Aplicación de archivos de propiedades para configurar servidores mediante el gestor de trabajos

En un entorno de gestión flexible, puede someter el trabajo Configurar propiedades para aplicar archivos de propiedades a los servidores de aplicaciones gestionados por el gestor de trabajos. Tras editar un archivo de propiedades que se haya diseñado para un destino de servidor de aplicaciones gestionado, utilice el gestor de trabajos para distribuir el archivo de propiedades al destino gestionado y aplicar el archivo modificado para actualizar la configuración del servidor de aplicaciones.

Antes de empezar

Los archivos de propiedades proporcionan un modo de consultar y cambiar la configuración del producto. Los archivos listan las propiedades utilizadas con mayor frecuencia en pares de nombre y valor.

Antes de someter un trabajo para aplicar un archivo de propiedades, haga lo siguiente:

  1. Inicie el gestor de trabajos. Si va a aplicar el archivo de propiedades a un destino del gestor de despliegue, inicie éste y su nodo federado. Si va a aplicar el archivo de propiedades a un destino de servidor de aplicaciones autónomo, inicie el agente administrativo. Los destinos deben estar gestionados por el gestor de trabajos.
  2. Utilice el mandato extractConfigProperties del grupo de mandatos PropertiesBasedConfiguration del objeto AdminTask para extraer un archivo de propiedades de un servidor de aplicaciones que esté gestionado por el gestor de trabajos. Debe ejecutar el mandato extractConfigProperties localmente o bien ejecutar un script wsadmin que extrae el archivo de propiedades en un trabajo Ejecutar script wsadmin. El gestor de trabajos no tiene ningún trabajo que extraiga, específicamente, un archivo de propiedades.

    Por ejemplo, supongamos que desea extraer la configuración del servidor de un destino de servidor de aplicaciones que tiene un servidor denominado server1, y un perfil denominado AppSrv02. Ejecute los siguientes mandatos wsadmin desde el directorio bin del perfil AppSrv02:

    wsadmin -lang jython
    
    AdminTask.extractConfigProperties('[-propertiesFileName server.props -configData Server=server1 ]')

    El producto extrae la configuración del servidor en un archivo denominado server.props, en el directorio bin del perfil AppSrv02.

  3. Abra el archivo de propiedades con un editor, cambie el valor de una o más propiedades y guarde el archivo.
    Importante: El archivo de propiedades debe tener la codificación UTF-8. El archivo generado se codifica como UTF-8 automáticamente. Asegúrese de que el archivo permanezca como UTF-8 después de efectuar cualquier edición. Utilice un editor que pueda manejar la codificación UTF-8, o US-ASCII, si el archivo no tiene ningún carácter que se encuentre fuera del juego de caracteres US-ASCII de 7 bits.
  4. Copie el archivo de propiedades en el directorio /config/temp/JobManager del perfil del gestor de trabajos.

    Si el directorio JobManager no existe, créelo en el directorio /config/temp del perfil del gestor de trabajos. Para crear el directorio y acceder al mismo, debe tener los permisos adecuados.

    Si el archivo de propiedades existe en un destino gestionado, puede ejecutar el trabajo propiedades Recopilar archivo para copiar el archivo de propiedades del destino gestionado al directorio perfil_gestor_trabajos/config/temp/JobManager/señal_trabajo/nombre_destino. Consulte el tema sobre el trabajo para recopilar archivo.

  5. Ejecute el trabajo Distribuir archivo para distribuir el archivo de propiedades desde un gestor de trabajos a uno o más destinos de servidor de aplicaciones. Recuerde los valores que especifique para Destino, ya que deberá utilizar dicha ubicación para el trabajo aplique el archivo de propiedades.
    Avoid trouble Avoid trouble: Debe distribuir el archivo de propiedades a los destinos para poder ejecutar el trabajo Configurar propiedades. El trabajo de distribución de archivos copia el archivo de propiedades en el directorio /config/temp/JobManager del perfil del gestor de trabajos a los destinos. El nombre del archivo de propiedades de los destinos se convertirá en el valor que especifique para el destino cuando distribuya el archivo. Consulte el tema dedicado al trabajo de distribución de archivos.gotcha
  6. Si el archivo de propiedades utiliza un archivo de correlación de propiedades, ejecute el trabajo Distribuir archivo para distribuir dicho archivo. Recuerde el valor que especifique para Destino.

Su ID en el gestor de trabajos debe estar autorizado por el rol de administrador o el rol de operador para poder someter trabajos. Cuando someta un trabajo, puede especificar un nombre de usuario y una contraseña para su autenticación y autorización en el destino o destinos. Cuando someta un trabajo a varios destinos, el nombre de usuario y la contraseña o las credenciales para el usuario que someta el trabajo deben poder aplicarse a todos los destinos del trabajo.

Acerca de esta tarea

Puede utilizar la consola de administración del gestor de trabajos o del gestor de despliegue para someter un trabajo que aplica un archivo de propiedades y configura un servidor de aplicaciones. Desde la consola, seleccione el trabajo Configurar propiedades, especifique el archivo de propiedades que desea aplicar, especifique las opciones de trabajo, planifique el trabajo, revise el resumen y someta el trabajo.

