V4.3.0.1.6 Deployment

About Applying This Patch

How do I Know if I Need This Patch?

You must apply this patch if you are enabling two additional language placeholders in GE Digital APM, and your current version is V4.3.0.1.0 through V4.3.0.1.5.

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

Applying V4.3.0.1.6

To apply this patch, complete the following steps:

  1. Apply this patch to all instances of the GE Digital APM Server (both dedicated and supporting).
  2. 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.
  3. Enable additional language placeholders P1 and P2.

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

  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.

    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.

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

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

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

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

Install the GE Digital APM Mobile Application on a Windows Device

Procedure

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

Enable additional language placeholders P1 and P2

Procedure

  1. Run the following queries against the database:
    1. To enable the P1 language
      INSERT INTO MI_MODULES(MODL_KEY,MODL_NM,MODL_VER_NBR,LAST_UPDT_DT,SITE_KEY,MODL_TYPE_CD,MODL_CAPTION_TX)
      VALUES(-73,'Language-P1', (select MODL_VER_NBR from MI_MODULES where MODL_KEY = -1),'25-Apr-19',-1,'CORE', 'Language-P1');
      
    2. To enable the P2 language
      INSERT INTO MI_MODULES(MODL_KEY,MODL_NM,MODL_VER_NBR,LAST_UPDT_DT,SITE_KEY,MODL_TYPE_CD,MODL_CAPTION_TX)
      VALUES(-74,'Language-P2', (select MODL_VER_NBR from MI_MODULES where MODL_KEY = -1),'25-Apr-19',-1,'CORE', 'Language-P2');
      
  2. Activate the license via GE Digital APM or via command prompt.

Activate a License via GE Digital APM

Before You Begin

  • You must have obtained the license file and customer PIN.

Procedure

  1. In the module navigation menu, select Admin > Operations Manager > Activate Licenses.
    The Activate Licenses page appears.
  2. Select Load License.
    The Licenses Activation window appears.
  3. In the Customer PIN box, enter the customer PIN.
  4. In the License File box, select Choose File.
    The Open window appears.
  5. Navigate to the folder containing the file, select it, and then select Open.
    The Open dialog box closes, and the name of the file appears in the License File text box.
  6. Select OK.

Results

  • The GE Digital APM system validates the license file and PIN that you entered. If the file and PIN are determined to be valid, the License Activation window closes, and license file appears in the list on the Activate Licenses page.
  • For each module activated successfully, the Status field is populated with the text ACTIVE. However, if the license file or PIN are invalid, an error message will be displayed after Step 6. The error message will explain the problem that was encountered.

Activate a License via Command Prompt

Before You Begin

  • You must have obtained the license file from GE Digital APM.

Procedure

  1. On your GE Digital APM Server, select the Windows Start button, then navigate to and right-click Command Prompt, and then select Run as administrator.
    A command prompt window appears.
  2. On the command prompt window, enter the following: <root>\Program Files\Meridium\Upgrade\Meridium.Version.ContentActivation.exe /datasourceid:<Datasource Id> /u:<User> /p:<Password> /file:<License File> /pin:<PIN>
    Where:
    • <root> is replaced with the location where the GE Digital APM program files are installed.
    • <Datasource Id>, <User>, and <Password> are replaced with the appropriate values.
    • <License File> is replaced with the path and file name of the license file that you want to apply (e.g., C:\temp\APMLicenseFile.txt).
    • <PIN> is replaced with the customer-specific PIN associated with the selected license file. The appropriate PIN should have been provided to you when you received the license file.
    The utility runs, and the license is installed.
  3. Take the data source to which you applied the license offline, and then bring it back online.
    Note: As an alternative to taking the data source offline, and then bringing it back online, you can restart the GE Digital APM Server.
    The data source is fully activated.