How do I create a silent installation export package for TSCO Agent/BPA Agent?

Version 4
    Share:|

    This document contains official content from the BMC Software Knowledge Base. It is automatically updated when the knowledge article is modified.


    PRODUCT:

    BMC Performance Assurance for Servers


    APPLIES TO:

    TrueSight Capacity Optimization 11.0, 10.7, 10.5, 10.3, 10.0 ; BMC Performance Assurance for Servers 9.5



    QUESTION:

     
       BMC Performance Assurance (BPA) version 7.5.00 and later (including TrueSight Capacity Optimization Gateway Server/Agent) use a java based installer . What is the correct method to create a package that can be silently installed or used for deployment through an external software deployment utility?   
       
       
        
         
    • TrueSight Capacity Optimization (Capacity Agent) 11.3, 11.0, 10.7, 10.5, 10.3, 10.0
    •    
    • BMC Performance Assurance  9.5, 9.0, 7.5.10, 7.5.00
    •   
       
       
        
         
    • Unix
    •    
    • Windows
    •   
       


    ANSWER:

     

     

      
       

    The information related to doing a Silent Installation of BMC Performance Assurance (BPA) verison 7.5.00 (informally known as 'Perform') or the TrueSight Capacity Optimization (TSCO) Agent is available is documented here: https://docs.bmc.com/docs/display/btco110/Performing+the+Capacity+Agent+installation+silently

    Be aware that the the full path to the options file is required, and it must be in quotes if there are any spaces in it.

       

    Windows

       

    One can use environment variables when specifying the path to options file:

       
       E:\windows_console>start /wait setup.exe -i silent -DOPTIONS_FILE="%TEMP%\AgentSilentInstallOptions.txt"  
       


    Or you can use the relative paths from that temporary directory:

       
       E:\windows_console>start /wait setup.exe -i silent -DOPTIONS_FILE="..\..\AgentSilentInstallOptions.txt"  
       

    Unix

       

    One can use environment variables when specifying the path to options file (if the variable is set within the shell):

       
       setup.sh -i silent -DOPTIONS_FILE="$BPA_IMAGE/AgentSilentInstallOptions.txt"  
       


    Or use the relative paths from that temporary directory:

       
       setup.sh -i silent -DOPTIONS_FILE="/var/tmp/image/AgentSilentInstallOptions.txt"  
       


    If the -DOPTIONS_FILE parameter is not fully pathed the silent installation will fail with errors like this reported in the log:

       
       (Dec 02 2009 11:25:42.881 AM -0500),CONFIG,com.bmc.install.utility.logging.Log, Execution started   
    (Dec 02 2009 11:25:42.882 AM -0500),CONFIG,com.bmc.install.builder.installanywhere.InstallationTaskAction,   
      LOG EVENT {Description=[Options file],Detail=[AgentSilentInstallOptions.txt]}   
    (Dec 02 2009 11:25:42.991 AM -0500),CONFIG,com.bmc.install.builder.installanywhere.InstallationTaskAction,   
      LOG EVENT {Description=[Could not find options file],Detail=[C:\Users\Administrator\AppData\Local\Temp\I1259771112\Windows\AgentSilentInstallOptions.txt]}  
       


    Also note that the parameter is '-DOPTIONS_FILE'. There is no space between the '-D' and 'OPTIONS_FILE'. If there is a space the silent installation will fail.

       

    Q: What can be done to debug Silent Installation problems?

       

    The installation creates a log file in the %TEMP% directory called 'BPA_install_log.txt' that can be used to diagnose installation problems. The log is somewhat difficult to read if you are not familiar with the installer so it may be best to contact Technical Support for debugging assistance.

       

    On Unix the log will typically be written to the /tmp or /var/tmp directory.

      
      

    Q: How do I change the target installation directory for a silent install?

      

    When doing a silent installation the base installation directory is set via the "installLocation" setting in the AgentSilentInstallOptions.txt file:

    ###################################################################################
    # Product Install Location
    #
    # The install location of the product. Specify a valid directory into which the
    # product should be installed.
    ###################################################################################
    -P installLocation=/opt/bmc/Patrol3

      

    Note that the last directory that already exists for the specifed installationLocation must be writable by the user the silent install is being executed as.  If the specified directory is not writable the installation will fail with the following errors reported to the BPA_isntall_log.txt file:

      

    (Jun 21 2013 09:14:05.446 AM -0400),CONFIG,com.bmc.install.task.InstallationPropertiesHelper,
      LOG EVENT {Description=[SET PROPERTY VALIDATION_ERROR_RESULT],Detail=[INSTALLING_DIRECTORY_NOT_WRITABLE]}
    (Jun 21 2013 09:14:05.447 AM -0400),INFO,com.bmc.install.product.bpa.bpaDestinationValidationTask,
      LOG EVENT {Description=[Validation error],Detail=[INSTALLING_DIRECTORY_NOT_WRITABLE]}
    (Jun 21 2013 09:14:05.473 AM -0400),SEVERE,com.bmc.install.product.bpa.bpaDestinationValidationTask,
      LOG EVENT {Description=[INSTALLING_DIRECTORY_NOT_WRITABLE],Detail=[Installing directory must be writable.]}

      

    Usually /opt would be owned by root so only the root user would be able to create a directory in it.  So, if you aren't running the install as root you'd need to have the /opt/bmc directory pre-created and owned by the user account that you are using to run the setup.sh.

    Also, note that if you aren't running the setup.sh as root that you'll need to manually run the /[BPA Installation Directory]/b1config9000.sh script as root.  That is the root configuration script.  It is run automatically when you install as root but would need to be run separately if you install as a non-root user.

      

    Q: How do I change the temporary directory used by the installer to hold the the temporary java image and Utilities directory?

      

    If you wanted to pick a different temporary directory (rather than /tmp) the following document describes that process:
      000022961: Is there a way to redirect the temporary directory during a GUI or silent install of the BMC Performance Assurance or BMC Performance Perceiver products?

      

     Q: If the silent install fails where should I look for errors?

      

    Unfortunately when running in the 'silent' installation mode the installer will not output any error messages to the screen -- it will only output them to the installation log.  If you were running through the X-Windows GUI install it will output messages to an error screen.

      

    So, to find errors check the end of the $IATEMPDIR/BPA_install_log.txt file to find the last errors generated before the installation terminated.  By default the $IATEMPDIR will be either /tmp or /var/tmp on Unix although this location can be overridden by setting the $IATEMPDIR environment variable.

      
    Related Products:  
       
    1. TrueSight Capacity Optimization (Gateway Server / Agent)
    2.  
    3. BMC Performance Assurance for Servers
       Legacy ID:KA315050

     


    Article Number:

    000031522


    Article Type:

    FAQ/Procedural



      Looking for additional information?    Search BMC Support  or  Browse Knowledge Articles