Jump to: navigation, search

Difference between revisions of "Virgo/Diagnostics"

m (Virgo Shell commands)
Line 4: Line 4:
 
== Equinox Console  ==
 
== Equinox Console  ==
  
The Virgo shell is useful for inspecting the contents of the user region, but sometimes it is necessary to use a feature only available in the Equinox console or to inspect the contents of the kernel region. For example, at the time of writing, the Virgo shell is unable to display package wirings established by DynamicImport-Package.  
+
The Equinox Console is useful for examining either the kernel framework or the user region framework.
  
To enable the Equinox console, you need to set a framework property like this:  
+
Virgo offers shell commands to the user region Equinox Console for slightly more friendly inspection of user region artefacts.
 +
 
 +
To enable an Equinox console, you need to set a framework property, like this:  
 
<pre>osgi.console=2402
 
<pre>osgi.console=2402
</pre>  
+
</pre>identifying the port to use.
In the case of the user region, add this property to the file config/org.eclipse.virgo.kernel.userregion.properties. In the case of the kernel region, add this property to the file lib/org.eclipse.virgo.kernel.launch.properties.  
+
 +
In the case of the user region, add this property to the file <tt>config/org.eclipse.virgo.kernel.userregion.properties</tt>. In the case of the kernel region, add this property to the file <tt>lib/org.eclipse.virgo.kernel.launch.properties</tt>.  
  
 
You can even enable an Equinox console in both regions at once, using two different ports of course.  
 
You can even enable an Equinox console in both regions at once, using two different ports of course.  
  
 
To use the console, telnet in:  
 
To use the console, telnet in:  
<pre>&gt;telnet localhost 2402
+
<pre>&gt; telnet localhost 2402
 
</pre>  
 
</pre>  
The most useful commands are "ss" to list all bundles, "bundle &lt;n&gt;" to display information about the bundle with bundle id &lt;n&gt;, and "help" to see other commands.  
+
The most useful commands are ''ss'' to list all bundles, ''bundle &lt;n&gt;'' to display information about the bundle with bundle id ''&lt;n&gt;'', and ''help'' to see other commands.
 +
 
 +
When running in the user region, the Virgo shell commands are offered via the ''vsh'' command.  Type ''vsh help'' to see a list of the shell commands available.  
  
 
[[Category:Virgo]] [[Category:EclipseRT]]
 
[[Category:Virgo]] [[Category:EclipseRT]]

Revision as of 07:08, 11 June 2010


This page contains hints and tips for diagnosing problems with Virgo and Virgo applications.

Equinox Console

The Equinox Console is useful for examining either the kernel framework or the user region framework.

Virgo offers shell commands to the user region Equinox Console for slightly more friendly inspection of user region artefacts.

To enable an Equinox console, you need to set a framework property, like this:

osgi.console=2402
identifying the port to use.

In the case of the user region, add this property to the file config/org.eclipse.virgo.kernel.userregion.properties. In the case of the kernel region, add this property to the file lib/org.eclipse.virgo.kernel.launch.properties.

You can even enable an Equinox console in both regions at once, using two different ports of course.

To use the console, telnet in:

> telnet localhost 2402

The most useful commands are ss to list all bundles, bundle <n> to display information about the bundle with bundle id <n>, and help to see other commands.

When running in the user region, the Virgo shell commands are offered via the vsh command. Type vsh help to see a list of the shell commands available.