Reference Guide › Command Line Scripting › Rapid Server Imaging Commands › dpmrsi capture Command--Capture RSI Image

dpmrsi capture Command--Capture RSI Image

Use the dpmrsi capture command to capture Rapid Server Imaging images and store them for later deployment.

This command has the following format:

dpmrsi capture

[-sc sc_url]
-name imagename
[-desc imagedescription]
[-type capturetype]
[-profile profilelocation]
-serverid targetserverid|-macaddr targetMACaddress
-ostype OStype
[-depot depotname]
[-excludefs filesystems]
[-boot_network bootnetwork]
-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

-name imagename

Defines the name of the RSI image.

-desc imagedescription

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

-type capturetype

Defines the type of capture to perform. Valid entries: offline and live.

Default: live

-profile profilelocation

(Optional) Specifies a location to store the profile, which contains a configuration of the captured system for use during image deployment. Specify a hyperlink to the profile location in the format: http://..., or the UNIX path of the profile location on the RSI server.

Example: /root/profiles/ServerA_capture_win2k3

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

-ostype OStype

Defines the OS configuration for the target server. Run the osspec command for a list of OS configurations for the OS types, and select the appropriate OS configuration for the target server. To list the OStypes supported by the RSI server, run the command, dpmrsi osspec -img_host RSIServer -dc_user RSIapplicationuser -dc_password RSIapplicationpassword.

Example: Microsoft_Windows-2003_*_*-*

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

-excludefs filesystems

(Optional) (Windows and Linux/Unix only) Specifies a list of case-sensitive comma-separated filesystem paths to exclude from the captured image.

Example: "E,F" excludes drives E and F from a captured Windows image.

Example: "/images" excludes any filesystems named 'images' from a captured Linux image.

Important! Excluding root filesystems or other essential boot or swap filesystems may make the captured image unusable.

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

-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: Capture an RSI Image

This example captures an RSI image from a server with the server_id OEM:01.

dpmrsi capture

-name testimage1
-desc "win2k3 server capture from OEM:01"
-ostype Microsoft_Windows-2003_*_*-* -type offline
-profile http://profileserver/profiles/testprofile1
-server_id OEM:01
-img_host rsiserver1
-dc_user user2 dc_password pass2
-ws_user wsuser -ws_password wsuserpassword