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 no dispones de .NET Runtime 6.0 o posterior, descarga e instala .NET Runtime para Linux antes de utilizar UiPath.OrganizationMigrationApp.

Para instalar.NET Runtime 6.0 en RHEL, ejecuta 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 no dispones de .NET Runtime 6.0 o superior, descarga e instala .NET Runtime 6.0 para Windows antes de utilizar 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 creen 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\`""

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.

Script de migración de Test Manager

El script de migración de Test Manager (testmanager_migrator.sh) te ayuda a realizar múltiples operaciones automáticas para migrar varias configuraciones y archivos, como:

• Ejecuta operaciones kubectl , como actualizar secretos y mapas de configuraciones.
• Realiza sincronizaciones de ArgoCD a través de la CLI.
• Anula los ajustes de configuración y reinicia las implementaciones.
• Añade archivos de almacenamiento al almacén de objetos de Ceph.
• Restaure y actualice DataEncryptionKey en los secretos de Kubernetes desde la instancia MSI.
• Sincroniza Test Manager en ArgoCD.
• Migra carpetas o archivos de un almacén de archivos de Windows al almacén de objetos de destino, creando la jerarquía de directorios necesaria en el depósito definido por los secretos de Kubernetes.

Requisitos del entorno para ejecutar el script de migración de Test Manager

Para ejecutar con éxito el script de migración de Test Manager, debes asegurarte de cumplir los siguientes requisitos del entorno:

• Configura kubectl con una conexión al clúster de Automation Suite.
  Importante:

  Asegúrate de que kubeconfig esté establecido como una variable de entorno.

• Instala la utilidad jq utilizando el siguiente comando yum install jq.
• Instala la CLI argocd . Consulta Instalar el CD de Argo para obtener más información.
• Instala Rclone. Consulta la documentación de RClone para obtener más información.
  Nota:

  La versión mínima necesaria para Rclone es 1.56.0.

Nota:

Si tu identidad se gestiona en Azure, asegúrate de ejecutar el script utilizando una máquina de Azure.

Comandos comunes del script de migración de Test Manager

Comprueba los siguientes comandos que puedes ejecutar utilizando el script de migración de Test Manager:

 ./testmanager_migrator.sh -d -y \
  -k \"enc key value\" \
  -s blobstoragefolder
    -k|--encryption-key
        The value of the encryption key that will override the key generated during installation.
    -s|--storage-folder
        The location of the storage folder on the local disk.
    -is-|--use-incluster-storage
        Use in cluster Ceph object store.
    -d|--dry-run
        Do not update Test Manager with the new values
    -y|--accept-all
        Do not prompt for confirmation of actions