Pre-migrate tasks

Before migrating the user accounts of IBM® Data Server Manager to IBM Db2® Data Management Console, you might require to complete some optional pre-migrate tasks.

Check the authentication and authorization mode of IBM Data Server Manager

If you do not exactly know the security configuration of the IBM Data Server Manager product and you want to understand it well before migration, follow the below instructions:

  1. Find the installation directory of IBM Data Server Manager. Navigate to the configuration folder Config located under the installation directory.
  2. Read the properties value of files dswebserver.properties and dswebserver_override.properties . Value of a same property in the override file will overwrite the value in the dswebserver.properties file.
  3. If either dsweb.customauth.repository=true or dsweb.customauth.ldap=true is not configured, normal authentication and local authorization could be enabled in IBM Data Server Manager.
  4. If only dsweb.customauth.repository=true property was found, repository authentication and local authorization will be used.
  5. If properties dsweb.customauth.repository=true and dsweb.customauth.privilegesinjson=false were found, repository authentication and Db2 UDF authorization will be enabled.
  6. If only dsweb.customauth.ldap=true property was found, LDAP authentication and local authorization will be enabled.
  7. If properties dsweb.customauth.ldap=true and dsweb.customauth.privilegesinldap=true were found, LDAP authentication and LDAP authorization will be enabled.
  8. If properties dsweb.customauth.ldap=true and dsweb.customauth.enableAddLDAPUser=true were found, LDAP authentication manual mode and local authorization will be enabled. This mode will override instruction 6 and 7 .
  9. For instruction 6 and 7, find the LDAP configuration file customldap.properties under the configuration folder. Read the properties in this file. If the property ldap.use.advanced.mode=true was configured, LDAP authentication advanced mode will be enabled, otherwise LDAP authentication simple mode will be used.

Check the authentication and authorization availability of IBM Data Server Manager

Make sure that the current security configuration of IBM Data Server Manager is correct and users can successfully login. Repository database can be accessed with the meta DB properties values. LDAP connections can be setup to LDAP server using the LDAP settings.

The setting of external security systems will be migrated to IBM Db2 Data Management Console. If the delegated security system was not available, then no user account will be available after migration.

Start the service of IBM Db2 Data Management Console

Although you can choose not to start IBM Db2 Data Management Console after upgrading from IBM Data Server Manager, we recommend you to start the service if you want to perform the migration of user accounts.

Some configuration files may be regenerated during the first time the service was started. If you perform migration first, some property values might be overwritten with default values.

After migration, confirmation through authentication settings web page might be required which in turn requires the service to be in running status.