Zeety ERPNext - manual de instalación (centos 7)

10

Click here to load reader

Transcript of Zeety ERPNext - manual de instalación (centos 7)

Page 1: Zeety   ERPNext - manual de instalación (centos 7)

COMMUNITY ­ COMPONENTE ERP ID:

Ver: 1.0.0.0

ErpNext ­ Manual de Instalación (Centos 7) Pág 1 de 10

Grupo de Investigación y Desarrollo de

Tecnologías de la Información

ERPNext Manual de Instalación Centos 7

Zeety S.A.S Grupo de Investigación y Desarrollo de Tecnologías de la Información

Page 2: Zeety   ERPNext - manual de instalación (centos 7)

COMMUNITY ­ COMPONENTE ERP ID:

Ver: 1.0.0.0

ErpNext ­ Manual de Instalación (Centos 7) Pág 2 de 10

Historial de Cambios

Versión Fecha Descripción cambios Responsable(s)

0.0.0.1 Contenido Vargas, S.

1.0.0.0 Contenido Coronado, C. Tabla: Cuadro historial de versiones

Zeety S.A.S Grupo de Investigación y Desarrollo de Tecnologías de la Información

Page 3: Zeety   ERPNext - manual de instalación (centos 7)

COMMUNITY ­ COMPONENTE ERP ID:

Ver: 1.0.0.0

ErpNext ­ Manual de Instalación (Centos 7) Pág 3 de 10

Tabla de Contenido

Preliminares Crear un Usuario para el Sistema

Permitir conexión por SSH Actualizar el Sistema Instalar los prerrequisitos

Python 2.7 Node.js MariaDB Redis WKHTMLtoPDF PIP

Instalar Frappe Bench Instalar ERPNext Habilitar como Entorno de Producción Borrar un sitio después de creado Desinstalar Frappe Problemas Comunes

Mensaje Solución

Mensaje Solución

Licencia

Zeety S.A.S Grupo de Investigación y Desarrollo de Tecnologías de la Información

Page 4: Zeety   ERPNext - manual de instalación (centos 7)

COMMUNITY ­ COMPONENTE ERP ID:

Ver: 1.0.0.0

ErpNext ­ Manual de Instalación (Centos 7) Pág 4 de 10

Preliminares ERPNext está basado en un marco de desarrollo para lenguaje Python denominado Frappe. Tiene como base de datos MariaDB y Redis. Para poder instalar ERPNext es necesario instalar Frappe­bench, un programa de línea de comandos que se utiliza como instalador y gestor de sitios para el marco de trabajo Frappe.

Crear un Usuario para el Sistema 1

Si aún no se cuenta con un usuario específico (que no sea root) es necesario crearlo.

# adduser erpnext # passwd erpnext

Habilitar que el usuario ejecute comandos como superusuario:

# gpasswd ­a erpnext wheel

Permitir conexión por SSH

Editar el archivo /etc/ssh/sshd_config, agregando la línea:

AllowUsers erpnext

Luego reiniciar el servicio sshd

systemctl restart sshd.service

Actualizar el Sistema Se debe garantizar que se tiene la última versión estable de los paquetes.

1 Opcional. Este paso solo se realiza en sistemas que no tengan un usuario diferente a root. Zeety S.A.S Grupo de Investigación y Desarrollo de Tecnologías de la Información

Page 5: Zeety   ERPNext - manual de instalación (centos 7)

COMMUNITY ­ COMPONENTE ERP ID:

Ver: 1.0.0.0

ErpNext ­ Manual de Instalación (Centos 7) Pág 5 de 10

# yum update

Además se debe instalar un conjunto de utilidades (la mayoría disponibles de manera predeterminada en las instalaciones de Centos 7)

# yum install ­y nano wget mlocate git

Instalar los prerrequisitos Nota, en los cuadros color verde se presentan los comandos a ejecutar. Cuando se anteceden del símbolo $ significan que deben ser ejecutados por el usuario normal. Si van precedidos de # significa que deben ser ejecutados como superusuario.

Python 2.7

# yum install ­y python­devel.x86_64 gcc libtiff­devel libjpeg­devel libzip­devel freetype­devel lcms2­devel libwebp­devel tcl­devel tk­devel

Node.js

# yum ­y install epel­release # yum ­y install nodejs npm

MariaDB

# yum install ­y mariadb­server mysql mariadb­devel.x86_64 # systemctl enable mariadb.service # systemctl restart mariadb.service $ mysql_secure_installation

Importante No se recomienda permitir el acceso a la base de datos desde una IP pública. Se puede restringir para conexiones locales en el archivo /etc/my.cnf:

Zeety S.A.S Grupo de Investigación y Desarrollo de Tecnologías de la Información

Page 6: Zeety   ERPNext - manual de instalación (centos 7)

COMMUNITY ­ COMPONENTE ERP ID:

Ver: 1.0.0.0

ErpNext ­ Manual de Instalación (Centos 7) Pág 6 de 10

# nano /etc/my.cnf En el editor agregar: bind­address = localhost Guardar y reiniciar el servicio.

Redis

$ wget http://download.redis.io/redis­stable.tar.gz $ tar xvzf redis­stable.tar.gz $ cd redis­stable $ make $ make test # make install $ redis­server

WKHTMLtoPDF

Con soporte para QT (requerido para la generación de PDF)

