GUI-TDT-001 Instalación Odoo

v 12.0

Objetivo

El propósito de esta guía es proporcionar orientación a los miembros del departamento Black Dot en la instalación de Odoo en un servidor local.

Notas introductorias

Odoo es un software de código abierto que se utiliza para la gestión de empresas. Es un sistema ERP que incluye una amplia gama de aplicaciones empresariales, como ventas, CRM, gestión de proyectos, inventario, etc.

Esta guía esta basada en Chapter 2: Development environment setup de la documentación oficial de Odoo.

Requisitos previos a la instalación de Odoo

Antes de poder instalar y correr odoo, es necesario tener instalado:

• Python en su versión 3.10.0 o superior.
  Nota: Versiones anteriores a 3.10.0 no son compatibles con Odoo 17.0, posteriores pueden ocasionar problemas de compatibilidad.

  Intalar Python (Windows)

  Descargar Python

  1. Descargar el ejecutable de la versión 3.10.0 de python.
  2. Ejecutar el instalador.
  3. Marcar la casilla de "Add Python 3.10 to PATH".
  4. Revisar versión de python con el comando python --version.

  Agregar python a las variables de entorno

  1. Abrir el menú de inicio y buscar "Editar las variables de entorno del sistema".
  2. En la ventana que se abre, dar clic en "Variables de entorno".
  3. En la sección de "Variables del sistema", dar clic en "Path" y luego en "Editar".
  4. Dar clic en "Nuevo" y agregar la ruta de la carpeta de python, por lo general es C:\Users\TuUsuario\AppData\Local\Programs\Python\Python310.
  5. Dar clic en "Aceptar" en todas las ventanas.
  Intalar Python (MacOS)

  Descargar Python

  1. Descargar el ejecutable de la versión 3.10.0 de python, puede ser desde Python.
  2. Ejecutar el instalador.
  3. Seleccionar la opción de "Install Now".
  4. Revisar versión de python con el comando python --version desde la terminal.

Proceso de instalación

Windows SetUp

1. Instalar PostgreSQL +12 (recomendado 16) desde aquí Windows y seguir las instrucciones de instalación que nos da la misma página.

2. Agregar la ruta de PostgreSQL a las variables de entorno.

   • Abrir el menú de inicio y buscar "Editar las variables de entorno del sistema".
   • En la ventana que se abre, dar clic en "Variables de entorno".
   • En la sección de "Variables del sistema", dar clic en "Path" y luego en "Editar".
   • Dar clic en "Nuevo" y agregar la ruta de la carpeta de PostgreSQL, por lo general es:
     C:\Program Files\PostgreSQL\13\bin.
   • Dar clic en "Aceptar" en todas las ventanas.

3. Clonar Nuestro Repositorio de manera local.

4. Crear Rol dentro de pgAdmin4.

Nota: pgAdmin 4 normalmente viene con la instalación de PostgreSQL. En caso de no tenerlo, descargarlo desde aquí.

• Abrir pgAdmin4.
• Ingresar con la contraseña establecida durante la instalación.
• Dar clic derecho en "Login/Group Roles" y seleccionar "Create" y luego "Login/Group Role".
• En la pestaña "General", en "Role name" escribir "odoo".
• En la pestaña "Definition", en "Password" escribir "odoo".
• En la pestaña "Privileges", marcar:
• Can login
• Create DB
• Dar clic en "Save".

5. Instalar C++ Build Tools.

   • Descargar Visual Studio community desde aquí.
   • Ejecutar el instalador.
   • Seleccionar la carga de trabajo "Desarrollo de escritorio con C++".
   • Dar clic en "Instalar".

6. Crear ambiente virtual.

   • Abrir la terminal.
   • Navegar a la carpeta del repositorio clonado.
   • Ejecutar el comando python -m venv cr.
   • Activar el ambiente virtual con el comando cr\Scripts\activate.ps1.

7. Instalar dependencias. Ejecuta los siguientes comandos en tu consola.

pip install setuptools wheel
pip install -r requirements.txt

Mac SetUp

1.Instalar PostgreSQL +12 (recomendado 16) con el siguiente enlace.

En caso de tener brew instalado, ejecutar el siguiente comando en tu terminal:

brew install postgresql

2. Ajustar PostgreSQL. Ejecuta los siguientes comandos en tu terminal.

  psql postgres
  CREATE ROLE odoo WITH LOGIN CREATEDB PASSWORD 'odoo';
  \q

En caso de tener problemas con el comando se recomienda visitar el siguiente enlace.

