Upgrade TufinOS 3 to 4: New, VMWare ESXi, Central/Remote Cluster, TOS Reinstall

Overview

This procedure is for upgrading TufinOS 3 to 4 on new VMWare ESXi machines. This requires upgrading first the worker nodes and then the data node.

If you have both central and remote clusters, upgrade the central cluster first.

During the TufinOS upgrade there will be some downtime. TOS will need to be reinstalled

Is This The Right Procedure?

This procedure is ONLY for:

• TOS R24-2

• Single data node central clusters or remote clusters

• Upgrades on new VMWare ESXi machines

If your TOS release is not R24-2, go to the Knowledge Center that matches your TOS version. If other requirements are not met, select a different procedure.

Prerequisites

General Requirements

• This procedure must be performed by an experienced Linux administrator with knowledge of network configuration.

• To ensure optimal performance and reliability, the required resources need to always be available for TOS. If resources become unavailable, this will affect TOS performance. Do not oversubscribe resources.

• Verify that you have sufficient resources (CPUs, disk storage and main memory) to run TOS Aurora. The required resources are determined by the size of your system. See Sizing Calculation for a Clean Install.

• You cannot use IP Tables with TOS Aurora. In addition, all IP Tables rules will be flushed when installing.

• If you have made a previous unsuccessful attempt to install TOS Aurora, you must uninstall and reboot before reinstalling (see Uninstalling TOS)

• The TOS installation removes all TOS files, directories and backups left on the machine from old deployments. If you have any files you want to keep, move them to a safe external location before starting this procedure.

• Do not install any software on your server before or after the deployment of TOS Aurora that is not specified in the current procedure.

• Once TOS Aurora has been installed, changing the host name or IP address will require reinstalling - see Changing IP Address/Host Names. If you want to change the host name of the node, do so before running the tos install command.

  If you need assistance, consult with your sales engineer or Tufin support.

• If you have any external disks (for example, etcd), disconnect them. These disks should be reconnected after the TufinOS upgrade is complete.

VMware Requirements

• Your ESX host must be running VMware ESXi 6.5, 6.7, 7.0 or 8.0 only. ESXi 8.0 requires TufinOS 4.20 or later

• Disks: Select a storage type of SSD. Take into consideration that TOS requires 7,500 IOPS and the throughput expected will average 250MB/s with bursts of up to 700MB/s.

Network Requirements

• Tufin Orchestration Suite must only be installed in an appropriately secured network and physical location. Only authorized users should be granted access to TOS products and the operating system on the server.

• You must allow access to required Ports and Services.

• All TOS nodes need to be on the same subnet.

• Network configurations for your interface must be set to manual IPv4 with gateway and DNS Servers set to the IPs used by your organization.

  The system will use a reverse DNS lookup (PTR record) to resolve the DNS IP addresses with the domain name during the TOS installation. Therefore you have to add these PTR records to the DNS server. If you do not, the TOS installation will fail.

• Allocate a 24-bit CIDR subnet for the Kubernetes service network and a16-bit CIDR subnet for the Kubernetes pods network (10.244.0.0/16 is used by default).

  The pods and services networks must be inside the following private networks: 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16. In addition, ensure that the dedicated CIDR for the service network and pods network don't overlap with each other, and:

  • The physical addresses of your TOS Aurora servers (see below)

  • Your primary VIP, Syslog VIP or external load balancer IP (see below)

  • Any other subnets communicating with TOS or with TOS nodes

• If a proxy is configured on your system make sure this network is excluded.

