You migrate a Box in order to:

• Update the operating system by installing the latest Ubuntu version supported by EV Observe.
• Replace a defective but still accessible Box (unstable or behaving unexpectedly) and migrate it to a new Box.
   

You can perform the migration:

• To a Box deployed using the Ubuntu 20.04 LTS master. In this case, the migration of the OS is performed by deploying a new Box and by copying the network configuration and data from the existing Box.
      See the procedure

• In the Web app. In this case, no machine is required. You can simply select the Boxes eligible for migration and run the processing.

Notes

• Software version upgrades are automatically performed by the EV Observe platform.
• Prior to running the migration, there must be 5 GB available disk space on the Box to be updated.

Caution

• If you want to change the Box, you must ensure that the password of the new Box does not contain the $ symbol as this will prevent the migration script from running correctly.
• When generating the password for a Hyper-V Box, you must not use punctuation marks. This is because punctuation marks are not always correctly interpreted by the Hyper-V console and access will not be possible if there is no network connection.

Best Practice

• Type of migration to choose: The version upgrade to Ubuntu 20.04 LTS requires two to four hours of total unavailability. During this downtime, there will be no notifications and no raw data will be collected. If you want to avoid this unavailability period and the absence of data, you should perform the migration using a Box deployed using the Ubuntu 20.04 LTS master.

• If the Box has a specific configuration or context, this may generate an error and block the version upgrade. For this reason, you should schedule the migration to run during the usual business hours so that you can contact the EasyVista Support team if there is an issue.
• Run the migration progressively on a few of the Box at a time.
• Perform snapshots on the most critical virtual Boxes so that you can rollback the version if there is an issue.
• Report maintenance on the Boxes to be migrated for the duration of the update. The recommended value is four hours. This avoids triggering false positives and alerts that are time-consuming to handle.

• Access to the Box is secured using a password.
  • At the end of the migration, you should replace the default password.
  • Use a password generator and create a strong password that includes 12 characters, upper and lower cases, numbers, punctuation marks and unique characters.

Procedure: How to migrate using the Ubuntu 20.04 LTS master

Step 1: Prepare the existing Box

1. Open the SSH port for the existing Box if it is used to collect data from agents.

• Run the command below to check the port status.
  Replace {IP_old_box} with the IP address of the existing Box and {SSH_port} with the SSH port of the existing Box.

• If the SSH port is closed:
  • Open the file called /etc/init.d/iptables.sh in the existing Box.
  • Enable the row, iptables -A INPUT -p tcp –dport $PORT_NSCA -j ACCEPT.
  • Run the following command, /etc/init.d/iptables.sh.

2. Run the command below to stop Nagios services for the existing Box.

Step 2: Create the new Box using the Ubuntu 20.04 LTS master

1. Import the Ubuntu 20.04 LTS master to the virtual environment from the sFTP site (sftp://software.servicenav.io).

Note: Contact the EasyVista Support team to obtain the relevant login information.

2. Configure the network of the new Box.

    See the detailed procedure
 

Step 3: Copy the network configuration and data from the existing Box to the new one

1. Log in to the new Box as the root user using an SSH client.

2. Run the command below to restart the new Box.

Replace {IP_old_box} with the IP address of the existing Box and {password_old_box} with the password of the existing Box.

• –host: Remote box hostname (required)
• –port: Remote box port
• –timeout: Connect timeout in seconds (default: 10)
• -u, –user: Username used to connect to remote box (default: coadmin)
• -p, –password: Password used to connect to remote box (required)
• -o, –output: Filepath to log file (default: importConfigurationFromBox.log)
• –halt-remote: Halt remote box upon operation success (default: false)
• –reboot: Reboot this host upon operation success (default: false)

3. Run the commands below to restart the remoteOperationBox and Nagios services for the new Box.

4. Run the command below to reload the monitoring configuration for the new Box.

5. Configure the sending of notification emails using the Exim4 service found on the new Box. Next, run the commands below to check that emails are sent correctly.

6. Run the command below to restart the SNMP service for the new Box.

Note: If the error message below appears, this indicates that the migration script was unable to run because the Box has multiple network interfaces.

In this case, you must specify the network interface to be configured.

• Open the Netplan configuration file called /etc/netplan/90-snb.yaml/ with root access rights.
• Replace the value of the Interface_name property with {interface_name} which is the name of the interface to be configured, as specified in the error message.
• Save your modifications.
• Run the following command, netplan apply with root access rights to apply the modifications you made to the configuration.
   

Step 4: Migrate the new Box to version 4.17 in the Web app

1. Select Configuration > General > Box in the menu.

2. Select the new Box.

3. Click Start the update.
 

Step 5: Secure access to the new Box using a password

Note: For security reasons, the migration script is unable to modify the password.

1. Run the command below once you have logged in using the coadmin user.

2. Follow the instructions to modify the password of the coadmin account.