6. Equinox Console

6.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.telnet.properties or osgi.console.ssh.properties in the repository/ext directory, and then restarting Virgo. The kernel shell ports may be reconfigured by editing the file osgi.console.telnet.properties or osgi.console.ssh.properties in the config 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 first time you use ssh to connect, specify the user "equinox" and password "equinox". You'll then be prompted prompted to create a new user, password, and role (the "admin" role is recommended).