[chronojump-server] Added howto_install_networks_server.txt

[Xavier Padullés <xpadulles src gnome org>]

commit e7047294e89395da44b3ad9cbfaeaa72f22fc6b0
Author: Xavier Padullés <x padulles gmail com>
Date:   Mon Jul 1 16:15:51 2019 +0200

    Added howto_install_networks_server.txt

 howto_install_networks_server.txt | 155 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 155 insertions(+)
---
diff --git a/howto_install_networks_server.txt b/howto_install_networks_server.txt
new file mode 100644
index 0000000..998ff49
--- /dev/null
+++ b/howto_install_networks_server.txt
@@ -0,0 +1,155 @@
+----------------
+0. PREREQUISITES
+----------------
+
+- Install Debian 9
+
+apt-get update
+apt-get install mysql-server default-libmysqlclient-dev gunicorn python-dev python-virtualenv python-pip vim 
git virtualenv apache2 gcc gettext
+
+
+- A gandi no es pot escriure en /srv. Per això ho fem tot a /srv2
+
+---------------
+1. APACHE2
+---------------
+
+systemctl start apache2
+
+- To check simply, go with the browser to http://networks.chronojump.org/
+
+-------------
+2. GUINICORN
+-------------
+
+- create the config of gunicorn
+
+mkdir /etc/gunicorn.d
+vim /etc/gunicorn.d/chronojump-api.conf
+
+- copy this text in the file
+
+CONFIG = {
+        'mode': 'wsgi',
+        'environment': {
+                'PYTHONPATH': '/srv2/api-app/venv/lib/python2.7/site-packages/'
+        },
+        'working_dir': '/srv2/api-app',
+        'python': '/srv2/api-app/venv/bin/python',
+        'args': (
+                '--bind=0.0.0.0:8080',
+                '--workers=4',
+                '--error-logfile=/srv2/log/gunicorn/error.log',
+                '--access-logfile=/srv2/log/gunicorn/access.log',
+                '--user=api',
+                '--group=api',
+                'main:app',
+        ),
+}
+
+
+- create the configuration of the server
+
+vim /etc/chronojump.conf
+
+- copy this text in the file
+
+
+[api]
+debug=True
+port=8080
+; port no utilitzat si es fa servir gunicorn
+backtraces_directory=/srv2/backtraces
+chronojump_stable_version=1.7.1.0
+
+[db]
+server=localhost
+user=********
+password=******************
+name=chronojump_django
+
+[notification_emails]
+from=server chronojump org
+to=info chronojump org
+subject=Chronojump error log
+
+[security]
+secret_key=**********
+
+
+- Create the structure of the directories
+
+mkdir /srv2
+mkdir /srv2/log
+mkdir /srv2/log/gunicorn
+mkdir /srv2/backtraces
+mkdir /srv2/api-app
+useradd chronojump
+chown chronojump /srv2/api-app
+git clone https://gitlab.gnome.org/GNOME/chronojump-server.git /srv2/api-app
+
+- Create the virtual enviroment structure and use it
+virtualenv /srv2/api-app/venv
+cd /srv2/api-app/
+. venv/bin/activate
+pip install -r /srv2/api-app/requirements.txt     //De moment no dona error al instal·lar
+
+- Configure the service to start and restart automatically
+
+cp /srv2/api-app/services/start_gunicorn.sh /usr/local/bin/
+chmod +x /usr/local/bin/start_gunicorn.sh
+
+cp /srv2/api-app/services/gunicorn.service /etc/systemd/system/
+systemctl start gunicorn
+
+- Check gunicorn at http://[ADDRESS]:080
+
+---------------
+3. DJANGO
+---------------
+
+- Create the SQL database. Use the system password
+
+mysql -u root
+
+create database chronojump_django;
+create user '[USER]'@'localhost' IDENTIFIED BY '[PASSWORD]';
+GRANT ALL PRIVILEGES ON chronojump_django.* TO django@localhost;
+quit;
+
+- install django in virtual environment
+
+pip install -r /srv2/api-app/requirements/django/base.txt
+pip install -r /srv2/api-app/requirements/django/local.txt
+
+
+- Create django or update tables
+
+export DATABASE_URL='mysql://[USER]:[PASSWORD]@localhost:3306/chronojump_django'
+/srv2/api-app/chronojumpserver-django/manage.py makemigrations
+/srv2/api-app/chronojumpserver-django/manage.py migrate
+
+
+- Compile language translations
+
+/srv2/api-app/chronojumpserver-django/manage.py compilemessages
+
+
+- Create chronojump's admin user:
+
+/srv2/api-app/chronojumpserver-django/manage.py createsuperuser
+user:admin
+email:info chronojump org
+password:[PASSWORD]
+
+
+- Add the url to the ALLOWED_HOSTS
+vim chronojumpserver-django/config/settings/local.py
+
+
+- Run the server
+
+cp /srv2/api-app/services/start_chronojump-server.sh /usr/local/bin/
+chmod +x /usr/local/bin/start_chronojump-server.sh
+cp /srv2/api-app/services/chronojump-server.service /etc/systemd/system
+systemctl start chronojump-server