Limited support This version of the product is in limited support. However, the documentation is available for your convenience. You will not be able to leave comments. Click here to view the documentation for the current version.

Installing the User Experience patch

Before you install Remedy with Smart IT (Smart IT) or BMC Digital Workplace, you must install the User Experience patch on your AR System server or server group. This patch enables BMC Remedy IT Service Management (BMC Remedy ITSM) to work with Smart IT and BMC Digital Workplace. The installation applies required BMC Remedy ITSM patches. 

To install the patch in an AR System server group, follow these procedures:

  1. Run the User Experience patch installer on the Admin server of the AR System server group environment.
  2. Run the User Experience patch installer on all nodes of the server group.

Related topics

BMC-Digital-Workplace-and-Smart-IT-installation-worksheets

Preparing-for-installation-of-BMC-Digital-Workplace-and-Smart-IT

Warning

BMC Remedy ITSM upgrades and patches will overwrite the User Experience patch changes. If you install Smart IT or BMC Digital Workplace for a supported BMC Remedy ITSM and later upgrade BMC Remedy ITSM to a new version or apply a service pack or patch, you must reinstall the User Experience patch, or neither Smart IT nor BMC Digital Workplace will perform correctly.

Before you begin

  • Ensure that you have the the following applications installed (minimum requirements):
    • BMC Remedy Action Request System (BMC Remedy AR System) 
    • BMC Remedy ITSM
    • BMC Service Request Management (if your implementation includes BMC Service Request Management)
  • Ensure that the BMC Remedy AR System server is running Java Runtime Environment (JRE) version 8 installed with the JAVA_HOME environment variable is set to the JRE path; for example, C:\Program Files\Java\jre1.8. Otherwise, the patch will not install correctly.
  • If you are installing the User Experience patch as a non-root user, make sure that your system administrator has completed the requirements described in Requirements-for-a-non-root-user-to-run-the-installer.
  • Back up your database and environment.
  • Find your completed BMC-Digital-Workplace-and-Smart-IT-installation-worksheets, so that you know the server on which BMC Digital Workplace (and, optionally, Smart IT) will be installed and what port it will use.

Important

Running the patch installer from any server other than the BMC Remedy ITSM server is not supported.

To install the User Experience patch

  1. On the BMC Remedy AR System and BMC Remedy ITSM server machine, download the installation files from http://www.bmc.com/available/epd.html: UserExperiencePatchversion.windows.zip or UserExperiencePatchversion.platform.tar.gz.
  2. After decompressing the User Experience patch files, run the setup.exe or setup.bin file.

  3. Complete the steps in the installation process by using the information that you collected on the installation worksheet.

    Note

    If you plan to use Smart IT, leave the Import only Digital Workplace definition files option deselected. Selecting this option imports data only for the BMC Digital Workplace application, and Smart IT data is not imported.

  4. Review the installation summary, and click Install.
  5. Run the user experience patch installer on secondary AR System servers in a server group.
    This action updates the binaries and plug-in files but does not import any .def files. When the patch is installed on the primary server, the .def files are imported and available in the database, so they do not need to be imported into the secondary servers.

If you have recently installed or upgraded BMC Remedy ITSM suite, the installation of User Experience patch might display the following message:
"Reindexing in progress.Please wait until the reindexing is finished on this AR".

Re-indexing may take from hours to days depending on your data. To check whether re-indexing is in progress, go to AR System Server Information > FTS tab. The Reindex check box is disabled if re-indexing is in progress and a message is displayed. Wait till the re-indexing is complete, and then install User Experience patch.

Sometimes, re-indexing may be stuck. Go to <BMC Software\ARSystem\ftsconfiguration\collection> and verify whether the index files generated are getting updated with the latest time stamp. A considerable difference in the current time and the latest timestamp implies FTS re-indexing is stuck. You need to re-index your data. Before re-indexing, delete the entries in the ft_pending table in the database.

Where to go from here

If you are  performing a fresh installation, verify whether you have any tasks remaining to prepare for installation.

If you are performing an upgrade, verify whether you have any tasks remaining to prepare for upgrade.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*