Skip to main content

Step 1: Enable Tomcat Vault for Use by Tomcat

The Tomcat Vault jar file and scripts are already installed with Code Insight. The following procedure enables the Tomcat Vault utility for use by Tomcat to manage the password vault on the current Linux or Windows instance.

To enable Tomcat Vault for use by Tomcat, follow this procedure:

  1. Navigate to the /tomcat/conf/catalina.properties file in your Code Insight installation folder, and add the following lines:

    • org.apache.tomcat.util.digester.PROPERTY_SOURCE=org.apache.tomcat.vault.util.PropertySourceVault

    • org.apache.tomcat.util.digester.REPLACE_SYSTEM_PROPERTIES=true

    • This code loads the password vault at the startup of the Code Insight Core Server or Scan Server, using the configuration information you will define in Step 3: Initialize the Password Vault.

  2. (On a Linux instance only) Navigate to the /tomcat/lib directory in your Code Insight installation folder, and execute the following command to obtain the permissions needed to access tomcat-vault.jar: chmod 775 tomcat-vault.jar
  3. Navigate to the /tomcat/bin directory in your Code Insight installation folder.
  4. (On a Linux instance only) Execute the following command to obtain the permissions needed to access the vault script: chmod 775 vault.sh
  5. Open vault.sh (on Linux) or vault.bat (on Windows) for editing.
  6. Update the JAVA_HOME parameter with the absolute path of the JRE used by Code Insight, and then save the file.

    • If you are using the JRE shipped with Code Insight, update the parameter with the value shown. (This value is the default when Code Insight is shipped.)

    • In vault.sh on a Linux machine:

    • export JAVA_HOME=../../jre

    • In vault.bat on a Windows machine:

    • set JAVA_HOME=``..\..\jre

    • If you are not using the JRE shipped with Code Insight, replace the parameter’s default value with the absolute path to the system JRE.