dmsweep deploy

dmsweep--DSM Deployment Command Line Interface › dmsweep Subcommands › dmsweep deploy

dmsweep deploy

The dmsweep deploy command attempts deployment of the specified package to the specified list of target computers.

The subcommand has the following format:

deploy

[/manager <manager_machine>] 
[/musername <manager_username> /mpassword <manager_password>] 
[/mfilename <manager_filename>] 
{/ip <address_wild> [/toip <stop_address>] | /ipfilename <ip_filename> | /domain <domain_name> (WinNT only) 
| /uri <uniform resource identifier> 
| /targetcred <target_credentials_file> 
| /query <query_name> }
[/tusername <target_username> /tpassword <target_password> | /epassword <encrypted_password>] 
[/tfilename <target_filename>] | 
{/packagenum <package_number> | /product <product_name> /package <package_name> [/version <version>] [/platform <platform>] [/language <language>]} 
[/pparams <package_parameters>] 
[/jobname <job_name>] 
[/sserver <scalability_server_machine>
 /ssusername <scalability_server_username> /sspassword <scalability_server_password>]
 [/primerargs <primer install arguments>]

/manager

Specifies the name of the manager from which to retrieve the package list. If you omit /manager, the current machine is assumed.

/musername

Specifies the username for the manager computer.

/mpassword

Specifies the password for the manager computer.

If <manager_password> is not supplied, dmsweep will prompt the value when the command is executed.

/mfilename

Lets you read the name of the manager and details of its username and password from a file.

The format of this file is described in the packages section.

/ip

Start address from which to scan.

