servicetools command

The servicetools command includes serviceability tools that you can use to troubleshoot WebSphere Application Server.

To run this script, your user profile must have *ALLOBJ authority.

Syntax

servicetools [-products product_list [-profiles profile_list]]
 [-input input_file] [-output output_file] [-trace trace_file]
 [-tools tool_options] [-help]

Parameters

The following options are available for the servicetools command:

-products

This is an optional parameter. The value product_list specifies the list of products for which you want to run the tools. If you specify multiple products, separate them with a colon (:). Valid products are WAS61Base, WAS61ND, WAS61Express, WAS60Base, WAS60ND, WAS60Express, WAS51Base, WAS51ND, WAS51Express, WAS51PME, WAS51PMEND, WAS50Base, WAS50ND, WAS50Express, WAS40Adv, WAS40AEs, and ALL. If you do not specify this parameter, specify the -products parameter for each tool as appropriate.

Not all tools require that you specify a product. This parameter applies only to those tools that require that you specify a product.

-profiles

This is an optional parameter. The value profile_list specifies the profile or profiles for which you want to run the tools. If you specify multiple profiles, separate them with a colon (:). If you do not specify this parameter, the tools run for all of the profiles in the products specified by the -products parameter.

-input

This is an optional parameter. The value input_file specifies an alternate XML Configuration file for the service tools. By default, the servicetools script uses the validator.xml file that is included in the ServiceTools.jar file.

-output

This is an optional parameter. The value output_file specifies a file to which the script writes standard output. If this value is not specified, the script writes the standard output to the display.

-trace

This is an optional parameter. The value trace_file specifies a file to which the script writes trace information. If you do not specify this parameter, the script does not generate trace information.

-tools

This parameter specifies the tool or tools that you want to run. The value tools specifies the tool that you want to run. The value tool_options specifies the parameters for the tool. These are the valid values for -tools:

• -checkprereqs If you specify this parameter, the script starts the prerequisite validator tool. For information about this tool and its parameters, see The prerequisite validator tool.

• -portconflict If you specify this parameter, the script starts the port validator tool. For information about this tool and its parameters, see The port validator tool.

You must specify all other parameters before you specify the tools parameter. You must specify the options for each tool after its parameter. You can specify more than one tool when you run the servicetools script. To run multiple tools, use this format:

servicetools parameters -tool1 tool1_options -tool2 tool2_options

-help

This optional parameter displays the usage statement for the script.

Related tasks

Reference topic