Step 3. Install NetWitness Platform

Complete the steps below to install NetWitness 12.1.

Note: Before installing the 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.
- Run the following commands on each hosts:
1. SSH to NW host.
2. Run the following commands.
systemctl stop ntpd
ntpdate nw-node-zero
systemctl start ndpd

This task installs:

  • The NW Server environmental platform.
  • The NW Server components (that is, Admin Server, Config Server, Orchestration Server, Integration Server, Broker, Investigate Server, Reporting Engine, Respond Server and Security server).
  • A repository with the RPM files required to install the other functional components or services.


Deploy your environment:

  1. Add new VM.
  2. Configure storage.
  3. Set up firewalls.

Install NetWitness Platform

Caution: If you want to install the Endpoint Relay Server, do not run the nwsetup-tui script. Follow the instructions in "(Optional) Installing and Configuring Relay Server" in the NetWitness Endpoint Configuration Guide.

IMPORTANT: In NetWitness Platform version 11.6 or Later, deployment account password 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 on the Warm Standby Server if it exists.

  1. Log in to the host with the root credentials and run the nwsetup-tui command to set up the host.

    This initiates the nwsetup-tui (Setup program) and the EULA is displayed.

    Note: Use the following options to navigate the Setup prompts.
    1.) When you navigate through the Setup program prompts, use the down and up arrows to move among fields, and use the Tab key to move to and from commands (such as <Yes>, <No>, <OK>, and <Cancel>). Press Enter to register your command response and move to the next prompt.
    2.) The Setup program adopts the color scheme of the desktop or console you use to access the host.
    3.) If you specify DNS servers during the Setup program (nwsetup-tui) execution, they MUST be valid (valid in this context means valid during setup) and accessible for the nwsetup-tui script to proceed. Any misconfigured DNS servers cause the Setup program to fail. If you need to reach a DNS server after setup that is unreachable during setup, (for example, to relocate a host after setup that would have a different set of DNS Servers), see "Change Host Network Configuration" topic in the System Maintenance Guide.
    If you do not specify DNS Servers during setup (nwsetup-tui), you must select 1 The Local Repo (on the NW Server) in the NetWitness Update Repository prompt in step 12 (the DNS servers are not defined so the system cannot access the external repo).


  2. Tab to Accept and press Enter.
    The Is this the host you want for your 12.1 NW Server prompt is displayed.
  3. Tab to Yes and press Enter to install 12.1 on the NW Server.
    Tab to No and press Enter to install 12.1 on other component hosts.

    Caution: If you choose the wrong host for the NW Server and complete the Setup, you must restart the Setup Program (step 2) and complete steps all the subsequent steps to correct this error.

  4. The Install prompt is displayed (Recover does not apply to the installation.).

    NW Server Host prompt:
    Other Component Hosts, the prompt is the same, but does not include option 3 Install (Warm/Standby)

  5. Press Enter. Install (Fresh Install) is selected by default.
    The System Host Name prompt is displayed.
    NW Server prompt:

    Other Component Hosts prompt says <non-nwserver-host-name>

    Caution: If you include "." in a host name, the host name must also include a valid domain name.

    Press Enter if want to keep this name. If not, edit the host name, tab to OK, and press Enter to change it.
  6. This step applies only to NW Server hosts.
    The Master Password prompt is displayed.
    The following list of characters are supported for Master Password and Deployment Password:
    • Symbols: ! @ # % ^ +
    • Numbers: 0-9
    • Lowercase Characters: a-z
    • Uppercase Characters: A-Z

    No ambiguous characters are supported for Master Password and Deployment Password. For example:
    space { } [ ] ( ) / \ ' " ` ~ ; : .< > -

    Type the Password, down arrow to Verify, retype the password, tab to OK, and press Enter.

  7. This step applies to both NW Server hosts and component hosts.
    The Deployment Password prompt is displayed.
    Type the Password, down arrow to Verify, retype the password, tab to OK, and press Enter.
  8. One of the following conditional prompts is displayed.
    • If the Setup program finds a valid IP address for this host, the following prompt is displayed.
      Press Enter if you want to use this IP and avoid changing your network settings. Tab to Yes and press Enter if you want to change the IP configuration on the host.
    • If you are using an SSH connection, the following warning is displayed.

      Note: If you connect directly from the host console, the following warning is not displayed.

      Press Enter to close warning prompt.

    • If the Setup Program finds an IP configuration and you choose to use it, the Update Repository prompt is displayed. Go to step 12 and complete the installation.
    • If the Setup Program did not find an IP configuration or if you choose to change the existing IP configuration, the Network Configuration prompt is displayed.

      Caution: Only select "Use DHCP" as an IP address configuration for the NW Server if DHCP issues static IP addresses.


    Tab to OK and press Enter to use Static IP.
    If you want to use DHCP, down arrow to 2 Use DHCP and press Enter.
    The Network Configuration prompt is displayed.
  9. Down arrow to the network interface you want, tab to OK, and press Enter. If you do not want to continue, tab to Exit.
    The following Static IP Configuration prompt is displayed.
  10. Type the configuration values, tab to OK, and press Enter. If you do not complete all the required fields, an All fields are required error message is displayed (Secondary DNS Server and Local Domain Name fields are not required). If you use the wrong syntax or character length for any of the fields, an Invalid <field-name> error message is displayed.

    Caution: If you select DNS Server, make sure that the DNS Server is correct and the host can access it before proceeding with the installation.

  11. The Use Network Address Translation (NAT) prompt is displayed.
    For the NW Server, tab to No and press Enter.
    For component hosts, if this host requires the use of NAT-based addresses to communicate with the NW Server, tab to Yes. Otherwise, tab to No and press Enter.

  12. The Update Repository prompt is displayed.

    For the NW Server:

    • Press Enter to choose the Local Repo.
    • If you want to use an external repo, down arrow to External Repo, tab to OK, and press Enter. If you select 1 The Local Repo (on the NW Server) in the Setup program, make sure that you have the appropriate media attached to the host (media that contains the ISO file, for example a build stick) from which it can install NetWitness 12.1. If the program cannot find the attached media, you receive the following prompt.
    • If you select 2 An External Repo (on an externally-managed server), the UI prompts you for a URL. The repositories give you access to NetWitness updates and CentOS updates. Refer to "Appendix B. Create an External Repo" in this guide for instructions on how to create this repo and its external repo URL so you can enter it in the following prompt.
      Enter the base URL of the NetWitness external repo and click OK. The Start Install prompt is displayed.

    For component hosts:

    • Select the same repo that you selected when you installed the NW Server host and follow the steps above.
    • The NW Server IP Address prompt is displayed.
      Type the NW Server IP address. Tab to OK and press Enter.
  13. The Disable firewall prompt is displayed.
    Tab to No (default), and press Enter to use the standard firewall configuration.
    To disable the standard firewall configuration, tab to Yes, and press Enter.
    If you select Yes, confirm your selection(select Yes again) or select No to use the standard firewall configuration.
  14. The Start Install prompt is displayed.
  15. Press Enter to install 12.1.
    When Installation complete is displayed, you have installed 12.1 on this host.

    Note: Ignore the hash code errors similar to the errors shown in the following figure that are displayed when you initiate the nwsetup-tui command. Yum does not use MD5 for any security operations so they do not affect the system security.


  16. (Optional) If your system configuration requires that a component host must use a NAT IP address to reach the NW Server host, you must configure the NAT IP address of the NW Server by running the following command:
    nw-manage --update-host --host-id <NW Server Host UUID> --ipv4-public <NAT IP address>

