| <html><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 8. Equinox Console</title><meta content="DocBook XSL Stylesheets V1.76.0" name="generator"><link rel="home" href="index.html" title="Virgo User Guide"><link rel="up" href="index.html" title="Virgo User Guide"><link rel="prev" href="ch07s08.html" title="Using Equinox Launcher"><link rel="next" href="ch08s02.html" title="Using Virgo Shell Commands"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table summary="Navigation header" width="100%"><tr><td align="left" width="20%"><a accesskey="p" href="ch07s08.html">Prev</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="ch08s02.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 8. Equinox Console"><div class="titlepage"><div><div><h2 class="title"><a name="admin-shell"></a>Chapter 8. Equinox Console</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="ch08.html#admin-shell-enable">Enabling the Equinox Console</a></span></dt><dt><span class="section"><a href="ch08s02.html">Using Virgo Shell Commands</a></span></dt><dd><dl><dt><span class="section"><a href="ch08s02.html#admin-shell-vsh-using-command-list">Virgo Shell Commands</a></span></dt></dl></dd><dt><span class="section"><a href="ch08s03.html">Virgo Shell Command Reference</a></span></dt><dd><dl><dt><span class="section"><a href="ch08s03.html#admin-shell-vsh-bundle-command">bundle Command</a></span></dt><dt><span class="section"><a href="ch08s03.html#admin-shell-vsh-config-command">config Command</a></span></dt><dt><span class="section"><a href="ch08s03.html#admin-shell-vsh-package-command">packages Command</a></span></dt><dt><span class="section"><a href="ch08s03.html#admin-shell-vsh-par-command">par Command</a></span></dt><dt><span class="section"><a href="ch08s03.html#admin-shell-vsh-plan-command">plan Command</a></span></dt><dt><span class="section"><a href="ch08s03.html#admin-shell-vsh-service-command">service Command</a></span></dt><dt><span class="section"><a href="ch08s03.html#admin-shell-vsh-install-command">install Command</a></span></dt><dt><span class="section"><a href="ch08s03.html#admin-shell-vsh-shutdown-command">shutdown Command</a></span></dt><dt><span class="section"><a href="ch08s03.html#admin-shell-cl-clhas">clhas command</a></span></dt><dt><span class="section"><a href="ch08s03.html#admin-shell-cl-clexport">clexport command</a></span></dt><dt><span class="section"><a href="ch08s03.html#admin-shell-cl-clload">clload command</a></span></dt></dl></dd><dt><span class="section"><a href="ch08s04.html">Using the p2 for extending your Virgo installation</a></span></dt><dd><dl><dt><span class="section"><a href="ch08s04.html#N10F94">Extending with the p2 director</a></span></dt><dt><span class="section"><a href="ch08s04.html#N10FA4">Extending via the p2 shell commands</a></span></dt></dl></dd></dl></div><div class="section" title="Enabling the Equinox Console"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="admin-shell-enable"></a>Enabling the Equinox Console</h2></div></div></div><p> |
| Shells are provided for both user region and kernel, although they are disabled by default and need enabling before |
| they can be used. |
| </p><p> |
| The user region shell ports may be reconfigured by editing the file |
| <code class="literal">osgi.console.properties</code> in the <code class="literal">repository/ext</code> directory, and |
| then restarting Virgo. The telnet properties in the file are prefixed with <span class="emphasis"><em>telnet.</em></span>, and the ssh properties are prefixed with <span class="emphasis"><em>ssh.</em></span>. |
| The kernel shell ports may be reconfigured by editing the file <code class="literal">osgi.console.properties</code> in the <code class="literal">configuration</code> directory, and then restarting Virgo. |
| </p><p> |
| To enable any of these shell ports, change the <code class="literal">enabled</code> setting from <code class="literal">false</code> to <code class="literal">true</code> |
| </p><pre class="programlisting">enabled=true</pre><p> |
| in the corresponding properties files. |
| </p><p> |
| 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. |
| </p><p> |
| 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. |
| </p><pre class="programlisting">prompt$ telnet localhost 2501 |
| Trying ::1... |
| Connected to localhost. |
| Escape character is '^]'. |
| |
| osgi> </pre><p> |
| </p><p> |
| Alternatively, you can ssh to port 2502 or 2402 for user region or kernel, respectively. |
| The users and passwords for ssh are configured in <code class="literal">configuration/org.eclipse.virgo.kernel.users.properties</code> as described |
| in <a class="link" href="ch13s06.html#configuring-authentication" title="Configuring Authentication">Configuring Authentication</a>. The default user and password are <code class="literal">admin</code> |
| and <code class="literal">springsource</code>. |
| </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3> |
| Currently the Virgo Nano Equinox Console is enabled by default. Telnet is accesible on <span class="emphasis"><em>2401</em></span> and SSH on <span class="emphasis"><em>2402</em></span>. In future these will be configurable. |
| </div><p> |
| </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3> |
| If you use the <code class="literal">shutdown</code> 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. |
| </div><p> |
| </p></div></div><div class="navfooter"><hr><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="ch07s08.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="ch08s02.html">Next</a></td></tr><tr><td valign="top" align="left" width="40%"> </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td valign="top" align="right" width="40%"> </td></tr></table></div></body></html> |
