• Mon Sep 3 12:24:26 CEST 2018: Version 0.12.0a
• Sun Aug 12 16:21:19 CEST 2018: Version 0.11.0a
• Mon Jan 29 00:07:15 CEST 2018: Version 0.9.0a
• Fri Nov 10 19:16:52 CEST 2017: Version 0.8.0.537a
• Fri Mar 31 12:19:00 CEST 2017: Version 0.7.1
• Sun Mar 5 00:04:41 CEST 2017: Version 0.7
• Thu Nov 10 12:30:45 CEST 2016: Version 0.6.2.1
• Wed Oct 12 21:19:21 CEST 2016: Version 0.5.1
• Wed Sep 21 17:56:40 CEST 2016: Version 0.41
• Tue Sep 13 10:52:36 CEST 2016: Version 0.4
• Thu Aug 18 15:44:31 CEST 2016: Version 0.3
• Wed Jun 29 10:44:15 CEST 2016: Version 0.2

• Raúl B. Netto (@Piuliss, [email protected], [email protected])
• Sebastian García (@eldracote, [email protected], [email protected])

    sudo apt-get update ; sudo apt-get upgrade -y

1. Clone the repository

    git clone [email protected]:stratosphereips/Manati.git; cd Manati

  or if you don't want to use SSH, use HTTPS


    git clone https://github.com/stratosphereips/Manati.git; cd Manati

2. Install Virtualenv to isolate the required python libraries for ManaTI, also will be installed python libraries for development

    sudo apt-get install virtualenv python-pip python-dev libpq-dev build-essential libssl-dev libffi-dev

3. Create virtualenv folder

    virtualenv .vmanati

4. Active Virtualenv

    source .vmanati/bin/activate

5. Install PostgreSQL DB engine

    sudo apt-get install postgresql-server-dev-all postgresql-9.5 postgresql-client-9.5

6. Create environment variables files. Copy and rename the files .env.example to .env, and .env-docker.example to .env-docker

    cp .env.example .env
     cp .env-docker.example .env-docker

OPTIONAL
You can modify the password and name of database, if you want. Remember, reflect the changes in the Postgres database settings below.

7. Install required python libraries

    pip install -r requirements/local.txt

  Maybe you will have some issues with permission in the folder ~/.cache, just perform the next command and problem solved:
       sudo chmod 777 ~/.cache
if you deploy to Amazon AWS EC2 and you have a memory error try:


    pip install -r requirements/local.txt --no-cache-dir

8. Start postgresql

    sudo /etc/init.d/postgresql start


Configure the database

9. As root: (There should be a user postgres after installing the database)

    su - postgres

10. Create the database:

    psql
 
     create user manati_db_user with password 'password';
 
     create database manati_db;
 
     grant all privileges on database manati_db to manati_db_user;
 
     alter role manati_db_user createrole createdb;
     
     CTRL-D (to output the postgres db shell)

OPTIONAL
To change the password by default of the postgres user (you can put the same password if you want), specially good idea if you want to use pgAdmin3-4 as a postgres client. Remember don't exit of "sudo - postgres"


    psql
     
     \password;
 
     CTRL-D (to output the postgres db shell)


Verify that the db was created successfully

11. As the postgres user

    psql -h localhost -d manati_db -U manati_db_user
 
     (and put the password)

After putting the password you should be logged in in the postgres.

12. Install redis-server

    sudo apt-get install redis-server

OPTIONAL
If you want to configure the Redis. For example, you are interested to change the password, you can:


    sudo vi /etc/redis/redis.conf

and find the line requirepass and write next it the password that you want.


    requirepass passwodUser

Just remember to update the variable environment REDIS_PASSWORD in the file .env in the root of the project.

13. Run migrate files

    python ./manage.py makemigrations guardian
     python ./manage.py migrate

14. Registering External modules. You must run this command everytime you add or remove an External Module

     python ./manage.py check_external_modules

15. Execute redis_worker.sh file (in background '&' or in another console).

    ./utility/redis_worker.sh

16. Create super user for login in the web system if you need

    python manage.py createsuperuser


How to run it
It is not recommended to run the server as root, but since only root can open ports numbers less than 1024, it is up to you which user you use. By default it opens the port 8000, so you can run it as root:


python ./manage.py runserver

After this, just open your browser in http://localhost:8000/manati_project/manati_ui
If you want to open the server in the network, you can do it with:


python ./manage.py runserver <ip-address>:8000

1. Open project directory

cd path/to/project_directory

2. Pull the last changes from master

git pull origin master

3. Install las libraries installed

pip install -r requirements/local.txt

4. Install redis-server and execute redis_worker.sh file (in background '&' or in another console)

./utility/redis_worker.sh

5. Prepare migrations files for guardian library (if it already has, nothings happens)

python ./manage.py makemigrations guardian --noinput

6. Execute migrations files

python ./manage.py migrate --noinput

7. Registering External modules. You must run this command everytime you add or remove an External Module

python ./manage.py check_external_modules

8. Execute server

python ./manage.py runserver

cd path/to/project_directory 
 python manage.py collectstatic --noinput --clear
 sudo supervisord -c supervisor-manati.conf -n

docker pull honeyjack/manati:latest
 docker run --name manati -p 8888:8888 -dti honeyjack/manati:latest bash

cd Manati
 cp .env.example .env
 cp .env-docker.example .env-docker
 docker-compose build
 docker-compose run web bash -c "python manage.py makemigrations --noinput; python manage.py migrate; python manage.py check_external_modules"
 docker-compose run web bash -c "python manage.py createsuperuser2 --username admin --password Password123 --noinput --email '[email protected]'"
 docker-compose up # or 'docker-compose up -d' if you don't want to see the logs in the console.

pg_dump -U manati_db_user -W -F p manati_db > backup.sql # plain text

psql manati_db -f backup.sql -U manati_db_user