dhis2-devs team mailing list archive

[noreply@xxxxxxxxxxxxx]

------------------------------------------------------------
revno: 591
committer: Inés Bebea <ines.bebea@xxxxxxxxxx>
branch nick: dhis2-docbook-docs
timestamp: Tue 2012-10-09 20:59:03 +0200
message:
  Implementation guide in Spanish: chapter 3 completed
modified:
  src/docbkx/es/dhis2_implementation_guide_installation.xml
  src/docbkx/es/dhis2_implementation_guide_setting_up_new_database.xml


--
lp:~dhis2-documenters/dhis2/dhis2-docbook-docs
https://code.launchpad.net/~dhis2-documenters/dhis2/dhis2-docbook-docs

Your team DHIS 2 developers is subscribed to branch lp:~dhis2-documenters/dhis2/dhis2-docbook-docs.
To unsubscribe from this branch go to https://code.launchpad.net/~dhis2-documenters/dhis2/dhis2-docbook-docs/+edit-subscription

=== modified file 'src/docbkx/es/dhis2_implementation_guide_installation.xml'
--- src/docbkx/es/dhis2_implementation_guide_installation.xml	2012-10-08 22:27:00 +0000
+++ src/docbkx/es/dhis2_implementation_guide_installation.xml	2012-10-09 18:59:03 +0000
@@ -12,7 +12,11 @@
     <para>Para un servidor nacional los requisitos hardware son un procesador quad-core 2GHz o superior y 12GB de RAM o superior. Nótese que se requiere un sistema operativo de 64 bits para utilizar más de 4 GB de RAM, por lo que se recomienda la edición Ubuntu 12.04 de 64 bits.</para>
     <para>En esta guía asumiremos que 4 GB se asignan a PostgreSQL y 7GB de RAM se asignan a Tomcat. <emphasis role="italic">¡Si estás utilizando una configuración distinta por favor ajusta los valores sugeridos en consecuencia!</emphasis>. Los pasos que marcaremos como <emphasis role="italic">opcional</emphasis>, como el paso de ajuste de rendimiento, pueden realizarse en un momento posterior.</para>
     <para><emphasis role="bold">Crear nuevo usuario (opcional)</emphasis></para>
-    <para>Tal vez queramos crear un usuario dedicado para ejecutar DHIS - no es recomendable ejecutarlo como usuario root. Creamos un nuevo usuario llamado dhis invocando <code>useradd -d /home/dhis -m dhis -s /bin/bash</code>   A continuación habilitamos al usuario para realizar operaciones como root temporalmente invocando <code>adduser dhis admin</code>   Si no hay grupo admin en el sistema, crearemos dicho grupo primero invocando <code>groupadd admin</code>   Después invocamos <code>passwd dhis</code> para fijar la contraseña de esta nueva cuenta de usuario. Nos aseguraremos de poner una contraseña fuerte con al menos 15 caracteres aleatorios. Tal vez queramos deshabilitar el login remoto para la cuenta de root, logrando así mayor seguridad, invocando <emphasis role="italic"> sudo passwd -l root</emphasis>.</para>
+    <para>Tal vez queramos crear un usuario dedicado para ejecutar DHIS - no es recomendable ejecutarlo como usuario root. Creamos un nuevo usuario llamado dhis invocando <code>useradd -d /home/dhis -m dhis -s /bin/bash</code> </para>
+    <para>A continuación habilitamos al usuario para realizar operaciones como root temporalmente invocando <code>adduser dhis admin</code> </para>  
+    <para>Si no hay grupo admin en el sistema, crearemos dicho grupo primero invocando <code>groupadd admin</code></para>
+    <para>Después invocamos <code>passwd dhis</code> para fijar la contraseña de esta nueva cuenta de usuario. Nos aseguraremos de poner una contraseña fuerte con al menos 15 caracteres aleatorios. </para>
+    <para>Tal vez queramos deshabilitar el login remoto para la cuenta de root, logrando así mayor seguridad, invocando <code> sudo passwd -l root</code></para>
     <para><emphasis role="bold">Ajuste del núcleo del sistema operativo</emphasis></para>
     <para>Estas configuraciones son opcionales excepto para la configuración de la memoria compartida, que es un requisito para la asignación de memoria para PostgreSQL. Abrimos el fichero de configuración del núcleo o kernel invocando <code>sudo nano /etc/sysctl.conf</code>   Al final del fichero añadiremos las líneas siguientes y guardaremos el fichero.</para>
     <screen>kernel.shmmax = 1073741824
