Command Line
Start and stop from command line
If start and stop pipeline service in platforms other than Windows, and start from the command prompt of Windows, please see the following execution files and execute these commands.
| UNIX | Start | [INSTALL_DIR]/pipeline/bin/plsvc |
| Stop | [INSTALL_DIR]/pipeline/bin/plstop | |
| Windows | Start | [INSTALL_DIR]/pipeline/bin/plsvc.exe |
| Stop | [INSTALL_DIR]/pipeline/bin/plstop.exe |
The authority of operating system user who executed these commands,various resources can be accessed. When necessary, embed these commands into start and stop script of operating system, the operating system and pipeline service can be started or stopped at the same time. If you want to embed, please see the manual of each operating system for details.
Control of service process
The command line tool of "plctrl"can be used for providing detailed service control. Option of plctrl is as follows.
| plctrl shutdown | All pipeline service is shutdown. Equal to plstop. |
| plctrl shutdown killall | When pipeline service is stopped, the process is forced to cancel one after another without stop request. |
| plctrl shutdown <Timeout> | When pipeline service is stopped, force to stop the service that doesn't end even if specified time has passed since stop was requested. When it can stop in specified time, it is equal to exit normally. Timeout period is applied to each service. Unit is seconds. Example) plctrl shutdown 15 |
| plctrl start <ServiceName> | Star specified service. Example) plctrl start FlowService |
| plctrl stop <ServiceName> | Stop specified service. |
| plctrl restart <ServiceName> | Restart specified service. |
| plctrl kill <ServiceName> | Force to stop specified service. |
| plctrl status [<ServiceName>] | Display specified service status(If no service is specified, default is all pipeline service). |
| plctrl gc <ServiceName> | Execute garbage collection in specified service. |
Memo
Because there is only PIPELINE-Service in the pipeline service now, so specify PIPELINE- Service in <ServiceName>.Although start or stop of each pipeline services is almost similar, if monitoring object of the cluster software is the main process of the pipeline service, this method is valid if you want to restart.
Exit code
The exit code of the plctrl command is as follows.(Optional status is excluded.)
| Exit code | Explanation |
|---|---|
| -1 | Failed to transfer command (Failed to connect server ) |
| 0 | Succeed in execution of command |
| 1 | Failed to execute command |
Exit code of status option
| Exit code | Explanation |
|---|---|
| 0 | Unknown(Unknown) |
| 1 | StartPending(Starting) |
| 2 | Running(Start) |
| 3 | StopPending(Stopping) |
| 4 | Stopped(Stopped) |
| 5 | Down(Exception exit) |