Otros comandos de utilidad

<< Clic para mostrar Tabla de Contenidos >>

Navegación:  Automation Server > Deployment > Deployment Avanzado > Cómo aplicar un paquete de deployment > Aplicar el paquete usando línea de comandos >

Otros comandos de utilidad

Introducción

El Deployment por Línea de Comandos tiene funciones adicionales que se pueden utilizar para automatizar algunas operaciones manuales. En este artículo se detallarán las siguientes:

 

1.Configuración de Variables de Ambiente.

2.Cifrado de contraseñas.

3.Forzar replicación de entidades.

4.Detener los componentes

5.Detener el Scheduler

6.Iniciar el Scheduler

7.Estado del Scheduler

8.Backup del Scheduler

9.Detener el Operation Service

10.Iniciar el Operation Service

11.Backup de la base de datos

12.Detener el IIS

13.Iniciar el IIS

14.Iniciar la limpieza

15.Detener el application pool

16.Iniciar el application pool

17.Backup de la Web application

18.Descomprimir parche

19.Exportar plantillas de Configuración.

 

1. Configuración de Variables de Ambiente

Bizagi tiene variables predefinidas que se pueden configurar dependiendo de las necesidades del usuario. Esta funcionalidad ayuda a actualizar la configuración general del proyecto, lo cual se reflejará en comportamientos de la ejecución. Por ejemplo, si desea cambiar el tiempo que toma Bizagi para limpiar la caché, puede modificar el valor de la Variable de Ambiente correspondiente para lograrlo.

 

La forma de especificar las variables y sus valores respectivos es a través de la ejecución del archivo BizagiAutomation.exe en una línea de comandos como se muestra:

 

BizagiAutomation.exe --runtype UpdateEnvironment --DSNDB "..." --Provider "..." –EnvironmentName "..." --BizagiValues "..." --CustomValues "..." --Config "..." --Log "..." --ErrorLogger "..."

 

Notas de los parámetros y descripciones:

runtype: se usa para especificar el tipo de ejecución del programa. En este caso el valor de este parámetro es UpdateEnvironment pues se van a actualizar los valores de las variables de ambiente.

DSNB: String de conexión a la base de datos del proyecto. Este parámetro es obligatorio.

   Al usar SQL Server:

"Persist Security Info=True;User ID=[SQL_Login];Password=[Login_password];Data Source=[DB_Server]\[Named_instance];Initial Catalog=[Database];"

o[SQL_Login]: La cuenta usada para conectarse a la instancia de base de datos de SQL Server.

o[Login_password]: La contraseña correspondiente al Log in anterior.

o[DB_Server]: Nombre o dirección IP del servidor de base de datos. Use \[Nombre de la instancia] cuando aplique, si su instancia de la base de datos no es la que no está nombrada por defecto.

o[Database]: El nombre de la base de datos del proyecto.

 

   Al usar Oracle:

"Data Source=[DB_Server]:[Port_number]/[Service];User ID=[User_schema];Password=[User_schema_password];Unicode=True;"

o[DB_Server]: Nombre o dirección IP del servidor de bases de datos.

o[Port_number]: El puerto TCP utilizado para la conexión al servicio de la base de datos.

o[Service]: La identificación del servicio para una instancia de Oracle.

o[User_schema]: El nombre de la base de datos del proyecto.

o[User_schema_password]: La contraseña correspondiente para el User Schema. Es altamente recomendable cifrar la contraseña usando la funcionalidad de Cifrado de contraseñas.

Provider: Cliente de bases de datos. Este parámetro es obligatorio.

oPara bases de datos Oracle use la siguiente cadena: Oracle

oPara bases de datos SQL Server use la siguiente cadena: MSSqlClient

EnvironmentName: Nombre del ambiente a configurar. Puede ser Desarrollo, Pruebas o Producción. Este parámetro es obligatorio.

BizagiValues: Propiedades predefinidas que se van a actualizar, se ponen en sintaxis de JSON. Este parámetro es opcional.

CustomValues: Propiedades definidas por el usuario a actualizar, se ponen en sintaxis de JSON. Este parámetro es opcional.

Log: Archivo donde las trazas de la ejecución se van a añadir. Este parámetro es opcional.

ErrorLogger: Archivo donde las trazas de error se van a añadir. Este parámetro es opcional.

Config: Archivo con los parámetros para la ejecución en sintaxis JSON. Si usted usa el archivo config, todos los parámetros anteriores van incluidos dentro del JSON, vea Usando el archivo config.

 

Ejemplo del Comando

Asuma que tiene un parámetro personalizado en su ambiente de producción, como semuestra a continuación:

 

CLD_08

 

Tiene que registrar el siguiente comando:

 

BizagiAutomation.exe --runtype UpdateEnvironment --DSNDB "Persist Security Info=True;User ID=sa;Password=****;Data Source=localhost\SQLEXPRESS2017;Initial Catalog=Prod_MyProject;" –-EnvironmentName "Production" --CustomValues "{\"MyName\": \"New Value\"}" --Provider "MSSqlClient" --Log "C:\temp\log.txt" --ErrorLogger "C:\temp\Errorlog.txt"

 

