getCurrentUpgradeProgressStage

The getCurrentUpgradeProgressStage method returns detailed progress information for an upgrade or COP file installation that is in progress. Before you can use this method, you need to have initiated a StartUpgradeService call. This call should always be made asynchronously.

Request Parameters

None

This result indicates that an application installation is in progress.

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.

upgradeStage

Current progress of the upgrade installation as follows:
upgrade.progress.populating.archives - Populating archives
upgrade.progress.populating.os.rpms - Populating OS RPMs
upgrade.progress.populating.hw.rpms - Populating HW RPMs
upgrade.progress.populating.deployment.rpms - Populating Deployment RPMs
upgrade.progress.os.installation - OS Installation
upgrade.progress.platform.preinstall - Platform Pre Install
upgrade.progress.os.rpms.installation - OS RPMs Installation
upgrade.progress.platform.postinstall - Platform Post Install
upgrade.progress.platform.postinstall.nochroot - Platform Post Install - nochroot
upgrade.progress.create.special.accounts - Creating important user accounts/groups
upgrade.progress.tomcat.config - Setting up Tomcat configuration
upgrade.progress.disable.keys.functions - Disabling various keys and functions
upgrade.progress.create.ccm.accounts - Creating CCM Account
upgrade.progress.hw.based.install - HW RPMs installation
upgrade.progress.updating.rc.local - Updating rc.local
upgrade.progress.application.installation - Application Installation
upgrade.progress.finalization - Finalization

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:getCurrentUpgradeProgressStage</wsa:Action>
		<wsa:MessageID>uuid:75eb75b0-de1f-4179-8413-8a9c487cd749</wsa:MessageID>
		<wsa:ReplyTo>
			<wsa:Address>http://server_url/servlet/WSACallBackHandler</wsa:Address>
			<wsa:PortType xmlns:ns1="http://example.org">ns1:LocalPart</wsa:PortType>
		</wsa:ReplyTo>
		<wsa:To>https://server_url/platform-services/services/UpgradeProgressStageService.UpgradeProgressStageServiceHttpSoap11Endpoint</wsa:To>
	</SOAP-ENV:Header>
	<SOAP-ENV:Body>
		<getCurrentUpgradeProgressStage 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://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</wsa:To>
		<wsa:MessageID>urn:uuid:4A13792C1511BDDB981297716605720</wsa:MessageID>
		<wsa:Action>urn:getCurrentUpgradeProgressStageResponse</wsa:Action>
		<wsa:RelatesTo>uuid:9edecbfe-215b-4ee9-b681-79b3096f8f1c</wsa:RelatesTo>
	</soapenv:Header>
	<soapenv:Body>
		<ns:getCurrentUpgradeProgressStageResponse xmlns:ns="server_url">
			<ns:return xmlns:ax229="server_url/xsd" xmlns:ax230="server_url/xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ax229:UpgradeStageResponse">
				<ax229:result>internal.request.complete</ax229:result>
				<ax229:upgradeStage>upgrade.progress.application.installation</ax229:upgradeStage>
			</ns:return>
		</ns:getCurrentUpgradeProgressStageResponse>
	</soapenv:Body>
</soapenv:Envelope>

This result indicates that the install processs is in the archiving stage.

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.

upgradeStage

