Text Console

The text console term stands for the terminal window for monitoring and administering the framework by typing text commands. The mBS framework offers two ways for console administration: from the framework local console and from a remote Telnet client application.

Framework Local Console

After the framework is started, administrators can issue commands straight in the framework local console. This capability is supplied by the Console Bundle. It does not contain the supported commands itself but contacts the Parser Service of the ProSyst Util Bundle, and maps the commands maintained by this service to the system output. Therefore, to be able to execute commands and see their results in the framework local console, you should install and start the Console Bundle (bundles/console.jar). Originally, the Console Bundle is activated by default when the framework is started.

The command set that is available in the framework local console is described in the "Framework Commands" document.

Telnet Console

The framework can be administrated over Telnet since the collection of commands in the Parser Service of the ProSyst Util Bundle is forwarded to remote Telnet clients.

The Telnet Bundle enables Telnet administration. This bundle is loaded by default when the framework is started.

Enabling Telnet Admistration

To enable the Telnet administration:

Start the framework or if it is on a remote device, make sure it is running.
Make sure that the Telnet Bundle is active. Otherwise, install and start it.
Start Telnet.
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 username 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, that is it is a member of the administration group.

Using Commands over Telnet

After connecting to the framework, you can monitor it by sending tex commands. The Telnet Bundle receives the commands and refers to the Parser Service of the ProSyst Util Bundle 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`	-	Prints help messages online.
`spy`	-	Turns online messages on and off.
`finger`	-	Prints a list of users that are currently connected to the same Telnet server.
`logout`	-	Terminates the client-server connection over Telnet.

Note: The other commands accessible over Telnet belong to the set of commands managed by the Parser Service. They are described in the "Framework Commands" document.

Note: The Telnet Bundle has properties, which can be configured through the OSGi Configuration Admin service. These properties concern mainly the specific features of the Telnet communication mechanism.

Administration