EducationSoftwareStrategy.com
StrategyCommunity

Knowledge Base

Product

Community

Knowledge Base

TopicsBrowse ArticlesDeveloper Zone

Product

Download SoftwareProduct DocumentationSecurity Hub

Education

Tutorial VideosSolution GalleryEducation courses

Community

GuidelinesGrandmastersEvents
x_social-icon_white.svglinkedin_social-icon_white.svg
Strategy logoCommunity

© Strategy Inc. All Rights Reserved.

LegalTerms of UsePrivacy Policy
  1. Home
  2. Topics

KB32552: How to use the MicroStrategy Health Center Console?


Community Admin

• Strategy


This knowledge base article explains how to use the MicroStrategy Health Center Console.

Strategy Health Center Console is an interface to manage a Health Center System and perform Health Center functions such as analyzing logs, diagnosing any problems with Strategy systems.
 
Launching the Health Center Console
 

  • In Windows: From the Start menu, point to Programs, then Strategy, then Tools, then select Health Center Console.
     
ka04W00000148IKQAY_0EM440000002AuN.gif
  • In UNIX/Linux/Solaris: In the Health Center installation directory, in the /bin folder, run the program mstrsuppappgui.

 
NOTE: Users must have administrative privileges on the Health Center machine to be able to run the Health Center Console.
 
After the Health Center Console is launched, it prompts to connect to Master Health Agent. In the Machine Name and Port fields, type the name and port number of the Master Health Agent machine. If the Master Health Agent has an access code, in the Access Code field, type the password. Next, click Connect. The Health Center Console is connected to the specified Master Health Agent, and has access to all Health Agents that have been added to that Master Health Agent's Health Center system.
 

ka04W00000148IKQAY_0EM440000002Auk.gif

 
The main window of the Health Center Console after connecting to a Master Health Agent:
 

ka04W00000148IKQAY_0EM440000002Auj.gif

 
The Health Center Console consists of a navigation pane on the left and a main pane on the right. Select the panel that users want to use from the bottom of the navigation pane. Depending on the panel that you select, different Health Center functionality is available. Users can select from:

  • The System panel, for managing the Health Center system.
  • The System Checks panel, for performing system checks and fixing problems.
  • The Diagnostics Packages panel, for managing diagnostics packages and destinations.
  • The Log Analysis panel, for viewing and analyzing log files.
  • The Action History panel, for viewing a record of the actions taken through the Health Center console to correct problems found during system checks.

 
Managing Master Health Agent and Health Agent
Once users have connected to a Master Health Agent in the Health Center Console, users can add additional Health Agent machines to the Health Center system. When users have added a Health Agent to the system, the Master Health Agent can then perform tasks such as scheduling system checks or viewing log files for that machine.
 
To add a Health Agent to a Health Center System:

  • In the Health Center Console, in the System panel, right-click the Master Health Agent and select Add. The Add Machine dialog box opens.
     
ka04W00000148IKQAY_0EM440000002Aum.gif
  • In the Machine Name and Port fields, type the name and port number of the Health Agent machine. If the Health Agent was configured to require an access code, type that access code in the Access Code field.
     
ka04W00000148IKQAY_0EM440000002Auh.gif
  • Click Add. The dialog box closes and the machine is added to the network. It is now visible in the main pane.

If a Health Agent machine is behind a firewall from the Master Health Agent, the Master Health Agent may not be able to connect directly to the Health Agent. In this case, users must configure the Master Health Agent to receive a connection from the Health Agent. 
 
Follow steps below to add a Health Agent behind a firewall:

  • When users configure the machine as a Health Agent, on the Health Agent Connectivity page of the Health Center Configuration Wizard, select the Connect automatically to check box, and then type the IP address and port number of the Master Health Agent to connect to.
     
