Performing the BMC Remedy AR System client upgrades

Perform the steps in this topic to upgrade the following components with the interface-based BMC Remedy AR System server installer:

• BMC Remedy Developer Studio (and the Localization Toolkit)
• BMC Remedy Data Import
• Atrium Integrator Spoon

Before you begin

• If you have not done so already, do one of the following to prepare the server group for upgrade:

  • Preparing the AR System server for a server group upgrade - Perform these steps when you are performing a staged upgrade or plan to upgrade the server group during a scheduled outage window. 
  • Preparing for an in-place, zero-downtime upgrade of the platform - If you want to upgrade the platform components that are a part of a server group environment with no scheduled outage, you must perform pre-configuration steps on the primary and secondary servers prior to 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 Remedy AR System clients

1. If you have not already downloaded the installer, download the BMC Remedy AR System installer from EPD, or navigate to the installation directory on the DVD. See Downloading the installation files.

2. Unzip the suite installer (for example, ARSuiteKitWindows.zip or ARSuiteKitLinux.zip).

3. Navigate to the Disk 1 folder.

4. Start the installer; then, in the lower right corner of the Welcome panel, click Next.

5. Run the setup:
   • (Windows) Run setup.exe.
   • (UNIX) Run setup.bin.

6. Review the license agreement, click I agree to the terms of license agreement, and then click Next.

7. On the Products selection panel, select AR System clients.

   1. Navigate to the directory in which you want to install the BMC Remedy AR System application.
      The default locations are 
      • (Windows) C:\Program Files\BMC Software\ARSystem
      • (UNIX) /opt/bmc/ARSystem
   2. Use the installation spreadsheet to enter the correct values in the AR System Server User and Database Information pane.
   3. Click Next.
      The installer validates your system resources.

8. Review the JRE path that is auto-populated based on the path specified during installation, and then click Next. 
   The installer validates your inputs, and then the Installation preview panel appears, listing the product and product features that will be upgraded.

9. Click Next.
10. The BMC Remedy AR System features you have selected are installed. After post-installation cleanup, a summary of the installation appears.
11. Click View Log to review the installer log for any errors.
    The install logs are available at the following location: 
    • (Windows) C:\Users\Administrator\AppData\Local\Temp\arsystem_install_log.txt
    • (UNIX) /tmp/arsystem_install_log.txt
      
      After you have analyzed the logs, close the log.
12. To exit the BMC Remedy AR System installer, click Done.

After you upgrade BMC Remedy AR System clients

After you upgrade, check whether a patch or fix has been released in Release notes and notices. When you upgrade the product, you must install the latest service pack and then apply the latest patch (if available). Patches are not full installations and must be applied over the latest full installation (main release or a service pack).

Updating external Developer Studio plug-ins

When you upgrade BMC Remedy Developer Studio, the installer performs the following actions:

• Moves the previous Developer Studio files to a DeveloperStudioBackup folder. (This includes workspaces and external plug-ins.)
• Places the new binaries in the DeveloperStudio folder.
• Copies workspaces from the DeveloperStudioBackup folder to the DeveloperStudio folder.

External Developer Studio plug-ins that you configured before the upgrade are not copied to the DeveloperStudio folder.

To ensure that the correct plug-ins are in the DeveloperStudio folder

Manually copy external Developer Studio plug-ins from the DeveloperStudioBackup folder to the DeveloperStudio folder.

Troubleshooting the BMC Remedy AR System clients

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

• Working with logs
• 2021-01-05_00-08-25_Troubleshooting data and workflow import issues