Deployment

Review the Generation Availability Analysis data model to determine which relationship definitions you will need to modify to include your custom equipment and location families. Via Configuration Manager, modify the relationship definitions as needed.

This step is required only if you store equipment and location information in families other than the baseline Equipment and Functional Location families.

Specify additional system codes for families available in GAA.

By default, GE Digital APM provides a set of system codes for the families available in GAA. You can modify these default system codes or you can add new system codes.

This step is required. You must define the GAA Company to represent the functional location that you want to use in GAA. You must add a GAA Company at the highest level in the functional location, followed by GAA Plant and GAA Unit at the next subsequent levels.

You must define GAA Company, GAA Plant, and GAA Unit before you can start recording event data. GAA Company is stored in a GAA Company record.

You will need to repeat this step whenever you want to record data about any company that has not yet been identified within your system. Each GAA Company, however, can be associated with only one Hierarchy Level and vice-versa.

This step is required. You must define the GAA Plant to represent the functional location that you want to use in GAA. You must add a GAA Plant at the level next to GAA Company in the functional location, followed by GAA Unit at the next subsequent levels.

You must define a GAA Company before defining a GAA Plant, and a GAA Plant before defining a GAA Unit. GAA Plant is stored in a GAA Plant record.

You will need to repeat this step whenever you want to record data about any plant that has not yet been identified within your system. Each GAA Plant, however, can be associated with only one Hierarchy Level and vice-versa.

This step is required. You must define the GAA Unit to represent the functional location that you want to use in GAA. You must add a GAA Unit at the level next to GAA Plant in the functional location.

You must define a GAA Unit after defining a GAA Company and a GAA Plant. GAA Unit is stored in a GAA Unit record.

You will need to repeat this step whenever you want to record data about any unit that has not yet been identified within your system. Each GAA Unit, however, can be associated with only one functional location and vice-versa.

This step is required. When you add a GAA Unit record, a Unit Capacity record is automatically created with the values defined in the capacity related fields in the GAA Unit record. You must verify these values. As needed, you can modify the values in the available fields.

Using the file Meridium.DbUtility.GAAUpgradeUtility.exe stored in the installation folder (e.g., C:\Program Files\Meridium\Upgrade), set the following information:

• User ID in the userId field.
• Password in the password field.
• Database name in the datasourceId field.
• Regulatory organization (NERC, CEA) in the fuelReportingOrganization field.

This step is required.

In the Generation Company family:

• In the Enterprise 1 Code (MI_GMCOMPNY_ERP_01_CD_C) field, enter the Asset ID.
  Note: The Asset ID is the Entity ID of the functional location.
• In the Enterprise 1 Description (MI_GMCOMPNY_ERP_01_DESC_C) field, for the Primary Regulatory Organization, enter the value NERC or CEA.
  Note: If the Primary Regulatory Organization information has not been set, an exception error will occur.
• In the Enterprise 3 Code (MI_GMCOMPNY_ERP_03_CD_C) field, enter the Country ID.
  Note: In GE Digital APM V4.3.0.0.0, the Country field is required.

This step is required.

The GAA Company will receive the site key from the associated functional location.

• In the Enterprise 1 Code (MI_GM_PLANT_ERP_01_CD_C) field, enter the Asset ID.
  Note: The Asset ID is the Entity ID of the functional location.
• In the Enterprise 1 Description (MI_GM_PLANT_ERP_01_DESC_C) field, for the Primary Regulatory Organization, enter the value NERC or CEA.
  Note: If the Primary Regulatory Organization information has not been set, an exception error will occur.
• In the Enterprise 4 Code (MI_GM_PLANT_ERP_04_CD_C) field, enter the time zone for the Plant.
  Note: If the time zone information is invalid, an exception error will occur.

This step is required.

The GAA Plant will receive the site key from the associated functional location.

In the Generation Unit family:

• In the Enterprise 1 Code (MI_GM_UNIT0_ERP_01_CD_C) field, enter the Asset ID.
  Note: The Asset ID is the Entity ID of the functional location.
• In the Enterprise 1 Description (MI_GM_UNIT0_ERP_01_DESC_C) field, for the Primary Regulatory Organization, enter the value NERC or CEA.
  Note: If the Primary Regulatory Organization information has not been set, an exception error will occur.

This step is required.

The GAA Unit will receive the site key from the associated functional location.

The Primary Event and the Contributing Event will receive the site key from the GAA Unit.

Run the file GAAUpgradeUtility.exe.

This step is required.

During the upgrade:

• The states in the Incident Reporting Status field for Primary Events and the states in the Reporting Status field for Performance records will be updated to the new State Management.
• The queries in V3.6.0.0.0 will be replaced by the queries in V4.3.0.0.0.
• The Is Default field will be set to True for all records in the GAA Configuration family.
• The upgrade will map the existing fields in the Events and Performance data to the fields in the new families.
• The Event Details for all the Units will be generated.

After you complete this step, a log file is generated containing detailed information about the upgrade process.