WebSphere Application Server - Express, Version 6.0.x     Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Using the installation verification tools

This topic describes how to use the installation verification tools. The installation verification tools verify that the installation of the application server profile is successful. A profile consists of files that define the run-time environment for an application server. Each profile has its own installation verification tools.

Before you begin

After installing the product, you are ready to use the installation verification tools.

Why and when to perform this task

Use the installation verification tools to gain assurance that the product is successfully installed. Two tools exist. This task describes when and how to use to both tools. One tool is the checksum tool (the installver tool). The installver tool compares the checksum of each installed file to the correct checksum value for each file and reports differences. The other tool is the installation verification test (IVT). The IVT tests deployment manager profiles and stand-alone application server profiles to make sure that the server processes can start.

The IVT program scans product log files for errors and verifies core functionality of the product installation.

After installing the product, the Installation wizard displays a prompt for starting the First steps console.

Installation verification is the first option on the First steps console.

The test consists of starting and monitoring the application server during its start up.

Steps for this task

  1. Run the installver tool to verify that the installation correctly installed all files.

    See the description of the installver command for more information.

  2. Use the installation verification test to verify the proper creation of profiles.
    1. Select Installation verification on the First steps console after installing the product.

      You can also start the First steps console from the command line, as described in firststeps command.

      You can also start the ivt command directly from the bin directory of the profile:
      • [Linux][UNIX]install_root/profiles/default/bin/ivt.sh
      • [Windows]install_root\profiles\default\bin\ivt.bat

      If you create additional profiles, the ivt script location is within the profile_home/bin directory.

    2. Observe the results in the First steps status window.

      The log file for installation verification is the install_root/profiles/default/logs/ivtClient.log file. If you create additional profiles, the file path is profile_home/logs/ivtClient.log.

      The IVT provides the following useful information about the application server:
      • The application server name
      • The name of the profile
      • The profile file path
      • The type of profile
      • The node name
      • The current encoding
      • The port number for the administrative console
      • Various informational messages that include the location of the SystemOut.log file and how many errors are listed within the file
      • A completion message

      As the IVT starts the application server on a Windows platform, the IVT attempts to start the Windows service for the application server, if a Windows service exists. This is true even though the Windows service might have a manual startup type.

      See Automatically restarting server processes for more information.

    3. If the log shows that errors occurred during the installation verification, correct the errors and run the IVT again. If necessary, create a new profile after correcting the error, and run the IVT on the new profile.

Result

The installver tool validates the integrity of all installed files.

The IVT tool starts the server process of a profile automatically if the server is not running. Once the server initializes, the IVT runs a series of verification tests. The tool displays pass or fail status in a console window. The tool also logs results to the profile_home/logs/ivtClient.log file. As the IVT verifies your system, the tool reports any detectable errors in the SystemOut.log file.

What to do next

After installing the product and verifying the installation, you can configure the installation by creating more profiles.

You can also install other packages on the product installation image, such as IBM HTTP server, the Web server plug-ins, or the Application Client.

See Task overview: Installing for more information.




Sub-topics
ivt command
installver command

Related tasks
Installing the product and additional software
Task overview: Installing

Related reference
firststeps command

Task topic    

Terms of Use | Feedback

Last updated: Jun 8, 2005 12:45:23 PM EDT
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.express.doc/info/exp/ae/tins_ivt.html

© Copyright IBM Corporation 2004, 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)