Distinguished names
If we are using LDAP in the source environment, verify wkplc.properties is properly configured. We might have a configuration that is working, but it might not be supported after migration. Short distinguished names (DN) are not supported. Make sure the properties files in your source environment are set with the fully qualified distinguished names.
The following excerpt from wkplc.properties provides some examples of using fully qualified distinguished names (DN) for the PortalAdminId parameter.
- PortalAdminId
- User ID for the WebSphere Portal administrator. The installation program sets this value based on user input during installation. The user ID cannot contain a space: for example, user ID. The user ID cannot be longer than 200 characters.
(UNIX only) Some tasks might require us to enter the fully qualified user ID. If the fully qualified user ID contains a space; for example:
cn=wpsadmin,cn=users,l=SharedLDAP,c=US,ou=Lotus,o=Software Group,dc=ibm,dc=com
...then place the fully qualified user ID in the properties file or into a parent properties file instead of as a flag on the command line. To create a parent properties file called mysecurity.properties, enter the fully qualified user ID, and then run:
./ConfigEngine.sh task_name -DparentProperties=/opt/mysecurity.properties
(Windows only) Some tasks might require us to enter the fully qualified user ID. If the fully qualified user ID contains a space; for example:
cn=wpsadmin,cn=users,l=SharedLDAP,c=US,ou=Lotus,o=Software Group,dc=ibm,dc=com
...then place quotations around the fully qualified user ID before running the task, for example:
"cn=wpsadmin,cn=users,l=SharedLDAP,c=US,ou=Lotus,o=Software Group,dc=ibm,dc=com."
- Value: A valid user ID contains only ASCII characters and can contain the following characters:
- Lowercase characters {a-z} and uppercase characters {A-Z}
- Numbers {0-9}
- Exclamation point {!}, Hyphen {-}, period {.}, question mark {?}, accent grave {`}, tilde {~}
- Open parenthesis {(} and close parenthesis {)}
- Open bracket {[} and close bracket {]}
- Underscore {_}, which is the only special character allowed in IBM i
- Examples: The following are example user IDs:
- Development configuration without security: PortalAdminId=uid=xyzadmin,o=defaultWIMFileBasedRealm
- IBM Tivoli Directory Server: { uid=,cn=users,dc=myco,dc=com }
- IBM Lotus Domino: { cn=,o=myco.com }
- Novell eDirectory: { uid=,ou=people,o=myco.com }
- Oracle Directory Server: { uid=,ou=people,o=myco.com }
- Windows Active Directory: { cn=,cn=users,dc=myco,dc=com }
- Windows Active Directory-Lightweight-Directory-Services: { cn=,cn=users,dc=myco,dc=com }
- Default: no default