Installing Replicated by Script

Instructions for installing Replicated via the easy install script.

We provide an easy-to-use one-line installation process (via shell script) which will detect your OS, ask a few questions and install both docker-engine and the required Replicated components.

If you want to always release your application with a specific version of Replicated you can read how to always install a specific version of Replicated.

Basic Install

Save the install script to file and run. We recommend reading and understanding the install script prior to running.

curl -sSL -o install.sh https://get.replicated.com/docker
sudo bash ./install.sh

Quick install

curl -sSL https://get.replicated.com/docker | sudo bash

Release Channel Install Scripts

Every release channel for your application has a custom install link. Using the channel install link allows the Replicated installer will optimize the install process. Based on your app YAML the installer will choose the highest allowed version of Replicated using your configured replicated_version range.

To find the install link, login to your vendor.replicated.com account, select your app and click “build history” for your channel and click “Copy install script url”.

Flags

The install script takes optional flags to configure Replicated for your environment.

Flag Usage
http-proxy Sets the HTTP proxy for Docker and Replicated
no-proxy Skip the proxy prompt
additional-no-proxy Address that can be reached without the HTTP proxy
private-address Set the nodes private IP address
public-address Set the nodes public IP (service) address
no-auto Prompts will wait indefinitely instead of 20 second timeouts
fast-timeouts Prompts with timeouts will wait for 1 second instead of 20 seconds or longer
ui-bind-port Change the default UI port binding from port 8800
docker-version Install with a specific version of Docker
no-docker Skip the docker installation
hard-fail-on-loopback If present, aborts the installation if devicemapper on loopback mode is detected
bypass-storagedriver-warnings For automation bypasses the warning for devicemapper with loopback
log-level Set the log level for Replicated. Can be error, warn, info or debug
no-ce-on-ee Disable installation of Docker CE onto platforms it does not support - RHEL, SLES and Oracle Linux

Example call with flags:

curl -sSL https://get.replicated.com/docker | sudo bash -s no-auto ui-bind-port=8000

Best practices with the easy-install script

When you’re ready to start delivering to customers we recommend that you proxy this install script with a TLS cert matching your domain name. The script should always be served with TLS.

Installing Behind A Proxy

The Replicated installation script supports environments where an HTTP proxy server is required to access the Internet. The installation script will prompt for the proxy address and will set up Replicated and Docker to use the supplied value.

An example of running the Replicated installation script with a proxy server is:

curl -x http://<proxy_address>:<proxy_port> https://get.replicated.com/docker | sudo bash

Post-Installation Maintenance

Upgrade to latest Replicated build

If you would like to upgrade Replicated to the latest release simply rerun the installation script and that will upgrade the Replicated components to the latest build.

Restarting Replicated

If you installed Replicated using the easy installation script, the script will have created an init service you can use to control Replicated. In this case, restarting replicated varies depending on your host OS.

Ubuntu/Debian

service replicated restart
service replicated-ui restart
service replicated-operator restart

CentOS/RHEL/Fedora/Amazon Linux 2

sudo systemctl restart replicated replicated-ui replicated-operator

Amazon Linux 2018.03

restart replicated
restart replicated-ui
restart replicated-operator

Removing Replicated

To remove Replicated, run the following commands:

Ubuntu/Debian

service replicated stop
service replicated-ui stop
service replicated-operator stop
docker stop replicated-premkit
docker stop replicated-statsd
docker rm -f replicated replicated-ui replicated-operator replicated-premkit replicated-statsd retraced-api retraced-processor retraced-cron retraced-nsqd retraced-postgres
docker images | grep "quay\.io/replicated" | awk '{print $3}' | xargs sudo docker rmi -f
docker images | grep "registry\.replicated\.com/library/retraced" | awk '{print $3}' | xargs sudo docker rmi -f
apt-get remove -y replicated replicated-ui replicated-operator
apt-get purge -y replicated replicated-ui replicated-operator
rm -rf /var/lib/replicated* /etc/replicated* /etc/init/replicated* /etc/init.d/replicated* /etc/default/replicated* /var/log/upstart/replicated* /etc/systemd/system/replicated*

CentOS/RHEL/Fedora

systemctl stop replicated replicated-ui replicated-operator
service replicated stop
service replicated-ui stop
service replicated-operator stop
docker stop replicated-premkit
docker stop replicated-statsd
docker rm -f replicated replicated-ui replicated-operator replicated-premkit replicated-statsd retraced-api retraced-processor retraced-cron retraced-nsqd retraced-postgres
docker images | grep "quay\.io/replicated" | awk '{print $3}' | xargs sudo docker rmi -f
docker images | grep "registry\.replicated\.com/library/retraced" | awk '{print $3}' | xargs sudo docker rmi -f
yum remove -y replicated replicated-ui replicated-operator
rm -rf /var/lib/replicated* /etc/replicated* /etc/init/replicated* /etc/default/replicated* /etc/systemd/system/replicated* /etc/sysconfig/replicated* /etc/systemd/system/multi-user.target.wants/replicated* /run/replicated*