Instalación silenciosa

El proceso de instalación silenciosa requiere la edición y ejecución del script Silent-Install-Hub-4.5.ps1 en PowerShell para instalar Hub sin el uso del asistente de instalación de Hub.

El script Silent-Install-Hub-4.5.ps1 está disponible para descargar desde el portal de Blue Prism.

Para realizar una instalación regular con el asistente de instalación de Hub, consulte Instalar Blue Prism Hub.

Al utilizar el asistente de instalación de Hub, hay oportunidades para validar la información que ha ingresado en los campos de texto haciendo clic en los botones del asistente. No hay validación cuando se realiza una instalación silenciosa. Si se introducen parámetros incorrectos, se podría romper el servidor web. Se recomienda tomar una instantánea de la máquina antes de ejecutar el script como copia de seguridad.

Audiencia prevista

Esta guía es para profesionales de TI competentes en:

  • Edición y ejecución de scripts
  • Uso de PowerShell
  • Depuración

Requisitos previos

Todos los requisitos previos para la instalación de un Blue Prism Hub regular también se aplican a la instalación silenciosa de un Blue Prism Hub.

Para obtener información sobre la instalación del software requerido, consulte Instalar y configurar el servidor web.

Edite el archivo del script Silent-Install-Hub.ps1

Las siguientes secciones describen cómo preparar el archivo de script Silent-Install-Hub-4.5.ps1 para una instalación silenciosa de Blue Prism Hub.

El Silent-Install-Hub-4.5.ps1 de se puede abrir y editar en un editor como Notepad o Visual Studio Code. Cada sección del código en el archivo contiene información que corresponde a una pantalla en el asistente de instalación de Hub.

La mayoría de los parámetros del archivo Silent-Install-Hub-4.5.ps1 son sencillos de completar o editar. Cada parámetro tiene un nombre y un valor, y se muestra en el siguiente formato:

