Install StorageOS with Docker by oicheryl

Prerequisites

In this tutorial, you will install StorageOS on a three node Docker cluster. Open up terminals for the second and third host (type yes where prompted):

ssh [email protected] ssh [email protected]

NBD (Network Block Device) is a default Linux kernel module that allows block devices to be run in userspace. It is not a requirement for StorageOS to run, but improves performance significantly.

Enable the module on each host in turn: sudo modprobe nbd nbds_max=1024 sudo modprobe nbd nbds_max=1024 sudo modprobe nbd nbds_max=1024

You should also install the StorageOS CLI:

curl -sSLo storageos https://github.com/storageos/go-cli/releases/download/0.10.0/storageos_linux_amd64 && chmod +x storageos && sudo mv storageos /usr/local/bin/

and set the environment variables so you can connect to the cluster:

export STORAGEOS_USERNAME=storageos STORAGEOS_PASSWORD=storageos STORAGEOS_HOST=[[HOST_IP]]

Installation

Now you can install the StorageOS node container on each host.

In the first terminal:

docker run -d --name storageos -e HOSTNAME=host01 -e ADVERTISE_IP=[[HOST_IP]] -e JOIN=[[HOST_IP]] --net=host --pid=host --privileged --cap-add SYS_ADMIN --device /dev/fuse -v /var/lib/storageos:/var/lib/storageos:rshared -v /run/docker/plugins:/run/docker/plugins storageos/node:0.10.0 server

Wait until the container reports that it is healthy:

docker ps

and confirm that StorageOS has started on the first node:

storageos node ls

Second node

Now switch to the second node and install the container again:

docker run -d --name storageos -e HOSTNAME=host02 -e ADVERTISE_IP=[[HOST2_IP]] -e JOIN=[[HOST_IP]] --net=host --pid=host --privileged --cap-add SYS_ADMIN --device /dev/fuse -v /var/lib/storageos:/var/lib/storageos:rshared -v /run/docker/plugins:/run/docker/plugins storageos/node:0.10.0 server

Confirm that the installation was successful:

docker ps

and that you have a two node cluster:

storageos node ls

Third node

Now start StorageOS on the last node:

docker run -d --name storageos -e HOSTNAME=host03 -e ADVERTISE_IP=[[HOST3_IP]] -e JOIN=[[HOST_IP]] --net=host --pid=host --privileged --cap-add SYS_ADMIN --device /dev/fuse -v /var/lib/storageos:/var/lib/storageos:rshared -v /run/docker/plugins:/run/docker/plugins storageos/node:0.10.0 server

Confirm that the installation was successful:

docker ps

You should now have three nodes in your cluster:

storageos node ls

Cluster health

Check on the status of the different components:

storageos cluster health

If they are any problems, check the Docker logs:

docker logs storageos

cd <directory>	Change directory
ls	List directory
echo 'contents' > <file>	Write contents to a file
cat <file>	Output contents of file

i	In Command Mode	Change into Insert Mode, you can now insert and edit text in the file
esc	In Insert Mode	Change into Command Mode, you can now execute commands
:wq	In Command Mode	Save and Exit

Welcome!

Install StorageOS with Docker

Congratulations!

You've completed the scenario!

Scenario Rating

Steps