Upgrade process overview

This section describes how to upgrade from version 7.1.00, 7.2.00 or 8.0.00 to 8.1.00. 

Note

If you are upgrading a TrueSight Middleware Administrator cluster (MongoDB® replica set) you must stop all TrueSight Middleware Administrator servers and MongoDB® instances running on each host in the cluster, then follow the steps below on each host.

Note

It is recommended to compact database files prior to upgrading TrueSight Middleware Administrator as these may have grown significantly after using the product for a long time. To do so stop the True Sight Middleware Administrator service, backup your current database files and run the mongod command with the --repair option from the TrueSight Middleware Administrator installation directory. For example:

mongodb\mongodb-win32-x86_64-2.4.9\bin\mongod --dbpath data\db --repair

Be aware that running this command requires additional free disk space (about equal to the size of your current data set). See the MongoDB product documentation for more details.

To upgrade TrueSight Middleware Administrator

  1. Stop the TrueSight Middleware Administrator service.
  2. The upgrade preserves the following files and folders, but they should be reviewed after the installation has completed to confirm their preservation:
    • etc/jetty.xml
    • etc/jetty-deployer.xml
    • etc/jetty-selector.xml
    • etc/data.conf
    • etc/known_hosts
    • configuration/wrapper.conf
    • configuration/services/*
    • security/*
  3. Backup the installation directory. Zipping it and storing it somewhere safe is sufficient to backup the installation directory.
  4. To accelerate the upgrade process, the contents of the work/ directory can be deleted prior to the upgrade installation being run.
  5. Start the installation process. The installer displays a screen that allows the user to specify where the current product is installed.
  6. Start the TrueSight Middleware Administrator service and verify correct functionality of the product.

Note

After upgrading TrueSight Middleware Administrator, users should clear their browser cache to ensure the browser is picking up the upgraded Web-UI components. Otherwise, interference with cached components of a previous version of the product may cause unpredictable results when the browser renders the Web UI.

Note

When upgrading from version 7.1 to 8.0, be aware that the installer no longer preserves the following files:

etc/jetty.xml

etc/data.conf

configuration/wrapper.conf

configuration/services/*

The original files are located in the backupV72 sub-directory, and you will need to re-do any previous edits made to those files, using the backupV72 versions as a reference.

 

Preventing framing attacks ("clickjacking")

To protect TrueSight Middleware Administrator from framing attacks (so-called  'clickjacking') after upgrading an existing TrueSight Middleware Administrator installation to 8.0.00, edit etc/jetty.xml before starting the services and add the following section under the top-level <Configure> folder:

  

  <!-- =========================================================== -->
    <!-- Rewrite handlers -->
    <!-- =========================================================== -->
     <New id="RewriteHandler" class="org.eclipse.jetty.rewrite.handler.RewriteHandler">
       <Set name="rules">
         <Array type="org.eclipse.jetty.rewrite.handler.Rule">
           <Item>
             <New id="header" class="org.eclipse.jetty.rewrite.handler.HeaderPatternRule">
               <Set name="pattern">*.jsp</Set>
               <Set name="name">X-Frame-Options</Set>
               <Set name="value">DENY</Set>
             </New>
           </Item>
         </Array>
       </Set>
     </New>

 

 

 

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