Creating IBM DB2 databases manually

Create IBM® DB2® databases with SQL scripts instead of using the HCL 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, located in the HCL_Connections_Install\HCLConnections\native\connections.sql.zip\connections.sql directory of the HCL Connections setup directory or installation media. Extract this file before proceeding. When extracted, the SQL scripts are located in the HCL_Connections_Install/HCLConnections/native/connections.sql/application_subdirectory directory of the HCL 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.

Notes:

If you are using Linux™ on IBM System z® with the DASD driver, the SQL scripts are located in the HCL_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 HCL 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:

In the SMIT tool, select System Storage Management>File System>Add/Change/Show/Delete File Systems
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.

Attention: HCL Connections™ 6.5 install wizard does not create the database for the Community Highlights / Connections Engagement Center (ICEC) application. You will need to manually run the SQL scripts that are provided with HCL Connections. Refer to the procedure in this section to create the ICEC database.

Notes:

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.

Notes:

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 HCL 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:

Procedure

Optional: (Only required if the database server and HCL Connections are installed on different systems.) Copy the HCL Connections SQL scripts to the DB2 database system. Authorize a user ID that can create the databases.
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.
Notes:
- If you created multiple database instances, specify the user ID for the first instance.
- The default administrative ID for Microsoft Windows is db2admin.
Start the DB2 command line processor in command mode and enter the following command:
db2start
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
For Home page, run the following script:
db2 -td@ -vf connections.sql/homepage/db2/initData.sql

For Activities, Communities, Community Highlights / Connections Engagement Center (ICEC), 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 -tvf  connections.sql/icec/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.

Run the following command to grant access privileges to the lcuser account for the Activities, Communities, Community Highlights / Connections Engagement Center (ICEC), 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 -tvf  connections.sql/icec/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

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

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

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.
Close the DB2 command line processor.
Optional: When you install HCL 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.