Manual breve de CSDS La herramienta CSDS tiene como objetivo realizar la descarga de archivos y ejecución de comandos a maquinas remotas (ATMs en el caso de Bancomer) que contiene el agente, con el objeto de realizar actualización de software. Adicionalmente se pueden ejecutar comandos especiales para obtener información de sistema, de versiones u cualquier cambio que se necesite hacer en un ATM para corregir alguna anomalía y que no necesariamente conlleva realizar la actualización de un software (aplicativo Jam). Hay dos maneras de realizar las actividades anteriores: CSDS COMMAND JOB Envío de un comando (un comando a un cajero) Envío de un Job (uno o varios comandos a uno a mas cajeros) Para realizar el envío de un Job se necesita tener creados: 1. Paquete de CSDS 2. Lista de distribución en CSDS Un Job se conforma de: CSDS JOB Lista de distribución (1 a N cajeros) Configuración de Reintento automático (Opcional) Programación (Hora y Fecha de ejecución Lista de pasos (comandos individuales) CREACIÓN DE PAQUETE Maintenance à Package Maintenance 1. Click en botón Add 2. Llenar las secciones del paquete: a. Package Description: Escribir nombre de paquete (apegarse a nombres previamente escritos para el tipo de paquete). b. Create Package From i. Directory: Para paquetes que contienen más de un archivo ii. Single file. Para paquetes que contienen un solo archivo c. File Path: Seleccionar desde el botón de browser la ruta en el servidor de csds donde se encuentra ubicado el paquete (ruta donde sube los paquetes Areli/Antonio). 3. Click en Save CREACION DE LISTA DE DISTRIBUCION Maintenance à Distribution List 1. Clic en botón Add 2. Escribir nombre de lista de distribución en el recuadro “Distribution List Name” 3. Click en botón “Add machine to list” 4. Buscar atms a. Utilizar filtro necesario (Machine Key, Failed Jobs, Attributes) b. Seleccionar todos o los cajeros necesarios de la lista superior y pasarlos a la lista inferior. c. Click en botón Ok 5. Click en Save NOTA: Al final de la creación se debe hacer un match con la lista de Excel desde donde se creó para verificar que los cajeros son correctos. CREACION DE JOB Para crear un Job desde cero para un envío de actualización de versión. Administration à Job Console 1. Clic en botón Add 2. Llenar la sección Job Details a. Description: Escribir nombre del Job (apegarse a nombres previamente escritos para el tipo de Job, apoyarse en filtro si es necesario) b. Distribution List: Seleccionar la lista existente del combo. c. E-mail Group: seleccionar Default: default d. Configure Retry Mode: para configurar esta sección ver las indicaciones más adelante en este documento (Opcional). e. Schedule: Seleccionar el tipo de programación (Select Date, Run Now, Decide later) según sea el caso. 3. Llenar la sección “Step Details” con los pasos necesarios para mandar el job (las instrucciones se las mandarán por correo): a. Agregar pasos: i. Max Step Required Time to Finish(in minutes): Escribir el doble de minutos que se tiene calculados para la ejecución de un paso (en algunos casos es mejor poner el triple, sobre todo para DOWNLOADS). ii. CSDS Command: Seleccionar el comando según la acción que se necesite: ü DOWNLOAD: Descargar en el atm un paquete creado dentro del CSDS a. File: Seleccionar el paquete de CSDS i. Clic en botón de browser (…) ii. Ir a pestaña “Existing packages” y seleccionar paquete iii. Click en OK b. Action: Seleccionar “7z” Los demás parámetros se quedan igual y se da clic en OK ü EXECUTE: Ejecutar en el atm un comando a. Action: Seleccionar “Run” b. File: Escribir la ruta del atm que contiene el archivo que se va a ejecutar: /ID_Paquete/files/archivo.bat ID_Paquete: el id del paquete que se seleccionó en el paso DOWNLOAD. Archivo.bat cambiar por el nombre que se da en las instrucciones del envio. 4. Clic en Save Para crear un Job desde otro Job Administration à Job Console 1. Seleccionar Job que se quiera copiar y clic derecho 2. Seleccionar opción “Copy Job” 3. Modificar Description con nombre deseado 4. Cambiar Lista de Distribución si así se desea 5. Modificar alguno de los pasos (opcional) 6. Seleccionar Programación deseada 7. Click en Save Modo de Reintento automático Cuando se va a dejar programado un job se puede configurar lo opción de Reintento automático para que se ejecute varias veces automáticamente. Esto permite dar un porcentaje mayor de éxito al Job. 1. Clic en botón “Configure Retry Mode” 2. Habilitar el botón “Retry Enabled” 3. Seleccionar los valores deseados según la experiencia del tipo de Job y tamaño: a. Retry Attemp Mode: i. Retry forever until job is succesfully finished: Seleccionar esta opción si se desea que el job se ejecute tantas veces sea necesario hasta que termine en exitoso. ii. Retry for especific number of times: Seleccionar esta opción si se quiere reinicar el job sólo un numero especifico de veces. b. Retry interval in minutes: Seleccionar el número de minutos que se debe esperar para que un atm finalizado en error se vuelva a ejecutar. c. Select error list: Seleccionar el los errores los estatus de error para los cuales se desea se reinicie, pueden ser todos. d. Clic en Select e. Clic en Configure Nomenclaturas () Obligatorio [] Opcional Abreviación de aplicativos: Listas de distribución Tipo de envío Nomenclatura Uso Ejemplos Para cualquier caso a un cajero PRO_(numero) DES_(numero) Para un cajero de producción Para un cajero de desarrollo PRO_5499 DES_6127 Actualización de versión v(versión)_(etapa)_[Grupo] v2.1.0_Fase1 ó v2.1.0_Nac_G1 Nivelación de version Niv_(version)_[Grupo] Actualización de versión por corrección de incidencias Obtención de versión v(versión)_[etapa]_[marca] Para una lista de cajeros que van a ser actualizados a la última versión del aplicativo de Jam Para nivelar una lista de cajeros a una versión específica Para actualización de versión que corrige incidencias específicas de un grupo de cajeros. Para obtener la version del aplicativo Jam de una lista de cajeros Para actualización de publicidad Publi_G1 Actualización de publicidad Utilizar la de actualización de versión o la de nivelación de versión. Si es nueva: ov_(descripcion)_[Grupo] Publi_(grupo) Niv_2.0.9_G1 v.2.1.1.P_NCR Ov_faltantes_v2.0.9 Para toda la red de atms RedAtms_(Grupo) Para realizar un envío que incluya a toda la red de atms sin exepción RedAtms_G1 Para otras aplicaciones (Aplicativo)_(Descripcion) Para envíos a otras aplicaciones que no tiene que ver con el Jam JAM_ActualizaAgente CHECKER_ActivaAgente Jobs Tipo de envío Nomenclatura Actualización de versión APP_v(versión)_(etapa)_[Grupo] Nivelación de version APP_niv_(version)_[Grupo] Actualización de versión por corrección de incidencias APP_v(versión)_[etapa]_[marca] Obtención de versión Actualización de publicidad Para otras aplicaciones Uso Ejemplos Para una lista de cajeros que van a ser actualizados a la última versión del aplicativo de Jam Para nivelar una lista de cajeros a una versión específica Para actualización de versión que corrige incidencias específicas de un grupo de cajeros. APP_v2.1.0_Fase1 ó APP_v2.1.0_Nac_G1 Utilizar la de actualización de versión o la de nivelación de versión. Si es nueva: APP_ov_(descripcion)_[Grupo] APP_Publi_(fecha)_(grupo) Para obtener la version del aplicativo Jam de una lista de cajeros APP_ov_faltantes_v2.0.9 Para actualización de publicidad APP_Publi_G1 (Aplicación)_(Descripcion) Para envíos a otras aplicaciones que no tienen que ver con el Jam CSDS_UpgradeAgent CHECKER_ActivaAgente APP_niv_2.0.9_G1 APP_v.2.1.1.P_NCR Paquetes Tipo de envío Nomenclatura Uso Ejemplos Actualización de versión APP_v(versión) Para una lista de cajeros que van a ser actualizados a la última versión del aplicativo de Jam APP_v2.1.0 APP_V.2.1.1.EM Nivelación de version APP_niv_(version)_[Grupo] Para nivelar una lista de cajeros a una versión específica PRO_niv_2.0.9_G1 Actualización de versión por corrección de incidencias APP_v(versión)_[etapa]_[marca] Para actualización de versión que corrige incidencias específicas de un grupo de cajeros. PRO_v.2.1.1.P_NCR Obtención de versión Utilizar la de actualización de versión o la de nivelación de versión. Si es nueva: APP_ov_(descripcion)_[Grupo] APP_Publi_(fecha)_(grupo) Para obtener la version del aplicativo Jam de una lista de cajeros PRO_ov_faltantes_v2.0.9 Para actualización de publicidad PRO_Publi_G1 (Aplicación)_(Descripcion) Para envíos a otras aplicaciones que no tienen que ver con el Jam CSDS_Agente_4.3.0.18 JAMNM_Cacert_Feb2012 Actualización de publicidad Para otras aplicaciones Tabla de No. Atms – No. De Jobs No. De Pasos del Job 1 2-6 7-10 11-16 17-20 21-30 30 o más No. De Atms x Lista 500 300 150 100 75 25-50 1-19 Tiempo aprox. (hrs). 3.5 2.5 2.5 3 2-5 2.5 a 3 3 Coral Ferreira R. - [email protected]
