Upgrading silently using the unified product installer

As an alternative to performing an interactive upgrade, you can perform an unattended (silent) upgrade of BMC Server Automation on 64-bit Linux and Windows platforms. In a silent installation, you run the unified product installer through a command line.

For lists of the product components that are upgraded and those that are not upgraded by the unified product installer, see the introductory sections in Upgrading on Windows using the unified product installer. This topic includes the following sections:

Before you begin

Ensure that your environment meets the requirements discussed in Preparing for a Windows upgrade using the unified product installer and Preparing for a Linux or UNIX upgrade using the unified product installer.

To encrypt your database password in preparation for specifying it in the options file (see step 4 below), use the BSAOneClickInstallMaintenanceTool utility provided in the installation package. After extracting the package (step 1 below), you can find this utility in the temporary directory: \Disk1\utility\BSAOneClickInstallMaintenanceTool.cmd (for Windows) or /Disk1/utility/BSAOneClickInstallMaintenanceTool.sh (for Linux).
You can run this utility in the following ways:

• Interactively - Run the utility, enter your password on the Encrypt tab, and click Encrypt
• Silently - Run the following command from the directory where the utility is located:
  
  • (Windows) BSAOneClickInstallMaintenanceTool.cmd -silent -encrypt -encrypt -password=<password> -confirm_password=<password>
  • (Linux) ./BSAOneClickInstallMaintenanceTool.sh -silent -encrypt -encrypt -password=<password> -confirm_password=<password>

To upgrade in silent mode

1. Download and extract the installation package appropriate for the operating system level and hardware platform in a temporary directory. The package follows the naming convention BBSA<version>-<platform>.zip, and contains the unified product installation program files.
   Download this package to the host computer of the Application Server that was set up as a configuration server (for more about this type of Application Server setup, see Application Server types). If this is a Linux computer, ensure that it has an RSCD agent installed and running.
   

2. Extract the RSCDAgent.zip file and copy the rscd folder to one of the following locations before running the unified product installer (The unified product installer uses the RSCD installers while installing or upgrading BMC Server Automation in your environment):

   • (Windows) <temporary location>/files/installers

   • (Linux) <temporary location>/Disk1/files/installers
     

3. If you are on a Linux machine, assign executable permission to the temporary directory by entering the following command:

   chmod +x -R <temporary directory> 

   In addition, if the temporary directory is at the end of a path (that is, has at least one parent directory), assign read permission to the others class (which includes the bladmin system user) for all directories in the path. To do this, execute the following command on the top-level directory in the path:

   chmod o+r -R <top-level directory>

4. In a text editor, create an options file and define values for the relevant upgrade options. Define each option on a separate line. Below is a list of available upgrade options, by category:

   SRP authentication
   

   Use the following options to enable access to the Application Server during the upgrade:

   Option	Description of value
   -J BSA_APPSERVER_PROFILE	Name of a profile on the Application Server to use during the upgrade for SRP authentication. The profile that you specify must be associated with the same Application Server where you are performing the upgrade.
   -J BSA_APPSERVER_PROFILE_USER	Name of a user for SRP authentication. For example: -J BSA_APPSERVER_PROFILE_USER=BLAdmin
   -J BSA_APPSERVER_PROFILE_USER_PASSWORD	A valid password for the specified user.

5. Change directory (cd) to the location where the installation file (setup.exe for Windows or setup.bin for Linux) resides in the temporary directory.

6. Run the installation program with the -i silent option, using the following command. Use an absolute path to the options file. Enclose the path in double quotation marks (" ").
   setup.exe|setup.bin -i silent -DOPTIONS_FILE="<OptionsFilePath>"

   Example

   (Windows)setup.exe -i silent -DOPTIONS_FILE="C:\Program Files\BMC Software\BladeLogic\silentinstall_win_options.txt"

   (Linux) setup.bin -i silent -DOPTIONS_FILE="/opt/bmc/bladelogic/silentinstall_linux_options.txt"

   Note

   If product components are detected during the upgrade on remote Windows machines in the BMC Server Automation environment, installers are automatically copied to the C:\BBSAInstallerDumpDir directory on the remote machines. These installers are used to automatically upgrade product components on those machines.
   

   During the upgrade, the original Application Server deployments are backed up. The backup files are stored in <installation directory>/br.

   The installation log file, bsainstallupgrade.log, is stored in %TEMP% (on Windows) or in /tmp (on Linux). For more information about the log files created by the unified product installer, see the Troubleshooting section.

Where to go from here

1. The unified product installer automatically installs agent installer jobs and depot objects such as agent installers and agent bundles that can be used for installing or upgrading agents on servers in the environment. The agent installers, agent bundles, and agent installer jobs are present in the following locations:

   Object	Depot Path	Can be used for
   Installers	/Depot/BMC Maintenance/Agent Installers/	Agent install and upgrade
   Bundles	/Depot/BMC Maintenance/Agent Bundles/	Agent upgrade
   Jobs	/BMC Maintenance/Agent Installer Jobs/	Agent upgrade

   Note

   The agent installer for the Solaris platform requires additional configuration before first use. See Additional information for Solaris installation packages.

   For more information about using these objects, see Installing one or more agents using the BMC Server Automation Console and Upgrading the RSCD Agent using an Agent Installer Job.

   Warning

   Modifying the name or path of these depot objects may cause errors in the agent installation process.

2. Upgrade any remaining product components that were not upgraded by the unified product installer. 
3. If you adjusted security settings before the upgrade (as described in the troubleshooting instructions for security settings), remember to re-adjust your security settings, based on your unique needs and the IT security policies at your organization.
4. On SuSE 11, the Application Server does not start automatically at the end of the upgrade. You must start the Application Server manually at the end of the upgrade using the following command:
   /etc/init.d/blappserv start