Knowledgebase business article search

Install ESMC Web Console using JDK

Issue

  • Starting January 2019, Oracle JAVA SE 8 public updates for business, commercial or production use will require a commercial license 
  • If you do not purchase a JAVA SE subscription, you can use this guide to transition to a no-cost alternative 
  • Only installations on Windows are affected

 

Solution

Supported versions:

If you have multiple Java versions installed on your system, we recommend that you uninstall the older Java versions and only keep the latest one.

Make sure that Java, ESMC, and Apache Tomcat have the same bitness (32-bit or 64-bit).

MDM enrollment issues

MDM mobile device enrollment using a QR code is not functional for JDK 11.0.1 and OpenJDK 11.0.1. MDM mobile device enrollment using a QR code is only functional for Amazon Corretto 8u192. All other MDM enrollment methods are functional.

I am installing new ESMC server from All-in-one installer.
 

Migrate your existing ESMC Web Console to use JDK.

You can migrate your existing ESMC Web Console from Oracle Java JDK to an alternative one. Choose one of the migration scenarios below based on your current Apache Tomcat version.

 

Migration scenario for Tomcat version 7.0.90 and higher

This migration scenario does not require re-install of Apache Tomcat.

  1. Navigate to the Apache Tomcat location (for example, C:\ProgramFiles\Apache Software Foundation\"Apache tomcat folder"\bin\tomcat7w.exe)
  2. In the Apache Tomcat 7 Properties window, navigate to the General tab and click on the Stop button to stop the Apache Tomcat service.
  3. Uninstall your current JDK.
  4. Install your desired JDK.
  5. Go back to the Apache Tomcat 7 Properties window and navigate to the Java tab.
  6. Under Java Virtual Machine path select the correct path to the jvm.dll file based on the JDK. (for example for Amazon Correto, C:\Program FIles\Amazon Correto\jre8\bin\server\jvm.dll)
  7. Go back to the General tab, and click Start to start the Apache Tomcat service.
  8. Verify that you can log in to your ESCM Web Console.

 

Migration scenario for Tomcat version 7.0.88 and lower

This migration scenario requires re-install of Apache Tomcat.

  1. Back up the necessary files:
    C:\Program Files (x86)\Apache Software Foundation\Tomcat 7.0\.keystore|
    C:\Program Files (x86)\Apache Software Foundation\Tomcat 7.0\conf\Server.xml
    C:\Program Files (x86)\Apache Software Foundation\Tomcat 7.0\conf\Tomcat-users.xml
    C:\Program Files (x86)\Apache Software Foundation\Tomcat 7.0\conf\Serverinfo.properties
    C:\Program Files (x86)\Apache Software Foundation\Tomcat 7.0\webapps\era\WEB-INF\classes\sk\eset\era\g2webconsole\server\modules\config\EraWebServerConfig.properties

     
  2. Download and run the JDK installer.
     
  3. In order to change which JDK Apache Tomcat is used, you need to reinstall the Apache Tomcat.
     
  4. If you are running more than ESMC Web Console on Apache Tomcat, we recommend that you check the official Apache Tomcat upgrade/migration documentation.
     
  5. If you are using a custom SSL certificate store in the Tomcat folder, back up the certificate.
     
  6. Uninstall the current version of Apache Tomcat.
     
  7. Delete the following folder if it is still present on your system:
    C:\Program Files (x86)\Apache Software Foundation\Tomcat 7.0\
     
  8. Run the Apache Tomcat installer from the ESMC All In One installers folder. During the installation, select the path to your JDK you intend to use instead of the Java SE. (for example, C:\Program Files\Amazon Corretto\jre8). 
     
  9. When you are finished, deselect the check box next to Run Apache Tomcat.
     
  10. Verify that the Apache Tomcat Service is not running.
     
  11. Copy the era.war file from the installers folder to the Apache Tomcat web applications folder: click Start → Apache Tomcat → Tomcat Program Directory and open the webapps folder (on most Windows operating systems - C:\Program Files (x86)\Apache Software Foundation\Tomcat 7.0\webapps)
     
  12. Allow a few minutes for the file extraction and ESMC Web Console installation. The installation will run silently but you can verify a successful installation by the presence of the era folder inside the webapps folder.
     
  13. Restore the backed up files to their original locations.
     
  14. Verify that the Apache Tomcat is using the JDK you selected. To do so, click Start →  All Programs → Apache Tomcat → Monitor Tomcat. In the Java tab under Java Virtual Machine, there should be the path to the JDK you selected.
     
  15. You can now start the Apache Tomcat service and verify that the webconsole is running without any issues.
My installer requires Oracles JAVA

This guide describes how to install ERA/ESMC Web Console with JDK. 