# yum install ­y wkhtmltopdf.x86_64 python­pdfkit.noarch

PIP

# curl "https://bootstrap.pypa.io/get­pip.py" ­o "get­pip.py" # python get­pip.py # pip install ­­upgrade pip # easy_install ­U setuptools # pip install ­­upgrade setuptools

Zeety S.A.S Grupo de Investigación y Desarrollo de Tecnologías de la Información

Page 7: Zeety   ERPNext - manual de instalación (centos 7)

COMMUNITY ­ COMPONENTE ERP ID:

Ver: 1.0.0.0

ErpNext ­ Manual de Instalación (Centos 7) Pág 7 de 10

Instalar Frappe Bench

$ git clone https://github.com/frappe/bench bench­repo # pip install ­e bench­repo $ bench init frappe­bench

Instalar ERPNext

$ cd frappe­bench/ $ bench get­app erpnext https://github.com/frappe/erpnext $ bench new­site site1.local

Durante la creación del sitio se pide editar el archivo /etc/my.cnf agregando:

[mysqld] innodb­file­format=barracuda innodb­file­per­table=1 innodb­large­prefix=1 character­set­client­handshake = FALSE character­set­server = utf8mb4 collation­server = utf8mb4_unicode_ci [mysql] default­character­set = utf8mb4

Luego de ello reiniciar el motor de base de datos:

# systemctl restart mariadb.service

Y se termina la instalación de la aplicación:

$ bench install­app erpnext $ bench start

Zeety S.A.S Grupo de Investigación y Desarrollo de Tecnologías de la Información

Page 8: Zeety   ERPNext - manual de instalación (centos 7)

COMMUNITY ­ COMPONENTE ERP ID:

Ver: 1.0.0.0

ErpNext ­ Manual de Instalación (Centos 7) Pág 8 de 10

Una vez realizado lo anterior, se podrá ingresar a la aplicación desde un navegador: http://<direcciónIP>:8000

Donde <direcciónIP> debe ser reemplazado por la dirección de la instancia en donde se instaló el aplicativo.

El usuario predeterminado es: Administrator y la clave es la que se ingresó cuando se creó el nuevo sitio.

Habilitar como Entorno de Producción

$ wget https://raw.githubusercontent.com/frappe/bench/master/install_scripts/setup_frappe.sh # bash setup_frappe.sh ­­setup­production

Borrar un sitio después de creado 1. Eliminar la base de datos asociada al sitio. 2. En la carpeta de Frappe bench­>sites, borrar la carpeta correspondiente al sitio.

Desinstalar Frappe

Eliminar los directorios frappe­bench y bench­repo. Eliminar (si existe) el usuario frappe.

Problemas Comunes

Mensaje

ERPNext can only be installed on a fresh site where the setup wizard is not completed

Solución

Se debe borrar el sitio y crearlo de nuevo. Otra solución es crear un nuevo sitio e instalar ERPNext en él.

Zeety S.A.S Grupo de Investigación y Desarrollo de Tecnologías de la Información

Page 9: Zeety   ERPNext - manual de instalación (centos 7)

COMMUNITY ­ COMPONENTE ERP ID:

Ver: 1.0.0.0

ErpNext ­ Manual de Instalación (Centos 7) Pág 9 de 10

Mensaje

Si después de ejecutar bench install­app erpnext, aparece una traza de error cuya últim línea muestra:

TypeError: 'NoneType' object is not iterable

Solución

Eliminar la base de datos asociada al sitio. Y volver a ejecutar:

$ bench new­site site1.local $ bench install­app erpnext $ bench start

Zeety S.A.S Grupo de Investigación y Desarrollo de Tecnologías de la Información

Page 10: Zeety   ERPNext - manual de instalación (centos 7)

COMMUNITY ­ COMPONENTE ERP ID:

Ver: 1.0.0.0

ErpNext ­ Manual de Instalación (Centos 7) Pág 10 de 10

Licencia

Grupo de Investigación y Desarrollo de

Tecnologías de la Información

Los contenidos originales de Zeety S.A.S en esta obra, se distribuyen bajo una Licencia Creative Commons Atribución­Compartir Igual 3.0 Unported.

Atribución – Compartir igual.

De conformidad a esta licencia: Usted es libre para:

Compartir — copiar y redistribuir el material en cualquier medio o formato Adaptar — remezclar, transformar y crear a partir del material

Para cualquier propósito, incluso comercialmente

Bajo los siguientes términos:

Atribución — Usted debe darle crédito a esta obra de manera adecuada: si se suministran, usted debe dar el nombre del creador y de las partes atribuidas, un aviso de derechos de autor, una nota de licencia, un aviso legal, y un enlace al material; e indicando si se han realizado cambios. Puede hacerlo en cualquier forma razonable, pero no de forma tal que sugiera que usted o su uso tienen el apoyo del licenciante

Compartir igual — Si usted mezcla, transforma o crea nuevo material a partir de esta obra, usted podrá distribuir su contribución siempre que utilice la misma licencia que la obra original..

Las marcas, nombres de productos y empresas, logos, figuras, citas, contenidos no originales de Zeety S.A.S y otras referencias; son propiedad de sus respectivos dueños y no están cubiertos por esta licencia.

Zeety S.A.S Grupo de Investigación y Desarrollo de Tecnologías de la Información