Instalación por el método manual de la suite ERPNext en una instancia con sistema operativo Centos 7.

1.
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

2.
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

3.
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

4.
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

5.
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

6.
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

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

8.
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

9.
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

10.
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