Zoomdata Version

Upgrading your Kerberized Environment to Version 2.6 Troubleshooting

When upgrading to version 2.6 from Zoomdata versions 2.3-2.5 and you use Kerberos Authentication for your PostgreSQL metadata database, you may run into issues when trying to upgrade your environment. Even though Zoomdata is able to connect to PostgreSQL, the application fails to complete a full upgrade as the zoomdata-launcher cannot be started.

If you are running in to this issue, follow the steps below for guidance on how to resolve these issues before attempting another upgrade.

Before upgrading, you need to do the following:

  • Create the jaas.config file
  • Append your zoomdata.propeties file with your Kerberos information
  • Append your zoomdata.env file with your Kerberos information
  • Append your zoomdata.jvm file with your Kerbersos information

Create the JAAS Configuration File

You need to create a jaas.config file with the information that corresponds to the Kerberos credentials for your environment. This lets the zoomdata.jvm file know what particular login modules to use. For more information about JAAS files, see Oracle's documentation.

  1. On the server you want to upgrade, create the jaas.config file in the install directory. This file must be placed in your /conf/ file folder. For example, /<install-directory>/conf/gss-jaas.config.
  2. Open the file to edit.

    sudo vi /conf/gss-jaas.config
  3. Add the following to the file:
  4. Client
    com.sun.security.jgss.initiate {
    com.sun.security.auth.module.Krb5LoginModule required
    useKeyTab=true
    keyTab="<path-to-keytab-file>" useTicketCache=true
    principal="kerberos-principal"
    doNotPrompt=true
    debug=true;
    };
  5. Save and exit the file.

Append your zoomdata.properties File

  1. On the server you want to upgrade, open your zoomdata.properties file.
  2. sudo vi /etc/zoomdata/zoomdata.properties
  3. Add the following to the file:
  4. spring.datasource.connection-properties:jaasApplicationName=com.sun.security.jgss.initiate
    spring.datasource.url=jdbc:postgresql://<your-kerberized-pg-host>:yourportnumber/zoomdata
    spring.datasource.username=<your-kerbersos-postgres-mapped-username>
  5. Save and exit the file

Append your zoomdata.env File

  1. On the server you want to upgrade, open you zoomdata.env file.
  2. sudo vi /etc/zoomdata/zoomdata.env
  3. Add the following to the file:
  4. KERBEROS_KEYTAB=<your-key-tab-file>
    KERBEROS_PRINCIPAL=<your-principal-name>
    KERBEROS_CONFIG=<your-kerberos-config-file>
  5. Save and exit the file.

Append your zoomdata.jvm File

  1. On the server you want to upgrade, open your zoomdata.jvm file.
  2. sudo vi /etc/zoomdata/zoomdata.jvm
  3. Add the following to the file:
  4. -Djava.security.auth.login.config=<path-to-jaas-config-file>
    -Djavax.security.auth.useSubjectCredsOnly=false
  5. Save and exit the file.
  6. Follows steps 1-9 to configure the zoomdata-scheduler. You need to change the properties for the following files:
    • scheduler.properties
    • scheduler.env
    • scheduler.jvm
  7. Once you have made the changes to the scheduler files, restart the Zoomdata Server.

Was this topic helpful?