AgentMM - A command line tool to place OpsMgr agents into Maintenance mode
Here's a command line line tool I've written using C# (requires .Net Framework 3.0) to put OpsMgr agents into maintenance mode similar to that using the PowerShell script written by Boris (see https://blogs.msdn.com/boris_yanushpolsky/archive/2007/08/06/so-what-is-in-maintenance-mode.aspx & https://blogs.msdn.com/boris_yanushpolsky/archive/2007/08/30/stoping-maintenance-mode.aspx). The utility places three objects into maintenance mode when requiring to physically power down a computer for maintenance. This is a requirement from the console too, which is a question which has been raised numerous times and is unfortunately not an easy streamlined task within the OpsMgr console. For example, if you need to power down a server for hardware upgrade or service pack upgrade, from the OpsMgr console you would need to perform the following steps to prevent OpsMgr alerting you that the machine was offline:
1) From the Monitoring space, Computers view you would select the computer and place it in maintenance mode. This places the Agent in maintenance mode but NOT the HealthService instance or HealthServiceWatcher instance. (So missing the next steps if the machine was shut down would produce an alert with description "The computer <agentFQDN> was not pingable" with path Microsoft.SystemCenter.AgentWatchersGroup\<agentFQDN>. This is in response to a 20022 OpsMgr Connector event logged on the RMS due to the HeathService on the agent failing to heartbeat and a resultant diagnostic using Win32_PingStatus.
2) From the Discovered Inventory node, choose the State Actions, Change Target type and from View Common Targets select Health Service. Choose the Health Service for the agent in step 1 and place it in Maintenance mode
3) From the Discovered Inventory node, choose the State Actions, Change Target type and from View All Targets select Health Service Watcher. Choose the agent name from list and place it in Maintenance mode.
Using these three steps you will avoid alerts when a computer is completely shut down. NOTE: Placing Management servers into maintenance mode while they are operational, especially the RMS is not recommended or supported. Placing the RMS into Maintenance mode will essentially unload the workflow responsible for ending maintenance mode, so you'll find maintenance mode never ends (This is mention although briefly in the Online help under "Maintenance Mode in Operations Manager 2007".
Alternatatively you can use the utility below to place individual agents into maintenance mode when those agents are to be completely shutdown. AgentMM is an unsupported utility, you use at your own risk.
https://home.comcast.net/~the_eastwoods/MOMDownloads/AgentMM.zip
9/19 - A few issues I've found or had reported with this version: 1) OpsMgr Administrator rights are required to use AgentMM. If you use the admin console you would need minimally Operator rights. I'll attempt to sort this out. 2) the domain\username for remote connections does require a backslash delimitter.
Here's the command line help:
This utility can be used to place an agent in maintenance mode when that agent is to be taken offline (shut down) completely.
The Agent, the HealthService and the HealthServiceWatcher are placed into maintenance mode by AgentMM allowing the agent to be shut down without alerts being generated.
Command line usage to begin maintenance mode :
______________________________________________
AgentMM [/S[erver] <sdkservername> domain/user] <AgentFQDN> <Comment> <Reasoncode> <MMStartDateTime> <MMEndDateTime> [/Test]
/S[erver] <sdkservername> domain\user - Are optional. Allows maintenance mode to be issued remotely. See DLL's required below.
<AgentFQDN> - Is the fully qualified domain name of the agent to be placed in maintenance mode
<Comment> - Is a comment on why the agent is being placed into maintenance mode. Delimit with " for comments including spaces
<Reasoncode> - Is an integer valid from the list of reasons list below
MMStartDateTime is a date and time to start maintenence mode. This is entered in short date/time format for your locale. e.g. "09/12/07 17:35". Delimit with "
MMEndDateTime is a date and time to end maintenence mode. This is entered in short date/time format for your locale. e.g. "09/12/07 18:50". Delimit with "
Command line usage to end maintenance mode :
____________________________________________
AgentMM [/S[erver] <sdkservername> domain/user] /Stop <AgentFQDN>
Shortcuts to usage:
___________________
MMStartDateTime can be entered using the word Now to signify the current date/time.
MMEndDateTime can be entered using an offset in Minutes or Hours from the MMStartDateTime. Use +30m for example to schedule a 30 minute window. Use +6h for example for schedule a 6
hour window.
List of Reasoncode values (0-14):
_________________________________
0 = ApplicationInstallation (An application is installed.)
1 = ApplicationUnresponsive (An application is unresponsive.)
2 = ApplicationUnstable (An application is unstable.)
3 = LossOfNetworkConnectivity (A loss of network connectivity has occurred.)
4 = PlannedApplicationMaintenance (Planned application maintenance.)
5 = PlannedHardwareInstallation (Planned hardware installation.)
6 = PlannedHardwareMaintenance (Planned hardware maintenance.)
7 = PlannedOperatingSystemReconfiguration (Planned operating system reconfiguration.)
8 = PlannedOther (Another planned reason not listed in this enumeration.)
9 = SecurityIssue (A security issue.)
10 = UnplannedApplicationMaintenance (Unplanned application maintenance.)
11 = UnplannedHardwareInstallation (Unplanned hardware installation.)
12 = UnplannedHardwareMaintenance (Unplanned hardware maintenance.)
13 = UnplannedOperatingSystemReconfiguration (Unplanned operating system reconfiguration.)
14 = UnplannedOther (Another unplanned reason that is not listed in this enumeration.)
Example of usage:
_________________
AgentMM ServerX1.contoso.com 0 "Installing Service Pack 2" Now +45m
The command above schedules maintenance mode to begin for agent ServerX1, specifying a reason as ApplicationInstallation, lasting 45 minutes
AgentMM /S OpsMgrRMS contoso\opsmgradmin ServerX1.contoso.com 5 "Installing additional memory" Now "9/28/07 18:00:00"
The command above schedules maintenance mode to begin for agent ServerX1, specifying a reason as PlannedHardwareMaintenance.
What is test mode:
__________________
Adding a last parameter on the command line called /Test will not actually place any object in Maintenance mode.
Test mode will simply verify an agent with the support FQDN can be located and its current status together with a verification of command line parameters.
Not available in this version of AgentMM:
_________________________________________
No ability to update Maintenance mode settings for an agent already in maintenance mode.
No ability to target groups at this time. Nice to have, maybe next time.
Remote connnections require the assemblies Microsoft.EnterpriseManagement.OperationsManager.DLL and Microsoft.EnterpriseManagement.OperationsManager.Common.DLL to be present.
Comments
Anonymous
January 01, 2003
Happy new year to all! A few things I thought might be of interest! Maintenance mode Questions relatingAnonymous
January 01, 2003
I'd like to say "great tool" however I have been unable to successfully run it yet. I'm getting the following error when I run it: Unhandled Exception: System.IO.FileNotFoundException: Could not load file or assembly 'Microsoft.EnterpriseManagement.OperationsManager, Version=6.0.4900.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35' or one of its dependencies. The system cannot find the file specified. File name: 'Microsoft.EnterpriseManagement.OperationsManager, Version=6.0.4900.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35' at AgentMM.AgentMM.Main(String[] args) WRN: Assembly binding logging is turned OFF. To enable assembly bind failure logging, set the registry value [HKLMSoftwareMicrosoftFusion!EnableLog] (DWORD) to 1. Note: There is some performance penalty associated with assembly bind failure logging. To turn this feature off, remove the registry value [HKLMSoftwareMicrosoftFusion!EnableLog]. Any assistance with this issue would be greatly appreciated. Cliveea - You will need the SDK binaries Microsoft.Enterprisemanagement.OperationsManager.dll and Microsoft.EnterpriseManagement.OperationsManager.Common.dll copied to the same folder as Agentmm. You can find these in the SDK Binaries folder beneath the Opsmgr install on the Management Server.Anonymous
January 01, 2003
Summary This document will provide guidance to online links, resources, tools and blogs to assist inAnonymous
January 01, 2003
There are so many tools currently developed that it is hard to know where to find them. Here is a listAnonymous
January 01, 2003
There are many articles that talk about maintenance mode in System Center Operations Manager 2007. TopicsAnonymous
January 01, 2003
Happy new year to all! A few things I thought might be of interest! Maintenance mode Questions relatingAnonymous
January 01, 2003
So you have a simple case where a server operator needs to perform some maintenance and he does not haveAnonymous
January 01, 2003
At day 2 one of the sessions I followed covered the future of opsmgr. They announced that at the endAnonymous
January 01, 2003
PingBack from http://www.technotesblog.com/?p=548Anonymous
January 01, 2003
If you open the properties of this alert rule, you'll see that the configuration data source scans theAnonymous
January 01, 2003
The KB http://support.microsoft.com/kb/942866/en-us discussing the behaviour of maintenance mode whenAnonymous
January 01, 2003
  Voici une liste de liens trĂ©s pratique sur tous les sujets SCOM , installation , configuration...Anonymous
January 01, 2003
Main Downloads page (catalog, documentation) http://technet.microsoft.com/en-us/opsmgr/bb498232.aspxAnonymous
January 01, 2003
The comment has been removedAnonymous
January 01, 2003
Clive Eastwood , from Microsoft, has released a very nice maintenance mode tool for Opsmgr. With thisAnonymous
January 01, 2003
The comment has been removed