• You must have available the following dedicated IP addresses:

  • For on-premise deployments, a primary VIP that will serve as the external  IP address used to access TOS Aurora from your browser. The primary VIP will not be needed in the installation of the operating system, except in the final step - the installation command.
  • The physical network IP address of the first network interface used by the administrator for CLI commands. This is the IP address you will use in most steps of the procedure.

  • If additional nodes are subsequently added to the cluster, each node will require an additional dedicated physical network IP address.

  • Additional syslog VIPs can be allocated as needed.

  • The VIP, all node physical network IP addresses and all syslog VIPs must be on the first network interface.

  • Make sure your first physical interface is correctly configured and all other interfaces are not on the same network.

    To find the first network interface, run the following command:

    [<ADMIN> ~]$ sudo /opt/tufinos/scripts/network_interface_by_pci_order.sh | awk -F'=' '/NET_IFS\[0\]/ { print $NF }'

    sudo /opt/tufinos/scripts/network_interface_by_pci_order.sh | awk -F'=' '/NET_IFS\[0\]/ { print $NF }'

    Otherwise network errors such as connectivity failures and incorrect traffic routing might occur.

Downloads

1. Download the TufinOS 4.40 installation package from the Download Center.

2. Download the TOS R24-2 PHF1.1.0 installation package from the Download Center.

The downloaded files are in .tgz format <FILENAME>.tgz.

3. Extract the TufinOS image from its archive.

   [<ADMIN> ~]$ sudo tar xzvf <FILENAME>.tgz

   sudo tar xzvf <FILENAME>.tgz

   The run file name includes the release, version, build number, and type of installation.

   TufinOS ISO file example: TufinOS-4.40-4368238-x86_64-Final.iso

4. Verify the integrity of the TufinOS installation package.

   [<ADMIN> ~]# sha256sum -c TufinOS-X.XX-XXXXXX-x86_64-Final.iso.sha256

   sha256sum -c TufinOS-X.XX-XXXXXX-x86_64-Final.iso.sha256

   The output should return OK

Preliminary Preparations

1. Verify that your deployment is compatible with TufinOS 4.40.

   1. Check your current TufinOS version:

      cat /etc/tufinos-release

      Your TufinOS release appears in the output. If the command is not recognized, you have a non-TufinOS operating system and cannot upgrade using this procedure.

   2. Review the compatibility and requirements and supported upgrade paths for TufinOS 4.40 and verify that you can perform the procedure.
