Knowledge Base

Knowlegebase articles

Welcome to SysOrb knowledge base. Her you will find detailed explanation on questions regarding SysOrb. The list is under continues development and new articles will be added. You can follow the links below or enter a "key word" to search all of the articles.

How to quickly set downtime on an agent

Symptoms: 

When in a hurry or performing emergency administrative actions, it can be rather inconvenient to have to locate a given server in the SysOrb web interface and configure downtime there, in order to prevent false alarms being sent to users in the alert group.

Cause: 

SysOrb versions prior to 3.6 only allowed web based configuration of so-called "unexpected downtime" (the downtime setting used when temporarily disabling alerting from a server for a relatively short amount of time). When performing administrative actions on the server console or on a remote shell, it can be cumbersome to have to also start up the web interface and locate the given server there in order to configure downtime. If downtime is not configured, alerts may be dispatched due to checks spuriously failing because of the administrative actions that are being performed.

If you, for example, need to re-start the web server service or daemon, you risk sending out alerts to other administrators of the server, if you do not configure downtime on the server prior to restarting the service or daemon. Given that the restart often takes just a few seconds, and locating the server (even when using the web interface search feature) might take a minute, it is tempting to just do the re-start and hope SysOrb doesn't notice the missing web service in the few seconds it is away.

Resolution: 

In SysOrb 3.6, downtime can now be set directly from the agent. It is no longer necessary to use the web interface to configure "unexpected downtime" on a server.

On a Windows system you can use the "Set Agent in Downtime" option in the Start Menu. A single click on this option will set 30 minutes of downtime on the node (including SNMP checks, NetChecks and AgentChecks).

On Windows, UNIX and Linux systems you can use a simple command line argument to the agent executable. On the command line run
soagent --down
This too, will set downtime on the node (including SNMP, NetChecks and AgentChecks) for 30 minutes.

If you want another interval you can specify an integer number of minutes with the down option; for example:
soagent --down=90
which will set one and a half hour of downtime.

One significant side effect of this functionality is, that you can now also set downtime easily from your own scripts. If, for example, you have software upgrade scripts or system configuration scripts that re-start services, you can now let these scripts set a few minutes of downtime on the node before they restart services. And there is no longer any excuse for administrators for not setting downtime before restarting services.