1. Applications Administration Guide
  2. Configuring OCI Generative AI Service Integration using Template File

Configuring OCI Generative AI Service Integration using Template File

This topic describes how to use the ociconfig-template.properties template file to configure OCI Generative AI integration, enable new Gen AI features, and manage configuration updates during installation and upgrades.

The ociconfig-template.properties template file contains the latest out-of-the-box (OOB) configuration required to support new Gen AI functionalities.

New Customers – Fresh Installation

  • The ociconfig-template.properties template file is delivered as part of the installation.

  • No ociconfig.properties file is created by default.

  • You must do the following:

    1. Copy and rename ociconfig-template.properties to ociconfig.properties.

    2. Modify ociconfig.properties as required.

    3. Use this file to enable and configure new Gen AI features.

New Customers – Subsequent Upgrades After Initial Installation

New Customers – Fresh Installation (subsequent upgrades with/without new feature changes)

  • The ociconfig-template.properties template file is delivered as part of the installation.

  • No modification/update to the ociconfig-template.properties template file is required.

  • If any future modifications are required in ociconfig.properties due to changes in ociconfig-template.properties, you must carefully review the updates and manually merge the necessary changes into ociconfig.properties by referring to the ociconfig-template.properties file.

Existing Customers – Upgrading to 26.6 and Later

Scenario 1: Upgrade from pre-26.6 to utilize new features

  • The ociconfig-template.properties template file is newly introduced and copied during the upgrade.

  • The existing ociconfig.properties template file will be deleted during the upgrade.

  • You must do the following:

    1. Take a backup of their existing ociconfig.properties file before the upgrade.

    2. After the upgrade, restore the file as ociconfig.properties.

    3. Modify/update ociconfig.properties to align with the new template.

    Note: This is a one-time impact during the upgrade to 26.6 (or later).

Scenario 2: Subsequent Upgrades (26.6 → 26.7 → 26.8 → 26.9 → 26.10, and later)

  • The ociconfig-template.properties template file is replaced with the latest OX9 version during each upgrade.

  • The existing ociconfig.properties file:

    • Is not modified or deleted.

    • Is treated as a customer-managed configuration file.

  • You must do the following:

    1. Review changes in the updated ociconfig-template.properties.

    2. Manually merge any required changes into ociconfig.properties by referring to ociconfig-template.properties.