You can specify an address as a machine name, if it can be successfully resolved (for example, by DNS), or as an IP address (for example 10.0.0.1). The <address_wild> argument enables you to use asterisks (for example, 10.0.0.* covers the range 10.0.0.1 to 10.0.0.254 and 10.0.*.* covers the range 10.0.0.1 to 10.0.255.254.

You can specify a single address for <address_wild> or a comma-separated list of addresses.

/toip

End address for the range to scan.

If you specify /toip in conjunction with /ip, the scan starts with the address specified by <address_wild> and stops after scanning <stop_address>.

/ipfilename

If you specify /ipfilename, the command reads the list of target machines is from the file <ip_filename>. Each line of the file contains a single target address or multiple addresses separated by commas, for example:

machine1

machine2, machine3, 10.0.0.1

machine5

/domain

If a deployment manager is on a Windows-based computer, you can use /domain to scan the computers in the specified domain.

/uri

If you specify /uri you can use a uniform resource identifier to specify target computers to read from an external directory.

/targetcred

If you specify /targetcred, the command reads the list of target machines and connection credentials from the file <target_credentials_file>.

/query

If /query is specified, the list of targets will be generated when the unmanaged asset query identified by <query_name> is run.

/packagenum

Package number of the package to be scanned for. The output from the dmsweep packages command describes the valid values.

Note: Use of the /packagenum option allows rapid specification of packages, but be aware that the package numbers may differ as new packages are added to the deployment package library. If you wish to identify packages in a non-variant way (for example when writing batch scripts), use the package identification options below.

/product

The product name (for example "CA Unicenter DSM") to be scanned for. The output from the dmsweep packages command describes the valid values.

/package

The package name (for example "Agent + all agent plugins") to be scanned for. The output from the dmsweep packages command describes the valid values.

/version

Version of the package (for example "11.2.0.1234") to be scanned for. The output from the dmsweep packages command describes the valid values. Optional but if you do not supply enough information to uniquely identify the package an error is displayed.

/platform

Platform property of the package (for example "Linux x86") to be scanned for. The output from the dmsweep packages command describes the valid values. Optional but if you do not supply enough information to uniquely identify the package an error is displayed.

/language

Language property of the package (for example "ENU") to be scanned for. The output from the dmsweep packages command describes the valid values. Optional but if you do not supply enough information to uniquely identify the package an error is displayed.

/tusername

Specifies the username for connecting to the target. If your deployment manager has already deployed packages to the target computer, credentials may not be required.

/tpassword

Specifies the password for connecting to the target. If your deployment manager has already deployed packages to the target computer, credentials may not be required.

If you specify /tusername but omit <target_username>, the user is prompted for the username. If you specify /tpassword but omit <target_password>, the user is prompted for the password, which will not be displayed on the screen.

/epassword

Specifies the password in encrypted form. This option alerts dmsweep to this format and the password will be decrypted before being used. See Encrypted Passwords.

/tfilename

If a target needs authentication and /tfilename has been specified, <target_filename> is searched. If an entry exists, the credentials specified in the file are used for the target, otherwise /tusername and /tpassword are used. The file <target_filename> contains one target per line, with each line containing the target's machine name (or IP address), username and password, for example:

10.0.0.1 username1 password1

10.0.0.2 username2 password2

* username3 password3

An entry with '*' as the target name denotes default credentials for any target not explicitly listed in the file.

/pparamsT

Specifies a comma-separated list of parameters to replace $1$, $2$ and so on on the package install command line. To display the command line along with the expected format and description of each parameter use dmsweep's packages command. For a list of installation options valid for the different agent and server deployment packages, see the CA ITCM Implementation Guide.

/primerargs

Specifies non-default installation arguments (for example non-default installation locations) to the dmprimer installation (but not the agent or server installation). The install arguments are passed unmodified to the installation command line on the computer on which a primer is to be installed. For a list of valid installation options, see the CA ITCM Implementation Guide.

/jobname

Specifies the name of the job is set to the supplied <job_name> argument; otherwise it will be generated automatically based on the current date and time.

/sserver

Forces the target machines to obtain their packages from a scalability server. If not specified the package is obtained from the manager machine.

/ssuserame

Specifies the username for connecting to the scalability server.

/sspassword

Specifies the password for connecting to the scalability server.

Note: If you specify /ssusername but omit <scalability_server_username>, the user is prompted for the username. If you specify /sspassword but omit <scalability_server_password>, the user is prompted for the password, which will not be displayed on the screen.

Note: You can use <target_credentials_file> instead of <ip_filename> and <target_filename>. For details of /targetcred, see The Target Credentials File.

Examples:

Following you will find some examples showing the various possibilities of the deploy subcommand:

To deploy to a target through a local manager use the command

dmsweep deploy /ip <target machine > /pn 2 /pparams <myserver>,,

To deploy a package to a target computer that needs credentials using the local manager, enter the following command:
```
dmsweep deploy /ip <machine name> /pn 2 /pparams <myserver>,, /tu <target username> /tp <target password>
```
To deploy a package to a target computer that needs credentials wherein the password may be encrypted, enter the following command:
```
dmsweep deploy /ip <machine name> /pn 2 /pparams <myserver>,, /tu <target username> /ep <encrypted password>
```
The following example shows how you can use the dmsweep command line utility to prompt for username and password.
dmsweep has a password prompting feature, which enables you to enter passwords without the password appearing on the screen. You can also prompt for usernames but they are displayed as they are typed. To prompt for the username or password, enter the option but do not supply a value, as shown in the following example.

To deploy a package to a target using the local manager with password and username prompting, enter the following command:
```
dmsweep deploy /ip <target machine> /pn 2 /pparams <myserver>,, /tu  /tp
```
To deploy a package to a range of machines, where no credentials are required, enter the following command:
```
dmsweep deploy /ip 192.0.25.1 /toip 192.0.25.9 /pn 3 /pparams <myserver>,, 
```
To deploy to all the machines in a subnet (192.0.45) using a wildcard, enter the following command:
```
dmsweep deploy /ip 192.0.45.* /pn 3 /pparams <myserver>,,
```
You can also use wildcards to deploy to multiple subnets, enter the following command:
```
dmsweep deploy /ip 192.0.*.* /pn 1 /pparams <myserver>,,
```

To deploy to a target through a remote manager, enter the following command:

dmsweep deploy /ip <target machine> /pn 3 /mgr <remote manager> /mu <remote manager user> /mp <remote manager password> /tu <target user> /tp <target password>

To deploy to a target through a remote manager but with username and password prompting for both the manager and target machines, enter the following command:
```
dmsweep deploy /ip <target machine> /pn 3 /mgr <remote manager> /mu  /mp  /tu /tp 
```

Note: Replace values such as the package number, target computers and manager machines with suitable values.