Deploy Asset Health Manager

Deploy AHM for the First Time

Before You Begin

The following table outlines the steps that you must complete to deploy and configure this module for the first time. These instructions assume that you have completed the steps for deploying the basic system architecture.

These tasks may be completed by multiple people in your organization. GE Digital recommends, however, that the tasks be completed in the order in which they are listed.

If you are deploying this module in APM Now, before you begin completing these tasks, review the system requirements for this module to identify the supported features for this module in APM Now. Unless noted, all deployment tasks in the following table are applicable for the deployment of this module in APM Now.

Results

Step	Task	Notes
1	Assign Security Users to one or more of the Asset Health Manager Security Groups and Roles.	This step is required.
2	In the GE Digital APM Server, configure the Meridium Notification Service for AHM.	This step is required.
3	On the GE Digital APM Server, start or restart the Meridium Notification Service.	This step is required. You may review the log files for this service at C:\ProgramData\Meridium\Logs.
4	Start or restart the Meridium AHI Service (Asset Health Indicator Service).	This step is required. When you start the service, Health Indicator records are created or updated automatically based on health indicator and reading source records. You may review the log files for this service at C:\ProgramData\Meridium\Logs.
5	Review the AHM data model to determine which relationship definitions you will need to modify to include your custom asset families.	This step is required only if you store asset information in families other than the baseline Equipment and Functional Location families.
6	Determine the equipment or location whose overall health you want to evaluate, and make sure that an asset record exists in the database for this equipment or location and is included in the Asset Hierarchy configuration.	This step is required. If you are using custom asset families and relationships (see Step 5), make sure that the equivalent records and links exist in the database.
7	Configure Health Indicator Mapping records for each family that you want to use as a health indicator source, for which a baseline Health Indicator Mapping record does not already exist.	This step is required. Baseline Health Indicator Mapping records exist for the following health indicator source families: Measurement Location KPI OPC Tag Health Indicator
8	Link each asset record to the record(s) that you want to use as a health indicator source records.	This step is required.
9	For any specific records in a health indicator source family for which you do not want health indicators to be created, exclude these records from the automatic health indicator creation.	This step is optional.
10	Review the baseline event mappings and modify or create new mappings as necessary to customize the information that is displayed in the Events section in Asset Health Manager.	This step is optional. Refer to the Asset Health Manager end user help for more information about events.

About the Asset Health Services

When you deploy the Asset Health Manager, Process Data Integration, and Policy Designer modules together, the services used by each module interact with each other in various ways. This topic summarizes those services and describes a standard system architecture containing the components used by all three modules.

For a list of tasks that you must complete to deploy each module, refer to the deployment topics in the following areas:

Asset Health Manager (AHM)
Policy Designer
Process Data Integration (PDI) for the First Time

Services Summary

The following services are used by the Asset Health Manager, Process Data Integration, and Policy Designer modules:

Asset Health Indicator Service: Automatically updates the following field values in a Health Indicator record when reading values related to the health indicator source record (e.g., an OPC Tag or Measurement Location record) change:
- Alert Level
- Last Reading Date
- Last Char Reading Value (for records that accept character values)
- Last Numeric Reading Value (for records that accept numeric values)
This service also facilitates the automatic creation of Health Indicator records for configured sources.
Policy Trigger Service: When an input to a policy (i.e., an associated record in the GE Digital APM database or reading value in the process historian) changes or when a policy schedule is due, a message is added to the policy trigger queue.
Policy Execution Service: The Meridium Policy Execution Service handles the execution of policies. Specifically, the Policy Execution Service monitors a corresponding policy execution queue and executes the policy instances that are added to it.
Process Data Integration (PDI) Service: Monitors the subscribed tags (i.e., tags that are used in policies and health indicators or tags for which readings are being stored in the GE Digital APM database) and, when data changes occur on these tags, adds messages to the appropriate queues. This service also facilitates the automatic import and synchronization of tags from a configured process historian.

Standard System Architecture Configuration

The following diagram illustrates the machines in the GE Digital APM system architecture when the Policy Designer, Process Data Integration (PDI), and Asset Health Manager (AHM) modules are used together. This image depicts the standard configuration, where the OPC Server software and the Process Data Integration Service are on the same machine.

Note: In this example configuration, only one machine of each type is illustrated. Your specific architecture may include multiple GE Digital APM Servers, multiple OPC Servers, or multiple GE Digital APM Servers used for policy executions.

