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.

Docker/Podman

Para completar el proceso de migración, debes utilizar un cliente Docker o Podman que se haya autenticado con el registro privado. Esto permite que los migradores se ejecuten en las bases de datos MSI, haciéndolos compatibles con las bases de datos de Automation Suite.

Docker

• Para descargar los binarios de Docker, consulta la documentación oficial de Instalar el motor de Docker.
• Para autenticar el registro de Docker, consulta la documentación oficial de inicio de sesión de Docker. Como alternativa, puedes utilizar el siguiente comando sustituyendo las credenciales de muestra por tus credenciales de registro reales:

  docker login my.registry.io:443 --username "admin" --password "secret"

Podman

• Para descargar los binarios de Podman, consulta las Instrucciones de instalación oficiales de Podman.
• Para autenticarte en el registro de Podman, consulta la documentación oficial de inicio de sesión de Podman. Como alternativa, puedes utilizar el siguiente comando sustituyendo las credenciales de muestra por tus credenciales de registro reales:

  podman login my.registry.io:443 --username "admin" --password "secret"

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.

cd <AS install directory>
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.

Administrator group configuration requirement

Before starting the migration, you must add the Administrator group in every tenant.

If you are performing an organization merge and the Administrator group is not added in all tenants, you can lock yourself out of the Orchestrator instance after the merge completes.

Adding the Administrator group in each tenant ensures that administrative access is preserved throughout the migration and merge process.