HERMES Installation Guide

Applicable Versions: Alemba Service Manager HERMES, v10.6 and above

Alemba provides access via PowerShell to automatically download and then run the ASM Patch for the version you require. We have found that this process is out of sync with current trends and maintaining these install tools is preventing improvements in the design, development, test, release, and maintenance processes.

We believe that ASM will be easier to install, own and operate without the old install process. ASM Gaia (v10.4) marks the last release which supports the old installation process.

ASM Hermes (v10.6) is geared towards automated installation on cloud environments.

For On Premise Installations Alemba now also provides an AlembaSetup.exe package that contains the installation files.

If you currently have a version of ASM earlier than v10.5.1, ASM is going to be removed and reinstalled during the upgrade process.

Any screen designs used in this document are used to represent the solution and may differ from what is delivered.

Summary of the Automated Installation Process

Below are the steps the automated installer performs. If monitoring the installation, you will be able to follow along with this list. Space is available for you to take notes during the process.

• Check for powershell 5 or later

• Check current user is a member of the built in Administrator role

• Find package.zip

• Install Azure Platform Utilities if on Azure and that ASM KeyVault environment variable is set.

• Validate install parameters. Parameters are gathered in the following order:

  • from script arguments

  • from Azure Key Vault secrets (if ASM KeyVault is set for the environment)

  • environment variables (prefixed with ASM_)

  • user input (if interactive)

• Validate database connection string

• Uninstall ASM Gaia or earlier

• Disable Windows Defender Realtime monitoring

• Extract files to ALEMBA_PATH\Staging

• Stop ASM Services

• Check if upgrade is supported

  • Only if it’s a minor upgrade e.g. 10.6.5 to 10.6.6

  • If not, the existing version will be removed before the install continues

• Install Prerequisites

  • Windows Features

  • .NET Core

ASM now requires .NET 8

We've upgraded from .NET 6 to .NET 8. Make sure to install the Hosting Bundle, which includes the .NET Runtime and IIS

https://dotnet.microsoft.com/en-us/download/dotnet/8.0

• Uninstall existing versions of ASM if necessary

• Copy files for each system

• Remove existing files (if necessary)

• Copy new files

• Update Registry

Prerequisites Summary Checklist

• SQL 2019 - SQL 2019 or later is necessary if you wish to create a new database

• PowerShell >5.0

• User is Administrator

• Key Vault

• ADO net connection String

• Host Name

• System Name

• SSL Certificate (Required for ASM Application)

• Certificate Thumbprint

• Certificate Store Location

• Download Prerequisites

• License Key Text

• Ensure Outlook is not installed on the Application Server

• Minimum 8GB RAM, Recommended 16 GB RAM in Production Environments

SQL Server 2019

SQL 2019 or later is necessary if you wish to create a new database. You can check it by opening the Properties:

Go to Options and click on the Compatibility Level:

There should be a SQL Server 2019 option.

You need the Full Text feature on the SQL Server.

You must change the Database recovery mode from full to simple. Failing to do so will fill the transaction log and cause the database to sill up and run out of disk space.