What the installer does

Incoplax platform is supplied as a docker image. The installer deploys it on a server: installs docker, PostgreSQL if necessary, creates data directories, configures kernel parameters and shared directories, loads the image, and starts the container.

The installer works in three phases and never mixes them.

  1. Collection. Asks questions or takes answers from the command line and the answers file. In this phase it changes nothing: it only reads the server state to warn about problems in advance.

  2. Confirmation. Shows a summary of what was entered and a list of what it is going to do, down to the list of system files that will be changed.

  3. Application. Performs what it showed, writing each command and its result to the log.

Until you agree on the confirmation screen, no changing command is executed on the server. Refusal on this screen leaves no traces.

What the distribution consists of

The distribution is a directory (usually an unpacked zip archive) with entry points at the root and an era directory next to them.

What Why

era/scripts/install.sh, era/scripts/uninstall.sh, era/scripts/install_pg.sh, era/scripts/gen_container_cmd.sh

Commands executed on the server where you are.

install_ssh.sh, uninstall_ssh.sh, install_pg_ssh.sh, gen_container_cmd_ssh.sh

The same, but for a remote server: launched from your machine.

era/era.sh

Dispatcher: bash era/era.sh install …​ — the same as bash era/scripts/install.sh …​.

era/image/

The platform image (era_*.tar.gz) and, if needed, the PostgreSQL image.

era/assets/

The product layer (era_product_*.zip), if used.

era/scripts/

Entry points of this server and installer internals: libraries, message directories, OS matrices. Of the listed items you need only the four commands above — nothing else needs to be touched.

logs/

Run logs. Appears on first launch.

info.txt

A brief summary of this documentation — the same on one page.

The image file name is not hard-coded: incoplax_*.tar.gz, era_*.tar.gz, any_*.tar.gz are suitable. If there are several images, set the required one with the --eradockerimagepath key.

Instance and postfix

Several independent platform installations can run on one server. They are distinguished by the postfix — a string you set with the --postfix key and which is appended to names.

Entity Name

Platform container

era<postfix>

PostgreSQL container

postgres<postfix>

Instance data directory

/opt/era<postfix>

systemd unit for a host cluster

postgresql_<version>_era<postfix>.service

The postfix may be empty — then the container is simply called era. The forms _11, _dev, _test are commonly used.

What the installer changes on the server

The full list depends on the answers and is always shown on the confirmation screen. Usually it is:

  • packages: docker-ce and, when installing the database on the host, postgresql<version>-server;

  • data directories inside /opt/era<postfix>;

  • /etc/sysctl.conf or files in /etc/sysctl.d/ — inotify limits and, on request, network parameters;

  • /etc/exports.d/era_nfs.exports — if the server serves shared directories over NFS;

  • /etc/systemd/system/postgresql_*.service — if the cluster is installed on the host;

  • firewalld rules — on CentOS and relatives, if it is active;

  • docker containers and loaded images.

There is no automatic rollback. Instead, all actions are idempotent: a repeated run with the same answers file is safe and brings the installation to completion.