Performing the BMC Atrium Core Web Services upgrade

Before you begin

If you have not already done so, perform the tasks in Preparing-for-the-BMC-Atrium-Core-upgrade.

If you have not done so already, prepare the system to run the installers. If you want to run in nonadmin mode on Windows, see Preparing-a-Windows-environment. If you want to run in nonroot mode on UNIX, see Preparing-a-UNIX-environment.

To upgrade BMC Atrium Core Web Services

1. If you have not already done so, download the BMC Atrium Core installer on a computer other than where you installed the AR System server.
2. Unzip the installer.
3. Navigate to the Disk 1 folder.
4. Start the installer.
   • For Windows, run setup.cmd.
   • For UNIX, run setup.bin.
5. In the lower right corner of the Welcome panel, click Next.
6. Review the license agreement, click I agree to the terms of license agreement, and then click Next.
7. In the AR System Server Information panel, perform the following actions:
   1. Enter BMC AR System username and password.
   2. Enter BMC AR System port number and host name.
   3. Navigate to the directory in which you want to install BMC Atrium CMDB.
      The default locations are:
      • (Windows) C:\Program Files\BMC Software\AtriumCore
      • (UNIX or Linux) /opt/bmc/AtriumCore
   4. Click Next.
      The installer validates the system resources of your computer.
8. In the Install mode panel, select Upgrade, and then click Next.
   During upgrade, only existing BMC Atrium Core components are upgraded.
9. In the Confirmation panel, confirm that you have backed up the database and met the memory requirements. Then Click Yes, and then click Next.
10. (Optional) If any pre-check errors occur, the Pre-Checks for BMC Atrium Core panel is displayed with the details. Fix the errors and then proceed with the installation.
    The Run Health Check panel appears. For more information, see Troubleshooting-BMC-Atrium-Core-issues.
11.  Perform the following steps, as required:
    1. To run additional validation tests, click Next.
    2. Otherwise, select the No option, and then click Next.
       The health check is run after the upgrade. The installer validates your inputs, and then the Installation Preview panel appears, listing the product and product features that will be installed.
12. Click Install.
    A summary of the installation appears.

13. Click View Log to review the installer log for any errors or warnings. The install logs are available at the following location:

    • (Windows) C:\Users_<installUser>_\AppData\Local\Temp\atriumcore_install_log.txt
    • (UNIX and Linux) \tmp\atriumcore_install_log.txt

    If the installation fails see, Troubleshooting-BMC-Atrium-Core-issues.

14. Close the log when you finish.
15. Click Done to exit the BMC Atrium Core installer.

Post upgrade steps: if upgraded from 9.0.00 or older versions

When you upgrade from 9.0.00 or an older version, the web services added to the registry in the older version are removed. You can restore the web services by using one of the following methods:

• Republish the web services to the 18.05 environment.
• The back up of the web services is created and stored at AtriumCore\BackUp\derby-db. After upgrading to Remedy 18.05, you can import the derby-db back up into your 18.05 environment by performing the following steps:

1. 
   
   1. Stop the Tomcat server that hosts the UDDI Registry Server.the 
   2. Navigate to the AtriumCore\shared\wsc\data\bmcuddi directory.
   3. If the derby-db/ directory exists, move it to another directory outside the <ATRIUMCORE_HOME>location, or rename it, such as derby-db.bak.
   4. Copy the AtriumCore\BackUp\derby-db  directory to AtriumCore\shared\wsc\data\bmcuddi
   5. Start the Tomcat server.

Troubleshooting the BMC Atrium Core upgrade

Consult the following topics for information about issues you might encounter during the upgrade:

• Platform-installation-and-upgrade-known-and-corrected-issues
• Working-with-logs
• 2021-01-05_00-08-25_Troubleshooting data and workflow import issues
• Troubleshooting-driver-issues
• Troubleshooting-BMC-Atrium-Core-issues

Where to go from here