8. Equinox Console
Prev |  | Next

## 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
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
If you use the `shutdown` shell command to stop Virgo Tomcat Server, 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.

Prev |  | Next
7.8 Using Equinox Launcher | Home | 8.2 Using Virgo Shell Commands