Skip to content

Requirements

No matter which OS you use, the minimum hardware recommendations are as follows:

  • 2 CPU
  • 4GB Memory
  • 30 GB Storage

Debian Based

The punchplatform deployer is supported on these operating systems:

  • Ubuntu 16.04 or later
  • Debian 7 or later (not tested)

Follow this Debian based setup

CentOS Based

The punchplatform deployer is supported on these operating systems:

  • CentOS 7 or later
  • RedHat 7 or later (not tested)

Follow this CentOS based setup

Darwin Based

The punchplatform deployer is supported on MacOS:

Follow this Darwin based setup

Targeted nodes requirements

The target servers are going to be installed with binaries and configurations to run the punchplatform components. The punchplatform deployer tool internally uses ansible to do that.

In this chapter we list the requirements and checks you must ensure before deploying.

Infrastructure requirements

Make sure:

  • All network interfaces are up and configured.
  • Storage partitions are writable and mounted except for Ceph intended block device to manage.

System requirements

  • Administration access: An administration account must be provided and access with SSH from the installation environment to the servers.
    This account must be sudoers to update systemctl configuration for instance.

  • Naming resolution: Naming resolution must be configured. Short and long hostname are resolved.
    When resolving from any target machine the hostname of itself or any other target machine (i.e. the return of 'hostname' command), the result must be the production network interface (as opposed to any other administration or supervision/monitoring dedicated network interface).

  • Time Synchronisation: A full time synchronisation infrastructure like NTP must be configured and running.

  • Repository: Standard repositories of the chosen operating system must be provided. To test the correct configuration, we recommend to update all servers before the punch deployment.
    Internet access is ok, but private repository too.
    For CentOS deployment, EPEL standard repository must be enable and available.

  • system language: System language must be configured to en_US.UTF-8.

    localectl | grep LANG
         System Locale: LANG=en_US.utf8
    
    If this is not the case, change it :
    sudo localectl set-locale LANG=en_US.utf8
    

Elasticsearch requirements

The execution prerequisites are disclosed in Elasticsearch public documentation; the current section highlights some specificities that are often not identified during server/OS setup and may cause deployment problems

  • the /tmp partition must not be mounted with noexec options, otherwise Elasticsearch will fail its bootstrap checks with an error message in its log file :
   system call filters failed to install
  • Elasticsearch by default requires that its process memory may be locked to prevent swapping. The target servers (or virtual servers) must be able to deliver this feature (i.e. no specific hardening) should prevent Elasticsearch from requesting memory lock from the kernel. Elasticsearch checks this at startup time during its 'bootstrap checks' and fail if no/not enough memory could be locked.