Previous Topic: dpmec2 imgjobcheck Command--Get Amazon EC2 Imaging Job Status

Next Topic: dpmec2 run Command--Create Amazon EC2 Instance


dpmec2 manage Command--Manage Amazon Elastic Compute Cloud Instances

The dpmec2 manage command reboots or terminates Amazon EC2 instances.

Important! Back up all important data before you issue this command to avoid permanently losing unsaved data.

This command has the following format:

dpmec2 manage -instance all|instanceID[,instanceID]} [-sc sc_url] -operation {reboot|terminate|password} [-wait [timeout]] [-region region] [-pre] [-post][-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

-instance all|instanceID[,instanceID]

Specifies whether all instances or specific instances are managed.

all

Lists all instances.

instanceID[,instanceID]

Lists the specific instances.

-operation reboot|terminate|password

Specifies the action to perform on the specified list of instances.

reboot

Reboots the list of instances.

terminate

Permanently deletes the list of instances.

password

The Windows instance password.

-wait [timeout]

Defines a time in minutes to wait for an operation to complete or fail. Valid entries: 0=wait indefinitely. If you do not specify this option, an operation updates without waiting for completion. If you enter the wait option with no timeout value, the CLI uses the default wait time from the casdaconf.cfg (dpmsd only) or caimgconf.cfg (all other CLIs) files, or defaults to 120 minutes.

-region region

Defines any of the regions supported and defined by Amazon.

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

-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: Reboot All Instances

This example reboots all instances.

dpmec2 manage -instance all -operation reboot