Identity Manager - Migration Settings tool for exporting and importing client settings

Identity Manager - Migration Settings tool for exporting and importing client settings

IDM 4.6 Dashboard introduces a new feature to customize UI settings, behavior, branding, and access to the application through client settings. There can be multiple such client settings on a single identity manager instance and different sets of users can map to different clients. The client settings include the branding settings, custom CSS, access settings, and custom behaviors.

The migration tool helps you migrate the client settings from one Identity Manager instance to another.

Where else is this tool useful?


Usecase 1: Primary usecase for this tool is to transfer settings from one Identity Manager instance to another. E.g. from your staging Identity Manager server to your production server.

Usecase 2: To take backup of all client settings and restore at a later point.

Usecase 3: To change storage option from file to database (Make sure to take the backup of settings before switching from file to database or vice versa).

 

Solution:


This is the tool to either export or import client settings from a server. The attached zip file contains one jar file and the silent properties file. You can set source and destination server details in the silent properties file for export and import client settings. The jar file you can run from a terminal with the following options:

Usage: java -jar MigrationSettings.jar [-option1] [value1]....[-optionN] [valueN]

Example 1: java -jar MigrationSettings.jar -e settings.json -f silent.properties

    • By running this it will export all the client settings from source server which you have provided in the silent properties file.



Example 2: java -jar MigrationSettings.jar -i settings.json -f silent.properties

    • By running this it will import all the client settings to destination server which you have provided in the silent properties file.



Example 3: java -jar MigrationSettings.jar -e settings.json -sp http -ss localhost -spo 8180 -srctx IDMProv -su cn= admin,ou=sa,o=data -spwd password

    • By running this it will export all client settings from the server which you have given through command line



Example 4: java -jar MigrationSettings.jar -i settings.json -dp http -ds localhost -dpo 8180 -drctx IDMProv -du cn=admin,ou=sa,o=data -dpwd password

    • By running this it will import all client settings to the server which you have given through command line



Where options include:

-e                   Export to file name (Example: clients.json)

-i Import settings from file name (Example: clients.json)

-sp Source Server protocol (http/https default: http)

-ss Source Server IP adrress(default: localhost)

-spo Source Server port (default: 8180)

-srctx Source Server RBPM Context (default: IDMProv)

-su Source Username (Example: cn=uaadmin,ou=sa,o=data)

-spwd Source Password

-dp Destination Server protocol (http/https default: http)

-ds Destination Server IP adrress(default: localhost)

-dpo Destination Server port (default: 8180)

-drctx Destination Server RBPM Context (default: IDMProv)

-du Destination Username (Example: cn=uaadmin,ou=sa,o=data)

-dpwd Destination Password

-f <filename> Use this option for silent mode, load values from property file. This will override other options passed to this utility


 

Silent properties File:

source.protocol=http

source.ip=127.0.0.2

source.port=8180

source.rbpm.web.context=IDMProv

source.username=cn=uaadmin,ou=sa,o=data

source.password=password

destination.protocol=http

destination.ip=127.0.0.1

destination.port=8180

destination.rbpm.web.context=IDMProv

destination.username=cn=uaadmin,ou=sa,o=data

destination.password=password


Note: Source server properties are mandatory for exporting client settings and similarly destination server properties are mandatory for importing. If you do not give password property in the silent properties file, it will ask you in the command line.

Download:
Find from attachment.

Attachments

DISCLAIMER:

Some content on Community Tips & Information pages is not officially supported by Micro Focus. Please refer to our Terms of Use for more detail.
Top Contributors
Version history
Revision #:
3 of 3
Last update:
‎2020-01-30 11:02
Updated by:
 
The opinions expressed above are the personal opinions of the authors, not of Micro Focus. By using this site, you accept the Terms of Use and Rules of Participation. Certain versions of content ("Material") accessible here may contain branding from Hewlett-Packard Company (now HP Inc.) and Hewlett Packard Enterprise Company. As of September 1, 2017, the Material is now offered by Micro Focus, a separately owned and operated company. Any reference to the HP and Hewlett Packard Enterprise/HPE marks is historical in nature, and the HP and Hewlett Packard Enterprise/HPE marks are the property of their respective owners.