How to move the Identity Service to another machine

This is a short guide on how to move the Identity Service from one computer to another and keep the existing database and all the existing configurations.

note

This workflow is valid for Identity Service v22.12 and higher. This means the Identity Service version you will try to move using this document should be at least 22.12.

Prerequisites

1. Identity Service (further in this document – IS) v22.12 or higher installed on your computer (further in the document – computer A).
2. The target machine (further – computer B) without an installed IS.
3. Some modules (e.g. OpenLM Server, DSS, etc.) connected to the IS on computer A.
4. Optional: SSL is enabled for each OpenLM application, including the IS.

The process

1. Disable the components' security, one by one, in the IS on computer A.

   

   note

   During the relocation of the IS, all the components will work without any security. If it is critical for you to keep the EasyAdmin user interface and other modules unavailable to unauthorized users, you can shut down all the components' services until the configuration is complete.

2. Stop the Identity Service on computer A.

3. Install the IS (same version or higher) on computer B.

4. Connect the IS to the same database used with the IS on computer A.

5. After the installation, stop the IS service on computer B.

6. Open CMD on computer B and use the cd command to navigate to the SecurityService folder. By default:

   cd C:\Program Files\OpenLM\OpenLM Identity Service\SecurityService

7. Execute the command below, replacing the address with the FQDN of computer B:

   OpenLM.SecurityService -url "http(s)://[FQDN of computer B]:5000"

   note

   If your environment uses HTTPS, first configure the IS on computer B with HTTPS using the SSL setup guide, and execute the command afterward.

8. Start the IS service on computer B.

9. Connect, step by step, all the components you used with the IS.