Troubleshooting examples that use the DirectoryAdmin tool

If you run into the following problems while administering IBM® InfoSphere® Information Server, you can use the DirectoryAdmin tool to help you determine and address the problem.

Lost user password

This example is only applicable to internal user registry configuration. From the command line, enter the following command:

DirectoryAdmin.bat -user -userid admin_user_id -password new_password

You can provide the password as plain text or as a string that has been encrypted with the encrypt command.

Note: If you have multiple InfoSphere Information Server Suite Administrators, you could instead ask one of these administrators to log in to the IBM InfoSphere Information Server Web console and reset the lost user password in the IBM InfoSphere Information Server Web console.

User registry configuration is not working and you cannot log in to the IBM InfoSphere Information Server Web console

To reset the user registry configuration to use the IBM InfoSphere Information Server internal user registry:

From the command line, set the InfoSphere Information Server to use the InfoSphere Information Server internal user registry by entering the following command:
```
DirectoryAdmin.bat -set_provider ISF
```
Create the default InfoSphere Information Server Suite administrator user by using the following command:
```
DirectoryAdmin.bat -user -userid default_isadmin_userid -password password
 -admin
```
You can provide the password as plain text or as a string that has been encrypted with the encrypt command.
Log in to the IBM WebSphere® Application Server Administrator console and set the application server user registry to the InfoSphere Information Server internal user registry.

To reset the user registry configuration to use the application server user registry:

Ensure that the application server user registry is configured to use the local operating system user registry or LDAP user registry of your choice.
From the command line, set InfoSphere Information Server to use the application server user registry by entering the following command:
```
DirectoryAdmin.bat -set_provider J2EE
```
Assign a user the necessary security roles to make that user the default InfoSphere Information Server Suite Administrator by entering the following command:
```
DirectoryAdmin.bat -user -userid default_isadmin -admin
```
The default InfoSphere Information Server administrator user syntax differs depending on the user registry that is configured in the application server.

Local OS on UNIX

Provide the UNIX user ID, such as "isadmin."

Local OS on Windows

COMPUTER_NAME\userid, such as MYSERVER\isadmin where MYSERVER is the name of the Microsoft Windows computer. If the Microsoft Windows computer is registered in a domain, the syntax might also be DOMAIN_NAME\userid. The name must be uppercase.

LDAP

The full distinguished name (DN) must be provided in the proper case. For more information on retrieving the DN, refer to LDAP distinguished name (DN) determination.