$msi_params = $msi_params + "NAME=`"Value`" "

Para editar un parámetro, sobrescriba el valor. Se recomienda que no cambie ninguno de los nombres de los parámetros.

Recuerde guardar el Silent-Install-Hub-4.5.ps1 después de realizar cualquier cambio.

Cambiar el destino predeterminado de instalación de Hub (opcional)

Para verificar la ubicación predeterminada en el script Silent-Install-Hub.ps1 y cambiarla a una nueva ubicación:

  1. Abra el archivo Silent-Install-Hub-4.5.ps1 en un editor.

    Se abre el archivo de script. Se mostrará de manera diferente según su editor.

    La carpeta de destino donde desea instalar Hub muestra la ubicación predeterminada (C:\Archivos de programa (x86)\Blue Prism):

  2. Si desea instalar Hub en otra ubicación, elimine el # del comienzo de la línea y edite la ruta de archivo indicada en la imagen anterior.

    El # indica que la línea está comentada y no se ejecutará. Debe eliminar el # para activar la línea.

Cambiar el modo de autenticación de SQL (opcional)

El modo de autenticación se puede editar para las siguientes bases de datos:

  • IMS (IMS_SQL_SERVER)
  • Hub (HUB_SQL_SERVER)
  • Audit (AUDIT_SQL_SERVER)
  • Archivo (FILE_SQL_SERVER)
  • Notification Center (NOTIFICATION_CENTER_SQL_SERVER)
  • License Manager (LICENSE_MANAGER_SQL_SERVER)
  • Email Service ( EMAIL_SERVICE_SQL_SERVER)

Cada sección de la base de datos corresponde a una pantalla del asistente de instalación de Hub.

Las siguientes instrucciones utilizan la base de datos IMS como ejemplo (IMS es un nombre heredado para el Authentication Server).

La siguiente línea de código corresponde al panel Modo de autenticación en la pantalla Configurar conexión IMS SQL del asistente de instalación de Hub:

  • Para establecer el modo de autenticación en Confiable (Autenticación de Windows), sobrescriba el valor con una T.

    Si introduce T para el valor IMS_SQL_AUTH_MODE, elimine cualquier valor para IMS_SQL_USERNAME y IMS_SQL_PASSWORD.

  • Para establecer el modo de autenticación en Especificar nombre de usuario y contraseña (Autenticación de SQL), sobrescriba el valor con una S.

    Si introduce S para el valor IMS_SQL_AUTH_MODE, complete el valor para IMS_SQL_USERNAME y IMS_SQL_PASSWORD.

Editar el nombre de host (opcional)

El nombre de host se puede editar para los siguientes sitios web:

  • IMS (IMS_SITE_NAME)
  • Hub (HUB_SITE_NAME)
  • Audit (AUDIT_SITE_NAME)
  • Email Service ( EMAIL_SERVICE_SITE_NAME)
  • File (FILE_SITE_NAME)
  • SignalR (SIGNALR_SITE_NAME)
  • License Manager (LICENSE_MANAGER_SITE_NAME)
  • Notification Center (NOTIFICATION_CENTER_SITE_NAME)

Cada sección del sitio web corresponde a una pantalla del asistente de instalación de Hub.

Las siguientes instrucciones utilizan el sitio web de IMS como ejemplo (IMS es un nombre heredado para el Authentication Server).

IMS_HOSTNAME corresponde a la pantalla de Configuración de IIS de Authentication Server del asistente de instalación del Hub.

Para verificar/editar el nombre de host:

  1. Compruebe que el valor en el valor IMS_HOSTNAME esté todo en minúsculas.
  2. Puede sobrescribir el valor IMS_HOSTNAME con un nuevo nombre de host. Si sobrescribe con un nuevo nombre de host, asegúrese también de escribir el nombre en minúscula.

Obtenga certificados SSL con PowerShell

Puede utilizar PowerShell como método rápido para mostrar las huellas digitales de todos los certificados en un almacén en particular.

  1. Abra PowerShell como administrador.

  2. Escriba la siguiente línea después de PS C:\Windows\system32>:

    Get-ChildItem -Path Cert:\LocalMachine\My

  3. Presione Intro.

    Las huellas digitales de certificado se muestran en mayúsculas sin espacios.

Obtener certificados SSL con la Consola de administración de Microsoft

Cualquier pantalla del asistente de instalación de Hub que requiera un certificado muestra una lista desplegable para que usted seleccione. Al realizar una instalación silenciosa, los certificados deben ingresarse manualmente en formato de miniatura:

Para acceder a los certificados:

  1. En la barra de búsqueda de Windows, escriba "MMC" y seleccione el comando Ejecutar MMC.

    Se abre la consola de administración de Microsoft.

  2. Haga clic en Archivo y luego en Agregar/Eliminar complementos.

  3. En el diálogo Agregar o eliminar complementos, seleccione Certificados y haga clic en Agregar.

  4. En el diálogo Complemento de certificados, haga clic en Cuenta de computadora y haga clic en Siguiente.

  5. Haga clic en Finalizar y luego en Aceptar.

  6. Haga clic en Certificados en la vista de árbol y seleccione la carpeta Personal > Certificados o la carpeta Web Hosting > Certificados para seleccionar el certificado apropiado en el panel principal (busque en la columna Nombre descriptivo).

  7. Haga doble clic en su certificado y, en el diálogo Certificado, seleccione Detalles y luego Huella digital.

    El script solo funciona si las huellas digitales de certificado están en mayúscula y no contienen espacios. Utilice un editor de texto para cambiarlas a mayúsculas y eliminar espacios antes de pegarlas en el archivo de script.

  8. Copie la huella digital y péguela en los valores de certificado relevantes en el archivo Silent-Install-Hub-4.5.ps1.

Seleccione y cancele la selección de las casillas de verificación

Los valores que corresponden a las casillas de verificación aceptan valores “true” o “false”.

Omitir Blue Prism Decision (opcional)

Para omitir la instalación de Blue Prism Decision, establezca el valor BLUE_PRISM_DECISION_SKIPPED como “true”.

Verificar RabbitMQ

Asegúrese de que los parámetros RMQ contengan los valores correctos.

Verificar ID de cliente

Asegúrese de que el parámetro HUB_CUSTOMER_ID contenga el valor correcto. Si este valor es incorrecto, no podrá licenciar ningún complemento sin alguna reconfiguración manual.

Compruebe la URL de Blue Prism API (opcional)

Asegúrese de que el parámetro BLUE_PRISM_API_URL contenga los valores correctos.

Combinar parámetros

El siguiente código se utiliza para combinar todos los parámetros en una cadena lista para la instalación:

Copiar
$silentArgs = “/I `"[filepath to Blue Prism Hub.msi]$Version\Blue Prism Hub.msi`" /qn /norestart /l*v `"C:[filepath to log file]logs_hub_$Version.log’" $msi_params"$process = Start-Process msiexec.exe -Wait -ArgumentList $silentArgs -PassThruWrite-Host $process.ExitCode
Verifique que la ruta de acceso al archivo de Blue Prism Hub.msi sea correcta y actualícela si no lo es.

Iniciar la instalación silenciosa

Recuerde guardar el Silent-Install-Hub-4.5.ps1 después de realizar cualquier cambio.

Antes de iniciar la instalación, asegúrese de que el script Silent-Install-Hub-4.5.ps1 esté en el mismo directorio que el archivo Blue Prism Hub.msi, o deberá especificar la ruta completa al script en el paso tres a continuación.

  1. En el Explorador de archivos, navegue hasta la ubicación del archivo Blue Prism Hub.msi.

  2. Haga clic en Archivo y seleccione Abrir Windows PowerShell > Abrir Windows PowerShell como administrador.

    Aparece la pantalla PowerShell.

  3. Escriba .\Silent-Install-Hub-4.5.ps1 y presione Intro.

  4. Si aparece una advertencia, escriba R para ejecutar una vez.

    El instalador de Hub se ejecutará y el Hub 4.5 estará disponible una vez instalado. Si la instalación falla, aparece un código de error en PowerShell. Se recomienda que busque en el registro para encontrar y solucionar el problema.

Se crea un archivo de registro en la ubicación del instalador durante la instalación y las actualizaciones en tiempo real. Se recomienda eliminar los archivos de registro después de la instalación por motivos de seguridad.

Desinstalación silenciosa

Recuerde guardar el Silent-Install-Hub-4.5.ps1 después de realizar cualquier cambio.

  1. Utilizando PowerShell como administrador, reemplace la siguiente línea de código en el archivo Silent-Install-Hub-4.5.ps1:

    Copiar
    $silentArgs = "/I `"[ruta de acceso a Blue Prism Hub.msi]$Version\Blue Prism Hub.msi`" /qn /norestart /l*v `"C:[ruta de acceso al archivo de registro]logs_hub_$Version.log` 

    con:

    Copiar
    $silentArgs = "/X `"[ruta de acceso a Blue Prism Hub.msi]$Version\Blue Prism Hub.msi`" /qn /norestart /l*v `"C:[ruta de acceso al archivo de registro]logs_hub_uninstall_$Version.log`" $msi_params"
  2. En el Explorador de archivos, navegue hasta la ubicación del archivo Blue Prism Hub.msi.

  3. Haga clic en Archivo y seleccione Abrir Windows PowerShell > Abrir Windows PowerShell como administrador.

    Aparece la pantalla PowerShell.

  4. Escriba ".\Silent-Install-Hub-4.5.ps1 y presione Intro.
  5. Si aparece una advertencia, escriba R para ejecutar una vez.

    Hub se desinstalará.

  6. Escriba ".\Clear-Installation.ps1" y presione Intro.

    Esto completa el proceso de desinstalación. Si la instalación falla, aparece un código de error en PowerShell. Se recomienda que busque en el registro para encontrar y solucionar el problema.

    Los archivos de registro deben eliminarse después de la instalación por motivos de seguridad.

