...
The remote console feature allows to connect to a running ServiceMix instance from a remote computer and perform all the operations that are usually accessible from the local console.
| Warning |
|---|
|
The remote console is currently enabled by default, but there is the default security in place is very low. The username and password that are prompted are by default not validated, so any combination will work. In production environment, we recommend disabling the server (by using the client mode) or deploying a JAAS realm to perform some real authentication. See the security documentation. To secure the channel, it is possible to use SSL encryption by changing the url as shown in the #Configuration section. |
Launch options
The ServiceMix Kernel shell scripts supports a number of options to control the remote console:
...
| Panel |
|---|
|
| No Format |
|---|
|
> java -jar lib/servicemix-client.jar --help
Apache ServiceMix Kernel client
-a [address] specify the URL to connect to
-h [host] specify the host to connect to
-u [user] specify the user name
-p [password] specify the password
--help shows this help message
[commands] commands to run
If no commands are specified, the client will be put in an interactive mode
|
|
...
| Panel |
|---|
|
| No Format |
|---|
|
> java -jar lib/servicemix-client.jar
smx@root:/> osgi/shutdown
smx@root:/>
>
|
|
| Warning |
|---|
| title | Sending direct commands from the client |
|---|
|
The client jar does not yet support passing command line arguments to the remote ServiceMix Kernel.
In order to do so, you can create a text file containing the commands and use the system console to redirect this file to the input stream: | Code Block |
|---|
> echo osgi/shutdown |
Connected
> > command.txt
> java -jar lib/servicemix-client.jar < command.txt
>
|
|
#top
Using an SSH client
You can use any standard SSH client to connect to a ServiceMix Kernel instance. The default port is 8101.
| Code Block |
|---|
> ssh -p 8101 -l smx localhost
smx@localhost's password: smx
smx@root:/>
|
| Warning |
|---|
| title | Error messages when using some ssh clients |
|---|
|
Some SSH clients will prompt some harmless warnings when connecting to ServiceMix Kernel.
In particular, openssh 5.1p1 will display the following output: | Code Block |
|---|
channel_by_id: 1: bad id: channel free
channel_input_success_failure: 1: unknown
channel_by_id: 1: bad id: channel free
channel_input_success_failure: 1: unknown
|
|
#top
Using another Kernel instance
...
