Fuse ESB - Configuring and Running Fuse ESB - Connecting and Disconnecting Remotely

Using the ssh:ssh command

You connect to a remote runtime's console using the ssh:ssh command.

Example 2.2. ssh:ssh Command Syntax

ssh:ssh {-l username} {-P password} {-p port} { hostname }

-l username: The username used to connect to the remote console. The default value is smx.
-P password: The password used to connect to the remote console. The default value is smx.
-p port

	Warning
	We recommend that you change the default username and password in the `etc/users.properties` file. See Configuring JAAS Security for details.

Example 2.3. Connecting to a Remote Console

karaf@root>ssh:ssh -l smx -P smx -p 8108 hostname

To confirm that you have connected to the correct Fuse ESB instance, type shell:info at the karaf> prompt. Information about the currently connected instance is returned, as shown.

Example 2.4. Output of the shell:info Command

        
Karaf
  Karaf home                  /local/apache-servicemix-4.4.1-fuse-00-08
  Karaf base                  /local/apache-servicemix-4.4.1-fuse-00-08
  OSGi Framework              org.eclipse.osgi - 3.5.1.R35x_v20090827
JVM
  Java Virtual Machine        Java HotSpot(TM) Server VM version 14.1-b02
  Vendor                      Sun Microsystems Inc.
  Uptime                      2 minutes
  Total compile time          43.562 seconds
Threads
  Live threads                97
  Daemon threads              42
  Peak                        100
  Total started               201
Memory
  Current heap size           34,234 kbytes
  Maximum heap size           518,464 kbytes
  Committed heap size         129,920 kbytes
  Pending objects             0
  Garbage collector           Name = 'Copy', Collections = 44, Time = 1.033 seconds
  Garbage collector           Name = 'MarkSweepCompact', Collections = 5, Time = 1.389 seconds
Classes
  Current classes loaded      7,335
  Total classes loaded        7,340
  Total classes unloaded      5
Operating system
  Name                        Linux version 2.6.31-17-generic
  Architecture                i386
  Processors                  1

Using the Karaf client

The Karaf client allows you to securely connect to a remote Fuse ESB instance without having to fully launch Fuse ESB locally.

For example, to quickly connect to a Fuse ESB instance running in server mode on the same machine, open a command prompt and run the Apache Karaf client[.bat] script (which is located in the InstallDir/bin directory), as follows:

client

More usually, you would provide a hostname, port, username, and password to connect to a remote instance. And, if you were using the client within a larger script, for example in a test suite, you could append console commands as follows:

client -a 8101 -h hostname -u smx -p smx features:install cxf-osgi

To display the available options for the client, type:

client --help

Example 2.5. Karaf Client Help

Apache Felix Karaf client
  -a [port]     specify the port 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
  -v            raise verbosity
  -r [attempts] retry connection establishment (up to attempts times)
  -d [delay]    intra-retry delay (defaults to 2 seconds)
  [commands]    commands to run
If no commands are specified, the client will be put in an interactive mode

Disconnecting from a remote console

To disconnect from a remote console, press Ctrl+D at the karaf> prompt.