Mise à jour des informations d’identification

Mettez à jour les informations d’identification stockées dans Automation Suite sur EKS/AKS.

Directives

Pour mettre à jour les informations d'identification des différents composants d' Automation Suite , procédez comme suit :

1. Générez le fichier input.json .
2. Fournissez les nouvelles informations d’identification pour les composants concernés dans le input.json, tel que décrit dans la section dédiée de chaque composant.
3. Exécutez l’interface de ligne de commande uipathctl, tel que décrit dans la section dédiée de chaque composant.

Génération du fichier input.json

Générez le dernier fichier input.json comme suit :

• R: Pour obtenir la dernière révision de votre fichier input.json , exécutez la commande suivante:

  uipathctl manifest get-revision
  

• B: pour répertorier tous les fichiers input.json antérieurs et déterminer celui que vous souhaitez choisir, exécutez la commande suivante:

  uipathctl manifest list-revisions
  

Mise à jour des chaînes de connexion SQL

Il existe plusieurs scénarios dans lesquels vous souhaiterez peut-être mettre à jour la chaîne de connexion utilisée par les produits Automation Suite pour se connecter à la base de données SQL, tels que les suivants :

• Lors de la rotation périodique du mot de passe utilisé pour se connecter à la base de données, à des fins de sécurité et de conformité

• Lors de la modification du nom de domaine complet du serveur SQL

• Lors de la migration de la base de données vers un autre serveur SQL à des fins de maintenance

• Lors de l'ajout, de la modification ou de la suppression d'un ou plusieurs attributs de connexion, tels que MultiSubnetFailover

• Lorsque vous passez de l'authentification de base à l'authentification intégrée à l'aide de Kerberos et AD

  Important :

  Les produits d'Automation Suite ne créent pas de tables ou de schémas au moment de la mise à jour de la chaîne de connexion à la base de données SQL. Assurez-vous que votre nouvelle chaîne de connexion fait référence à la même base de données que vous utilisez actuellement.

  Pour éviter les temps d'arrêt pendant le processus de mise à jour, assurez-vous que votre chaîne de connexion actuelle est valide au moment du processus de mise à jour. Vous pouvez révoquer votre ancienne chaîne de connexion après la mise à jour.

Mise à jour des chaînes de connexion des produits installés

Pour mettre à jour la chaîne de connexion des produits installés dans Automation Suite, connectez-vous à l'un des nœuds du serveur et effectuez les opérations suivantes.

1. Générez le fichier input.json .
2. Fournissez les nouvelles chaînes de connexion pour les produits installés dans le input.json.
3. Exécutez la commande uipathctl manifest apply.

Fournir les nouvelles chaînes de connexion pour les produits installés

Il existe deux façons de fournir les chaînes de connexion pour les produits s'exécutant dans Automation Suite :

• R : Fournissez un modèle de chaîne de connexion qui sera commun à tous les produits exécutés dans Automation Suite. Cette approche supposera les noms de base de données par défaut pour tous les produits.
• B : fournissez des chaînes de connexion spécifiques à chaque produit.

Important :

Assurez-vous d'échapper aux mots de passe NET, JDBC ou ODBC comme suit :

