Validate

Proceed only if...

  • You have completed the set up your target machine.

Otherwise, go back.

In this step you will:

  • Validate your target platform to make sure it's ready for installing TOS Aurora.

Run Validation Checks

  1. Transfer the TOS Aurora run file, downloaded previously, to your target server.

  2. Run the screen command:

    [<ADMIN> ~]$ sudo tmux new-session -S validate
    sudo tmux new-session -S validate
  3. Deploy the TOS Aurora CLI, by executing the run file <RUNFILE>.run that was downloaded and extracted in Prepare.

    [<ADMIN> ~]$ sudo sh <RUNFILE>.run 
    sudo sh <RUNFILE>.run
  4. Check that a DNS has been configured

    [<ADMIN> ~]$ sudo cat /etc/resolv.conf
    sudo cat /etc/resolv.conf
  5. Check that the hostname is valid.

    [<ADMIN> ~]$ sudo hostnamectl | grep 'hostname'
    sudo hostnamectl | grep 'hostname'
  6. Check that there is enough free space.

    [<ADMIN> ~]$ sudo df -h
    sudo df -h

    Must be no less than

    • /var/ 200GB

    • /tmp/ 25GB

    • /opt/ 200 GB

  7. Check that the TOS Aurora CLI is correctly installed.

    [<ADMIN> ~]$ sudo tos --help 
    sudo tos --help

    If help output is listed, the TOS CLI is installed OK.

  8. Check that your drive meets the 250MB/s throughput minimum requirement.

    1. Run the following command four times, noting the result each time.

      [<ADMIN> ~]$ sudo dd if=/dev/zero of=/opt/testfile bs=12k count=1024 conv=fdatasync
      sudo dd if=/dev/zero of=/opt/testfile bs=12k count=1024 conv=fdatasync
    2. Run the following command four times, noting the result each time.

      [<ADMIN> ~]$ sudo dd if=/dev/zero of=/opt/testfile bs=100k count=1024 conv=fdatasync
      sudo dd if=/dev/zero of=/opt/testfile bs=100k count=1024 conv=fdatasync
    3. Run the following command four times, noting the result each time.

      [<ADMIN> ~]$ sudo dd if=/dev/zero of=/opt/testfile bs=500k count=1024 conv=fdatasync
      sudo dd if=/dev/zero of=/opt/testfile bs=500k count=1024 conv=fdatasync
    4. Calculate the average of all 12 results from the above checks. If the calculated value is 250MB/s or higher, you can proceed, otherwise, you must repeat the setup step with disks that meet the minimum performance.

  9. Run the tmux command:

    [<ADMIN> ~]$ sudo tmux -S dry-run
    sudo tmux -S dry-run
  10. Perform a dry run of the install, to verify the procedure in advance by going through all the stages without installing anything.

    You will populate the tos install command with the information you have chosen for the VIP, modules, load-model, and services-network.

    This will not install TOS Aurora, but check that all of the prerequisites have been met.

    If you have not changed your physical IP address to the one you wish to use, ensure the temporary IP does not interfere with services-network and is in the same network as the primary-vip.

    Make sure you include the parameter --dry-run in the install command. Run the install command, replacing the parameters:

    • <PRIMARY> with the IP you will use to access TOS Aurora - the primary VIP for on-prem or with 'external' for cloud deployments

    • <SERVICE-CIDR> with the CIDR you want to use for the Kubernetes service network, as described in Prerequisites

      <MODULE-TYPE> with one of the following values:

      • ST for SecureTrack only

      • ST, SC for both SecureTrack and SecureChange

      • RC for a remote collector

    • <LOAD> with small, medium or large, as specified in your sizing requirements

    [<ADMIN> ~]$ sudo tos install  --migrate --modules=<MODULE-TYPE> --primary-vip=<PRIMARY> --services-network=<SERVICE-CIDR> --load-model=<LOAD> --dry-run -d
    sudo tos install --migrate --modules=<MODULE-TYPE> --primary-vip=<PRIMARY> --services-network=<SERVICE-CIDR> --load-model=<LOAD> --dry-run -d

    Where

    • --dry-run: Optional parameter to verify the procedure in advance by going through all the stages without installing anything.

    • -d: Creates a debug log. We recommend including this debug flag when running tos install.

    Examples:

    [<ADMIN> ~]$ sudo tos install  --migrate --modules=ST,SC --primary-vip=external --services-network=10.10.10.0/24 --load-model=medium --dry-run
    [<ADMIN> ~]$ sudo tos install  --migrate --modules=ST,SC --primary-vip=192.168.1.2 --services-network=10.10.10.0/24 --load-model=medium --dry-run
    [<ADMIN> ~]$ sudo tos install  --migrate --modules=RC --primary-vip=162.148.10.0 --services-network=10.10.10.0/24 --load-model=large --dry-run													

Can I Proceed?

Continue to the next step only if...

  1. The dry run completed successfully.