Unsupported content This version of the product has reached end of support. The documentation is available for your convenience. However, you must be logged in to access it. You will not be able to leave comments.

Performing a silent upgrade of the portal on Windows

You can perform an unattended (silent) upgrade of BladeLogic Portal on a Windows system.

This topic contains the following sections:

Upgrade path

For this version, BladeLogic Portal only supports an upgrade from BladeLogic Portal 2.1.

Contents of the response file

A silent upgrade requires a short response file, which specifies the selections you would normally make during an interactive upgrade  Shown below are the contents of the response file, including the parameters that are new in this version.

Note

There are two response files shown below—one for version 2.2 and the other for version 2.2.01.

Response file for version 2.2

###############################################################################
#
# Product: BMC Automation Portal 2.2.00
#
# To invoke in silent mode with options file:
# setup.exe -i silent -DOPTIONS_FILE=<location of Upgrade_Options.txt>
###############################################################################

# Upgrade BMC Automation Portal
-A featureBMCAutomationPortal

# Migrate the portal database (true|false)
-J MIGRATE_PORTAL_DB=true

# provide beginning values for Search Indexing Server port ranges
-J BMC_AUTOMATION_DCAINDEX_TCP_PORT=9300

# select server site to install
-J BNA_SELECTED=<true | false>

# bladelogic network information
-J BNA_SERVER_HOST=<yourbnahost.domain.com>
-J BNA_SERVER_PORT=<port>
-J BNA_USER=<admin_user>
-J BNA_ROLE=<Realm>
-J BNA_PASSWORD=<password>

# BNA server information for Data Refresh
-J BNA_DR_USER=<bna_user>
-J BNA_DR_PASSWORD=< password>

# Remote DCAIndex server to be configured
-J ELASTICSEARCH_HOST=<hostName1:tcpport1,hostName2:tcpport2>

Response file for version 2.2.01

###############################################################################
#
# Product: BMC Automation Portal 2.2.01
#
# To invoke in silent mode with options file:
# setup.exe -i silent -DOPTIONS_FILE=<location of Upgrade_Options.txt>
###############################################################################

# Upgrade BMC Automation Portal
-A featureBMCAutomationPortal

# Migrate the portal database (true|false)
-J MIGRATE_PORTAL_DB=true

# provide beginning values for Search Indexing Server port ranges
-J BMC_AUTOMATION_DCAINDEX_TCP_PORT=9300

# BSA server information for Data Refresh
-J BBSA_SCAN_IMPORTER_SUPPORT=<true | false>

# select server site to install
-J BNA_SELECTED=<true | false>

# bladelogic network information
-J BNA_SERVER_HOST=<yourbnahost.domain.com>
-J BNA_SERVER_PORT=<port>
-J BNA_USER=<admin_user>
-J BNA_ROLE=<Realm>
-J BNA_PASSWORD=<password>

# BNA server information for Data Refresh
-J BNA_DR_USER=<bna_user>
-J BNA_DR_PASSWORD=< password>
-J BNA_SCAN_IMPORTER_SUPPORT=<true | false>

# Remote DCAIndex server to be configured
-J ELASTICSEARCH_HOST=<hostName1:tcpport1,hostName2:tcpport2>

Before you begin

  • The installation must run on a 64-bit Microsoft Windows 2008 or 2012 operating system.
  • A database must be set up prior to installation. Currently, for Windows installations, the database must be running on Microsoft SQL Server (see Setting-up-a-SQL-Server-database). The database should reside on the same LAN as this installation of BladeLogic Portal.
  • BMC Server Automation must be installed and its Application Server started. 
  • BMC Network Automation must be installed and its Application Server started, if you are using Threat Director and monitoring network vulnerabilities. 
  • The BladeLogic Portal server, the portal database, and the BMC Server Automation Application Server must all reside on the same LAN.
  • Web services must be enabled on BMC Server Automation by establishing a communication path (via REST APIs) between the BMC Server Automation Application Server and the server hosting BladeLogic Portal.
  • Other applications cannot use ports that you allocate to the BladeLogic Portal server.
  • Port number 9300 should be free to allow for transport layer traffic with the DCA Index Server that is installed as part of this procedure. If the installation indicates there is a problem communicating with the DCA Index Server, you can manually specify a port.
  • You must obtain the necessary installation files. See Downloading-the-installation-files.
  • Set the UNICODE_SUPPORT flag to false for all versions of BladeLogic Portal earlier than version 2.2.01.
    Because of a known issue (DRBLY-30368) in previous releases that prevented the creation of Unicode-compliant databases, you must manually set a flag in the BladeLogicPortalInstalledConfiguration.xml file. You must always perform this action no matter whether you want Unicode or not and whether you are using SQL Server or Oracle.These steps are not necessary if you are upgrading from version 2.2.01 or later.
    1. Navigate to the install location for BladeLogic Portal.
      Typical locations:
      Windows: C:\Program Files\BMC Software\BladeLogicPortal
      Linux: /opt/bmc/BladeLogicPortal
    2. Open the BladeLogicPortalInstalledConfiguration.xml file for editing.
    3. Find the property called UNICODE_SUPPORT. It should appear as follows:
      <property>
            <name>UNICODE_SUPPORT</name>
            <value>true OR false</value>
    4. Set the value to false and save the file.

To upgrade the portal in silent mode

  1. Copy the installation file, BTD22.WIN64.zip, to an appropriate location on the computer where you are installing the portal. 
    In versions earlier than 2.2.01, the file is called BLPortal22.WIN64.zip.
  2. Extract the contents of BTD22.WIN64.zip. 
    This extraction generates a file structure where the top level directory is named BladeLogicPortal.
  3. Navigate to \BladeLogicPortal\windows\Disk1.

  4. Prepare a silent response file.

    1. Create a response file using the sample file shown above.
    2. Follow the instructions in the sample file to specify upgrade choices.
    3. Save the response file and note its full name and path.
  5. As Administrator, use a command line to enter the following command: 
    setup.exe -i silent -DOPTIONS_FILE=<Path of silent response file>
  6. A standard installation sets up an HTTP port to monitor the DCA Index Server. If you do not want to leave an HTTP port open for security reasons, you can disable HTTP traffic with the DCA Index Server after installation is complete.(% style="line-height: 13.0pt;font-size: 10.0pt;" %)

Where to go next

Set up a backup procedure for the DCA Indexing Server. If BladeLogic Portal was already installed and you have just installed another instance, you must be certain that each instance has an identical backup configuration.

If you want to disable HTTP traffic with the DCA Indexing Server, see Disabling or enabling HTTP traffic with the DCA Indexing Server. 

If you are using roles with a limited set of permissions for Data Refresh, see Configuring-Data-Refresh.

When those tasks are complete, see Configuring-after-installation.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*