A preflight check is a test that is run before installing and running an application. The test will analyze the system to determine if the environment meets the minimum requirements.
The preflight check may be manually run for an existing installation by visiting:
https://[your server address]:8800/run-checks
By default, Replicated automatically adds preflight checks for:
|Linux Kernel||3.10 or greater|
|Docker Version||1.7.1 - 17.12.1-ce|
|Disk Space||/tmp 1 GB
/var/lib/replicated 250 MB
/var/lib/docker 1 GB (docker root directory)
|TCP Ports (Replicated services)||9870-9880 on docker0|
|Outbound internet access (if required)||Replicated APIs, external registries|
Additionally, it’s recommended to specify additional system requirements in the
host_requirements section of the application YAML. These host requirements will apply to single node installs, as well as each node on distributed installs.
name: My Counter App host_requirements: docker_version: "1.10.3" cpu_cores: 2 cpu_mhz: 2400 memory: 8GB disk_space: 80GB docker_space: 10GB replicated_version: ">=2.3.0 <2.4.1"
docker_version refers to the lowest acceptable version of docker on the host. Any host running a docker version at or above this value will meet the requirement.
Replicated enforces these requirements and will not allow the customer to start the application without either meeting these requirements or dismissing the warnings. Upon dismissing preflight warnings, an entry will be recorded in the on-premise audit log.
min_disk_spacedoes not guarantee free space, it refers to the disk size mounted at the specified location.
- The requested
docker_versionmust be one of the versions Replicated supports.
The application level
host_requirements key can be used to automatically upgrade Replicated. This feature can be enabled by specifying a version range in the
replicated_version key. Version range syntax is similar to that used by npm. Versions that don’t support this feature will simply ignore the value. This key is also ignored by the pre-flight checks.