Overview

About APM Upgrade

The APM Upgrade document provides information on how to upgrade the existing APM version to a newer latest version. These instructions assume that you upgrade basic APM system architecture first and then complete the steps for upgrading the modules. For information on upgrade instructions for specific component or module, refer to the specific information using the left navigation.

Terms Used in this Documentation

The following table lists the common terms that are used throughout the database upgrade documentation and their definitions.

Term

Definition

Examples

Database content

Items that exist in the APM database are displayed in some form via the APM interface. There are two versions of database content that exist in your database at a given time:

  • Baseline content: The database content that matches the baselineAPM database. With the exception of rules and Catalog items, you cannot view baseline content in the APM interface. This content is stored in a separate location from the corresponding public version of that content.

  • Public content: The database content that you interact with in the APM interface. This content may be the same as the baseline content or it may be the baseline content plus your customizations.

Queries

Entity families

Customized database content

Baseline database content that has changed in your database.

Added a field to a baseline datasheet.

Modified an Entity family description.

Baseline database content

The database content as it is developed and delivered to you in the baseline APM database.

Query in the baseline Catalog folder

Equipment family

Custom content

Database content that exists only in your database and not in the baseline APM database.

New query

New Entity family and fields

Pre-upgrade public version

In the context of the upgrade process, pre-upgrade public version refers to the public version of the database content that exists in your database (prior to upgrading it to the later version).

Query in the Public Catalog folder

Datasheet

(applies whether or not the query or datasheet has been customized)

Pre-upgrade baseline version

In the context of the upgrade process, pre-upgrade baseline version refers to the baseline version of the database content that exists in your database (prior to upgrading it to the later version).

Query in the Baseline Catalog folder.

Datasheet with no customizations

 

Content protection

The process by which the custom changes that you apply to baseline database content are preserved during the database upgrade process. Note that, after you apply changes to baseline database content, the database content is considered customized database content.

Field added to a baseline datasheet in your pre-upgrade database also appears in your upgraded database.