This documentation applies to the 8.1 version of Remedy Action Request System, which is in "End of Version Support."

To view the latest version, select the version from the Product version menu.

Patch 1 for Service Pack 2: 8.1.02.001

This topic contains information about updates and fixes in this patch, and provides instructions for downloading and installing the patch.

Tip

For information about issues corrected in this patch, see Known and corrected issues

Notes

  • You can install this patch on 64-bit computers, not 32-bit.
  • You must have installed BMC Remedy Action Request (AR) System 8.1 Service Pack 2 before running the patch installer.
  • When the AR System patch is being applied, the patch installer restarts the AR System server as part of the installation process.
  • The patch installer does not use Install Anywhere Framework and is not affected by the IATEMPDIR system variable. If the default %TEMP% directory has insufficient space, increase the available space or change its location.
  • Ensure that all of the AR System objects, such as forms and workflows, have been released before you apply the patch.
  • After you apply the patch to the BMC Remedy Mid Tier, flush the mid-tier cache and delete the content from the following folders:
    <Midtier>\cache\
    <Midtier>\cachetemp\
    <Tomcat>\Work\Catalina\localhost\arsys\
    <Tomcat>\temp\
    <Midtier>\PluginsCache\
  • For a list of AR System files that are updated by Patch 1, download and unzip ARSystem8102Patch1FileList. This zip file contains lists for all supported platforms.

Reviewing the patches currently installed on your computer

To review all the current patches installed on your computer, perform the following steps:

  1. Open the Maintenance Tool (installed under C:\Program Files\BMC Software\ARSystem\arsystem).
  2. Click Browse to Log.
  3. Scroll through the Navigation pane to find the <Product>InstalledConfiguration.xml file for the product patch that you installed; for example:

    C:\Program Files\BMC Software\ARSystem\ARSystemInstalledConfiguration.xml

    C:\Program Files\BMC Software\BMCServiceRequestManagement\BMCServiceRequestManagementInstalledConfiguration.xml

  4. Double-click the file to open it in the Maintenance Tool.
  5. Click the Product Feature Map tab.
  6. Under Updates, review the patches installed on your computer.
    (Click the image to expand it.)

Installing the patch and reviewing the result

The patch installer determines which modules are already installed on the target computer and then applies the patches only to those modules. For example, if you run the AR System patch installer on a computer that is running only the AR System server, then only the fixes relevant to the AR System server are applied.

Note

If you install the patch by using the SSI installer, ensure that you add the following code to the ARSystemInstalledConfiguration.xml before you begin the patch installation:

<productFeature backupOnUpgrade="false" id="featureDeveloperStudio" independentOfChildren="true" parent="featureARSystemClients"
rebootRequiredOnInstall="false" rebootRequiredOnUninstall="false" rebootRequiredOnUpgrade="false" requiredDiskSpaceMode="default"
requiredRAMMode="default" state="INSTALLED" visible="true">
    <version majorVersion="1" minorVersion="02" releaseVersion="8"/>
    <requiredDiskSpaceMap>
        <requiredDiskSpace id="default" size="123 MB"/>
        <requiredDiskSpace id="backup" size="0 bytes"/>
        <requiredDiskSpace id="temporary" size="0 bytes"/>
    </requiredDiskSpaceMap>
        <requiredRAMMap>
        <requiredRAM id="default" size="512 MB"/>
    </requiredRAMMap>
</productFeature>

To install the patch and review the result

Note

You must disable escalations before you install the patch.

If you are installing the patch on a server group, you must disable escalations only when installing the patch on the administrator server.

  1. Download the patch installer from the BMC Electronic Product Download site, or navigate to the installation directory on the CD. For more information, see Downloading the installation files.

  2. Unzip the suite installer.

  3. Navigate to the Disk 1 folder.

  4. Start the installer:

    • For Windows, run setup.cmd.

    • For UNIX, log on as root and run setup.sh.

  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. On the Patch contents panel, review what is included in the patch, and then click Next.

  8. On the BMC Remedy AR System User Inputs panel, review the AR System server values, and then click Next.

    Note

    On AIX operating systems, you must manually provide the value for the AR System server TCP port.


  9. On the Installation Preview panel, review the list of patch fixes that you are installing, and then click Install.

  10. When the patch installation is finished and the Installation Summary panel appears, click View Log to review the SEVERE error messages or warnings in the product installer log.

    Determine whether the errors are due to network, host, or other environment-related issues.

    The installation log is located in the %TEMP% folder of your computer; for example:

    C:\Users\Administrator\AppData\Local\Temp\arsystem_install_log.txt

    C:\Users\Administrator\AppData\Local\Temp\bmcservicerequestmanagement_install_log.txt

  11. Close the log when you finish.

  12. Click Done to exit the patch installer.

  13. Use the Maintenance Tool to review the patch information.

    Note

    Ensure that you re-enable escalations after you finish installing the patch.

To install the patch on a server group

To install the patch on a server group, perform the following steps:

  1. Shut down all of the non administrator servers in the server group.
  2. If you have configured a load balancer, disable the administrator server on the load balancer.
  3. Remove the administrator server from the server group.
  4. Disable escalations by following the instructions in Disabling escalations.
  5. Install the patch on the administrator server by following the instructions in Installing the patch and reviewing the result.
  6. Enable escalations.
  7. Add the administrator server back to the server group.
  8. Restart the administrator server.
  9. If you have configured the load balancer, enable the administrator server on the load balancer.
  10. On each of the non administrator servers, perform the following steps:
    1. Start the BMC Remedy AR System service.
    2. Install the patch by following the instructions in Installing the patch and reviewing the result.
    3. Enable the server on the load balancer.

