Actualización de Administrador de flujos de trabajo a Administrador de flujos de trabajo de SharePoint en una nueva granja de servidores

SE APLICA A:2013 2016 2019 Subscription Edition SharePoint en Microsoft 365

Información general

Al actualizar granjas de SharePoint anteriores que usan Administrador de flujos de trabajo clásicas (WFM) a una versión más reciente de SharePoint, WFM también debe actualizarse a SharePoint Administrador de flujos de trabajo (SPWFM). Puesto que va a instalar una copia nueva de SPWFM en el nuevo hardware y actualizar las bases de datos de WFM existentes, este procedimiento es básicamente una combinación de los nuevos procedimientos de instalación y actualización con algunos pasos agregados.

Nota:

A medida que actualice una granja de WFM existente a una granja de SERVIDORES SPWFM, se reutilizarán las bases de datos de WFM. El registro y los flujos de trabajo existentes deben permanecer intactos.

Paso 1: Preparar la granja de Administrador de flujos de trabajo antigua

Necesita información del entorno "antiguo" para configurar correctamente el entorno "nuevo".

Obtención de la clave de generación de certificados

Dado que los pasos de actualización requieren que se una a una granja de flujos de trabajo existente, necesita la WFM "Clave de generación de certificados" al volver a unirse. Si no sabe cuál es esa clave y no tiene ningún registro escrito, restablezca la clave de generación de certificados para WFM y Service Bus antes de continuar. Debe unir la granja de flujos de trabajo existente con la clave de generación de certificados adecuada.

Comprobación del ámbito

Debe volver a registrar SPWorkflowService con el mismo nombre de ámbito que se usó en la granja anterior.

1. Para comprobar el nombre del ámbito, ejecute el siguiente PowerShell en uno de los servidores de SharePoint de la granja de servidores "antigua":

   
   Add-PSSnapin *sharepoint*
   $site = (Get-SPWebapplication -IncludeCentralAdministration | ?{$_.IsAdministrationWebApplication}).Sites[0]
   $wfmProxy = Get-SPServiceApplicationProxy | ?{$_.TypeName -eq "Workflow Service Application Proxy"}
   $wfmProxy.GetWorkflowServiceAddress($site)
   
   

2. Una dirección se muestra de forma similar a esta: local:12290/SharePoint2013contoso.apps.https://

La parte después del número de puerto es el nombre del ámbito. En este ejemplo, es "SharePoint2013". Anote el nombre del ámbito y guárdelo para más adelante. Lo necesitará al ejecutar Register-SPWorkflowService en la nueva granja de servidores.

Comprobación de la cuenta de servicio y el grupo de administración

1. En el servidor WFM de la granja "antigua", abra PowerShell.

2. Ejecutar

   
   GET-wffarm | select runasaccount, admingroup 
   
   

   Ejemplo:

   

Tome nota de la cuenta y del grupo. Al volver a unirse a la granja de flujos de trabajo en el nuevo entorno, debe proporcionar la contraseña de RunAsAccount. Solo los usuarios que son miembros de AdminGroup pueden examinar el URI del punto de conexión de flujo de trabajo y ejecutar el comando Register-SPWorkflowService .

Desvinculación de la antigua granja de WFM

Importante

Debe ejecutar el asistente y dejar la granja de flujos de trabajo en el servidor de WFM "antiguo". Debe hacerlo para todos los nodos de la granja de WFM para que las bases de datos de Flujo de trabajo y Service Bus no contengan hosts.

Si omite este paso, huérfanará las entradas de host en las bases de datos de Flujo de trabajo y Service Bus, lo que provocará muchos problemas en el nuevo entorno.

1. Inicie sesión en el servidor que hospeda la granja de WFM y abra "Administrador de flujos de trabajo configuración".
2. Seleccione Salir Administrador de flujos de trabajo granja de servidores y siga los pasos para salir de la granja actual.
3. Si tiene varios nodos (hosts) en la granja de WFM, repita este paso para cada nodo.

Nota:

