Accessing the console via Telnet

The framework can be administrated over Telnet since the collection of commands in the Parser Service is made available to (remote) Telnet clients.

The Bosch IoT Gateway Software provides Util Telnet bundle to enable administrators supervise the server using Telnet client applications.

Enabling Telnet administration

To enable the Telnet administration:

Make sure the framework is running – on the local machine, or on a remote device.
Install and start the Util Telnet bundle com.prosyst.mbs.util.telnet.jar:
fw>$i -s ../bosch-iot-gateway-sdk/runtime/osgi/bundles/com.prosyst.mbs.util.telnet.jar

Make sure it is active.
Start a Telnet application.
To connect to the remote framework, specify the following host properties in the Telnet application:
- Host Name – the name of the framework device. Use localhost if the framework is running on the local machine.
- Port – telnet, which corresponds to the standard port for Telnet connection (#23). If this port is overloaded and the connection with the framework is lost, redirect your request to port #2323.
- Term Type – vt100.
You are prompted to log in. Type your user name after the Login keyword, and press ENTER. Next, you enter your password. To confirm, press ENTER again. Make sure that you provide an account which is registered with the User Admin service and has administrative rights, meaning that it is a member of the administration group.

Using commands over Telnet

After connecting to the framework, you can monitor it by sending text commands. The Telnet Bundle receives the commands and refers to the Parser Service to load their execution. After a command is executed, its output is returned to the Telnet client. By default, in the Telnet application you do not see the runtime information being dumped by the framework and its bundles. To activate this, use the dump command from the Telnet client, which will make the Parser service forward the information from System.out and System.err to the Telnet output.

Telnet-specific commands

Framework administration over Telnet includes commands that are Telnet-specific:

Telnet Commands	Shortcut	Description
help	-	Print help messages online.
spy	-	Turn online messages on and off.
finger	-	Print a list of users that are currently connected to the same Telnet server.
logout	-	Terminate the client-server connection over Telnet.

The other commands accessible over Telnet belong to the set of commands managed by the Parser Service.

The Util Telnet bundle properties concern mainly the specific features of the Telnet communication mechanism and can be configured through the OSGi Configuration Admin service.