---
title: Upgrade
description: This guide covers common aspects of upgrading an AM deployment, whether you are moving to a new maintenance release, upgrading to a new major release, or migrating from a legacy release to a newer AM release.
component: pingam
version: 7.2
page_id: pingam:upgrade-guide:preface
canonical_url: https://docs.pingidentity.com/pingam/8.1/upgrade/preface.html
llms_txt: https://docs.pingidentity.com/pingam/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
page_aliases: ["index.adoc"]
superseded_by: https://docs.pingidentity.com/pingam/8.1/upgrade/preface.html
---

# Upgrade

This guide covers common aspects of upgrading an AM deployment, whether you are moving to a new maintenance release, upgrading to a new major release, or migrating from a legacy release to a newer AM release.

Release levels, and how much change to expect in a maintenance, minor, or major release, are defined in [ForgeRock product release levels](https://docs.pingidentity.com/pingam/release-notes/stability.html#release-levels). Release levels are identified by version number.

|   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| - | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|   | AM supports several versions of the web and Java agents, so you don't usually need to upgrade your agents when you upgrade AM.You can find information on the supported AM versions in [Web Agents](https://docs.pingidentity.com/web-agents/release-notes/requirements.html#am-requirements) or [Java Agents](https://docs.pingidentity.com/java-agents/release-notes/requirements.html#am-requirements).Learn more about upgrading web and Java agents in the [Web Agents documentation](https://docs.pingidentity.com/web-agents/2024.11/upgrade/preface.html) or the [Java Agents documentation](https://docs.pingidentity.com/java-agents/2024.11/upgrade/preface.html). |

[icon: check-square, set=fad, size=3x]

#### [Before you upgrade](upgrade-planning.html)

Review the tasks you need to complete before upgrading AM.

[icon: server, set=fad, size=3x]

#### [Upgrading servers](upgrade-servers.html)

Learn, step by step, how to upgrade the AM core services.

[icon: plus, set=fad, size=3x]

#### [Upgrading components](upgrade-components.html)

Review components and services that you might need to upgrade or reconfigure.