Previous Topic: Software Delivery Commands

Next Topic: dpmsd deliver Command--Deliver a Package


dpmsd cancelimage Command--Cancel a Pending Image

The dpmsd cancelimage command cancels an image that has been deployed to a server. You can cancel the OS image jobs that are pending or already in progress. When you cancel an operating system image that is already in progress, the state of the target host becomes unpredictable. You may need to reset the target host for the next task.

Note: You can modify the casdaconf.cfg file to disable canceling an operating system image deployment in progress. The flag is set to enable canceling an image in progress: SD_Img_Cancel_Job_In_Progress=Yes. To disable this setting, change “Yes” to “No” and recycle Apache service.

This command has the following format:

dpmsd cancelimage [-sc sc_url] -target_host targethostname [-itcm_server itcmdomainmanager] [-pre][-post[-ws_user username -ws_password password][-locale iso629value]
-sc sc_url

(Optional) Defines the URL for the service controller host.

Example: https://hostname:port/...

hostname

Defines the fully qualified host where the service controller is installed.

Example: localhost.ca.com

port

Defines the listening port for the service controller server.

Example: 80

-target_host targethostname

Defines the name of the target host server to which you are deploying the image.

-itcm_server itcmdomainmanager

(Optional) Defines the name of the CA ITCM Domain Manager where the software delivery adapter resides. Optional when only one Software Delivery adapter or CA ITCM domain manager is configured. Valid for CA Server Automation only.

-pre

(Optional) Specifies whether to generate an event before the operation is performed.

-post

(Optional) Specifies whether to generate an event after the operation is performed.

-ws_user username -ws_password password

(Optional) Specifies the credentials to use for the web service security check. If you do not include credentials, you are prompted to enter them. Avoid the prompt for credentials by setting up your own session using caaipsecurity.

-locale iso639value

(Optional) Specifies an IS0 639_3166 combination to override the default English output, for example, fr_FR for French. To use the locale of the command prompt, specify "native".

Example: Cancel an Image on a Host

This example cancels an operating system image on the target host server001.

dpmsd cancelimage -target_host server001 -pre -post

Example: Cancel an Image on a Host in a Multiple ITCM Domain Manager Environment

This example cancels an operating system image on the target host server001. This operation is routed to the sd adapter on ITCM domain manager domainmanager001.

dpmsd cancelimage -target_host server001 - itcm_server domainmanager001 -pre -post