2. Check the cluster health.

   1. On the primary data node, check the following status.

      [<ADMIN> ~]$ sudo systemctl status k3s

      sudo systemctl status k3s

   In the output under the line k3s.service - Aurora Kubernetes, two lines should appear - Loaded... and Active... similar to the example below. If they appear, continue with the next step, otherwise contact Tufin Support for assistance.

   Example output:

   [<ADMIN> ~]$ sudo systemctl status k3s
    [root@TufinOS ~]# systemctl status k3s
    Redirecting to /bin/systemctl status k3s.service
    ● k3s.service - Aurora Kubernetes
       Loaded: loaded (/etc/systemd/system/k3s.service; enabled; vendor preset: disabled)
       Active: active (running) since Tue 2021-08-24 17:14:38 IDT; 1 day 18h ago
         Docs: https://k3s.io
      Process: 1241 ExecStartPre=/sbin/modprobe overlay (code=exited, status=0/SUCCESS)
      Process: 1226 ExecStartPre=/sbin/modprobe br_netfilter (code=exited, status=0/SUCCESS)
     Main PID: 1250 (k3s-server)
        Tasks: 1042
       Memory: 2.3G

   1. On the primary data node, check the TOS status.

      [<ADMIN> ~]$ tos status

      tos status

   2. In the output, check if the System Status is Ok and all the items listed under Components appear as Ok. If this is not the case, contact Tufin Support.

   Example output for a central cluster data node:

   [<ADMIN> ~]$ tos status         
   [Mar 28 13:42:09]  INFO Checking cluster health status           
   TOS Aurora
   Tos Version: 24.2 (PRC1.1.0)
   
   System Status: "Ok"
               
   Cluster Status:
      Status: "Ok"
      Mode: "Multi Node"
   
   Nodes
     Nodes:
     - ["node1"]
       Type: "Primary"
       Status: "Ok"
       Disk usage:
       - ["/opt"]
         Status: "Ok"
         Usage: 19%
     - ["node3"]
       Type: "Worker Node"
       Status: "Ok"
       Disk usage:
       - ["/opt"]
         Status: "Ok"
         Usage: 4%
   
   registry
     Expiration ETA: 819 days
     Status: "Ok"
   
   Infra
   Databases:
   - ["cassandra"]
     Status: "Ok"
   - ["kafka"]
     Status: "Ok"
   - ["mongodb"]
     Status: "Ok"
   - ["mongodb_sc"]
     Status: "Ok"
   - ["ongDb"]
     Status: "Ok"
   - ["postgres"]
     Status: "Ok"
   - ["postgres_sc"]
     Status: "Ok"
   
   Application
   Application Services Status OK
   Running services 50/50
   
   Remote Clusters
   Number Of Remote Clusters: 2
     - ["RC"]
        Connectivity Status:: "OK:"
     - ["RC2"]
        Connectivity Status:: "OK"
   
     Backup Storage:
     Location: "Local
   s3:http://minio.default.svc:9000/velerok8s/restic/default "
     Status: "Ok"
     Latest Backup: 2024-03-23 05:00:34 +0000 UTC			

   Example output for a remote cluster data node:

   [<ADMIN> ~]$ tos status         
   [Mar 28 13:42:09]  INFO Checking cluster health status           
   TOS Aurora
   Tos Version: 24.2 (PRC1.0.0)
   
   System Status: "Ok"
               
   Cluster Status:
      Status: "Ok"
      Mode: "Single Node"
   
   Nodes
     Nodes:
     - ["node2"]
       Type: "Primary"
       Status: "Ok"
       Disk usage:
       - ["/opt"]
         Status: "Ok"
         Usage: 19%
     
   registry
     Expiration ETA: 819 days
     Status: "Ok"
   
   Infra
   Databases:
   - ["mongodb"]
     Status: "Ok"
   - ["postgres"]
     Status: "Ok"
   
   Application
   Application Services Status OK
   Running services 16/16
   
     Backup Storage:
     Location: "Local
   s3:http://minio.default.svc:9000/velerok8s/restic/default "
     Status: "Ok"
     Latest Backup: 2024-03-23 05:00:34 +0000 UTC			