ka04W00000148IKQAY_0EM440000002AuV.gif
  • In the Health Center console, in the System panel, right-click the Master Health Agent and select Await incoming connection. The Await Incoming Connection dialog box opens.
     
  • In the Machine Name field, type the IP address of the Health Agent machine that is trying to connect to this Master Health Agent. If the Health Agent was configured to require an access code, type that access code in the Access Code field.
     
ka04W00000148IKQAY_0EM440000002AuI.gif
  • Click OK. The Health Agent can now connect to this Master Health Agent.

Instead of adding Health Agents to the Health Center system one at a time, users can use Health Center to discover Strategy components elsewhere in the network. users provide information about the Strategy components on this machine, such as Intelligence Server or Desktop, and Health Center scans the network for other machines that those components are aware of. If those other machines have been configured as Health Agents, users can then add them to the Health Center system.
 
To discover Health Agents in the Strategy network,

  1. In the Health Center Console, In the System panel, right-click a machine and select Discover machines. The Machine Discovery Wizard opens.
  2. Step through the wizard, providing any required information for example, Intelligence Server login and password.
  3. On the Summary page, select the machines that users want to add to the Health Center system and click Finish. The wizard closes and an Add Machines dialog box opens for each machine selected. 
     
    Note: If a machine has been configured as a Health Agent, and is using the default port and does not require an access code, an Add Machine dialog box does not open for that machine. Instead, that machine is automatically added to the Health Center system.
     
  4. For each machine, in the Add Machines dialog box, type the port number and access code (if required) and click OK. That machine is then added to the Health Center system.

 
Diagnosing and fixing problems
One of the main purposes of Health Center is to diagnose any problems with users' Strategy systems. Health Center does this by performing system checks on the Master Health Agent and on all Health Agents in the Health Center system to identify any problems. In many cases, Health Center also provides users with the ability to fix the problems immediately.
 
NOTE: A system check is a Health Center scan of a specific component of a Strategy product or machine configuration. System checks can report errors or potential errors, and in many cases can provide ways to fix these problems. For more information on available system checks, see the tech note below:
 
KB32551 A list of supported system checks for MicroStrategy Health Center
 
Users can execute these system checks manually from the Health Center Console, or users can schedule them to automatically run daily or weekly at a specified time. The Master Health Agent handles the scheduling, and at the appropriate times it triggers the scheduled system checks on all Health Agents in the system.
 
To manually execute a system check:

  • In the Health Center Console, in the System Checks panel, expand the machine users want to run a system check on, expand the category containing that system check, and select that system check.
     
  • If the system check is displayed in blue, it requires additional configuration information. In the Configuration tab, type the required information.
     
ka04W00000148IKQAY_0EM440000002AuJ.gif
  • In the navigation pane on the left, right-click the system check and select Refresh. The system check is performed immediately.
     
ka04W00000148IKQAY_0EM440000002AuP.gif

 
Analyzing system information
In the Health Center Console, users can review the Strategy log files to get more information about the possible causes of any errors in the Strategy system. For example, if Intelligence Server returns an Out Of Memory error, users can look in the DSSErrors.log file to see what tasks have used more memory than expected.
 
All Strategy system components record information about low-level system activity in log files. This information can include system errors, memory usage, starting and stopping services, and so on. The log files for all the machines in Health Center system are listed on the Log Analysis panel. To view the contents of a log file in the main pane of the Health Center console, double-click that file.
 

ka04W00000148IKQAY_0EM440000002AuZ.gif

 
Creating and sending Diagnostic Packages
If a problem in the system cannot be resolved by the actions suggested by Health Center, the next step is often to contact Strategy Technical Support. Health Center can collect all the relevant information into a single diagnostics package, which can then be delivered to Strategy Technical Support.
 
A diagnostics package contains system information, including log files, collected from one or more Health Agent machines. When users create a diagnostics package, users can choose what machines to include log files from, and what log files to include in the package.
 