SharePoint Administrador de flujos de trabajo se instalará en el nuevo hardware de la nueva granja de servidores. No es necesario desinstalar Administrador de flujos de trabajo y los componentes de Service Bus de los servidores antiguos.

Si desea que la granja de WFM "antigua" siga funcionando durante la migración, realice una copia de seguridad de las bases de datos de Flujo de trabajo y Service Bus como se describe a continuación y vuelva a ejecutar el asistente para volver a unirse a la granja. Para evitar mover información de nodo a la nueva granja de servidores, asegúrese de que todos los nodos están separados en el momento de la copia de seguridad de la base de datos.

Paso 2: Mover las bases de datos

Mover las bases de datos de contenido

Para mantener la paridad entre los sitios de SharePoint y los flujos de trabajo que se ejecutan en ellos, debe mover las bases de datos de contenido junto con el servicio De administración de aplicaciones y las bases de datos de WFM. La actualización del contenido de SharePoint está fuera del ámbito de este documento, pero nos referimos a algunos elementos relacionados con la actualización de WFM.

Con el método de asociación de base de datos, puede mover bases de datos de contenido de SharePoint de la granja antigua a la nueva granja de servidores.

Nota:

Si va a pasar a una versión principal más reciente de SharePoint, es posible que tenga que completar un paso de actualización intermedio. Por ejemplo, solo SharePoint 2016 y 2019 se pueden actualizar directamente a SharePoint Server Edición de Suscripción (SPSE). SharePoint 2013 no puede. Para actualizar una base de datos de contenido de SharePoint 2013 a SPSE, primero debe actualizarla a SharePoint 2016 y luego a SPSE.

Más información en:

• Versión preliminar de SharePoint Server Edición de Suscripción
• Actualizar a SharePoint Server 2019
• Actualizar a SharePoint Server 2016

Mover la base de datos de App Management

Dado que los flujos de trabajo obtienen su permiso para el contenido de SharePoint a través de entidades de seguridad de aplicación almacenadas en la base de datos de Administración de aplicaciones, también debe actualizar o migrar esta base de datos a la nueva granja de servidores.

Importante

Debe mover la base de datos de App Management junto con las bases de datos de contenido, WFM y Service Bus. Si no lo hace, se producirá un error en todos los flujos de trabajo creados antes de la migración.

Encontrará el problema 3: los flujos de trabajo producen un error y devuelven el error "No se puede obtener la información de permisos de la entidad de seguridad de la aplicación". Aunque el problema se puede corregir más adelante, es más fácil evitarlo mediante la incorporación de la base de datos de App Management durante la actualización o migración.

Estos son los pasos básicos:

• Haga una copia de seguridad de la base de datos de App Management en la granja antigua mediante SQL Server copia de seguridad.
• Restaure la base de datos de App Management en la nueva SQL Server.
• Creación de un nuevo servicio de administración de aplicaciones En Administración central en la nueva granja de servidores, vaya a Administrar aplicaciones de servicio y cree un nuevo servicio de administración de aplicaciones. En la sección Base de datos, escriba el nombre y el nombre de la base de datos de SQL Server de la base de datos de App Management que restauró desde la granja anterior. Básicamente, estamos creando una nueva aplicación de servicio mediante la reutilización de la base de datos antigua. Debe actualizar la base de datos a la versión actual de SharePoint.
• Confirme que el servicio está en el grupo de proxy predeterminado. Asegúrese de que este nuevo Servicio de administración de aplicaciones está en el grupo de proxy predeterminado y de que las aplicaciones web lo usan.

Nota:

Al igual que las bases de datos de contenido, si va a pasar a una versión principal más reciente de SharePoint, es posible que tenga que completar un paso de actualización intermedio. Por ejemplo, solo SharePoint 2016 y 2019 se pueden actualizar directamente a SharePoint Server Edición de Suscripción (SPSE). SharePoint 2013 no puede. Para actualizar una base de datos de contenido de SharePoint 2013 a SPSE, primero debe actualizarla a SharePoint 2016 y luego a SPSE.

