Propiedades de Runbook

  • Artículo

Importante

Esta versión de Orchestrator ha llegado al final del soporte técnico. Se recomienda actualizar a Orchestrator 2022.

En líneas generales, un Runbook es una serie de actividades que utilizan datos, realizan tareas y publican datos para que los utilicen otras actividades del Runbook. Cada Runbook tiene una colección de propiedades configurables. Dichas propiedades permiten personalizar el comportamiento de un Runbook.

Visualización de las propiedades de un runbook

Siga estos pasos para ver las propiedades de un runbook:

  1. En el Designer Runbook, en el panel Connections, seleccione la carpeta Runbooks.

  2. Si el Runbook se almacena en una carpeta, seleccione la carpeta correspondiente en Runbooks.

  3. En el área de trabajo Runbook Designer , haga clic con el botón secundario en la pestaña de un Runbook para seleccionar Propiedades.

  4. Para cerrar el cuadro de diálogo Propiedades del runbook , seleccione Finalizar.

Se mostrará un resumen de las propiedades del Runbook e información acerca de cómo configurarlas.

General

En la pestaña General del cuadro de diálogo Propiedades del runbook , puede personalizar un nombre y una descripción para el runbook. También puede asociar una programación al Runbook. Una vez asignada la programación al Runbook, este solo se ejecutará en las fechas y las horas especificadas en la programación.

Crear una programación

  1. En Runbook Designer, en el panel Conexiones , expanda la carpeta Configuración global .

  2. Haga clic con el botón secundario en la carpeta Programaciones para seleccionar la opción Nueva y, a continuación, la opciónProgramación.

  3. En la pestaña General del cuadro de diálogo Nueva programación , en el cuadro Nombre , escriba un nombre para la programación.

  4. En la pestaña Detalles del cuadro de diálogo Nueva programación , seleccione la fecha y hora para iniciar el runbook.

Configurar la programación para días específicos de la semana

  1. En la pestaña Detalles del cuadro de diálogo Nueva programación , haga clic en Días de la semanay, a continuación, seleccione los días en los que desea que se inicie el Runbook.

  2. En Repetición, seleccione la semana del mes en la que desea iniciar el Runbook.

    Por ejemplo, si desea iniciar el Runbook todos los lunes, en Días de la semana, seleccione Lunesy, en Repetición, seleccione Primera, Segunda, Tercera, Cuartay Última.

Configurar la programación para días específicos en el mes

  1. En la pestaña Detalles del cuadro de diálogo Nueva programación , seleccione Días del mes.

  2. En el cuadro Días del mes , escriba la fecha o las fechas en las que desea iniciar el Runbook.

    Separe las fechas por comas.

    Por ejemplo, si desea que el Runbook se inicie los días 1 y 15 de cada mes, escriba 1, 15 en el cuadro Días del mes .

Configuración de la programación para horas específicas

  1. En la pestaña Detalles del cuadro de diálogo Nueva programación , seleccione Horas.

  2. En el cuadro de diálogo Programar horas , seleccione las horas en las que desea iniciar el runbook.

    Puede permitir y denegar el inicio de un Runbook durante un período determinado. Por ejemplo, si desea iniciar un runbook solo fuera del horario comercial, seleccione las horas de 9 a.m. a 5 p.m. para lunes, martes, miércoles, jueves y viernes y seleccione Denegado.

  3. En la pestaña Excepciones del cuadro de diálogo Nueva programación , agregue cualquier excepción de fecha para el runbook y seleccione Aceptar.

  4. Seleccione Finalizar.

Importante

La fecha y la hora programadas para el inicio de un Runbook se basan en el reloj del sistema del servidor de Runbook. Esto permite que las programaciones funcionen en entornos de máquina virtual y sigan ejecutándose incluso cuando el reloj del sistema se ajuste al horario de verano.

Asociación de una programación a un runbook

  1. En el cuadro de diálogo Propiedades del runbook , en la pestaña General , seleccione el botón de puntos suspensivos (...) para buscar una programación.

  2. Seleccione una programación, seleccione Aceptar y, después, Finalizar.

Servidores Runbook

Esta pestaña muestra la lista de servidores de Runbooks asignados para ejecutar este Runbook. Si la lista está vacía, el Runbook utilizará la configuración definida en la carpeta Servidores de Runbooks que se encuentra en el panel Conexiones de Runbook Designer. Si el servidor de Runbook que utiliza el rol Principal está disponible, el Runbook se ejecutará con dicho rol. Si el servidor de runbook principal no está disponible, se comprueba cada servidor de runbook que usa un rol en espera hasta que se encuentre uno que pueda ejecutar el runbook.

Puede invalidar el comportamiento predeterminado y asignar a un Runbook un servidor de Runbook principal, así como tantos servidores de Runbooks como desee. Resulta útil asignar un servidor de runbook específico a un runbook si el runbook requiere acceso a un recurso especializado, como un dispositivo de copia de seguridad.

Asignación de servidores de runbook principal y en espera a un runbook

