Fresh installation of ECE using Podman hosts
editFresh installation of ECE using Podman hosts
editThis section provides guidelines and recommendations to install ECE using a Podman-based environment. The recommended approach consists of two (2) high-level steps.
Step 1: Install ECE.
Step 2: Add additional Podman hosts
When copy-pasting commands, verify that characters like quotes (“) are encoded correctly in the console where you copy the command to.
Steps that run commands starting with sudo
can be run as any sudoers user.
Otherwise, the corresponding user is mentioned as part of the step description.
Avoid customizing the host Docker path /mnt/data/docker
when using SELinux. Otherwise the ECE installer script needs to be adjusted.
-
Install ECE
Use the ECE installer script together with the
--podman
flag.Refer to the official Install ECE online documentation to adapt the command line parameters to your environment.
JVM heap sizes describes recommended JVM options.
Important while running
./elastic-cloud-enterprise.sh
-
Execute the installer script as user
elastic
. - Ensure to use an installer script that supports podman.
-
Make sure you use
--podman
. -
Use
--cloud-enterprise-version VERSION_NAME
to specify the correct version. -
If you are using SELinux, make sure you also use
--selinux
.
-
Execute the installer script as user
-
Add additional Podman hosts
Refer to the official Install Elastic Cloud Enterprise on an additional host and Install ECE online documentation to adapt the command line parameters to your environment including fetching the role token.
JVM heap sizes describes recommended JVM options.
Important while running
./elastic-cloud-enterprise.sh
-
Execute the installer script as user
elastic
. - Ensure to use an installer script that supports podman.
-
Make sure you use
--podman
. -
To fetch a role token following the Generate Roles Tokens guidelines, you need to send a JSON token to the admin console. Double check the correct format of the roles. Roles are a list of individual strings in quotes, NOT a single string.
Example
{ "persistent": true, "roles": [ "allocator","coordinator","director","proxy" ] }
-
The ECE version of the additional host must be the same as the version used in step 2. Use
--cloud-enterprise-version VERSION_NAME
to specify the correct version. -
Make sure to apply the roles to the additional host. The value for the
--roles
flag is a single string.Example
--roles "allocator,coordinator,director,proxy"
To add a new allocator, use
--roles "allocator"
. To add a new coordinator, director, proxy, and allocator, use--roles "allocator,coordinator,director,proxy"
-
Execute the installer script as user