Mover las bases de datos de WFM y Service Bus

Si la actualización o migración incluye mover bases de datos a un nuevo SQL Server, debe mover todas las bases de datos de WFM y Service Bus.

1. Realice una copia de seguridad de las bases de datos en la SQL Server anterior:

• SbGatewayDatabase
• SbManagementDB
• SBMessageContainer01
• WFInstanceManagementDB
• WFManagementDB
• WFResourceManagementDB

2. Restaure las bases de datos en el nuevo SQL Server.

Restauración de las bases de datos en el nuevo servidor SQL Server

Importante

Debe restaurar las 6 bases de datos en el nuevo servidor SQL Server con los mismos nombres de base de datos que se usaron anteriormente. Si cambia los nombres de base de datos, el Asistente para configuración de flujo de trabajo agotará el tiempo de espera al intentar iniciar los servicios de Service Bus.

Creación de un alias de SQL

El Asistente para configuración del administrador de flujos de trabajo solo le pide que escriba información de conexión para 2 de las seis bases de datos. Las cadenas de conexión de las otras cuatro bases de datos se almacenan dentro de las dos bases de datos que especifique. Por este motivo, es importante restaurar las bases de datos con los mismos nombres que se usaron anteriormente.
Para que las cadenas de conexión de base de datos anteriores funcionen, también debe crear un alias SQL en los nuevos servidores SPWFM.

• Busque el nombre del servidor SQL server "antiguo" ejecutando esta consulta SQL en la base de datos "SbManagementDB":

  select Name, Value as "SQLServerName" from store.serviceconfig where name = 'SBGatewayDatabaseServer'
  
  

  Ejemplo:

  

• En el servidor SPWFM, vaya a Inicio | Ejecute y escriba "cliconfg".

  

• En la pestaña Alias , seleccione Agregar.

• Elija TCP/IP para la biblioteca de red.

• En el cuadro "Alias del servidor", escriba el nombre del servidor SQL Server "antiguo". Ejemplo: "SQL"

• En el cuadro "Nombre del servidor", escriba el nombre del servidor SQL Server "nuevo" (ejemplo: "New_SQL") y seleccione Aceptar.

Nota:

WFM versiones no se alinean con las versiones de SharePoint, lo que significa que si está realizando una actualización de varias versiones de SharePoint, no es necesario actualizar WFM en cada paso.

Por ejemplo, al actualizar de SharePoint 2013 a SharePoint 2019, debe actualizar las bases de datos de contenido y la aplicación app management service a SharePoint 2016 y, a continuación, a 2019. Pero no es necesario actualizar WFM en la granja de servidores de 2016. Solo se requiere una única actualización de WFM (en el entorno de 2013) a SPWFM (en el entorno de 2019).

Paso 3: Preparación del nuevo servidor Administrador de flujos de trabajo de SharePoint

Comprobación del rol de servidor IIS

1. Compruebe si tiene el rol de servidor "Servidor web (IIS)" instalado en el nuevo servidor SPWFM. Instálelo si no está en el servidor.

   Si va a instalar SPWFM en un servidor que no es de SharePoint, es posible que aún no lo tenga instalado. Desafortunadamente, no hay nada que le obligue a instalarlo, por lo que, si no lo hace, se produce un error en el Asistente para configuración de flujo de trabajo: "No se pudo cargar el archivo o ensamblado "Microsoft.Web.Administration".

Instalación de Azure Service Fabric

SharePoint Administrador de flujos de trabajo requiere Azure Service Fabric, que debe instalarse antes de ejecutar la instalación de SharePoint Administrador de flujos de trabajo. Si el entorno de ejecución de Azure Service Fabric aún no está instalado, siga estos pasos para instalarlo:

La versión mínima de Azure Service Fabric Runtime compatible con SharePoint Administrador de flujos de trabajo es 9.1.1583.9590 y puede descargarla desde Azure Service Fabric Runtime. También puedes encontrar y descargar cualquier versión superior de su Windows Installer desde aquí.