Tenga en cuenta que el parámetro Custom Values, es un JSON con las comillas dobles escapadas con \" adentro.

 

--CustomValues "{\"MyName\": \"New Value\"}"

 

Esto actualiza el valor del parámetro personalizado. Los valores por defecto, o el nombre no pueden ser actualizados usando la consola de comandos.

 

CLD_09

 

Si usted tiene múltiples parámetros, sepárelos con una coma:

 

 

--CustomValues "{\"Parameter name 1\": \"New Value 1\" , \"Parameter name 2\": \"New Value 2\"}"

 

Si suted quiere actualizar el parámetro personalizado en el ambiente de desarrollo, pero en todas las pestañas:

 

CLD_10

 

Debe cambiar el parámetro EnvironmentName del comando:

 

–-EnvironmentName "Development" para la pestaña de Desarrollo (Development).

–-EnvironmentName "Test" para la pestaña de Pruebas (Test)

–-EnvironmentName "Production" para la pestaña de Producción (Production)

 

Usando el archivo Config

Este parámetro es una opción que se le presenta al usuario, para enviar los parámetros al programa que facilita el proceso. En caso de que desee establecer los parámetros de ejecución usando un archivo, debe construir un archivo config con el siguiente formato:

 

{

   "DSNDB":"[Cadena DSNB como se describió anteriormente]",

   "Provider":"[MSSqlClient o Oracle]",

   "environmentName": "[Development o Test o Production]",

   "bizagiValues":{

     "sendEmailCopyTo": "alex@company.com",

     "enableEmail": false,

     "interfaceThresholdTime":2500

   },

   "customValues": {

     "AdmonEmail": "user@company.com",

     "defaultHolidays": "200"

   }

}

 

Cuando se pasan los parámetros por archivo, el usuario debe escribirlo de antemano y ejecutar el comando BizagiAutomation.exe solamente con el parámetro --Config. Al lado del parámetro, debe proveer la ruta en su ordenador al archivo de configuración. Por ejemplo:

 

BizagiAutomation.exe --runtype UpdateEnvironment --Config "Ruta al archivo"

 

Note que los parámetros obligatorios (los que no están encerrados en corchetes) deben ser especificados al menos una vez, ya sea en la línea de comandos o en el archivo config. En caso de que se especifique en ambos, Bizagi solo considerará los valores incluidos en la línea de comandos.

 

Con respecto a los valores de Bizagi y del usuario, tenga en cuenta que:

Debe haber al menos un valor para los de Bizagi y uno para los del usuario, para que el programa ejecute.

Todos los valores del usuario que sean especificados deben corresponderse con uno existente con exactamente el mismo nombre.

Se pueden establecer valores para tantas variables como desee, en formato JSON.

Todos los valores de Bizagi disponibles son:

 

AttribMaxLengthThreshold

EmailIntegrationPassword

QueryEngineDSNDB

UploadMaxFileSize

BizagiSchedulerInterval

EmailIntegrationPort

QueryEngineProviderType

UploadPath

CacheAvailableMemoryPercentageLimit

EmailIntegrationUsername

RepDsndb

WebDavFolder

CacheExpirationCheckInterval

EmailRecipient

RepProviderType

WebDavUrl

CryptographyEncryptionAlgorithm

EnableEmail

SendEmailBccTo

WebServicesTimeOut

CryptographyHashAlgorithm

EnableEntityLog

SendEmailCopyTo

WsLegacyEnabled

CryptographyKeyUrl

EnableMMFactLog

SkipRecipients

WsSecurityEnabled

DataStoreEnabled

EnablePushNotifications

SmtpAccount

WsSecurityPassword

DisableAbortNotifications

EnableTrace

SmtpEnableSsl

WsSecurityUserName

EmailIntegrationAccount

EntityTableCacheTimeout

SmtpPassword

WsSecurityX509CertFindType

EmailIntegrationConnectionType

EntityTesting

SmtpSenderAcc

WsSecurityX509CertFindValue

EmailIntegrationEnabled

InterfaceThresholdTime

SmtpServer

WsSecurityX509CertStoreLocation

EmailIntegrationEnableSsl

Logging

SmtpType

WsSecurityX509CertStoreName

EmailIntegrationHost

ParamEntityInstancesThreshold

SoaBusinessKeyEnforcement

WsSecurityX509CertValidationMode

 

2. Cifrado de contraseñas

El cifrado de contraseñas permite añadir una capa adicional de seguridad a las contraseñas o información relevante de su proyecto. Esta funcionalidad utiliza una función SHA-2 de hashing para cifrar cualquier cadena de caracteres. Esta funcionalidad también está disponible en el Portal de Trabajo y puede ser usada en cualquier ambiente. Para más información acerca de esta funcionalidad desde el Portal de Trabajo, refiérase a este artículo.

 

Tal como funciona en el Portal de trabajo, Bizagi permite generar contraseñas cifradas a través de línea de comandos. Para usar esta funcionalidad solo necesita correr el comando BizagiAutomation.exe con el parámetro GeneratePassword como sigue.

 

BizagiAutomation.exe --runtype GeneratePassword --Password "..." --EncryptType "..." --Log "..." --ErrorLogger "..." --Config "..."

 

 

