System Requirements for 7.1.1

System Requirements and prerequisites

Hardware and resource requirements

GroundWork recommends the following minimum hardware specification for basic operation:

  • 64-bit architecture
  • 2 CPU
  • 4 GB RAM
  • 30 GB disk

If you are deploying to an environment that has any complexity there are a number of considerations to be made and Support can help you size your system but a good starting point for reference is the following:

  • 4 or more CPUs
  • 32 GB RAM
  • 100 GB disk

OS platform requirements

GroundWork Monitor Enterprise Edition has been tested on the following platforms:

  • Red Hat Enterprise Linux 6 Server and 7 Server, 64-bit.
  • CentOS 6 and 7, 64-bit.
  • SuSE Linux Enterprise Server 11sp4 and 12 64-bit. SuSE has ended support for SLES 10 and GroundWork no longer supports new installation (7.0.2 or newer) on SLES 10.
  • Ubuntu Server 12.04 LTS, 14.04 LTS, and 16.04 LTS, 64-bit. Ubuntu 8.04 LTS and 10.04 LTS have reached end-of-life and GroundWork no longer supports new installations (7.1.1 or newer) on these versions. Ubuntu 12.04 LTS will be EOL in April 2017, so it is not recommended.
Special Considerations for Virtualized Environments
Monitoring inherently has a continuous high-load resource profile. This must be taken into account when deciding whether to run in a virtualized environment, and if so, when allocating resources to a virtual host running the monitoring. If you try to install on a virtual host which has too much contention from other VMs on the same host, results are likely to be disappointing.

If you are installing in a virtualized environment, particularly VMware ESX, using a single virtual CPU is generally recommended. As with a standalone machine, a 64-bit virtual machine is required for the GroundWork Monitor Enterprise 7.1.1 release. Installation of VMware tools and configuration of host time synchronization is highly recommended in all VMware environments.

System configuration and operating system settings

Please read the following requirements carefully before you install GroundWork Monitor Enterprise packages:

  • The host name of the GroundWork Monitor server must be resolveable with DNS to its external interface's address, both from the server itself and the workstations and other servers that will use it. This is a hard requirement and GroundWork will not work if the name does not resolve.
  • Time and date must be accurate on the systems running GroundWork, and preferably synchronized to a time server using NTP or a similar method. Time Zone should be set correctly.
  • GroundWork Monitor Enterprise 7.1.1 must be installed on a 64-bit system.
  • The GroundWork installer must be able to install into the /usr/local/groundwork/ file tree.
  • The uid and gid of the root user must both be 0.
  • The default group for the root user must be root.
  • The nagios user and group must be local to the system and not provided via directory services. Ideally, for a fresh install, these user/group names do not already exist on the system.
  • If the nagios user exists (not necessary), the default group for nagios must be nagios.
  • Make sure that the system you install to does not have a pre-installed Apache server or PostgreSQL database.
  • The partition that GroundWork Monitor is installed to must allow setuid execution.
  • If SELinux is installed, disable it prior to installation. The permissive setting is insufficient; it must be set to disabled.
    /etc/selinux/config
    SELINUX=disabled

    Disable it immediately, prior to running the GroundWork binary installer:

    setenforce 0
  • Please ensure that libX11 is installed prior to installing GroundWork. For example, on Red Hat or Centos systems the commands: 
    yum groupinstall base
yum install libX11

    will ensure the libraries needed are present.

    Special Configuration for Virtualized Environments
    • If GroundWork Monitor Enterprise is deployed under VMware, resource allocation is critical to performant operation of the monitoring. For a small-to-medium installation, only allocate 1 CPU to the virtual machine; allocating more CPUs can sometimes result in worse performance. For large installations, the situation is more complex, and testing is required to get optimal settings. (A full discussion of VMware configuration is beyond the scope of this install guide.)
    • In a virtualized environment, a memory reservation of 4 GB should be considered the absolute minimum. A memory reservation of 8 GB or larger is generally recommended. A memory allocation of 8 GB or more should be applied to the VM.
    • If GroundWork Monitor Enterprise is deployed under VMware, running X Windows on that VM is strongly discouraged. High rates of interrupts from the windowing system can have a significant negative effect on performance in a virtualized environment, due to the extra overhead of switching CPUs between VM guest hosts.

Java Compatibility

GroundWork Monitor specifically requires Sun Microsystems' Java SDK version 1.7 Update 76. This software is included in the GroundWork installation bundle. Under some circumstances, other Java packages can interfere with the Sun provided software, but generally as of 7.1.1, there is little chance of this. Still we recommend not using any separate JVM on the same machine as GroundWork.

Externally defined user nagios

GroundWork Monitor uses the user account named nagios for access control to several components in the system. For this reason we prefer that the nagios user NOT exist prior to installation; the installer will then create the user and group, its home directory, and its dot-file setup in the manner we require. If you have any of the following conditions:

  • The nagios user is already defined on the system.
  • You have modified /etc/nsswitch.conf to support maintaining this user in some place other than local password/shadow/group files.
  • You are using external authentication of another kind (e.g., LDAP) with the nagios user defined in a way that will inhibit the GroundWork installer from creating this user and its home directory,

then you must disable and remove all traces of the nagios user before the installation. To reenable such prior setup after the installation, you must take whatever steps are necessary to ensure that the user number is the same as that used by the GroundWork-installed user nagios. Also note that if the nagios user already exists before the installation, the nagios home directory is assumed to exist, and reside at /usr/local/groundwork/users/nagios.

Requirements for a separate PostgreSQL database location

In a simple install, the PostgreSQL databases will reside on the GroundWork Monitor system itself, but you may prefer to run the databases on a separate machine. See instructions for the remote database installation here. The database server supports the same Operating Systems as GroundWork Monitor, which are:

  • Red Hat Enterprise Linux 6 Server and 7 Server, 64-bit.
  • CentOS 6 and 7, 64-bit.
  • SuSE Linux Enterprise Server 11sp4 and 12, 64-bit.
  • Ubuntu Server 12.04 LTS, 14.04 LTS, and 16.04 LTS, 64-bit. Ubuntu 12.04 LTS will be EOL in April 2017, so it is not recommended.

The minimal system requirements for a separate database install are:

  • 64-bit CPU (required)
  • 2 CPU, 3 GHz P4 or equivalent
  • 4 GB RAM
  • 80 GB disk
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.