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
- Enabling logs if you run into problems
- Preparing for product upgrades
- To prepare for BMC AR System Server and IT Management Suite upgrade
- To prepare for a BMC AR System Server – Cloud Database upgrade
- Preparing for product upgrades in a high-availability environment
- Where to go next
Oracle JRE requirements
When the product installation or upgrade requires the 64-bit Oracle JRE as a prerequisite, you cannot substitute the OpenJDK version. Before you start:
- Check the Java version installed on your host.
If the OpenJDK is installed, uninstall it and replace it with 64-bit Oracle JRE 1.6 or later.
- If you removed the OpenJDK and installed the Oracle JRE, verify that the environment variables are properly set to reflect the new JRE version.
To create backups and snapshots
- Take a snapshot of the physical computer or VM and back up database for enterprise AR System and Cloud database at the same time.
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.
From the host on which you installed Cloud Platform Manager, back up the Platform_Manager folder.
- 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. Before you upgrade the PXE server, back up your data store.
- For all products that you want to upgrade in the solution:
- Take a snapshot of the host on which you installed the product.
- 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. 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.confEnterprise-AR and Cloud-AR
Linux: <ARS_Home>/conf/ar.conf
Windows: <ARS_Home>\Conf\ar.cfgEnterprise-AR and Cloud-AR
Linux: /etc/arsystem/<hostname>/armonitor.conf
Windows: <ARS_Home>\Conf\armonitor.cfgEnterprise-AR and Cloud-AR
E-AR Linux:
<ARS_Home>/pluginsvr/pluginsvr_config.xml
<Cloud_Portal_Home>/Cloud_Portal/plugin/pluginsvr_config.xmlE-AR Windows:
<ARS_Home>\pluginsvr\pluginsvr_config.xml
<Cloud_Portal_Home>\Cloud_Portal\plugin\pluginsvr_config.xmlC-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.xmlAtrium 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.xmlAtrium 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.xmlBMC Network Automation
Linux: <BCA_NETWORKS_INSTALL_DIR>/logging.properties
Windows: <BCA_NETWORKS_INSTALL_DIR>\logging.propertiesBMC Network Automation
Linux: <BCA_NETWORKS_INSTALL_DIR>/tomcat/conf/server.xml
Windows:<BCA_NETWORKS_INSTALL_DIR>\tomcat\conf\server.xmlBMC Network Automation
Linux: <BCA_NETWORKS_INSTALL_DIR>/database.properties
Windows: <BCA_NETWORKS_INSTALL_DIR>\database.propertiesBMC 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.
- Log on to the AR System server.
http://<hostname:<port>/arsys - Open the AR System Administration Console (select Applications >AR System Administration >AR System Administration Console).
- Open the Server Information window (select System >General >Server Information).
- Click the Log Files tab.
- Enable the following logs:
- API Log
- Escalation Log
- Filter Log
- SQL Log
- Plug-in Log
- 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:
- Ensure that all the BMC ProactiveNet servers and the BMC ProactiveNet Data Collection Host systems with domain names can be pinged by one another.
- 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:
Before performing | Review this topic |
---|---|
BMC AR System upgrade | |
BMC Atrium Core upgrade | |
BMC ITSM upgrade | |
BMC SRM upgrade | |
BMC SLM upgrade |
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:
Before performing | Review this topic |
---|---|
BMC AR System upgrade | |
BMC Atrium Core upgrade |
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:
- Open the BMC Remedy Configuration Tool using the following URL: http://:<hostname>:<port>/arsys/shared/config/config.jsp.
- On the AR Server Settings panel, click Add Server and specify the enterprise AR System – Primary host name.
- 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
- 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.
- Go to ARSystemserverInstallationdirectory\Conf.
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- Update the Server-Name and Server-Connect-Name properties with the host name on which you installed the enterprise AR System.
- Using the mid tier, log on to the Primary and Secondary servers of the enterprise AR System and Cloud database products.
- Go to AR System Administration Console > System > General > Server Information > Connection Settings > Configuration tab.
- Clear the Server Group Member box.
- 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
- Using the mid tier, log on to any of the AR System server in the server group.
- 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.
- Using the mid tier, log on to the Primary and Secondary servers of enterprise AR System and Cloud database products.
- Go to AR System Administration Console > System > General > Server Information > Connection Settings > DSO Server tab.
- 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.
- 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:
Ensure that the enterprise AR System host has a minimum of 16 GB RAM and 4 CPUs available.
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- 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.
- Tune your MS SQL and Oracle databases according to the guidelines in the BMC Remedy AR System documentation: Preparing your database for an upgrade.
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
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}- Search for the CSM Change integration HTTP Callout entry.
- Click on View relationship and open the URL entry.
- 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