test run
Applies To: Microsoft HPC Pack 2012, Microsoft HPC Pack 2012 R2
Runs the specified diagnostic test on one or more specified nodes, or on all nodes if no nodes are specified.
For examples of how to use this command, see Examples.
Syntax
test run {<test_alias> | /testid:<identifier>} [/company:<company_name>]
[/nodes:<node1>[,<node2>,[<node3>[,...]]]]
[/username:[<domain>\]<user_name> /password:<password>]
[/<parameter1_name>:<value1> [/<parameter2_name>:<value2> [...]]]
[/server:<server_name>]
test run {/? | /help}
Parameters
Parameter |
Description |
|---|---|
<test_alias> |
Specifies the alias for the diagnostic test that you want to run. You must specify the <test_alias> or the /testid parameter. If you specify both the <test_alias> and /testid parameters, the <test_alias> parameter is ignored. If your HPC cluster includes two tests with the same alias from different companies, specify the /company parameter in addition to the <test_alias> parameter to specify the test that you want to run. |
/testid:<identifier> |
Specifies the numeric identifier for the test that you want to run. You must specify the /testid or the <test_alias> parameter. If you specify both the /testid and <test_alias> parameters, the <test_alias> parameter is ignored. |
/company:<company_name> |
Specifies the company that created the diagnostic test that you want to run. Specify the company if your HPC cluster includes two diagnostic tests with the same alias from different companies. If the company name includes spaces, enclose the company name in quotation marks ("). |
/nodes:<node1>[,<node2>,[<node3>[,...]]] |
Specifies a list of one or more nodes on which to run the diagnostic test. When you specify multiple nodes, separated them with commas (,). If you do not specify the /nodes parameter, the test runs on all of the nodes in the HPC cluster. |
/username:[<domain>\]<user_name> |
Specifies the user name for the account that the test should use to run the commands in the test. If you specify the /username parameter, you must also specify the /password parameter. |
/password:<password> |
Specifies the password for the account that the test should use to run the commands in the test. If you specify the /password parameter, you must also specify the /username parameter. |
/<parameterN_name>:<valueN> |
Specifies that value to use for a parameter of the diagnostic test. |
/server:<server_name> |
Specifies the host name or IP address of server that hosts the HPC Diagnostics Service for the HPC cluster on which you want to run the test. The value must be a valid computer name or IP address. If you do not specify the /server parameter, this command uses the head node that the CCP_SCHEDULER environment variable specifies. |
/? |
Displays Help at the command prompt. |
/help |
Displays Help at the command prompt. |
Remarks
To get a list of diagnostic tests that are installed on the cluster that includes their identifiers and aliases, use the test listtests command.
To view information about the parameters of a diagnostic test or about the company that provided a diagnostic test, use the test viewtest command.
You must be a cluster administrator to run this command successfully.
Examples
To run the diagnostic test with an alias of MyDailyTest on all of the nodes in the HPC cluster, type:
test run MyDailyTest
To run the diagnostic test with an identifier of 68 on the nodes named ComputeNode1, ComputeNode2, and ComputeNode3, type:
test run /testid:68 /nodes:ComputeNode1,ComputeNode2,ComputeNode3
To run the diagnostic test with an alias of WeeklyTest, using the account with a user name someone in the CONTOSO domain and a password of MyPassword, type:
test run WeeklyTest /username:CONTOSO\someone /password:MyPassword
To run the diagnostic test with an identifier of 49, using a value of 12 for the count parameter of the test and a value of true for the verbose parameter of the test, type:
test run /testid:49 /count:12 /verbose:true