Sun Java System Identity Pack 2005Q4M3 Installation |
D
Changing the Database Repository Password
If you are using an index database (such as MySQL, Oracle, Sybase, DB2, or SQL Server) to store index data, use the following procedure to:
- Change the repository password
- Update the application to use the modified repository information
Note It is recommended that you perform each of these steps in the order presented. If you change the repository password at a time other than when directed in this sequence, problems can occur. The examples used in this procedure are for a MySQL repository; some steps may vary depending on the specific repository used.
- Shut down your server.
- Archive a copy of the existing ServerRepository.xml file, in case you need to revert. By default, this file is located in $WSHOME/WEB-INF.
- Verify the existing repository:
lh setRepo -c
Identity Manager Pack responds with the current repository information; for example:
MysqlDataStore:jdbc:mysql://localhost/waveset
- Create a temporary file system repository location:
mkdir c:\tempfs
- Set Identity Manager Pack to use the temporary file system repository location:
lh setRepo -tLocalFiles -fc:\tempfs
LocalFiles:c:\tempfs- Change the password for your repository. This procedure depends on the mechanism provided by your repository provider. This example highlights steps for a MySQL database:
mysqladmin.exe -hlocalhost -uwaveset -poldpasswd password newpasswd
- Set the application to use the modified repository information:
lh setRepo -tMysql -ujdbc:mysql://localhost/waveset
-Uwaveset -PnewpasswdThe application responds with this warning:
WARNING: No UserUIConfig object in repository.
MysqlDataStore:jdbc:mysql://localhost/waveset
Note The warning message appears because the temporary file system that you pointed to has no contents. Ignore this message; after running the command, the temporary file system will no longer be needed.
- Verify the new repository value:
lh setRepo -c
The application responds with the new value:
MysqlDataStore:jdbc:mysql://localhost/waveset
- Restart the server and verify that you can log in.
- Remove the c:\tempfs temporary directory, and the ServerRepository.xml file that you archived in Step 2.