V4.3.0.0.9 Deployment

About Applying This Patch

How do I Know if I Need This Patch?

You must apply this patch if your current version is V4.3.0.0.0 through V4.3.0.0.8, and you are using one or more of the following modules or features:

Asset Strategy Management
Root Cause Analysis

For details, refer to the release notes for this patch.

Applying V4.3.0.0.9

To apply this patch, complete the following steps:

Apply this patch to all instances of the GE Digital APM Server (both dedicated and supporting).
Important: This patch can be applied to any machine where V4.3.0.0.0 is currently running. To ensure that the machine is updated to the baseline database content, you must complete steps 2 through 5 if you have not completed them when applying a previous release.
If you are using Calibration Management, using the command prompt, navigate to the <GE Digital APM installation folder>\Upgrade folder, and then run the following command:
```
Meridium.DbUtility.PostUpgrade.exe -x:<path>/CalibrationDataModelUpgradeUtility.xml -d:<datasource ID> -u:<user name> -p:<password>
```
Where:
- <path> is the folder path of the file CalibrationDataModelUpgradeUtility.xml.
  Tip: The default path is C:\Meridium\DbUpg\MI_DB_MASTER_4030003\4030003\_99_PostProcess\_files. If, however, you have provided a different location to save and extract zip files, then you can search for the folder path in the Windows registry under HKEY_LOCAL_MACHINE\SOFTWARE\Meridium\APM\InstallInfo.
- <datasource ID> is the identification of the GE Digital APM datasource.
- <user name> is the GE Digital APM user name.
- <password> is the GE Digital APM password.
If you are using one of the following modules, import the needed files:
- Calibration Management
- Reliability Analytics
- Root Cause Analysis
- Rounds Designer
- Rounds
If you are using Root Cause Analysis:
- Enable state management for the RCA Analysis family.
- Remove the Status field from the RCA Recommendation datasheet.
If you are using a module that uses the MI_TASK family, run the upgrade script to update the existing records.
Apply this patch to mobile devices using an iOS, Android, or Windows operating system by following the standard documentation for installing the GE Digital APM mobile application.

The files that you need to apply this patch are included in the distribution package.

Apply This Patch to GE Digital APM Server Instances

Procedure

Restart the machine containing the GE Digital APM Server instance that you want to upgrade.
On the same machine, stop all GE Digital APM services and the Redis service. To do so:
1. Access Task Manager, and then, on the Windows Task Manager window, select the Services tab.
  The Services section appears.
2. Select the heading of the Description column.
  The services are organized alphabetically according to their descriptions.
3. For each service whose description begins with Meridium and whose status is Running, right-click the service, and then select Stop Service.
  All GE Digital APM services are stopped.
4. Right-click the service whose description is Redis, and then select Stop Service.
  The Redis service is stopped.
On the same machine, access the GE Digital APM distribution package, and then navigate to the folder Setup\Meridium APM Server and Add-ons.
Open the file Setup.exe.

A message appears, asking if you want to allow the installer to make changes to your machine.
Select Yes.

The Meridium APM Server and Add-ons installer appears, displaying the Preparing Setup screen. When the setup is prepared, a message appears, asking if you want to upgrade your GE Digital APM Server.
Select Yes.

The Setup Status screen appears, displaying a progress bar. When the installation is complete, the Maintenance Complete screen appears.
If prompted to restart your computer, accept the selection Yes, I want to restart my computer now, and then select Finish.

Otherwise, select Finish to open the APM System Administration tool. As needed, manage each of the configuration files present, and then select Exit.

Import Files

Procedure

On the machine containing the GE Digital APM Application Server instance to which you want to apply this patch, open the GE Digital APM distribution package, and navigate to the folder: <Distribution Package>\General Release\Meridium APM Setup\Database.
Using Configuration Manager, import the needed zip file.
- If you are using Calibration Management, import the file Instrument Data Query.zip.
- If you are using Reliability Analytics, import the file TileListOfRAProductionAnalysisWithoutPLA.zip.
- If you are using Root Cause Analysis, import the file RCA Queries.zip.
- If you are using Rounds Designer, perform the following tasks as needed:
  - Extract the file MI_CHECK_PT.zip, import the Checkpoint family, and then import the Measurement Location and Lubrication Requirement families.
  - Import the file RoutesDataloader.zip.
- If you are using Rounds, perform the following tasks as needed:
  1. Extract the file 403000306.zip.
  2. Import the file MI_CHKPCOND.zip. When you import, ensure that you select All Metadata.
  3. Import the file Rounds_Templates.zip, importing both Dataloader Templates.

Enable State Management for the RCA Analysis Family

Access Configuration Manager, and then select Family Management.
In the family hierarchy, search for and select RCA Analysis.
The workspace for the RCA Analysis family appears.
In the workspace, select State Configuration.
Select Enable State Functionality.
Clear the Show States on Datasheets check box.
Select Add States, and then add states. The following table provides values that you can use to create states.
ID Caption Initial State
Not Started Not Started Yes
In Progress In Progress No
On Hold On Hold No
Deferred Deferred No
Completed Completed No
Select Add Operation, and then add operations. The following table provides values that you can use to create operations.
ID Caption Predecessor State Successor State
Start Start Not Started In Progress
Hold Hold In Progress On Hold
Continue Continue On Hold In Progress
Defer Defer In Progress Deferred
Complete Complete In Progress Completed
Select Save.
State Management is enabled for the RCA Analysis family.

ID	Caption	Initial State
Not Started	Not Started	Yes
In Progress	In Progress	No
On Hold	On Hold	No
Deferred	Deferred	No
Completed	Completed	No

