Upgrade the systems in your environment in the following order:

  1. NW Server hosts
  2. Analyst UI hosts
  3. ESA Primary hosts
  4. ESA Secondary hosts
  5. The rest of your component hosts

Note: NW Server, Analyst UI, and ESA Primary and Secondary hosts must all be upgraded on the same day. The rest of your component hosts can be upgraded on the same day or later.

For information about all the host types in NetWitness, see the Host and Services Getting Started Guide for NetWitness Platform XDR. Go to the NetWitness All Versions Documents page and find NetWitness Platform guides to troubleshoot issues.

Important Notes

Synchronize Time on Component Hosts with NW Server Host

Before you upgrade hosts, make sure that the time on each host is synchronized with the time on the NetWitness Server.

To synchronize the time, do one of the following:

  • Configure the NTP Server. For more information, see "Configure NTP Servers" in the System Configuration Guide.
  • Perform the following steps on each host:
    1. SSH to the Admin Server host.

    2. Run the following commands.

      salt \* service.stop ntpd

      salt \* cmd.run 'ntpdate nw-node-zero'

      salt \* service.start ntpd

Mixed Mode Unsupported for ESA Hosts

Mixed mode is not supported for ESA hosts in NetWitness Platform. The NetWitness server, ESA primary host, and ESA secondary host must all be on the same NetWitness Platform version.

Respond Server Service Not Enabled Until NW Server and Primary ESA Host Upgraded to same version

After upgrading the primary NW Server (including the Respond Server service), the Respond Server service is not automatically re-enabled until after the Primary ESA host is also upgraded to same version. The Respond post-upgrade tasks only apply after the Respond Server service is upgraded and is in the enabled state.

Guidelines for Deploy_Admin Password