Notas de los parámetros y decripción:

runtype: Se usa para especificar el tipo de ejecución de BizagiAutomation. En este caso se usa el valor GeneratePassword pues la necesidad es cifrar una contraseña.

Password: Se usa para especificar el texto que el usuario va a encriptar. Debe ser pasado como el valor de este parámetro.

EncryptType: Se usa para indicar el tipo de cifrado- Los valores posibles son P para contraseñas de de archivos del proyecto, y C para contraseñas de archivos de configuración.

Log: Su valor indica el archivo en el que las trazas de ejecución se van a añadir. Este parámetro es opcional.

ErrorLogger: Su valor indica el archivo en el que se añaden las trazas de errores. Este parámetro es opcional.

Config: Archivo con los parámetros de ejecución en JSON. Este parámetro es obligatorio cuando no se envíen uno o más parámetros obligatorios.

 

note_pin

El resultado de la ejecución entregará el valor cifrada que va a ser retornado en la línea de comandos.

Puede copiar y pegar este valor donde lo requiera.

 

3. Forzar replicación de entidades

Bizagi puede integrarse con fuentes de datos externas para obtener información de otros sistemas que la organización ya tenga funcionando. Uno de esos mecanismos es la replicación de data, la cual consiste en copias locales de fuentes de datos externas que se actualizan periódicamente para tener la información actual del otro sistema, disponible para una aplicación de Bizagi. Para mas información de replicación de data, refiérase a este artículo.

 

Cuando un proceso de deployment haya sido completado, la base de datos empezará vacía. Esto significa que no habrá información de ninguna entidad, incluyendo las tablas replicadas. Para evitar esperar a que el proceso de replicación de entidades se ejecute para llenar la información necesaria, Bizagi provee una forma de forzar la replicación por medio de línea de comandos.

 

Para hacerlo, usted puede ejecutar el comando BizagiAutomation con la opción ForceReplication especificada como runtype. El comando se debe ejecutar como sigue.

 

BizagiAutomation.exe --runtype ForceReplication --DSNDB "..." --Provider "..." --Config --Log --ErrorLogger

 

Notas de los parámetros y descripciones:

runtype: se usa para especificar el tipo de ejecución del programa. En este caso el valor de este parámetro es UpdateEnvironment pues se van a actualizar los valore de las variables de ambiente.

DSNB: Especificación de la conexión a la base de datos donde las variables van a ser actualizadas. La cadena de texto debe tener la siguiente convención:

oPersist Security Info=True;User ID=[SQL_Login];Password=[Login_password];Data Source=[DB_Server]\[Named_instance];Initial Catalog=[Database]

--Provider: Cliente de bases de datos. Este parámetro es obligatorio.

oPara bases de datos Oracle use la siguiente cadena: Oracle

oPara bases de datos SQL Server use la siguiente cadena: MSSqlClient

Log: Archivo donde las trazas de la ejecución se van a añadir. Este parámetro es opcional.

ErrorLogger: Archivo donde las trazas de error se van a añadir. Este parámetro es opcional.

Config: Archivo con los parámetros para la ejecución en sintaxis JSON. Este parámetro es obligatorio cuando no se envíen uno o más parámetros obligatorios.

 

4. Detener los componentes

Bizagi utiliza dos componentes principales para ejecutar los procesos y sus elementos, estos componentes son el Scheduler y el Web Application. Después del procedimiento de deployment, es posible que deba reiniciar estos componentes para que reflejen los cambios realizados en el procedimiento de deployment.

 

Para detener los componentes, usted puede ejecutar el comando BizagiAutomation con la opción StopComponents especificada como runtype. El comando se debe ejecutar como sigue.

 

BizagiAutomation.exe --runtype StopComponents --Project "..." --Log "..." --ErrorLogger "..."

 

Notas de los parámetros y descripciones:

runtype: Se usa para especificar el tipo de ejecución de BizagiAutomation. En este caso, StopComponents es utilizado como valor del parámetro ya que la necesidad es detener el Scheduler y el Web application.

Project: Se usa para indicar el proyecto en el cual se quiere detener sus componentes.

Log: Archivo donde las trazas de la ejecución se van a añadir. Este parámetro es opcional.

ErrorLogger: Archivo donde las trazas de error se van a añadir. Este parámetro es opcional.

 

5. Detener el Scheduler

El Scheduler de Bizagi es un servicio creado en cada proyecto de Bizagi, para llevar a cabo tareas tales como: enviar alarmas, disparar temporizadores (activar retrasos temporizados), ejecutar la replicación y ejecutar trabajos personalizados y actividades asíncronas. Después del procedimiento de deployment, es posible que deba reiniciar el scheduler para reflejar los cambios realizados en el procedimiento de deployment.

 

Para detener el Scheduler, usted puede ejecutar el comando BizagiAutomation con la opción StopScheduler especificada como runtype. El comando se debe ejecutar como sigue.

 

BizagiAutomation.exe --runtype StopScheduler --Project "..." --ServiceName "..." --ComputerName "..." --UserName "..." --Password "..." --Log "..." --ErrorLogger "..."

 

