Upgrade Agent Factory

Upgrade Agent Factory by following the procedure for your deployment. See Upgrade an Installation Kit Deployment, Upgrade Your Marketplace Instance, or Upgrade a Container Image Deployment.

Agent Factory 26.10 supports upgrades from the previous three releases: 26.7, 26.4, and 25.3.

Before upgrading to 26.10, verify that the existing PAF runtime database user retains the base grants required for Agent Factory installation, including CREATE JOB, and has these additional grants for NL2SQL and A2A:

If any grant is missing, ask an authorized DBA to apply it before you start the upgrade. For the SQL, see Example Grants for a PDB or Non-Autonomous Database or Autonomous Database Grant Syntax.

Upgrade an Installation Kit Deployment

  1. Download the latest kit according to your environment specifications. See Download Kit.

  2. Create a directory and copy the downloaded tar.gz into the directory. Please note that this directory should not be the previous installation staging directory.

    Note: For Marketplace deployments, run sudo setenforce permissive before running interactive_install.sh. This temporarily sets SELinux to permissive mode, allowing the Podman build to proceed without being blocked. This change applies only to the current runtime and does not modify the permanent SELinux configuration. Use it only for the duration of the upgrade.

    cd <directory where the zip was copied>
    tar xzf <installer>.tar.gz
    bash interactive_install.sh --reset
    bash interactive_install.sh

    Successful Agent Factory 26.10 upgrade terminal output

  3. Log in using the application URL. A version upgrade notification should pop up, confirming that the update was successful.

    Version Upgrade

See Upgrade Troubleshooting for upgrade-related FAQs.

Upgrade Your Marketplace Instance

Follow these steps to upgrade your Marketplace instance.

  1. Download the latest installation kit. See Download Kit.

    The filename oracle_agent_factory_<version>_<architecture>.tar.gz varies by version and architecture. Replace <version> and <architecture> with the appropriate values for your release.

  2. Generate and save a download token, and then download the corresponding wget.sh script.

    Make sure to select the package that matches your VM architecture, ARM or x86. Review your VM details page or contact your tenancy administrator if you are unsure.

  3. Copy the downloaded wget.sh file to your VM using scp, or copy and paste its contents directly.

    scp -i <path_to_private_key> wget.sh opc@<public_ip>:~
  4. Connect to the VM.

    The following command keeps the SSH session alive, so the upgrade is less likely to be interrupted:

    ssh -i <path_to_private_key> -o ServerAliveInterval=60 -o ServerAliveCountMax=5 opc@<public_ip>
  5. Create a new staging directory for the upgrade and grant access to the installation user.

    sudo mkdir -p /u01/staging_upgrade/
    sudo chown opc:opc /u01/staging_upgrade/
    cd /u01/staging_upgrade/
  6. Execute the downloaded wget.sh script.

    You are prompted for the previously generated token.

    bash ~/wget.sh

    This command downloads the binary file into the current directory.

  7. Extract the installation kit and start the installer.

    tar -xzf oracle_agent_factory_<version>_<architecture>.tar.gz
    sudo setenforce permissive
    ./interactive_install.sh

    When prompted for the staging location, enter the new staging directory you created earlier, such as /u01/staging_upgrade.

The installer detects the existing installation and performs the upgrade while preserving your configuration and data.

Upgrade a Container Image Deployment

Upgrade an image deployment with the new image and the existing application volume. Keep the volume contents and database users.

  1. Confirm that the runtime database user has the grants listed in Create the Database Users.

  2. Pull the target image and stop every Agent Factory container connected to the same database. Keep the database running. Repeat the stop command for any other Agent Factory containers connected to that database.

    podman pull <target-image-reference>
    podman stop <existing-container>
  3. Start a new container with the existing application volume and the upgrade command. Replace the volume name with your deployment’s volume name.

    podman run -d \
      --name oracle-applied-ai-upgraded \
      --network bridge \
      -p 0.0.0.0:8080:8080 \
      -v agentfactory_selfcontained_mount:/mount:Z \
      <target-image-reference> upgrade

    If an encrypted database wallet needs a password that has not already been saved, add --secret agent_factory_db_wallet_password. See Wallet Mode. Retain any proxy or network settings required by your deployment.

  4. Monitor the upgrade until it completes:

    podman logs -f oracle-applied-ai-upgraded
  5. Open the application and sign in with your existing credentials.

Validate and Recover a Kit or Marketplace Upgrade

After the installer completes, validate the upgraded deployment before returning it to users.

Important: For upgrades from release 26.4 or earlier to release 26.7 or later, Agent Factory disables SSO if it was previously enabled to complete the required role transition. Agent Factory redirects users to the local login page. Sign in as a local administrator and re-enable SSO in Configure Single Sign-On (SSO).

  1. Open https://<host>:8080/agentFactory/ and confirm that the login page loads.
  2. Sign in as an administrator.
  3. Confirm that the version upgrade notification appears.
  4. Open LLM Management and test the default generative and embedding model configurations.
  5. Open Data Sources and confirm that existing sources are present.
  6. Run a simple published agent or Agent Builder flow.
  7. Generate a diagnostics bundle. See Collect Diagnostics.

If the upgrade fails, keep the new staging directory and the previous staging directory intact until diagnostics have been collected. From the new staging directory, run:

make diagnose

Then review the generated diagnostics archive or provide it to support.