2.4 Installing the Module

Run the module installer on the vCenter servers you want to monitor (agents) to install the agent components, and run the module installer on all console computers to install the Help and console extensions.

Access the AM70-VMWare-8.x.x.0.msi module installer from the AM70_VMWare_8.x.x.0 self-extracting installation package on the AppManager Module Upgrades & Trials page.

For Windows environments where User Account Control (UAC) is enabled, install the module using an account with administrative privileges. Use one of the following methods:

  • Log in to the server using the account named Administrator. Then, run the module installer VirtualCenter.msi file from a command prompt or by double-clicking it.

  • Log in to the server as a user with administrative privileges and run the module installer VirtualCenter.msi file as an administrator from a command prompt. To open a command-prompt window at the administrative level, right-click a command-prompt icon or a Windows menu item and select Run as administrator.

You can install the Knowledge Scripts and the Analysis Center reports into local or remote AppManager repositories (QDBs). The module installer installs Knowledge Scripts for each module directly into the QDB instead of installing the scripts in the \AppManager\qdb\kp folder as in previous releases of AppManager.

2.4.1 Manually Installing the Module

You can install the module manually, or you can use Control Center to deploy the module on a remote computer where an agent is installed. For more information, see Section 2.5, Deploying the Module with Control Center. However, if you do use Control Center to deploy the module, Control Center only installs the agent components of the module. The module installer installs the QDB and console components as well as the agent components on the agent computer.

NOTE:If you are upgrading from version 8.0 of this module, you will need to perform the installation steps in a specific order to make sure the Knowledge Scripts get updated correctly. For more information, see Section 2.4.2, Upgrading from Version 8.0 of the Module.

To install the module manually:

  1. Double-click the module installer .msi file.

  2. Accept the license agreement.

  3. Review the results of the pre-installation check. You can expect one of the following three scenarios:

    • No AppManager agent is present: In this scenario, the pre-installation check fails, and the installer does not install agent components.

    • An AppManager agent is present, but some other prerequisite fails: In this scenario, the default is to not install agent components because of one or more missing prerequisites. However, you can override the default by selecting Install agent component locally. A missing application server for this particular module often causes this scenario. For example, installing the AppManager for Microsoft SharePoint module requires the presence of a Microsoft SharePoint server on the selected computer.

    • All prerequisites are met: In this scenario, the installer installs the agent components.

  4. To install the Knowledge Scripts into the QDB and to install the Analysis Center reports into the Analysis Center Configuration Database:

    1. Select Install Knowledge Scripts to install the repository components, including the Knowledge Scripts, object types, and SQL stored procedures.

    2. Select Install report package to install the Analysis Center reports.

    3. Specify the SQL Server name of the server hosting the QDB, as well as the case-sensitive QDB name.

    4. Specify the SQL Server name of the server hosting the Analysis Center Configuration Database.

  5. Install this module to all QDBs, and for Control Center environments, install the module to the primary QDB last.

  6. Run the module installer on all console computers to install the Help and console extensions.

  7. Run the module installer on the VMware vSphere computers you want to monitor (agents) to install the agent components.

  8. Configure VMware vCenter credentials in AppManager Security Manager. For more information, see Section 2.7, Configuring vCenter Connection Credentials.

  9. If you have not discovered VMware vSphere resources, run the Discovery_VirtualCenter Knowledge Script on all agent computers where you installed the module. For more information, see Section 2.8, Discovering VMware vSphere Resources.

  10. To get the updates provided in this release, upgrade any running Knowledge Script jobs. For more information, see Section 2.10, Upgrading Knowledge Script Jobs.

2.4.2 Upgrading from Version 8.0 of the Module

If you are upgrading from the previous release, version 8.0, you need to perform additional steps to make sure the Knowledge Scripts get updated correctly for version 8.1 of the module.

To upgrade from version 8.0 when the QDB and the agent are on separate computers:

  1. Manually install the 8.1 module on the QDB. For more information, see Section 2.4.1, Manually Installing the Module.

  2. Propagate the Knowledge Script changes into Knowledge Script Groups, monitoring policies, and ad hoc jobs. For more information, see Section 2.10, Upgrading Knowledge Script Jobs.

  3. Manually install the 8.1 module on the agent machine.

To upgrade from version 8.0 when the QDB and the agent are on the same computer:

  1. Stop all ad hoc and monitoring policy jobs.

  2. Manually install the 8.1 module on the computer to install the Knowledge Scripts as well as the managed object. For more information, see Section 2.4.1, Manually Installing the Module.

  3. Propagate the Knowledge Script changes into Knowledge Script Groups, monitoring policies, and ad hoc jobs. For more information, see Section 2.10, Upgrading Knowledge Script Jobs.

  4. Start any jobs you stopped at the beginning of this procedure.