Abra una consola de PowerShell como administrador con privilegios elevados y ejecute el siguiente comando:

.\MicrosoftServiceFabric.9.1.1583.9590.exe /accepteula

Para comprobar que Azure Service Fabric está instalado, debe poder encontrarlo en los programas y características de la Panel de control.

Nota:

SharePoint Administrador de flujos de trabajo admite la versión 9.1.1583.9590 de Azure Service Fabric y versiones posteriores. Puede instalar versiones superiores. Obtenga más información en las versiones admitidas de Service Fabric.

Si desea actualizar directamente Azure Service Fabric sin desinstalarlo, tenga en cuenta las dependencias de actualización. Obtenga más información en las versiones admitidas de Service Fabric.

Importante

Si Windows Fabric ya está instalado en el equipo, debe desinstalarlo antes de instalar Azure Service Fabric.

Instalación de SPWFM y el cliente SPWFM en el servidor SPWFM

1. En el servidor SPWFM, descargue e instale sharePoint Administrador de flujos de trabajo Client y SharePoint Administrador de flujos de trabajo

Instalación del cliente SPWFM en todos los servidores de SharePoint

1. Descargue el instalador de SharePoint Administrador de flujos de trabajo Client.
2. Instale el cliente de SharePoint Administrador de flujos de trabajo en todos los servidores de SharePoint de la granja de servidores.

Configuración de servicios de administración de aplicaciones y suscripciones

1. En el servidor de SharePoint (si aún no lo ha hecho), configure el servicio De administración de aplicaciones mediante la base de datos de Administración de aplicaciones actualizada de la granja anterior. Consulte el paso anterior "Mover la base de datos de administración de aplicaciones".

2. Cree un nuevo servicio de configuración de suscripción.

   $sa = New-SPSubscriptionSettingsServiceApplication -ApplicationPool 'SharePoint Web Services Default' -Name 'Subscriptions Settings Service Application' -DatabaseName 'Subscription'
   New-SPSubscriptionSettingsServiceApplicationProxy -ServiceApplication $sa
   

3. Compruebe las aplicaciones administración de aplicaciones y servicio de suscripción. Deben estar en estado "Iniciado".

   

Paso 4: Volver a unir la granja de flujos de trabajo y actualizar

1. Ejecute el Asistente para configuración de SPWFM.

2. En el servidor SPWFM, abra "Administrador de flujos de trabajo Configuration" (Configuración de Administrador de flujos de trabajo) y seleccione Join an existing Administrador de flujos de trabajo farm (Unir a una granja de servidores Administrador de flujos de trabajo existente).

3. Escriba la SQL Server y los detalles de la base de datos que usaba la WFM instalación "clásica" anterior y, a continuación, ejecute la instalación.

   

4. Escriba la contraseña de la cuenta de servicio y la clave de generación de certificados.

   

5. En el servidor SPWFM, vuelva a abrir "configuración de Administrador de flujos de trabajo", seleccione Actualizar Administrador de flujos de trabajo granja y déjelo ejecutar hasta que finalice.

Confiar en el certificado SSL SPWFM en los servidores de SharePoint

Dado que SharePoint debe ponerse en contacto con el punto de conexión de servicio SPWFM, los servidores de SharePoint deben confiar en el certificado que usa.

Exportación del certificado

1. En el servidor SPWFM, abra el Administrador de IIS. Haga clic con el botón derecho en el sitio de administración de flujos de trabajo y elija Editar enlaces. Seleccione el enlace HTTPS en el puerto 12290 y elija Editar. Seleccione el botón "Ver" junto al certificado SSL.

   

2. Seleccione la pestaña Detalles y elija "Copiar en archivo..."

3. Ejecute el Asistente para exportación de certificados para exportar el certificado sin la clave privada como unbinario X.509 codificado en DER (. CERTIFICADO CER).

4. Copie el archivo .cer en el servidor de Administración central de SharePoint.

Adición del certificado SPWFM a la confianza de la granja

