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.

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
./bin/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\`""