2020-02-02 11:37:49 +00:00
|
|
|
Installation
|
|
|
|
|
2020-02-18 21:48:21 +00:00
|
|
|
1. Get the source
|
2020-02-02 11:37:49 +00:00
|
|
|
Get the source code by running
|
|
|
|
$ git clone https://git.freesoftwareextremist.com/bloat
|
|
|
|
You can also download the latest source tarball from the URL
|
|
|
|
"https://git.freesoftwareextremist.com/bloat/snapshot/bloat-master.tar.gz"
|
|
|
|
|
|
|
|
2. Build and install
|
2020-02-18 21:48:21 +00:00
|
|
|
Install GO from your system's package manager or from https://golang.org/dl.
|
|
|
|
Then run make to compile the source.
|
2020-02-02 11:37:49 +00:00
|
|
|
$ make
|
|
|
|
# make install
|
|
|
|
This will perform a system wide installation of bloat. By default, it will
|
2020-02-18 21:48:21 +00:00
|
|
|
install the binary in /usr/local/bin and data files in /usr/local/share/bloat.
|
|
|
|
You can change these paths by editing the Makefile.
|
|
|
|
|
|
|
|
3. Edit and copy the config file
|
|
|
|
Edit the generated config file to you liking and then copy it to the default
|
|
|
|
config location. Comments in the config file describe what each config value
|
|
|
|
does. For most cases, you only need to change the value of "client_website".
|
|
|
|
$ $EDITOR bloat.def.conf
|
|
|
|
# cp bloat.def.conf /etc/bloat.conf
|
|
|
|
|
|
|
|
4. Create database directory
|
|
|
|
Create a directory to store session information. Optionally, create a user
|
|
|
|
to run bloat and change the ownership of the database directory accordingly.
|
|
|
|
# mkdir /var/bloat
|
2020-02-02 11:37:49 +00:00
|
|
|
# useradd _bloat
|
|
|
|
# chown -R _bloat:_bloat /var/bloat
|
2020-02-18 21:48:21 +00:00
|
|
|
Replace /var/bloat with the value you specified in the config file.
|
2020-02-02 11:37:49 +00:00
|
|
|
|
|
|
|
5. Run the binary
|
|
|
|
# su _bloat -c bloat
|
2020-02-18 21:48:21 +00:00
|
|
|
Now you should create an init script to automatically start bloat at system
|
|
|
|
startup.
|
|
|
|
|
|
|
|
|
|
|
|
Update
|
|
|
|
|
|
|
|
Either run git pull to fetch the updated source or download the latest tarball
|
|
|
|
from the URL mentioned in the installation step. Then run make to install the
|
|
|
|
updated binary and data files
|
|
|
|
$ git pull
|
|
|
|
$ make
|
|
|
|
# make install
|
|
|
|
|
|
|
|
|
|
|
|
Note: Commands starting with # are to be is to run as root.
|