MicroStrategy - Health Center

mstr

http://community.microstrategy.com/t5/Server/TN32554-How-to-Configure-a-MicroStrategy-Health-Center-system/ta-p/183413 - done reading
http://community.microstrategy.com/t5/Server/TN32552-How-to-use-the-MicroStrategy-Health-Center-Console/ta-p/183411
http://community.microstrategy.com/t5/Server/TN32553-How-to-keep-the-MicroStrategy-Health-Center-System-up-to/ta-p/183412
http://community.microstrategy.com/t5/Server/TN36742-What-is-MicroStrategy-Health-Center-s-Customer/ta-p/187037
http://community.microstrategy.com/t5/tkb/articleeditorpage/tkb-id/server/message-uid/t5/Server/TN42771-How-to-Configure-MicroStrategy-Health-Center-for/ta-p/192620
http://community.microstrategy.com/t5/Server/TN39868-How-to-configure-MicroStrategy-Health-Center-in-a-UNIX/ta-p/189920
http://community.microstrategy.com/t5/tkb/articleeditorpage/tkb-id/server/message-uid/t5/Server/TN46833-How-to-configure-Health-Center-in-UNIX-Linux-when-a/ta-p/196478
http://community.microstrategy.com/t5/Server/TN35640-How-to-configure-MicroStrategy-Master-Health-Agent-or/ta-p/186072

What is MicroStrategy Health Center?

It is an incomplete monitoring tool with some diagnostic capabilities.

MicroStrategy Health Center can help you prevent, diagnose and fix problems in your MicroStrategy system. It detects known problems and provides an immediate solution to many of them. Health Center can email a system administrator if it encounters a problem with the system. In cases where Health Center cannot fix a problem immediately, it enables you to bundle relevant system information, such as log files, into a diagnostic package and transmit the package to MicroStrategy Technical Support for review and troubleshooting.

Health Center requires that one machine in the Health Center system be designated as a Master Health Agent. This machine is responsible for most of the Health Center operations, such as scheduling system checks and transmitting diagnostics packages to MicroStrategy Technical Support.

What are the components of MicroStrategy Health Center?

  1. Master Health Agents: The Master Health Agent (MHA) machine serves as the hub of the Health Center system. It keeps track of the scheduled system checks for itself and the connected Health Agents, and triggers those system checks at the appropriate times. It also stores the network topology for the system, and transmits diagnostic packages to MicroStrategy Technical Support.
  2. Health Agents: These machines perform system checks on themselves when scheduled to do so by the Master Health Agent, and report the results of those checks.

Health Center uses a distributed system architecture. A Health Center system consists of a central machine (the Master Health Agent) that connects to multiple additional machines (Health Agents). Users can have multiple Health Center systems in a MicroStrategy system, each with their own Master Health Agent.

How can we define a machine as a Health Agent?

As part of a MicroStrategy installation, you can designate this machine as a Health Agent. After you complete the MicroStrategy installation, you can further define this machine as a Master Health Agent through the use of the MicroStrategy Configuration Wizard. For information on configuring and using Health Center, refer to the System Administration Guide.

To define the machine as a Health Agent, provide the following information:

  1. Port: Type the port number to use to connect to the Master Health Agent machine. The default port is 44440.
  2. Access Code: Type the access code that must be provided by Health Center to access this Health Agent. If you leave this field blank, no access code is required to access this Health Agent.
  3. UNIX Daemon: Select this check box to configure this Health Agent as a daemon, so that the Health Agent process is constantly running in the background. This requires you to configure the Health Agent using an account that has root access privileges to the machine.

If you do not have root access to the machine, clear this check box. This configures the Health Agent as an application. In this case, be careful not to stop the Health Agent process, so that the machine can remain part of the Health Center system at all times.

What is the default port for MicroStrategy Health Agent?

44440

What are the best practices for choosing the Master Health Agent?

  1. The machine should be always available on the network, so that users can run diagnostic tests at any time.
  2. The machine should have HTTPS access, so that it can download Health Center updates.
  3. The machine should have FTP access so that it can send diagnostics packages to MicroStrategy Technical Support.
  4. The machine should not have a heavy additional workload. For example, a production environment Intelligence Server machine may not make a good Master Health Agent.

How can we launch the Health Center Configuration Wizard?

  1. Start menu -> Programs -> MicroStrategy -> Tools -> Health Center Configuration Wizard.

