InfoCenter Home >
3: Migration overview >
3.5: Switching administrative databases >
3.5.1: Using the database conversion assistant to switch administrative databases

3.5.1: Using the database conversion assistant to switch administrative databases

The database conversion assistant helps you modify the WebSphere administrative server configuration in order to switch from one administrative database to another. This user-friendly editor leads you through the necessary changes to the database configuration information stored in the administrative server configuration and setupcmdline files.

  The assistant helps you convert database settings. You must also move database content from the old database to the new database. (You can use the XMLConfig administrative client to do so automatically). Use the database migration assistant as part of the overall procedure described in article 3.5.

Obtaining and running the database conversion assistant

  1. Create a directory named DBUpgrade. Make sure it is a subdirectory of the WebSphere directory in the product installation_root.
  2. Obtain the database conversion assistant file (a ZIP or JAR) from the among the tools offered on the Support page of the product Web site.
  3. Extract the database conversion assistant file contents into the DBUpgrade directory.
  4. If using Windows NT, add the following to the PATH environment variable:
    product_installation_root\jdk\bin
    
  5. Run the assistant:
    •   dbupgrade.sh
    •   dbupgrade.bat
  6. Follow the instructions in the assistant interface.

Troubleshooting

The tool might fail sometimes due to some extra entries in the CLASSPATH or PATH environment variables. In this case, do the following:

  1. Open a command prompt window and set CLASSPATH and PATH as follows (so there are no other entries in the CLASSPATH or PATH):
    set CLASSPATH=product_installation_root\jdk\lib\tools.jar
    set PATH=product_installation_root\jdk\bin
    
  2. Run the tool from the command prompt. Once the window is closed, the CLASSPATH and PATH settings will reset to the system settings.
Go to previous article: Switching administrative databases Go to next article: Settings to change when switching administrative databases

 

 
Go to previous article: Switching administrative databases Go to next article: Settings to change when switching administrative databases