Merge pull request #39 from beescoop/install-readme

obeesdoo installation guides
7 years ago · 9fa90e62e0
3 changed files with 426 additions and 1 deletions
--- a/README.md
+++ b/README.md
@ -1,8 +1,96 @@
 # Obeesdoo
 Specific module for the Beescoop
 ## Install odoo
 # Migrate barcode
 - cf. [install-odoo-linux-server.md](install-odoo-linux-server.md) (review)
 - cf. [install-odoo-mac.md] (install-odoo-mac.md)
 ## Setup obeesdoo
 ##### 1) clone repos
 ```
 $ cd projects
 $ git clone https://github.com/beescoop/Obeesdoo.git obeesdoo -b 9.0 --depth 1
 $ git clone https://github.com/houssine78/vertical-cooperative.git vertical-cooperative -b 9.0 --depth 1
 $ git clone https://github.com/houssine78/addons.git houssine-addons -b 9.0 --depth 1
 $ git clone https://github.com/coopiteasy/procurement-addons procurement-addons -b 9.0 --depth 1
 $ git clone https://www.github.com/OCA/l10n-belgium -b 9.0 --depth 1
 $ git clone https://www.github.com/OCA/mis-builder -b 9.0 --depth 1
 $ git clone https://www.github.com/OCA/web -b 9.0 --depth 1
 $ git clone https://github.com/OCA/server-tools -b 9.0 --depth 1
 $ git clone https://github.com/OCA/reporting-engine -b 9.0 --depth 1
 ```
 todo: setup git submodules
 ##### 2) install wkhtmltopdf
 Download and install [wkhtmltopdf version 0.12.1](https://github.com/wkhtmltopdf/wkhtmltopdf/releases/0.12.1)
 ##### 3) set up the database and import production data.
 ```
 $ createuser -d odoo
 $ createdb beescoop -o odoo
 $ gunzip <dump-file>.sql.gz
 $ psql beescoop <dump-file>.sql
 ```
 ##### 4) deactivate cron jobs and mails 
 ```
 $ psql -d beescoop -c "UPDATE ir_cron SET active='f' WHERE active='t';"
 $ psql -d beescoop -c "update ir_mail_server set smtp_encryption='none', smtp_port=1025, smtp_host='localhost',smtp_user='', smtp_pass='';"
 $ psql -d beescoop -c "UPDATE fetchmail_server SET active='f', password='', server='localhost';"
 ```
 ##### 5) create odoo.conf
 ```
 $ export ODOO_HOME='~/projects'
 $ vi $ODOO_HOME/odoo.conf
 ```
 ```
 [options]
 ; This is the password that allows database operations:
 ; admin_passwd = admin
 debug=True
 dev=True
 db_host=False
 db_port=False
 db_user=odoo
 db_password=False
 addons_path=addons,openerp/addons,$ODOO_HOME/obeesdoo,$ODOO_HOME/vertical-cooperative,$ODOO_HOME/houssine-addons,$ODOO_HOME/procurement-addons,$ODOO_HOME/l10n-belgium,$ODOO_HOME/mis-builder,$ODOO_HOME/web,$ODOO_HOME/server-tools,$ODOO_HOME/reporting-engine
 ```
 ##### 6) update database structure
 ```
 $ cd ~/projects/odoo
 $ psql -d tmp_march_beescoop -c "truncate product_scale_log"
 $ python odoo.py -c $ODOO_HOME/odoo.conf -u all -d odoo-test --stop-after-init
 ```
 ### Troubleshoot
 Missing libraries
 ```
 pip install pycoda
 pip install xlsxwriter
 ```
 Can't update `product_scale_log` table (I did not write down the exact error)
 ```
 truncate table product_scale_log
 ```
 ## Migrate barcode
 ```sql
 insert into member_card (active, barcode, partner_id, responsible_id, activation_date) select 't', barcode, id, 1, '2016-01-01' from res_partner where barcode is not null;
--- a/install-odoo-linux-server.md
+++ b/install-odoo-linux-server.md
@ -0,0 +1,259 @@
 # Install odoo on a linux server
 > by Thibault François 
 ## Installation basique
 ##### 1) ajouter un utilisateur odoo
    # adduser odoo
 ##### 2) installation de postgresql (DBMS)
    # apt-get install postgresql
 ##### 3) install git
    # apt-get install git
 ##### 4) installer pip : python package manager
    # apt-get install python-pip
 ##### 5) installation des paquets devel pour compilation des bibliothèques python
    # apt-get install python-dev postgresql-server-dev-all libjpeg-dev zlib1g-dev libpng12-dev libxml2-dev libxslt1-dev libldap2-dev libsasl2-dev
 ##### 6) installation de node-less
    # apt-get install node-less
 ##### 7) clone odoo
    # su odoo
    $ cd /home/odoo
    $ git clone https://github.com/odoo/odoo.git
 ##### 8) installer bibliothèque python
    $ exit
    # cd /home/odoo/odoo
    # pip install -r requirements.txt
 ##### 9) créer odoo user pour postgresql avec les droits de création de base de donnée
    # su postgres
    $ createuser -d odoo
    $ exit
 ##### 10) Installer wkhtml to pdf 0.12.1 !! (pas une autre) (sur une machine 64 bit avec un ubuntu 64bit 14.04) 
    # apt-get install fontconfig  libfontconfig1 libxrender1 fontconfig-config
    # wget http://download.gna.org/wkhtmltopdf/0.12/0.12.1/wkhtmltox-0.12.1_linux-trusty-amd64.deb
    # dpkg -i wkhtmltox-0.12.1_linux-trusty-amd64.deb
    # cd /usr/local/bin/
    # cp wkhtmltoimage /usr/bin/wkhtmltoimage
    # cp wkhtmltopdf /usr/bin/wkhtmltopdf
 ##### 11) Tester l'installation de odoo
    # su odoo
    $ cd /home/odoo/odoo
    $ ./odoo.py
 lancer le navigateur http://localhost:8069 la page de création de base de donnée d'odoo devrait s'ouvrir, essayé de créer une base de donnée
 ctrl + c pour tuer le processus odoo depuis la console
 ## Pour aller plus loin: init.d script
 
##### 1) créer un répertoire de log
    # su odoo
    $ mkdir /home/odoo/log
 
##### 2) créer fichier de config odoo
    $ cd /home/odoo/odoo
    $ ./odoo.py -s -c /home/odoo/odoo.conf --stop-after-init --logfile=/home/odoo/log/odoo.log
 
##### 3) Créer le fichier init.d
    $ exit
    $ vim /etc/init.d/odoo  
 copier le contenu dans le fichier (gedit va aussi bien que vim) 
    #!/bin/sh
    ### BEGIN INIT INFO
    # Provides:             openerp-server
    # Required-Start:       $remote_fs $syslog
    # Required-Stop:        $remote_fs $syslog
    # Should-Start:         $network
    # Should-Stop:          $network
    # Default-Start:        2 3 4 5
    # Default-Stop:         0 1 6
    # Short-Description:    Enterprise Resource Management software
    # Description:          Open ERP is a complete ERP and CRM software.
    ### END INIT INFO
    PATH=/bin:/sbin:/usr/bin
    DAEMON=/home/odoo/odoo/odoo.py
    NAME=odoo
    DESC=odoo
    # Specify the user name (Default: openerp).
    USER=odoo
    # Specify an alternate config file (Default: /etc/openerp-server.conf).
    CONFIGFILE="/home/odoo/odoo.conf"
    # pidfile
    PIDFILE=/var/run/$NAME.pid
    # Additional options that are passed to the Daemon.
    DAEMON_OPTS="-c $CONFIGFILE"
    [ -x $DAEMON ] || exit 0
    [ -f $CONFIGFILE ] || exit 0
    checkpid() {
        [ -f $PIDFILE ] || return 1
        pid=`cat $PIDFILE`
        [ -d /proc/$pid ] && return 0
        pid=`cat $PIDFILE`
        [ -d /proc/$pid ] && return 0
        return 1
    }
    case "${1}" in
            start)
                    echo -n "Starting ${DESC}: "
                    start-stop-daemon --start --quiet --pidfile ${PIDFILE} \
                            --chuid ${USER} --background --make-pidfile \
                            --exec ${DAEMON} -- ${DAEMON_OPTS}
                    echo "${NAME}."
                    ;;
            stop)
                    echo -n "Stopping ${DESC}: "
                    start-stop-daemon --stop --quiet --pidfile ${PIDFILE} \
                            --oknodo
                    echo "${NAME}."
                    ;;
            restart|force-reload)
                    echo -n "Restarting ${DESC}: "
                    start-stop-daemon --stop --quiet --pidfile ${PIDFILE} \
                            --oknodo
                    sleep 1
                    start-stop-daemon --start --quiet --pidfile ${PIDFILE} \
                            --chuid ${USER} --background --make-pidfile \
                            --exec ${DAEMON} -- ${DAEMON_OPTS}
                    echo "${NAME}."
                    echo "${NAME}."
                    ;;
            *)
                    N=/etc/init.d/${NAME}
                    echo "Usage: ${NAME} {start|stop|restart|force-reload}" >&2
                exit 1
                ;;
    esac
    exit 0
 
##### 4) donner les bons droits au fichier
    # chmod 755 /etc/init.d/odoo
 
##### 5) tester le script
    # /etc/init.d/odoo start
 tester à nouveau sur localhost:8069
 
##### 6) faire en sorte que le script s'exécute au démarrage
    # update-rc.d odoo defaults
 ## Pour aller plus loin: proxy nginx
 
##### 1) installer nginx
    # apt-get install nginx
 vous pouvez tester l'installation réussie sur http://localhost
 
##### 2) configurer nginx pour odoo : editer le fichier de conf
    # vim /etc/nginx/sites-enabled/default
 supprimer le contenu et le remplacer par
    upstream odoo {
        server 127.0.0.1:8069 weight=1 fail_timeout=300s;
    }
    server {
            # server port and name
            listen        80;
            server_name   localhost;
            location / {
                    proxy_pass    http://odoo;
                    # force timeouts if the backend dies
                    proxy_next_upstream error timeout invalid_header http_500 http_502 http_503;
                    # set headers
                    proxy_set_header Host $host;
                    proxy_set_header X-Real-IP $remote_addr;
                    proxy_set_header X-Forward-For $proxy_add_x_forwarded_for;
            }
    }
 
##### 3) tester la config et relancer nginx 
    # nginx -t
    # nginx -s reload
 tester http://localhost
 devrait conduire à odoo (ne pas oublier de vider le cache de son navigateur au cas ou ca ne marche pas tout de suite)
 ## Sécurité
 > odoo plus accessible sur le port et changer le master password
 a) editer fichier de conf de odoo
    # vim /home/odoo/odoo.conf
 changer 
    admin_passwd = admin 
    xmlrpc_interface =
 pour 
    admin_passwd = secret_password
    xmlrpc_interface = 127.0.0.1
 b) redémarrer odoo
    # /etc/init.d/odoo restart
--- a/install-odoo-mac.md
+++ b/install-odoo-mac.md
@ -0,0 +1,78 @@
 # Install odoo on macos
 > Tested on macos High Sierra (10.13.3)
 ##### 1) install Homebrew
 ```
 $ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
 ```
 ##### 2) Install Python, postgresql and needed modules
 ```
 $ brew update
 $ brew install python
 $ brew install postgresql
 $ brew install freetype jpeg libpng libtiff webp xz
 ```
 ##### 3) Add postgresql to system startup
 ```
 $ ln -sfv /usr/local/opt/postgresql/*.plist ~/Library/LaunchAgents
 $ launchctl load ~/Library/LaunchAgents/homebrew.mxcl.postgresql.plist
 ```
 ##### 4) install less compiler
 ```
 $ brew install npm
 $ npm install -g less
 ```
 ##### 5) setup odoo environment
 I recommend using [virtualenvwrapper](http://virtualenvwrapper.readthedocs.io/en/latest/index.html)
 ```
 $ mkvirtualenv odoo -p /path/to/python2.7
 $ which python
 $ /Users/<user>/.virtualenvs/odoo/bin/python
 ```
 Use `deactivate` to get out of odoo environment, use `workon odoo` to activate the environment.
 ##### 6) clone odoo
 ```
 $ cd ~/projects
 $ git clone https://github.com/odoo/odoo.git odoo
 ```
 ##### 7) Install odoo requirements
 ```
 $ cd odoo
 $ git checkout 9.0
 $ pip install -r requirements.txt
 ```
 You should now be able to start a simple odoo instance with `python odoo.py`
 ## Configuring pycharm
 ## Troubleshoot
 Missing codaparserexception
 ```
 pip install pycoda
 ```
 Can't update `product_scale_log` table (I did not write down the exact error)
 ```
 truncate table product_scale_log
 ```
 ## Source
 source: [setup-odoo-development-on-os-x-with-pycharm](http://bloopark.de/en_US/blog/the-bloopark-times-english-2/post/setup-odoo-development-on-os-x-with-pycharm-109)