The process command is used to start and stop processes.
To start a process, use the -start option. The argument can be
either an installed component or a component descriptor policy
XML file on disk. To stop a running process, use process -stop.
As a shortcut to executing process -start on an installed component,
you can simply type the component's name at the shell prompt.
Additionally, as a shortcut to stopping a process on one platform
and starting it on another, you can use the process -move command
to perform these two operations at once.
|
Syntax:
|
process -start <path or
file>
process -stop <path>
process -move <path> <path>
|
|
Example:
Openwings@root\some_platform\> ls
COMPONENTS:
HelloWorldServiceSync_im-0.1
HelloWorldUser_im-0.1
...
MBEANS:
...
SERVICES:
...
PROCESSES:
...
Openwings@root\some_platform\> process -start
HelloWorldUser_im-0.1
HelloWorldUser_im-0.1 has been started.
Openwings@root\some_platform\> ls
COMPONENTS:
HelloWorldServiceSync_im-0.1
HelloWorldUser_im-0.1
...
MBEANS:
...
SERVICES:
...
PROCESSES:
HelloWorldUser_im-0.1-<UniqueID>
...
Openwings@root\some_platform\> process -stop
HelloWorldUser_im-0.1-<UniqueID>
Process HelloWorldUser_im-0.1-<UniqueID> has
been stopped.
Openwings@root\some_platform\> ls
COMPONENTS:
HelloWorldServiceSync_im-0.1
HelloWorldUser_im-0.1
...
MBEANS:
...
SERVICES:
...
PROCESSES:
...
The <UniqueID> that is part of
the process name above will always be a 32-character hexadecimal
string, with underscores separating every 8 characters for readability.
It is possible to move a process from one platform
(container manager) to another. You can manually stop the process
on one platform and start it on another by using the start and
stop commands as separate operations, but the move command makes
this more convenient. In addition, if the process being moved
depends on a set of components, the move command will automatically
install these components onto the target (if they are served on
the web server).
To use the process -move command, specify the process
to be moved and the destination container manager (where it should
be moved).
Example:
Openwings@root\some_platform\> ls
COMPONENTS:
HelloWorldServiceSync_im-0.1
HelloWorldUser_im-0.1
...
MBEANS:
...
SERVICES:
...
PROCESSES:
HelloWorldUser_im-0.1-<UniqueID>
...
Openwings@root\some_platform\> process -move
HelloWorldUser_im-0.1-<UniqueID> <anotherPlatformName>
Process HelloWorldUser_im-0.1-<UniqueID>
successfully stopped.
Successfully started process on <anotherPlatformName>.
Next: The uninstall
command
