8. Equinox Console

8.1 Enabling the Equinox Console

Shells are provided for both user region and kernel, although they are disabled by default and need enabling before they can be used.

The user region shell ports may be reconfigured by editing the file osgi.console.properties in the repository/ext directory, and then restarting Virgo. The telnet properties in the file are prefixed with telnet., and the ssh properties are prefixed with ssh.. The kernel shell ports may be reconfigured by editing the file osgi.console.properties in the configuration directory, and then restarting Virgo.

To enable any of these shell ports, change the enabled setting from false to true

enabled=true

in the corresponding properties files.

If you wish to change a port, any free port can be used, but the usual defaults are, for telnet, 2501 for the user region and 2401 for the kernel, and for ssh, 2502 for the user region and 2402 for the kernel.

Access is via ssh or telnet. The simplest way to access the shell is via telnet to port 2501 or 2401 for user region or kernel, respectively.

prompt$ telnet localhost 2501
Trying ::1...
Connected to localhost.
Escape character is '^]'.

osgi> 

Alternatively, you can ssh to port 2502 or 2402 for user region or kernel, respectively. The users and passwords for ssh are configured in configuration/org.eclipse.virgo.kernel.users.properties as described in Configuring Authentication. The default user and password are admin and springsource.

[Note]Note
Currently the Virgo Nano Equinox Console is enabled by default. Telnet is accesible on 2401 and SSH on 2402. In future these will be configurable.

[Note]Note
If you use the shutdown shell command to stop Virgo Server for Apache Tomcat, the shutdown messages appear in the shell terminal instead of in the terminal in which Virgo runs. This is due to the mechanisms which the shell implementation uses to redirect standard output.