Reference Guide › Command Line Scripting › Software Delivery Commands › dpmsd deliver Command--Deliver a Package

dpmsd deliver Command--Deliver a Package

The dpmsd deliver command delivers a package to a host computer.

This command has the following format:

dpmsd deliver [-sc sc_url] -package_name packagename -procedure_name procedurename -computer_host computerhostname [-scalability_server scalabilityservername] [-itcm_server itcmdomainmanager] -computer_username username [-computer_password password] [-auth_file authorizationfilename] [-auth_comp componentID] -os_type {Windows|Linux|Any|HP-UX|AIX|Solaris} [-wait [timeout]] [-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

-package_name {packagename|all}

Defines the name of the package to deliver.

packagename

Applies the managed status change to the specified package.

all

Apply the managed status change to all packages.

-procedure_name procedurename

Defines a name for the procedure.

-computer_host computerhostname

Defines the name of the server for deploying the package.

-scalability_server servername

(Optional) Specifies the CA ITCM scalability server for software distribution.

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

-computer_username computerusername

Defines the user name of the target host server for the deployment operation.

Windows: Administrator access is required.

UNIX/Linux: Root access is required.

-computer_password computerpassword

(Optional) Defines the user password used for deploying agents to the target host server to which you are deploying. If you do not specify the password, is retrieved from the authorization file.

Note: Use the dpmutil CLI to set up the authorization file.

-auth_file authorizationfilename

(Optional) Specifies the full path name of the authorization file to use to retrieve the encrypted password. This file contains the CA Server Automation administrator credentials that were generated using the dpmutil set auth command. When this option is not specified, the default authorization file is used.

-auth_comp componentID

(Optional) Specifies a component ID that you can use to group hosts and users.

-os_type={Windows|Linux|HP-UX|AIX|Solaris|Any}

Defines the type of operating system that is on the computer host. This parameter is required for software delivery agent deployment. Options include the following:

Windows

Specifies the Windows operating system.

Linux

Specifies the Linux operating system.

HP-UX

Specifies the HP UNIX operating system.

AIX

Specifies the AIX UNIX operating system.

Solaris

Specifies the Solaris operating system.

Any

Specifies any type of operating system.

Note: This option is valid for image deployment only.

-wait timeout

(Optional) Indicates whether to display the status of the job and not return until the operation completes, fails, or the timeout period is met (if you specify a timeout value). If you do not specify this option, the CLI returns without waiting for completion. If there is no response, the optional timeout value defines the timeout period in minutes. If you enter the wait option with no timeout value, the CLI uses the default wait time from the caimgconf.cfg file or defaults to 120 minutes. In addition to any positive integer, the following timeout values are also possible:

""

No timeout value.

0

Wait indefinitely.

-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: Deliver a Software Package to a Host

This example delivers a package containing a version of Apache software to a Windows host computer.

dpmsd deliver -computer_host comphost001 -package_name "Apache HTTP Server 2.2.3 2.2.3" -procedure_name Install -os_type Windows -computer_username administrator

Example: Deliver a Software Package to a Host in a Multiple ITCM Domain Manager Environment

This example delivers a package containing a version of Apache software to a Windows host computer. This operation is routed to the sd adapter on ITCM domain manager domainmanager001.

dpmsd deliver -computer_host comphost001 -package_name "Apache HTTP Server 2.2.3 2.2.3" -procedure_name Install -os_type Windows -itcm_server domainmanager001 -computer_username administrator