Ambience 4.x Server Migration

Elixir Ambience 3.x, 4.x
1

Content:

  • This entry gives you an overview of the steps needed during Ambience 4.x Server Migration.
  • Touches on two main points, “Migration of Configuration scripts/files” & “Migrations of Existing File Systems”.

Migration of Configuration scripts/files:

i.e. startup scripts, users & groups, server configurations, database drivers, etc.

  1. Login to the Domain Manager of the former Ambience instance and export the relevant configurations, e.g. usersgroupdb, password-policy and user access rights.

    Graphical user interface, application Description automatically generated|757.6499035358429x384.7668378353119
    Graphical user interface, application Description automatically generated|757.6499035358429x384.76683783531191366×694 72.3 KB

  2. Go to the Domain Manager of the new Ambience instance and import the configurations exported from the former instance. Ensure each configuration is imported under the same node that it was exported from.
    Refer to the URL for more information on the Domain Manager configurations:
    Chapter 2. Configuration

  3. Go to the /lib directory of the former Ambience instance and copy the JDBC drivers to the new Ambience instance.

  4. Compare and copy each piece (one by one) line of configuration information from the former configuration files in the /config directory of the existing Ambience installation to the new Ambience configuration files. Same applies to any configuration changes made to the files in the /jetty directory.

  • DO NOT wholly copy and overwrite configuration files from the former Ambience /config over to the new Ambience /config path. This may prevent the new Ambience instance from starting up correctly.
  1. Go to /bin directory, compare and copy the command line arguments in the batch files and shell scripts to the new executable scripts in the /bin directory of the new Ambience Server installation.

Migration of existing file systems to new Ambience instances:

  1. Login to the Domain Manager on the new Ambience Instance and replicate the repository, stores and file systems according to the former Ambience instance.
    |725.1956033706665x363
    |725.1956033706665x3631360×683 74.4 KB
  • For example, the current version of Ambience has a Store name “QA-Test” and the file path ‘./data/dacapo/eno/repository-QA’. Copy the path of the stores and the file system names and set them up on the new Ambience instance. Note that the names of the file systems are case sensitive and they have to be exactly the same.
    |624.3175799846649x317.6761268377304
    |624.3175799846649x317.67612683773041366×695 56.6 KB

Other Considerations:

  • The Ambience server license can be redeployed as long as it is based on the major version, e.g. 4, and the license has not expired.
  • We do advise performing an end-to-end test once migrated to the latest/desired Ambience 4.x version.

Download softcopies of the above guide and migration guidelines here:
Ambience 4.x Server Migration.pdf (203.2 KB)
Guideline for Ambience Migration_v1.0.pdf (324.8 KB)