Installare la fonte¶
L“«installazione» dalla fonte non consiste nell’installazione di Odoo ma nell’eseguirlo direttamente.
L’utilizzo del codice sorgente di Odoo può essere più conveniente per gli sviluppatori di moduli in quanto è accessibile in modo più semplice rispetto ai programmi di installazione.
Questa pratica consente di avviare e arrestare Odoo in modo più flessibile ed esplicito rispetto ai servizi configurati dai programmi di installazione. Inoltre, consente di sovrascrivere impostazioni utilizzando i parametri della riga di comando senza la necessità di modificare il file di configurazione.
Infine, fornisce grande controllo sulla configurazione del sistema e consente di mantenere (ed eseguire) più facilmente varie versioni di Odoo, l’una accanto all’altra.
Recuperare le sorgenti¶
Esistono due modi per ottenere il codice sorgente di Odoo: come archivio ZIP oppure attraverso Git.
Archivia¶
Edizione Community:
Edizione Enterprise:
Git¶
Nota
È necessario aver installato Git ed è consigliato avere conoscenze di base dei comandi Git per procedere.
Per clonare una repository Git, scegli tra la clonazione con HTTPS o SSH. Nella maggior parte dei casi, la migliore soluzione è HTTPS. Tuttavia, scegli SSH per contribuire al codice sorgente di Odoo oppure seguendo il tutorial per developer per iniziare.
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone git@github.com:odoo/odoo.git
$ git clone git@github.com:odoo/enterprise.git
C:\> git clone https://github.com/odoo/odoo.git
C:\> git clone https://github.com/odoo/enterprise.git
C:\> git clone git@github.com:odoo/odoo.git
C:\> git clone git@github.com:odoo/enterprise.git
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone git@github.com:odoo/odoo.git
$ git clone git@github.com:odoo/enterprise.git
Nota
La repository git Enterprise non contiene il codice fonte Odoo completo. Si tratta di un insieme di componenti aggiuntivi extra. Il codice server principale si trova nella versione Community. Eseguire la versione Enterprise significa eseguire il server dalla versione Community con l’opzione addons-path impostata per la cartella con la versione Enterprise. È necessario clonare sia la repository Community che Enterprise per far sì che l’installazione di Odoo Enterprise funzioni.
Preparazione¶
Python¶
Odoo richiede Python 3.10 o versioni superiori per funzionare.
Cambiato nella versione 17: Requisito minimo aggiornato da Python 3.7 a Python 3.10.
Utilizza un sistema di gestione pacchetti per scaricare e installare Python 3 se necessario.
Scarica l’ultima versione di Python 3 e installala.
Durante l’installazione, seleziona Aggiungi Python 3 al PERCORSO per poi fare clic su Personalizza installazione e assicurati che il campo pip sia spuntato.
Nota
Se Python 3 è già installato, assicurati che la versione sia pari a 3.10 o superiori, in quanto le versioni precedenti non sono compatibili con Odoo.
$ python3 --version
C:\> python --version
$ python3 --version
Verifica che pip sia stato installato per questa versione.
$ pip3 --version
C:\> pip --version
$ pip3 --version
PostgreSQL¶
Odoo utilizza PostgreSQL come sistema di gestione dei database.
Utilizza un sistema di gestione pacchetti per scaricare e installare PostgreSQL (versioni supportate: 12.0 o superiori). È possibile farlo eseguendo il comando:
$ sudo apt install postgresql postgresql-client
Scarica PostgreSQL (versioni supportate: 12.0 o superiori) e installao.
Utilizza Postgres.app per scaricare e installare PostgreSQL (versioni supportate: 12.0 o superiori).
Suggerimento
Per far sì che gli strumenti della riga di comando legati a Postgres.app siano disponibili, assicurati di configurare la variabile $PATH seguendo le istruzioni relative agi strumenti CLI Postgres.app.
Per impostazione predefinita, l’unico utente è postgres. Odoo non permette di connettersi come postgres quindi devi creare un nuovo utente PostgreSQL.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
Nota
Dato che l’utente PostgreSQL ha lo stesso nome del login Unix, è possibile collegare il database senza una password.
Aggiungi la directory PostgreSQL’s
bin(per impostazione predefinita:C:\Program Files\PostgreSQL\<version>\bin) alPERCORSO.Crea un utente postgres con una password utilizzando il gui admin pg:
Apri pgAdmin.
Fai doppio clic sul server per creare una connessione.
Seleziona .
Inserisci il nome utente nel campo «Nome ruolo» (ad es.,
odoo).Apri la scheda Definizione, inserisci una password (ad es.,
odoo) e fai clic su Salva.Apri la scheda Privilegi e imposta Può accedere? su
Sìe Crea database? suSÌ.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
Nota
Dato che l’utente PostgreSQL ha lo stesso nome del login Unix, è possibile collegare il database senza una password.
Dipendenze¶
L’utilizzo di pacchetti di distribuzione è il metodo preferito per installare dipendenze. In alternativa, installa le dipendenze Python con pip.
Su Debian/Ubuntu, puoi installare i pacchetti richiesti tramite i seguenti comandi:
$ cd odoo #CommunityPath
$ sudo ./setup/debinstall.sh
Lo script setup/debinstall.sh analizzerà il file debian/control e installerà i pacchetti trovati.
Avvertimento
L’utilizzo di pip potrebbe comportare problemi di sicurezza e dipendente non funzionati. Utilizzalo solo se sai cosa stai facendo.
Dato che alcuni pacchetti Python richiedono una fase di compilazione, è necessario installare librerie di sistema.
Su Debian/Ubuntu, puoi installare le librerie richieste tramite il comando seguente:
$ sudo apt install python3-pip libldap2-dev libpq-dev libsasl2-dev
Le dipendenze Odoo sono elencate nel file requirements.txt situato alla radice della directory Odoo Community.
Nota
I pacchetti Python nel file requirements.txt si basano sulla versione stabile/LTS Debian/Ubuntu corrispondente al momento del rilascio di Odoo. Ad esempio, per Odoo 15.0, la versione del pacchetto python3-babel è la 2.8.0 in Debian Bullseye e la 2.6.0 in Ubuntu Focal. La versione più bassa viene scelta nel file requirements.txt.
Suggerimento
È preferibile non combinare pacchetti del modulo Python fra varie istanze di Odoo o con il sistema. Tuttavia, è possibile utilizzare virtualenv per creare ambienti Python isolati.
Apri il percorso dell’installazione di Odoo Community (CommunityPath) ed esegui pip sul file dei requisiti per installare i requisiti per l’utente corrente.
$ cd /CommunityPath
$ pip install -r requirements.txt
Prima di installare le dipendenze, scarica e installa gli Strumenti Build per Visual Studio. Seleziona C++ build tools nella scheda Workloads e installali quando richiesto.
Le dipendenze Odoo sono elencate nel file requirements.txt situato alla radice della directory Odoo Community.
Suggerimento
È preferibile non combinare pacchetti del modulo Python fra varie istanze di Odoo o con il sistema. Tuttavia, è possibile utilizzare virtualenv per creare ambienti Python isolati.
Apri il percorso dell’installazione di Odoo Community (CommunityPath) ed esegui pip sul file dei requisiti in un terminale con privilegi di amministratore:
C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt
Le dipendenze Odoo sono elencate nel file requirements.txt situato alla radice della directory Odoo Community.
Suggerimento
È preferibile non combinare pacchetti del modulo Python fra varie istanze di Odoo o con il sistema. Tuttavia, è possibile utilizzare virtualenv per creare ambienti Python isolati.
Apri il percorso dell’installazione di Odoo Community (CommunityPath) ed esegui pip sul file dei requisiti:
$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt
Nota
Per le lingue che utilizza una interfaccia da destra a sinistra (come l’arabo o l’ebraico), è richiesto il pacchetto rtlcss-
Scarica e installa nodejs e npm tramite sistema di gestione pacchetti.
Installa
rtlcss:$ sudo npm install -g rtlcss
Scarica e installa nodejs.
Installa
rtlcss:C:\> npm install -g rtlcssModifica la variabile
PATHdell’ambiente sistema per aggiungere la cartella dove è situtatortlcss.cmd(tipicamente:C:\Users\<user>\AppData\Roaming\npm\).
Avvertimento
wkhtmltopdf non è installato tramite pip e deve essere installato manualmente nella versione 0.12.6 per far sì che supporti intestazioni e pié di pagina. Consulta la wiki relativa a wkhtmltopdf per maggiori dettagli sulle varie versioni.
Eseguire Odoo¶
Una volta che tutte le dipendenze sono state configurate, Odoo può essere avviato eseguendo odoo-bin, l’interfaccia della riga di comando del server. Si trova alla radice della directory di Odoo Community.
Per configurare il server, specifica gli argomenti della riga di comando oppure un file di configurazione.
Suggerimento
Per l’edizione Enterprise, aggiungi il percorso ai componenti aggiuntivi enterprise nell’argomento addons-path. Nota che per caricare correttamente i componenti aggiuntivi, è necessario che il percorso si trovi prima di altri percorsi in addons-path.
Le configurazioni comuni necessarie sono:
Utente e password PostgreSQL.
Percorsi personalizzati dei componenti aggiuntivi, oltre a quelli predefiniti, per caricare moduli personalizzati.
Uno dei modi tipici per avviare il server sarebbe:
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Dove CommunityPath è il percorso dell’installazione di Odoo Community installation e mydb è il nome del database PostgreSQL.
C:\> cd CommunityPath/
C:\> python odoo-bin -r dbuser -w dbpassword --addons-path=addons -d mydb
Dove CommunityPath è il percorso dell’installazione Odoo Community, dbuser è l’accesso PostgreSQL, dbpassword rappresenta la password PostgreSQL e mydb è il nome del database PostgreSQL.
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Dove CommunityPath è il percorso dell’installazione di Odoo Community installation e mydb è il nome del database PostgreSQL.
Dopo che il server è stato avviato (il registro INFO odoo.modules.loading: Modules loaded. è stampato), apri http://localhost:8069 in un browser web e accedi al database Odoo con l’account amministratore di base: usa admin come e-mail e di nuovo admin come password.
Suggerimento
Vedi anche