Database transfer: Set up JCR collation | HCL Digital Experience

Manual steps from the Configuration Wizard are included in HCL Digital Experience Product Documentation for reference and for advanced users. The procedure includes variables and steps for different databases. When you use the wizard to configure your deployment, it replaces the variable with information that you provided in the wizard. It also shows only the steps that are specific to your environment. The instructions that the wizard generates are specific to your environment.

About this task

Note: All steps for all database environments are included without consideration for your environment. Use the Configuration Wizard to generate custom instructions for your environment.

JCR collation is recommended when the language locales of your users do not natively collate correctly in the DB2 database and when language locale correct ordering is important.

Procedure

Stop the HCL server.

Copy files from the HCL server to a temporary directory on the DB2 server.

${WpsInstallLocation}/jcr/wp.content.repository.install/lib/wp.content.repository.install.jar

${WasUserHome}/PortalServer/jcr/config/registerCollationUDFTemplate.sql

Set up collation on the database where the JCR domain is located. Change to this directory:
```
db2_instance_owner_home/sqllib/function
```

Enter this command:

db2home/sqllib/java/jdk/bin/jar -xvf ${wf.ejp.collationTempDir}/wp.content.repository.install.jar icm/CollationUDF.class

Change to the temporary directory where you copied the files in a previous step. For example, you can use this temporary directory on the DB2 server:
```
${wf.ejp.collationTempDir}
```
Open the file registerCollationUDFTemplate.sql, and change the multiple

Connect to the JCR database.

db2 connect to ${jcr.DbName} user ${jcr.DBA.DbUser} using ${jcr.DBA.DbPassword}

Enter this command to run the script:

db2 -tvf ${wf.ejp.collationTempDir}/registerCollationUDFTemplate.sql

Disconnect from the JCR database.
Restart the DB2 instance.
Verify that the UDF is registered properly. Log in as ${jcr.DbUser}.
Open a DB2 terminal window.

Connect to the database that contains JCR domain:

db2 connect to ${jcr.DbName} user ${jcr.DbUser} 
       using ${jcr.DbPassword}

When you have connected to the JCR database, verify that the UDF is registered properly. To verify the UDF registration, run this command:
```
db2 values ${jcr.DbSchema}.sortkeyj('abc','en')
```
Disconnect from the DB2 terminal window:
```
db2 disconnect all db2 terminate
```
Start the HCL server.
Update the collation configuration options. Log in to the WebSphere Integrated Solutions Console.
Go to Resources > Resource Environment > Resource Environment Providers > JCR ConfigService PortalContent > Custom properties.
Add or update the following properties as necessary:
- Enable/Disable collation support for all DB2 platforms(LUW, Z, I), this is disabled (false) by default
  - Name: jcr.query.collation.db2.enabled
  - Value: true
  - Type: java.lang.String
- Name: jcr.query.collation.en
  - Value: en
  - Type: java.lang.String
- Name: jcr.quiery.collation.sv
  - Value: sv
  - Type: java.lang.String
- Name: jcr.quiery.collation.zh
  - Value: zh
  - Type: java.lang.String
- Name: jcr.quiery.collation.de
  - Value: de
  - Type: java.lang.String
- Name: jcr.quiery.collation.da
  - Value: da
  - Type: java.lang.String
- Name: jcr.quiery.collation.hu
  - Value: hu
  - Type: java.lang.String
- Name: jcr.quiery.collation.jp
  - Value: jp
  - Type: java.lang.String
To apply your settings, stop and restart HCL Portal.