current progress of the upgrade installation as follows:
upgrade.progress.populating.archives - Populating archives
upgrade.progress.populating.os.rpms - Populating OS RPMs
upgrade.progress.populating.hw.rpms - Populating HW RPMs
upgrade.progress.populating.deployment.rpms - Populating Deployment RPMs
upgrade.progress.os.installation - OS Installation
upgrade.progress.platform.preinstall - Platform Pre Install
upgrade.progress.os.rpms.installation - OS RPMs Installation
upgrade.progress.platform.postinstall - Platform Post Install
upgrade.progress.platform.postinstall.nochroot - Platform Post Install - nochroot
upgrade.progress.create.special.accounts - Creating important user accounts/groups
upgrade.progress.tomcat.config - Setting up Tomcat configuration
upgrade.progress.disable.keys.functions - Disabling various keys and functions
upgrade.progress.create.ccm.accounts - Creating CCM Account
upgrade.progress.hw.based.install - HW RPMs installation
upgrade.progress.updating.rc.local - Updating rc.local
upgrade.progress.application.installation - Application Installation
upgrade.progress.finalization - Finalization

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:getCurrentUpgradeProgressStage</wsa:Action>
		<wsa:MessageID>uuid:75eb75b0-de1f-4179-8413-8a9c487cd749</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_url/platform-services/services/UpgradeProgressStageService.UpgradeProgressStageServiceHttpSoap11Endpoint</wsa:To>
	</SOAP-ENV:Header>
	<SOAP-ENV:Body>
		<getCurrentUpgradeProgressStage 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://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</wsa:To>
		<wsa:MessageID>urn:uuid:4A13792C1511BDDB981297716498899</wsa:MessageID>
		<wsa:Action>urn:getCurrentUpgradeProgressStageResponse</wsa:Action>
		<wsa:RelatesTo>uuid:42da5653-165e-4292-82ec-d5bc5b47f293</wsa:RelatesTo>
	</soapenv:Header>
	<soapenv:Body>
		<ns:getCurrentUpgradeProgressStageResponse xmlns:ns="server_url">
			<ns:return xmlns:ax229="server_url/xsd" xmlns:ax230="server_url/xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ax229:UpgradeStageResponse">
				<ax229:result>internal.request.complete</ax229:result>
				<ax229:upgradeStage>upgrade.progress.populating.archives</ax229:upgradeStage>
			</ns:return>
		</ns:getCurrentUpgradeProgressStageResponse>
	</soapenv:Body>
</soapenv:Envelope>

This result indicates that the install processs is in the finalization stage.

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.

upgradeStage

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:getCurrentUpgradeProgressStage</wsa:Action>
		<wsa:MessageID>uuid:75eb75b0-de1f-4179-8413-8a9c487cd749</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_url/platform-services/services/UpgradeProgressStageService.UpgradeProgressStageServiceHttpSoap11Endpoint</wsa:To>
	</SOAP-ENV:Header>
	<SOAP-ENV:Body>
		<getCurrentUpgradeProgressStage 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://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</wsa:To>
		<wsa:MessageID>urn:uuid:4A13792C1511BDDB981297717254843</wsa:MessageID>
		<wsa:Action>urn:getCurrentUpgradeProgressStageResponse</wsa:Action>
		<wsa:RelatesTo>uuid:f30bb3a9-b43f-4dd6-b4f0-ac9ae80c62c1</wsa:RelatesTo>
	</soapenv:Header>
	<soapenv:Body>
		<ns:getCurrentUpgradeProgressStageResponse xmlns:ns="server_url">
			<ns:return xmlns:ax229="server_url/xsd" xmlns:ax230="server_url/xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ax229:UpgradeStageResponse">
				<ax229:result>internal.request.complete</ax229:result>
				<ax229:upgradeStage>upgrade.progress.finalization</ax229:upgradeStage>
			</ns:return>
		</ns:getCurrentUpgradeProgressStageResponse>
	</soapenv:Body>
</soapenv:Envelope>

This result indicates that there is no upgrade in progress.

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.

upgradeStage

Example Request and Response (No Upgrade in Progress)

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:getCurrentUpgradeProgressStage</wsa:Action>
		<wsa:MessageID>uuid:75eb75b0-de1f-4179-8413-8a9c487cd749</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_url/platform-services/services/UpgradeProgressStageService.UpgradeProgressStageServiceHttpSoap11Endpoint</wsa:To>
	</SOAP-ENV:Header>
	<SOAP-ENV:Body>
		<getCurrentUpgradeProgressStage 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:371332A0B549A964C21298941890020</wsa:MessageID>
		<wsa:Action>urn:getCurrentUpgradeProgressStageResponse</wsa:Action>
		<wsa:RelatesTo>uuid:2b377ea4-f0d1-4667-ac01-303fc05cec7a</wsa:RelatesTo>
	</soapenv:Header>
	<soapenv:Body>
		<ns:getCurrentUpgradeProgressStageResponse xmlns:ns="server_url">
			<ns:return xmlns:ax230="server_url/xsd" xmlns:ax229="server_url/xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ax229:UpgradeStageResponse">
				<ax229:result>internal.request.complete</ax229:result>
				<ax229:upgradeStage xsi:nil="true"/>
			</ns:return>
		</ns:getCurrentUpgradeProgressStageResponse>
	</soapenv:Body>
</soapenv:Envelope>

Platform Administrative Web Services (PAWS) API Reference

getCurrentUpgradeProgressStage