If you already have ESMC Web Console running, follow Migrate your existing ESMC Web Console to use JDK guide above.

  1. To perform a new installation of ERA/ESMC server with the Web Console using JDK, run the All-In-One Installer.
     
  2. Administrator privileges are required to run the installer.
     
  3. Click Next.

    Figure 1-1

  4. Select Install ESET Security Management Center Server and click Next.

Figure 1-2

  1. Read the End-User License Agreement. If you agree, select I accept the terms in the license agreement. Deselect the check box next to Participate in product improvement program if you do not agree to send crash reports and telemetry data to ESET. If the check box is left selected, telemetry data and crash reports will be sent to ESET. Click Next.

Figure 1-3

  1. Your network architecture will determine which components should be installed. Read the descriptions below and deselect the check box next to the components that you will not install. Click Install when you are done deselecting components. Installation time will vary depending on your system configuration. If a prerequisite is not satisfied or an error occurs, follow the instructions from the installer to resolve the issues.
    • Microsoft SQL Server Express: If you have an existing Microsoft SQL or MySQL database that you will use with ESET Security Management Center, deselect this check box. Leaving this check box selected will create a new Microsoft SQL Server Express database to use with ESET Security Management Center.
    • ESET Security Management Center Webconsole: Leaving this check box selected will install the Apache Tomcat service necessary for ESET Security Management Center Server to manage clients.
      OPEN JDK for ESMC Webconsole

      Deselect the ESET Security Management Center Webconsole component if you are using Open JDK for ESMC Webconsole. This component will be installed manually after the server installation is finished.

    • Mobile Device Connector: Leaving this check box selected will install the ESET Mobile Device Connector (MDC) component, which allows for the remote management of Android and iOS devices. See our MDC FAQ for more information.
    • Rogue Detection Sensor: Leaving this check box selected will install ESET Rogue Detection Sensor, a component that helps locate unmanaged computers on your network so that you can deploy resources to allow for their management using ESMC. We strongly recommend that you leave this check box selected.
    • Apache HTTP Proxy (mirror replacement): We recommend that you deselect this component if you are unsure if it is needed on your network. Apache HTTP Proxy can deliver significant performance improvements on networks of roughly 40 computers or more.

      Using HTTP Proxy will create and apply several proxy-based policies for clients and apply them automatically, which can affect your ability to download updates. You can install Apache HTTP Proxy later if you need to.

Figure 1-4

  1. Click Next in the ESET Security Management Center Server Setup window.

Figure 1-5

  1. If you opted to install Microsoft SQL Server Express in step 6, click Next to perform a database connection check and continue to step 9.

Figure 1-6

Users with a pre-existing database: Select the appropriate database type from the Database drop-down menu. Type the Database nameHostname and Port (you can find this information in SQL Server Configuration Manager) for your database into the appropriate fields. If you are using MS SQL database, you can also select the Use Named Instance check box. This will allow you to use a custom database instance, including MS SQL database that is installed in a Failover Cluster (see more details in Online Help). Enter database administrator Username and Password. Then click Next. In the following screen, select Use existing user and then enter the Database username and Password if one is used.

Figure 1-7
Click the image to view larger in new window

  1. Type the password you will use to log into ESMC Web Console into the Password and Confirm Password fields. Make sure to record this password for use later and then click Next.

Figure 1-8

  1. In the Certificate information window, customize your Certification Authority. The only mandatory fields are Authority common name and Certificate validity. Enter any additional information about your Certification Authority that you want to add. If you create a password, make sure that you record it in a safe place because all client computers using this certificate will require that same password to use the certificate. Click Next when you are finished.

Figure 1-9

  1. Select Activate with License Key and type your License Key into the appropriate field, or select Activate later. If you have an ESET-issued Username and Password from an earlier version of ERA, you can convert them into a license key using ESET Business Account. Click Next when you are finished.
  1. Click Install.

Figure 1-10

  1. Click Finish.

Figure 1-11

  1. Follow the steps in the WinPcap installation setup wizard.
     
  2. Close the Installation successful window and proceed with the manual installation of ESMC Web Console.

Manual Installation of ESMC Web Console

  1. Run the installation of Apache Tomcat.
     
  2. Run the installation of your selected JDK.
     
  3. Copy the era.war file from the installers folder to the Apache Tomcat web applications folder: navigate to Start > Apache Tomcat > Tomcat Program Directory and open webapps folder (On most windows operating systems - C:\Program Files (x86)\Apache Software Foundation\Tomcat 7.0\webapps)
     
  4. Allow a few minutes for the file extraction and ESMC Web Console installation. The installation will run silently but you can verify the successful installation by the presence of era folder inside the webapps folder.
     
  5. Restart the Apache Tomcat service. Start > Apache Tomcat > Configure Tomcat. Click Stop, wait for 30 seconds and then click Start.
     
  6. Open ESMC Web Console in your browser: http://localhost:8080/era/, a login screen will be displayed.

 



Was this information helpful?