Space banner

   

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Installing the Smart IT User Experience patch

Before you install BMC Remedy with Smart IT (Smart IT) or BMC MyIT, you must install the Smart IT MyIT User Experience patch. This patch enables  BMC Remedy IT Service Management (BMC Remedy ITSM) to work with Smart IT and BMC MyIT. For Smart IT, this patch enables viewing incidents, requests, approvals, and so on in the timeline and activity feed. Without this patch, timelines, email notifications, and social features will not work in either Smart IT or BMC MyIT. The installation applies required BMC Remedy ITSM patches. 

To install the patch in a server group, follow these procedures:

  1. Run the Smart IT MyIT User Experience patch installer on the Admin server of the server group environment.
  2. Run the Smart IT MyIT User Experience patch installer on all nodes of the server group.

Warning

BMC Remedy ITSM upgrades and patches will overwrite the User Experience patch changes. If you install Smart IT or MyIT 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 Smart IT MyIT User Experience patch, or neither Smart IT nor MyIT will perform correctly.

Before you begin

  • Ensure that you have BMC Remedy Action Request System (BMC Remedy AR System), BMC Remedy ITSM, and BMC Knowledge Management installed. For more information about how to prepare for installing Smart IT or MyIT, see the topic about preparing for installation.

  • Ensure that the BMC Remedy AR System server is running Java Runtime Environment (JRE) version 7 or 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.
  • Back up your database and environment.
  • Complete the installation worksheet for BMC MyIT and Smart IT so that you know the server on which BMC MyIT (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.
  • While upgrading the User experience patch from Smart IT 1.1 to 1.2, the installer may run into one of the following issues:
    • The following error message is displayed: "Unable to copy SocialEventManager.jar to a destination directory".
    • The ArrayIndexOutofBound error is logged in the log file. 
    Solution: Run the installer in silent mode. For more information on silent installation, refer to Installing Smart IT using silent mode.
  • If you have recently installed or upgraded BMC Remedy ITSM suite, the installation of Smart IT MyIT User Experience patch may 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 Smart IT MyIT 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.

To install the Smart IT MyIT User Experience patch

  1. On the BMC Remedy AR System and BMC Remedy ITSM server machine, download the installation files for the social patch 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, do not select the Import only MyIT definition files option. Selecting this option imports data only for the MyIT application, and Smart IT data is not imported.

  4. Review the installation summary, and click Install
    When the installation process is complete, the AR System server is restarted.

  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.

Related topics 

Preparing for Smart IT installation

Downloading the Smart IT installation files

Installation worksheet

Modifying Smart IT or Smart IT Social server ports

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Comments

  1. Andreas Mitterdorfer

    The "Before you begin" section should list the requirement, that fts reindex should be finished (aka ft_pending table should be empty) on AR Server otherwise the installer stops with the corresponding note.

    Aug 31, 2015 08:26
    1. Catherine Siderine

      Hi Andreas,

      Thank you for your comment. I will pass it along to the person who takes care of this content.

      Regards,
      Cathy 

      Sep 03, 2015 05:00