GNU Health/Guía Técnica/Instalación

De Wikilibros, la colección de libros de texto de contenido libre.
Saltar a: navegación, buscar

Índice de la sección
«Guía Técnica»

IMPORTANTE[editar]

Antes de iniciar la instalación del GNUHealth le recomendamos leer exhaustivamente la presente documentación, en la que encontrará información relevante acerca del método de instalación.

A su vez, el proceso de documentación implica una revisión permanente de la misma, por lo que su experiencia puede ser muy valiosa para el resto de la comunidad. Si considera que algún aspecto de la documentación presente no es exhaustivo o no refleja su experiencia, por favor háganoslo saber. En caso de requerir asistencia durante le proceso de instalación, le sugerimos consultar las FAQs (próximamente), escribir a la lista de distribución oficial de GNUHealth (https://lists.gnu.org/mailman/listinfo/health-es) o consultar en nuestro canal IRC #gnu-health-es

Componentes Centrales de GNU Health[editar]

GNUHealth se basa en tres componentes centrales: Tryton, PostgreSql y Python: A continuación brindamos una breve referencia de cada componente, para mas información sugerimos leer la documentación original de cada uno de ellos.


Tryton (http://www.tryton.org) Tryton es una plataforma de desarrollo basado en software libre. Está basado en un modelo de 3 capas que permite implementar una solución de negocios integral, ofreciendo similares prestaciones a los conocidos ERPs (Enterprise Resource Planning). La principal ventaja de Tryton es su modularidad, escalabilidad y seguridad. GNUHealth basa su funcionamiento en Tryton 3.2, sobre el cuál se immplementa módulos especificamente diseñados para la gestión de sistemas e instituciones de salud en todos sus niveles.


PostgreSql (http://www.postgresql.org) PostgreSql es un sistema de gestión de bases de datos orientas a objetos basada en software libre. Con mas de 15 años de evolución y permanente desarrollo, PostgreSql tiene una fuerte reputación por su confiabilidad e integridad. PostgreSql corre en la mayoría de los sistemas operativos tales como Linux, UNIX (AIX, BSD, HP-UX, SGI IRIX, Mac OS X, Solaris, Tru64) y Windows. Por tratarse de una base de datos de clase enterprise soporta Multi-Version Concurrency Control (MVCC), replicación asincrónica, backups online, etc.

Python (http://www.python.org) Python es un lenguage de programación de alto nivel de uso general y sumamente popular. Su filosofía de diseño enfatiza la facilidad de lectura de su código, así como también permite expresar conceptos en menos lineas de código comparado con lenguages similares, tales como C. Python soporta diversos paradigmas de programación, tales como la orientación a objetos, imperativo y programación funcional. La utilización de herramientas específicas (tales como py2exe o pyinstaller) permite empaquetar código en programas tipo stand-alone en la gran mayoría de los sistemas operativos. Esto último es fundamental a la hora de distribuir software como GNUHealth que está basado en Python, sin la necesidad de requerir un intérprete.

Requerimientos[editar]

La última versión estable de GNU Health cuenta con los siguientes requisitos:

  1. Sistema Operativo: GNU Health es independiente del Sistema Operativo, aunque recomendamos usar un Sistema Operativo Libre (como GNU/Linux o FreeBSD)
  2. Base de Datos: PostgreSQL
  3. Python: >= 2.7 < 3.0
  4. Tryton: = 3.8

Paquetes Necesarios[editar]

Consultar Notas Específicas de Sistemas Operativos para más información

A continuación detallamos los paquetes necesarios para poder instalar GNUHealth:

  1. python-pip: Paquete que contiene la aplicación “pip”. pip es un sistema de gestión de paquetes que se utiliza para instalar y gestionar paquetes de software escritos en Python.
  2. python-imaging: Instala la Python Imaging Library (PIL).La PIL añade capacidades de procesamiento de imágenes para el intérprete de Python.
  3. postgresql: Paquete de instalación de PostgreSQL. PostgreSQL es un SGBD (Sistema de Gestión de Base de Datos) relacional orientado a objetos y libre, publicado bajo la licencia BSD.
  4. build-essential: Es un metapaquete (paquete de paquetes), es un paquete que se encarga de instalar otros paquetes a los que hace referencia y que son necesarios para la instalación de GNU Health.
  5. python-dev: Paquete necesario para utilizar el pip.
  6. libxml2-dev: Paquete de librerías para manejar los archivos xml que utiliza GNU Health
  7. libxslt1-dev: XSLT es un paquete que permite transformar los archivos XML en otros tipos de archivos como HTML, Texto Plano, etc.
  8. postgresql-server-dev-9.3: Herramientas de desarrollo para el servidor Porstgres.
  9. libldap2-dev: Este paquete permite el desarrollo de aplicaciones LDAP utilizando las bibliotecas OpenLDAP.
  10. libsasl2-dev: Archivos para el desarrollo de bibliotecas de abstracción de la autenticación - Cyrus SASL
  11. python-psycopg2: psycopg2 es un adaptador de base de datos PostgreSQL para el lenguaje de programación Python.
  12. python-gtk2: Enlaces de Python para el conjunto de elementos gráficos de GTK+.
  13. python-sql: librería que permite escribir queries en estilo pythónico.
  14. libjpeg-dev: Dependencia de Pillow.


Podemos instalar dichos paquetes mediante el siguiente comando:

# apt-get install build-essential python-dev python-pip \libxml2-dev libxslt1-dev libldap2-dev libsasl2-dev python-ldap \python-imaging python2.7-cracklib postgresql postgresql-server-dev-all libjpeg-dev

(Puede requerir permisos de superusuario para realizar está operación)


--GNUCeciliasp (discusión) 11:41 4 oct 2014 (UTC)

Instalar GNU Health en un Sistema GNU/Linux o FreeBSD[editar]


IMPORTANTE : Necesita instalar PostgreSQL, PIP, GCC y otras dependencias antes de instalar GNU Health. Por Favor compruebe Las Notas Específicas del Sistema Operativo para GNU Health

La siguiente guía de instalación se basa en la ejecución de líneas de comando en una Terminal. Para mayor información sobre como usar la Terminal de Comandos en Linux sugerimos leer la siguiente documentación

Crear el Usuario en el Sistema Operativo[editar]

Se recomienda emplear un usuario dedicado para la Instalación de GNU Health. Este usuario será diferente al usuario root del sistema.

Para la creación del usuario siga los siguientes pasos:

 sudo adduser gnuhealth

A continuación, se le solicitará ingresar una contraseña para el nuevo usuario gnuhealth. Le sugerimos tomar nota de la misma para su utilización en el futuro.

Crear el Usuario de Base de Datos en PostgreSql[editar]

El siguiente comando cambia al usuario administrador por defecto de dicho motor de base de datos (usuario postgres) y le otorga permisos al recientemente creado administrador gnuhealth. Se otorga permisos para crear usuarios y bases de datos (no permite crear roles ni permisos de superusuario en PostgreSql):

Ejecute, como root :

sudo su - postgres -c "createuser --createdb --no-createrole --no-superuser gnuhealth"

Descarga e Instalación de GNU Health[editar]

Ejecutando el Instalador de GNU Health[editar]

La instalación de GNUHealth debe realizarce con el usuario gnuhealth, prestar mucha atención en este punto es muy importante, (no con el usuario root del sistema). Al realizar la instalación con dicho usuario, se crearán los directorios en el directorio correspondiente al mismo.

Sugerencia: para mayor seguridad de estar como usuario gnuhealth, cerramos la sesión con la que instaló hasta este punto (generalmente el usuario root del sistema), e ingresamos con el usuario gnuhealth. Desde ahí podemos comenzar con todo el proceso que veremos a continuación. De esta manera nos aseguramos que la instalación no quede como propietaria del usuario root, ya que algunas distros Linux fallan en este punto. De esta manera, la instalación del kernel de GNU Health, estará siendo instalado correctamente bajo el usuario correcto gnuhealth y su entorno. Atención: si utiliza esta modalidad, comience desde el punto 2.

Los pasos principales son para la descarga e instalación son los siguientes :

1. Convertirse en el usuario gnuhealth

su - gnuhealth

2. Descargar GNU Health desde GNU.org . (También puede obtener la última versión desde http://ftp.gnu.org/gnu/health/gnuhealth-latest.tar.gz):

Para descargar la última versión es necesario utilizar el paquete Wget. Para mas información sobre el mismo consultar la documentación oficial
wget http://ftp.gnu.org/gnu/health/gnuhealth-latest.tar.gz

3. Descomprimir el archivo Una vez descargado el archivo de instalación (generalmente en /home), es necesario descomprimirlo mediante el siguiente comando:

tar xzf gnuhealth-latest.tar.gz
cd gnuhealth-*

De esta manera, se creará la carpeta "gnuhealth-2.6-x" la cuál contiene todos los archivos necesarios para correr el script de instalación.

4. Ejecutar el script gnuhealth_install.sh

Siendo que el script anterior nos posiciona dentro del directorio recientemente creado, podremos correr el script de instalación:

./gnuhealt.sh

(Requiere conexión activa a Internet)

Nota: En instalaciones reciente puede instalar usando el script gnuhealth-setup, con el comando install:

./gnuhealth-setup install

(Requiere conexión activa a Internet)


Finalmente, habilite el entorno BASH para el usuario gnuhealth para poder definir las variables de entorno:

source $HOME/.gnuhealthrc

Active los dispositivos de red para el protocolo JSON-RPC[editar]

El servidor Tryton de GNU Health atiende peticiones de red de localhost en el puerto 8000, no permitiendo conexiones directas desde otras terminales. Para ello es necesario editar el archivo /home/gnuhealth/gnuhealth/tryton/server/trytond-3.2.2/etc/trytond.conf. Esto puede hacerse mediante un editor de texto o a través del comando

editconf

Puede modificar la línea con el parámetro jsonrpc, activando el dispositivo de red para que las terminales en su red se puedan conectar. Por ejemplo, la siguiente línea

[jsonrpc]
listen = *:8000

Permitirá conectar con el servidor en los diferentes dispositivos de su sistema.

Configuración de un directorio local para archivos adjuntos[editar]

Por defecto, Tryton utiliza un directorio a nivel de sistema para almacenar los archivos adjuntos. En GNU Health es recomendable guardar los archivos adjuntos en el espacio de usuario gnuhealth. Con un editor de texto, abra el archivo de configuración del servidor trytond.conf e ingrese el directorio para archivos adjuntos, por ejemplo :

editconf
[database]
path = /home/gnuhealth/attach

Arrancar el Servidor Tryton[editar]

Para poder iniciar el servidor Tryton (//home/gnuhealth/gnuhealth/tryton/server/trytond-3.2.2/bin/trytond) debe moverse al directorio del sistema que acabamos de instalar. Para ello es posible utilizar el alias cdexe (disponible desde la versión 2.2.1 )

cdexe

Ahora sí estamos en condiciones de iniciar el servidor:

./trytond -v

Deberá ver algo como lo siguiente. Preste atención a la última línea INFO:server:starting JSON-RPC protocol on localhost:8000

[Sat Oct 29 21:03:48 2011] INFO:server:using default configuration
[Sat Oct 29 21:03:48 2011] INFO:server:initialising distributed objects services
[Sat Oct 29 21:03:48 2011] INFO:server:starting JSON-RPC protocol on localhost:8000

Esta última línea nos indica (tal como se haya configurado el archivo trytond.conf) si el sistema estará disposible para el localhost unicamente o para todas las terminales dentro de su red.

Instalación del cliente Tryton[editar]

Instalación Tradicional[editar]

GNU Health utiliza el cliente Tryton como interfaz de usuario. Si usted está en un sistema operativo Windows, puede descargar el último Tryton compatible con GNU Health de aquí [1], y ejecutar el archivo exe para correr el cliente.

Si Ud. está utilizando un sistema operativo UNIX/Linux, por favor siga estos pasos:

Por favor NO instale el cliente con el usuario gnuhealth . El usuario gnuhealth debe ser responsable solo de ejecutar el servidor

Podemos crear un usuario específico para ejecutar el cliente , mediante los siguientes comandos, (Puede ingresar el nombre de usuario que desee, "cliente" es a modo de ej.)

Primero debemos volver al usuario root del sistema (lease "root" como su usuario root)

su "root"

Luego agregamos el usuario para correr el cliente

sudo adduser cliente

Luego cambiamos al usuario cliente

su cliente

Luego descargamos el cliente de Tryton

sustituir XX, YY y ZZ por la version del servidor, ej. en el caso del servidor 3.8.3 XX=3,YY=8, ZZ=3, si el servidor es el 3.2.5 XX=3,YY=2, ZZ=5, etc.
wget http://downloads.tryton.org/XX.ZZ/tryton-XX.YY.ZZ.tar.gz

Una vez descargado el archivo de instalación (generalmente lo ubicará en /home), es necesario descomprimirlo mediante el siguiente comando:

tar -xzvf tryton-3.2.5.tar.gz

Una vez descomprimido el archivo de instalación, es necesario instalarlo mediante el siguiente comando:

cd tryton-3.2.5 
sudo python setup.py install

Si tira un error al correr este script de instalación es necesario instalar las dependencias, generalmente en terminales se soluciona mediante el siguiente comando:

sudo apt-get install python-setuptools

Para ejecutar el cliente corremos:

cd tryton-3.2.5/bin 
./tryton

MS Windows[editar]

Descarga de Tryton Cliente para Windows


Visite el siguiente enlace y busque la ultima versión

http://downloads.tryton.org/3.2


Siga las instrucciones al correr la instalación

Método Alternativo[editar]

Una opción para descargar el último Tryton compatible con GNU Health con el comando PIP. Puede instalar el cliente Tryton con el siguiente comando:

pip install --user "tryton>=3.2,<3.3"

Esto instalará el cliente tryton en el directorio $HOME/.local/bin.


Nota: Si usted tiene un cliente de Tryton viejo (instalado con PIP), que se puede actualizar a la última versión con el siguiente comando :

pip install --upgrade --user tryton


Para ejecutarlo, puede correr:

cd $HOME/.local/bin
 ./tryton

Esto iniciará el cliente tryton

Colocar las solapas del cliente Tryton en la posición correcta para GNU Health[editar]

Antes de comenzar con la instalación de la base de datos, es necesario colocar la posición de las solapas en la posición de arriba "Top". De esta manera tendremos una navegación óptima.

La siguiente acción en el cliente Tryton lo llevará a cabo: Opciones -> Formulario -> Posición de las Pestañas -> Superior

GNU Health Client Tabs position.png

Finalmente, guarde los cambios en las preferencias del cliente Opciones -> Guardar Opciones


También se puede cambiar el valor “top” por defecto del archivo de configuración del cliente Tryton, que se aloja en el directorio $HOME, ($HOME/.config/x.y/). Por tanto para una versión Tryton 2.0, puede chequear el valor de la solapa de posiciones haciendo lo siguiente:

gnuhealth@server:~$ cd $HOME/.config/tryton/2.2
gnuhealth@server:~/.config/tryton/2.2$ grep form_tab tryton.conf

Debe volver a form_tab = top. Si tiene otro valor, por favor cámbielo por "top".

Crear la base de datos de GNU Health[editar]

El primer paso es crear una base de datos que contenga toda la información para sistema GNU Health.

Toda la información de GNU Health está almacenada en una base de datos PostgreSQL, y es procesada por el núcleo de Tryton. No se necesita realizar ninguna acción a nivel del sistema operativo para crear o gestionar la base de datos, ya que todo puede hacerse a través de la interfaz Tryton / GNU Health.

Para crear la base de datos, abra el cliente Tryton. Se le abrirá la siguiente ventana emergente para iniciar sesión:

GNU Health login popup.png

Haga click en los perfiles de gestión Administrar Perfiles, y después haga click en añadir Añadir. Dé a su nueva conexión un nombre en el lugar izquierdo y complete los campos del lado derecho. Si está haciendo la instalación en la misma máquina, elija localhost como hostname. Ejemplo:

GNU Health Profile Editor.png

Haga click en el botón Nueva, aparecerá el siguiente emergente:

GNU Health Create new database.png

La contraseña por defecto para el Servidor Tryton es admin (podrá cambiarla después). Ponga nombre a a su base de datos e introduzca una nueva contraseña de admin dos veces. Nota: esta será la contraseña del super-usuario de su nueva base de datos, por lo que se recomienda utilizar una contraseña fuerte para trabajar con servidores de producción.

Una vez creada la base de datos, haga click en Listo. Ya está preparado para iniciar sesión !

Inicio de sesión de la aplicación[editar]

Ahora que ha vuelto a la pantalla de inicio de sesión, notará que el perfil seleccionado es el que recién acaba de crear. Complete el formulario de inicio de sesión:

  • Nombre de usuario: el nombre que ha usado antes, normalmente, admin
  • Contraseña: la contraseña introducida dos veces en la sección anterior

Instalación de los módulos por defecto[editar]

A partir de este momento, usará el cliente para la mayoría de los procesos. Empiece por la instalación de la funcionalidad básica:

  1. Después de haber creado la base de datos, el sistema le preguntará para la creación de algunos usuarios nuevos. Puede saltar este paso desde ahora.
  2. Se le mostrará un listado de módulos que le proporcionarán la funcionalidad deseada. Si no ve la ventana de los módulos, navegue hacia ella en el lado derecho: Administración > Módulos > Módulos.
  3. Seleccione el módulo de perfiles health_profile, y haga click en marcar para instalación Marcar para instalación:

    GNU Health Module selection.png

  4. Haga click en el icono de Ejecutar Acción (un cuadrado rotado azul) y seleccione Realizar instalaciones/actualizaciones pendientes:

    GNU Health Module selection - Marked for installation.png

  5. Tryton seleccionará de manera automática todos los módulos dependientes requeridos para la instalación:

    GNU Health Perform Pending Installation-Upgrade.png

  6. Haga Click en iniciar actualización Iniciar Actualización. Este proceso tomará un tiempo, dependiendo del ordenador en el que se esté instalando GNU Health. Una vez hecho, aparecerá el siguiente mensaje:

    GNU Health system upgrade done message.png

Enhorabuena, ha instalado satisfactoriamente GNU Health!

Instalación de Módulos Extra[editar]

GNU Health está en evolucionando constantemente. Los módulos base son un paquete que brinda la funcionalidad básica. Dependiendo de su centro de salud, lo más probable es que deba instalar algunos de los otros módulos de GNU Health. Algunos de los módulos que están listos para su instalación son:

  • health_history: Genera reportes de la historia clínica del paciente.
  • health_reporting: Estadísticas basadas en diferentes indicadores (enfermedades, asignaciones médicas, .. ). También crea diferentes tipos de gráficos
  • health_services: Registra todos los servicios brindados al paciente, tanto para tratamiento ambulatorio como para hospitalización. Le permitirá generar facturas de los servicios seleccionados.
  • health_qrcodes: Permite identificar al paciente y los recién nacidos con códigos QR 2-dimensional Quick-Recognition codes.

Hay muchos más. Sólo hay que revisar la lista de módulos y seleccionar los que mejor se adapten a su centro de salud.

Enhorabuena ! Ya ha completado la instalación inicial de GNU Health.

Los próximos capítulos le guiarán a través de la personalización de GNU Health para satisfacer las necesidades de su centro de salud.


Epidemiología · Actualización