Transferring your Console to a new server

To move your Console to a new server, follow the steps below.

The most recent version of this procedure is maintained in the User Guide, in the chapter Configuration » Servers » Transferring Console — check it when running a newer software version.
On the OLD machine
  1. Stop all components (Sensors, Filters, BGP Connectors) from Configuration » Components.
  2. Stop WANsupervisor:
    service WANsupervisor stop
  3. Back up the database:
    /opt/andrisoft/bin/WANmaintenance backup_db
On the NEW machine
  1. Install the software packages and their dependencies.
  2. If a Console was already running on this machine, stop all its components from Configuration » Components, stop WANsupervisor, and back up its configuration:
    service WANsupervisor stop
/opt/andrisoft/bin/WANmaintenance backup_db
  3. Copy the backup file from the OLD machine:
    scp user@old_machine:/opt/andrisoft/tmp/wanguard_backup_from_xxxx-xx-xx.sql /root
  4. Restore the backup:
    mysql -p andrisoft < /root/wanguard_backup_from_xxxx-xx-xx.sql
  5. Go to Configuration » Servers and change the IP address of each server.
  6. Update the configuration of the Sensors, Filters and BGP Connectors to reflect the interfaces and IP addresses of the new machine.
  7. Start WANsupervisor:
    service WANsupervisor start
On every remote server that runs Sensors and/or Filters
  1. Update the software packages to the latest version, then execute:
    /opt/andrisoft/bin/install_supervisor
    When prompted, provide the new Console IP and database password.
  2. Restart the WANsupervisor service:
    service WANsupervisor restart
If something went wrong

To restore the initial configuration on the NEW machine:

  1. Stop all Sensors, then stop WANsupervisor:
    service WANsupervisor stop
  2. Restore the initial database:
    mysql -p andrisoft < /opt/andrisoft/tmp/wanguard_backup_from_xxxx-xx-xx.sql
  3. Start WANsupervisor, then start the Sensors:
    service WANsupervisor start
Copy graph files, packet dumps and flow data

You can manually copy the directories /opt/andrisoft/graphs, /opt/andrisoft/flows and /opt/andrisoft/dumps to the new server, as long as the ownership of the directories and files is preserved. If you store graphs in InfluxDB, also copy its "andrisoft" database to the new server; if you store graphs or flows in ClickHouse, copy its "andrisoft" database as well.

AuthorAndrisoft Team
Date Created27 November 2014
Date Updated11 October 2023
Views23,364