[KB7732] Migrate ESET PROTECT Virtual Appliance to ESET PROTECT Server (Windows)

Issue

  • Migrate ESET PROTECT Server from ESET PROTECT Virtual Appliance to Windows Server

Solution

  1. Prerequisites
  2. Create a certificate with connection information
  3. Set a new ESET PROTECT Server IP address and assign the policy
  4. Enable Webmin interface
  5. ESET PROTECT Server Setup

I. Prerequisites

Supported MySQL Database

The following guide is only applicable to ESET PROTECT Virtual Appliance running a supported MySQL database.


II. Create a certificate with connection information

  1. Open ESET PROTECT On-Prem in your web browser and log in.

  1. Click MorePeer CertificatesNew Certificate.

    Figure 1-1
  2. In Basic, type the Description of the certificate. Select Server from the Product drop-down menu. Leave the Host field set to the default value and leave the Passphrase and Confirm passphrase fields empty.

    Figure 1-2
  3. Click Sign. Select the radio button next to Certification authority under Signing method. In the Certification authority options, click <Select certification authority>. A new window will open. Select the certification authority you want to use to sign a new certificate. Click OK to confirm and return to the previous window.

    Figure 1-3
  4. Type the Certification Authority passphrase. In this case, it is the same password you use to log into the ESET PROTECT Virtual Appliance Web Console. Click Finish to apply.

    Figure 1-4

III. Set a new ESET PROTECT Server IP address and assign the policy

  1. Open ESET PROTECT On-Prem in your web browser and log in.

  2. Click PoliciesNew Policy.

    Figure 2-1
  3. In Basic, type a name for your policy.

    Figure 2-2
  4. Click the Settings tab, select ESET Management Agent from the drop-down menu, and click Edit server list.

    Figure 2-3
  5. In the Servers window, click Add. In the Host field, type the IP address of your new ESET PROTECT Server (on Windows) in the format xxx.xxx.xxx.xxx. If you use a port other than the default ESET PROTECT Server port 2222, specify your custom port number. Click OK. Make sure your new ESET PROTECT Server address is listed first and click Save.

    Figure 2-4
  6. Click Assign → Assign to display a new popup window with all Static and Dynamic Groups.

    Figure 2-5
  7. Select the Static Group All to assign the policy to all connected agents and click OK.

    Figure 2-6
  8. Review the settings for this policy and click Finish to apply. The time to apply the policy will vary depending on your ESET PROTECT Server (on Windows) configuration.

  9. When the policy is applied, open ESET PROTECT Virtual Appliance and create a database backup.


IV. Enable Webmin interface

  1. In the ESET PROTECT Server Appliance management mode menu, select Enable/Disable Webmin interface to enable the Webmin interface.

  2. Connect to the Webmin interface using a web browser with the IP address of ESET PROTECT Virtual Appliance and port 10000. For example, https://xxx.xxx.xxx.xxx:10000. Log into the Webmin interface using the ESET PROTECT Virtual Appliance credentials where root is the login.

    Figure 3-1
  3. In the Webmin interface main menu, expand Tools and click File Manager. Click the root folder. Right-click the era-backup.sql file and select Download from the context menu. Save the file to a local drive and copy it to a location accessible from the target Windows machine.

    Figure 3-2
  4. Return to the ESET PROTECT Virtual Appliance window, log into the management mode and select Shut down system.

  5. On the target Windows Server, prepare a clean installation of MySQL Server. When you are prompted by the MySQL installer to create a Root Account Password, we recommend that you use the same one you used in the ESET PROTECT Server Appliance.

  6. Before proceeding, you must import ESET PROTECT Virtual Appliance database backup to an empty database named era_db on the target MySQL Server. Open a Command prompt and navigate to the MySQL Server binaries folder (the default location is C:\Program Files\MySQL\MySQL Server x.x\bin). Type the following commands, and replace TARGETHOST with the address of the target database server.

    mysql --host TARGETHOST -u root -p "--execute=CREATE DATABASE era_db /*!40100 DEFAULT CHARACTER SET utf8 */;"​
  7. Restore the ESET PROTECT Virtual Appliance backup database to the previously prepared empty database. Make PATHTOBACKUPFILE the location where you have stored the ESET PROTECT Virtual Appliance database backup:

    mysql --host TARGETHOST -u root -p era_db < PATHTOBACKUPFILE
  8. Create an ESET PROTECT On-Prem database user named root on the target MySQL server. Replace TARGETERAPASSWD with the password you used to log in to ESET PROTECT Virtual Appliance Web Console:

    mysql --host TARGETHOST -u root -p "--execute=CREATE USER root@'%' IDENTIFIED BY 'TARGETERAPASSWD';"
  9. Grant proper access rights for the ESET PROTECT On-Prem database user - root, on the target MySQL server:

    mysql --host TARGETHOST -u root -p "--execute=GRANT ALL ON eradb.* TO root;"​



V. ESET PROTECT Server Setup

  1. Download the ESET PROTECT Server standalone component. Execute the installation file and follow the Installation Wizard.

  2. In the Database server connection setup screen, ensure that the MySQL Server and MySQL ODBC Driver are detected properly. The database must be named era_db. In the Database account section, type in the Username "root" and Password you created in step 8.

    Figure 4-1
  3. Click Next to continue. The installer will ask if you want to use the provided user root as a database user for ESET PROTECT On-Prem, click Yes to apply and continue.

  4. Select the check box next to Use Administrator password already stored in the database. Change the Agent and Console port if required to match the settings in the ESET PROTECT Server Appliance. The default value for the Agent port is 2222, and the default value for the Console port is 2223. Click Next.

    Figure 4-2
  5. In the following window, select the radio button next to Keep currently used certificates and click Next. Follow the Installation Wizard to finish the Server component installation.

    Figure 4-3
  6. Install ESET PROTECT Web Console.

  7. Open ESET PROTECT On-Prem in your web browser and log in.
    Use your ESET PROTECT Server Appliance password. Verify that the agents have migrated successfully and are connecting to the new server. Do not uninstall your old ESET PROTECT Server Appliance until you have verified the migration was successful.