ID	Caption	Predecessor State	Successor State
Start	Start	Not Started	In Progress
Hold	Hold	In Progress	On Hold
Continue	Continue	On Hold	In Progress
Defer	Defer	In Progress	Deferred
Complete	Complete	In Progress	Completed

Remove Status Field from the RCA Recommendation Datasheet

Procedure

Access Configuration Manager, and then select Family Management.
In the family hierarchy, search for and select RCA Recommendation.
The workspace for the RCA Analysis family appears.
In the workspace, select Datasheets, and then select Manage Datasheets.
The RCA Recommendation workspace appears.
In the first column, select Status.
In the workspace, select .
Select Save.
The Status field is removed from the RCA Recommendation datasheet.

Run the Upgrade Script

If you are using a module that uses the MI_TASK family, run the RUN_SCRIPT.cmd file to update the values in the Task State field in the existing records as follows:

Existing Value	Updated Value
Proposed	PROPOSED
Scheduled with change	SCHEDULED WITH CHANGE
Scheduled without change	SCHEDULED WITHOUT CHANGE

Tip: Export or back up the Oracle or SQL server schema database.

Install the database client.
Note: If the database client is not installed, an error message appears, indicating that the database client is not recognized, and the script will not run as expected.
Navigate to the folder <Distribution Package>\General Release\Meridium APM Setup\Database\Update Task State.
If you are using an Oracle database, copy the folder ORA to a local or mapped drive that is accessible from the machine in which you will run the script.
-or-
If you are using an SQL database, copy the folder SQL to a local or mapped drive that is accessible from the machine in which you will run the script.
Note: Make sure that the folder name does not contain space.
From the copied folder, run the file RUN_SCRIPT.cmd, and then follow the on-screen instructions.
Values in the Task State field will be updated in the existing records.
A log file is generated. If the log file contains errors, contact the technical product support.

Install the GE Digital APM Mobile Application on an iOS Device

GE Digital provides an iOS app, but there are specific steps that must be taken for an organization to install the GE Digital APM mobile application on iOS devices.

Before You Begin

Before the application can be installed, an Apple developer's license must be purchased.

Procedure

Obtain the application package file at C:\Program Files\Meridium\ApplicationServer\distribution\GEDigitalAPM.ipa.

Note: This is the default location of the application package file. The exact location at which you can obtain the application package file may differ based on your initial installation of GE Digital APM.
After you obtain the application package file, you must sign the application using the production certificate, private key, app identifier, and distribution provisioning profile created through https://developer.apple.com/programs/enterprise/.
Optional: If your organization does not use mobile device management, complete the following steps to distribute the application within your organization:
1. In Notepad or a similar text editor, copy and paste the following text:
```
<?xml version="1.0" encoding="UTF - 8"?>
<!DOCTYPE plist PUBLIC " -//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>items</key>
	<array>
		<dict>
			<key>assets</key>
			<array>
				<dict>
					<key>kind</key>
					<string>software-package</string>
					<key>url</key>
					<string>https://<your_server_url>/GEDigitalAPM.ipa</string>
				</dict>
			</array>
			<key>metadata</key>
			<dict>
				<key>bundle-identifier</key>
				<string><your_application_identifier></string>
				<key>kind</key>
				<string>software</string>
				<key>title</key>
				<string>GEDigitalAPM</string>
			</dict>
		</dict>
	</array>
</dict>
</plist>
```
2. Replace <your_server_url> with the URL of your server.
3. Replace <your_application_identifier> with an identifier for your application.
4. Save the file as GEDigitalAPM.plist, and then close the file.
  The .plist file is created. When you configure a distribution page for your application, link to this file.
5. In the web page from which you want to distribute the application within your organization, add an anchor tag with an href pointing to the installation file, as shown in the following example:
  <a href="itms-services://?action=download-manifest&url=https://my.company.com/GEDigitalAPM.plist">Install GE Digital APM</a>
You can use the link you configured to distribute the application within your organization.

Install the GE Digital APM Mobile Application on an Android Device

GE Digital provides an Android app, but there are specific steps that must be taken for an organization to install the GE Digital APM mobile application on Android devices.

Procedure

Obtain the application package file at C:\Program Files\Meridium\ApplicationServer\distribution\GEDigitalAPM.apk.

Note: This is the default location of the application package file. The exact location at which you can obtain the application package file may differ based on your initial installation of GE Digital APM.
Optional: If your organization does not use mobile device management, in the web page from which you want to distribute the application within your organization, add an anchor tag with an href pointing to the installation file, as shown in the following example:
<a href="my.company.com/GEDigitalAPM.apk">Install GE Digital APM</a>

You can use the link you configured to distribute the application within your organization.

Install the GE Digital APM Mobile Application on a Windows Device

Procedure

Obtain the application package file at C:\Program Files\Meridium\ApplicationServer\distribution\GEDigitalAPM.zip.

Note: This is the default location of the application package file. The exact location at which you can obtain the application package file may differ based on your initial installation of GE Digital APM.
On the device on which you want to install the GE Digital APM mobile application, extract the content of the application package file to a local folder.
In the folder into which you extracted the application package file content, right-click Install.bat, and then select Run as an Administrator.

Note: If you are using a touch-screen device, press and hold Install.bat, and then select Run as an Administrator.

The GE Digital APM mobile application is installed on the Windows device for all current and future Windows user accounts.
Optional: To cancel future installations or uninstall the GE Digital APM mobile application, in the folder into which you extracted the application package file content, right-click Uninstall.bat, and then select Run as an Administrator.

Note: If you are using a touch-screen device, press and hold Uninstall.bat, and then select Run as an Administrator.

The GE Digital APM mobile application is uninstalled for the Windows user account that is currently logged in, and installations for future Windows user accounts are canceled.