storlets/doc/source/s2aio.rst
Eran Rom 571becce17 moving to devstack first phase
This patch gets rid from all ansible code
as well as the container vs host installations
and does all install in the devstack way.

Changes summary:
1. Add devstack/plugin.sh
2. modify s2aio.sh to:
  - Get rid of all docker / host installation code
  - Get rid of all ansible related code mainly stuff
    that make sure root and user can ssh without a
    password - ansible requirements
3. modify tox.ini and .gitignore accordingly
4. update docs accordingly

Once phase 1 is completed the next phase needs to:
1. Make plugin.sh more devstack friendly. specifically,
   use devstack funcs as mych as possible (e.g. not
   running python setup install directly.)
2. Offer a patch to devstack that would call
   devstack/plugins.sh with appropriate gate

Change-Id: I3818b38a62e264267ce04fa789f1bca07111397d
2017-10-13 15:13:24 +03:00

1.2 KiB

s2aio

s2aio is a script that installs Swift and Storlets all on one. The script allows to do the installation either on the host where it is invoked or in a Docker container.

To install on the host:

To install in a Docker container follow the same steps, replacing the last command with:

./s2aio.sh install dev docker

If you do not have Docker installed on your host, the above script will install it and set docker to use "vfs" as the docker storage driver (instead of the default "aufs" storage driver). If you already have Docker installed, you may need to change its storage driver to "vfs". The created Docker container runs yet another container. Running Docker in Docker may require the usage of the "vfs" storage device.

When installed on the host, the script can be used to start and stop all relevant services using:

./s2aio.sh stop

and

./s2aio.sh start

For the Swift data, the s2aio installation uses a loopback device over a .img file. When shutting down the host, the .img file may get corrupted. Thus, the above stop and start commands are useful when using s2aio.sh for in a long lived hosts that can get rebooted from time to time.