3. Backup your TOS data. This needs to be performed for all primary data nodes - the central cluster and remote collector clusters.

   If you are going to perform this procedure over multiple maintenance periods, create a new backup each time.

   1. Create the backup using tos backup create:

   [<ADMIN> ~]$ sudo tos backup create

   sudo tos backup create

   Example output:

   [%=Local.admin-prompt% sudo tos backup create
   						[Aug 23 16:18:42]  INFO Running backup
   					Backup status can be monitored with "tos backup status"

   2. You can check the backup creation status using tos backup status, which shows the status of backups in progress. Wait until completion before continuing.

   [<ADMIN> ~]$ sudo tos backup status

   sudo tos backup status

   Example output:

   [<ADMIN> ~]$ sudo tos backup status
   					Found active backup "23-august-2021-16-18"

   3. Run the following command to display the list of backups saved on the node:

      [<ADMIN> ~]$ sudo tos backup list

      sudo tos backup list

   Example output:

   [<ADMIN> ~]$ sudo tos backup list
   						["23-august-2021-16-18"]
   						Started: "2021-08-23 13:18:43 +0000 UTC"
   						Completed: "N/A"
   						Modules: "ST, SC"
   						HA mode: "false"
   						TOS release: "21.2 (PGA.0.0) Final"
   						TOS build: "21.2.2100-210722164631509"
   						Expiration Date: "2021-09-22 13:18:43 +0000 UTC"
   					Status: "Completed"

   4. Check that your backup file appears in the list, and that the status is "Completed".

   5. If your backup files are saved locally:

      1. Run sudo tos backup export to save your backup file from a TOS backup directory as a single .gzip file. If there are other backups present, they will be included as well.

      2. Transfer the exported .gzip file to a safe, remote location.

         Make sure you have the location of your backups safely documented and accessible, including credentials needed to access them, for recovery when needed.

      After the backup is exported, we recommend verifying that the file contents can be viewed by running the following command:

      [Target location]$ tar tzvf <filename>

      tar tzvf <file name>
4. Remote Collector clusters. If you are currently upgrading the central cluster, make sure all the Remote Collector clusters are connected.

   On the Central cluster primary data node run:

   [<ADMIN> ~]$ sudo tos cluster list

   sudo tos cluster list

   The output shows all connected clusters.

   Example output:

   $ sudo tos cluster list
   NAME    ID    IP                TYPE
   
   Central    1                    master
   RC1        2    192.168.75.156    data_collector

5. If you are running a multi-node cluster, get a list of your nodes.

   [<ADMIN> ~]$ sudo tos cluster node list

   sudo tos cluster node list
6. Save your TufinOS Configuration (repeat this step for each node).

   The TOS backup does not include your TufinOS configurations. Therefore, before you start create a list of the data you want to keep and save it outside the machine you are upgrading.

   After the upgrade completion, re-configure all your backed-up data before restoring TOS Aurora.

   For more information on what to information to save, see Save Your TufinOS Configuration:

   If you have any questions about the upgrade, contact the Tufin support team. Do not attempt the upgrade if you are unsure about any part of it.

Install TufinOS

TufinOS on the new data nodes, and on all worker nodes.

1. Place the TufinOS ISO image file on the datastore of vSphere. For local installation on a VMware machine, locate the extracted ISO image file.

2. Confirm that in your virtual machine settings, Boot Options is configured to use BIOS. If you are using EFI, the procedure will not work.

3. Edit the properties of the virtual CD/DVD drive, and do one of the following:

   Using vSphere:

   • As Device Type select Datastore ISO file, and browse to the TufinOS ISO image.

   • Under Device Status, select Connect at power on.

   Using a workstation:

   • Under Device Status, select Connect at power on.

   • Under Connection, select Use ISO image file, and browse to the TufinOS ISO image.

4. Set the VM to boot to BIOS configuration

   Example using vSphere

   1. Navigate to VM settings > VM options.
   2. Check: During the next boot, force entry into the BIOS setup screen.

      

5. In BIOS > Boot, select CD-ROM Drive.



6. In BIOS > Exit, select Exit Saving Changes. Click Yes.

   

7. Save the settings.

8. Restart the VM. TufinOS installation begins.

9. Select TufinOS 4.40 Installation for TOS Aurora.

10. When prompted, select which type of node to install:

    • Install TufinOS 4.40 for Data Node.

    • Install TufinOS 4.40 for Worker Node

11. When prompted, confirm and choose Yes.

12. When the installation is complete, reboot the virtual machine.

13. When BIOS launches, change the Boot option to Hard Drive.

    

14. In BIOS > Exit, select Exit Saving Changes. Click Yes.

    

15. Log in using the default admin user credentials:

    username: tufin-admin

    password: admin (you will be prompted to change this on first log in)

    IP address: assigned by DHCP

Set Up The Nodes

1. Restore the TufinOS configuration data that you saved before beginning the upgrade procedure (see Save Your TufinOS Configuration). In general we recommend that the new server configurations be similar to the old configurations.

2. If you want to reset the host name or IP of the machine, do so now. Once TOS Aurora has been installed, changing the host name or IP address will require reinstalling - see Changing IP Address/Host Names. To change the host name, use the command below, replacing <mynode> with your preferred name:

   [<ADMIN> ~]$ sudo hostnamectl set-hostname <mynode>

   sudo hostnamectl set-hostname <mynode>

3. Configure the server timezone:

   [<ADMIN> ~]$ sudo timedatectl set-timezone <timezone>

   sudo timedatectl set-timezone <timezone>

   where <timezone> is in the format Area/Location. Examples: America/Jamaica, Hongkong, GMT, Europe/Prague.

   To view a list of the time-zone formats that can be used, run:

   [<ADMIN> ~]$ sudo timedatectl list-timezones

   sudo timedatectl list-timezones

4. Synchronize your machine time with a trusted NTP server. Follow the steps in Configuring NTP Using Chrony. In an HA deployment, all servers need to be synchronized to the same time.

5. Configure the IP address and DNS, where <Interface Name> is the name of the interface you are using (for example, ens32). If you have several network interfaces, configure the first one.

   To find the first network interface

   Run the command:

   [<ADMIN> ~]$ sudo /opt/tufinos/scripts/network_interface_by_pci_order.sh | awk -F'=' '/NET_IFS\[0\]/ { print $NF }'

   sudo /opt/tufinos/scripts/network_interface_by_pci_order.sh | awk -F'=' '/NET_IFS\[0\]/ { print $NF }'

6. To assign a static IP address or restore one that was used before upgrading:

   1. Run the command:

   [<ADMIN> ~]$ sudo nmtui edit <Interface Name>

   sudo nmtui edit <Interface Name>

   

   and set the following parameters in the window:

   • Set IPv4 CONFIGURATION to Manual
   • Set Addresses for the physical IP, together with the chosen subnet
   • Set Gateway and DNS Servers to the IPs used by your organization
   2. Restart the network service.

   [<ADMIN> ~]$ sudo systemctl restart NetworkManager.service

   sudo systemctl restart NetworkManager.service
7. Verify that the DNS server can resolve its own address using a reverse lookup

   Run:

   [<ADMIN> ~]$ sudo nslookup <DNS SERVER IP>

   sudo nslookup <DNS SERVER IP>

   If the name of the server is displayed, the DNS server can resolve its own address using a reverse lookup.

   Example Output

   [<ADMIN> ~]$ sudo nslookup  1.2.3.4
   4.3.2.1.in-addr.arpa	name=EXAMPLE.company.com
   

   If the name of the server is not displayed, set it using a reverse lookup entry at /etc/hosts.

   Example Output where 1.2.3.4 4.3.2.1.in-addr-arpa was added.

   [<ADMIN> ~]$ sudo cat /etc/hosts 
   127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4
   ::1 localhost6 localhost6.localdomain6
   1.2.3.4 admin.company.com admin
   2.3.4.5 5.4.3.2.in-addr-arpa
   

    

Mount The etcd Database on The Data Node to a New Disk

The etcd database should be on a separate disk to improve the stability of TOS Aurora and reduce latency. Moving the etcd database to a separate disk ensures that the kubernetes database has access to all the resources required to ensure an optimal TOS performance.

See Move etcd - New Non-Cloud VM.

Install TOS

1. Run the tmux command:

   [<ADMIN> ~]$ tmux new-session -s TOS-Install

   tmux new-session -s TOS-Install

2. On the target machine, create the directory /opt/tufin/data, if it does not exist already.

3. Transfer the run file (already downloaded) to the /opt/tufin/data directory.

4. Go to /opt/tufin/data

5. Verify the integrity of the TOS installation packages by entering the following commands and comparing the output with the checksum information.

[<ADMIN> ~]$ sha256sum tos-xxxx-xxxxxxxx-final-xxxx.run.tgz

sha256sum tos-xxxx-xxxxxxxx-final-xxxx.run.tgz

[<ADMIN> ~]$ sha1sum tos-xxxx-xxxxxxxx-final-xxxx.run.tgz

sha1sum tos-xxxx-xxxxxxxx-final-xxxx.run.tgz

6. Extract the TOS run file from its archive.

   [<ADMIN> ~]$ tar -xvzf tos-xxxx-xxxxxxxx-final-xxxx.run.tgz

   tar -xvzf tos-xxxx-xxxxxxxx-final-xxxx.run.tgz

The run file name includes the release, version, and build number.

TOS file example: R24-2-pga0.0-final-4577.run

7. Run the TOS Aurora run file.

   [<ADMIN> ~]$ cd /opt/misc/

   cd /opt/misc/

   [<ADMIN> ~]$ sudo sh <runfile>

   sudo sh <runfile>

8. Run the install command, replacing the parameters:

   • <PRIMARY> - The VIP you will use to access TOS Aurora as described in Prerequisites

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

   • <PODS-CIDR> Optional. The CIDR you want to use for the Kubernetes pods network, as described in Prerequisites. The default pods network is 10.244.0.0/16

   • <MODULE-TYPE> - One of the following values:

     • ST for SecureTrack only
     • ST, SC for both SecureTrack and SecureChange/SecureApp
     • RC for a remote collector
   • <LOAD> - small, medium or large, as provided by your account team, based on your sizing calculation.

   There is also an option to do a dry run, to verify the procedure in advance by going through all the stages without installing anything. To do a dry run, add the parameter --dry-run to the install command.

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

   sudo tos install --modules=<MODULE-TYPE> --primary-vip=<PRIMARY> --services-network=<SERVICE-CIDR> --pod-network=<PODS-CIDR> --load-model=<LOAD> -d

   Examples:

   $ sudo tos install --modules=ST,SC --primary-vip=192.168.1.2 --services-network=10.10.10.0/24 --load-model=medium -d
   

   $ sudo tos install --modules=RC --primary-vip=162.148.10.0 --services-network=10.10.10.0/24 --load-model=large -d
   

9. The EULA is displayed. After reading, enter q to exit the document. If you accept the EULA, enter y and wait until the command completes.

   

10. You can now safely exit the CLI screen session:

    [<ADMIN> ~]# exit

    exit

11. If the installation was for a central (main) cluster, log into TOS Aurora at https://<VIP> in your browser with user=admin, password=admin. If a warning message is shown regarding the site security certificate, 'accept the risk' and continue to the site. You will be prompted to set a new password.

    If the installation was for a remote collector, connect it to the central cluster.

Add The Worker Nodes to The Cluster

Repeat these steps for each worker node.

1. Add the worker node to the cluster.

   1. On the primary data node run:

      [<ADMIN> ~]$ sudo tos cluster node add --role=<TYPE>

      sudo tos cluster node add --role=<TYPE>

      where <TYPE> is worker or data, depending on the type of node you want to add.

      On completion, a new command string is displayed, which you will need to run on the new node within one hour. If the allocated time expires, you will need to repeat the current step.

   2. Log in to the CLI of the server to be added as a new node in the cluster.

   3. On the new node, run the command string displayed previously on the primary data node in step 2 above. If the allocated time has expired, you will need to start from the beginning.
   4. Verify that the node was added by running sudo tos cluster node list on the primary data node.
2. Check the cluster status.

   1. On the primary data node, check the TOS status.

      [<ADMIN> ~]$ tos status

      tos status

   2. In the output, check if the System Status is Ok and all the items listed under Components appear as Ok. If this is not the case, contact Tufin Support.

   Example output for a central cluster data node:

   [<ADMIN> ~]$ tos status         
   [Mar 28 13:42:09]  INFO Checking cluster health status           
   TOS Aurora
   Tos Version: 24.2 (PRC1.1.0)
   
   System Status: "Ok"
               
   Cluster Status:
      Status: "Ok"
      Mode: "Multi Node"
   
   Nodes
     Nodes:
     - ["node1"]
       Type: "Primary"
       Status: "Ok"
       Disk usage:
       - ["/opt"]
         Status: "Ok"
         Usage: 19%
     - ["node3"]
       Type: "Worker Node"
       Status: "Ok"
       Disk usage:
       - ["/opt"]
         Status: "Ok"
         Usage: 4%
   
   registry
     Expiration ETA: 819 days
     Status: "Ok"
   
   Infra
   Databases:
   - ["cassandra"]
     Status: "Ok"
   - ["kafka"]
     Status: "Ok"
   - ["mongodb"]
     Status: "Ok"
   - ["mongodb_sc"]
     Status: "Ok"
   - ["ongDb"]
     Status: "Ok"
   - ["postgres"]
     Status: "Ok"
   - ["postgres_sc"]
     Status: "Ok"
   
   Application
   Application Services Status OK
   Running services 50/50
   
   Remote Clusters
   Number Of Remote Clusters: 2
     - ["RC"]
        Connectivity Status:: "OK:"
     - ["RC2"]
        Connectivity Status:: "OK"
   
     Backup Storage:
     Location: "Local
   s3:http://minio.default.svc:9000/velerok8s/restic/default "
     Status: "Ok"
     Latest Backup: 2024-03-23 05:00:34 +0000 UTC			

   Example output for a remote cluster data node:

   [<ADMIN> ~]$ tos status         
   [Mar 28 13:42:09]  INFO Checking cluster health status           
   TOS Aurora
   Tos Version: 24.2 (PRC1.0.0)
   
   System Status: "Ok"
               
   Cluster Status:
      Status: "Ok"
      Mode: "Single Node"
   
   Nodes
     Nodes:
     - ["node2"]
       Type: "Primary"
       Status: "Ok"
       Disk usage:
       - ["/opt"]
         Status: "Ok"
         Usage: 19%
     
   registry
     Expiration ETA: 819 days
     Status: "Ok"
   
   Infra
   Databases:
   - ["mongodb"]
     Status: "Ok"
   - ["postgres"]
     Status: "Ok"
   
   Application
   Application Services Status OK
   Running services 16/16
   
     Backup Storage:
     Location: "Local
   s3:http://minio.default.svc:9000/velerok8s/restic/default "
     Status: "Ok"
     Latest Backup: 2024-03-23 05:00:34 +0000 UTC			

Backup and Restore TOS Data

You are going to be backing up your TOS data on the existing data node and restoring it to the new data node.

1. Back up your TOS data.

   Backup your TOS data. This needs to be performed for all primary data nodes - the central cluster and remote collector clusters.

   If you are going to perform this procedure over multiple maintenance periods, create a new backup each time.

   1. Create the backup using tos backup create:

   [<ADMIN> ~]$ sudo tos backup create

   sudo tos backup create

   Example output:

   [%=Local.admin-prompt% sudo tos backup create
   						[Aug 23 16:18:42]  INFO Running backup
   					Backup status can be monitored with "tos backup status"

   2. You can check the backup creation status using tos backup status, which shows the status of backups in progress. Wait until completion before continuing.

   [<ADMIN> ~]$ sudo tos backup status

   sudo tos backup status

   Example output:

   [<ADMIN> ~]$ sudo tos backup status
   					Found active backup "23-august-2021-16-18"

   3. Run the following command to display the list of backups saved on the node:

      [<ADMIN> ~]$ sudo tos backup list

      sudo tos backup list

   Example output:

   [<ADMIN> ~]$ sudo tos backup list
   						["23-august-2021-16-18"]
   						Started: "2021-08-23 13:18:43 +0000 UTC"
   						Completed: "N/A"
   						Modules: "ST, SC"
   						HA mode: "false"
   						TOS release: "21.2 (PGA.0.0) Final"
   						TOS build: "21.2.2100-210722164631509"
   						Expiration Date: "2021-09-22 13:18:43 +0000 UTC"
   					Status: "Completed"

   4. Check that your backup file appears in the list, and that the status is "Completed".

   5. If your backup files are saved locally:

      1. Run sudo tos backup export to save your backup file from a TOS backup directory as a single .gzip file. If there are other backups present, they will be included as well.

      2. Transfer the exported .gzip file to a safe, remote location.

         Make sure you have the location of your backups safely documented and accessible, including credentials needed to access them, for recovery when needed.

      After the backup is exported, we recommend verifying that the file contents can be viewed by running the following command:

      [Target location]$ tar tzvf <filename>

      tar tzvf <file name>
2. Restore TOS to the new data node

   If you are restoring from external storage:

   1. Connect to the external backup storage using sudo tos backup storage set. with the <LOCATION> as external.

   2. Run sudo tos backup list to list all the backups and identify the one that you want to restore.

   3. Run sudo tos restore specifying the desired backup. We recommend that you select the most recent backup. On completion, your data will have been restored.

   If you are restoring from a backup that was saved locally and transferred to a safe, external location:

   1. Copy the export file (gzip format) from the remote location to your primary data node.

   2. Run sudo tos backup import, specifying the full path of the export file, to extract all the backups from the export file to the TOS backup directory.

   3. Run sudo tos backup list to list all the backups and identify the one that you want to restore.

   4. Run sudo tos restore specifying the desired backup. We recommend that you select the most recent backup. On completion, your data will have been restored.

   Important. After you restore TOS to a different or changed production environment, such as a new appliance or VM, or an in-place machine following an operating system upgrade, you must upload the license file. If you are restoring to a lab environment, there is no need to upload the license file. TOS will be fully functional and in 'lab mode' . TOS will then automatically shut down after 30 days.

3. Check the cluster status.

   1. On the primary data node, check the TOS status.

      [<ADMIN> ~]$ tos status

      tos status

   2. In the output, check if the System Status is Ok and all the items listed under Components appear as Ok. If this is not the case, contact Tufin Support.

   Example output for a central cluster data node:

   [<ADMIN> ~]$ tos status         
   [Mar 28 13:42:09]  INFO Checking cluster health status           
   TOS Aurora
   Tos Version: 24.2 (PRC1.1.0)
   
   System Status: "Ok"
               
   Cluster Status:
      Status: "Ok"
      Mode: "Multi Node"
   
   Nodes
     Nodes:
     - ["node1"]
       Type: "Primary"
       Status: "Ok"
       Disk usage:
       - ["/opt"]
         Status: "Ok"
         Usage: 19%
     - ["node3"]
       Type: "Worker Node"
       Status: "Ok"
       Disk usage:
       - ["/opt"]
         Status: "Ok"
         Usage: 4%
   
   registry
     Expiration ETA: 819 days
     Status: "Ok"
   
   Infra
   Databases:
   - ["cassandra"]
     Status: "Ok"
   - ["kafka"]
     Status: "Ok"
   - ["mongodb"]
     Status: "Ok"
   - ["mongodb_sc"]
     Status: "Ok"
   - ["ongDb"]
     Status: "Ok"
   - ["postgres"]
     Status: "Ok"
   - ["postgres_sc"]
     Status: "Ok"
   
   Application
   Application Services Status OK
   Running services 50/50
   
   Remote Clusters
   Number Of Remote Clusters: 2
     - ["RC"]
        Connectivity Status:: "OK:"
     - ["RC2"]
        Connectivity Status:: "OK"
   
     Backup Storage:
     Location: "Local
   s3:http://minio.default.svc:9000/velerok8s/restic/default "
     Status: "Ok"
     Latest Backup: 2024-03-23 05:00:34 +0000 UTC			

   Example output for a remote cluster data node:

   [<ADMIN> ~]$ tos status         
   [Mar 28 13:42:09]  INFO Checking cluster health status           
   TOS Aurora
   Tos Version: 24.2 (PRC1.0.0)
   
   System Status: "Ok"
               
   Cluster Status:
      Status: "Ok"
      Mode: "Single Node"
   
   Nodes
     Nodes:
     - ["node2"]
       Type: "Primary"
       Status: "Ok"
       Disk usage:
       - ["/opt"]
         Status: "Ok"
         Usage: 19%
     
   registry
     Expiration ETA: 819 days
     Status: "Ok"
   
   Infra
   Databases:
   - ["mongodb"]
     Status: "Ok"
   - ["postgres"]
     Status: "Ok"
   
   Application
   Application Services Status OK
   Running services 16/16
   
     Backup Storage:
     Location: "Local
   s3:http://minio.default.svc:9000/velerok8s/restic/default "
     Status: "Ok"
     Latest Backup: 2024-03-23 05:00:34 +0000 UTC			

4. Reinstall Tufin Extensions and PS solutions

   1. Reinstall all extensions. See the Extensions Knowledge Center.

   2. Reinstall all Professional Services solutions and reconfigure the cron jobs.