Diagnostic and Maintenance Tools
Cleanup MOM
Use this tool to completely remove previous versions of MOM from the file system and from the registry; this includes Windows Installer information and COM registrations. The following versions of MOM can be removed with this utility: MOM 2000, MOM 2000 SP1, beta versions of MOM 2005, MOM 2005 Release Candidates, and MOM 2005.
Note
You should only use this program when you cannot uninstall MOM using Add/Remove Programs.
Type: Command line.
File list: CleanupMOM.exe, CleanupMOM_Readme.doc.
Prerequisites: Administrator privileges.
Installation: Not required.
How to use: Copy the file(s) to the %Program Files%\Microsoft Operations Manager 2005directory. Use the tool as follows:
CleanupMOM.exe [options] Options: /i: <MOM installation directory> //specify the MOM installation directory /z:S //uninstall MOM server component(s) /z:A //uninstall MOM agent component /z:R //uninstall MOM reporting
Computer Group Members Utility
Use this tool to list and view members of a specific computer group. This tool also lists the parent and child computer groups for the specified computer group.
Type: Command line.
File list: CGMembers.exe, CGMembers.xslt, CGMembers_Readme.txt.
Prerequisites: None
How to install: Copy all of the files to %Program Files%\Microsoft Operations Manager 2005.
How to use: From the command prompt, use as follows:
CGMembers -CG CGName [-das dasname -out xmlfilename -xslt xsltfilename]
Where:
CGName: // Name of the Computer group to get information about
dasname: // Name of the DAS (default local computer)
xmlfilename: // xml file name (default is console)
xsltfilename: // xslt file name (default CGMembers.xslt)
Management Group Utility
You use this tool to list the management groups that an agent reports to. In cases where a management group has been decommissioned, without removing configuration information from its agents, you can use this utility to remove invalid configuration information from the agents.
Type: Command line.
File list: MGUtil.exe, MGUtil_Readme.doc
Prerequisites: None
How to use: From the command prompt, use as follows:
MGUtil.exe [options] Used without options, lists all the management groups that an agent reports to. [options] /c // Lists all the corrupted Management Group configurations /r // Removes all the corrupted Management Group configurations
MOM Information Utility
Use this tool for a variety of development and troubleshooting tasks, including:
Collect the rules, responses, and VarSet values from the MOM agent into an XML file, for offline analysis.
Clear the queues on an agent.
Run the utility locally at the agent, and put it into maintenance mode.
Enable script debugging.
Type: Command line.
File list: MOMInfo.exe, MOMInfo_Readme.doc.
Prerequisites: Must be run on the computer on which an agent is installed, or on a Management Server.
How to use: Run from the command prompt, as follows:
MOMInfo.exe <Action Flag> [<Location>] [<Options>] <Action Flag> // Flag specifying the action to perform, can be any one of the following: /rules // dumps the rules as xml (optional) /responses //dumps the responses as xml (optional) /varset // dumps the varset as xml (optional) /clearqueue // Clears all MOM queues (optional) /maintenancemode:<timeout> // Sets maintenance mode (optional), Note:<timeout> is the max amount of time to remain in maintenance mode, defaults to '-1' (INFINITE), set to 'exit' to exit maintenance mode (optional) /scriptdebugging:<script> // sets script debugging (optional), <script> is the name of the script to debug defaults to '*', set to 'off' to turn script debugging off (optional) /errorhandling:<mode> // sets error handling (optional), <mode> is the either off (default), queue, or auto (optional) [<Location>] // location to run the action on (optional, defaults to agent), can be any one of the following: /momagent // returns info from the agent-side (optional) /momserver // returns info from the server-side (optional) [<Options>] // can be any one of the following (optional): /s // suppresses all prompts (optional) /out:<file> // file to contain the output of the action (required for rules, responses, and varset actions) /config:<Config Group> // the configuration or management group to run the action against (optional) /server:<server name> // the server to run the action on (optional)
MOM Inventory
Use this tool to collect all of the information that Product Support Services (PSS) requires to troubleshoot a CAB file. The following information is collected:
All of the MOM Trace logs.
MOM Agent Install logs.
Registry values and ACLs.
Directory ACLs for the MOM installation directory.
Version information for all the binary files in the MOM installation directory.
Values stored in the OnePoint Configuration table
Type: Dialog.
File list: MOMInventory.exe, MOMInventory_Readme.doc
Prerequisites: This tool requires the .NET Framework v1.1.4322 or later.
How to use: From the command prompt, use as follows:
MOMInventory.exe
When the dialog opens:
Click the Run Collection button.
When prompted, provide a location where you want to save the cab file created by this tool.
MOM Trace Log Viewer
Use this tool to filter and view the contents of MOM trace logs (log views that end with an MC8 extension). This enables you to:
Open more than one log, and tile or cascade the child windows.
Refresh the contents of the window. MOM trace logs are always being updated when MOM service is running.
Filter the view in various ways (by function, by thread, etc.).
View the detail of each line in a log.
Search the log file.
Bookmark specific lines for review.
Type: Dialog
File list: MOMLogViewer.exe, MOMLogViewer_Readme.doc
Prerequisites: None
How to use: From the command prompt, use as follows:
MOMLogViewer.exe
After the dialog opens, use File/Open in the dialog (this defaults to %WinDir%\Temp\Microsoft Operations Manager) and select the log that you want to view.
For more information about applying filters or finding specific text, see MOMLogViewer_Readme.doc.
Windows Server Cluster Detection
Use this tool to determine why a MOM agent is not detecting the Virtual Server on a Windows Server Cluster. This tool performs the same checks as the MOM agent service, and provides a report of configuration problems that may prevent MOM from monitoring the Virtual Server.
This utility can be run on one of the servers in Cluster Group, or it can be run remotely against the cluster.
Type: Command line.
File list: MOMClusterTool.exe, MOMClusterTool_Readme.doc.
Prerequisites: None
How to use: Run from the command prompt, as follows:
MOMClusterTool.exe /SERVER:<server name> Run without specifying a server name, the tool performs a simple diagnostic. You can also use the /SERVER:<server name> switch to identify a server that you want to diagnose.