Entrust distributes the cagw-util command-line utility for Creating a basic configuration with cagw-util and Normalizing a legacy configuration with cagw-util. See below for how to install and configure this tool.

Installing cagw-util

To install the cagw-util tool, extract the contents of the zipped distribution file in the Windows or Linux machine where you will run the tool. You can later transfer the generated files to the CA Gateway host.

Setting the Java path

If the Java path is not in your global settings, configure the JAVA_HOME variable using the following scripts.

Script

OS

Example

​bin/setenv.sh

​Linux

export JAVA_HOME=/usr/java/jdk-17.0.6

bin/setenv.bat

Windows

set JAVA_HOME=C:\Program Files\Java\jdk-17.0.6

Normalizing exceptional Camel Case keys

When Normalizing a legacy configuration with cagw-util, the tool can be instructed how to normalize exceptional Camel Case keys by making use of the strings listed in the following file.

conf/UpperCaseWords.txt

By default, this file contains the following lines.

DN
DNS
MSCA
AWS

Therefore, when normalizing to kebab-case, the utility formats subjectDNCache as subject-dn-cache instead of subject-d-n-cache. Edit this file to add additional exceptions.