1. En Administración central, vaya a Administración de seguridad > de confianza.
2. Elija Nuevo y asígnele un nombre como "Flujo de trabajo" o "SPWFM".
3. Seleccione Elegir archivo y, a continuación, seleccione el archivo .cer que copió en el equipo. Seleccione Aceptar.

Adición del certificado SPWFM a entidades raíz de confianza

1. En el servidor central de Administración, haga clic con el botón derecho en el archivo de .cer del certificado SPWFM y elija Instalar certificado.

2. Con el Asistente para importación de certificados, elija Máquina > local Coloque todos los certificados en el siguiente almacén > Examinar > entidades de certificación raíz de confianza.

   

Importante

Debe repetir este paso de importación de certificados en todos los servidores de SharePoint de la granja de servidores.

Validación del punto de conexión Administrador de flujos de trabajo de SharePoint

1. Compruebe primero desde el servidor SPWFM. a. Seleccione Sitio de administración de flujos de trabajo. En el panel derecho, elija Examinar *12290 (https). b. Se abre un explorador; vaya a https://localhost:12290. Si permitió conexiones a través de HTTP durante la instalación, tendrá un punto de conexión HTTP en el puerto 12291 y un punto de conexión HTTPS en el puerto 12290. c. Pruebe los puntos de conexión http y https.

2. Compruebe desde los servidores de SharePoint. En última instancia, son los servidores de SharePoint los que deben conectarse al punto de conexión SPWFM, por lo que también debe confirmar que hay conectividad desde allí.
   a. Inicie sesión en uno de los servidores de SharePoint con la cuenta de ejecución de SPWFM o como un usuario que sea miembro de AdminGroup. Consulte el paso anterior "Comprobar la cuenta de servicio y el grupo de administración".
   b. Vaya al FQDN del punto de conexión SPWFM.

   Por ejemplo:

   https://apps.contoso.local :12290/.local.contosohttps:// apps. El resultado debe tener este aspecto:

   

Registro del servicio

1. Inicie sesión en cualquier servidor de SharePoint como la cuenta de ejecución de SPWFM o como un usuario que sea miembro de AdminGroup. Consulte el paso anterior "Comprobar la cuenta de servicio y el grupo de administración".

2. Ejecute el comando Register-SPWorkflowService para registrar el servicio de flujo de trabajo en SharePoint. Necesita el URI del punto de conexión SPWFM, el nombre del ámbito que recopiló en el paso "Comprobar el ámbito" anterior, y tendrá que incluir el parámetro -Force.

   Ejemplo:

   Register-SPWorkflowService -SPSite http://www.contoso.local -WorkflowHostUri https://spwfm.contoso.local:12290 -ScopeName SharePoint2013 -Force
   

Validar la configuración

1. Compruebe el proxy de aplicación de servicio de flujo de trabajo en Administración > central Administrar aplicaciones de servicio. Seleccione el vínculo Application Proxy servicio de flujo de trabajo. Debe mostrarse como conectado.

   Ejemplo:

   

2. Pruebe un nuevo flujo de trabajo.

   a. Inicie sesión en un equipo cliente y abra SharePoint Designer.
   b. Abra uno de los sitios y vaya a Flujos de trabajo.
   c. Cree un nuevo flujo de trabajo y asegúrese de que puede ver el "Flujo de trabajo de SharePoint 2013" en la lista de plataformas entre las que elegir.
   d. Cree un flujo de trabajo básico de "registro al historial" de la plataforma 2013 y pruebe para asegurarse de que se realiza correctamente.

3. Pruebe un flujo de trabajo antiguo.

   a. Busque una lista que tenga asignado un flujo de trabajo en la granja "antigua".
   b. Inicie una nueva instancia de ese flujo de trabajo y compruebe que funciona. Si incluyó la base de datos de aplicaciones de App Management Service durante la migración y ejecutó Register-SPWorkflowService con el nombre correcto de "ámbito", los flujos de trabajo de la granja antigua deberían seguir funcionando.