Apache Felix Remote Shell
The Apache Felix Remote Shell provided by the org.apache.felix.shell.remote bundle is a frontend to the Apache Felix Shell Service which allows remote access to the shell using telnet clients. The remote shell provides simple telnet access with no bells and whistles – it just works ...
To use the Apache Felix Remote Shell, you have to install the org.apache.felix.shell bundle in addition to the org.apache.felix.shell.remote bundle. Once both bundles are installed, you may access the shell remotely.
Acknowledgment
The Apache Felix Remote Shell has been contributed by Dieter Wimberger.
Configuration
The Apache Felix Remote Shell bundle currently is configured using framework properties obtained from the bundle's context. The following properties are supported:
| Property | Default Value | Description |
|---|---|---|
| osgi.shell.telnet.ip | 127.0.0.1 | IP Address on which the remote shell is accessible (since 1.0.4). |
| osgi.shell.telnet.port | 6666 | Port on which the remote shell is accessible. |
| osgi.shell.telnet.maxconn | 2 | The maximum number of simultaneous connections. |
| osgi.shell.telnet.socketTimeout | 0 | Sets the SO_TIMEOUT socket option to the given number of milliseconds. The default is no timeout (since 1.0.4). |
Note: Starting with version 1.0.4 the remote shell does not listen on all interfaces by default but on the localhost only. That is, by default the remote shell is only accessible from the host on which the remote shell is running. To access the system from another host, you have to configure the IP address of the interface to which the remote shell should be attached.
Security Note
This remote shell bundle does not employ any security at all. Thus if there is no security manager is active in the framework's JVM any user connecting to the remote shell full control over the framework.
To have some minimum level of security ensure the IP Address configured with the osgi.shell.telnet.ip property is not publicly accessible.