Reference Guide › Command Line Scripting › Rapid Server Imaging Commands › dpmrsi deploy Command--Deploy RSI Image

dpmrsi deploy Command--Deploy RSI Image

Use the dpmrsi deploy command to deploy an RSI image captured previously from a server to a target system.

This command has the following format:

dpmrsi deploy

[-sc sc_url]
[-baremetal yes|no -system_type virtual|physical -ostype OStype]
-name imagename
[-desc imagedescription]
[-scale yes|no]
[-depot depotname]
[-profile profilelocation]
[-profile_hostname hostname]
[-profile_driverset driverset]
[-profile_addressX staticnetworkaddress]
[-profile_dhcpX yes|no]
[-profile_interfaceidX interfaceID]
[-profile_netmaskX netmask]
[-boot_network bootnetwork]
-serverid targetserverid|-macaddr targetMACaddress
-img_host RSIserver
-dc_user RSIapplicationuser -dc_password RSIapplicationpassword
[-ws_user username -ws_password password]
[-locale iso639value]

-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

-baremetal yes|no -system_type virtual|physical -ostype OStype

Specifies bare metal system parameters, where the default = no. If you specify -baremetal 'yes', specify the system_type and the ostype. Valid entries: -baremetal = yes or no, -system_type = virtual or physical, ostype = any ostype returned from the command, dpmrsi osspec <credentials>.

-name imagename

Defines the name of the RSI image.

-desc imagedescription

Defines text for easy identification. Valid entries: any alphanumeric characters.

-profile profilelocation

(Optional) Specifies the location of a profile, which contains a configuration of the target system for use during image deployment. If you do not specify a profile, the system configuration where the image is captured is used. Specify a hyperlink to the profile in the format: http://..., or the UNIX path of the profile location on the RSI server.

Example: /root/profiles/ServerA_capture_win2k3

Note: If you specify the profile location without specifying -profile parameters in the command, the profile values are used. If you specify profile-related parameters in the command, the values that you specify are used instead of the values in the profile.

-profile_hostname hostname

(Optional) Defines the hostname for the target system after image deployment. Valid entries: any alphanumeric character.

-profile_driverset driverset

(Optional) Defines the driverset to apply to the target system after image deployment. Valid entries: any alphanumeric characters.

-profile_address1|2|3 ipnetworkaddress

(Optional) Defines the network interface (1, 2, or 3), and its IP address for the target system. This parameter must be provided if the value for profile_dhcp = no. Valid entries: xxx.xxx.xxx.xxx.

-profile_dhcp1|2|3 yes|no

(Optional) Defines the network interface (1, 2, or 3) for the target system, and whether it is configured for DHCP. Valid entries: yes = DHCP, no = static IP address.

-profile_interfaceid1|2|3

(Optional) Defines the integer index of the network interface for the target system during image deployment. Valid entries: 1, 2, or 3.

-profile_netmask1|2|3 netmask

(Optional) Defines the network interface (1, 2, or 3) and the netmask. This parameter must be provided if the value for profile_dhcp = no. Valid entries: netmask in dot notation.

-scale yes|no

Indicates whether to resize the image to fit the available storage space. If you specify yes, the image is scaled up or down to fit the available storage on the target server. File systems and logical volumes are scaled based on the data they contain. Swap space and raw partitions are not scaled. If the image contains more data than fits on the server storage, the operation fails.

Default: yes

-depot depotname

(Optional) Specifies the name of the RSI depot.

Example: mydepot

Default: If the -depot switch is not specified, the default depot is used.

-boot_network networkname

Defines the name of the registered boot network on the RSI server. This parameter is required only if there is more than one network (default) registered with the RSI server. Valid entry: any alphanumeric characters.

-serverid target server ID | -macaddr targetMACaddress

Defines the server ID or MAC address of the Rapid Server Imaging target. -macaddr takes precedence when both -serverid and -macaddr parameters are specified.

-img_host RSIserver

Defines the name of the RSI server.

-dc_user RSIapplicationuser

Defines the RSI application user name.

-dc_password RSIapplicationpassword

Defines the password for the RSI application user.

-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: Deploy RSI Image

This example deploys an RSI image to a server with the MAC address, 00:0C:F1:56:98:AD.

dpmrsi deploy

-name testimage1
-profile http://profileserver/profiles/testprofile2
-macaddr 00:0C:F1:56:98:AD
-img_host rsiserver1
-dc_user user2 -dc_password pass2
-ws_user wsuser -ws_password wsuserpassword