The following table summarizes the machines illustrated in this diagram and the software and services that you will install when you complete the first-time deployment steps for Asset Health Manager , Process Data Integration, and Policy Designer.

Machine	Software Installed	Asset Health Service Installed Automatically with Service Software
GE Digital APM Server	GE Digital APM Server software	Asset Health Indicator Service
		Policy Trigger Service
		Policy Execution Service
Process Data Integration Server, which also acts as the OPC Server	Process Data Integration Service software	Process Data Integration Service
	OPC Server software	N/A
Process Historian	Process historian software	N/A

Configure the Meridium Notification Service for AHM

About This Task

For the Asset Health Indicator service to work correctly, you must configure the Meridium Notification Service by modifying the file Meridium.Service.Notification.exe.config on all GE Digital APM Servers.

Procedure

On the GE Digital APM Server, navigate to the folder where the Meridium Notification Service files are installed. If you installed the software in the default location, you can locate these files in the folder C:\Program Files\Meridium\Services.
Open the file Meridium.Service.Notification.exe.config in an application that you can use to modify XML script (e.g., Notepad).
If you have not done so already, complete any necessary basic configuration for the Meridium Notification Service.
Within the <notification> tags, within the <notificationSettings> tags, uncomment the following text string (i.e., delete the ): <!– <add key="server4" serverType="external" endPointname="ahmService"/> -->
Within the <system.serviceModel> tags, within the <client> tags, uncomment the following text string (i.e., delete the ): 
Save and close the file.
Start or restart the Meridium Notification Service.

AHM Security Groups

The following table lists the baseline Security Groups available for users within this module, as well as the baseline Roles to which those Security Groups are assigned.

Important: Assigning a Security User to a Role grants that user the privileges associated with all of the Security Groups that are assigned to that Role. To avoid granting a Security User unintended privileges, before assigning a Security User to a Role, be sure to review all of the privileges associated with the Security Groups assigned to that Role. Also, be aware that additional Roles, as well as Security Groups assigned to existing Roles, can be added via Security Manager.

Security Group	Roles
MI AHI Administrator	MI Health Admin MI Strategy Admin MI Strategy Power
MI AHI User	MI Health Power MI Health User MI Strategy Admin MI Strategy Power MI Strategy User
MI AHI Viewer	None

Security Group

Roles

MI AHI Administrator

MI Health Admin

MI Strategy Admin

MI Strategy Power

MI AHI User

MI Health Power

MI Health User

MI Strategy Admin

MI Strategy Power

MI Strategy User

MI AHI Viewer

None

The baseline family-level privileges that exist for these Security Groups are summarized in the following table.

Family	MI AHI Administrator	MI AHI User	MI AHI Viewer
Entity Families
Checkpoint Task	View, Update, Insert	View, Update, Insert	View
Event Mapping	View, Update, Insert, Delete	View	View
Health Indicator	View, Update, Insert, Delete	View, Update	View
Health Indicator Mapping	View, Update, Insert, Delete	View	View
Health Indicator Value	View, Update, Insert, Delete	View	View
KPI	View	View	View
KPI Measurement	View	View	View
Measurement Location	View	View	View
Measurement Location Template	View	View	View
OPC Reading	View	View	View
OPC System	View	View	View
OPC Tag	View	View	View
Operator Rounds Allowable Values	View	View	View
Policy	View	View	View
Policy Event	View, Update, Insert, Delete	View, Update, Insert, Delete	View
Policy Instance	View	View	View
Reading	View	View	View
Recommendation	View, Update, Insert, Delete	View, Update, Insert, Delete	View
Timestamped Value	View, Update, Insert, Delete	View	View
Relationship Families
Has Checkpoint	View	View	View
Has Child Hierarchy Item (Deprecated)	View, Update, Insert, Delete	View	View
Has Consolidated Events	View, Update, Insert, Delete	View, Update, Insert, Delete	View
Has Health Indicators	View, Update, Insert, Delete	View	View
Has OPC Reading	View	View	View
Has OPC Tag	View	View	View
Has Readings	View	View	View
Has Recommendations	View, Update, Insert, Delete	View, Update, Insert, Delete	View
Has Timestamped Value	View, Update, Insert, Delete	View	View
Health Indicator Has Mapping	View, Update, Insert, Delete	View	View
Health Indicator Has Source	View, Update, Insert, Delete	View	View