Manual de instalación de Demonio REGTEL Documento Público Título del informTítulo del inform CONTROL DE VERSIONES Versión Fecha 1.0 Autor 12/08/2015 Fermín Méndez Descripción / Cambios Relevantes Primera versión Manual de instalación del Demonio 2 ÍNDICE 1. Introducción ..........................................................................................................................................4 2. Pasos para la Instalación del Demonio ..................................................................................................4 3. Instalación del Demonio. .......................................................................................................................4 4. Configuración del Demonio. ............................................................................................................... 11 Manual de instalación del Demonio 3 1. Introducción El objetivo de este documento es detallar todos los pasos necesarios para la instalación y configuración del demonio de Regtel. Un demonio es un programa configurable por el usuario que se encarga de realizar una tarea determinada, de forma periódica y automática sin que el usuario tenga que estar pendiente de realizarla. El Demonio de Regtel lee documentos en pdf, que se han dejado en una determinada carpeta, para subirlos a la aplicación web de Regtel y que sean visibles desde ella. 2. Pasos para la Instalación del Demonio Para la instalación del demonio habrá que seguir los siguientes pasos: 1. Descomprimir, en el ordenador donde se va a instalar, el fichero “Daemon_instalador_vx.x.zip”. Este fichero contendrá todos los elementos necesarios para la instalación. 2. Ejecutar el fichero “RegtelDaemon_setup.exe”, seguir las instrucciones. 3. Se propone una carpeta en por defecto para instalación del Demonio. Si se desea instalar en otra carpeta no va a permitir cambiarla. 4. Se propone una carpeta por defecto en la que se van crear los accesos directos en el menú inicio de Windows. Va a permitir cambiarla y seleccionar la deseada. 5. AL final del proceso de instalación se recomienda reiniciar la máquina para completar la instalación. 6. Después del reinicio de la máquina, se ha de instalar en servicio del demonio. Para instalar el servicio ejecutaremos el fichero “Instalar_Servicio_RegtelDaemon.exe”. 7. Si por cualquier circunstancia se instala mal el servicio, se pude desinstalar ejecutando el fichero “Desinstalar_Servicio_RegtelDaemon.exe”, y volver a instalarlo. 3. Instalación del Demonio. Se ha de descomprimir el fichero que contiene el demonio en una carpeta que tengamos localizada. Manual de instalación del Demonio 4 Se ha de ejecutar el fichero “RegtelDaemon_setup.exe”. Aparecerá una ventana como la del siguiente pantallazo. Se ha de pulsar en el botón “Siguiente” para continuar con la instalación. Se ha de volver a pulsar en el botón “Siguiente” para continuar con la instalación. Manual de instalación del Demonio 5 Se nos propone una carpeta en la que se va a instalar el Demonio. Si se desea instalar en otra carpeta no va a permitir cambiarla. Se ha de pulsar el botón “Siguiente” para continuar con la instalación. Manual de instalación del Demonio 6 Se propone una carpeta por defecto en la que se van crear los accesos directos en el menú inicio de Windows. Va a permitir cambiarla y seleccionar la deseada. Se ha de pulsar el botón “Siguiente” para continuar con la instalación. Se muestra un resumen con las carpetas indicadas para la instalación del Demonio. Para continuar con la instalación se ha de pulsar el botón “Instalar”. Manual de instalación del Demonio 7 Se ha de esperar a que el proceso de instalación finalice. Aparecerá una ventana en la que se indica el resultado del proceso de instalación. Para continuar con la instalación se ha de pulsar el botón “Siguiente”. Para completar la instalación se ha de reiniciar la máquina, se ha de pulsar el botón “Finalizar”. Manual de instalación del Demonio 8 Después del reinicio de la máquina, se ha de instalar en servicio del demonio. Para instalar el servicio ejecutaremos el fichero “Instalar_Servicio_RegtelDaemon.exe”. Aparece la siguiente pantalla y para finalizar la instalación se ha de pulsar una tecla. Si por cualquier circunstancia se instala mal el servicio, se pude desinstalar ejecutando el fichero “Desinstalar_Servicio_RegtelDaemon.exe”, y volver a instalarlo. Manual de instalación del Demonio 9 Tanto en la instalación con desinstalación del servicio del demonio, puede que aparezca una ventana como la que se ve en la siguiente imagen. Para finalizar, se ha de pulsar la opción “Este programa se instaló correctamente”. Para comprobar que se ha instalado correctamente, se ha de mirar si aparece el icono de Regtel la parte inferior derecha. , en Si se pone el ratón sobre el icono y se pulsa el botón derecho, aparece un menú con las siguientes opciones: Manual de instalación del Demonio 10 Iniciar: Si se pulsa empieza la ejecución ininterrumpida del demonio Parar: Si se pulsa se detiene la ejecución del demonio dejándolo parado hasta que se vuelva a iniciar Parametrizar: Si se pulsa aparecerá una ventana de configuración del demonio. Ver el apartado de configuración Reiniciar: Si se pulsa provoca el reinicio del demonio, es decir un parar e iniciar Salir: Si se pulsa se para el demonio. Si estuviera iniciado y se cierra el demonio, es decir desaparecería el icono de la barra de tareas. 4. Configuración del Demonio. En este apartado se van a detallar las formas de configurar el demonio: 1. Pulsando el botón derecho del ratón sobre el icono del demonio y seleccionando la opción “Parametrizar” del menú, se abre un formulario de configuración cono el que se ve en la siguiente imagen. 2. También se puede acceder a la configuración del demonio navegando por las carpetas del ordenador, en la ruta donde se ha instalado la aplicación existirá un fichero llamado “regtelDaemoIni.properties”. Manual de instalación del Demonio 11 Si se abre con un editor se podrá acceder a la configuración. Esta opción muestra más parámetros para configurar que la primera opción. Los parámetros a configurar aquí serían: Manual de instalación del Demonio 12 4.1. Descripción de parámetros de configuración. A continuación se describen los parámetros de la configuración de demonio de Regtel: DirectorioScaner (Directorio Scaner): Mediante este valor se indica al demonio donde tiene que ir a buscar los documentos pdf, es decir el usuario colocará en este directorio los documentos pdf que desee que el demonio localice y suba a la web. Opciones: Se puede indicar una ruta local, es decir una unidad propia del ordenador donde está instalado el demonio. Estas se distinguen porque son las unidades típicas que crea el Windows: C, D, E. Por ejemplo: C:\prueba. Se puede indicar una carpeta de red: \\miservidor\carpeta1\proyectos\ No olvidar escribir el usuario y la contraseña en los parámetros: UsuDirectorioScaner y PassDirectorioScaner correspondientemente. No es posible conectar a una unidad de red: Z:\carpeta1\proyectos\ No es posible conectarse a un servidor Linux. UsuDirectorioScaner (Usuario Directorio Scaner): solo es necesario para el caso de mapear una carpeta de red (por ejemplo \\miservidor\carpeta1\proyectos\). Se escribirá un usuario que tenga permisos en esa dirección. PassDirectorioScaner (Contraseña Scaner): Solo es necesario introducirla si se está mapeando una carpeta de red. Este valor corresponde con la contraseña del usuario introducido en el parámetro anterior. RutaCarpetaTemp (Ruta Carpeta Ficheros Temp): Este parámetro lo utilizará el demonio para subir los archivos pdf. El demonio necesita una carpeta temporal donde realizar toda la operación. No es posible dejarlo sin rellenar porque el demonio desconocerá que carpeta temporal puede utilizar para sus operaciones. Periodicidad: Este valor indica el número de segundo que transcurre entre ejecución y ejecución, es decir, el demonio se ejecuta una vez, realiza sus operaciones y se para el tiempo que en ese parámetro se le indica. Por ejemplo si se le indica 60, el demonio estará parado 1 minuto. TamanoMaximoFichero (Tamaño Máximo Fichero): En este parámetro se indica el tamaño máximo en kilobytes que pueden tener los archivos pdf. MailAviso (Mail Aviso): En este parámetro opcional se puede escribir una dirección de correo electrónico a la cual se enviarán avisos correspondientes al demonio, por ejemplo la subida de algún documento. Manual de instalación del Demonio 13 ServidorUpload: En este parámetro solo visible desde el fichero regtelDaemoIni.properties, se indica la dirección del servlet que trata los documentos pdfs, por ejemplo: https\://redabogacia.org/regtel/regtelssl/uploadApp.srvl. Colegio: Este parámetro corresponde con el código de la oficina a la que corresponde el usuario. El dato es necesario porque si no se denegará la subida. Usuario: En este parámetro solo visible desde el fichero regtelDaemoIni.properties, se pone el código del usuario daemon perteneciente al colegio del usuario. Si se desconoce, deberá ponerse en contacto con el CGAE para que le proporcione este valor. Firma: Mediante un Si o un No se indica si los documentos va firmados o no. Manual de instalación del Demonio 14