3. Clonar Nuestro Repositorio de manera local.

4. Crear ambiente virtual.

   • Abrir la terminal.
   • Navegar a la carpeta del repositorio clonado.
   • Ejecutar el comando python -m venv cr.
   • Activar el ambiente virtual con el comando source cr/bin/activate.

5. Instalar dependencias. Ejecuta los siguientes comandos en tu consola.

python -m pip install setuptools wheel
python -m pip install -r requirements.txt

Ubuntu SetUp

Ubuntu Setup

1. Instalar PostgreSQL +12 (recomendado 16) con el siguiente comando.

sudo apt install postgresql postgresql-client

2. Ajustar PostgreSQL. Ejecuta los siguientes comandos en tu consola.

  psql postgres
  CREATE ROLE odoo WITH LOGIN CREATEDB PASSWORD 'odoo';
  \q

3. Clonar Nuestro Repositorio de manera local.

4. Crear ambiente virtual.

   • Abrir la terminal.
   • Navegar a la carpeta del repositorio clonado.
   • Ejecutar el comando python -m venv cr.
   • Activar el ambiente virtual con el comando source cr/bin/activate.

5. Instalar dependencias de C++.

cd /CommunityPath
sed -n -e '/^Depends:/,/^Pre/ s/ python3-\(.*\),/python3-\1/p' debian/control | sudo xargs apt-get install -y

Si se presentan errores intentar la sigueinte alternativa

sudo apt install python3-pip libldap2-dev libpq-dev libsasl2-dev

6. Instalar dependencias de python. Ejecuta los siguientes comandos en tu consola.

pip install setuptools wheel
pip install -r requirements.txt

FAQ

¿Qué pasa si tengo una versión de Python diferente a la 3.10.0?

Dependiendo de tu sistema operativo, se recomienda visitar los siguientes recursos:

Windows

• Cómo administrar múltiples versiones de Python y entornos virtuales
• How to Update Python Version on Windows - Quick Guide
• How to Change Default Python Version on Windows 10/11 (2023)

Mac

• How to Update Python on Mac
• Update Python

Ubuntu

• How to Install Python 3.10 on Ubuntu 20.04
• Install Python 3.10.x on Ubuntu 20.04

Error de instalación de librerías

En caso de tener problemas al instalar librerías particulares, se recomienda instalar las librerías de manera individual. Nota: Asegurarse de tener el ambiente virtual activo.

pip install nombre_libreria

Ya tengo Visual Studio instalado, ¿Cómo instalo C++ Build Tools?

Si ya tienes Visual Studio instalado, puedes instalar C++ Build Tools de manera independiente. Puedes descargárlo desde aquí.

Control de cambios

Versión	Cambio realizado	Análisis	Autor	Revisor(es)	Fecha de cambio
v 1.0	Creación de la guía	N/A	Diego Sandoval		26/02/2024
v 2.0	Ajustes a la guia y cambios en MAC	N/A	Juan Pablo Cabrera	Diego Sandoval	05/03/2024
v 3.0	Ajustes a la guia y cambios en instalación postgres	N/A	Diego Sandoval		05/03/2024
v 4.0	Corrección de la guía	N/A	Diego Sandoval	Daniel Cajas	09/04/2024
v 5.0	Agregar guia Ubuntu	N/A	Daniel Cajas	Diego Sandoval	09/04/2024
v 6.0	Corrección de la guía	N/A	Diego Sandoval	Daniel Cajas	12/04/2024
v 7.0	Corrección de la guía	N/A	Juan Pablo Cabrera	Daniel Cajas	13/04/2024
v 7.1	Cambio a link relativo	Los links relativos avisan si se rompen	Ricardo Fernández		1/05/2024
v 8.0	Ajustes en el proceso de instalación	N/A	Juan Pablo Cabrera		06/05/2024
v 9.0	Ajustes en el proceso de instalación	N/A	Juan Pablo Cabrera		07/05/2024
v 10.0	Ajustes en el índice	N/A	Daniel Fuentes		07/05/2024
v 10.1	Ajustes en el proceso de instalación	N/A	Juan Pablo Cabrera		08/05/2024
v 11.0	Refactor de la guía, se agrega FAQ	N/A	Diego Sandoval	Daniel Fuentes	12/05/2024
v 11.1	Añadir los recursos para Mac y Ubuntu	N/A	Daniel Fuentes		13/05/2024
v 12.0	Cambiar comandos de creación de usuarios para postgres,, añadir recursos mac	N/A	Daniel Cajas, Diego Sandoval		16/05/2024