-
Notifications
You must be signed in to change notification settings - Fork 11
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
1ab2eaa
commit ca1fd74
Showing
3 changed files
with
260 additions
and
3 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file was deleted.
Oops, something went wrong.
259 changes: 259 additions & 0 deletions
259
social-registry/development/install-openg2p-package-on-linux-system.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,259 @@ | ||
| --- | ||
| description: Installation of Social Registry on developer machine | ||
| --- | ||
|
|
||
| # Install OpenG2P Package on Linux System | ||
|
|
||
| The guide provides steps to install the OpenG2P package on a laptop/desktop running on Linux system. Developers can run the entire OpenG2P package on their machines.  | ||
|
|
||
| ## Prerequisites | ||
|
|
||
| Below are the prerequisites to install the OpenG2P package on a laptop/desktop.  | ||
|
|
||
| <table><thead><tr><th width="282"></th><th></th></tr></thead><tbody><tr><td>Operating System/Server</td><td>Linux System</td></tr><tr><td>Language</td><td>Python3</td></tr><tr><td>Repository</td><td>GitHub</td></tr><tr><td>Database</td><td>PostgreSQL</td></tr><tr><td>Platform</td><td><ul><li><a href="https://www.odoo.com/documentation/15.0/administration/on_premise/source.html">Odoo 15.0</a></li><li><a href="https://www.odoo.com/documentation/17.0/administration/on_premise/source.html">Odoo 17.0</a></li></ul></td></tr></tbody></table> | ||
|
|
||
| {% tabs %} | ||
| {% tab title="Odoo 15.0" %} | ||
| ## Installation of Odoo 15.0 | ||
|
|
||
| #### 1. Update system packages | ||
|
|
||
| * Log in to your Linux server using SSH and update the package list and upgrade the existing packages. | ||
|
|
||
| ```bash | ||
| sudo apt update | ||
| sudo apt upgrade -y | ||
| ``` | ||
|
|
||
| #### 2. Install dependencies | ||
|
|
||
| * Odoo requires several dependencies to function correctly. Install them using the following commands. | ||
|
|
||
| ```bash | ||
| sudo apt install -y python3-pip python3-dev build-essential libxml2-dev libxslt1-dev libevent-dev libsasl2-dev libldap2-dev libpq-dev libjpeg-dev zlib1g-dev libfreetype6-dev liblcms2-dev libwebp-dev libopenjp2-7-dev libtiff5-dev libffi-dev nodejs npm | ||
| ``` | ||
|
|
||
| #### 3. Create Odoo user | ||
|
|
||
| * It is recommended to create a separate system user to run Odoo for security purposes. Create the user with the following command. | ||
|
|
||
| ```bash | ||
| sudo adduser --system --home=/opt/odoo --group odoo | ||
| ``` | ||
|
|
||
| #### 4. Install and configure PostgreSQL | ||
|
|
||
| * Install PostgreSQL server and create a new database user for Odoo. | ||
|
|
||
| ```bash | ||
| sudo apt install -y postgresql | ||
| sudo su - postgres | ||
| createuser --createdb --username postgres --no-createrole --no-superuser --pwprompt odoo_user | ||
| exit | ||
| ``` | ||
|
|
||
| #### 5. Install Wkhtmltopdf. <a href="#docs-internal-guid-f8d8e15e-7fff-3872-8a9f-bfbb05735977" id="docs-internal-guid-f8d8e15e-7fff-3872-8a9f-bfbb05735977"></a> | ||
|
|
||
| * Odoo supports printing report files in PDF format. Wkhtmltopdf helps to generate reports in PDF format from HTML data format. Moreover, the report engine converts Qweb template reports to HTML format and Wkhtmltopdf will produce reports in PDF format. | ||
|
|
||
| ```bash | ||
| sudo wget https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.5/wkhtmltox_0.12.5-1.bionic_amd64.deb | ||
| sudo dpkg -i wkhtmltox_0.12.5-1.bionic_amd64.deb | ||
| sudo apt install -f | ||
| ``` | ||
|
|
||
| #### 6. Install Odoo. | ||
|
|
||
| * Clone the odoo15 repository from the official GitHub repository. | ||
|
|
||
| ```bash | ||
| sudo git clone https://github.com/odoo/odoo.git -b 15.0 /opt/odoo/odoo15 | ||
| ``` | ||
|
|
||
| {% hint style="danger" %} | ||
| Cloning the odoo15 repository takes time because of the large file. | ||
| {% endhint %} | ||
|
|
||
| * Make a new Odoo Python virtual environment. | ||
|
|
||
| ```bash | ||
| cd /opt/odoo | ||
| python3 -m venv odoo-venv | ||
| ``` | ||
| * Turn on the virtual environment. | ||
|
|
||
| ```bash | ||
| source odoo-venv/bin/activate | ||
| ``` | ||
| * Switch to the odoo15 directory and install the required Python libraries: | ||
|
|
||
| ```bash | ||
| sudo chown -R <odoo_user>: /opt/odoo/odoo15 | ||
| cd /opt/odoo/odoo15 | ||
| pip3 install wheel | ||
| pip3 install -r requirements.txt | ||
| ``` | ||
|
|
||
| #### 7. Configure Odoo. | ||
|
|
||
| * Edit the configuration file `/opt/odoo/odoo15/debian/odoo.conf` and set the appropriate values for the following parameters: | ||
|
|
||
| ``` | ||
| sudo nano /opt/odoo/odoo15/debian/odoo.conf | ||
| ``` | ||
| ``` | ||
| [options] | ||
| addons_path = /opt/odoo/odoo15/addons,/opt/odoo/odoo15/custom-addons | ||
| admin_passwd = strong_admin_password | ||
| db_host = localhost | ||
| db_port = 5432 | ||
| db_user = odoo_user | ||
| db_password = your_database_password | ||
| ``` | ||
| * Inside the customs addons directories, place the relevant project module and custom third-party modules. | ||
| #### 8. Start Odoo. | ||
| * Start the Odoo server using the following command: | ||
| ```bash | ||
| cd /opt/odoo/odoo15 | ||
| ./odoo-bin -c debian/odoo.conf | ||
| ``` | ||
| {% endtab %} | ||
| {% tab title="Odoo 17.0" %} | ||
| ## Installation of Odoo 17.0 | ||
| #### 1. Update system packages | ||
| * Log in to your Linux server using SSH and update the package list and upgrade the existing packages. | ||
| ```bash | ||
| sudo apt update | ||
| sudo apt upgrade -y | ||
| ``` | ||
|
|
||
| #### 2. Install dependencies. | ||
|
|
||
| * Odoo requires several dependencies to function correctly. Install them using the following commands: | ||
|
|
||
| ```bash | ||
| sudo apt-get install -y python3-pip | ||
| sudo apt-get install python-dev python3-dev libxml2-dev libxslt1-dev zlib1g-dev libsasl2-dev libldap2-dev build-essential libssl-dev libffi-dev libmysqlclient-dev libjpeg-dev libpq-dev libjpeg8-dev liblcms2-dev libblas-dev libatlas-base-dev | ||
| sudo apt-get install -y npm | ||
| sudo ln -s /usr/bin/nodejs /usr/bin/node | ||
| sudo npm install -g less less-plugin-clean-css | ||
| sudo apt-get install -y node-less | ||
| ``` | ||
|
|
||
| #### 3. Create Odoo user. | ||
|
|
||
| * It is recommended to create a separate system user to run Odoo for security purposes. Create the user with the following command: | ||
|
|
||
| ```bash | ||
| sudo adduser --system --home=/opt/odoo --group odoo | ||
| ``` | ||
|
|
||
| #### 4. Install and configure PostgreSQL. | ||
|
|
||
| * Install PostgreSQL server and create a new database user for Odoo: | ||
|
|
||
| ```bash | ||
| sudo apt install -y postgresql | ||
| sudo su - postgres | ||
| createuser --createdb --username postgres --no-createrole --no-superuser --pwprompt odoo_user | ||
| exit | ||
| ``` | ||
|
|
||
| #### 5. Install Wkhtmltopdf. <a href="#docs-internal-guid-f8d8e15e-7fff-3872-8a9f-bfbb05735977" id="docs-internal-guid-f8d8e15e-7fff-3872-8a9f-bfbb05735977"></a> | ||
|
|
||
| * Odoo supports printing report files in PDF format. Wkhtmltopdf helps to generate reports in PDF format from HTML data format. Moreover, the report engine converts the Qweb template reports to HTML format by the report engine and Wkhtmltopdf will produce the report in PDF format. | ||
|
|
||
| ```bash | ||
| sudo wget https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.5/wkhtmltox_0.12.5-1.bionic_amd64.deb | ||
| sudo dpkg -i wkhtmltox_0.12.5-1.bionic_amd64.deb | ||
| sudo apt install -f | ||
| ``` | ||
|
|
||
| #### 6. Install Odoo. | ||
|
|
||
| * Clone the odoo17 repository from the official GitHub repository: | ||
|
|
||
| ```bash | ||
| sudo git clone https://github.com/odoo/odoo.git -b 17.0 /opt/odoo/odoo17 | ||
| ``` | ||
|
|
||
| {% hint style="danger" %} | ||
| Cloning the odoo17 repository takes time because of the large file. | ||
| {% endhint %} | ||
|
|
||
| * Make a new Odoo Python virtual environment. | ||
|
|
||
| ```bash | ||
| cd /opt/odoo | ||
| python3 -m venv odoo17-venv | ||
| ``` | ||
| * Turn on the virtual environment. | ||
|
|
||
| ```bash | ||
| source odoo17-venv/bin/activate | ||
| ``` | ||
| * Switch to the odoo17 directory and install the required Python libraries. | ||
|
|
||
| ```bash | ||
| sudo chown -R <odoo_user>: /opt/odoo/odoo17 | ||
| cd /opt/odoo/odoo17 | ||
| pip3 install wheel | ||
| pip3 install -r requirements.txt | ||
| ``` | ||
|
|
||
| #### 7. Configure Odoo. | ||
|
|
||
| * Edit the configuration file `/opt/odoo/odoo17/debian/odoo.conf` and set the appropriate values for the following parameters: | ||
|
|
||
| ``` | ||
| sudo nano /opt/odoo/odoo17/debian/odoo.conf | ||
| ``` | ||
| ``` | ||
| [options] | ||
| addons_path = /opt/odoo/odoo17/addons,/opt/odoo/odoo17/custom-addons | ||
| admin_passwd = strong_admin_password | ||
| db_host = localhost | ||
| db_port = 5432 | ||
| db_user = odoo_user | ||
| db_password = your_database_password | ||
| ``` | ||
| * Inside the customs addons directories, place the relevant project module and custom third-party modules. | ||
| #### 8. Start Odoo. | ||
| * Start the Odoo server using the following command: | ||
| ```bash | ||
| cd /opt/odoo/odoo17 | ||
| ./odoo-bin -c debian/odoo.conf | ||
| ``` | ||
| {% endtab %} | ||
| {% endtabs %} | ||
| ## Installation of OpenG2P package | ||
| 1. Create a `custom-addons` folder inside the `odoo` folder to keep all the extra modules. | ||
| 2. Clone all the [OpenG2P modules](../../pbms/development/repositories/). | ||
| ```bash | ||
| git clone <repo_url> | ||
| ``` | ||
| 3. Install the required Python libraries for all the custom-addons. | ||
| ```bash | ||
| cd /opt/odoo/custom-addons/<module_directory> | ||
| pip3 install -r requirements.txt | ||
| ``` | ||
| 4. Add addons directory path to the _odoo.conf_ file in **addons\_path** parameter, mentioned in [point 7](install-openg2p-package-on-linux-system.md#id-7.-configure-odoo). | ||
| 5. For the Social Registry to function properly, your add-ons should include the packages listed below.[https://github.com/OpenG2P/openg2p-packaging/blob/main/packaging/packages/social-registry/17.0-develop.txt](https://github.com/OpenG2P/openg2p-packaging/blob/main/packaging/packages/social-registry/17.0-develop.txt) |