Diferencias

Muestra las diferencias entre dos versiones de la página.

--- f1:respaldarv2 [2018/10/24 04:23] – creado lmachuca
+++ f1:respaldarv2 [2018/12/27 13:31] (actual) – lmachuca
@@ Línea 1: / Línea 1: @@
-Respaldarv2 es un script de respaldos para bases de datos de MySQL, para varios productos de Helpcom.
+======respaldarv2======
+Respaldarv2 es un script de respaldos para bases de datos de MySQL, que se puede usar para varios productos de Helpcom. En particular, se puede usar en [[:Instalación Linux Servidor]].
+<note info>
+Documento y software en versión preliminar.
+</note>
 =====Obtener =====
-FIXME Pendiente Publicar
+  * Clonar desde el [[https://chiselapp.com/user/lmachucab/repository/respaldarv2|Repositorio Chiselapp]]
+  * SFTP Helpcom
 =====Prerequisitos=====
-  * Equipo con Linux o Windows.
+  * Soporte para **Fossil**, versión 1.37 o posterior.
-  * Soporte para **Python 2.7 o posterior**.
+  * Soporte para **Python 2.7**. [[f1:Python|Ver Instalar Python]].
-    * En Debian 8 en adelante viene por defecto.
+  * Soporte para los siguientes paquetes de Python: ''subprocess'', ''configparser'', ''mysql'', ''tailer''.
-    * En Windows XP instalar Python %%<=%% 3.4; versiones posteriores sólo funcionan con Windows 7.
+  * Soporte para las herramientas **MySQL client**: ''mysql'' y ''mysqldump'' al menos.
-  * Soporte para los siguientes paquetes de Python: ''subprocess'', ''configparser'', ''mysql''.
+    * De ser posible estas herramientas deben encontrarse en el ''$PATH''.
+=====Instalación=====
+La página web del repositorio da las instrucciones para clonar. O se puede seguir estos pasos:
+<code bash>
+administrador$ fossil clone https://chiselapp.com/user/lmachucab/repository/respaldarv2 respaldarv2.fossil
+administrador$ fossil open respaldarv2.fossil
+</code>
+Alternativamente, la página web del repositorio ofrece enlaces de descarga directa para usar con ''wget'' o ''curl'' o similar.
 =====Uso=====
+Para utilizar el script es necesario preparar un archivo ''.ini'' con la información que describe qué base de datos se va a extraer y de dónde. Este archivo tiene el nombre por defecto **''respaldar.ini''** pero se puede tener cualesquiera archivos ini con nombres; el programa toma como argumento qué ini procesar.
-Para utilizar el script es necesario preparar un archivo ''.ini'' con la información que describe qué base de datos se va a extraer y de dónde. A continuación se publica un ejemplo de archivo.
+La documentación en el repositorio muestra la estructura del archivo .ini.
-<code ini prueba.ini>
+====Entorno Gráfico====
-host=192.168.1.100
-port=3306
+El script va acompañado de dos archivos que son lanzadores en modo gráfico: mientras estén en el mismo directorio que el script original ''respaldar.py'', basta con arrastrar y soltar un archivo .ini a este lanzador gráfico:
-user=usuario
-pass=password
+  * ''argv1.bat'': Lanzador gráfico para Windows, lanza la ventana de CMD que permite tomar el ini y lanzar la aplicación.
-db=temp
+  * ''argv1.desktop'': Lanzador gráfico para Linux, lanza la ventana de terminal y permite asignar a un menú o botón del panel.
-name=prueba
+=====Notas=====
+==== Dependencias ====
+Para instalar los módulos de python que se necesitan como dependencias debiera bastar con los siguientes comandos:
+  pip install --user configparser
+  pip install --user subprocess
+  pip install --user tailer
+==== Instalar Cliente MySQL ====
+Para ejecutar correctamente el script asume que es posible encontrar las aplicaciones de MySQL en el ''$PATH'', ya sea en Windows o en Linux. Si éste no fuera el caso es posible hacer una de dos cosas:
+  * Copiar los ejecutables de ''mysqldump'' y las librerías que requiere en la misma carpeta que el programa de respaldos.
+  * Utilizar la variable ''mysqldump'' en el archivo.ini para poder apuntar a la ruta donde se encuentra el programa.
+==== Ejemplo: Instalar en Linux ====
+  - En el gestor de paquetes instalar las herramientas de Fossil, MySQL Client y Python pip.
+  - Descomprimir nuestro programa de respaldo en una carpeta, por ejemplo ''respdb''.
+  - ...¡Listo! Linux es así de fácil.
+Ejemplo de línea de comando para instalar las herramientas en Debian:
+  apt-get install fossil mysql-client mysql-utilities python2 python-pip virtualenv
+==== Instalar en Windows XP ====
+  - Descomprimir nuestro programa de respaldo en una carpeta, por ejemplo ''respdb''.
+  - Instalar **Python for Windows 2.7.9** desde algunas de las fuentes indicadas arriba.
+  - En las opciones de instalación asegurarse que están seleccionados todos los script (FIXME TOBEDONE agregar foto)
+  - Instalar las herramientas de consola de MySQL desde un instalador de [[:f1:Mysql Server]] o de un MySQL Community Wizard.
+  - Abrir una consola de CMD y llevar la terminal al directorio del entorno de Python (1)
+  - Ejecutar ''pip.exe'' para instalar los componentes y dependencias en el entorno (2)
+  - Si el equipo **no** tiene las herramientas de MySQL agregadas en el ''%PATH%'', \\ copiar los siguientes archivos a la misma carpeta: (3)
+:
+<code cmd 1>
+rem cambiar la ruta de Python por la que se usó al instalar el sistema
+C:
+cd \Python27\Tools
 </code>
+:
+<code cmd 2>
+pip.exe install --user configparser tailer subprocess
+</code>
+:
+<file>
+mysqldump.exe
+mysql.exe
+libmysql.dll
+</file>
+{{tag>helpcom sistemas python}}