V4.4.0.0.8 Deployment

1. Restart the machine containing the GE Digital APM Server instance that you want to upgrade.
2. 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.

3. On the same machine, access the GE Digital APM distribution package, and then navigate to the folder Setup\Meridium APM Server and Add-ons.
4. Open the file Setup.exe file.

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

5. 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.

6. Select Yes.

   The Setup Status screen appears, displaying a progress bar. When the installation is complete, the Maintenance Complete screen appears.

   

7. 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.

GE Digital provides an iOS application, but there are specific steps that you must perform to install the GE Digital APM mobile application on iOS devices.

1. Access 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.
2. Sign the application using the production certificate, private key, application identifier, and distribution provisioning profile created through https://developer.apple.com/programs/enterprise/.
   The GE Digital APM Mobile Application is installed on the iOS Device.
3. 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.

GE Digital provides an Android application, but there are specific steps that you must perform to install the GE Digital APM mobile application on Android devices.

1. Access 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.
2. 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.

1. Access 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.
2. Access 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.
3. 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.
4. 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.
5. 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.

1. Open the C:\Program Files\Meridium\Services\OTConnect\Adapters\{name}\appsettings.json file in a text editor, and then configure it to connect to the process historian or OPC server that you want to investigate.
2. Open Command Prompt, and then run C:\Program Files\Meridium\Services\OTConnect\Adapters\{name}\APM.OTConnect.Adapter.exe tags.
   The exact Source Tag metadata collected from the process historian is written to a file, tags.csv in the working directory.

1. Extract the archive to a working directory.
2. Update the appsettings.json file in the working directory. For more information, refer to the Working with OT Source Capability Utility topic.
3. To run the Portable OT Connect Capability Utility, run APM.OTConnect.Adapter.exe check.
4. To run the Tag Sync Utility, run APM.OTConnect.Adapter.exe tags.