Installation PowerShell Parameters

Key Vault Cloud Systems (Alemba Cloud Systems only)

This is the name of the key vault which has been configured for access by your Azure Virtual Machine.

This setting is entirely optional and is only applicable to systems running in Alemba Cloud.

Parameter Name: KeyVault

Environment Variable Name: ASM_KeyVault

Default: Null

Example: mykeyvault

Connection String

This is the ADO Net connection string used to connect to the ASM database. The way we deal with this connection string has been simplified to help support more advanced scenarios such as Windows Authentication.

See https://docs.microsoft.com/en-us/dotnet/framework/data/adonet/connection-string-syntax

Even if you had a running ASM before (if it’s not EOS or higher), you have to enter the following variables:

  • Server name

  • Database name

  • User ID

  • Password

Parameter Name: ConnectionString

Environment Variable Name: ASM_ConnectionString

Default: Null

Example: The database ASM uses is installed on an SQL server called SQL01, ASM connects to a database on that server called ASMSQL with the username ASMDBAccount with a password xxxxx. Your connection string will therefore be:

Server=ASMSQL;Database=ASMSQL;User Id=ASMDBAccount;Password=xxxxx

Additional parameters can be added after this string to specify the maximum application pool size and the connection time out. Adding these settings to the end of the connection string will add additional stability:

;Max Pool Size=1000;Connection Timeout=120

Therefore your string, using the previous example will look like:

Server=ASMSQL;Database=ASMSQL;User Id=ASMDBAccount;Password=xxxxx;Max Pool Size=1000;Connection Timeout=120

HostName

This is the URL which will be used to access ASM over the network and will be used to configure IIS.

You can find your existing hostname by browsing to your current ASM version and noting the start of the URL.

For instance the Alemba support site is https://alemba.help/production/portal.aspx. The hostname is the bit between // and the first / i.e. alemba.help

For brand new implementations this could be the servername, but ideally you would install an SSL certificate on the ASM application server with a friendly name for connection. Please consult your local IT department for how to get hold of an SSL certification for use with ASM.

Parameter Name: Hostname

Environment Variable Name: ASM_Hostname

Default: localhost

Example: support.alembacloud.com

System Name

This name refers to the ASM instance and is used to determine the base URL for the ASM system. Assuming you use the default name of production, you would access ASM using https://support.alembacloud.com/production/core.aspx. Again you can find your existing instance name by browsing to your current version and noting the information between the first / and second /.

In our previous example of https://alemba.help/production/portal.aspx, the instance name would be production.

On a brand new implementation of ASM you can call this whatever you like: production, test, dev or anything else!

Parameter Name: systemName

Environment Variable Name: ASM_systemName

Default: production

Example: production

Certificate Thumbprint

The installation can configure HTTPS bindings for the system, but a suitable certificate must be installed on the server prior to running the installation.

Please contact your local IT team to obtain an SSL certificate for the ASM Application, which should be loaded in .pfx format in to the my certificate store with the public key marked as exportable.

Please consider that the IIS worker process must have suitable permissions to access the certificate and ASM is configured by default to use Application Pool Identity for the application pools that run under IIS. You will need to grant the user 'Network Service' permission to the certificate with All rights to expose the certificate to ASM.

The certificate thumbprint is used as a unique identifier for the certificate and can be found in the certificate properties

See the related section in https://docs.microsoft.com/en-us/powershell/module/iisadministration/new-iissitebinding?view=windowsserver2019-ps for further information.

The default value of null can be used if you do not have an SSL certificate in place, and can be added after patching to this version.

Parameter Name: sslCertificateThumbprint

Environment Variable Name: ASM_sslCertificateThumbprint

Default: Null

Certificate Store Location

The installation can configure HTTPS bindings for the system, but a suitable certificate must be installed on the server prior to running the installation.

This setting defines the install location of the certificate on the local server.

See the related section in https://docs.microsoft.com/en-us/powershell/module/iisadministration/new-iissitebinding?view=windowsserver2019-ps for further information

The default value of My can be used if you have no SSL certificate installed

Parameter Name: sslCertificateStore

Environment Variable Name: ASM_sslCertificateStore

Default: My

Accepted Values:

  • Cert:\LocalMachine\My

  • Cert:\LocalMachine\WebHosting

  • My

  • WebHosting

Install Prerequisites

The installation will install all prerequisites by default. When this value is set to n the system administrator assumes responsibility for installing windows features and all other prerequisites.

Parameter Name: InstallPrerequisites

Environment Variable Name: ASM_InstallPrerequisites

Default: y

Accepted Values: y, n

Replace Existing Versions

When this value is set to y, the installation will install reset all IIS configuration during the installation process.

This is the recommended approach and system administrators are advised to capture any non-standard configuration in a PowerShell script to run as part of their upgrade process.

Common items that are overwritten during a patch:

IIS: http redirects, url rewrites

ASM: Custom files you may have altered such as email-subjects.xml, Infra_custom.sql, Email event connector files stored in InstallDrive\alemba\Service Manager\web\systems\systemname folder\config

Alemba recommends that any changes to files follow a change control process and are documented and stored for ease of reapplying post patch.

Parameter Name: CleanInstall

Environment Variable Name: ASM_CleanInstall

Default: y

Accepted Values: y, n

Optional Modules

Specify one or more non-critical modules to install

Parameter Name: optionalModules

Environment Variable Name: ASM_optionalModules

Default: none

Accepted Values:

  • all

  • alemba.web.windows

  • infra.api.wstester

  • infra.console

  • dashboard.platform

ALEMBA.WEB.WINDOWS

Used to support integrated windows authentication. Alemba recommends using SAML or Open ID instead of this legacy authentication method.

INFRA.API.WSTESTER

Install the standard test harness for the classic API. Further configuration is required post installation.

INFRA.CONSOLE

Install the ASM Server Console. Required for Workflow Import/Export.

DASHBOARD.PLATFORM

You need to install this module again even if you had running Dashboards before. In this case only the IIS configurations are going to be reset.

Installs the Syncfusion Dashboard Platform. Requires further manual configuration.

License Key Text

On patching a pre-existing system to this version the existing license key will be maintained.

On creating a brand new implementation of ASM a license key should be obtained through your Technical Account Manager

Parameter Name: LicenceKey

Environment Variable Name: ASM_LicenseKey

Default: none

Copyright 2023 Alemba, ASM EOS 10.4