ivt command

The ivt command starts the installation verification test (IVT) program. The IVT program verifies that the installation of WebSphere Process Server using a stand-alone profile or a deployment manager profile was successful.

The IVT program starts the server process automatically if it is not already running. After the server process initializes, the IVT runs a series of verification tests and displays pass or fail status in a console window and writes results to a log file. IVT checks both whether WebSphere Application Server and WebSphere Process Server have been installed correctly.
Note: If you have installed WebSphere Process Server immediately after you have installed WebSphere Application Server, then you need to run only the WebSphere Process Server installation verification test, rather than running the separate installation verification test programs of both WebSphere Application Server and WebSphere Process Server.

The IVT program scans the SystemOut.log file for errors and verifies core functionality of the profile.

You can start the IVT program from the command line or from the First steps console.

Location of the command file

The location of the installation verification test program for a profile is:
  • On Linux platforms:On UNIX systems:install_root/profiles/profile_name/bin/wps_ivt.sh
  • On Windows platforms:install_root\profiles\profile_name\bin\wps_ivt.bat

If you create a profile in a location other than install_root/profiles/profile_name, the test program will be located within the profile_name directory.

Parameters

The following parameters are associated with this command.

server_name
Required parameter that identifies the name of the application server process, such as server1 or dmgr.
profile_name
Required parameter that identifies the name of the profile that contains the process server definition.
-p server_port_number
Optional parameter that identifies the default_host port when the port is not 9080, which is the default.
-host machine_host_name
Optional parameter that identifies the host machine of the profile to test. The default is localhost.

Syntax for the ivt command

Use the following syntax for the command:
  • On Linux platforms:On UNIX systems:install_root/profiles/profile_name/bin/wps_ivt.sh
  • On Windows platforms:install_root\profiles\profile_name\bin\wps_ivt.bat

Logging

The ivt command logs results to the following files:
  • install_root/profiles/default/logs/wps_ivtClient.log for installation
  • profile_home/logs/wps_ivtClient.log for additional profiles.

Example

The following examples test the server1 process in the profile01 profile on the myhost machine using the default_host on port 9081.

On Windows platforms:
wps_ivt.bat server1 profile01 -p 9081 -host myhost
On Linux platforms:On UNIX systems:
wps_ivt.sh server1 profile01 -p 9081 -host myhost

Parent topic: Using the installation verification tool