This section specifically relates to the process of upgrading from version 1.x of Loome Identity to version 2.1. If you are upgrading from 2.x to a later version, please follow the standard upgrade guide.

Loome Identity 2.1 is a complete rebuild of the product and as such you cannot directly upgrade the product. You must remove version 1.x and then install version 2.1.

While it is not necessary, we recommend you do this outside of business hours and preferably on the weekend, to ensure that user tokens from the 1.x version expire. If you upgrade to version 2.1 and user tokens from the 1.x version have not expired, users may initially be directed to an error page on the client application before having to sign in again.

You may reuse the following items from your existing installation;

  • DNS entry
  • SSL certificate
  • Database name
  • Service account

After upgrade, you will need to do the following in relation to your client applications (please refer to the installation documentation for your client application for steps on creating the client record and running the setup application);

  • Recreate the client record in Loome Identity.
  • Run the setup application for your client application and enter the new client ID and secret.