This documentation supports the 19.02 version of Remedy with Smart IT.

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

Performing the Smart IT upgrade

This topic describes how to use the GUI wizard installer to upgrade Smart IT on a single server. Other options for running the installer are described in Performing the Smart IT installation.

Before you begin

  • Complete the steps described in Preparing for upgrade.
  • Ensure that you have upgraded to BMC Remedy IT Service Management 19.02.
  • Installed Smart IT and Digital Workplace on separate Apache Tomcat servers.


The installer will upgrade only Smart IT. If you are using BMC Digital Workplace and Smart IT, you must upgrade BMC Digital Workplace first before upgrading Smart IT.

Best practices

Do not use Xming to install the Smart IT server, because it might not perform reliably during installation. Instead, use VNC, MobaXterm, or any other client.

To upgrade Smart IT on a single server

  1. Extract the Smart IT installer (for example, or SmartITVV.VV.VV.Linux.tar.gz where VV.VV.VV and V.V.V indicate the version numbers of Smart IT).
  2. Navigate to the Disk 1 folder.
  3. Start the installer:
    • For Windows, run setup.exe.
    • For UNIX, run setup.bin.

  4. On the Welcome panel, click Next.
  5. Review the license agreement, click I agree to the terms of license agreement, and then click Next.
  6. Enter the values from the Upgrade worksheet.
    After you have entered the required information, the installer validates your input. 
  7. (Optional) Back up the following databases before performing an upgrade in your production environment: 
    • Remedy with Smart IT database 
    • BMC Remedy AR System database

    BMC recommends that you back up the databases in case you experience upgrade errors related to database schemas or AR System workflow. If the upgrade fails, you can use the backups to restore the databases and resume the upgrade from the last successful step.
  8. Click Next.
  9. Enter a new destination directory name to store the file system of Smart IT 19.02.
    If you do not enter a new directory name, an error occurs and installation will not progress further until you provide a different directory name. Ensure that the directory name is different than the previous directory name. For example, if your previous directory name was Smart_IT_MyIT, provide a new directory name, such as SmartIT.
  10. In the Smart IT Database Information panel, select the option to create new schemas, enter the schema names, and database administrator credentials and click Next.
  11. Click Next.


    Starting with Smart IT version 18.05, the Smart IT and Digital Workplace installers are separated. Therefore, in steps 9 to 11, you must provide new destination directory name and Smart IT system and business schema names to avoid errors. If you are upgrading from 18.05 to 19.02, then the steps 9 to 11 are not applicable.

  12. In the Installation Preview panel, review and, if needed, correct the installation details and click Install.
    After post-installation, a summary of the installation appears.
  13. From the installation summary, review the information and any instructions or errors.
    For example, if a database failed, you can recover and run the upgrade again from the backup of your database by performing the recovery steps:
    1. Restore the database by using the backup created in step 7.
    2. View the installation log files to find and correct the cause of failure.
      For example, review any SEVERE error messages or warnings in the product installer log. See whether errors are due to network, host, or other environment-related issues. You can view a log file of the installation: 
      • (Windows) C:\Users\Administrator\AppData\Local\Temp\smartit_install_log.txt  
      • (UNIX or Linux) /tmp/smartit_install_log.txt
    3. Run the installer again.
      The upgrade will resume from the last successful step.
  14. Click Done to exit the installer.

To upgrade Smart IT in a server group

After you have upgraded at least one server, you can upgrade additional servers in the server group, either separately or in parallel, by following the steps in To upgrade Smart IT on a single server.

Post-Upgrade tasks

After the upgrade is complete, perform the following tasks:

Run the migration utilities

Stop and delete services

  • Stop and delete the relevant service:
    • (Windows) From the list of services, manually stop and delete MyITSocialService.
    • (Linux) Run the following command at a command prompt:
      service socialserviced stop
  • Stop and delete the relevant MongoDB service:
    • (Windows) From the list of services, manually stop and delete MongoDB.
    • (Linux) Run the following command at a command prompt:
      service mongod stop
  • From the pluginsvr_config.xml file, delete the SocialEventManager plug-in entry. The  pluginsvr_config.xml file is available at the following path: 

    <C:\Program Files\BMC Software\ARSystem\pluginsvr\pluginsvr_config.xml>

Verify the Activity feeds

Verify the Activity feeds from the respective worklog forms and from the SMT:Social_Events form.

Where to go from here

Verifying the Smart IT server installation

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


  1. Rainer Noeth

    If we upgrade SmartIT in a server group, did we have zero downtime? When we upgrade the primary can the users work on the other server?

    May 30, 2019 03:57
    1. Nilay Agambagis

      Hello Rainer,

      Thanks for your comment. As of now, Smart IT does not support zero downtime.


      Nilay Agambagis

      Jun 03, 2019 01:33
  2. Peter Guggenbuhl

    Hello In the Documentation is written: <<From the pluginsvr_config.xml file, delete the SocialEventManager plug-in entry>>

    Can You please state more exactly where this file is located. I assume this is the file on the ARSystem Server. However, there exist several pluginsvr_config.xml files on the ARSystem Server. Thanks for a short statement Peter

    Aug 14, 2019 04:25
    1. Nilay Agambagis

      Hello Peter,

      Thanks a lot for your comment.

      I have included the path/location of the pluginsvr_config.xml file in this topic.


      Nilay Agambagis

      Aug 22, 2019 05:06
  3. Sidhdesh Punaskar

    We should add note in documentation that customer should use different tomcat instance other than DWP tomcat as it is not supported and there are many issues reported.
    Recently customer reported an issue where it was working with same tomcat till 1805 version with Smart IT and DWP. Smart IT was upgraded to 1908 but DWP 1908 is removed from EPD and only 1911 is available and since upgrade to DWP 1911, Smart IT stopped woking. Only DWP is running on same tomcat.

    Feb 13, 2020 08:33
    1. Nilay Agambagis

      Hello Sidhdesh,

      Thanks a lot for your comment. This is already documented in the landing page of Upgrading, as a Best Practice to upgrade (3rd bullet):



      Nilay Agambagis

      Feb 13, 2020 11:53