Creating IBM DB2 databases manually

Create IBM® DB2® databases with SQL scripts instead of using the IBM Connections database wizard.

Before you begin

Use this procedure if you do not want to use the database wizard to create your databases.

The SQL scripts are located in a compressed file called connections.sql_*.zip, located in the IBM_Connections_Install/IBMConnections/native directory of the IBM Connections setup directory or installation media. Extract this file before proceeding. When extracted, the SQL scripts are located in the IBM_Connections_Install/IBMConnections/native/connections.sql/application_subdirectory directory of the IBM Connections set-up directory or installation media, where application_subdirectory is the directory that contains the SQL scripts for each application.

If you are using AIX®, see the note in the Preparing the database wizard topic about decompressing TAR files.

  • If you are using Linux™ on IBM System z® with the DASD driver, the SQL scripts are located in the IBM_Connections_Install_s390/IBMConnections/connections.s390.sql directory.
  • If you are using Linux on IBM System z with the SCSI driver, back up the connections.s390.sql directory and rename the connections.sql directory to connections.s390.sql.

If the database server and IBM Connections are installed on different systems, copy the SQL scripts to the system that hosts the database server.

(AIX only) Configure the AIX system that hosts the DB2 databases to use the enhanced journaled file system (JFS2), which supports file sizes larger than 2 GB. To enable large files in the JFS system, complete the following steps:
  1. In the SMIT tool, select System Storage Management>File System>Add/Change/Show/Delete File Systems
  2. Select the file system type you want to use and specify other characteristics as wanted. If you use a Journaled File System, set the Large File Enabled setting to true.
See the AIX documentation for more options.
  • When you are creating a database either with the database wizard or SQL scripts, you must log into the system where the database is hosted with the database administrator account. The default values for DB2 are db2admin on Microsoft™ Windows™, and db2inst1 on Linux and AIX. For Oracle, the default value on AIX and Linux is oracle, and system administrator on Windows. For SQL Server, the default value is the system administrator.

(DB2 only) If you use only one database instance and if that instance includes other databases besides IBM Connections, configure the numdb parameter to match the total number of databases on the instance. For more information, go to the numdb webpage in the DB2 information center.
  • If you migrated from IBM Connections 4.5 or 5.0, the numdb parameter was set to 14, the maximum number of IBM Connections 4.5 or 5.0 databases. If the instance has additional databases, increase the value of the numdb parameter to match the total number of databases on the instance. To change the parameter, enter the following command:


    where nn is a number of databases.

  • Before removing (or dropping) a database, stop Connections first to ensure that no database connection is in use; otherwise you will not drop the user and the database removal will not occur.
  • If you run dbWizard.bat but the database wizard does not launch, check whether you have 32-bit DB2 installed. You need to have 64-bit DB2 on a 64-bit system.

About this task

You must perform this task for each IBM Connections application that you are installing.
Note: To capture the output of each command to a log file, append the following parameter to each command: >> /file_path/db_application.log

where file_path is the full path to the log file and application is the name of the log file. For example:

db2 -td@ createDb.sql >> /home/db2inst1/db_activities.log

Ensure that you have write permissions for the directories and log files.