How can we configure a machine as the Master Health Agent?

  1. Launch the Health Center Configuration Wizard
  2. On the Welcome page, select Master Health Agent. Click Next.
  3. In this step, users can set up the connection parameters and service credentials. The Display Name is the machine name populated automatically. The Port Number, by default is 44440, is the port number used by the Master Health Agent. The valid range is between 1024 and 65533. The Service Credentials is the Windows NT account to be used to run the Master Health Agent service. It must have the service privilege enabled. Local System Account will be used by default.
  4. On this page, users configure the Health Center repository for the Master Health Agent. The repository contains configuration information about the Health Center system, such as the list of machines on the network and the MicroStrategy products they have installed.
    • Create new Health Center repository to create a new repository for this Master Health Agent.
      1. In the System Access Code field, type an access code if desired. The Health Center Console must supply this code when connecting to this Master Health Agent.
      2. In the Repository Path field, type the location of the new information repository, or click Browse (…) to browse to the location.
    • Reuse an existing information repository to configure this Master Health Agent to use an existing repository.
      1. In the Repository Path field, type the location of the information repository, or click Browse (…) to browse to the location.
      2. Click Change System Access Code to change the access code for the repository. A dialog box opens. Type the old access code in the Old System Access Code field, and type the new access code in the New System Access Code and Retype System Access Code fields, then click Change.
    • Click Advanced Options to open the Health Center Repository Advanced Options dialog box. In this dialog box, specify the maximum size (in gigabytes) of the Health Center Repository.
    • Click Next to move to the next page.
  5. In this step, users configure the Health Center Update process. Health Center checks for updates every week, beginning 24 hours after users finish configuring the Master Health Agent. Read the description and legal information about the MicroStrategy Environment Information Upload process. To activate the Environment Information Upload process, select the check box. All information sent to MicroStrategy as a result of this process is stored in the Census sub folder of the Health Center Repository.
  6. On this page, specify whether to use a proxy HTTPS server to download Health Center Updates. Users can also test the HTTPS connection, and the FTP and FTPS connections to the MicroStrategy Technical Support destinations.
  7. In the optional products page, specify whether any optional MicroStrategy products are installed on this machine, and, for a Master Health Agent, what email address to use as the return address for Health Center notification emails. Some MicroStrategy products do not require a full MicroStrategy installation. Select the check boxes next to each of these products that is being used on this machine for Health Center to monitor these products. In the 'From' Email Address field, type the email address that users want to appear as the return address for Health Center notification emails. All emails notifying an administrator of a system check failure are displayed as coming from this address.
  8. The summary page shows the settings users selected. Click Finish to complete the Master Health Agent setup.

How can we configure a machine as a normal Health Agent?

Health agents perform system checks when instructed to do so by a Master Health Agent, and pass the results of those checks to the Master Health Agent. Because the Health Agent process requires relatively few system resources, users can configure all machines in the network as Health Agents with minimal impact on performance.

  1. Launch the Health Center Configuration Wizard
  2. On the Welcome page, select Health Agent.
  3. In this step, users can set up the connection parameters and service credentials. The Display Name is the machine name populated automatically. The Port Number, by default is 44440, is the port number used by the Master Health Agent. The valid range is between 1024 and 65533. The Service Credentials is the Windows NT account to be used to run the Health Agent service. It must have the service privilege enabled. Local System Account will be used by default.
  4. In this step, users specify an optional access code for the Health Agent, or a list of IP addresses that are allowed to connect to the Health Agent. If users do not want to use either authentication method, select Health Agent-specific access code and leave the Access code and Retype access code fields blank.
  5. In this page, specify whether users want this agent to connect automatically to a specific Master Health Agent. If this Health Agent is behind a firewall that allows outbound traffic, select the Connect automatically to check box to have this machine connect automatically to a specified Master Health Agent. In this way the connection is not blocked by the firewall.
  6. In this step, specify whether any optional MicroStrategy products are installed on this machine. Some MicroStrategy products do not require a full MicroStrategy installation. Select the check boxes next to each of these products that is being used on this machine for Health Center to monitor these products.
  7. The summary page shows users a summary of the choices made in setting up the machine as a Health Agent.

Is the traffic between Master Health Agent and regular Health Agent encrypted?

Yes. The encryption level / algorithm is AES.

Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-ShareAlike 3.0 License