Remote Console

This tool is a simple remote console which receives the system output redirected from the framework to the Remote Console as well as sends data from the Remote Console's input to the framework.

The tool opens a TCP/IP server socket on a certain port and listens for incoming data from the framework. With this utility, you can remotely monitor the runtime results coming from an mBS framework and the bundles installed on it. You can also send commands to the framework and observe their execution.

To start and use the Remote Console tool:

• On the framework device:
  1. Set the mbs.output system property to remote in the appropriate default.prs file.
  2. Specify:
     • The IP address of the tool host by using the mbs.output.remote.host system property.
     • The port of the tool host by using the mbs.output.remote.port system property.

  Tip: See "System Properties" for more details about the system properties of the framework.

• On the tool host:
  1. Set the port (default is 2000) on which the Remote Console tool will listen and receive data by using the mbs.rconsole.port system property (in tool starting script file or in the command line complying with the syntax of the JVM). This port must be the same as the one set on the framework device.
  2. Start the Remote Console tool:
  • By using the rconsole script file that is located in the bin/tools/framework/rconsole folder of the Framework Professional Edition Package .
  • From the command line by instantiating SocketConsole class.

As a result, the Remote Console tool and the framework will connect.

If the Remote Console tool is started before the framework, the data transfer will start immediately.

If the Remote Console tool is started after the mBS framework, initially the connection will not be available. It will be established after a specific timeout, configurable with the mbs.output.remote.reconnectTimeout system property on the framework device.

Framework Tools