IBM Tivoli Composite Application Manager for Application Diagnostics, Version 7.1.0.1

Performing a silent installation and configuration - J2EE Agent

The ITCAM for J2EE data collector supports the silent installation. In a silent installation, predefined parameters are used to replace user interface interactions. Silent installation is useful for advanced users who prefer to input installation information once through a response file instead of repeatedly inputting data in an installation procedure.

The following notes apply to silent installation and configuration:

  1. By default, the installer will create log files in the following directory: /var/ibm/tivoli/common/CYN/logs.

  2. By default, the configuration program will create the garbage collection logs in the file DC_home/ServerTypeServerVersion-gc-log.log.InstanceName.

  3. If you are using a startup script, the configuration program will produce a copy of the script as it was before the configuration. If a failure occurs after the configuration, you can use this copy of the script to switch back to the configuration of the application server before it was modified by the installer. The copy of the startup script will be named with a .orig extension. If the data collector configuration fails, no copy of the startup script gets produced, because the installer will not modify the original file.

You have the option to only install the data collector, both install and configure the data collector, or only configure the data collector using this procedure. If you only want to configure the data collector, perform this procedure after the data collector has been installed.

To run the silent installation command:

  1. Log on to the computer on which you want to install and configure the data collector as a user with the proper permissions (see Summary of permissions required for installing and configuring the data collector).

  2. Start the instance of the application server to be monitored by the data collector.

  3. Check the following Web site to see if the latest level of maintenance (such as fix packs or interim fixes) needs to be applied:
    http://www-306.ibm.com/software/sysmgmt/products/support/IBMTivoliCompositeApplicationManagerforJ2EE.html

    If there is no maintenance you need to apply, you have the option to perform both the installation and configuration by running the executable file once and using one response file.

    If there is maintenance you need to apply, run the installation and configuration separately. After you perform the silent installation and before you perform the silent configuration, apply the latest level of maintenance.

  4. If you will be configuring, or installing and configuring, the data collector, perform the applicable pre-configuration steps for the application server:


    Pre-configuration steps for application servers

    Application server type Pre-configuration steps
    WebLogic If a customized script is used for starting the server, see Pre-configuration steps for supporting customized startup script for WebLogic
    NetWeaver No pre-configuration steps required
    JBoss See Pre-configuration steps for Tomcat users

    If a customized script is used for starting the server, also see Pre-configuration steps for supporting customized startup script for JBoss

    If the Java Wrapper Service for Tomcat is used, also see Pre-configuration steps for supporting Java Service Wrapper for Tomcat

    Tomcat If a customized script is used for starting the server, see Pre-configuration steps for supporting customized startup script for Tomcat
    Oracle No pre-configuration steps required
    J2SE See Pre-configuration steps for J2SE users
    Sun Java System Application Server (JSAS) No pre-configuration steps required

  5. Specify configuration options in one of the following response file templates and save the file:


    Response file templates

    Application server type Sample response file
    WebLogic DC61_weblogic.opt
    NetWeaver DC61_netweaver.opt
    JBoss DC61_jboss.opt
    Tomcat DC61_tomcat.opt
    Oracle DC61_oracle.opt
    J2SE DC61_j2se.opt
    Sun Java System Application Server (JSAS) DC61_jsas.opt

    The file is located in /path/to/install/silent. See each of the following for guidance on how to modify the file:


    Application server specific silent install settings for UNIX/Linux

    Application Server Silent Installation Steps
    WebLogic Silent installation and configuration settings for WebLogic
    WebLogic Portal Server Silent installation and configuration settings for WebLogic Portal Server
    NetWeaver Silent installation and configuration settings for NetWeaver
    JBoss Silent installation and configuration settings for JBoss
    Tomcat Silent installation and configuration settings for Tomcat
    Oracle Silent installation and configuration settings for Oracle
    J2SE Silent installation and configuration settings for J2SE
    Sun Java System Application Server (JSAS) Silent installation and configuration settings for JSAS

    1. If you are performing only the installation, options for the configuration will be ignored when running the silent installation.

    2. If you are performing only the configuration, options for the installation will be ignored when running the silent configuration.

    3. Optionally, you can use response files created by the GUI installation and configuration programs. If you are performing an installation and configuration, perform the following steps to make one response file from two generated response files:

      1. In both the Installation program and the Configuration tool, when the Save settings to the response file option is shown, select it and enter a file path name.

      2. With a text editor, copy and paste the contents of the response file generated from the installation program into the response file generated by the configuration program.

      3. Save the newly created response file with a unique name or in another location. Enter the name of this response file in Step 7.

    4. If you save the response file in a location other than /path/to/install/silent, make sure that directory is readable by the user performing the silent installation.

  6. Do one of the following:


    Whether to use the installation executable file or config_dc.sh

    To install or install and configure the data collector If you only want to configure the data collector
    Use the command-line interface to access the directory that contains the installation executable file. One of the following files is located in this directory:

    • IBM AIX: setup_DC_aix.bin
    • Solaris: setup_DC_sol.bin
    • Linux: setup_DC_lin.bin
    • HP-UX: setup_DC_hp11.bin

    Go to the DC_home/installer/config_dc directory. The config_dc.sh file is located in this directory.

  7. Type the following command and press Enter:
    ./executable_file -silent [-is:log [log_file_name]] [configuration_option...]
      -options response_file

    The executable_file specifies the installation executable file, or the config_dc.sh file, mentioned in Step 6.

    The log_file_name specifies the path and name of the log file that the silent installer will write to. The file will be created even if it does not yet exist or if no name is specified.

    The configuration_option specifies one or more configuration options not included in the response file.

    The response_file specifies the response file you configured in Step 5. Indicate the path and name of the file.

    Examples:

    ./setup_DC_lin.bin -silent -is:log /opt/tmp/DClog.txt -V DC_ASL_SOAPPORT="8885"
      -options /opt/silent/DC6.opt
    ./config_dc.sh -silent -V DC_ASL_SOAPPORT="8885" -options /opt/silent/DC6.opt

    1. Configuration options specified in the response file take precedence over those entered in the command line. For a particular command-line configuration option to take effect, first nullify that option in the response file by commenting it out with a number sign (#).

    2. If you are performing a silent configuration (after the data collector has been installed), you cannot use the -is option. Instead run the command in the following way:
      ./config_dc.sh -silent [configuration_option...] -options response_file
      For example:
      ./config_dc.sh -silent -V DC_ASL_SOAPPORT="8885" -options
        /opt/silent/DC6.opt

  8. If you have performed only a silent installation (you indicated LAUNCH_CONFIG="false"), check the /var/ibm/tivoli/common/CYN/trace-install.log file to find out whether the installation was successful.

  9. If you have just performed a silent installation (and are about to perform configuration) and there is maintenance you need to apply, do so from the following Web site:
    http://www-306.ibm.com/software/sysmgmt/products/support/IBMTivoliCompositeApplicationManagerforJ2EE.html

  10. If you have performed a silent configuration, or instalation and configuration, perform the applicable post-configuration steps for the application server:

  11. Start the Application Monitor interface of the Managing Server and verify that you can see the monitored data.


Parent topic:

Install the ITCAM for J2EE data collector on UNIX/Linux