Prerequisites for upgrade

This section describes the prerequisites that you must perform before you upgrade your BMC Cloud Lifecycle Management solution to version 3.1 in a High-Availability (HA) and non-HA environments. In this section, the following topics are provided:

Oracle JRE requirements

To create backups and snapshots

1. Take a snapshot of the physical computer or VM and back up database for enterprise AR System and Cloud database at the same time.

2. Ensure that you restore the database and host computers for enterprise AR System server and Cloud database together. Otherwise, you might encounter possible data corruption issues.

   Note

   After you back up the Cloud Platform Manager host computer, ensure that you back up the hosts and databases for the enterprise AR System and Cloud database products. You must perform this step to save the data that the Cloud Platform Manager created on the Cloud database.

   From the host on which you installed Cloud Platform Manager, back up the Platform_Manager folder.

3. From the host on which you installed the preboot executable environment (PXE) server, back up the TFTP folder.
   This folder is deleted on the target computer during the upgrade process.

4. Before you upgrade the PXE server, back up your data store.

   Note

   Ensure that you specify the correct data store location.

5. For all products that you want to upgrade in the solution:
   1. Take a snapshot of the host on which you installed the product.
   2. Back up the product database, if one exists.
      For example, for BMC Atrium Core – Web Registry components, take a snapshot of the host on which you installed the web registry. For enterprise AR System, backup the the host on which you installed the product and the database.

   3. Back up the following configuration files:

      Product	File
      Platform Manager	Linux: <PM_Install_Directory>/Platform_Manager/wrapper.conf Windows: <PM_Install_Directory>\Platform_Manager/wrapper.conf
      Enterprise-AR and Cloud-AR	Linux:  <ARS_Home>/conf/ar.conf Windows: <ARS_Home>\Conf\ar.cfg
      Enterprise-AR and Cloud-AR	Linux: /etc/arsystem/<hostname>/armonitor.conf Windows: <ARS_Home>\Conf\armonitor.cfg
      Enterprise-AR and Cloud-AR	E-AR Linux: <ARS_Home>/pluginsvr/pluginsvr_config.xml <Cloud_Portal_Home>/Cloud_Portal/plugin/pluginsvr_config.xml E-AR Windows: <ARS_Home>\pluginsvr\pluginsvr_config.xml <Cloud_Portal_Home>\Cloud_Portal\plugin\pluginsvr_config.xml C-AR Linux: <ARS_Home>/pluginsvr/pluginsvr_config.xml C-AR Windows: <ARS_Home>\pluginsvr\pluginsvr_config.xml
      Mid Tier	Linux: <TOMCAT_INSTALL_DIR>/conf/server.xml Windows: <TOMCAT_INSTALL_DIR>\Tomcat6.0\conf\server.xml
      Atrium Orchestrator AMREPO	Linux: <AMREPO_INSTALL_DIR>/repository/config/repository.xml <AMREPO_INSTALL_DIR>/tomcat/webapps/baorepo/WEB-INF/classes/META-INF/repository.xml Windows: <AMREPO_INSTALL_DIR>\repository\config\repository.xml <AMREPO_INSTALL_DIR>\tomcat\webapps\baorepo\WEB-INF\classes\META-INF\repository.xml
      Atrium Orchestrator CDP	Linux: <CDP_INSTALL_DIR>/tomcat/webapps/baocdp/WEB-INF/classes/log4j.xml Windows: <CDP_INSTALL_DIR>\tomcat\webapps\baocdp\WEB-INF\classes\log4j.xml
      BMC Network Automation	Linux: <BCA_NETWORKS_INSTALL_DIR>/logging.properties Windows: <BCA_NETWORKS_INSTALL_DIR>\logging.properties
      BMC Network Automation	Linux: <BCA_NETWORKS_INSTALL_DIR>/tomcat/conf/server.xml Windows:<BCA_NETWORKS_INSTALL_DIR>\tomcat\conf\server.xml
      BMC Network Automation	Linux: <BCA_NETWORKS_INSTALL_DIR>/database.properties Windows: <BCA_NETWORKS_INSTALL_DIR>\database.properties
      BMC Database Automation	GUI PHP Configuration (Manager Host) Linux: <BDA_Install_Dir>/etc/php.ini
      BMC Database Automation	GUI Web Server Configuration (Manager Host) Linux:  /etc/httpd/etc/conf/httpd.conf /etc/httpd/etc/conf.d/gridapp.conf

       