Disabling escalations

  1. Open the BMC Remedy AR System Administration Console.
  2. Open Server Information.
  3. Click the Configuration tab.
  4. Select Disable Escalations.

  5. Click OK.

Performing a silent installation

  1. Use the Maintenance Tool to create an encrypted password.

  2. Create a text file called Options.txt and add the following options that correspond to user input:

    -J BMC_AR_USER=<AR System Admin User>
    -J BMC_AR_PASSWORD=<AR System User Password>
    -J BMC_AR_PORT=<AR System TCP Port>
    -J BMC_AR_SERVER_NAME=<Server Alias>

    For example:

    -J BMC_AR_USER=Demo
    -J BMC_AR_PASSWORD=DES\:51208e44b3bc2f3808839e457d4e2050
    -J BMC_AR_PORT=0
    -J BMC_AR_SERVER_NAME=vw-sjc-aus-idd04
  3. Open a command window and navigate to the Disk 1 folder.

  4. Run the installer with the -i silent option:

    • For Windows:

      setup.cmd -i silent -DOPTIONS_FILE= <pathToFile>\Options.txt
    • For UNIX:

      setup.sh -i silent -DOPTIONS_FILE= <pathToFile>/Options.txt

      You must use an absolute path to the Options.txt file.

  5. Use the Maintenance Tool to review the patch information.

Reconciling your customizations

For information about reconciling your customization, see Comparing objects after you upgraded with overlays already present. Ensure that you perform the mandatory step of reconciling after an upgrade with overlays already present.

If you use the object modification log, see Object modification log for information about obtaining a list of modified objects after you apply the hotfixes. Alternatively, if objects are modified by the patch, a Bill of Materials file (BillofMaterials.txt) will be available to identify the affected objects.

Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Stefan Hall

    I followed the instruction under "install the patch on a server group" and at point 5 I got this error message.

    Disable server group at primary server didn't work.It seems the installer can't handle the correct configured ar.conf entries. Maybe I have to change these settings too

    Dec 09, 2014 03:23
    1. Prachi Kalyani

      Hello Stefan,

      Thank you for your comment. Please contact  BMC Customer Support for assistance.

      Thanks,

      Prachi

      Dec 09, 2014 04:22
  2. Darmawan Chia

    Hi,

    In the notes, you mentioned that "you can install this patch on 64-bit computers, not 32-bit"

    does it mean currently there's no patch yet for 32-bit computer?

     

    Please advise as currently I am setting up ARS 8.1.02 on Win 2008 32-bit, I tried to rum the setup.cmd but it said cannot find JAVA_HOME but when I run the setup.jar it shows the patch installer GUI, thanks.


    Dec 20, 2014 11:30
    1. Prachi Kalyani

      Hello,

      Thank you for your comment. As mentioned in the notes, BMC does not provide patch for  32-bit computers. You can install the patch on 64-bit computers.

      Thanks,

      Prachi

      Dec 22, 2014 01:29
  3. Raimo Waldvogel

    Hello,

    We have an 8.0 environment with ARServer, MidTier, Emailengine...

    Now I have installed the 8.1.02 MidTier (because we only want to update the MidTier) and now I want to install the Patch001 for the MidTier. But I can not select only the MidTier in the Patch Installer. The Installer always want to update ARServer, MidTier and Emailengine...

    Is there a copy file method for a MidTier upgrade? I could not find a Install description.

     

    best regards,

    Raimo

     

     

     

    Jan 06, 2015 08:10
    1. Prachi Kalyani

      Hello,

      Thank you for your comment.

      Please update you system environment variable with Variable Name as BMC_AR_SYSTEM_HOME and Variable Value as location of the Mid Tier folder on your system.

      Thanks,

      Prachi

      Jan 08, 2015 11:31
      1. Raimo Waldvogel

        Hello Prachi

        Thx for the hint.
        There is already a BMC_AR_SYSTEM_HOME = C:\Program Files\BMC Software\ARsystem
        The midtier folder is in this folder (default installation) but arsystem and emailengine folders are here too.

        Is there a way that the patch installer only "sees" the midtier folder?

        best regards,
        Raimo

         

         

        Jan 13, 2015 08:34
        1. Prachi Kalyani

          Hello,

          Thank you for your comment.

          BMC recommends you to install the Mid Tier war file from the Electronic Product Distribution (EPD) facility for the mid tier fixes.

          Installing the AR System 8.1.02 Patch 001 may cause issues because you have an 8.0 environment with ARServer, MidTier, Emailengine and you have installed the 8.1.02 MidTier.

          Thanks,

          Prachi

          Jan 14, 2015 12:25
          1. Raimo Waldvogel

            Hello Prachi,

            Therefore I have to replace the hole content of the C:\Program Files\BMC Software\ARsystem\midtier with the content of the MidTier.war? right?
            Is there somewhere a official documentation for that?

            best regards,
            Raimo

            Jan 14, 2015 01:06
            1. Prachi Kalyani

              Hello Raimo,

              Instead of replacing the entire content, BMC recommends you to configure your web server and install BMC Remedy Mid Tier with the .war file. For more information see, Configuring your web server and installing BMC Remedy Mid Tier with a .war file.

              Thanks,

              Prachi

              Jan 28, 2015 12:44
              1. Raimo Waldvogel

                Thx for the link!

                Feb 03, 2015 08:23
  4. Suresh Loganathan

    Hello Prachi,

     

    First time, I am trying to install the patch in Solaris(Sun OS 5.10) OS. Before doing the installation any things needs to note?

    Thanks,

    Suresh

    Apr 29, 2016 07:39
    1. Prachi Kalyani

      Hello Suresh,

      The above information available on the topic will be sufficient to help you install the patch.

      Please follow the instructions mentioned on this topic.

      Thanks,

      Prachi

      May 03, 2016 12:40