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

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 
ERPNextestábasadoenunmarcodedesarrolloparalenguajePythondenominadoFrappe.                    
Tiene como base de datos MariaDB  y Redis.  
 
ParapoderinstalarERPNextesnecesarioinstalarFrappe­bench,unprogramadelíneade                     
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>debeserreemplazadoporladireccióndelainstanciaendondeseinstaló                      
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—Usteddebedarlecréditoaestaobrademaneraadecuada:sise                     
suministran,usteddebedarelnombredelcreadorydelaspartesatribuidas,unavisode                       
derechosdeautor,unanotadelicencia,unavisolegal,yunenlacealmaterial;e                      
indicandosisehanrealizadocambios​.Puedehacerloencualquierformarazonable,                   
pero no de forma tal que sugiera que usted o su uso tienen el apoyo del licenciante 
●Compartirigual—Siustedmezcla,transformaocreanuevomaterialapartirdeesta                      
obra,ustedpodrádistribuirsucontribuciónsiemprequeutilicela​mismalicenciaquela                      
obra original.. 
Lasmarcas,nombresdeproductosyempresas,logos,figuras,citas,contenidosnooriginalesde                       
ZeetyS.A.Syotrasreferencias;sonpropiedaddesusrespectivosdueñosynoestáncubiertospor                        
esta licencia. 
 
 
Zeety S.A.S 
Grupo de Investigación y Desarrollo de Tecnologías de la Información