OpenAthens LA support ended on 31 March 2020

Search

Skip to end of metadata
Go to start of metadata

This is basically a new installation and a restore from backup. The basic steps in order:

Administration console (Linux):

  1. Download and install the base version OpenAthens LA 2.2 administration console. Instructions as per a new Administration console installation. Check all is well by logging into the console and running through the first run wizard before proceeding. Do not edit any settings.
  2. Update the base 2.2 administration console to the latest version:

     sudo yum update openathensla-admin
  3.  Copy the database folder from your 2.1.x administration console to your new one.
  4. Restart the openathensla-admin service

    sudo service openathensla-admin restart
  5. Check all is well by logging into the console and seeing your publish history and other settings appearing. You may need to re-enter the runtime hostname on the Configurations tab. If all has gone according to plan you will see the correct version number under the Help > About menu item (if you do not, restart the service once more as per step 4).

  6. (Optional) download a backup of your console settings (tools menu > backup)

Administration console (Windows):

  1. Download the latest MSI installer from the downloads page.
  2. Uninstall the existing software via the add/remove function in the control panel. Do not manually remove any files or folders from the installation directory.
  3. Install the new version.
  4. Access the console and enter your licence key (from the download page) at the prompt and then log in. If all has gone according to plan you will see the correct version number under the Help > About menu item.
  5. (Optional) download a backup of your console settings (tools menu > backup)

Runtime server(s)

  1. Download and install the base version OpenAthens LA 2.2 runtime (or runtimes to match your existing deployment) and update to the latest version. Instructions as per a new runtime installation.

  2. Attach the runtime(s) to your administration console and use the migration wizard on the last page to migrate data and settings from your old 2.1.x runtime(s).
  3. On the configurations tab, confirm the runtime hostname is correct under connection settings.
  4. Publish and test
  5. Update DNS to direct users to your new runtimes instead of your old ones.

Service info: End users will lose their sessions between the old and new runtimes and will need to re-authenticate to continue. Administration users will lose statistics for the period between the data transfer to the new runtime and that runtime entering service. Items such as memcache for load-balanced servers or alternative authentication providers such as Kerberos will need to be re-implemented. The migration wizard can be re-run if a significant time passes before switching users to the new runtime.

Upgrading from a 2.0 version of OpenAthens LA

  1. Set up the latest version as new.
  2. Contact our service desk for advice on how to copy any statistics and certificates you need to keep
  3. Update DNS to direct users to your new runtimes
  • No labels