ivt command

The ivt command starts the installation verification test (IVT) program. The IVT verifies that the installation of the application server or deployment manager profile was successful. A profile consists of files that define the runtime environment for a deployment manager or an application server. Each profile has its own ivt command.

New feature New feature: This topic references one or more of the application server log files. Beginning in WebSphere Application Server Version 8.0 you can configure the server to use the High Performance Extensible Logging (HPEL) log and trace infrastructure instead of using SystemOut.log , SystemErr.log, trace.log, and activity.log files or native z/OS logging facilities. If you are using HPEL, you can access all of your log and trace information using the LogViewer command-line tool from your server profile bin directory. See the information about using HPEL to troubleshoot applications for more information on using HPEL.newfeat

The IVT program starts the application server or deployment manager automatically if the server process 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.

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 script for a profile is the profile_root/bin directory. The script file name is:
  • ivt.sh
  • ivt.bat

Parameters

The following parameters are associated with this command.

server_name
Required parameter that identifies the name of the server process, such as server1 or dmgr
profile_name
Required parameter that identifies the name of the profile that contains the 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:
  • profile_root/bin/ivt.sh
  • profile_root\bin\ivt.bat

Logging

The ivt command logs results to the profile_root/logs/ivtClient.log file.

New feature New feature: This topic references one or more of the application server log files. Beginning in WebSphere Application Server Version 8.0 you can configure the server to use the High Performance Extensible Logging (HPEL) log and trace infrastructure instead of using SystemOut.log , SystemErr.log, trace.log, and activity.log files or native z/OS logging facilities. If you are using HPEL, you can access all of your log and trace information using the LogViewer command-line tool from your server profile bin directory. See the information about using HPEL to troubleshoot applications for more information on using HPEL.newfeat

Example

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

ivt.sh server1 profile01 -p 9081 -host myhost
ivt.bat server1 profile01 -p 9081 -host myhost



Related tasks
Using the installation verification tool
Reference topic Reference topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Feb 6, 2014 11:19:27 PM CST
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=matt&product=was-nd-dist&topic=rinsivt
File name: rins_ivt.html