Once users have created a diagnostics package, users can save it as a ZIP file, or send it directly to Strategy Technical Support over FTP. users can use either standard FTP mode, or an encrypted FTP mode (FTPS) that makes use of SSL.
 
Note: Health Center does not support transmitting diagnostics packages using secure FTP (SFTP), that is, FTP over SSH.
 
To create a diagnostics package,

  • In the Health Center Console, select the System panel.
     
  • In the main pane, right-click the machine that users want to create a diagnostic package for and select Collect Diagnostics. The Diagnostics Information Collection Wizard opens at the Welcome page.
     
ka04W00000148IKQAY_0EM440000002Auo.gif
ka04W00000148IKQAY_0EM440000002AuT.gif
  • To add information to an existing diagnostics package, from the Diagnostics Package drop-down list, select the package to add information to.
     
    To create a new diagnostics package, in the Diagnostics Package drop-down list, type the name of the new package.
     
    The Description field displays a description of the diagnostics package. You can edit this description by typing in the field.
     
ka04W00000148IKQAY_0EM440000002AuF.gif
  • On this page, users specify what information users want to collect from the Strategy products installed on the specified machine to include in the diagnostics package.
     
    To include all information about a specific Strategy product in the diagnostics package, select the check box next to that product. To only include information about specific information collectors for a product, click + to expand the product and then select the check boxes next to the information collectors that users want to include information from.
     
    The color of the information collector's name indicates the status of that information collector the last time it was executed:
     
ka04W00000148IKQAY_0EM440000002AuX.gif
  •  
     
    Select Skip configuration of selected items if all required configuration values are filled to skip the pages of the wizard that deal with configuring items for which all required information is already present.
     
     
    • Black: The collector executed successfully. Ex. Strategy Intelligence Server > Log Collector
    • Blue: The collector required additional configuration information. Ex. Strategy Intelligence Server > Cache Collector
    • Orange: The collector was able to partially execute. Ex. Strategy Object Manager > Log Collector
    • Red: The collector was not able to execute. Ex. Strategy Narrowcast Server > Configuration Parameters
       
  • The execution summary page shows the result for each collector with detail explanation.
     
ka04W00000148IKQAY_0EM440000002AuM.gif
  • The Diagnostics Package Summary dialog box allows users to view a summary of a diagnostics package, select a destination for the package, and transmit it to that destination. A diagnostics package contains system information, including log files, collected from one or more Health Agent machines, to assist Strategy Technical Support in troubleshooting usersr system.
     
    The main area of the dialog box contains the following information about the selected diagnostics package:
    • The name of the package.
    • The user who created the package. 
    • The date that the package was created.
    • The date that the package was last modified by the user.
    • The date the package was last sent to a destination.
       
ka04W00000148IKQAY_0EM440000002Aul.gif
  • Users can choose a destination to send the package to. A destination is a location where Health Center can send diagnostics packages to be reviewed by Strategy Technical Support. Health Center supports the following destinations for diagnostics packages:
    • Exported to disk, in the FileDestination subdirectory of the Master Health Agent repository location
    • Transmitted over the network via FTP
    • Transmitted over the network via an encrypted FTP mode (FTPS) that uses SSL
       
ka04W00000148IKQAY_0EM440000002Aub.gif
    •  
      Click Support Destinations to open the Support Destinations dialog box. From this dialog box users can configure destinations, or set a destination as the default.
       
ka04W00000148IKQAY_0EM440000002AuK.gif
    •  
      Strategy provides various FTP/FTPS sites for different geographic regions where Master Health Agents are located. For better result, It is strongly recommended to use regional FTP/FTPS sites information when uploading Diagnostic Packages from Master Health Agents. For more information, visit the technical note below:
       

      KB32556: How to Configure an FTP/FTPS Destination in MicroStrategy Health Center

 
 


Comment

0 comments

Details

Knowledge Article

Published:

May 4, 2017

Last Updated:

February 27, 2018