Enabling logs if you run into problems

This section describes how to enable logging if you run into issues (for example, with E-AR, C-AR, Cloud Portal, or Cloud Extensions upgrades or with Cloud Portal and Cloud Extensions new installations) and you must re-run the installation or upgrade to get additional information for troubleshooting.

1. Log on to the AR System server.
   http://<hostname:<port>/arsys 
2. Open the AR System Administration Console (select Applications >AR System Administration >AR System Administration Console).
3. Open the Server Information window (select System >General >Server Information).
4. Click the Log Files tab.
5. Enable the following logs:
   
   
   • API Log
   • Escalation Log
   • Filter Log
   • SQL Log
   • Plug-in Log
6. Click Apply and Save.

Preparing for product upgrades

This section explains that steps you must perform to prepare you product hosts for upgrading on non-high availability servers.

To prepare the BMC ProactiveNet and Performance Manager for upgrade

Before you upgrade the BMC ProactiveNet components, you must complete the following prerequisites:

1. Ensure that all the BMC ProactiveNet servers and the BMC ProactiveNet Data Collection Host systems with domain names can be pinged by one another.
2. If the BMC database and the BMC Application Server reside on different systems, ensure that they are synchronized.

For fixing issues with the BMC ProactiveNet and Performance Manager upgrade, see Upgrade issues with BMC ProactiveNet Performance Management.

To prepare for BMC AR System Server and IT Management Suite upgrade

To ensure an efficient BMC AR System Server and IT Management Suite upgrade, see the following steps described in the BMC Remedy AR System online technical documentation:

To prepare for a BMC AR System Server – Cloud Database upgrade

To ensure an efficient cloud database upgrade, see the following steps described in the BMC Remedy AR System online technical documentation:

Preparing for product upgrades in a high-availability environment

This section explains the steps that you must perform to prepare you product hosts for upgrading on HA servers. For recommendations for installing products in a HA environment, see Installing products for HA.

To configure the mid tier for the upgrade

Perform the following steps to ensure that you can access the enterprise AR System and Cloud database using the mid tier:

1. Open the BMC Remedy Configuration Tool using the following URL: http://:<hostname>:<port>/arsys/shared/config/config.jsp.
2. On the AR Server Settings panel, click Add Server and specify the enterprise AR System – Primary host name.
3. On the General Settings panel, set the following fields to he enterprise AR System – Primary host name:
   • Preference Server(s)
   • Data Visualization Module Server(s)
   • Homepage Server
   • Authentication Server
4. Repeat steps 2 and 3 to add Cloud database to the mid tier configuration.

To remove enterprise AR System and Cloud database from the server group

Before you install the AR Extension, you must remove the AR System servers from the serer group. You must perform this step to remove any load balancer settings that you might have configured in your environment.

1. Go to ARSystemserverInstallationdirectory\Conf.

2. Open the ar.conf (on Linux) or ar.cfg(on Microsoft Windows) file and remove the following entries:

   Map-IP-Address: 10.128.253.183 10.128.105.209
   Map-IP-Address: 10.128.106.166 10.128.105.209
   

3. Update the Server-Name and Server-Connect-Name properties with the host name on which you installed the enterprise AR System.
4. Using the mid tier, log on to the Primary and Secondary servers of the enterprise AR System and Cloud database products.
5. Go to AR System Administration Console > System > General > Server Information > Connection Settings > Configuration tab.
6. Clear the Server Group Member box.
7. Restart the AR System Server service on the enterprise AR System and Cloud database hosts.

