The servicetools script

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

Product

This script is available in WebSphere Application Server and WebSphere Application Server Network Deployment.

Authority

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

Syntax

The syntax of the script is:

servicetools [ -products product_list [ -instances instance_list ] ]
  [ -input input_file ] [ -output output_file ] [ -trace trace_file ]
  [ -tools tool_options ]

Parameters

The parameters of the script are:

• -products
  Optional. 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 WAS50Base, WAS50ND, WAS50Express, WAS40Adv, WAS40AEs, and ALL. If you do not specify this parameter, specify the -products parameter for each tool as appropriate.

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

• -instances
  Optional. The value instance_list specifies the instance or instances for which you want to run the tools. If you specify multiple instances, separate them with a colon (:). If you do not specify this parameter, the tools run for all of the instances in the products specified by the -products parameter.

• -input
  Optional. 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
  Optional. 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
  Optional. 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 on 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 on 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.