GE Digital APM Server First-Time Installation Steps

Install the GE Digital APM Server Software and Add-ons

Before you begin

These instructions assume that:

  • Your system meets the hardware and software requirements for the GE Digital APM Server machine.

    Note: Note: If your system does meet certain software requirements, a message may be displayed during the installation process that indicates the software requirement that is missing. Some software requirements, however, will be installed automatically if they are missing.
  • You are an Administrator with full access to the machine that will serve as the GE Digital APM Server machine.
Note: Note: IIS will be reset automatically by the installer before the installation process begins.
Note: Note: If you want to run the GE Digital APM Server and Add-ons installer in silent mode from the command line, you must first ensure that Microsoft .NET Framework 4.5.2 is installed on the GE Digital APM Server machine. If it is not installed, an error will occur during installation. You can download this program from the official Microsoft website. If the GE Digital APM Server and Add-ons installer is run according to the procedure in this topic and Microsoft .NET Framework 4.5.2 has not yet been installed on the GE Digital APM Server machine, it will be installed automatically during the installation process.
Important: Before installing the GE Digital APM Server and Add-ons software, via your IIS Manager, the WebDAV Publishing service needs to be deactivated. To verify this, in the Server Manager, in the Local Server workspace, in the Roles and Features section, ensure that WebDAV Publishing is not present in the list.

Procedure

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

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

  3. Select Yes.

    The Meridium APM Server and Add-ons installer appears.

    Note: If a list of required programs appears in the installer, select Install. The installer will install the programs, and then the server will restart.

  4. On the welcome screen, select Next.

    The License Agreement screen appears.

  5. Read the License Agreement, and then, if you agree to the terms, select the I accept the terms of the license agreement check box. Then, select Next.

    The Select Installation Location screen appears.

  6. By default, the Meridium APM Server and Add-ons software will be saved to the following folder: C:\Program Files\Meridium. If you are satisfied with the default location where the software will be installed, select Next.

    -or-

    If you want to change the location where the software will be installed, select Change, and then navigate to the location where you want to install the Meridium APM Server and Add-ons software. The folder path that you select will be displayed in place of the default folder path. When you are satisfied with the installation location, select Next.

    The Select the features you want to install screen appears.

    Important: The Select the features you want to install screen lets you specify which features you want to install on the GE Digital APM Server machine. These instructions assume that you want to deploy only the GE Digital APM Server software and help files.
    Note: Deploying the help files will create a locally stored copy of the files on your GE Digital APM Server. By default, GE Digital APM is configured to point to these locally stored files when help is accessed, but the setting is configurable.
  7. In the tree, select the Meridium APM Application Server and Help check boxes.
  8. If you will install Elastic Search on its own, dedicated server, clear the Elastic Search check box, and then select Next.

    -or-

    To install Elastic Search on the GE Digital APM Server, ensure that the Elastic Search check box is selected, and then select Next.

    Note:

    You must install Elastic Search on a server in your environment.

    For optimum system performance, GE Digital APM recommends that you install Elastic Search on its own, dedicated server that contains no GE Digital APM components. If you choose to deploy Elastic Search in this way, you should clear the Elastic Search check box in this step. If you utilize this deployment, you will install Elastic Search on a dedicated server in a subsequent procedure.

    If you leave the Elastic Search check box selected in this step, Elastic Search will be installed on the GE Digital APM Server. If you utilize this deployment, to improve system performance, GE Digital APM recommends that the server machine have a minimum of 24 GB RAM.

    The Select ZIP File Location screen appears.

  9. In the Select ZIP File Location screen, change the default destination folder if needed, and then select Next.

    The Websites screen appears.

  10. If necessary, change the website for the Meridium virtual directory, and then select Next.

    The Select Location for ElasticSearch files screen appears.

  11. In the Select Location for ElasticSearch files screen, change the default destination folder if needed, and then select Next.

    The Complete the Installation screen appears.

  12. Select Install.

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

  13. Clear the Launch APM System Administration now check box, and then select Finish.
    Note: If prompted to restart your computer, accept the selection Yes, I want to restart my computer now, and then select Finish.

    The Meridium APM Server and Add-ons installer closes.