Notas de los parámetros y descripciones:

runtype: Se usa para especificar el tipo de ejecución de BizagiAutomation. En este caso, StopScheduler es utilizado como valor del parámetro ya que la necesidad es detener el Scheduler de un proyecto local o remoto.

Project: se utiliza para indicar el proyecto local o remoto en el que desea detener su servicio de Scheduler. Este parámetro es opcional, si no está este parámetro, el parámetro ServiceName es obligatorio.

ServiceName: se usa para indicar el servicio de Scheduler local o remoto que desea detener. Este parámetro es opcional, si no está este parámetro, el parámetro Project es obligatorio.

ComputerName: se usa para indicar el nombre de la máquina donde desea detener el servicio de Scheduler. Este parámetro es opcional, si no está este parámetro, se detiene el scheduler local.

UserName: se usa para indicar el nombre de usuario de la máquina remota donde desea detener el servicio de Scheduler. Este parámetro es obligatorio si el parámetro ComputerName está presente.

Password: se usa para indicar la contraseña de la máquina remota donde desea detener el servicio de Scheduler. Este parámetro es obligatorio si los parámetros ComputerName y UserName están presentes.

Log: Archivo donde las trazas de la ejecución se van a añadir. Este parámetro es opcional.

ErrorLogger: Archivo donde las trazas de error se van a añadir. Este parámetro es opcional.

 

6. Iniciar el Scheduler

El Scheduler de Bizagi es un servicio creado en cada proyecto de Bizagi, para llevar a cabo tareas tales como: enviar alarmas, disparar temporizadores (activar retrasos temporizados), ejecutar la replicación y ejecutar trabajos personalizados y actividades asíncronas. Después del procedimiento de deployment, es posible que deba reiniciar el scheduler para reflejar los cambios realizados en el procedimiento de deployment.

 

Para iniciar el Scheduler, usted puede ejecutar el comando BizagiAutomation con la opción StartScheduler especificada como runtype. El comando se debe ejecutar como sigue.

 

BizagiAutomation.exe --runtype StartScheduler --Project "..." --ServiceName "..." --ComputerName "..." --UserName "..." --Password "..." --Log "..." --ErrorLogger "..."

 

Notas de los parámetros y descripciones:

runtype: Se usa para especificar el tipo de ejecución de BizagiAutomation. En este caso, StartScheduler es utilizado como valor del parámetro ya que la necesidad es iniciar el Scheduler de un proyecto local o remoto.

Project: se utiliza para indicar el proyecto local o remoto en el que desea detener su servicio de Scheduler. Este parámetro es opcional, si no está este parámetro, el parámetro ServiceName es obligatorio.

ServiceName: se usa para indicar el servicio de Scheduler local o remoto que desea iniciar. Este parámetro es opcional, si no está este parámetro, el parámetro Project es obligatorio.

ComputerName: se usa para indicar el nombre de la máquina donde desea iniciar el servicio de Scheduler. Este parámetro es opcional, si no está este parámetro, se inicial el scheduler local.

UserName: se usa para indicar el nombre de usuario de la máquina remota donde desea iniciar el servicio de Scheduler. Este parámetro es obligatorio si el parámetro ComputerName está presente.

Password: se usa para indicar la contraseña de la máquina remota donde desea iniciar el servicio de Scheduler. Este parámetro es obligatorio si los parámetros ComputerName y UserName están presentes.

Log: Archivo donde las trazas de la ejecución se van a añadir. Este parámetro es opcional.

ErrorLogger: Archivo donde las trazas de error se van a añadir. Este parámetro es opcional.

 

7. Estado del Scheduler

El Scheduler de Bizagi es un servicio creado en cada proyecto de Bizagi, para llevar a cabo tareas tales como: enviar alarmas, disparar temporizadores (activar retrasos temporizados), ejecutar la replicación y ejecutar trabajos personalizados y actividades asíncronas. Antes o después del procedimiento de deployment, es posible que deba saber el estado del servicio de scheduler.

 

Para saber el estado del Scheduler, usted puede ejecutar el comando BizagiAutomation con la opción SchedulerStatus especificada como runtype. El comando se debe ejecutar como sigue.

 

BizagiAutomation.exe --runtype SchedulerStatus --Project "..." --ServiceName "..." --ComputerName "..." --UserName "..." --Password "..." --Log "..." --ErrorLogger "..."

 

Notas de los parámetros y descripciones:

runtype: Se usa para especificar el tipo de ejecución de BizagiAutomation. En este caso, SchedulerStatus es utilizado como valor del parámetro ya que la necesidad es saber el estado del servicio de Scheduler de un proyecto local o remoto.

Project se utiliza para indicar el proyecto local o remoto en el que se desea saber el estado del servicio de Scheduler. Este parámetro es opcional, si no está este parámetro, el parámetro ServiceName es obligatorio.

ServiceName: se utiliza para indicar el servicio de Scheduler local o remoto del que quiere conocer su estado. Este parámetro es opcional, si no está este parámetro, el parámetro Project es obligatorio.

ComputerName: se utiliza para indicar el nombre de la máquina donde quiere conocer el estado del servicio de Scheduler. Este parámetro es opcional, si no está este parámetro, el estado del Scheduler es verificado localmente.

