Process Server Administration Command Line Tool
You can use this tool to manage all processes,and process instances on the Process Server. This document contains a list of commands and command parameters that can be used to interact with the Process Server.
Each time a BPEL process executes an instance is created on the Process Server. To manage these effectively, it is good practice to periodically delete the executed processes that have been deployed and configured using persistence from the Process Server. To delete instances use the delete [all | completed | failed | terminated | suspended | iid] command.
Tool Location:
<install_directory>\processserver\bin\pscli.cmd
Commands
The commands below begin with the pscli [flags]
command followed by the task command. For example: --pscli [flags] changepassword or --pscli [flags] list. The optional flags on all the commands are:
-Server (-s)
- The name and port number of the VPD server you want to connect to (for example, hostname:34001). If you do not provide a port number, the default port 34000 is used.-Username (-u)
- The username you want to connect with-Password (-p)
- The password you want to use when connecting
Command | Description |
---|---|
help commands | View a list of commands followed by brief descriptions. |
help command | View help on a specific command. |
list [all | processes | instances] |
Combines results from the following two commands |
list processes | List all deployed processes on the server and view their status |
list instances | Generates a list of process instances including their current state, last activity of each instance, and the instance identification number. |
info [iid | pid | ProcessNameFilter] |
Example: pscli info 751 where 751 is the iid or (instance identifier) Example: pscli info HelloWorld (ProcessNameFilter) Example: pscli info <pid here> (process identifier)
|
deploy packagename PathToDirectory | Copies the specified process or package to the server from the specified directory, when deployed a process can be run from the server. Example: pscli deploy HelloWorld C:\verastream\projects\HelloWorld |
undeploy [packagename | all] |
Undeploy removes specified processes or process packages from the server, they may no longer be run on the server. Example: pscli undeploy HelloWorld where ‘HelloWorld’ is the name of the process. |
activate[all | pid | ProcessNameFilter] |
This action makes the specified process avaialable for use on the server to which it has been deployed. This action can be performed against all processes, against a single processspecified by the pid or by entering the process name. |
retire[all | pid | ProcessNameFilter] |
This action can be performed against all processes, against a single process specified by the pid or by entering the process name to essentially ’deactivate’ the process. |
terminate [ all | iid] |
Stops all running process instances or a single running instance. |
delete [all | completed | failed | terminated | suspended | iid] |
This action deletes information stored about the instance from the database. These status parameters perform the delete action against:
|
changepassword | Changes your Process Server password credentials. |
More Information