To create the application databases, complete the following steps:


  1. Optional: (Only required if the database server and IBM Connections are installed on different systems.) Copy the IBM Connections SQL scripts to the DB2 database system. Authorize a user ID that can create the databases.
  2. Log in to the DB2 database system with the user ID of the owner of the database instance. The user ID must have privileges to create a database, a tablespace, tables, and indexes.
    • If you created multiple database instances, specify the user ID for the first instance.
    • The default administrative ID for Microsoft Windows is db2admin.
  3. Start the DB2 command line processor in command mode and enter the following command:


  4. For Home page and Profiles, change to the directory where the SQL scripts for each application are stored, and then enter the following command to run the script:

    db2 -td@ -vf connections.sql/homepage/db2/createDb.sql

  5. For Home page, run the following script:

    db2 -td@ -vf connections.sql/homepage/db2/initData.sql

  6. For Activities, Communities, Blogs, Bookmarks, Files, Forums, Mobile, Push Notifications, and Wikis, change to the directory where the SQL scripts for each application are stored, and then enter the following command to run the script:
    db2 -td@ -vf connections.sql/activities/db2/createDb.sql
    db2 -td@ -vf connections.sql/communities/db2/createDb.sql
    db2 -td@ -vf connections.sql/blogs/db2/createDb.sql
    db2 -td@ -vf connections.sql/dogear/db2/createDb.sql
    db2 -td@ -vf connections.sql/files/db2/createDb.sql
    db2 -td@ -vf connections.sql/forum/db2/createDb.sql
    db2 -td@ -vf connections.sql/mobile/db2/createDb.sql
    db2 -td@ -vf connections.sql/pushnotification/db2/createDb.sql
    db2 -td@ -vf connections.sql/wikis/db2/createDb.sql
    Note: The SQL scripts for Bookmarks are stored in the dogear directory.
  7. Run the following command to grant access privileges to the lcuser account for the Activities, Communities, Blogs, Bookmarks, Dogear, Files, Forums, Home page, Mobile, Profiles, Push Notifications, and Wikis databases:
    db2 -td@ -vf connections.sql/homepage/db2/appGrants.sql
    db2 -td@ -vf connections.sql/profiles/db2/appGrants.sql
    db2 -td@ -vf connections.sql/pushnotification/db2/appGrants.sql
    db2 -td@ -vf connections.sql/activities/db2/appGrants.sql
    db2 -td@ -vf connections.sql/communities/db2/appGrants.sql
    db2 -td@ -vf connections.sql/blogs/db2/appGrants.sql
    db2 -td@ -vf connections.sql/dogear/db2/appGrants.sql
    db2 -td@ -vf connections.sql/files/db2/appGrants.sql
    db2 -td@ -vf connections.sql/forum/db2/appGrants.sql
    db2 -td@ -vf connections.sql/mobile/db2/appGrants.sql
    db2 -td@ -vf connections.sql/wikis/db2/appGrants.sql
  8. Run the following commands to generate statistics for the Home page database:
    db2 -td@ -vf connections.sql/homepage/db2/reorg.sql
    db2 -td@ -vf connections.sql/homepage/db2/updateStats.sql
  9. Run the following commands to create Calendar tables in the Communities database:
    db2 -td@ -vf connections.sql/communities/db2/calendar-createDb.sql
    db2 -td@ -vf connections.sql/communities/db2/calendar-appGrants.sql
  10. If you plan to use the Metrics application, run the following commands to create the Metrics and Cognos® databases:
    db2 -td@ -vf connections.sql/metrics/db2/createDb.sql
    db2 -td@ -vf connections.sql/metrics/db2/appGrants.sql
    db2 -td@ -vf connections.sql/cognos/db2/createDb.sql
    db2 -td@ -vf connections.sql/cognos/db2/appGrants.sql
    Note: The first two of these commands create the Metrics database and the following two commands create the Cognos database. The Cognos database tables are created when you start the Cognos BI Server for the first time.
  11. If you plan to use IBM Connections Content Manager (CCM), run the following commands to create the CCM databases:
    db2 -td@ -vf connections.sql/library.gcd/db2/createDb.sql
    db2 -td@ -vf connections.sql/library.gcd/db2/appGrants.sql
    db2 -td@ -vf connections.sql/library.os/db2/createDb.sql
    db2 -td@ -vf connections.sql/library.os/db2/appGrants.sql
    Note: Two databases will be created if you want to install IBM Connections Content Manager databases.
  12. Close the DB2 command line processor.
  13. Optional: When you install IBM Connections, the JDBC configuration page of the installation wizard asks you to provide a user ID and password for the Application User. The user ID that you specify on that page must have read and write access to the database. You can provide the user ID of an administrative user or you can create a dedicated user ID with fewer privileges. See the Creating a dedicated DB2 user topic for more information.

What to do next

(DB2 for Linux on System z only.) To improve database performance, enable the NO FILE SYSTEM CACHING option. For more information, see the Enabling NO FILE SYSTEM CACHING for DB2 on System z topic.