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.
- Agent crashes
- Automatic rescan of all nodes in a domain
- Bandwidth consumption estimate
- Basic database tuning
- Can I customize the reports in SysOrb?
- Disabling specific checks
- Does SysOrb support SNMP traps?
- Explanation of the score keeper strategy.
- How does HTTP Netcheck work in SysOrb?
- How to automatically update alert group on all nodes to “As domain”
- How to backup SysOrb database
- How to change time interval value of agent_checkin_delay
- How to move the SysOrb server to a new server
- How to quickly set downtime on an agent
- I cannot get all of the "performance counters/cache" entries to appear in SysOrb what should I do?
- Migrating MIB information from one SysOrb installation to another
- Migrating the configuration of a Windows SysOrb server from 32 to 64 bits
- No empty blocks in meta database.
- Script to get a list of nodes which have no AlertGroup
- SysOrb agent is not checking in to the Sysorb server
- SysOrb agent stops checking in from a windows server with very long system uptime
- SysOrb server shuts down unexpectedly
- System uptime no longer updates on windows
- Unable to monitor hardware (fans, disks, temperatures etc.) on Windows
- Upgrading SysOrb on Windows
- Uploading a SysOrb database to Evalesco
- What does KiB and MiB mean?
- What is IPMI ?
- Windows agent late for check-in every hour
SysOrb agent is not checking in to the Sysorb server
The SysOrb agent is not checking in to the SysOrb server and you have a red alert in the Checkin column in SysOrb webinterface.
In general the first thing to do is to look for the answer in the SysOrb agent log which can be found on the server where the agent is installed.
On windows the agent log is located in install-dir\Config\agent.log or it can be found in Start menu->Programs->SysOrb.
On unix the default location is
Scroll down to the end of the log file to find the last log entry.
If one of the following similar log entry appears in the agent log then this article explain how to solve it.
Failed to register with server. Will try again in 28 seconds... (failures=8) Reason given: "The SysOrb Server does not have a master key for the "node name" node in the "domain name" domain - release the key on the agent!"
Failed to register with server. Will try again in 28 seconds... (failures=8) Reason given: "The SysOrb Server does not have a master key for the "node name" node in the "domain name" domain - release the key on the server!"
The first time the SysOrb agent contact the SysOrb server it will negotiate an encryption key with the server. This key will provide mutual authentication between the SysOrb Server and the SysOrb agent for all future communication. If one party loses the key, the two will be unable to mutually authenticate each other the next time the SysOrb Agent contacts the SysOrb Server.
If, for example, the Node is deleted from the web interface, the associated key is deleted on the SysOrb Server. In that situation, the key must be released on the corresponding SysOrb Agent to allow the two to negotiate a new key (scenario 1).
If, for example, the server on which the SysOrb Agent is running, is re-installed, the negotiated key will be lost on this system. In that situation, the key on the SysOrb Server must be released so that the SysOrb Server and SysOrb Agent can again negotiate a key (scenario 2).
Release key on the agent (scenario 1)
On windows open the SysOrb configuration utility located in Start menu->Programs->SysOrb->SysOrb configuration. In the configuration tree choose SysOrb agent->General->Release Key. In the dialog on the right side of the configuration dialog click the Release Key button.
To release the agent key on a Unix-like system, you must delete the variables file while the SysOrb agent daemon is stopped. The location of the variables file is configured in the agent.conf file on the host where the agent runs usually:
/etc/init.d/soagent stop ; rm /var/sysorb/variables.agent ; /etc/init.d/soagent start
To release the agent key on a NetWare system, you must delete the variables file while the SysOrb agent NLM is unloaded. The location of the variables file is configured in the AGENT.CFG file on the host where the agent runs ususally:
Release Key on server side Scenario 2)
To release the key on server, do the following in the SysOrb web interface:
After you have released key on either SysOrb agent or SysOrb server wait a few minutes and observe. Now the agent should start to check in again.