Appendix B. Silent Installation Using CLI

You can use the following Command Line Interface commands to run the installation script (nwsetup-tui) without getting prompted for inputs. This enables you to automate the installation of a host by supplying response to the scripts prompts through the command line.

  1. After you have created a base image on the host, log in to the host with the root credentials.

  2. Submit the nwsetup-tui script with the --silent command and the arguments that you want to apply.

    The following command string is an example of how you would install a basic NW Server host.

    nwsetup-tui --silent --is-head=true --host-name=new-host --master-pass=netwitness --deploy-pass=netwitness --repo-type=1 --custom-firewall=false --ip-override=false --eula=true

Note: 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. (Conditional - For Component Hosts Only) Install the appropriate service Category on the newly provisioned host in the NetWitness Platform Hosts view.

    1. Log into NetWitness and go to netwitness_adminicon_25x22.png (Admin) > 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 (for example, Event Stream Analysis) and click netwitness_ic-install.png.

      The Install Services dialog is displayed.

    4. Select the appropriate host type in Category and click Install.

Arguments

Argument Description

‑‑help‑install‑opts

Display all the arguments in this table.

--eula

Accept or decline the End User License Agreement (EULA). Specify:

  • true (default) to accept the agreement
  • false to decline it and cancel the installation.

For example: --eula=true
--is-head

Designate the host as the NW Server host or a component host. Specify:

  • true for NW Server host.
  • false for Component host.

For example: --is-head=true
--host-name

Specify new hostname. If you do not specify this argument, NetWitness Platform retains the existing hostname.

For example: --host-name=<hostname>

--master-pass

Enter master password. For example:
--master-pass=<password>

--deploy-pass

Enter deployment password. For example:
--deploy-pass=<password>

--iface-name

Specify network interface.

For example: --iface-name=eth0

--ip-override

Accept or override IP address found for this host or change the IP configuration found on the host. Specify:

  • true provide IP address.
  • false use IP address found on the host.

For example: --ip-override=false

--ip-type

Select ip address configuration type. Specify:

  • 1 Static IP Configuration)
  • 2 DCHP

For example: --ip-type=1

--ip-addr

For Static IP configuration, enter IP Address for static address.

For example: --ip-addr=<ip-address>

--ip-netmask

For Static IP configuration, enter Subnet Mask for static address. For example:
--ip-gateway=<subnet-mask>

--ip-gateway

For Static IP configuration, enter default gateway for static address. For example:
--ip-gateway=<default-gateway>

--ip-nameserver

IP address assigned to DNS server.
--ip-nameserver=<ip-address>

‑‑ip‑nameserver‑secondary

Optional - IP address assigned to a secondary DNS server.
For example: --ip-nameserver-secondary=<ip-address>

--ip-domain

For Static IP configuration, enter Local Domain Name for static address. For example:
--ip-domain=<default-gateway>

--repo-type

Select type of update repository. Specify:

  • 1 Local repository
  • 2 External repository

For example: --repo-type=1

--repo-url

For an external update repository, specify the url of the repository. For example:
--repo-url=<url>

--head-ip

For a component host, specify IP Address of the NW Server.

For example: --head-ip=<ip-address>
--custom-firewall

Disable default firewall configuration and use your custom configuration. Specify:

  • true use custom firewall configuration.
  • false use default firewall configuration.

For example: --custom-firewall=true

--use-nat

Configure the host to use Network Address Translation (NAT) based IP addresses:

  • true use NAT IPs to connect to other hosts
  • false do not use NAT IPs to connect to other hosts (default)

For example: --use-nat=false