Running the prerequisite checker

Complete the following steps to run the stand-alone prerequisite checker.

There are several TADDM configurations for which prerequisites can be checked. We categorize them by size, type of deployment, and server type. The size of a deployment is defined in terms of the number of server equivalents (SEs). The following deployment size groupings are used:
  • Small deployment: Fewer than 2,000 SEs
  • Large deployment: 2,000 - 10,000 SEs
  • Enterprise deployment: More than 10,000 SEs
You can run the prerequisite scanner in the following two ways:
Quick run
In quick-run mode, you can use ready-to-run scripts that set all of the required parameters for the prerequisite checker.
Custom
In custom mode, you must provide all of the required (and optional) parameters for the prerequisite checker.
Run the prerequisite checker in either quick or custom mode. Complete one of the following sets of steps:
  • To run the prerequisite checker in quick-run mode, complete the following steps:
    1. (Optional) Copy the prerequisite checker for the appropriate operating system to the target computer.
    2. Open a command-line interface:
      • On the Windows operating system, open a Command Prompt.
      • On Linux® and UNIX operating systems, open a shell environment.
    3. Change to the directory where the prerequisite checker is located and run the appropriate script for your environment.
      For the Windows operating system, the following scripts are available:
      Script Product
      taddm_domain_small.bat IBM® Tivoli Application Dependency Discovery Manager Domain Server - Small
      taddm_domain_large.bat IBM Tivoli Application Dependency Discovery Manager Domain Server - Large
      taddm_domain_enterprise.bat IBM Tivoli Application Dependency Discovery Manager Domain Server - Enterprise
      taddm_domain_database_small.bat Database Server for IBM Tivoli Application Dependency Discovery Manager Domain Server - Small
      taddm_domain_database_large.bat Database Server for IBM Tivoli Application Dependency Discovery Manager Domain Server - Large
      taddm_domain_database_enterprise.bat Database Server for IBM Tivoli Application Dependency Discovery Manager Domain Server - Enterprise
      taddm_streaming_small.bat IBM Tivoli Application Dependency Discovery Manager Discovery or Storage Server - Small
      taddm_streaming_large.bat IBM Tivoli Application Dependency Discovery Manager Discovery or Storage Server - Large
      taddm_streaming_enterprise.bat IBM Tivoli Application Dependency Discovery Manager Discovery or Storage Server - Enterprise
      taddm_streaming_database_small.bat Database Server for IBM Tivoli Application Dependency Discovery Manager Storage Server - Small
      taddm_streaming_database_large.bat Database Server for IBM Tivoli Application Dependency Discovery Manager Storage Server - Large
      taddm_streaming_database_enterprise.bat Database Server for IBM Tivoli Application Dependency Discovery Manager Storage Server - Enterprise
      For Linux and UNIX operating systems, the following scripts are available:
      Script Product
      taddm_domain_small.sh IBM Tivoli Application Dependency Discovery Manager Domain Server - Small
      taddm_domain_large.sh IBM Tivoli Application Dependency Discovery Manager Domain Server - Large
      taddm_domain_enterprise.sh IBM Tivoli Application Dependency Discovery Manager Domain Server - Enterprise
      taddm_domain_database_small.sh Database Server for IBM Tivoli Application Dependency Discovery Manager Domain Server - Small
      taddm_domain_database_large.sh Database Server for IBM Tivoli Application Dependency Discovery Manager Domain Server - Large
      taddm_domain_database_enterprise.sh Database Server for IBM Tivoli Application Dependency Discovery Manager Domain Server - Enterprise
      taddm_streaming_small.sh IBM Tivoli Application Dependency Discovery Manager Discovery or Storage Server - Small
      taddm_streaming_large.sh IBM Tivoli Application Dependency Discovery Manager Discovery or Storage Server - Large
      taddm_streaming_enterprise.sh IBM Tivoli Application Dependency Discovery Manager Discovery or Storage Server - Enterprise
      taddm_streaming_database_small.sh Database Server for IBM Tivoli Application Dependency Discovery Manager Storage Server - Small
      taddm_streaming_database_large.sh Database Server for IBM Tivoli Application Dependency Discovery Manager Storage Server - Large
      taddm_streaming_database_enterprise.sh Database Server for IBM Tivoli Application Dependency Discovery Manager Storage Server - Enterprise
    4. After the prerequisite scanner completes, detailed scan information is displayed. The results are also saved locally.

      On the Windows operating system, the results are saved to %TMP%\taddm\prs.

      On Linux and UNIX operating systems, the results are saved to /tmp/taddm/prs.

  • To run the prerequisite checker in custom mode, complete the following steps:
    1. Copy the prerequisite checker for the appropriate operating system to the target computer.
    2. Open a command-line interface:
      • On the Windows operating system, open a Command Prompt.
      • On Linux and UNIX operating systems, open a shell environment.
    3. Change to the directory where the prerequisite checker is located and run the following command:
      • On the Windows operating system, run the prereq_checker.bat command.
      • On Linux and UNIX operating systems, run the prereq_checker.sh command.
