Configure WebSphere Portal to use DB2

View information on manually transferring data to the DB2 database you have installed and set up. Follow these steps to transfer WebSphere Portal, and Java Content Repository databases to DB2. As an alternative to the manual database transfer procedure described here, you can use the configuration wizard to complete the database transfer task.

Before you begin:

Ensure that the following prerequisites are met:


Installing DB2

Create users

Creating remote databases

Modifying database properties

Steps for transferring data to another supported database

  1. If you are running a type 2 connection, before transferring data edit the db2cli.ini file. Failure to follow these steps will cause the database transfer to hang at the task action-process-constraints.

    1. Locate the file C:\Program Files\IBM\SQLLIB\db2cli.ini.

    2. Add the following to the end of the file. Leave an empty line after ReturnAliases=0.

      [COMMON] DYNAMIC=1 ReturnAliases=0

  2. Open a command prompt and change to the directory profile_root/ConfigEngine.

  3. Enter the following commands to validate configuration properties.

    ConfigEngine.bat validate-database-driver -DTransferDomainList=release,customization,community,jcr,feedback,likeminds -DWasPassword=password

    ConfigEngine.bat validate-database-connection -DTransferDomainList=release,customization,community,jcr,feedback,likeminds -DWasPassword=password

  4. From the same command prompt as the previous steps, change to the directory profile_root\bin.

  5. Stop both WAS and the WebSphere Portal server:

    Option Description
    WAS stopServer.bat server1-username admin_userid -password admin_password
    WebSphere Portal stopServer.bat WebSphere_Portal-username admin_userid -password admin_password

  6. Transfer the database:

    1. cd profile_root/ConfigEngine.

    2. Enter the following command:

      ConfigEngine.bat database-transfer -DTransferDomainList=release,customization,community,jcr, feedback,likeminds -DWasPassword=password 

      If you have been storing data in IBM Derby for a long time, database transfer could fail with OutOfMemory exceptions. If database transfer fails, add the following property to the command in this step: ConfigEngine.bat database-transfer -DDbtJavaMaxMemory=1536M -DWasPassword=password

    3. After running this task, a message is added to the log files to verify that this task was successful. Check the log files. If the configuration fails, verify the values in the,, and files and then repeat this step.

  7. After transferring the database tables, perform a reorg check to improve performance. Perform this step for each database alias in the property file.

    1. Connect to a database with the following command:

      db2 connect to database_alias user
      db2admin_userid using

      Additional options might be required if additional security has been installed. Refer to DB2 Universal Database commands by example for links to the command reference.

    2. After it is connected, run the following command from the DB2 prompt:

      db2 reorgchk update statistics on table all > xyz.out

    3. Look in the reorg column for entries marked with a * (star or asterisk) in the file xyz.out. For each line with a *, note the tablename and run the following command for each tablename:

      db2 reorg table tablename
      db2 terminate
      db2rbind database_name -l
      db2rbind.out -u
       -p password

    4. The output file db2rbind.out is only created when there is an error for the db2rbind command.

  8. Change to the directory profile_root\bin.

  9. Enter the following command to start the WebSphere Portal server: startServer.bat WebSphere_Portal

If you have performed database transfer in a clustered environment, explicitly copy the profile_root\PortalServer\jcr\lib\com\ibm\icm\ file from the primary node on which the database-transfer task was processed to all secondary nodes. This ensures that the secondary nodes have the new JCR database values specified in the file.

  1. Stop the portal server on the secondary node.

  2. Copy the profile_root\PortalServer\jcr\lib\com\ibm\icm\ file from the primary node and replace the file on the secondary node with the new file from the primary node.

  3. Start the portal server on the secondary node.

Parent topic:

Set up a remote DB2 database

Previous topic:

Configure JCR collation support

Next topic:

Configure DB2 for large file handling in Web Content Management