Reference Guide › Command-Line Scripting › Policy Commands › dpmpolicy findcandidatemachine Command--Find the Candidate Servers

dpmpolicy findcandidatemachine Command--Find the Candidate Servers

The dpmpolicy findcandidatemachine command finds the servers that match user-defined specifications.

This command has the following format:

dpmpolicy findcandidatemachine [-sc sc_url] [-machine_list machinelist] -constraint Source:OP:Value [-constraint Source:OP:Value] [-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

-machine_list machinelist

(Optional) Specifies the list of available servers. Valid entry: Comma-separated machine names.

-constraint={Source:OP:Value},...

Defines the specifications that the candidate servers must meet. Options include the following:

Source={MEMORY|CPUSPEED|STORAGE|ARCH}

Specifies the type of constraint and an associated value.

MEMORY

Specifies a memory constraint.

Limits: MB

CPUSPEED

Specifies a CPU processing speed constraint.

Limits: MHz

STORAGE

Specifies a storage constraint.

Limits: MB

ARCH

Specifies a hardware constraint.

Limits: X86, SPARC, PA-RISC, POWERPC or X64.

OP={EQ|NEQ|GT|GTE|LT|LTE}

Specifies an operand. Operands include the following:

EQ=equal to

NEQ=not equal to

GT=greater than

GTE=greater than or equal to

LT=less than

LTE=less than or equal to

-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: Find Servers

This example finds servers with more than 2000 MB of system memory.

dpmpolicy findcandidatemachine -constraint MEMORY:GT:2000

Example: Find Servers in the List

This example finds servers with more than 2000 MB of system memory and 2400 MHz of CPU or more from the provided list of servers.

dpmpolicy findcandidatemachine -constraint MEMORY:GT:2000 -constraint CPUSPEED:GTE:2400 -machine_list alert.ca.com, 141.202.224.59