• pour NET : ajoutez ' au début et à la fin du mot de passe, puis doublez tout autre '.
• pour JDBC/ODBC : ajoutez { au début du mot de passe et } à la fin, et doublez tout autre }. Ne doublez pas {.

Si vous définissez TrustServerCertificate=False, vous devrez peut-être fournir un certificat CA supplémentaire pour SQL Server. Ceci est requis si le certificat SQL Server est auto-signé ou signé par une autorité de certification interne. Pour plus de détails, consultez Mise à jour des certificats CA.

Pour encoder ou décoder des chaînes Base64 à l'aide de PowerShell, vous pouvez utiliser les commandes suivantes :

• décoder la chaîne Base64 : [System.Text.Encoding]::Default.GetString([System.Convert]::FromBase64String('<base64_string>'))
• encoder la chaîne Base64 : [System.Convert]::ToBase64String([System.Text.Encoding]::Default.GetBytes('<plain_text>'))

A : Fournir une chaîne de connexion commune pour tous les produits

Tous les produits exécutés dans Automation Suite font référence à un modèle de chaîne de connexion commun. Un cas d'utilisation pour choisir cette méthode serait lorsque vous souhaitez modifier le mot de passe pour tous les produits à la fois. Notez que, dans ce cas, le mot de passe sera le même pour tous les produits.

Dans ce scénario, les noms de base de données de tous les produits doivent être ceux par défaut, comme requis par Automation Suite. Si les noms de base de données que vous avez configurés ne répondent pas aux exigences d'Automation Suite, passez à l'étape suivante.

Astuce :

Check the list of databases and their default names in SQL database.

Le tableau suivant explique le format de modèle accepté par les services produit :

Paramètre	Description	Produits
sql_connection_string_template	Chaîne de connexion ADO.NET complète où le nom du catalogue est défini sur DB_NAME_PLACEHOLDER. Le programme d'installation remplacera cet espace réservé par les noms de base de données par défaut pour les services de la suite installée.	Plate-forme Orchestrator Robots Automation Suite Test Manager Automation Hub Automation Ops Insights Data Service Process Mining ECS Passerelle LLM Observabilité LLM Solutions Agents
sql_connection_string_template_jdbc	Chaîne de connexion JDBC complète où le nom de la base de données est défini sur DB_NAME_PLACEHOLDER. Le programme d'installation remplacera cet espace réservé par les noms de base de données par défaut pour les services de la suite installée.	AI Center
sql_connection_string_template_odbc	Chaîne de connexion ODBC complète où le nom de la base de données est défini sur DB_NAME_PLACEHOLDER. Le programme d'installation remplacera cet espace réservé par les noms de base de données par défaut pour les services de la suite installée.	Document Understanding Apps
sql_connection_string_template_sqlalchemy_pyodbc	Chaîne de connexion PYODBC alchemy SQL complète où le nom de la base de données est défini sur DB_NAME_PLACEHOLDER. Le programme d'installation remplacera cet espace réservé par les noms de base de données par défaut pour les services de la suite installée.	Document Understanding
postgresql_connection_string_template_sqlalchemy_pyodbc	Chaîne de connexion SQL alchemy PsyCoPG2 où le nom de la base de données est défini sur DB_NAME_PLACEHOLDER. Le programme d'installation remplacera cet espace réservé par les noms de base de données par défaut pour les services de la suite installée.	Process Mining
postgresql_connection_string_template_sqlalchemy_asyncpg	Chaîne de connexion PostgreSQL complète où le nom de la base de données est défini sur DB_NAME_PLACEHOLDER. Le programme d'installation remplacera cet espace réservé par les noms de base de données par défaut pour les services de la suite installée.	À propos d’Autopilot for Developers

exemple sql_connection_string_template

Server=tcp:sfdev1804627-c83f074b-sql.database.windows.net:1433;Initial Catalog=DB_NAME_PLACEHOLDER;Persist Security Info=False;User Id=testadmin;Password=***;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;Max Pool Size=100;

exemple sql_connection_string_template_jdbc

jdbc:sqlserver://sfdev1804627-c83f074b-sql.database.windows.net:1433;database=DB_NAME_PLACEHOLDER;user=testadmin;password=***;encrypt=true;trustServerCertificate=false;Connection Timeout=30;hostNameInCertificate=sfdev1804627-c83f074b-sql.database.windows.net"

exemple sql_connection_string_template_odbc

SERVER=sfdev1804627-c83f074b-sql.database.windows.net,1433;DATABASE=DB_NAME_PLACEHOLDER;DRIVER={ODBC Driver 17 for SQL Server};UID=testadmin;PWD=***;MultipleActiveResultSets=False;Encrypt=YES;TrustServerCertificate=NO;Connection Timeout=30;"

sql_connection_string_template_sqlalchemy_pyodbc example

"mssql+pyodbc://testadmin%40sfdev4515230-sql.database.windows.net:<password>@sfdev4515230-sql.database.windows.net:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"

exemple post-gresql_connection_string_template_sqlalchemy_pyodbc

"postgresql+psycopg2://testadmin:<password>@sfdev8454496-postgresql.postgres.database.azure.com:5432/DB_NAME_PLACEHOLDER"

Remarque :

Mettez à jour le input.json avec le nouveau modèle de chaîne de connexion que vous souhaitez mettre à jour.

B : Fournir des chaînes de connexion spécifiques à chaque produit

Plate-forme

Le service Platform fournit des capacités administratives telles que la gestion de l'organisation et des locataires, la gestion des licences, la gestion des utilisateurs, etc. Le service Platform est activé par défaut et ne peut pas être supprimé. Son nom de base de données par défaut est AutomationSuite_Platform .

Pour fournir une chaîne de connexion au service Platform, ajoutez ou mettez à jour la section suivante dans le fichier input.json :

"platform": {
  "sql_connection_str": "***" // dotnet connection string 
}

Orchestrator

Le nom de base de données par défaut pour Orchestrator est AutomationSuite_Orchestrator .

Pour fournir une chaîne de connexion au service Orchestrator, ajoutez ou mettez à jour la section suivante dans le fichier input.json :

"orchestrator": {
  "sql_connection_str": "***" // dotnet connection string
}

Robots Automation Suite

Les Robots Automation Suite et Orchestrator partagent la même base de données par défaut. Le nom de la base de données est AutomationSuite_Orchestrator .

Pour fournir une chaîne de connexion aux Robots Automation Suite, ajoutez ou mettez à jour la section suivante dans le fichier input.json :

"asrobots": {
  "sql_connection_str": "***" // dotnet connection string
}

Automation Hub

Le nom de la base de données par défaut pour Automation Hub est AutomationSuite_Automation_Hub .

Pour fournir une chaîne de connexion au service Automation Suite, ajoutez ou mettez à jour la section suivante dans le fichier input.json :

"automation_hub": {
  "sql_connection_str": "***" // dotnet connection string
}

Automation Ops

Le nom de la base de données par défaut pour Automation Ops est AutomationSuite_Platform .

Pour fournir une chaîne de connexion au service Automation Ops, ajoutez ou mettez à jour la section suivante dans le fichier input.json :

"automation_ops": {
  "sql_connection_str": "***" // dotnet connection string
}

AI Center

Le nom de la base de données par défaut pour AI Center est AutomationSuite_AICenter .

Pour fournir une chaîne de connexion au service AI Center, ajoutez ou mettez à jour la section suivante dans le fichier input.json :

"aicenter": {
  "sql_connection_str": "***" // jdbc connection string
}

Agents

Le nom de base de données par défaut des agents est AutomationSuite_Agents.

Pour fournir une chaîne de connexion au service AI Center, ajoutez ou mettez à jour la section suivante dans le fichier input.json :

"agents": {
    "sql_connection_str": "" //Optional and only require to override the default database name - dotnet connection string
  }

Apps

Le nom de base de données par défaut pour Apps est AutomationSuite_Apps.

Pour fournir une chaîne de connexion au service Apps, ajoutez ou mettez à jour la section suivante dans le fichier input.json :

"apps": {
  "sql_connection_str": "***" // odbc connection string
}

Data Service

Le nom de base de données par défaut pour Data Service est AutomationSuite_DataService .

Pour fournir une chaîne de connexion au service Data Service, ajoutez ou mettez à jour la section suivante dans le fichier input.json :

"dataservice": {
  "sql_connection_str": "***" // dotnet connection string
}

Document Understanding

Le nom de base de données par défaut pour Document Understanding est AutomationSuite_DU_Datamanager .

Pour fournir une chaîne de connexion au service Document Understanding, ajoutez ou mettez à jour la section suivante dans le fichier input.json :

"documentunderstanding": { 
"enabled": true,
"sql_connection_str": "***" // dotnet connection string,
"datamanager": {
 "sql_connection_str": "***" // odbc connection string
 "pyodbc_sql_connection_str": "***" // python sql connection string
 }
}

Insights

Le nom de la base de données par défaut pour Insights est AutomationSuite_Insights .

Pour fournir une chaîne de connexion au service Insights, ajoutez ou mettez à jour la section suivante dans le fichier input.json :

"insights": {
  "sql_connection_str": "***" // dotnet connection string
}

Process Mining

Le nom de la base de données par défaut pour Process Mining est AutomationSuite_ProcessMining_Metadata .

Pour fournir une chaîne de connexion au service Process Mining, ajoutez ou mettez à jour la section suivante dans le fichier input.json :

"process_mining": {
    "enabled": true,
    "sql_connection_str": "***", // dotnet connection string
    "airflow": {
        "metadata_db_connection_str": ""
    },
    "warehouse": {
        "sql_connection_str": "",
        "master_sql_connection_str": "",
        "sqlalchemy_pyodbc_sql_connection_str": ""
    }
}

Test Manager

Le nom de base de données par défaut de Test Manager est AutomationSuite_Test_Manager .

Pour fournir une chaîne de connexion au service Test Manager, ajoutez ou mettez à jour la section suivante dans le fichier input.json :

"test_manager": {
  "sql_connection_str": "***" // dotnet connection string
}

Integration Services

Le nom de base de données par défaut pour Integration Services est AutomationSuite_Integration_Services.

Pour fournir une chaîne de connexion, ajoutez ou mettez à jour la section suivante dans le fichier input.json :

"integrationservices": {
  "sql_connection_str": "***" // dotnet connection string
}

Studio Web

Le nom de base de données par défaut pour Studio Web est AutomationSuite_StudioWeb.

Pour fournir une chaîne de connexion, ajoutez ou mettez à jour la section suivante dans le fichier input.json :

"studioweb": {
  "sql_connection_str": "***" // dotnet connection string
}

Service d’ancrage dans le contexte

Le nom de base de données par défaut pour l’ancrage dans le contexte est AutomationSuite_ECS et AutomationSuite_ECSVector.

Pour fournir une chaîne de connexion, ajoutez ou mettez à jour la section suivante dans le fichier input.json :

"ecs": {
      "enabled": true, //Set to "false" to disable
      "sql_connection_str": "", //Optional and only required to override the default database name - dotnet connection string
      "sql_vector_connection_str": "", //Optional and only required to override the default database name - dotnet connection string
    }

Passerelle LLM

Le nom de base de données par défaut de la passerelle LLM est AutomationSuite_LLMGateway.

Pour fournir une chaîne de connexion, ajoutez ou mettez à jour la section suivante dans le fichier input.json :

"llmgateway": {
      "enabled": true, //Set to "false" to disable
      "sql_connection_str": "" //Optional and only required to override the default database name - dotnet connection string
    }

Observabilité LLM

Le nom de base de données par défaut pour l'Observabilité LLM est AutomationSuite_Llmops.

Pour fournir une chaîne de connexion, ajoutez ou mettez à jour la section suivante dans le fichier input.json :

"llmobservability": {
      "enabled": true, //Set to "false" to disable
      "sql_connection_str": "" //Optional and only required to override the default database name - dotnet connection string
    }

Solutions

Le nom de base de données par défaut de la solution d'automatisation est AutomationSuite_AutomationSolutions.

Pour fournir une chaîne de connexion, ajoutez ou mettez à jour la section suivante dans le fichier input.json :

 "automationsolutions": {
      "enabled": true, //Set to "false" to disable
      "sql_connection_str": "", //Optional and only required to override the default database name - dotnet connection string
    }

Maestro

Le nom de base de données par défaut de Maestro est AutomationSuite_Maestro.

Pour fournir une chaîne de connexion, ajoutez ou mettez à jour la section suivante dans le fichier input.json :

"maestro": {
    "enabled": true, //Set to "false" to disable
    "sql_connection_str": "" //Optional and only required to override the default database name - dotnet connection string
  }

Temporel en tant que service (TaaS)

Les noms de base de données par défaut pour SaaS sont les suivants :

• pour le magasin de persistance : AutomationSuite_Taas
• pour le magasin de visibilité : AutomationSuite_Taas_Visibility

Pour fournir une chaîne de connexion, ajoutez ou mettez à jour la section suivante dans le fichier input.json :

"taas": {
    "enabled": true, //Set to "false" to disable
    "temporal": {
      "postgresql_connection_str": "", //Optional and only required to override the default database name - postgresql connection string
      "postgresql_visibility_connection_str": "" //Optional and only required to override the default database name - postgresql connection string
    }
  }

À propos d’Autopilot for Developers

Le nom de base de données par défaut d’Autopilot for Developers est AutomationSuite_A4D.

Pour fournir une chaîne de connexion, ajoutez ou mettez à jour la section suivante dans le fichier input.json :

"a4d": {
  "enabled": true, //Set to "false" to disable
  "sqlalchemy_asyncpg_postgresql_connection_str": "" //Optional and only require to override the default database name - postgresql connection string
  }

Exécution du programme d'installation uipathctl

Pour finaliser la mise à jour, exécutez la commande suivante:

uipathctl manifest apply input.json --versions versions.json

Mise à jour des informations d'identification Redis

Fournir les nouveaux identifiants pour Redis

Mettez à jour la section suivante dans le fichier input.json avec le nouveau mot de passe et/ou nom d'hôte :

"fabric": {
  "redis": {
    "hostname": "new_hostname",
    "password": "new_password",
    "port": 6380,
    "tls": true
  }

Exécution du programme d'installation uipathctl

Pour finaliser la mise à jour des informations d’identification Redis, exécutez la commande suivante:

uipathctl manifest apply input.json --only redis --versions versions.json

Remarque :

Vous pouvez utiliser l'indicateur de simulation avec uipathctl pour imprimer le résultat de la commande sans l'appliquer.

Mise à jour des informations d'identification de l'objectstore

Mettez à jour la section suivante dans le fichier input.json avec les nouvelles clés_access_key, secret_key ou account_key et account_name :

"external_object_storage": {
  "enabled": false, // <true/false>
  "create_bucket": true, // <true/false>
  "storage_type": "s3", // <s3,azure,aws>
  "fqdn": "",  // <needed in case of aws non instance profile>
  "port": 443, // <needed in case of aws non instance profile>
  "region": "", 
  "access_key": "", // <needed in case of aws non instance profile>
  "secret_key": "", // <needed in case of aws non instance profile>
  "use_managed_identity": false, // <true/false>
  "bucket_name_prefix": "",
  "bucket_name_suffix": "",
  "account_key": "", // <needed only when using non managed identity>
  "account_name": "",
  "azure_fqdn_suffix": "core.windows.net",
  "client_id": "" // <optional field in case of managed identity>
},

Exécution du programme d'installation uipathctl

Pour terminer la mise à jour des informations d'identification du magasin d'objets, exécutez la commande suivante:

uipathctl manifest apply input.json --versions versions.json

Remarque :

Vous pouvez utiliser l'indicateur de simulation avec uipathctl pour imprimer le résultat de la commande sans l'appliquer.

Mise à jour des informations d’identification du registre

Lorsque le registre de conteneurs utilisé nécessite une authentification pour pouvoir extraire des images, les pods doivent utiliser une clé secrète nommée uipathpullsecret.

Afin de mettre à jour uipathpullsecret, procédez comme suit:

1. Mettez à jour la section de registre du fichier input.json :

     "registries": { 
       "docker": { 
         "url": "yourContainerRegistryUrl", 
         "username": "username", 
         "password": "newpassword" 
       }, 
       "helm": { 
         "url": "yourContainerRegistryUrl", 
         "username": "username", 
         "password": "newpassword" 
       } 
     }
   

2. Supprimez le uipathpullsecret existant :

   kubectl delete secret uipathpullsecret -n <uipath>
   kubectl delete secret uipathpullsecret -n <uipath-installer>
   

3. Relancez la commande d’installation :

   uipathctl manifest apply input.json --versions versions.json