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).