Set Up ESA Hosts

After you install your NW Server and component hosts, follow these steps to set up your ESA hosts.

  • Install your primary ESA host following the instructions in "Install 12.1 on the NetWitness Server (NW Server) Host and Other Component Hosts" in this guide, and install the ESA Primary service on it after you finish the Set Up program in the UI in netwitness_adminicon_25x22.png (Admin) > Hosts > netwitness_ic-install.png:
  • (Conditional) If you have a secondary ESA host, install it and install the ESA Secondary service on it after you finish the Set Up program in the UI in netwitness_adminicon_25x22.png (Admin) > Hosts > netwitness_ic-install.png:

Install Component Services on Hosts

After you have installed NW Server and component hosts, and set up your ESA hosts, follow these steps to install component services, such as Decoders and Concentrators, on your host systems.

  1. Install a component service on the host.
    1. Log into NetWitness and go to (missing or bad snippet)> Hosts.
      The New Hosts dialog is displayed with the Hosts view grayed out in the background.

      Note: If the New Hosts dialog is not displayed, click Discover in the Hosts view toolbar.

    2. Select the host in the New Hosts dialog and click Enable.
      The New Hosts dialog closes and the host is displayed in the Hosts view.
    3. Select that host in the Hosts view and click netwitness_ic-install.png.
      The Install Services dialog is displayed.
    4. Select the appropriate host type (for example, Concentrator) in Category and click Install.

Complete Licensing Requirements

Complete licensing requirements for installed services. See the NetWitness Platform 12.1 Licensing Management Guide for more information. Go to the NetWitness All Versions Documents page and find NetWitness Platform guides to troubleshoot issues.

(Optional) Install Warm Standby NW Server

Refer to "Warm Standby NW Server Host" under "Deployment Option Setup Procedures" in the Deployment Guide for NetWitness Platform 12.1 for instructions on how to set up a Warm Standby NW Server.