restartSystem

The restartSystem method reboots the system without switching partitions. This service does not return a response when successful, since the reboot occurs before the final response can be returned.


This service will restart the server; an asynchronous response is not guaranteed.

Request Parameters
None

This result shows that /var/log/install/gui-restart-result.xml could not be deleted and the restart failed.
In this case, review the logs to determine the root cause.

Response Parameters (return element children)
result


A result code such as internal.request.complete that describes the result. See Error Codes in the Developer's Guide for details.
remoteMessages


If xsi:nil="true" then there are no remote messages. Otherwise:

  • error - Boolean, true if an error occurred, false otherwise
  • info - Boolean
  • messageKey - A result code such as internal.request.denied.lock if such an error occurred
  • messageType - The type of error, such as internal.message.error
  • warning - Boolean, true if this is a warning, false if not
  • messageParams - Information about the message (there can be more than one messageParam)
Example Request and Response
Request Response 
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<SOAP-ENV:Header xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/08/addressing">
		<wsa:Action>urn:restartSystem</wsa:Action>
		<wsa:MessageID>uuid:0b23619d-f88e-43cb-a6f2-e3752827dddd</wsa:MessageID>
		<wsa:ReplyTo>
			<wsa:Address>http://server/servlet/WSACallBackHandler</wsa:Address>
			<wsa:PortType xmlns:ns1="http://example.org">ns1:LocalPart</wsa:PortType>
		</wsa:ReplyTo>
		<wsa:To>https://server/platform-services/services/RestartSystemService .RestartSystemServiceHttpSoap11Endpoint/</wsa:To>
	</SOAP-ENV:Header>
	<SOAP-ENV:Body>
		<restartSystem xmlns="server_url"/>
	</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
    
								
<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Header xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/08/addressing">
        <wsa:To>http://server/servlet/WSACallBackHandler</wsa:To>
        <wsa:MessageID>urn:uuid:131F8296C8AB838D9D1299260560238</wsa:MessageID>
        <wsa:Action>urn:restartSystemResponse</wsa:Action>
        <wsa:RelatesTo>uuid:98335f43-35ea-4a4b-bb6c-1843bf340850</wsa:RelatesTo>
    </soapenv:Header>
    <soapenv:Body>
        <ns:restartSystemResponse xmlns:ns="server_url">
            <ns:return xmlns:ax264="server_url/xsd" xmlns:ax263="server_url/xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ax263:RestartSystemResponse">
                <ax263:remoteMessages xsi:type="ax263:RemoteMessage">
                    <ax264:error>true</ax264:error>
                    <ax264:info>false</ax264:info>
                    <ax264:messageKey>error.file.notdeleted</ax264:messageKey>
                    <ax264:messageType>internal.message.error</ax264:messageType>
                    <ax264:warning>false</ax264:warning>
                    <ax263:messageParams>/var/log/install/gui-restart-result.xml</ax263:messageParams>
                </ax263:remoteMessages>
                <ax263:result>internal.request.failed</ax263:result>
            </ns:return>
        </ns:restartSystemResponse>
    </soapenv:Body>
</soapenv:Envelope>