Incoplax platform installer

The installer installs Incoplax platform on a server: unpacks the docker image, starts containers, and if necessary configures PostgreSQL and shared directories over NFS. It works on the current server and on a remote server via ssh.

First it collects all answers, shows what it is going to do, and changes the server only after confirmation. Until that moment nothing on the server is changed.

Getting started

What the installer does

What the distribution consists of, what entry points exist, and the three phases of operation.

Server requirements

Supported OSes, bash version, space, locale, network.

Preparation

What to do before launching: image, ssh access, proxy, permissions.

Installation

Installation on the current server

Running era/scripts/install.sh on the server itself.

Installation on a remote server

Running install_ssh.sh from your machine.

PostgreSQL separate from the platform

Server in a container or cluster on the host, replication, role switching.

Removal

What is removed, what remains, and how to verify the server is clean.

Start command for an existing container

Recovering the command from a running container.

Unattended operation

Running without questions

The full set of keys, the answers file, and repeated runs.

Logs and return codes

Where the log is, what it contains, and what each code means.

What to do on error

Analysis by return codes and by signs in the log.

End-to-end examples

Ready-made command sequences for typical tasks.

References

Parameter reference

All command-line keys, their defaults, and validators.

Return codes

Table of codes and what each means for the server state.

What is installed on each OS

Differences between families: packages, repositories, SELinux, firewalld.