UserName: se utiliza para indicar el nombre de usuario de la máquina donde quiere conocer el estado del servicio de Scheduler. Este parámetro es obligatorio si el parámetro ComputerName está presente.

Password: se utiliza para indicar la contraseña de la máquina donde quiere conocer el estado del servicio de Scheduler. Este parámetro es obligatorio si los parámetros ComputerName y UserName están presentes.

Log: Archivo donde las trazas de la ejecución se van a añadir. Este parámetro es opcional.

ErrorLogger: Archivo donde las trazas de error se van a añadir. Este parámetro es opcional.

 

8. Backup del Scheduler

El Scheduler de Bizagi es un servicio creado en cada proyecto de Bizagi, para llevar a cabo tareas tales como: enviar alarmas, disparar temporizadores (activar retrasos temporizados), ejecutar la replicación y ejecutar trabajos personalizados y actividades asíncronas. Antes del procedimiento de deployment, es posible que deba tomar un backup del servicio de Scheduler en caso de necesitar devolver los cambios realizados en el procedimiento de deployment.

 

Para tomar el backup del servicio de Scheduler, usted puede ejecutar el comando BizagiAutomation con la opción SchedulerBackup especificada como runtype. El comando se debe ejecutar como sigue.

 

BizagiAutomation.exe --runtype SchedulerBackup --Project "..." --ComputerName "..." --UserName "..." --Password "..." --Log "..." --ErrorLogger "..."

 

Notas de los parámetros y descripciones:

runtype: Se usa para especificar el tipo de ejecución de BizagiAutomation. En este caso, SchedulerBackup es utilizado como valor del parámetro ya que la necesidad es tomar un backup del servicio de Scheduler de un proyecto local o remoto.

Project se utiliza para indicar el proyecto local o remoto en el que se desea tomar el backup del servicio de Scheduler. Este parámetro es opcional, si no está este parámetro, el parámetro ServiceName es obligatorio.

ComputerName: se utiliza para indicar el nombre de la máquina donde se quiere tomar el backup del servicio de Scheduler. Este parámetro es opcional, si no está este parámetro, el backup es tomado localmente.

UserName: se utiliza para indicar el nombre de usuario de la máquina donde quiere tomar el backup del servicio de Scheduler. Este parámetro es obligatorio si el parámetro ComputerName está presente.

Password: se utiliza para indicar la contraseña de la máquina donde quiere tomar el backup del servicio de Scheduler. Este parámetro es obligatorio si los parámetros ComputerName y UserName están presentes.

Log: Archivo donde las trazas de la ejecución se van a añadir. Este parámetro es opcional.

ErrorLogger: Archivo donde las trazas de error se van a añadir. Este parámetro es opcional.

 

9. Detener el Operation Service

Bizagi Operation Service maneja la comunicación entre los ambientes durante operaciones como la creación y actualización de proyectos, deployment, licenciamiento, administración de nodos, entre otros. Después del procedimiento de deployment, es posible que deba reiniciarlo para reflejar los cambios realizados en el procedimiento de deployment.

 

Para detener el Operation Service, usted puede ejecutar el comando BizagiAutomation con la opción StopOperationsService especificada como runtype. El comando se debe ejecutar como sigue.

 

BizagiAutomation.exe --runtype StopOperationsService --ComputerName "..." --UserName "..." --Password "..." --Log "..." --ErrorLogger "..."

 

Notas de los parámetros y descripciones:

runtype: Se usa para especificar el tipo de ejecución de BizagiAutomation. En este caso, StopOperationsService es utilizado como valor del parámetro ya que la necesidad es detener el Operation Service de un proyecto local o remoto.

ComputerName: se utiliza para indicar el nombre de la máquina donde se quiere detener el Operation Service. Este parámetro es opcional, si no está este parámetro, se detiene el Operation Service local.

UserName: se utiliza para indicar el nombre de usuario de la máquina donde quiere detener el Operation Service. Este parámetro es obligatorio si el parámetro ComputerName está presente.

Password: se utiliza para indicar la contraseña de la máquina donde quiere detener el Operation Service. Este parámetro es obligatorio si los parámetros ComputerName y UserName están presentes.

Log: Archivo donde las trazas de la ejecución se van a añadir. Este parámetro es opcional.

ErrorLogger: Archivo donde las trazas de error se van a añadir. Este parámetro es opcional.

 

10. Iniciar el Operation Service

Bizagi Operation Service maneja la comunicación entre los ambientes durante operaciones como la creación y actualización de proyectos, deployment, licenciamiento, administración de nodos, entre otros. Después del procedimiento de deployment, es posible que deba reiniciarlo para reflejar los cambios realizados en el procedimiento de deployment.

 

Para iniciar el Operation Service, usted puede ejecutar el comando BizagiAutomation con la opción StartOperationsService especificada como runtype. El comando se debe ejecutar como sigue.

 

BizagiAutomation.exe --runtype StartOperationsService --ComputerName "..." --UserName "..." --Password "..." --Log "..." --ErrorLogger "..."

 

Notas de los parámetros y descripciones:

runtype: Se usa para especificar el tipo de ejecución de BizagiAutomation. En este caso, StartOperationsService es utilizado como valor del parámetro ya que la necesidad es iniciar el Operation Service de un proyecto local o remoto.

ComputerName: se utiliza para indicar el nombre de la máquina donde se quiere iniciar el Operation Service. Este parámetro es opcional, si no está este parámetro, se inicia el Operation Service local.

UserName: se utiliza para indicar el nombre de usuario de la máquina donde quiere iniciar el Operation Service. Este parámetro es obligatorio si el parámetro ComputerName está presente.

Password: se utiliza para indicar la contraseña de la máquina donde quiere iniciar el Operation Service. Este parámetro es obligatorio si los parámetros ComputerName y UserName están presentes.

Log: Archivo donde las trazas de la ejecución se van a añadir. Este parámetro es opcional.

ErrorLogger: Archivo donde las trazas de error se van a añadir. Este parámetro es opcional.

 

11. Backup de la base de datos

La Base de Datos de Bizagi es donde se almacenan todos los datos de negocio y los metadatos del proyecto. Antes del procedimiento de despliegue, es posible que deba realizar un backup de la base de datos de su proyecto en caso de que necesite revertir los cambios realizados en el procedimiento de deployment.

 

Para realizar una copia de seguridad de la base de datos del proyecto, usted puede ejecutar el comando BizagiAutomation con la opción DatabaseBackup especificada como runtype. El comando se debe ejecutar como sigue.

 

BizagiAutomation.exe --runtype DatabaseBackup --Project "..." --Log "..." --ErrorLogger "..."

 

Notas de los parámetros y descripciones:

runtype: Se usa para especificar el tipo de ejecución de BizagiAutomation. En este caso, DatabaseBackup es utilizado como valor del parámetro ya que la necesidad es tomar el backup de la base de datos del proyecto.

Project: se usa para indicar el proyecto local o remoto desde el cual se debe tomar el backup de la base de datos.

Log: Archivo donde las trazas de la ejecución se van a añadir. Este parámetro es opcional.

ErrorLogger: Archivo donde las trazas de error se van a añadir. Este parámetro es opcional.

 

12. Detener el IIS

Bizagi Studio utiliza Microsoft Internet Information Services (IIS) para la ejecución de los procesos. Después del procedimiento de deployment, es posible que deba reiniciar el IIS para reflejar los cambios realizados en el procedimiento de deployment.

 

Para detener el IIS, usted puede ejecutar el comando BizagiAutomation con la opción StopIIS especificada como runtype. El comando se debe ejecutar como sigue.

 

BizagiAutomation.exe --runtype StopIIS --ComputerName "..." --UserName "..." --Password "..." --Log "..." --ErrorLogger "..."

 

Notas de los parámetros y descripciones:

runtype: Se usa para especificar el tipo de ejecución de BizagiAutomation. En este caso, StopScheduler es utilizado como valor del parámetro ya que la necesidad es detener el IIS de una máquina local o remota.

ComputerName: se utiliza para indicar el nombre de la máquina donde se quiere detener el IIS. Este parámetro es opcional, si no está este parámetro, se detiene el IIS local.

UserName: se utiliza para indicar el nombre de usuario de la máquina donde quiere detener el IIS. Este parámetro es obligatorio si el parámetro ComputerName está presente.

Password: se utiliza para indicar la contraseña de la máquina donde quiere detener el IIS. Este parámetro es obligatorio si los parámetros ComputerName y UserName están presentes.

Log: Archivo donde las trazas de la ejecución se van a añadir. Este parámetro es opcional.

ErrorLogger: Archivo donde las trazas de error se van a añadir. Este parámetro es opcional.

 

13. Iniciar el IIS

Bizagi Studio utiliza Microsoft Internet Information Services (IIS) para la ejecución de los procesos. Después del procedimiento de deployment, es posible que deba reiniciar el IIS para reflejar los cambios realizados en el procedimiento de deployment.

 

Para iniciar el IIS, usted puede ejecutar el comando BizagiAutomation con la opción StartIIS especificada como runtype. El comando se debe ejecutar como sigue.

 

BizagiAutomation.exe --runtype StartIIS --ComputerName "..." --UserName "..." --Password "..." --Log "..." --ErrorLogger "..."

 

Notas de los parámetros y descripciones:

runtype: Se usa para especificar el tipo de ejecución de BizagiAutomation. En este caso, StartIIS es utilizado como valor del parámetro ya que la necesidad es iniciar el IIS de una máquina local o remota.

ComputerName: se utiliza para indicar el nombre de la máquina donde se quiere iniciar el IIS. Este parámetro es opcional, si no está este parámetro, se inicia el IIS local.

UserName: se utiliza para indicar el nombre de usuario de la máquina donde quiere iniciar el IIS. Este parámetro es obligatorio si el parámetro ComputerName está presente.

Password: se utiliza para indicar la contraseña de la máquina donde quiere iniciar el IIS. Este parámetro es obligatorio si los parámetros ComputerName y UserName están presentes.

Log: Archivo donde las trazas de la ejecución se van a añadir. Este parámetro es opcional.