What to do next

Install, Repair, or Uninstall GE Digital APM Server Components After the Initial Installation

About this task

If you need to install a GE Digital APM component on a machine after the initial installation is complete, you can run the GE Digital APM Server and Add-ons installer in modify mode, which will allow you to make changes to the current installation on that machine. Note that the same prerequisites are required when you run the installer in modify mode. You can also run the installer in repair mode to update installed components, or in remove mode to uninstall GE Digital APM components.

Note: IIS will be reset automatically by the installer before the installation process begins.

Procedure

  1. On the GE Digital APM Server machine, via the Control Panel, access the Programs and Features window.
  2. In the grid, select the Meridium APM Server and Add-on item, and then select Change.

    The Meridium APM Server and Add-ons installer appears, displaying the Preparing Setup screen, which contains a progress bar. After completion, the Welcome screen appears.

    The Welcome screen contains the following options:

    • Modify: Runs the installer in modify mode, which allows you to install additional components on the machine or uninstall specific components. This option is selected by default.
    • Repair: Runs the installer in repair mode, which allows you to update the components that are installed on the machine.
    • Remove: Runs the installer in remove mode, which uninstalls all the GE Digital APM components that are installed on the machine.
  3. Select the necessary option, and then select Next.

    If you selected the Modify option, then the Select the features you want to install screen appears.

    The components that are currently installed on the machine are selected in the tree. If you want to remove one or more of these components, you can clear the check box beside each component that you want to remove.

    1. Select the check boxes beside the additional components that you want to install, and then select Next.

      A message appears, indicating that the installer is checking your machine for the required prerequisites for the features that you want to install.

      If one or more prerequisites are missing on the machine, the Meridium Installer screen will appear, displaying a message that indicates which prerequisites still need to be installed on the machine before you can install the feature that is dependent on those prerequisites. This message also indicates what you can do to continue. If you see this screen, you should read the message in detail, and either select Back to clear the selection whose prerequisites are missing, and then continue through the installation without installing that component, or close the installer, install the missing prerequisite, and then run the installer again later.

      If all the prerequisites for the selected components are installed on the machine, then the Websites screen appears.

      The Websites screen lets you specify where the installer will create a virtual directory for Meridium. This website is configured in the IIS Manager on the GE Digital APM Server machine. The websites list contains all the websites that are configured on the GE Digital APM Server machine. The default website is Default Web Site. Throughout this documentation, we assume that you have chosen to install GE Digital APM under the Default Web Site.

    2. In the list of websites, select the website where you want the installer to create a virtual directory, and then select Next.
      Note: If you are installing Elastic Search, the Select Location for ElasticSearch files screen appears. If it does, select the location where you want to install the ElasticSearch files, and then select Next.

      The Setup Status screen appears, displaying a progress bar. After the server is configured, the Maintenance Complete screen appears.

    3. Select Finish.

      The Meridium APM Server and Add-ons installer closes. Additionally, if the Launch APM System Administration now check box was selected, the APM System Administration window appears.

    -or-

    If you selected the Repair option, the Setup Status screen appears, displaying a progress bar. After the server is configured, the Maintenance Complete screen appears.

    1. Select Finish.
      Note: If prompted to restart your computer, accept the selection Yes, I want to restart my computer now, and then select Finish.

      The Meridium APM Server and Add-ons installer closes. Additionally, if the Launch APM System Administration now check box was selected, the APM System Administration window appears.

    -or-

    If you selected the Remove option, a message appears, asking if you want to remove the selected application and all of its features.

    1. Select Yes.

      The Setup Status screen appears, displaying a progress bar. After the application and all of its features are removed, the Uninstall Complete screen appears.

    2. Select Finish.

      The Meridium APM Server and Add-ons installer closes.