The following input parameters are displayed:
Usage:  ./prereq_checker.sh "<Product Code>  [product version], <Product Code>  
[product version]..." [PATH=<Product install path>]  [detail]  
[-p <Product Code>.SECTION.NAME=VALUE pairs] [outputDir="<PRS output dir path>"] 
[xmlResult] [-health<active|inactive>]
Examples:
  • For the Windows operating system: prereq_checker.bat "TS1" outputDir="c:\PRS"
  • For Linux and UNIX operating systems: ./prereq_checker.sh "TS1" outputDir="/tmp/prereq_check_output/"
The following paragraphs provide a detailed description of the input parameters.
  • Product Code and product version pairs.

    At least one product code is required. For IBM TADDM, the code is a three-letter product code for the deployment type and size. For example, for a "small" domain deployment, you must enter TS1.

    Enter the product codes in upper-case letters. Multiple product codes must be comma-separated.

    Each component or agent has a config file with the naming convention *.cfg, for example TS1_07220000.cfg. If you specify a product code that does not have a corresponding *.cfg file, that product code is ignored.

    The product version parameter is not applicable to TADDM.

  • [PATH=product_install_path]
    The PATH parameter is optional. An example of the PATH parameter with a set value is PATH=D:\IBM\taddm. If you do not specify the PATH parameter, the prerequisite checker checks the following default IBM TADDM installation paths:
    • On the Windows operating system, the default path is C:\IBM\taddm.
    • On Linux and UNIX operating systems, the default path is /opt/IBM/taddm.
  • [detail]

    The detail parameter is optional. This flag indicates that you want to see detailed results on the screen when you run the prerequisite checker.

    Do not enclose the word detail in quotation marks.

    If you do not specify the detail parameter, then only PASS or FAIL is displayed on the screen. Omitting this parameter is a simple way to see whether your system meets the prerequisites.

    The detailed output is written to the precheck.log file, regardless of whether you specify the detail parameter or not. You can view this file to see the results of the prerequisite checker. You can also view the result.txt file to see the detailed steps that were taken by the prerequisite checker.

  • [outputDir=fully_qualified_path]

    When you run the prerequisite checker from a read-only media or from a directory without write permissions, you must set this parameter to the fully qualified path and place that value in quotation marks. The outputDir option is case-sensitive.

  • [-health active|inactive]

    This parameter is not applicable to TADDM.

The following specific product codes are available:
Table 1. Product codes
Code Product
TS1 IBM Tivoli Application Dependency Discovery Manager Domain Server - Small
TS2 IBM Tivoli Application Dependency Discovery Manager Domain Server - Large
TS3 IBM Tivoli Application Dependency Discovery Manager Domain Server - Enterprise
TS4 Database Server for IBM Tivoli Application Dependency Discovery Manager Domain Server - Small
TS5 Database Server for IBM Tivoli Application Dependency Discovery Manager Domain Server - Large
TS6 Database Server for IBM Tivoli Application Dependency Discovery Manager Domain Server - Enterprise
TS7 IBM Tivoli Application Dependency Discovery Manager Discovery or Storage Server - Small
TS8 IBM Tivoli Application Dependency Discovery Manager Discovery or Storage Server - Large
TS9 IBM Tivoli Application Dependency Discovery Manager Discovery or Storage Server - Enterprise
TSA Database Server for IBM Tivoli Application Dependency Discovery Manager Storage Server - Small
TSB Database Server for IBM Tivoli Application Dependency Discovery Manager Storage Server - Large
TSC Database Server for IBM Tivoli Application Dependency Discovery Manager Storage Server - Enterprise