To prepare the DSO information for the upgrade

If you have installed a server group environment for the following products, ensure that you update the Distributed Server Option (DSO) for them to point to the Primary servers:

• The enterprise AR System server(all nodes in server group)--Update the DSO target with the Cloud database – Primary host information
• The Cloud database servers (all nodes in server group)-- Update the DSO target with the enterprise AR System – Primary host information

1. Using the mid tier, log on to any of the AR System server in the server group.
2. Search for the Distributed Logical Mapping form and change the Name attribute value to the host name on which you installed the enterprise AR System – Primary or Cloud database – Primary depending on the following points:
   • For the enterprise AR System, specify the Cloud database – Primary host name.
   • For the Cloud database, specify the enterprise AR System – Primary host name.
3. Using the mid tier, log on to the Primary and Secondary servers of enterprise AR System and Cloud database products.
4. Go to AR System Administration Console > System > General > Server Information > Connection Settings > DSO Server tab.
5. Change the Server Nameto the local host name on which you installed the Enterprise AR System server – Primary depending on the following points:
   • For the enterprise AR System, specify the Cloud database – Primary host name.
   • For the Cloud database, specify the enterprise AR System – Primary host name.
6. Restart the AR System Server service on the enterprise AR System and Cloud database hosts.

To prepare the enterprise AR System for the upgrade

Before you upgrade the enterprise AR System host, you must complete the following prerequisites:

1. Ensure that the enterprise AR System host has a minimum of 16 GB RAM and 4 CPUs available.

   Note

   Ensure that you have the same amount of RAM and same number of CPUs on the Cloud Database host also.

2. Verify that the following queue parameters are listed in the ar configuration file (ar.cfg on Windows and ar.confon Linux):

   Private-RPC-Socket:  390601   1   1
   Private-RPC-Socket:  390603   5  10
   Private-RPC-Socket:  390620  12  12
   Private-RPC-Socket:  390621  12  16
   Private-RPC-Socket:  390622   4   6
   Private-RPC-Socket:  390626  12  12
   Private-RPC-Socket:  390635  20  20
   Private-RPC-Socket:  390680   2  25
   Private-RPC-Socket:  390681   4   4
   Allow-Unqual-Queries: T
   

3. If the queue parameters are not present on the enterprise AR System primary and secondary hosts, add these parameters in ar configuration file and restart the AR System server services.

4. Tune your MS SQL and Oracle databases according to the guidelines in the BMC Remedy AR System documentation: Preparing your database for an upgrade.

5. Open the CMF:PluginConfiguration form for the enterprise AR System and change the following attributes:

    Example: Callback URL: {nolink}http://CLM-MT:8080/arsys/plugins/CloudCallBackPlugin/params?server=<EnterprisePrimaryHostname>&username=csmcallback&pwd=csmcallback{nolink} 

   • Callback URL: set to the host name on which you installed the enterprise AR System – Primary
   • FIELD_AO_HOST: set to host name on which you installed BMC Atrium Orchestrator – Primary

6. Update the BMC BMC.CLOUD.BMc_Callout join form on the Cloud database host:

    Example:{nolink}[http://clm-mt:8080/arsys/plugins/CloudCallBackPlugin/params?server=]<ITSMPrimartHost>&username=csmcallback&pwd=csmcallback&operation=CHECK_CHANGE_REQUIRED{nolink}

   1. Search for the CSM Change integration HTTP Callout entry.
   2. Click on View relationship and open the URL entry.
   3. From the Custom tab, update the Attribute Value with the host name on which you installed the enterprise AR System – Primary.

To prepare the Cloud Platform Manager for the upgrade

Before you upgrade the Cloud Platform Manager host, you must open the Cloudservice.JSON file and set the attributevalue parameter of Cloud database load balancer setting name to the host name on which you installed the Cloud database – Primary.

Where to go next

Upgrade sequence