ErrorLogger: Archivo donde las trazas de error se van a añadir. Este parámetro es opcional.

 

14. Iniciar la limpieza

Bizagi almacena un caché para evitar una recarga excesiva de componentes relacionados con el portal de trabajo u otras tareas relacionadas con la ejecución de Bizagi. Después del procedimiento de deployment, es posible que deba limpiar los archivos temporales para reflejar los cambios realizados.

 

Para borrar los archivos temporales de un proyecto de Bizagi, usted puede ejecutar el comando BizagiAutomation con la opción RunCleanup especificada como runtype. El comando se debe ejecutar como sigue.

 

BizagiAutomation.exe --runtype RunCleanup --Project "..." --ComputerName "..." --UserName "..." --Password "..." --Log "..." --ErrorLogger "..."

 

Notas de los parámetros y descripciones:

runtype: Se usa para especificar el tipo de ejecución de BizagiAutomation. En este caso, RunCleanup es utilizado como valor del parámetro ya que la necesidad es to borrar los archivos temporales de un proyecto local o remoto.

Project: se usa para indicar el proyecto local o remoto en el cual se debe borrar los archivos temporales de un proyecto de Bizagi

ComputerName: se utiliza para indicar el nombre de la máquina donde se quiere borrar los archivos temporales. Este parámetro es opcional, si no está este parámetro, se borran los archivos temporales locales.

UserName: se utiliza para indicar el nombre de usuario de la máquina donde se quiere borrar los archivos temporales. Este parámetro es obligatorio si el parámetro ComputerName está presente.

Password: se utiliza para indicar la contraseña de la máquina donde se quiere borrar los archivos temporales. Este parámetro es obligatorio si los parámetros ComputerName y UserName están presentes.

Log: Archivo donde las trazas de la ejecución se van a añadir. Este parámetro es opcional.

ErrorLogger: Archivo donde las trazas de error se van a añadir. Este parámetro es opcional.

 

15. Detener el application pool

El Application Pool es un componente del IIS responsable de aislar la aplicación web de su Proyecto Bizagi de otras aplicaciones en su servidor. Después del procedimiento de deployment, es posible que deba reiniciar el Application Pool de Bizagi para reflejar los cambios.

 

Para detener el Application Pool de Bizagi, usted puede ejecutar el comando BizagiAutomation con la opción StopAppPool especificada como runtype. El comando se debe ejecutar como sigue.

 

BizagiAutomation.exe --runtype StopAppPool --ComputerName "..." --UserName "..." --Password "..." --Log "..." --ErrorLogger "..."

 

Notas de los parámetros y descripciones:

runtype: Se usa para especificar el tipo de ejecución de BizagiAutomation. En este caso, StopAppPool es utilizado como valor del parámetro ya que la necesidad es detener el Application Pool de Bizagi de una máquina local o remota.

ComputerName: se utiliza para indicar el nombre de la máquina donde se quiere detener el Application Pool de Bizagi. Este parámetro es opcional, si no está este parámetro, se detiene el application pool local.

UserName: se utiliza para indicar el nombre de usuario de la máquina donde se quiere detener el Application Pool de Bizagi. Este parámetro es obligatorio si el parámetro ComputerName está presente.

Password: se utiliza para indicar la contraseña de la máquina donde se quiere detener el Application Pool de Bizagi. Este parámetro es obligatorio si los parámetros ComputerName y UserName están presentes.

Log: Archivo donde las trazas de la ejecución se van a añadir. Este parámetro es opcional.

ErrorLogger: Archivo donde las trazas de error se van a añadir. Este parámetro es opcional.

 

16. Iniciar el application pool

El Application Pool es un componente del IIS responsable de aislar la aplicación web de su Proyecto Bizagi de otras aplicaciones en su servidor. Después del procedimiento de deployment, es posible que deba reiniciar el Application Pool de Bizagi para reflejar los cambios.

 

Para iniciar el Application Pool de Bizagi, usted puede ejecutar el comando BizagiAutomation con la opción StartAppPool especificada como runtype. El comando se debe ejecutar como sigue.

 

BizagiAutomation.exe --runtype StartAppPool --ComputerName "..." --UserName "..." --Password "..." --Log "..." --ErrorLogger "..."

 

Notas de los parámetros y descripciones:

runtype: Se usa para especificar el tipo de ejecución de BizagiAutomation. En este caso, StartAppPool es utilizado como valor del parámetro ya que la necesidad es iniciar el Application Pool de Bizagi de una máquina local o remota.

ComputerName: se utiliza para indicar el nombre de la máquina donde se quiere detener el Application Pool de Bizagi. Este parámetro es opcional, si no está este parámetro, se inicia el application pool local.

UserName: se utiliza para indicar el nombre de usuario de la máquina donde se quiere iniciar el Application Pool de Bizagi. Este parámetro es obligatorio si el parámetro ComputerName está presente.

Password: se utiliza para indicar la contraseña de la máquina donde se quiere iniciar el Application Pool de Bizagi. Este parámetro es obligatorio si los parámetros ComputerName y UserName están presentes.

Log: Archivo donde las trazas de la ejecución se van a añadir. Este parámetro es opcional.

