Upgrade or Update GE Digital APM to V4.3.1.0.0
Upgrading or updating and configuring GE Digital APM includes completing multiple steps, which are outlined in the tables in this section. This section of the documentation provides all the information that you need to upgrade or update and configure the basic system architecture to V4.3.1.0.0.
After you have completed these steps, you will need to perform additional steps required to upgrade any modules that were deployed on your previous version. If you have purchased additional modules for use with GE Digital APM, then you will also need to consult the first-time deployment documentation for each of those modules and features.
The person responsible for completing each task may vary within in your organization. We recommend, however, that the steps be performed in relatively the same order in which they are listed in the table.
Upgrade from any version V4.3.0.0.0 through V4.3.0.7.7
If your current version is GE Digital APM V4.3.0.0.0 through V4.3.0.7.7, then updating the basic system architecture to V4.3.1.0.0 requires only that you complete the steps that are outlined in the table in this section.
|
Step |
Task | Notes |
|---|---|---|
| 1 | Create a backup of your database, and create a backup of any configuration files that exist in your pre-updated system. | This step is not mandatory, but is recommended by GE Digital APM. Updates may include changes to configuration files and database elements. If any problems occur during the update, the configuration files and database can be restored to their original states from the backup copies. |
| 2 | Update the GE Digital APM Server and Add Ons software on the GE Digital APM Server(s). | This step is required. This procedure includes updating your data sources for V4.3.1.0.0. |
| 3 | If you want to activate non-English translations in GE Digital APM, then deploy translations. | This step is required only if you are deploying translations for the first time or if you want to utilize and redeploy updated translations. |
| 4 | As needed, configure one of the virtual machine to execute all the scheduled jobs. | This step is required only if you have deployed GE Digital APM in a clustered environment and you want to dedicate a virtual machine to run all the scheduled jobs. |
| 5 | As needed, deploy the GE Digital APM mobile application on mobile devices. | This step is required only if you are deploying the GE Digital APM mobile application on mobile devices. |
Upgrade from a version prior to version V4.3.0.0.0
If your current version is a version prior to GE Digital APM V4.3.0.0.0, then updating the basic system architecture to V4.3.1.0.0 requires only that you complete the steps that are outlined in the table in this section.
|
Step |
Task | Notes |
|---|---|---|
| 1 | Ensure that your system meets the hardware and software requirements for the basic GE Digital APM system architecture. | This step is required. |
| 2 |
On the server on which you will install Elasticsearch, download and install OpenJDK V1.8.0_111 or Oracle JDK V1.8.0_73. Important: The versions higher than V1.8.0_XX are not currently supported.
After the installation is complete, create a JAVA HOME system environment variable for the installed version as shown in the following examples:
Enter the following command to verify the environment variable.
Note:
|
This step is required. Ensure that you complete this step on the server on which you will install Elasticsearch. Note:
For optimum system performance, GE Digital APM recommends that you install Elasticsearch on its own, dedicated server that contains no GE Digital APM components. Important: Any time you update OpenJDK or Oracle JDK, you will need to re-enter this environment variable.
|
| 3 | Ensure that all existing GE Digital APM Security Users have been assigned time zones. Refer to your pre-upgraded system documentation for information on managing GE Digital APM Security Users. | This step is required. If there are GE Digital APM Security Users to whom time zones have not been assigned, a failure will occur during the database upgrade process. |
| 4 | If you intend to upgrade the Production Loss Analysis (PLA) module from a starting version prior to V3.6.0.0.0, then import the required baseline rules. |
Important:
This step is required only if you intend to upgrade the Production Loss Analysis (PLA) module from a starting version prior to Meridium Enterprise APM V3.6.0.0.0. If you intend to upgrade PLA in this manner, this procedure must be completed before upgrading the GE Digital APM Server and Add Ons software on the GE Digital APM Server. This procedure is part of the upgrade Production Loss Analysis workflow. |
|
5 |
Create a backup of any configuration files that exist in your pre-upgraded system which you may want to retain post-upgrade. | This step is required only if you want to retain customizations that you have made to your existing configuration files. |
|
6 |
Upgrade the GE Digital APM Server and Add Ons software on the GE Digital APM Server. | This step is required. Consult the documentation on Redis for information about its incorporation into server configurations. |
| 7 |
This step is required Note:
You must install Elasticsearch on a server in your environment. For optimum system performance, GE Digital APM recommends that you install Elasticsearch on its own, dedicated server that contains no GE Digital APM components. | |
|
8 | This step is required. | |
|
9 | This step is required. | |
| 10 | Modify the configuration file to remove notifications. | This step is required. |
| 11 | If you want to use non-English translations in GE Digital APM, then deploy translations. | This step is required only if you are deploying translations for the first time or if you want to utilize and redeploy updated translations. |
| 12 | If required, configure one of the virtual machine to execute all the scheduled jobs. | This step is required only if you have deployed GE Digital APM in a clustered environment and you want to dedicate a virtual machine to run all the scheduled jobs. |
| 13 | If required, deploy the GE Digital APM mobile application on mobile devices. | This step is required only if you are deploying the GE Digital APM mobile application on mobile devices. |
| 14 | If required, enable single sign-on for on-site or off-site authentication. | This step is required only if you are enabling single sign-on. |