AAI 26.0.0 Upgrade Documentation — Article Index

Products

• Automation Analytics & Intelligence

Issue/Introduction

This is a single starting point for all of the AAI 26.0.0 upgrade documentation. Bookmark this one article — it links out to every article in the set below, each with a short summary of what it covers, so you can quickly find the one that answers your question.

New to terms used across this documentation set? Several articles below use terms like certificate authority, keystore, or PKI without redefining them.
See: AAI Glossary — Terms Used in the 26.0.0 Upgrade Documentation

Environment

• Applies to the entire AAI 26.0.0 upgrade documentation set — both VM/traditional-installer and Kubernetes/OpenShift deployments. Environment-specific differences are called out within each individual article, not here.

Cause

Not applicable. This is a navigation index, not a resolution to a specific reported problem.

Resolution

What to Know Before Upgrading to AAI 26.0.0

• Background overview of what's changing architecturally in 26.0.0 — start here if you just want to understand the upgrade before doing anything
• Summary of networking and certificate changes
• Summary of changed defaults and runtime behavior
• Summary of API and UI changes
• Summary of the new service fleet and database schema additions

Pre-Upgrade Checklist for AAI 26.0.0

• Concrete, actionable checklist to complete before your upgrade window
• Audit your own automation for two breaking API changes
• Certificate SAN check (VM only) to confirm your existing HTTPS certificate has what it needs
• Configuration backup steps
• Client-certificate connector planning for the same maintenance window
• Memory/capacity planning for the new default footprint

Connector and Integration Impact of Upgrading to AAI 26.0.0

• Why every connector certificate breaks after the upgrade
• Step-by-step connector certificate regeneration and deployment
• Connector SAN allowlist check
• Verification steps to confirm a connector is reconnected

Where Did My Logs and Configuration Go? — AAI 26.0.0 Post-Upgrade Orientation

• Post-upgrade orientation for finding your logs (Part 1)
• Post-upgrade orientation for finding your configuration (Part 2)
• Written for reorienting yourself immediately after the upgrade completes

AAI 26.0.0: Directory and File Structure Map

• One-page map of where everything lives in 26.0.0 — a quick visual reference, not a walkthrough
• Full VM directory tree, including both configuration directories and the new external-services and log directories
• What "no single directory tree" means on Kubernetes/OpenShift, and where the real source of truth for settings lives instead
• The two things people most often miss: the old configuration directory didn't move, and where the JVM options file actually lives now

AAI: Log / Configuration Gathering Checklist

• Straight collection checklist — what to check and what to grab before opening or working an AAI support case, without the "why did this move" background
• Covers both VM and Kubernetes/OpenShift, with the specific logs and configuration files named per service
• Includes a subsection for the IWS z Connector's own logs and configuration

Ports, HTTPS, and Certificates in AAI 26.0.0 — What Changed

• The new port map
• The three independent certificate systems, explained
• Certificate SAN requirement to check before upgrading, if HTTPS is already in use
• What the upgrade automates vs. what you must still do manually
• How to enable HTTPS for the first time on 26.0.0
• Why you shouldn't trust a quoted certificate validity period, plus quick self-checks

What's New in AAI 26.0.0 — Cost Model and Data Insights

• The new Cost Model feature: cost centers, cost ownership, job association rules, and chargeback reporting
• How Cost Model access is granted (through your identity/access management system, not an AAI setting)
• New AI-assisted insight types: AI Data Insight, Chargeback Insight, and BAMP
• What this means for space/capacity planning

AAI Glossary — Terms Used in the 26.0.0 Upgrade Documentation

• Plain-language definitions of security and certificate terms (TLS, PKI, CA, keystore, truststore, and more)
• Plain-language definitions of deployment and architecture terms (JBoss, WAR, Pod, Helm, PVC, and more)
• The shared reference every other article in this set links to

Additional Information

To speak with a customer representative or a Support Engineer see Contact Support. Scroll to the bottom of the page and click on the respective region.