The RestartService
action stops a service, waits until the process has stopped, and then starts the service again.
a=RestartService&Port=9000
a=RestartService&Port=9000&ControlMethod=Process&Timeout=60
a=RestartService&Port=41600&ConfigContent=%5BServer%5D%0APort=41400%0A%5BService%5D%0AServicePort=41402%0AServiceControlClients=*.*.*.*%0A%5Bssdp%5D%0AssdpPort=41404
Before it starts the service, the RestartService
action first tries to stop the service by using the control method specified in the ControlMethod
parameter, then by using SCM, then by using a server process.
Note: You must have Windows administrator privileges to use this action.
Parameter | Description | Required |
---|---|---|
ConfigContent - Deprecated |
A replacement configuration to use for the service. |
|
ControlMethod |
The control method to use to start the service. |
|
Port |
The port of the service. |
Yes |
StopControlMethod |
The control method to use to stop the service. |
You can also submit this action from Coordinator by specifying the ControllerUUID
parameter. By default, the action is asynchronous, but you can run it synchronously by setting the Synchronous
parameter to True
.
If the response is successful, the response contains the following information:
<ControllerToken>
). <Port>
).ControllerUUID
parameter).You can use the Controller token with the QueueInfo
action to find the status of the action. For example:
action=SendAction&ControllerUUID=<UUID>&Command=QueueInfo&QueueAction=GetStatus&QueueName=<Action>&Token=<ControllerToken>
If the response fails, it contains an error. Usually this is as a result of an issue with underlying Controller, or as a result of an issue with Coordinator itself if the Controller is down.
For more information, refer to the Coordinator Reference.
|