Upgrading IT Data Analytics in a multiple server environment silently

Where you are in the Upgrade process

StepTask
1Preparing to upgrade the TrueSight Operations Management solution
2Upgrade Remedy Single Sign-On
3Upgrade TrueSight Presentation Server
4Upgrade TrueSight Infrastructure Management
5Upgrade App Visibility Manager
6Upgrade Real End User Experience Monitoring Software Edition
7Upgrade TrueSight IT Data Analytics (You are here)

You can upgrade IT Data Analytics in a multiple server environment, silently, by doing a custom upgrade. The silent upgrade obtains the required user inputs from the options files. You can download sample options files from within the procedure below, or you can generate them.

To perform a custom upgrade silently

Do the following:

  1. Log in to the host computer on which you want to upgrade IT Data Analytics, and delete all the files from the temporary directory: 

    • (Windows) %temp%
    • (Linux/tmp

  2. Extract the downloaded files (the installer) to a temporary location outside the following location to avoid any file sharing conflicts.

    • (WindowsC:\Program Files

    • (Linux) /opt

    It is strongly recommended that you exit all programs before starting the installation.

    • Page not found for multiexcerpt macro.
    The page: .Upgrading IT Data Analytics in a single server environment silently v11.3.01 was not found. Please check/update the page name used in the 'multiexcerpt-include' macro.
  3. Download the following sample options files depending on the component that you want to upgrade and your environment, or generate one. To generate the file, go to Step 6.

    ComponentWindows Sample Options fileLinux Sample Options file
    Indexer
    Search Server Configuration Database
    Search
    Collection Station
    Console Server

  4. Copy the sample options file to the following folder on every computer where you want to upgrade the components:

    • (Windows) C:\Program Files\BMC Software\TrueSight\ITDA
    • (Linux) /opt/bmc/TrueSight/ITDA

    To install the product in a different location, change the value of the installLocation property in the options file.

    • Page not found for multiexcerpt macro.
    The page: .Upgrading IT Data Analytics in a single server environment silently v11.3.01 was not found. Please check/update the page name used in the 'multiexcerpt-include' macro.

  5. You will need to type the Remedy Single Sign-On password in an encrypted form in the options file in Step 8. Encrypt this password using the EncryptPWD utility:
      Page not found for multiexcerpt macro.
    The page: .Upgrading IT Data Analytics in a single server environment silently v11.3.01 was not found. Please check/update the page name used in the 'multiexcerpt-include' macro.
    • Page not found for multiexcerpt macro.
    The page: .Upgrading IT Data Analytics in a single server environment silently v11.3.01 was not found. Please check/update the page name used in the 'multiexcerpt-include' macro.
    • Page not found for multiexcerpt macro.
    The page: .Upgrading IT Data Analytics in a single server environment silently v11.3.01 was not found. Please check/update the page name used in the 'multiexcerpt-include' macro.
    • Page not found for multiexcerpt macro.
    The page: .Upgrading IT Data Analytics in a single server environment silently v11.3.01 was not found. Please check/update the page name used in the 'multiexcerpt-include' macro.
    • Page not found for multiexcerpt macro.
    The page: .Upgrading IT Data Analytics in a single server environment silently v11.3.01 was not found. Please check/update the page name used in the 'multiexcerpt-include' macro.
    • Page not found for multiexcerpt macro.
    The page: .Upgrading IT Data Analytics in a single server environment silently v11.3.01 was not found. Please check/update the page name used in the 'multiexcerpt-include' macro.
    • Page not found for multiexcerpt macro.
    The page: .Upgrading IT Data Analytics in a single server environment silently v11.3.01 was not found. Please check/update the page name used in the 'multiexcerpt-include' macro.
  6. (Optional) If you are upgrading from TrueSight IT Data Analyticsversion 2.7, ensure that you modify the properties for re-indexing after upgrading.

     To modify the properties for re-indexing

    When you upgrade from TrueSight IT Data Analyticsversion 2.7, the indexes are migrated to TrueSight IT Data Analytics11.3.01 by default. You can modify some properties to manage the way you are re-indexing the data. Search features of TrueSight IT Data Analytics such as histogram, facets, and search counts of older data are available after the migration is complete. The migration may take some time depending on the size of data.

    Notes

    • After upgrading, if you create an Upload file  type of data collector to collect earlier data, then it is possible that the collected data is added to an existing index. As a result, the search performed on this data will work in a case-sensitive way.
    • If you have existing external configurations for the TrueSight Infrastructure Management (or ProactiveNet) cells, you might need to edit them and change the encryption key. Changing the encryption key is required if TLS is enabled for TrueSight Infrastructure Management on TrueSight Operations Management 10.7. You must import the certificates generated on the TrueSight Operations Management side to be able to create new external configurations in version  11.3.01 of TrueSight IT Data Analytics. For more information, see  Enabling security for communication with Infrastructure Management server
    • Re-indexing may increase CPU utilization. You can use throttling, which increases the time taken for re-indexing, but reduces the CPU utilization. For more information refer to the table.

    Do the following:

    1. Log in to the host computer on which you have installed TrueSight IT Data Analytics.

    2. Navigate to the following location: 

      <ITDA_INSTALLATION_DIRECTORY>\BMC Software\TrueSight\ITDA\custom\conf\server\olaengineCustomConfig.properties

    3. Modify the values of the following properties in the olaengineCustomConfig.properties file:

      PropertyAdditional information
      reindex.enabled

      Enables re-indexing.

      Example

      reindex.enabled=true

      By default the value is set to true.

      Note: If reindexed.enabled is set to false, the previously indexed data may not be compatible with the new version of TrueSight IT Data Analytics .

      Features such histograms and facets of older data will not be available.

      #reindex.number.of.last.days

      Sets the number of days for which the re-indexing is to be done.

      Example

      #reindex.number.of.last.days=14

      You can set the value to the number of days for which you want the re-indexing to be done. Depending on the number of days that you specify, the previously indexed data will be available for re-indexing.

      Tip

      You must uncomment the property if you want to change it.

      reindex.wait.before.next.bulk.write.millis

      Sets the wait time in milliseconds before writing the next bulk (or chunk) into new Indexes while re-indexing.

      Example

      reindex.wait.before.next.bulk.write.millis=0

      The default value is 0. The default value 0 means that there should be no wait time.

      Setting this value enables you to decrease the Indexer CPU usage while re-indexing. Increasing this value will decrease the CPU usage on the indexer.

      reindex.bulk.flush.threshold.millis

      Sets the time in milliseconds; that are passed after the last bulk flush or start of the bulk process. The bulk that is accumulated will be flushed (written) into the Indexer after this period is over. This happens irrespective of the bulk size.

      Example

      reindex.bulk.flush.threshold.millis=60000

      The default value is 60000.

      Note

      After changing the properties, if the Console Server component is already running, restart it.

  7. Restore the backed up keystore file (bmcitda.jks), and restart the IT Data Analytics server after upgrading.

    Note: The bmcitda.jks keystore file is backed up before upgrading to ensure that the custom certificates are not lost after upgrading.

Troubleshooting upgrade issues

If you face issues during the upgrade, see Troubleshooting an IT Data Analytics deployment

Where to go from here

Now that you have upgraded the TrueSight Operations Management solution, take advantage of the new and enhanced product features. See Release notes and notices to know more.

Where to go from here

Now that you have upgraded the TrueSight Operations Management solution, take advantage of the new and enhanced product features. See Release notes and notices to know more.

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

Comments