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]
(Optional) Defines the URL for the service controller host.
Example: https://hostname:port/...
Defines the fully qualified host where the service controller is installed.
Example: localhost.ca.com
Defines the listening port for the service controller server.
Example: 80
Defines the name of the target host server to which you are deploying the image.
(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.
(Optional) Specifies whether to generate an event before the operation is performed.
(Optional) Specifies whether to generate an event after the operation is performed.
(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.
(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
Copyright © 2013 CA. All rights reserved. |
|