El trabajo realiza los cambios siguientes en una configuración de servidor de aplicaciones:
  • Establece el atributo que corresponde a cada propiedad especificada en el archivo de propiedades en el nuevo valor.
  • Si un atributo que corresponde a la propiedad especificada no existe en la configuración, crea un atributo en la configuración.
  • Si un objeto de configuración especificado en el archivo de propiedades no existe en la configuración, crea un objeto de configuración.

Opcionalmente, al aplicar el archivo de propiedades puede especificar que el gestor de trabajo utilice variables establecidas en un archivo de correlación de variables. Especifique la ubicación de un archivo de correlación de variables para incluirlo en el archivo de propiedades.

Los pasos describen cómo utilizar la consola del gestor de trabajos o el gestor de despliegue para someter el trabajo. En lugar de utilizar una consola, puede someter el trabajo ejecutando el mandato configProperties del grupo de mandatos AdministrativeJobs para configurar las propiedades para el destino de servidor de aplicaciones. Consulte el tema sobre tipos de trabajos administrativos.

El trabajo de configuración de propiedades utiliza el mandato applyConfigProperties del grupo de mandatos PropertiesBasedConfiguration para el objeto AdminTask para configurar las propiedades para el destino.

Procedimiento

  1. Pulse Trabajos > Someter en el árbol de navegación de la consola administrativa.
  2. Seleccione un trabajo para aplicar un archivo de propiedades a uno o más destinos de servidor de aplicaciones.
    1. Seleccione el tipo de trabajo Configurar propiedades de la lista.
    2. Si lo desea, describa el trabajo.
    3. Pulse Siguiente.
  3. Para el destino del trabajo, seleccione los destinos de servidor de aplicaciones que desee configurar aplicando un archivo de propiedades.
    1. Seleccione Nombres de destino.
    2. Especifique los nombres de destino a los que haya distribuido previamente el archivo de propiedades y pulse Añadir, o pulse Buscar y especifique los destinos de servidor de aplicaciones como destinos seleccionados en la página Buscar destinos.
    3. Pulse Siguiente.
    4. Si se requiere autenticación de usuario, especifique un nombre de usuario, una contraseña o los valores de autenticación necesarios.
    5. Pulse Siguiente.
  4. Especifique los parámetros para el trabajo de configuración de propiedades.
    1. Especifique la ubicación del archivo de propiedades que desea aplicar.

      La ubicación del archivo de propiedades es el valor de destino que se especifica para el trabajo Distribuir archivo.

    2. Si el archivo de propiedades utiliza un archivo de correlación de variables, especifique la ubicación de dicho archivo.

      Utilice el valor de destino que se especifica para el trabajo Distribuir archivo.

    3. Pulse Siguiente.
  5. Planifique el trabajo.

    Las fechas y horas que especifique son relativas al gestor de trabajos.

    1. También puede especificar una o varias direcciones de correo electrónico a las que enviar las notificaciones cuando el trabajo haya finalizado.

      Si especifica varias direcciones de correo electrónico, sepárelas mediante comas. Las direcciones de correo electrónico se guardan en las preferencias de la consola. Cada dirección de correo electrónico se valida para comprobar su formato.

    2. Seleccione el momento en que el trabajo estará disponible para someterlo.

      Puede enviar el trabajo para que esté disponible ahora, o especificar una hora y una fecha a las que recuperar el trabajo del gestor de trabajos.

    3. Seleccione la caducidad del trabajo.

      La caducidad del trabajo es la fecha y hora en la que el trabajo dejará de estar disponible para su ejecución en los destinos. Puede utilizar la caducidad por omisión, especificar una fecha y hora de caducidad del trabajo o especificar un intervalo de tiempo en el que caducará el trabajo. La caducidad predeterminada se define en la página Configuración del gestor de trabajos.

    4. Opcionalmente especifique un intervalo recurrente para el trabajo, una fecha y hora de inicio para el intervalo y una fecha y hora final para el intervalo.
    5. Pulse Siguiente.
  6. Revise el resumen y pulse Finalizar para someter el trabajo.

Resultados

El gestor de trabajos realiza las operaciones siguientes:

  • Hace que el trabajo Configurar propiedades esté disponible para los destinos.
  • Informa sobre el estado del trabajo en cada destino.

Qué hacer a continuación

En la página Estado del trabajo, pulse el ID del trabajo y consulte el estado del trabajo. Pulse el icono de renovación de estado Especifica el icono de renovación de vista para el estado del trabajo para renovar el estado mostrado.

Si el trabajo no ha sido satisfactorio, consulte los mensajes de error que se han generado al ejecutar el trabajo, corrija la condición de error y someta el trabajo de nuevo.

Si el estado del trabajo es Satisfactorio, compruebe el destino para asegurarse de que se haya aplicado el archivo de propiedades.


Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tagt_jobmgr_server_propfile
File name: tagt_jobmgr_server_propfile.html