ErrorLogger: Archivo donde las trazas de error se van a añadir. Este parámetro es opcional.

 

17. Backup de la Web application

El Portal de Trabajo de Bizagi está empaquetado en una Web application alojada en su servidor. Antes del procedimiento de deployment, es posible que deba realizar un backup de la Web application de Bizagi en caso de que necesite revertir los cambios realizados.

 

Para realizar un backup de la Web application de Bizagi, usted puede ejecutar el comando BizagiAutomation con la opción WebAppBackup especificada como runtype. El comando se debe ejecutar como sigue.

 

BizagiAutomation.exe --runtype WebAppBackup --Project "..." --ComputerName "..." --UserName "..." --Password "..." --Log "..." --ErrorLogger "..."

 

Notas de los parámetros y descripciones:

runtype: Se usa para especificar el tipo de ejecución de BizagiAutomation. En este caso, WebAppBackup es utilizado como valor del parámetro ya que la necesidad es tomar un backup de la Web application de un proyecto local o remoto.

Project: se usa para indicar el proyecto local o remoto desde el cual se debe tomar el backup de la Web application.

ComputerName: se utiliza para indicar el nombre de la máquina donde se quiere tomar el backup de la Web application. Este parámetro es opcional, si no está este parámetro, el backup es tomado localmente.

UserName: se utiliza para indicar el nombre de usuario de la máquina donde quiere tomar el backup de la Web application. Este parámetro es obligatorio si el parámetro ComputerName está presente.

Password: se utiliza para indicar la contraseña de la máquina donde quiere tomar el backup de la Web application. Este parámetro es obligatorio si los parámetros ComputerName y UserName están presentes.

Log: Archivo donde las trazas de la ejecución se van a añadir. Este parámetro es opcional.

ErrorLogger: Archivo donde las trazas de error se van a añadir. Este parámetro es opcional.

 

18. Descomprimir parche

Algunos parches son generados por el equipo de Soporte de Bizagi para arreglar o mejorar componentes específicos para un cliente dado, estos parches deben descomprimirse en el ambiente donde se detectó la falla o la solicitud.

 

Para descomprimir el parche, usted puede ejecutar el comando BizagiAutomation con la opción UnzipPatch especificada como runtype. El comando se debe ejecutar como sigue.

 

BizagiAutomation.exe --runtype UnzipPatch --Source "..." --Target "..." --ComputerName "..." --UserName "..." --Password password --Log "..." --ErrorLogger "..."

 

Notas de los parámetros y descripciones:

runtype: Se usa para especificar el tipo de ejecución de BizagiAutomation. En este caso, UnzipPatch es utilizado como valor del parámetro ya que la necesidad es descomprimir un parche en una máquina local o remota.

Source: se utiliza para indicar la ruta local o remota donde se encuentra el archivo zip del parche.

Target: se usa para indicar la ruta local o remota donde se descomprimirá el parche.

ComputerName: se utiliza para indicar el nombre de la máquina donde se quiere descomprimir el parche. Este parámetro es opcional, si no está este parámetro, el backup es tomado localmente.

UserName: se utiliza para indicar el nombre de usuario de la máquina donde quiere descomprimir el parche. Este parámetro es obligatorio si el parámetro ComputerName está presente.

Password: se utiliza para indicar la contraseña de la máquina donde quiere descomprimir el parche. Este parámetro es obligatorio si los parámetros ComputerName y UserName están presentes.

Log: Archivo donde las trazas de la ejecución se van a añadir. Este parámetro es opcional.

ErrorLogger: Archivo donde las trazas de error se van a añadir. Este parámetro es opcional.

 

19. Exportar plantillas de Configuración

Si aún no se siente seguro o con la confianza suficiente para escribir los comandos y realizar un proceso de Deployment por Línea de Comandos exitoso, Bizagi ofrece una forma de generar ejemplos del funcionamiento de cada aplicación. Esto generará un directorio que contiene todos los ejemplos para cada runtype de la herramienta BizagiAutomation.

 

Para generar las plantillas ejecute el siguiente comando en su línea de comandos.

 

BizagiAutomation.exe --runtype GenerateTemplates

 

En el directorio MC tools, se creará una nueva carpeta que contiene todos los ejemplos para cada runtype.

 

1. Abra una línea de comandos y navegue al directorio de MC (C:\Program Files\Bizagi\Bizagi Studio\MC).

 

CLD_02

 

2. Ejecute el comando descrito anteriormente.

 

CLD_03

 

3. Revise la ubicación indicada en la línea de comandos, al navegar hasta allá en el explorador de Windows encontrará los archivos generados.

 

CLD_04

 

4. Cada subdirectorio corresponde a una aplicación de BizagiAutomation.exe. Adentro encontrará un archivo config de ejemplo, un archivo .bat que usa el archivo config, un .bat que usa parámetros en el comando y un ReadMe con consideraciones adicionales.

 

CLD_06

 

5. Explore los archivos generados para entender su funcionamiento y remplace los parámetros por defecto con los que usted necesite para realizar el deployment como lo requiera. Los archivos .bat y de config pueden ser abiertos con el editor de texto de su preferencia para ver o editar su contenido.