Bastio Agent can be installed in a few ways. You could either install it directly from the code repository, from the PyPI repository, or from our PPA repository.
Before installing Bastio Agent from our PPA repository you will need to set it up so that the APT packaging system will understand how to deal with it. Execute the following commands as root to add the PPA repository through APT:
# apt-add-repository ppa:databracket/bastio-agent
If Ubuntu Synchronizing Key Server (SKS) is down for any reason you can still try hkp://pool.sks-keyservers.net by running the following command:
# apt-add-repository ppa:databracket/bastio-agent --keyserver hkp://pool.sks-keyservers.net
Then run the following commands to install Bastio Agent latest version:
# apt-get update
# apt-get install bastio-agent
After successful installation of the package you can refer to Configuration to finish configuring your fresh installation and start using Bastio Agent.
Note
You do not have to configure Bastio Agent as an OS daemon or service as this installation method takes care of that.
You do not need to have git installed for this method but you will instead need to install pip to be able to install Bastio Agent from the PyPI repository. Please execute the following commands as root:
# mkdir -p /opt/bastio-agent
# virtualenv /opt/bastio-agent
# source /opt/bastio-agent/bin/activate
# pip install bastio-agent
# deactivate
Note
This installation method requires configuring Bastio Agent as a service (see below).
You will need to install git and virtualenv, and of course you will have to have Python v2.7 installed. After cloning the code repository you will need to setup a proper environment to run Bastio Agent from inside a virtual environment. To do so please execute the following commands in the same order as root:
# mkdir -p /opt/bastio-agent
# virtualenv /opt/bastio-agent
# source /opt/bastio-agent/bin/activate
# cd ~/bastio-agent-clone
# python install setup.py
# deactivate
Note
This installation method requires configuring Bastio Agent as a service (see below).
After successful installation of the package you will then need to prepare your operating system to run Bastio Agent as a service or a daemon. You will find in the package under the debian directory a LSB compliant SYSV-init script for your convenience. If you are on a Debian based distribution please carry out the following commands:
# mkdir -p /etc/bastio
# cp ~/bastio-agent-clone/data/agent.conf /etc/bastio/agent.conf
# cp ~/bastio-agent-clone/debian/bastio-agent.init /etc/init.d/bastio-agent
# chmod 0600 /etc/bastio/agent.conf
# chmod 0755 /etc/init.d/bastio-agent
# update-rc.d bastio-agent defaults
Note
You won’t need to carry out these steps if you installed Bastio Agent from our PPA repository.