Previous Topic: dpmsd imgjobcheck Command--Get OS Imaging Job Status

Next Topic: dpmsd list Command--List Software Packages


dpmsd installSDAgent--Install Software Delivery Agent

The dpmsd installSDAgent command installs the Software Delivery agent on a host computer.

This command has the following format:

installSDAgent [-sc sc_url] -computer_host computerhostname [-scalability_server scalability server] [-itcm_server itcm domain manager ]  -computer_username computerusername [-computer_password computerpassword][-auth_file authorizationfile][-auth_comp componentID] -os_type ostype [-pre][-post][[-ws_user username -ws_password password]|[-prompt <yes|no>]][-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

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

-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: Install SD Agent on Linux System

This example installs the sd agent on a Linux system.

dpmsd installSDAgent -computer_host comphost001 -computer_username administrator -computer_password adminpassword -os_type LINUX -pre -post -ws_user wsuser -ws_password wsuserpassword 

Example: Install SD Agent on Linux System in a Multiple ITCM Domain Manager Environment

This example installs the sd agent on a Linux system. This operation is routed to the sd adapter on ITCM domain manager domainmanager001.

dpmsd installSDAgent -computer_host comphost001 -itcm_server domainmanager001 -computer_username administrator -computer_password adminpassword -os_type LINUX -pre -post -ws_user wsuser -ws_password wsuserpassword