Ambience/Repertoire 202x Upgrade Guide

Ambience 2020+
,
1

PDF Guide:
Ambience_Repetoire202x Upgrade Guide.pdf (129.2 KB)

If you are using Repertoire, please refer to the migration guide below, as it provides more detailed information and supporting references:
Migrating from Repertoire 202x to latest 202x build - Repertoire 2022+ - Elixir Support Forum

Prerequisite

  • Ensure you have the license key for Ambience/Repertoire 202x.

  • Do not remove/overwrite your current Ambience/Repertoire installation directory

Steps to Upgrade to the Latest Version of Ambience/Repertoire 202x

  1. Stop/Shutdown the current Ambience/Repertoire server.

  2. Unzip the latest version of Ambience/Repertoire 202x.

  3. Mandatory configuration on the new Ambience/Repertoire 202x setup:

  • Edit the new etc/application.conf content base on your previous version of Repertoire/Ambience etc/application.conf (Do not overwrite the application.conf with your existing one)

  • Rename the bin/run-server from the new Repertoire/Ambience to bin/run-server.bkup and copy over startup script bin/run-server from the old Repertoire/Ambience to the new Repertoire/Ambience directory

  1. Optional Configurations:

JDBC Configuration:

  • Copy over the database connection pool properties from the old to new Ambience/Repertoire from the etc/ directory.

  • Copy over the JDBC database drivers from the old to new Ambience/Repertoire from the ext/ directory.

SSL Configurations:

  • Copy over the SSL keystore from the old to new Ambience/Repertoire from the etc/https/ directory or wherever it is stored (refer to the etc/application.conf for the correct location).

Example:

ambience {

systemId: "System"

bindAddress: "0.0.0.0"

bindPort: ${internal-port}

https {

enabled = false

keystore = "https/keystore"

keystore-type = "PKCS12"

keystore-password = ""

client-auth = "none" # none, optional or require

truststore = "https/truststore"

truststore-type = "PKCS12"

truststore-password = ""

}

}

Repertoire/Ambience service script

  • Linux

Uninstall the service Ambience/Repertoire service first
sudo systemctl disable repertoire

or

sudo systemctl disable ambience

Edit .service file content in /etc/systemd/system/ambience_service or /etc/systemd/system/repetoire_service:

#!/bin/sh -

[Unit]
Description=Elixir Ambience 202x Service

[Service]
User=elixir Do revise the user name as needed.
WorkingDirectory=/opt/ElixirAmbience202x/bin Do revise the path as needed.
ExecStart=/opt/ElixirAmbience202x/bin/run-server Do revise the path as needed.
Restart=on-failure

[Install]
WantedBy=multi-user.target

Use systemd to load new service:

sudo systemctl daemon-reload

Start Repertoire/Ambience service:

sudo systemctl start ambience

or

sudo systemctl start repertoire

Check status for Ambience/Repertoire service:

sudo systemctl status ambience

or

sudo systemctl status repertoire

Enable Ambience/Repertoire service:

sudo systemctl enable ambience

or

sudo systemctl enable repertoire

For more information:

Configuring Ambience/Repertoire 2020+ as Linux Service - Ambience 2020+ - Elixir Support Forum (elixirtech.com)

  • Windows

Uninstall Ambience/Repertoire window service via CMD/powershell by running from the old version server

elx-ambience-service.exe uninstall

Copy over the window services file from the old server to the new server.

Ambience:

run-ambience-service

elx-ambience-service

elx-ambience-service.wrapper

elx-ambience-service.out

elx-ambience-service

elx-ambience-service.err

Repertoire:

run-repertoire-service

elx-repertoire-service

elx-repertoire-service.wrapper

elx-repertoire-service.out

elx-repertoire-service

elx-repertoire-service.err

Install the Ambience/Repertoire service by running the following command via CMD/Power shell

elx-ambience-service.exe install

Or

elx-repertoire-service.exe install

For more information:

Installing Ambience/Repertoire 202x as a Windows Service - Ambience 2020+ - Elixir Support Forum (elixirtech.com)

Templates and Data Sources (Repertoire Only)

  • Copy over Repository/ directory to the new Repertoire-202x version

Repertoire Users and Groups

  • Copy over data/codex directory to the new Repertoire-202x version

ETL module files

  • Copy over from data/in & data/out directory to the new Ambience/Repertoire 202x

  1. Start the newly installed Ambience/Repertoire server 202x.

  2. Verify that everything is working as intended.

Please do a rollback to your previous version if you are unable to start the newly installed Ambience/Repertoire server.

Note:

For Ambience 202x installations template,data sources,user and roles are stored in your MongoDB database.