Updating Java and Apache Tomcat for the Empirum Web Console

The Empirum Web Console (EWC) ships with Java and Apache Tomcat components. Matrix42 updates these as part of the regular product release cycle (typically every 3 months), bundling the versions that are current at the time of release.

Between releases, however, new security patches for Java or Apache Tomcat may become available. To let you close these gaps without waiting for the next product update, Matrix42 provides a tool that updates your existing EWC package with the latest available versions.

Before You Start

Download the update package here: Update-Java_ApacheTomcat_for_EWC.zip

You will need:

• Access to the Empirum server (the script must run there)
• Administrator privileges
• Internet access on the Empirum server (optional — see Step 2 for the offline alternative)

Step 1: Extract the Package

Unzip the downloaded file directly on the Empirum server.

Step 2: Run the Update Script

Choose one of the following options:

Option A — Batch file (requires internet access) Right-click Update-Java_Apache Tomcat_for_EWC.bat and run it as administrator. The script automatically downloads the latest versions of Java and Tomcat and automatically integrates them into the existing package for the web console. Previous versions of Java_ApacheTomcat.exe and Setup.inf are saved as backups. After that, you only need to complete steps 4 and 5.

Option B — PowerShell script (supports offline use) Run Update-Java_Apache Tomcat_for_EWC.ps1 as administrator. This option supports additional parameters, including:

• -LocalJava and -LocalTomcat — Use locally provided installers instead of downloading from the internet
• -CopyToEmpirumServer — Automatically copy the resulting files to the EWC package directory (see Step 3)

To see all available parameters, run:

Get-Help .\Update-Java_Apache Tomcat_for_EWC.ps1 -Detailed

When the script completes successfully, the last lines of output will show the path to the new setup file, for example:

The script finished successfully and the new setup has been created:
'%TEMP%\Java_ApacheTomcat\target\Java_Apache Tomcat.exe'

Step 3: Deploy the New Files to the EWC Package

What you do next depends on whether you used the -CopyToEmpirumServer parameter.

In the paths below, replace your_current_version with your installed EWC version (for example, 25.4).

If you used -CopyToEmpirumServer: The files have already been copied for you. The script also created backups in the folders below, which you can now safely remove:

• \\%EmpirumServer%\Configurator$\Packages\Matrix42\Web Console\your_current_version
• \\%EmpirumServer%\Configurator$\Packages\Matrix42\Web Console\your_current_version\Install

If you did not use -CopyToEmpirumServer: Manually copy these two files to the Empirum server:

Step 4: Refresh the Package Hash

In the Empirum Management Console (EMC), open the software depot, select the Empirum Web Console package, and run Prepare package for validation. This generates an updated hash for the modified package.

Step 5: Reinstall on Affected Systems

Trigger a reinstallation of the Empirum Web Console package on all systems where EWC is deployed. They will pick up the updated Java and Tomcat versions.