Pulse Server Docker Requirements

Pulse provides two types of installation modes:

Online Installation: The Pulse server must have the accessibility to connect to the internet directly or via proxy for pulling Pulse packages.

Offline Installation: In this route, the user must whitelist the following URLs and complete the offline Pulse-based installation.

• https://191579300362.dkr.ecr.us-east-1.amazonaws.com/Acceldata/*
• https://prod-us-east-1-starport-layer-bucket.s3.us-east-1.amazonaws.com/*
• https://api.ecr.us-east-1.amazonaws.com/*
• https://accelo-binaries.s3.amazonaws.com/*
• https://accelo-binaries.s3-us-west-1.amazonaws.com/*

Docker Compatibility Matrix

The following table describes the compatibility matrix for various versions of Docker with Pulse.

Docker

Only Pulse servers require Docker CE, and support is only accessible on certain operating systems, as specified in the official Docker manual Install Docker Engine.

Online Installation

Instructions to install Docker CE via online is available on official docker documentation Install Docker Engine.

Commands for CentOS:

sudo yum install -y yum-utils

​

sudo yum-config-manager \

    --add-repo \

    https://download.docker.com/linux/centos/docker-ce.repo

​

sudo yum -y install docker-ce docker-ce-cli containerd.io

​

docker version

Proxy Based Online Installation

If your Pulse server is placed behind a proxy server and cannot connect to the Internet directly, verify if the proxy servers are working as expected by using either the curl or wget command. You must use a random website for testing.

Export and configure the necessary proxies to access the internet, then repeat the preceding steps to download and install Docker packages. After the preceding steps are completed, add the following configurations:

• Your proxy URI can be the same for both HTTP and HTTPS protocols. If URI is the same for both the protocols, you must verify if the URI works as expected, for both the protocols. If you have a HTTP proxy URI, create a file http-proxy.conf (if it does not already exist), in the location /etc/systemd/system/docker.service.d and add the following content:

[Service]

Environment="HTTP_PROXY=<YOUR_HTTP_PROXY_URI>"

• If you have a HTTPS proxy URI, create a file https-proxy.conf (if it does not already exist), in the location /etc/systemd/system/docker.service.d and add the following content:

[Service]

Environment="HTTP_PROXY=<YOUR_HTTPS_PROXY_URI>"

Offline Installation

Acceldata provides a link to download the offline RPM bundle for Docker CE binaries(only for RHEL/CentOS) along with the Pulse image tarball file, download these two files and unpack them on the Pulse server:

Steps to Install Docker from Offline RPM(s):

• Unzip the docker rpms on Pulse server
• Go to unzipped folder
• Execute command: rpm -ivh ./*
• Post above command gets completed, please validate with docker version command

Steps to Load Pulse Images on Docker:

• Download all the container images (*.tgzfiles) and keep it inside the images directory.
• When you download the Pulse all in one TAR file, you must also download the ad-oozie-connector.tgzfile separately for Pulse versions 3.0.3, 3.0.2, 3.0.1, and, 3.0.0.
• Go to the images directory and run following command.

ls -1 *.tgz | xargs --no-run-if-empty -L 1 docker load -i

Common Steps

Post above docker installation either via offline or online way, follow below steps for common instructions to complete Docker installation:

1. Create the file called daemon.json in the path /etc/docker. The file path must be path /etc/docker/daemon.json.

mkdir -p /etc/docker

vi /etc/docker/daemon.json

2. Add the following block of code to the newly created daemon.json file.

{

 "live-restore": true,

 "log-driver": "json-file",

 "log-opts": {

   "mode": "non-blocking",

   "max-buffer-size": "4m",

   "max-size": "10m",

   "max-file": "3"

 }

}

3. Restart, check status, and enable Docker using the following commands:

sudo systemctl daemon-reload

​

sudo systemctl restart docker

​

sudo systemctl enable docker

​

sudo systemctl status -l docker

4. (Optional) In case Pulse setup is through a “non-root” user to run the Docker containers, that user needs to be added to the “docker” group by running the following command:
   • Replace the <CURRENT_USERNAME> with your Linux username sudo usermod -aG docker <CURRENT_USERNAME>

Example: To add a user “accel” to “docker” group sudo usermod -aG docker accel