You are here

Configuring a DB2 database

This section describes how to configure a DB2 database for use with Alfresco.
  1. Install the DB2 database connector. The database connector allows DB2 database to talk to the Alfresco server.
    1. Obtain a copy of db2jcc4.jar. This should be available in the /java or /jdbc directory of your DB2 installation.
    2. Copy the JAR file into the <TOMCAT_HOME>/lib directory for Tomcat 6.
  2. Increase the available connections in DB2.
    1. Follow these instructions to increase the max_connections setting to 275: Setting max_connections
    2. Run the following command:

      update dbm cfg using max_connections 275 automatic
  3. Create a database named alfresco.

    Create the database with a larger page size of 32K. Ensure that the database is created with the UTF-8 character set.

    If you do not create the database with these settings, you will see error SQL0286N (sqlCode -286, sqlstate 42727) because the schema is created for tables that do not fit the page size.

  4. Ensure that the cur_commit database configuration parameter is set to ON.

    For new databases, this parameter is set to ON, by default. If you have upgraded from a previous DB2 release, you must set this parameter manually.

  5. Create a user named alfresco and set the associated schema.

    This user must have write permissions on all tables and sequences.

    DB2 only integrates with the operating system security. You can not add a database user with a password in the DB2 database as you can with some other databases, for example the Oracle database.

  6. Open the <classpathRoot>/ file.
  7. Locate the following line:


  8. Edit the line with an absolute path to point to the directory in which you want to store Alfresco data. For example: dir.root=C:/Alfresco/alf_data
  9. When using a schema which does not match the DB2 username, set the currentSchema and hibernate.default_schema properties as shown below:

    # DB2 connection
    Note: Remember to uncomment the database connection properties.
  10. Set the other database connection properties.
    Note: Remember to uncomment the database connection properties.
  11. Save the file without the .sample extension.
  12. Restart the Alfresco server.

    If you receive JDBC errors, ensure the location of the DB2 JDBC drivers are on the system path, or add them to the relevant lib directory of the application server.