Reference Guide › Command Line Scripting › Software Delivery Commands › dpmsd deployprocgrp Command--Deliver a Procedure Group

dpmsd deployprocgrp Command--Deliver a Procedure Group

The dpmsd deployprocgrp command delivers a procedure group to a host computer.

This command has the following format:

dpmsd deployprocgrp [-sc sc_url] -procedure_group_name proceduregroupname -computer_host computerhostname [-scalability_server servername] [-itcm_server itcmdomainmanager] -computer_username username [-computer_password password] [-auth_file authorizationfile] [-auth_comp componentID] -os_type {Windows|Linux|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

-procedure_group_name proceduregroupname

Defines a name for the software delivery procedure group.

-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 Procedure Group to a Host

This example delivers a procedure group to a Windows host computer.

dpmsd deployprocgrp -procedure_group_name Installations -computer_host comphost001 -computer_username administrator -os_type Windows

Example: Deliver a Procedure Group to a Host in a Multiple ITCM Domain Manager Environment

This example delivers a procedure group to a Windows host computer. This operation is routed to the sd adapter on ITCM domain manager domainmanager001.

dpmsd deployprocgrp -procedure_group_name Installations -itcm_server domainmanager001 -computer_host comphost001 -computer_username administrator -os_type Windows