Virgo provides an extension to the Equinox console, for the user region only, in the form of the vsh
command
that allows you to examine artifacts
currently installed to a particular Web Server instance, manage the lifecycle of the installed artifacts, install new artifacts, and shut down
the server. You can install, examine, and manage the lifecycle of the following artifacts:
Bundles
Configuration Artifacts
PARs
Plans
and can examine:
Exported packages
Services in the OSGi service registry
You invoke the Equinox Console Extension using the vsh
command. For example:
osgi> vsh help bundle - Management and examination of bundle artifacts config - Management and examination of configuration artifacts exit - Exit the kernel shell environment help - Get help on commands install - Install (deploy) an artifact to the server package - Examination of exported packages par - Management and examination of PAR artifacts plan - Management and examination of plan artifacts service - Examination of services shutdown - Shutdown Virgo Kernel osgi>
The following table lists the Equinox Console Extension subcommands; each subcommand in turn has a variety of options that you can specify, depending on what you want to do, such as start a bundle or refresh a plan. The reference documentation about each subcommand provides the full list of available options.
Table 6.1. Equinox Console Extension Subcommands
Subcommand | Description |
---|---|
bundle | Manages and displays information about bundle artifacts. |
config | Manages and displays information about configuration artifacts. |
package | Displays information about exported packages. |
par | Manages and displays information about PAR artifacts. |
plan | Manages and displays information about plan artifacts. |
service | Displays information about services in the OSGi service registry. |
install | Installs an artifact to Web Server. |
shutdown | Shuts down the Web Server instance to which the Equinox Console is connected. |
help | Displays help about the list of available subcommands, as well as more detailed help about individual subcommands. |
exit | Returns to the Equinox console with no effect. |