Open topic with navigation

# RestartService

The `RestartService` action stops a service, waits until the process has stopped, and then starts the service again.

## Example

`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.

## Parameters

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. |

## Comments

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:

- A token for the Controller (`<ControllerToken>`).
- The request port number (`<Port>`).
- The UUID of the Controller in question (as specified by the `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.

Related Topics

- AddService
- EditServiceInfo
- FindServices
- GetServices
- RemoveService
- StartService
- StopService

© 2013 - 2016 Hewlett Packard Enterprise Development LP | Send documentation feedback to HPE Close We welcome your comments! To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a web mail client, and send this email to AutonomyTPFeedback@hpe.com. Product: Topic Title: Help Topic: Feedback:

_HP_HTML5_bannerTitle.htm