Migrating deployments and installation server users

Applies to:

You can migrate deployments and user accounts from an 9.0.x or 9.1.x installation server to the latest 9.2.x OpenPages® installation server.

About this task

Do this task if the following conditions are met:

You have an 9.0.x or 9.1.x installation server (the source installation server).
You set up the new 9.2.x installation server (the target installation server), for example 9.2.0.
When you set up the new installation server, you did not migrate deployments and user accounts from the source installation server by using the /m (Microsoft Windows) or -m (Linux®) argument.
Or, you migrated, but some deployments or user accounts did not get migrated.

When you migrate, keep the following points in mind:

Deployments and users that already exist in the target installation server are not migrated.
User accounts in the source installation server that are missing passwords are not migrated.
A deployment is not migrated if any validation, installation, or configuration processes are running.

Procedure

If the installation app is open, log out and close the browser window.
Stop the source installation server.
Windows
- Stop the ibmopenpagesinstaller<version>.exe.
- Or, go to the <installation_server_home> directory of the installation server that you want to stop. Open a command prompt as an administrator, and then run the following command:
  npm run stop
Linux
1. Open a shell and go to the <installation_server_home> directory of the installation server that you want to stop, for example /home/opuser/IBM/OPInstall/OP_<version>_Installer.
2. Run the following command:
  npm run stop
Log on to the computer where you set up the target installation server.
Migrate deployments and user accounts to the target installation server.
1. Open a shell or command window and go to the <installation_server_home> directory, for example /home/opuser/IBM/OPInstall/OP_<version>_Installer.
2. Run the following command:
  Replace <old_directory> with the full path to the installation server home directory of the source installation server.
```
npm run migration <old_directory>
```
  For example, if you're migrating from a 9.0 installation server to a 9.2.0 installation server, replace <old_directory> with the full path to the home directory of the 9.0 installation server.
If a deployment or user account is not migrated, fix any issues, and then run the migration again.