Upgrading TrueSight Server Automation - Data Warehouse silently

Where you are in the Upgrade process

In a silent upgrade process, you run the installation program from a command line. A silent upgrade enables you to upgrade multiple systems at the same time. In silent mode, you must provide the parameters in an options.txt file. You can generate this file once while running the silent upgrade and use it later for upgrading other TrueSight Server Automation - Data Warehouse instances in your environment.

To upgrade TrueSight Server Automation - Data Warehouse silently

1. Log in to the host computer on which you want to upgradeTrueSight Server Automation - Data Warehouse. BMC recommends that you delete all the files from the temporary directory:

   • (Windows) %temp%

   • (Linux) /tmp

2. Extract the downloaded files to a temporary location outside the following location to avoid any file sharing conflicts:

   • (Windows) C:\Program Files

   • (Linux) /opt

3. As a root user, run this command to assign the executable permission to the installer file (setup.bin):
   chmod +x -R Disk1

4. Exit all programs and open the command prompt to navigate to the Disk1 directory:

   • (Windows) Windows\Disk1
   • (Linux) Linux/Disk1

5. Run the following command to generate the options file:

   • (Windows as Administrator) setup.exe –DGENERATE_OPTIONS_FILE=AbsolutePathToOutputOptionsFile

   • (Linux as root user) ./setup.bin –DGENERATE_OPTIONS_FILE=AbsolutePathToOutputOptionsFile

   where AbsolutePathToOutputOptionsFile is the absolute path and name that you assign to the output file that contains the installation options. If the file name or path includes a space, enclose the file path in double quotes. 

   Examples:

   • (Windows - Path with space) setup.exe –DGENERATE_OPTIONS_FILE="C:\temp folder\Disk1\options File.txt"

   • (Linux - Path with space) ./setup.bin –DGENERATE_OPTIONS_FILE="/opt/temp folder/Disk1/options File.txt"

   The command launches the TrueSight Server Automation - Data Warehouse wizard-based installer. Select the component that you want to upgrade and for which you want the options file. Complete the upgrade once to populate the options file with properties. Now, your options file is ready to be used in silent upgrade process.

6. (Optional) To change the password in the options.txt file later, use the Maintenance Tool. The Maintenance Tool enables you to create an encrypted password that you can paste into the options.txt file, which contains passwords as text.

   1. Start the Maintenance Tool utility.

       Click here to see steps to run the Maintenance tool.

      You can run the Maintenance Tool in a graphical user interface or from the command line. 

      To run the Maintenance Tool in a UI on Windows

      1. On the computer where you want to install the product, extract the downloaded product files from the BMC Electronic Product Distribution (EPD) site to a temporary directory.
      2. Navigate to the \Disk1\utility folder, and run the TssadwMaintenanceTool.cmd file.

      To run the Maintenance Tool in a UI on UNIX

      1. On the computer where you want to install the product, extract the downloaded product files from the EPD site to a temporary directory. 
      2. Navigate to the /Disk1/utility folder, and run the TssadwMaintenanceTool.sh file.

      To run the Maintenance Tool from the command line on Windows

      On the computer where you have extracted the downloaded product files, from the \Disk1\utility folder, run TssadwMaintenanceTool.cmd

      To run the Maintenance Tool from the command line on UNIX

      On the computer where you have extracted the downloaded product files, from the /Disk1/utility folder, run TssadwMaintenanceTool.s

   2. Click the Encrypt tab.
   3. In the Password and Confirm Password boxes, type your password.
   4. Click Encrypt.

   5. Copy and paste the encrypted password into the options.txt file for your silent upgrade.
      For example, if you want to encrypt the password for the TrueSight Server Automation - Data Warehouse console user and the output is DES\:b76c59dbc2e1433c7a9c2f006a2e2429116840dce695aea9, enter the following string:

      # -J CONSOLE_ADMIN_PASSWORD=DES\:b76c59dbc2e1433c7a9c2f006a2e2429116840dce695aea9

   Alternatively, you can use the -encrypt option to encrypt a password through the command line. For example, enter the following command from the \Disk1\utility folder, which is created when you extract the downloaded product files from the BMC Electronic Product Distribution (EPD) site:

   • Windows - BdssaMaintenanceTool.cmd -silent -encrypt -encrypt -password=<password> -confirm_password=<password>

   • UNIX - ./BdssaMaintenanceTool.sh -silent -encrypt -encrypt -password=<password> -confirm_password=<password>

   For more information, see the command-line help for the Maintenance Tool.

7. To upgrade other TrueSight Server Automation - Data Warehouse instances, do the following:
   
   1. Customize the options.txt file for an instance by updating the site and database details.
   2. Run the following command to start the silent upgrade process. When you specify the options.txt file name, specify the full path to the file; do not specify a path that is relative to the installation program.
      • (Microsoft Windows) setup.exe -i silent -DOPTIONS_FILE=pathToOptionsFile
        If the path contains spaces, enclose the path in quotation marks ("").
      • (UNIX) ./setup.bin -i silent -DOPTIONS_FILE=pathToOptionsFile
        

        Where, pathToOptionsFile is the path, including the name of the file, to which you want to copy the silent upgrade properties. If the file name or path includes a space, enclose the file path in double quotes.

        Examples:

        • (Windows - Path with space) setup.exe -i silent -DOPTIONS_FILE="C:\temp folder\Disk1\options File.txt"

        • (Linux - Path with space) ./setup.bin -i silent -DOPTIONS_FILE="/opt/temp folder/Disk1/options File.txt"

Next step in the Upgrade process

Now that you have successfully upgraded TrueSight Server Automation - Data Warehouse, do the following steps:

1. Upgrade TrueSight Smart Reporting - Platform.
   
   • To upgrade TrueSight Smart Reporting - Platform to version 19.2, see Upgrading to TrueSight Smart Reporting - Platform 19.2 .
   • To upgrade TrueSight Smart Reporting - Platform to version 19.3, see Upgrading to TrueSight Smart Reporting - Platform 19.3 .
   • To upgrade TrueSight Smart Reporting - Platform to version 20.02, see Upgrading to TrueSight Smart Reporting - Platform 20.02 .
2. Complete the post-upgrade activities. For more information, see Post-upgrade tasks.