@@ -61,8 +65,8 @@
 hibernate.hbm2ddl.auto = update</screen></para>
     <para>Un error frecuente es dejar un espacio en blanco después del último valor de propiedad - asegúrate de que no hay espacios en blanco al final de ninguna línea en este fichero. También debemos recordar que este fichero contiene la contraseña en claro de nuestra base de datos dhis2 de modo que deberemos protegerlo de accesos no autorizados. Para hacer esto invocamos <code>chmod 0600 hibernate.properties</code> que garantiza que solo el usuario dhis que es propietario del fichero puede leer o escribir en él.</para>
     <para><emphasis role="bold">Instalar Tomcat</emphasis></para>
-    <para>Descarga la distribución binaria de Tomcat de <emphasis role="italic">http://tomcat.apache.org/download-70.cgi</emphasis>. Una herramienta útil para descargar ficheros desde la web es <emphasis role="italic">wget</emphasis>. Extraemos el fichero en una ubiación adecuada. Esta guía asume que hemos navegado al directorio root del fichero extraido.</para>
-    <para>Limpiamos las aplicaciones web preinstaladas invocando <code>rm -rf webapps/*</code> Descargamos el último fichero WAR de DHIS 2 desde <emphasis role="italic">http://dhis2.org/download</emphasis>, lo movemos al directorio <emphasis role="italic">webapps</emphasis> y lo renombramos como <emphasis role="italic">ROOT.war</emphasis></para>
+    <para>Descarga la distribución binaria de Tomcat de <emphasis role="italic">http://tomcat.apache.org/download-70.cgi</emphasis>. Una herramienta útil para descargar ficheros desde la web es <emphasis role="italic">wget</emphasis>. Extraemos el fichero en una ubicación adecuada. Esta guía asume que hemos navegado al directorio root del fichero extraido.</para>
+    <para>Limpiamos las aplicaciones web preinstaladas invocando <code>rm -rf webapps/*</code> Descargamos el último fichero WAR de DHIS 2 desde <emphasis role="italic"> http://dhis2.org/download</emphasis>, lo movemos al directorio <emphasis role="italic">webapps</emphasis> y lo renombramos como <emphasis role="italic">ROOT.war</emphasis></para>
     <para>Abrimos el fichero <emphasis role="italic">bin/setclasspath.sh</emphasis> y añadimos las líneas que siguen. Lo primero será fijar la ubicación de nuestro Java Runtime Environment, lo segundo será dedicar memoria a Tomcat y lo tercero será fijar la ubicación en la que DHIS 2 buscará el fichero de configuración <emphasis role="italic">hibernate.properties</emphasis>. Es importante aquí que chequeemos que la ruta a la ubicación del JDK es correcta. Notemos que deberemos ajustar esto a nuestro entorno:</para>
     <para><screen>export JAVA_HOME=&apos;/usr/lib/jvm/java-7-openjdk&apos;
 export JAVA_OPTS=&apos;-Xmx6000m -Xms3000m -XX:MaxPermSize=800m -XX:PermSize=400m&apos;
@@ -70,7 +74,7 @@
     <para>Si necesitamos cambiar el <emphasis role="italic">puerto</emphasis> en el que Tomcat escucha las peticiones, podemos abrir el fichero de configuración de Tomcat <emphasis role="italic">/conf/server.xml</emphasis>, encontrar el elemento <emphasis role="italic">&lt;Connector&gt;</emphasis> que no está comentado y cambiar el valor de su atributo <emphasis role="italic">puerto</emphasis> por el número de puerto deseado.</para>
     <para>El log será nuestra primera fuente de información cuando queramos monitorear el comportamiento de Tomcat. Podemos ver fácilmente el log invocando <code>tail -f logs/catalina.out</code></para>
     <para><emphasis role="bold">Ejecutar DHIS 2</emphasis></para>
-    <para>Para terminar haremos ejecutable el script de arranque invocando <code>chmod 755 bin/*</code>   Ahora podemos arrancar DHIs 2 invocando <code>bin/startup.sh</code>   Podemos monitorear el log invocando <code>tail -f logs/catalina.out</code>   Podemos detener DHIS 2 invocando <code>bin/shutdown.sh</code>   Finalemente, asumiendo que el fichero WAR se llama ahora ROOT.war, podemos acceder a nuestra instancia DHIS a través del navegador web en <emphasis role="italic">http://localhost:8080</emphasis>.</para>
+    <para>Para terminar haremos ejecutable el script de arranque invocando <code>chmod 755 bin/*</code>   Ahora podemos arrancar DHIs 2 invocando <code>bin/startup.sh</code>   Podemos monitorear el log invocando <code>tail -f logs/catalina.out</code>   Podemos detener DHIS 2 invocando <code>bin/shutdown.sh</code>   Finalemente, asumiendo que el fichero WAR se llama ahora ROOT.war, podemos acceder a nuestra instancia DHIS a través del navegador web en <emphasis role="italic"> http://localhost:8080</emphasis>.</para>
   </section>
 
 
@@ -345,21 +349,22 @@
     </section>
   </section>
   <section>
-    <title>Configuración de DHIS 2 Live</title>
-    <para>The DHIS 2 Live package is extremely convenient to install and run. It is intended for demonstrations, for users who want to explore the system and for small, offline installations typically at districts or facilities. It only requires a Java Runtime Environment and runs on all browsers except Internet Explorer 7 and lower.</para>
-    <para>To install start by downloading DHIS 2 Live from <emphasis role="italic">http://dhis2.org</emphasis> and extract the archive to any location. On Windows click the executable archive. On Linux invoke the startup.sh script. After the startup process is done your default web browser will automtically be pointed to  <emphasis role="italic">http://localhost:8082</emphasis> where the application is accessible. A system tray menu is accessible on most operating systems where you can start and stop the server and start new browser sesssions. Please note that if you have the server running there is no need to start it again, simply open the application from the tray  menu.</para>
-    <para>DHIS 2 Live is running on an embedded Jetty servlet container and an embedded H2 database. However it can easily be configured to run on other database systems such as PostgreSQL. Please read the section above about server installations for an explanation of the database configuration. The <emphasis role="italic">hibernate.properties</emphasis> configuration file is located in the <emphasis role="italic">conf</emphasis> folder. Remember to restart the Live package for your changes to take effect. The server port is 8082 by default. This can be changed by modifying the value in the<emphasis role="italic"> jetty.port</emphasis> configuration file located in the <emphasis role="italic">conf</emphasis> directory.</para>
-  </section>
-  <section>
-    <title>Backup</title>
-    <para>Doing automated database backups for information systems in production is an absolute must, and might have uncomfortable consequences if ignored. Backups have two main purposes: The primary is data recovery in case data is lost, the secondary purpose is archiving of data for a historical period of time.</para>
-    <para>Backup should be central in a disaster recovery plan. Even though such a plan should cover additional subjects, the database is the key component to consider since this is where all data used in the DHIS 2 application is stored. Most other parts of the IT infrastructure surrounding the application can be restored based on standard components.</para>
-    <para>There are of course many ways to set up backup; however the following describes a setup where the database is copied into a dump file and saved on the file system. This can be considered a <emphasis role="italic">full</emphasis> backup. The backup is done with a <emphasis role="italic">cron job</emphasis>, which is a time-based scheduler in Unix/Linux operating systems.</para>
-    <remark>You can download both files from http://dhis2.com/download/pg_backup.zip</remark>
-    <para>The cron job is set up with two files. The first is a <emphasis role="italic">script</emphasis> which performs the actual task of backup up the database. It uses a PostgreSQL program called <emphasis role="italic">pg_dump</emphasis> for creating the database copy. The second is a crontab file which runs the backup script every day at 23:00. Note that this script backs up the database file to the local disk. It is strongly recommended to store a copy of the backup at a location outside the server where the application is hosted. This can be achieved with the <emphasis role="italic">scp</emphasis> tool. Make sure that you have set the system date correctly on your server.</para>
-  </section>
-  <section>
-    <title>Usando los servicios Web Amazon</title>
+    <title>Instalación de DHIS 2 Live</title>
+    <para>El paquete DHIS 2 Live es muy cómodo de instalar y ejecutar. Está pensado para ejemplos demostrativos, para usuarios que quieren explorar el sistema y para instalaciones pequeñas, offline típicamente en distritos o establecimientos de salud. Solo requiere el Entorno de Ejecución de Java (Java Runtime Environment) y funciona en todos los navegadores web excepto Internet Explorer 7 o versiones anteriores.</para>
+    <para>Para instalarlo comenzaremos descargando DHIS 2 Live de la página <emphasis role="italic">http://dhis2.org</emphasis> y extrayendo el archivo en alguna ubicación. En Windows pincharemos en el archivo ejecutable. En Linux invocamos el script <code>startup.sh</code> </para>
+    <para>Después del proceso de arranque, nuestro navegador web por defecto estará apuntando automáticamente a <emphasis role="italic">http://localhost:8082</emphasis>, donde se encuentra la aplicación. En la mayoría de sistemas operativos aparecerá un menú de sistema donde podremos arrancar y parar el servidor, así como iniciar nuevas sesiones de navegador. Notemos que si el servidor está funcionando no hay necesidad de arrancarlo de nuevo, sino simplemente abrir la aplicación desde el menú de sistema.</para>
+    <para>DHIS 2 Live se ejecuta en un contenedor Servlet Jetty embebido y con una base de datos H2 embebida. Sin embargo, podremos configurarlo para funcionar con otros sistemas de bases de datos como PostgreSQL. Encontraremos una explicación detallada sobre la configuración de una base de datos en la sección anterior sobre instalación en servidor. El fichero de configuración <emphasis role="italic">hibernate.properties</emphasis> se encuentra en la carpeta <emphasis role="italic">conf</emphasis>. Es importante acordarnos de reiniciar el paquete Live para que los cambios tengan efecto. El puerto del servidor es 8082 por defecto. Esto también podemos cambiarlo modificando el valor correspondiente en el fichero de configuración<emphasis role="italic"> jetty.port</emphasis> que se encuentra en el directorio <emphasis role="italic">conf</emphasis>.</para>
+  </section>
+  <section>
+    <title>Copias de seguridad (Backup)</title>
+    <para>Es indispensable hacer copias de seguridad automatizadas de las bases de datos de sistemas de información en producción. Ignorar esto puede traer consecuencias desagradables. Las copias de seguridad tienen dos propósitos principales: el primero es la recuperar los datos en caso de que suceda una pérdida de datos, el segundo es archivar los datos durante un periodo de tiempo histórico.</para>
+    <para>Las copias de seguridad son fundamentales en un plan de recuperación del desastre. Incluso cuando un plan como este debería cubrir también otros asuntos, la base de datos es el componente clave a considerar porque es ahí donde se guardan todos los datos utilizados en la aplicación DHIS 2. Las otras partes de la infraestructura TIC en torno a la aplicación se pueden restaurar en base a componentes estándar.</para>
+    <para>Por supuesto hay muchas maneras de configurar copias de seguridad; sin embargo, a continuación describimos una configuración donde la base de datos se copia en un fichero dump y se guarda en el sistema de ficheros. Esto puede considerarse una copia de seguridad <emphasis role="italic">completa</emphasis>. La copia de seguridad se realiza con el <emphasis role="italic">cron</emphasis>, que es un programador temporal en los sistemas operativos Unix/Linux.</para>
+    <remark>Podemos descargar ambos ficheros de la página http://dhis2.com/download/pg_backup.zip</remark>
+    <para>El cron se configura con dos ficheros. El primero es un <emphasis role="italic">script</emphasis> de backup que realiza la tarea misma de hacer la copia de seguridad de la base de datos. Utiliza un programa PostgreSQL llamado <emphasis role="italic">pg_dump</emphasis> para crear la copia de la base de datos. El segundo es un fichero crontab que lanza el script de backup cada día a las 23:00. Notemos que este script hace la copia de seguridad de la base de datos y la guarda en un fichero en el disco local. Es muy recomendable guardar una copia de esto también fuera del servidor donde se aloja la aplicación. Esto podemos conseguirlo con la herramienta <emphasis role="italic">scp</emphasis>. Deberemos asegurarnos de que hemos fijado la fecha y hora del sistema correctamente en nuestro servidor.</para>
+  </section>
+  <section>
+    <title>Usando los Servicios Web Amazon</title>
     <para>Amazon Web Services (AWS) offers virtual cloud-computing resources which allow developers and implementers to quickly scale an application, both horizontally and vertically, in a cost effective manner. AWS offers multiple operating systems and instance sizes depending on the exact nature of the deployment. This section will describe a basic setup with the AWS Elastic Cloud Compute (EC2) system using the Basic 32 bit Amazon AMI, which is based on the Red Hat Linux distribution. </para>
     <para>Estimating the cost of an AWS instance can be performed using the<ulink url="http://calculator.s3.amazonaws.com/calc5.html";> &quot;Simple Monthly Cal culator&quot;</ulink>. AWS costs are based entirely on usage. As your application usage grows, you can provision new servers. </para>
     <orderedlist>

=== modified file 'src/docbkx/es/dhis2_implementation_guide_setting_up_new_database.xml'
--- src/docbkx/es/dhis2_implementation_guide_setting_up_new_database.xml	2012-10-08 22:27:00 +0000
+++ src/docbkx/es/dhis2_implementation_guide_setting_up_new_database.xml	2012-10-09 18:59:03 +0000
@@ -37,8 +37,8 @@
      .</para>
   </section>
   <section>
-    <title>Pasos para desarrollar una base de datos</title>
-    <para>Esta sección describe los pasos concretos para desarrollar una base de datos partiendo de cero.</para>
+    <title>Pasos para elaborar una base de datos</title>
+    <para>Esta sección describe los pasos concretos para elaborar una base de datos desde el principio.</para>
     <section>
       <title>Jerarquía organizativa</title>
       <para>La jerarquía organizativa define la organización en DHIS 2: los establecimientos de salud, las áreas administrativas y otras áreas geográficas utilizadas en la recolección y el análisis de datos. Esta dimensión de los datos se define como una jerarquía con una unidad raíz (ej. Ministerio de Salud) y diversos niveles y nodos debajo. Cada nodo en esta jerarquía es lo que en DHIS 2 llamamos unidad organizativa. El diseño de esta jerarquía determinará las unidades geográficas de análisis disponibles a los usuarios al momento en que los datos son registrados y agregados en esta estructura. Solo puede haber una jerarquía organizativa en el sistema, de modo que deberemos considerar cuidadosamente cómo estructurarla.</para>
@@ -67,15 +67,15 @@
     </section>
     <section>
       <title>Tablas de reporte e informes</title>
-      <para>Standard reports in DHIS 2 is a very flexible way of presenting the data that has been collected. Data can be aggregated by any organisational unit or orgunit level, by data element, by indicators, as well as over time (e.g. monthly, quarterly, yearly). The report tables are custom data sources for the standard reports and can be flexibly defined in the user interface and later accessed in external report designers such as iReport or BIRT. These report designs can then be set up as easily accessible one-click reports with parameters so that the users can run the same reports e.g. every month when new data is entered, and also be relevant to users at all levels as the organisational unit can be selected at the time of running the report.</para>
+      <para>Una manera muy flexible de presentar los datos que se han recopilado son los reportes estándar en DHIS 2. Los datos pueden ser agregados por unidad organizativa o cualquier nivel de orgunit, por elemento de datos, por indicadores, así como a lo largo del tiempo (por ejemplo, mensual, trimestral, anualmente). Las tablas de reportes son fuentes de datos personalizadas para los reportes estándar y se pueden definir de manera flexible en el interfaz de usuario y posteriormente acceder a ellas con diseñadores externos de reportes como iReport o BIRT. Estos diseños de reporte se pueden configurar para ser accesibles fácilmente "one-click" con unos parámetros predefinidos de modo que los usuarios puedan lanzar los mismos reportes, por ejemplo, cada mes cuando se introducen nuevos datos, y también pueden ser relevantes a usuarios a todos los niveles ya que la unidad organizativa puede seleccionarse al momento de lanzar el reporte.</para>
     </section>
     <section>
       <title>SIG (Mapas)</title>
-      <para>In the integrated GIS module you can easily display your data on maps, both on polygons (areas) and as points (health facilities), and either as data elements or indicators. By providing the coordinates of your organisational units to the system you can qucikly get up to speed with this module. See the GIS section for details on how to get started.</para>
+      <para>En el módulo integrado de SIG podemos mostrar fácilmente nuestros datos en mapas, tanto en polígonos (áreas) como en puntos (establecimientos de salud), y tanto los elementos de datos como los indicadores. Si añadimos al sistema las coordenadas de nuestras unidades organizativas, podemos rápidamente comenzar a trabajar con este módulo. Recomendamos ver la sección SIG para más detalles sobre cómo configurar este módulo.</para>
     </section>
     <section>
       <title>Gráficos y dashboard</title>
-      <para>On of the easiest way to display your indicator data is through charts. An easy to use chart dialogue will guide you through the creation of various types of charts with data on indicators, organisational units and periods of your choice. These charts can easily be added to one of the four chart sections on your dashboard and there be made easily available right after log in. Make sure to set the dashboard module as the start module in user settings.</para>
+      <para>Una de las maneras más sencillas de mostrar nuestros datos de indicadores es utilizar gráficas. Una pantalla de diálogo amigable nos guiará a través de la creación de varios tipos de gráficas con data de indicadores, unidades organizativas y periodos a nuestra elección. Estas gráficas pueden añadirse fácilmente a una de las cuatro secciones del dashboard destinadas a gráficas, y así las tendremos disponibles directamente al entrar en nuestra sesión. Para esto deberemos fijar el módulo dashboard como el módulo de inicio en la configuración de usuario.</para>
     </section>
   </section>
 </chapter>