Opsview Infrastructure Agent (Beta) Upgrade

To upgrade from Opsview Agent to Infrastructure Agent, follow the instructions in this section.

Prerequisites

Take note of the following before you proceed with the upgrade procedure:

• The Opsview Agent is currently running on a Linux or Windows Server.
• An Infrastructure Agent package download is available for the required operating system.

Migration of configuration

When upgrading from Opsview Agent to Infrastructure Agent, three settings in the configuration are sent over to the new agent on startup. These settings will be stored in cfg/custom/imported.yml. If this file already exists, the Agent will not import the old settings on startup.

The settings are:

• allowed_hosts
• server port
• commands

The Agent will not import the following settings:

• allow_arguments
• allowed_ciphers
• allow_nasty_meta_chars
• ca
• certificate
• certificate_key
• file
• packet_count
• use_ssl

If you want to use these settings in the Infrastructure Agent, you need to transfer them over manually.

Upgrade procedure for Linux

1. Stop the Opsview Agent service.

   sudo systemctl stop opsview-agent
   

   sudo systemctl disable opsview-agent
   

2. Download the latest infrastructure-agent package from Opsview Downloads and run the following to install. Make sure to substitute the <version> with that of the downloaded package.

   • For Debian and Ubuntu, run:

     sudo apt install ./infrastructure-agent-<version>.deb 
     

   • For CentOS and RHEL, run:

     sudo yum install infrastructure-agent-<version>.rpm
     

3. Once the Agent is installed, you must set allowed_hosts in order for it to run if it is not automatically imported from the old Agent. See Infrastructure Agent Configuration for more information.

   The agent may need to be restarted manually to use the changed configuration:

   sudo systemctl restart infrastructure-agent
   

4. Once the Infrastructure Agent is running, you can uninstall the Opsview Agent.

   • For Debian and Ubuntu, run:

     sudo apt remove opsview-agent
     

   • For CentOS and RHEL, run:

     sudo yum uninstall opsview-agent
     

Upgrade procedure for Windows

1. Open Services, and then stop the Opsview Agent service.
2. Download the latest infrastructure-agent package from Opsview Downloads.
3. Once the package has downloaded, open the file to install it.
4. Once the Agent is installed, you must set allowed_hosts in order for it to run if it is not automatically imported from the old Agent. See Infrastructure Agent Configuration for more information.
5. You need to manually set an inbound firewall rule to allow connections to come through.
   • Go to Windows Defender Firewall.
   • Create a new inbound rule and select the Program option.
   • Ensure the program path is C:\Program Files\Infrastructure Agent\bin\infra-agent.exe.
   • Ensure Allow the connection is selected.
   • Ensure Domain, Private, and Public are selected (according to the connectivity requirements).
   • Give the rule a name and select Finish.
6. Once Infrastructure Agent is running, you can uninstall the Opsview Agent.