In NetWitness Platform version 11.6 or Later, deployment account password (only on node-zero) must contain at least one number, one upper and lower case letter, and one special characters (!@#%^,+ . ) along with the existing policy. The same password policy applies while updating deploy_admin password using nw-manage script.

If deploy_admin password is changed on Primary NW Server, it must be changed in the Warm Standby Server if it exists.

Upgrade Options for NetWitness Platform XDR

You can choose one of the following upgrade methods based on your Internet connectivity. They are listed in the order recommended by NetWitness Platform XDR.

The following rules apply when you are upgrading hosts for all of these upgrade methods:

  • You must upgrade the NW Server host first.
  • You can only apply a version that is compatible with the existing host version.
  • The NW Server, ESA primary, ESA secondary, and Analyst UI hosts must all be on the same NetWitness Platform version.

Option 1: Upgrade NetWitness Platform XDR

You can use this method if the NW Server host is connected to Live Services and if you are able to obtain the package.

Prerequisites

  1. The Automatically download information about new upgrades every day option is selected and is applied in AdminIcon_25x22.png(Admin) > System > Updates.
  2. Updates are available. Go to AdminIcon_25x22.png(Admin) > Hosts > Update > Check for Updates to check for updates. The Host view displays the Update Available status.
  3. 11.7.3.0 is available in the Update Version column.

To upgrade from 11.5.3.2, 11.5.3.3, 11.6.x.x, 11.7.0.x, 11.7.1.0, 11.7.1.1, 11.7.1.2, and 11.7.2.0 to 11.7.3.0:

  1. Go to AdminIcon_25x22.png(Admin) > Hosts.
  2. Select the NW Server (nw-server) host.

  3. Check for the latest updates.
    Chk4Upds.PNG

    Note: On clicking Check for Updates, if you encounter the Unauthorized error message, follow the workaround provided in the Host Update Failed Error section in Troubleshooting Installation and Upgrade Issues.

  4. Update Available is displayed in the Status column if you have a version update in your Local Update Repository for the selected host.

  5. Select 11.7.3.0 from the Update Version column. If you:

    • Want to view a dialog with the major features in the upgrade and information on the updates, click the information icon (ic-inline_help.png) to the right of the upgrade version number.
    • Cannot find the version you want, select Update > Check for Updates to check the repository for any available updates. If an update is available, the message "New updates are available" is displayed and the Status column updates automatically to show Update Available. By default, only supported updates for the selected host are displayed.
  6. Click Update > Update Host from the toolbar.
  7. Click Begin Update.
  8. Click Reboot Host.
  9. Repeat steps 6 to 8 for other hosts.

Note: You can select multiple hosts to upgrade at the same time only after updating and rebooting the NW Server host. All ESA, Endpoint, and Malware Analysis hosts should be upgraded to the same version as that of the NW Server host.

Note: In 11.7.1.0 or later versions, you can pre-stage the upgrade repository using the Pre Stage Host feature. Refer the following screenshot. For more information, see Option 4 (Optional): Pre-Stage Upgrade Repository by Downloading Packages.

pre-stage_upgrade_guide_12.0.PNG

Option 2: Upgrade NetWitness Platform XDR Offline

Task 1. Populate Staging Folder (/var/lib/netwitness/common/update-stage/) with Version Upgrade Files

  1. Make sure that you have downloaded the following file from NetWitness Community (https://community.netwitness.com/) > Products > NetWitness Platform > Downloads to a local directory:
    • If you are upgrading from 11.5.3.2, 11.5.3.3, or 11.6.x.x, download netwitness-11.7.0.0.zip, netwitness-11.7.1.0.zip, netwitness-11.7.2.0.zip, and netwitness-11.7.3.0.zip
    • If you are upgrading from 11.7.0.0, 11.7.0.1, or 11.7.0.2, download netwitness-11.7.1.0.zip, netwitness-11.7.2.0.zip, and netwitness-11.7.3.0.zip
    • If you are upgrading from 11.7.1.0, 11.7.1.1, or 11.7.1.2, download netwitness-11.7.2.0.zip and netwitness-11.7.3.0.zip
    • If you are upgrading from 11.7.2.0 to 11.7.3.0, download netwitness-11.7.3.0.zip
  2. SSH to the NW Server host.
  3. Copy netwitness-11.7.3.0.zip, netwitness-11.7.2.0.zip, netwitness-11.7.1.0.zip, and netwitness-11.7.0.0.zip (if upgrading from 11.5.3.2, 11.5.3.3, or 11.6.x.x) from the local directory to the /var/lib/netwitness/common/update-stage/ staging folder.
    For example:

    If you are logged as a root user you can run the following command without sudo:

    cp /tmp/netwitness-11.7.3.0.zip /var/lib/netwitness/common/update-stage/

    Note: NetWitness Platform unzips the file automatically.

  4. Copy netwitness-11.7.3.0.zip, netwitness-11.7.2.0.zip, and netwitness-11.7.1.0.zip (if upgrading from 11.7.0.0, 11.7.0.1, or 11.7.0.2) from the local directory to the /var/lib/netwitness/common/update-stage/ staging folder.
    For example:

    If you are logged as a root user you can run the following command without sudo:

    cp /tmp/netwitness-11.7.3.0.zip /var/lib/netwitness/common/update-stage/

    Note: NetWitness Platform unzips the file automatically.

  5. Copy netwitness-11.7.2.0.zip and netwitness-11.7.3.0.zip (if upgrading from 11.7.1.0, 11.7.1.1, or 11.7.1.2) from the local directory to the /var/lib/netwitness/common/update-stage/ staging folder.
    For example:

    If you are logged as a root user you can run the following command without sudo:

    cp /tmp/netwitness-11.7.3.0.zip /var/lib/netwitness/common/update-stage/

    Note: NetWitness Platform unzips the file automatically.

  6. Copy netwitness-11.7.3.0.zip (if upgrading from 11.7.2.0) from the local directory to the /var/lib/netwitness/common/update-stage/ staging folder.
    For example:
    If you are logged as a root user you can run the following command without sudo:
    cp /tmp/netwitness-11.7.3.0.zip /var/lib/netwitness/common/update-stage/

    Note: NetWitness Platform unzips the file automatically.

Task 2. Apply Upgrades from the Staging Area to Each Host

Caution: You must upgrade the NW Server host before upgrading any non-NW Server host.

Note: Optionally, you can follow the instructions provided in the Option 4 (Optional): Pre-Stage Upgrade Repository by Downloading Packages if you are upgrading from 11.7.1.0, 11.7.1.1, 11.7.1.2, and 11.7.2.0 to 11.7.3.0.

  1. Log in to NetWitness.
  2. Go to AdminIcon_25x22.png(Admin) > Hosts.

  3. Check for updates and wait for the upgrade packages to be copied, validated, and ready to be initialized.

    Offline-UI-Update1.png

    "Ready to initialize packages" is displayed if:

    • NetWitness Platform can access the upgrade package.
    • The package is complete and has no errors.

    Refer to Troubleshooting Version Installations and Updates for instructions on how to troubleshoot errors (for example, "Error deploying version <version-number>" and "Missing the following update package(s)," are displayed in the Initiate Update Package for RSA NetWitness Platform dialog.)

  4. Click Initialize Update.

    It takes some time to initialize the packages because the files are large and need to be unzipped. The time varies depending on how the host is configured.
    After the initialization is successful, the Status column displays Update Available and you complete the rest of the steps in this procedure to finish the upgrade of the host.

  5. Click Update > Update Hosts from the toolbar.

    update_host_12.0_upgrade_guide.PNG

  1. Click Begin Update from the Update Available dialog.
    After the host is upgraded, it prompts you to reboot the host.
  2. Click Reboot Host from the toolbar.

Option 3: Upgrade NetWitness Platform XDR using CLI (Offline)

You can use this method if the NW Server host is not connected to Live Services.

Prerequisites

Make sure that you have downloaded the following file from NetWitness Community (https://community.netwitness.com/) > Products > NetWitness Platform > Downloads to a local directory:

  • If you are upgrading from 11.5.3.2, 11.5.3.3, or 11.6.x.x to 11.7.3.0, download:
    netwitness-11.7.0.0.zip
    netwitness-11.7.1.0.zip

    netwitness-11.7.2.0.zip

    netwitness-11.7.3.0.zip

  • If you are upgrading from 11.7.0.0, 11.7.0.1, or 11.7.0.2 to 11.7.3.0, download:
    netwitness-11.7.1.0.zip

    netwitness-11.7.2.0.zip

    netwitness-11.7.3.0.zip

  • If you are upgrading from 11.7.1.0, 11.7.1.1, or 11.7.1.2 to 11.7.3.0, download:

    netwitness-11.7.2.0.zip

    netwitness-11.7.3.0.zip

  • If you are upgrading from 11.7.2.0 to 11.7.3.0, download:

    netwitness-11.7.3.0.zip

  • If you are using external repository, you can update the external repository with the latest upgrade content. For more information, see External Repo Instructions for CLI upgrade.

Procedure

You must perform the upgrade steps for NW Server hosts and for component servers.

Note: If you copy and paste the commands from PDF to Linux SSH terminal, the characters do not work. However, you can copy the commands from the HTML page https://community.netwitness.com/t5/netwitness-platform-online/upgrade-tasks-for-12-1-1/ta-p/695018#Option3 and paste them to Linux SSH terminal.

  1. Stage the 11.7.3.0 files to prepare them for the upgrade.

    •  If you are upgrading from 11.5.3.2, 11.5.3.3, or 11.6.x.x, you must stage 11.7.0.0, 11.7.1.0, 11.7.2.0, and 11.7.3.0. Log into the NW Server as root and create the following directories:
      /var/netwitness/tmp/upgrade/11.7.0.0
      /var/netwitness/tmp/upgrade/11.7.1.0

      /var/netwitness/tmp/upgrade/11.7.2.0

      /var/netwitness/tmp/upgrade/11.7.3.0
      and then copy the package zip files to the /var/netwitness/tmp/ directory of the NW Server and extract the package files from /var/netwitness/tmp/ to the appropriate directories using the following commands:
      unzip netwitness-11.7.0.0.zip -d /var/netwitness/tmp/upgrade/11.7.0.0
      unzip netwitness-11.7.1.0.zip -d /var/netwitness/tmp/upgrade/11.7.1.0

      unzip netwitness-11.7.2.0.zip -d /var/netwitness/tmp/upgrade/11.7.2.0

      unzip netwitness-11.7.3.0.zip -d /var/netwitness/tmp/upgrade/11.7.3.0

    • If you are upgrading from 11.7.0.0, 11.7.0.1, or 11.7.0.2, you must stage 11.7.1.0, 11.7.2.0, and 11.7.3.0. Log into the NW Server as root and create the following directory:

      • Option 1 (Manual) : Log into the NetWitness Server and create the following directories:
        /var/netwitness/tmp/upgrade/11.7.1.0

        /var/netwitness/tmp/upgrade/11.7.2.0

        /var/netwitness/tmp/upgrade/11.7.3.0
        and then copy the package zip file to the /var/netwitness/tmp/ directory of the NW Server and extract the package files from /var/netwitness/tmp/ to the appropriate directory using the following commands:
        unzip netwitness-11.7.1.0.zip -d /var/netwitness/tmp/upgrade/11.7.1.0

        unzip netwitness-11.7.2.0.zip -d /var/netwitness/tmp/upgrade/11.7.2.0

        unzip netwitness-11.7.3.0.zip -d /var/netwitness/tmp/upgrade/11.7.3.0

        Make sure you remove the update zip file from the staging directory after it is extracted.

      • Option 2 (Automated) : Log into the NetWitness Server and create the following directory:
        /var/netwitness/tmp/upgrade
        and then copy the NetWitness 11.7.1.0, 11.7.2.0, and 11.7.3.0 package zip files to the /var/netwitness/tmp/ directory on the NetWitness Server.
        After this, run the below command to extract, validate, and initialize the 11.7.3.0 zip files:
        [root@SA ~]# upgrade-cli-client --init --stage-dir /var/netwitness
        /tmp/upgrade --download-path /var/netwitness/tmp/ --version 11.7.3.0
        Once the message (INFO) Download and extraction of all the necessary NetWitness zips are completed is displayed in the console of the admin server, only then the initialization process will begin.

    Note: If you do not receive the message (INFO) Download and extraction of all the necessary NetWitness zips are completed, run the previous command again.

    IMPORTANT: After staging 11.7.3.0 (using the Option 2), if the initialization fails, run the command upgrade-cli-client --init --version 11.7.3.0 --stage-dir /var/netwitness/tmp/upgrade. If the initialization succeeds, ignore the step 2 Initialize the upgrade below and proceed with the further steps 3-6.

    • If you are upgrading from 11.7.1.0, 11.7.1.1, or 11.7.1.2, you need to stage 11.7.2.0 and 11.7.3.0. Log into the NW Server as root and create the following directory:

      • Option 1 (Manual) : Log into the NetWitness Server and create the following directories:

        /var/netwitness/tmp/upgrade/11.7.2.0

        /var/netwitness/tmp/upgrade/11.7.3.0
        and then copy the package zip file to the /var/netwitness/tmp/ directory of the NW Server and extract the package files from /var/netwitness/tmp/ to the appropriate directory using the following commands:

        unzip netwitness-11.7.2.0.zip -d /var/netwitness/tmp/upgrade/11.7.2.0

        unzip netwitness-11.7.3.0.zip -d /var/netwitness/tmp/upgrade/11.7.3.0
        Make sure you remove the update zip file from the staging directory after it is extracted.

      • Option 2 (Automated) : Log into the NetWitness Server and create the following directory:
        /var/netwitness/tmp/upgrade
        and then copy the NetWitness 11.7.2.0 and 11.7.3.0 package zip files to the /var/netwitness/tmp/ directory on the NetWitness Server.
        After this, run the below command to extract, validate, and initialize the 11.7.3.0 zip files:
        [root@SA ~]# upgrade-cli-client --init --stage-dir /var/netwitness
        /tmp/upgrade --download-path /var/netwitness/tmp/ --version 11.7.3.0
        Once the message (INFO) Download and extraction of all the necessary NetWitness zips are completed is displayed in the console of the admin server, only then the initialization process will begin.

      Note: If you do not receive the message (INFO) Download and extraction of all the necessary NetWitness zips are completed, run the previous command again.

      IMPORTANT: After staging 11.7.3.0 (using the Option 2), if the initialization fails, run the command upgrade-cli-client --init --version 11.7.3.0 --stage-dir /var/netwitness/tmp/upgrade. If the initialization succeeds, ignore the step 2 Initialize the upgrade below and proceed with the further steps 3-6.

    • If you are upgrading from 11.7.2.0, you only need to stage 11.7.3.0. Log into the NW Server as root and create the following directory:

      • Option 1 (Manual) : Log into the NetWitness Server and create the following directory:

        /var/netwitness/tmp/upgrade/11.7.3.0
        and then copy the package zip file to the /var/netwitness/tmp/ directory of the NW Server and extract the package files from /var/netwitness/tmp/ to the appropriate directory using the following command:

        unzip netwitness-11.7.3.0.zip -d /var/netwitness/tmp/upgrade/11.7.3.0
        Make sure you remove the update zip file from the staging directory after it is extracted.

      • Option 2 (Automated) : Log into the NetWitness Server and create the following directory:
        /var/netwitness/tmp/upgrade
        and then copy the NetWitness 11.7.3.0 package zip files to the /var/netwitness/tmp/ directory on the NetWitness Server.
        After this, run the below command to extract, validate, and initialize the 11.7.3.0 zip files:
        [root@SA ~]# upgrade-cli-client --init --stage-dir /var/netwitness
        /tmp/upgrade --download-path /var/netwitness/tmp/ --version 11.7.3.0
        Once the message (INFO) Download and extraction of all the necessary NetWitness zips are completed is displayed in the console of the admin server, only then the initialization process will begin.

      Note: If you do not receive the message (INFO) Download and extraction of all the necessary NetWitness zips are completed, run the previous command again.

      IMPORTANT: After staging 11.7.3.0 (using the Option 2), if the initialization fails, run the command upgrade-cli-client --init --version 11.7.3.0 --stage-dir /var/netwitness/tmp/upgrade. If the initialization succeeds, ignore the step 2 Initialize the upgrade below and proceed with the further steps 3-6.

  2. Initialize the upgrade using the following command:
    upgrade-cli-client --init --version 11.7.3.0 --stage-dir /var/netwitness/tmp/upgrade

  1. Upgrade the NW Server host, using the following command:
    upgrade-cli-client --upgrade --version 11.7.3.0 --host-key <ID / display name / (hostname/ IP address)>
  2. When the NW Server host upgrade is successful, reboot the host from NetWitness Platform user interface in the Hosts view.
  3. (Conditional) If Warm Standby Server is deployed, repeat steps 1 to 4 on the Warm Standby Server host.
  4. Repeat steps 3 and 4 for each component host, changing the IP address to the component host which is being upgraded.

Note: You can check versions of all the hosts, using the command upgrade-cli-client --list on the NW Server host. If you want to view the help content of upgrade-cli-client, use the command upgrade-cli-client --help.

Note: If the following error is displayed during the upgrade process:
2017-11-02 20:13:26.580 ERROR 7994 — [ 127.0.0.1:5671] o.s.a.r.c.CachingConnectionFactory : Channel shutdown: connection error; protocol method: #method<connection.close>(reply-code=320, reply-text=CONNECTION_FORCED - broker forced connection closure with reason 'shutdown', class-id=0, method-id=0)
the service pack will install correctly. No action is required. If you encounter additional errors when updating a host to a new version, contact Customer Support for assistance.

External Repo Instructions for CLI upgrade

For information about setting up an external repository, see "Appendix B. Set Up External Repo" in the 11.7Upgrade Guide for NetWitness Platform XDR. The following instructions assume that you already have an external repository set up. Go to the NetWitness All Versions Documents page and find NetWitness Platform guides to troubleshoot issues.

  1. Stage the 11.7.3.0 files to prepare them for the upgrade.

    •  If you are upgrading from 11.5.3.2, 11.5.3.3, or 11.6.x.x, you must stage 11.7.0.0, 11.7.1.0, 11.7.2.0, and 11.7.3.0. Log into the NW Server as root and create the following directories:
      /var/netwitness/tmp/upgrade/11.7.0.0
      /var/netwitness/tmp/upgrade/11.7.1.0

      /var/netwitness/tmp/upgrade/11.7.2.0

      /var/netwitness/tmp/upgrade/11.7.3.0
      and then copy the package zip files to the /var/netwitness/tmp/ directory of the NW Server and extract the package files from /var/netwitness/tmp/ to the appropriate directories using the following commands:
      unzip netwitness-11.7.0.0.zip -d /var/netwitness/tmp/upgrade/11.7.0.0
      unzip netwitness-11.7.1.0.zip -d /var/netwitness/tmp/upgrade/11.7.1.0

      unzip netwitness-11.7.2.0.zip -d /var/netwitness/tmp/upgrade/11.7.2.0

      unzip netwitness-11.7.3.0.zip -d /var/netwitness/tmp/upgrade/11.7.3.0

    • If you are upgrading from 11.7.0.0, 11.7.0.1, or 11.7.0.2, you must stage 11.7.1.0, 11.7.2.0, and 11.7.3.0. Log into the NW Server as root and create the following directory:

      • Option 1 (Manual) : Log into the NetWitness Server and create the following directories:
        /var/netwitness/tmp/upgrade/11.7.1.0

        /var/netwitness/tmp/upgrade/11.7.2.0

        /var/netwitness/tmp/upgrade/11.7.3.0
        and then copy the package zip file to the /var/netwitness/tmp/ directory of the NW Server and extract the package files from /var/netwitness/tmp/ to the appropriate directory using the following commands:
        unzip netwitness-11.7.1.0.zip -d /var/netwitness/tmp/upgrade/11.7.1.0

        unzip netwitness-11.7.2.0.zip -d /var/netwitness/tmp/upgrade/11.7.2.0

        unzip netwitness-11.7.3.0.zip -d /var/netwitness/tmp/upgrade/11.7.3.0

        Make sure you remove the update zip file from the staging directory after it is extracted.

      • Option 2 (Automated) : Log into the NetWitness Server and create the following directory:
        /var/netwitness/tmp/upgrade
        and then copy the NetWitness 11.7.1.0, 11.7.2.0, and 11.7.3.0 package zip files to the /var/netwitness/tmp/ directory on the NetWitness Server.
        After this, run the below command to extract, validate, and initialize the 11.7.3.0 zip files:
        [root@SA ~]# upgrade-cli-client --init --stage-dir /var/netwitness
        /tmp/upgrade --download-path /var/netwitness/tmp/ --version 11.7.3.0
        Once the message (INFO) Download and extraction of all the necessary NetWitness zips are completed is displayed in the console of the admin server, only then the initialization process will begin.

    Note: If you do not receive the message (INFO) Download and extraction of all the necessary NetWitness zips are completed, run the previous command again.

    IMPORTANT: After staging 11.7.3.0 (using the Option 2), if the initialization fails, run the command upgrade-cli-client --init --version 11.7.3.0 --stage-dir /var/netwitness/tmp/upgrade. If the initialization succeeds, ignore the step 2 Initialize the upgrade below and proceed with the further steps 3-6.

    • If you are upgrading from 11.7.1.0, 11.7.1.1, or 11.7.1.2, you need to stage 11.7.2.0 and 11.7.3.0. Log into the NW Server as root and create the following directory:

      • Option 1 (Manual) : Log into the NetWitness Server and create the following directories:

        /var/netwitness/tmp/upgrade/11.7.2.0

        /var/netwitness/tmp/upgrade/11.7.3.0
        and then copy the package zip file to the /var/netwitness/tmp/ directory of the NW Server and extract the package files from /var/netwitness/tmp/ to the appropriate directory using the following commands:

        unzip netwitness-11.7.2.0.zip -d /var/netwitness/tmp/upgrade/11.7.2.0

        unzip netwitness-11.7.3.0.zip -d /var/netwitness/tmp/upgrade/11.7.3.0
        Make sure you remove the update zip file from the staging directory after it is extracted.

      • Option 2 (Automated) : Log into the NetWitness Server and create the following directory:
        /var/netwitness/tmp/upgrade
        and then copy the NetWitness 11.7.2.0 and 11.7.3.0 package zip files to the /var/netwitness/tmp/ directory on the NetWitness Server.
        After this, run the below command to extract, validate, and initialize the 11.7.3.0 zip files:
        [root@SA ~]# upgrade-cli-client --init --stage-dir /var/netwitness
        /tmp/upgrade --download-path /var/netwitness/tmp/ --version 11.7.3.0
        Once the message (INFO) Download and extraction of all the necessary NetWitness zips are completed is displayed in the console of the admin server, only then the initialization process will begin.

      Note: If you do not receive the message (INFO) Download and extraction of all the necessary NetWitness zips are completed, run the previous command again.

      IMPORTANT: After staging 11.7.3.0 (using the Option 2), if the initialization fails, run the command upgrade-cli-client --init --version 11.7.3.0 --stage-dir /var/netwitness/tmp/upgrade. If the initialization succeeds, ignore the step 2 Initialize the upgrade below and proceed with the further steps 3-6.

    • If you are upgrading from 11.7.2.0, you only need to stage 11.7.3.0. Log into the NW Server as root and create the following directory:

      • Option 1 (Manual) : Log into the NetWitness Server and create the following directory:

        /var/netwitness/tmp/upgrade/11.7.3.0
        and then copy the package zip file to the /var/netwitness/tmp/ directory of the NW Server and extract the package files from /var/netwitness/tmp/ to the appropriate directory using the following command:

        unzip netwitness-11.7.3.0.zip -d /var/netwitness/tmp/upgrade/11.7.3.0
        Make sure you remove the update zip file from the staging directory after it is extracted.

      • Option 2 (Automated) : Log into the NetWitness Server and create the following directory:
        /var/netwitness/tmp/upgrade
        and then copy the NetWitness 11.7.3.0 package zip files to the /var/netwitness/tmp/ directory on the NetWitness Server.
        After this, run the below command to extract, validate, and initialize the 11.7.3.0 zip files:
        [root@SA ~]# upgrade-cli-client --init --stage-dir /var/netwitness
        /tmp/upgrade --download-path /var/netwitness/tmp/ --version 11.7.3.0
        Once the message (INFO) Download and extraction of all the necessary NetWitness zips are completed is displayed in the console of the admin server, only then the initialization process will begin.

      Note: If you do not receive the message (INFO) Download and extraction of all the necessary NetWitness zips are completed, run the previous command again.

      IMPORTANT: After staging 11.7.3.0 (using the Option 2), if the initialization fails, run the command upgrade-cli-client --init --version 11.7.3.0 --stage-dir /var/netwitness/tmp/upgrade. If the initialization succeeds, ignore the step 2 Initialize the upgrade below and proceed with the further steps 3-6.

  2. Initialize the upgrade using the following command:
    upgrade-cli-client --init --version 11.7.3.0 --stage-dir /var/netwitness/tmp/upgrade

  1. Upgrade the NW Server host, using the following command:
    upgrade-cli-client --upgrade --version 11.7.3.0 --host-key <ID / display name / (hostname/ IP address)>

  1. When the NW Server host upgrade is successful, reboot the host from NetWitness Platform user interface in the Hosts view.
  2. (Conditional) If Warm Standby Server is deployed, repeat steps 1 to 4 on the Warm Standby Server host.
  3. Repeat steps 3 and 4 for each component host, changing the IP address to the component host which is being upgraded.

Note: You can check versions of all the hosts, using the command upgrade-cli-client --list on the NW Server host. If you want to view the help content of upgrade-cli-client, use the command upgrade-cli-client --help.

Note: If the following error displays during the upgrade process:
2017-11-02 20:13:26.580 ERROR 7994 — [ 127.0.0.1:5671] o.s.a.r.c.CachingConnectionFactory : Channel shutdown: connection error; protocol method: #method<connection.close>(reply-code=320, reply-text=CONNECTION_FORCED - broker forced connection closure with reason 'shutdown', class-id=0, method-id=0)
the service pack will install correctly. No action is required. If you encounter additional errors when updating a host to a new version, contact Customer Support for assistance.

Option 4 (Optional): Pre-Stage Upgrade Repository by Downloading Packages

You can pre-stage the upgrade repository by downloading the required packages (.zip) without affecting the system. This minimizes the upgrade downtime and ensures the upgrade is completed within the planned time.

Procedure

  1. Go to AdminIcon_25x22.png(Admin) > Hosts.

  2. Click Update > Check for Updates from the toolbar.

    All possible update versions will be displayed in the Versions drop-down list.

  3. Click Update > Pre Stage Host and select the version in the update version column.

    A confirmation message for downloading the files is displayed.

    11.7.3_upgrade_host_pre_stage.PNG

    confirmation_message_update_pre_stage_host_12.0.PNG

  4. Click Yes to download the upgrade packages to the repo.

  5. Verify the status of the download in the notifications tray as shown below.

    The Pre Stage Host and Upgrade Host will be disabled until pre stage is completed.

    notifications_tray_pre_stage_host_11.7.3.PNG

    Note: The current version and the update version in the UI will be the same during the pre stage as it is not the actual update. This is because only the repo files are downloaded and no actual upgrade is done. The version will change only after upgrade.

  6. If the download is successful, Check for Updates again to start the initialization.

  7. Click Initialize Update.

    The initialization of the package will take some time as the files are large and will need to be unzipped.

    initialize_update_11.7.3.PNG

    IMPORTANT: Pre Stage Repo preparation steps from 1 to 4 can be performed at any time. However, from steps 5 to 8 the upgrade process begins and you must NOT reboot the host or restart the jetty server during this time as it will corrupt the .ZIP files.

  8. Check the status of initialization in the notifications tray.

  9. After the initialization is completed successfully, click Update > Update Host.

    After the host is updated, you will be prompted to reboot the host.

  10. Set up the host and reboot the host.