Siga estos pasos para asignar servidores de runbook principal y en espera a un runbook:

  1. En el cuadro de diálogo Propiedades del runbook , en la pestaña Servidores de Runbook , seleccione Invalidar los roles predeterminados de Runbook Server para configurar los servidores de runbook principal y en espera.

  2. Seleccione Agregar.

  3. Seleccione un servidor de runbook y seleccione Aceptar.

    El primer servidor de Runbook agregado se convertirá en el servidor de Runbook principal.

  4. Para agregar más servidores de runbook, seleccione Agregar y seleccione otro servidor de runbook.

    Los servidores de Runbooks adicionales se agregarán como servidor de Runbook de reserva.

  5. Cuando haya terminado de agregar servidores de runbook, seleccione Finalizar.

Registro

Esta característica controla los datos que se registran en la base de datos de Orchestration. Si se almacena en la base de datos de orquestación, estos datos son visibles en vistas como el panel Registro del runbook Designer y en la consola de Orchestration. Esta información no afecta a la disponibilidad de los datos publicados en un runbook en ejecución.

Los datos publicados incluyen datos específicos de cada actividad.

Los datos publicados comunes son conjuntos de elementos de datos comunes a todas las actividades. Estos elementos son los siguientes:

  • Nombre de actividad

  • Tipo de actividad

  • Identificador de actividad

  • Hora de finalización de actividad (año, mes, día, día de la semana, horas, minutos, segundos)

  • Duración de actividad

  • Actividad anterior

  • Nombre de la actividad anterior

Precaución

Cuando se activa el registro, aumenta el tamaño de la base de datos de Orchestration.

Notificaciones de eventos

Puede habilitar la notificación de eventos para el Runbook. Las notificaciones aparecen en vistas como, por ejemplo, el panel Registro de Runbook Designer y en la consola de Orchestration.

Si desea recibir notificaciones cuando un Runbook se ejecuta durante un periodo superior al especificado, escriba un valor en el cuadro Segundos .

Si quiere recibir una notificación si el runbook no se ejecuta, seleccione la opción Runbook no se puede ejecutar .

Para obtener más información sobre las notificaciones de eventos, consulte Registros de Orchestrator.

Simultaneidad de trabajos

La configuración de simultaneidad del trabajo permite establecer el número máximo de trabajos simultáneos para que pueda realizar varias solicitudes para el mismo runbook al mismo tiempo. Esta configuración se aplica al Runbook individual. Un servidor de Runbook puede ejecutar hasta 50 Runbooks al mismo tiempo. Si selecciona una configuración de simultaneidad de trabajos superior a 50, su entorno requerirá más servidores de Runbooks; de lo contrario, las solicitudes de inicio de Runbooks se pondrán en cola.

Se aplican las siguientes limitaciones:

  • No se pueden ejecutar solicitudes simultáneas para runbooks que comiencen con las actividades de supervisión. Si intenta cambiar el número máximo de solicitudes simultáneas para estos runbooks, runbook Designer restablece el valor máximo de trabajos simultáneos a 1 y muestra un mensaje de error.

  • Un servidor de Runbook puede ejecutar solicitudes simultáneas de Runbooks hasta alcanzar el límite máximo de procesamiento. Para cambiar el límite máximo de procesamiento, vea How to Configure Runbook Throttling.

  • No cree solicitudes simultáneas para runbooks que contengan actividades Modificar contador. Si ejecuta a la vez diferentes copias del mismo Runbook que modifiquen un contador (configurar, restablecer, incrementar o disminuir), es posible que el valor Contador deje de ser confiable. Puede leer el valor de los Contadores en Runbooks que se ejecutan al mismo tiempo.

  • No ejecute solicitudes simultáneas para runbooks que interactúen con un producto que no sea de Microsoft, como una herramienta de vales o de supervisión del sistema, a menos que tenga una buena comprensión de cómo controla la herramienta el procesamiento paralelo. Si la aplicación que no es de Microsoft no puede controlar el procesamiento paralelo o si no lo sabe, deje el número máximo de solicitudes simultáneas en un valor de 1.

  • Planee detenidamente la utilización de solicitudes simultáneas. Antes de cambiar el número máximo de solicitudes de Runbook simultáneas, tenga en cuenta las tareas que realiza el Runbook. Compruebe que cada instancia del Runbook pueda finalizar correctamente. Por ejemplo, si el runbook crea una carpeta, copia los archivos en ella y, a continuación, elimina la carpeta cuando haya terminado, una instancia del runbook podría eliminar la carpeta antes de que finalicen otras instancias. En este caso, debe mantener el número máximo de solicitudes simultáneas para este Runbook con un valor igual a 1 para evitar conflictos.

Datos devueltos

Datos devueltos define los datos que devuelve un Runbook cuando termina. Cada definición de Datos devueltos puede contener uno o varios valores de parámetro. Para rellenar las definiciones de datos, finalice el flujo de trabajo con la actividad Datos devueltos que contenga los valores devueltos.

Puede tener acceso a los valores de datos devueltos a través de los datos publicados de una de las siguientes formas.

  • Invoque el Runbook desde otro Runbook mediante la actividad Invocar Runbook. El runbook primario puede tener acceso a los datos devueltos del runbook secundario como datos publicados desde la actividad Invocar runbook.

  • Visualice los datos publicados desde Runbook Designer o desde la consola de Orchestration.

  • Use el servicio web orchestrator para devolver los datos publicados mediante programación.

Para definir los datos que debe devolver un Runbook, utilice las opciones Agregar, Editary Quitar para crear cada uno de los parámetros.

Pasos siguientes

Vea los registros de Orchestrator para ver las notificaciones de eventos.