Configurar la API de Decision fuera del proceso de instalación silenciosa de Blue Prism Hub

La siguiente información explica cómo configurar la API fuera del instalador si Decision no se instaló inicialmente:

  1. Abra Hub appsettings.json en un editor como Bloc de notas o Visual Studio Code.

  2. Abra el archivo Silent-install-Hub-4.5.ps1 y copie el valor BLUE_PRISM_DECISION_URL.

  3. Pegue el valor BLUE_PRISM_DECISION_URL sobre el valor "v1" en la sección "DruidModelServices" del archivo Hub appsettings.json.

  4. Copie el valor BLUE_PRISM_DECISION_CERTIFICATE_ID del Silent-Install-Hub-4.5.ps1

  5. Pegue el valor BLUE_PRISM_DECISION_CERTIFICATE_ID sobre el valor "CertificateThumbprint" en la sección "BluePrismDecisionSettings" del archivo Hub appsettings.json.

  6. En el archivo Hub appsettings.json, si el valor "KeyStorageDirectory" no está cifrado, actualice la ruta del archivo a las claves de protección de datos. Si este valor está cifrado, utilice la herramienta Blue Prism Data Protector para descifrar el valor y actualizar la ruta de acceso del archivo. Cifrar nuevamente si es necesario.

  7. En el archivo Hub appsettings.json, si el valor "ConnectionString" no está cifrado (en la sección "BluePrismDecision"), actualice la cadena de conexión de Blue Prism Decision. Si este valor está cifrado, utilice la herramienta Blue Prism Data Protector para descifrar el valor y actualizar la cadena de conexión. Cifrar nuevamente si es necesario.

  8. Guarde el archivo appsettings.json.

Ahora puede configurar Decision dentro de Hub. La base de datos se crea en el momento de la instalación.