Requisitos previos de migración

Antes de iniciar la migración, asegúrese de cumplir los siguientes requisitos previos:

.NET Runtime 6.0

Se requiere .NET Runtime 6.0 o posterior para ejecutar la herramienta UiPath.OrganizationMigrationApp. Debe descargarlo e instalarlo antes de ejecutar UiPath.OrganizationMigrationApp.

Linux

Si .NET Runtime 6.0 o posterior no está presente, descargue e instale .NET Runtime para Linux antes de usar UiPath.OrganizationMigrationApp.

Para instalar .NET Runtime 6.0 en RHEL, ejecute el siguiente comando:

sudo yum install dotnet-sdk-6.0 -y

Ventanas

La herramienta UiPath.OrganizationMigrationApp requiere .NET Runtime 6.0 como mínimo. Si .NET Runtime 6.0 y posteriores no están presentes, descargue e instale .NET Runtime 6.0 para Windows antes de usar UiPath.OrganizationMigrationApp.

Configuración de creación de depósitos de Orchestrator

Para garantizar que los depósitos de Orchestrator se creen automáticamente con la política CORS correcta, debes ejecutar el siguiente comando. El comando requiere que la utilidad jq esté instalada en tu máquina.

rm -f values.json && rm -f appsettings.json
kubectl -n uipath get cm orchestrator-customconfig -o jsonpath='{.data.values\.json}' | jq '.' > values.json
jq '.AppSettings' values.json > appsettings.json
jq '.["Storage.CreateBucket.OnTenantCreation.Enabled"] = "true"' appsettings.json > temp.json && mv -f temp.json appsettings.json
uipathctl config orchestrator update-config --app-settings appsettings.json

Para instalar jq, utiliza una de las siguientes opciones:

• Opción 1: ejecuta el siguiente comando:

  yum install -y epel-release yum install -y jq

• Opción 2: ejecuta los siguientes comandos:

  shell
  curl https://download-ib01.fedoraproject.org/pub/epel/7/x86_64/Packages/j/jq-1.6-2.el7.x86_64.rpm --output /tmp/jq-1.6-2.el7.x86_64.rpm
  yum localinstall /tmp/jq-1.6-2.el7.x86_64.rpm

Advertencia: Si no se habilita la configuración de Orchestrator que garantiza que los depósitos se crean automáticamente con la política CORS correcta, se producen problemas con la descarga desde los depósitos de almacenamiento, que debes solucionar realizando actualizaciones manuales en la política CORS.

Para confirmar que la configuración se ha habilitado, ejecuta el siguiente comando:

kubectl -n uipath get cm orchestrator-customconfig -o jsonpath='{.data.values\.json}' | jq

Si la configuración se ha habilitado, el comando debe devolver la siguiente respuesta:

{
  "AppSettings": {
    "Storage.CreateBucket.OnTenantCreation.Enabled": "true"
  }
}

UiPath.OrganizationMigrationApp

La herramienta UiPath.OrganizationMigrationApp le ayuda a realizar operaciones como mover los datos de identidad de todos los tenants de forma independiente a Automation Suite y fusionar organizaciones.

Para descargar UiPath.OrganizationMigrationApp, consulta Descargar los paquetes de instalación.

Para ver qué versión de UiPath.OrganizationMigrationApp es compatible con tu entorno, consulta Matriz de compatibilidad.

Herramienta para administrar Microsoft SQL Server

Debe descargar e instalar SQL Server Management Studio (SSMS) o una herramienta similar para administrar Microsoft SQL Server. Esta herramienta le ayuda a restaurar la base de datos de Orchestrator en la instancia de SQL Server de Automation Suite o en una instancia de SQL Server diferente.

1. Descarga e instala SQL Server Management Studio.

2. Inicie sesión en el servidor SQL independiente con la cadena de conexión SQL independiente.

3. Abre el puerto 1433 para la base de datos de origen y de destino.

Reglas de escape de caracteres especiales para las contraseñas de la cadena de conexión

En la mayoría de los casos, las contraseñas de conexión se encapsulan dentro de una única comillas ('). Sin embargo, cuando la contraseña incluye caracteres especiales como ` o $, requiere un enfoque diferente.

En estos casos, la contraseña debe formatearse como \`"<password>\`", reemplazando <password> por la contraseña real. Además, también debes cumplir las reglas de escape como se detalla en la siguiente tabla:

Formato original en ADUC	Formato de escape en la cadena PowerShell
cn=James $ Smith	"cn=James `$ Smith"
cn=Sally Wilson + Jones	"cn=Sally Wilson \+ Jones"
cn=William O'Brian	"cn=William O'Brian"
cn=William O`Brian	"cn=William O``Brian"
cn=Richard #West	"cn=Richard #West"
cn=Roy Johnson$	"cn=Roy Johnson$"

Ejemplo

Supongamos que la contraseña original es 7'8:<=XMe$y[@vC?_4ZeY8c-~y'W!1dU4gnczuf'/p>j<I. Al adherirse a las reglas de escape de caracteres especiales, se convierte en: Password=\`"7'8:<=XMe`$y[@vC?_4ZeY8c-~y'W!1dU4```gnczuf'/p>```j<I\`".

El comando completo, con la contraseña configurada en la cadena de conexión de destino, se ve de la siguiente manera:

./UiPath.OrganizationMigrationApp.exe migrate -a -m -s "Server=tcp:abc.com,1433;Initial Catalog=UiPath_20230531;Persist Security Info=False;User ID=username;Password=asiodhyf;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;" -d "Server=tcp:cde.net,1433;Initial Catalog=AutomationSuite_Platform;Persist Security Info=False;User Id=[e-mail];Password=\`"7'8:<=XMe`$y[@vC?_4ZeY8c-~y'W!1dU4```gnczuf'/p>```j<I\`""

Nota: asegúrate de que el comando solo se ejecute en una máquina que tenga acceso autorizado a la base de datos RDS.

Requisito de configuración del grupo de administradores

Antes de iniciar la migración, debes añadir el grupo Administrador en cada tenant.

Si estás realizando una fusión de organizaciones y el grupo Administrador no se añade a todos los tenants, puedes bloquearte la instancia de Orchestrator después de que se complete la fusión.

Añadir el grupo Administrador en cada tenant garantiza que el acceso administrativo se conserve durante todo el proceso de migración y fusión.