Dans le cadre de la documentation associée à ce produit, nous nous efforçons d’utiliser un langage exempt de préjugés. Dans cet ensemble de documents, le langage exempt de discrimination renvoie à une langue qui exclut la discrimination en fonction de l’âge, des handicaps, du genre, de l’appartenance raciale de l’identité ethnique, de l’orientation sexuelle, de la situation socio-économique et de l’intersectionnalité. Des exceptions peuvent s’appliquer dans les documents si le langage est codé en dur dans les interfaces utilisateurs du produit logiciel, si le langage utilisé est basé sur la documentation RFP ou si le langage utilisé provient d’un produit tiers référencé. Découvrez comment Cisco utilise le langage inclusif.
Cisco a traduit ce document en traduction automatisée vérifiée par une personne dans le cadre d’un service mondial permettant à nos utilisateurs d’obtenir le contenu d’assistance dans leur propre langue. Il convient cependant de noter que même la meilleure traduction automatisée ne sera pas aussi précise que celle fournie par un traducteur professionnel.
Ce document décrit les étapes de configuration de Contact Center Enterprise Orchestration.
Cisco vous recommande de prendre connaissance des rubriques suivantes :
Les informations contenues dans ce document sont basées sur les versions de logiciel suivantes :
Remarque : dans le document, CUIC fait référence à la fois aux installations co-résidentes et aux installations autonomes de CUIC, Live Data (LD) et Identity Server (IDS). Ce composant n'est référencé que lorsqu'une instruction est spécifique à un sous-composant.
The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.
UCCE/PCCE 12.5(1) (l'une ou l'autre)
UCCE/PCCE 12.6(1)
Version de Cloud Connect : 12.6(1)
Finesse, CUIC, VVB : 12.5(1)
Finesse, CUIC, VVB : 12.6(1)
CVP 12.5(1)
CVP 12.6(1)
Remarques spéciales sur les mises à niveau de Cloud Connect.
Remarque : lorsque vous mettez à niveau Cloud Connect de 12.5 à 12.6, il est obligatoire d'installer d'abord ucos.keymanagement.cop.sgn. La mise à niveau échoue si elle n'est pas effectuée.
Remarque : lorsque vous mettez à niveau Cloud Connect de 12.5 à 12.6, il est obligatoire d'augmenter le disque de 146 Go à 246 Go. Si cette étape a été manquée avant la mise à niveau, procédez comme suit :
Étape 1 : Arrêtez le serveur Cloud Connect.
Étape 2 : Développez le disque dans vSphere à 246 Go.
Étape 3 : Démarrez le serveur Cloud Connect.
VOS développe automatiquement les partitions. Cela garantit que les mises à jour téléchargées ne provoquent pas de condition de manque d'espace sur la partition commune.
L'orchestration CCE est prise en charge à partir de Cloud Connect 12.6(1).
Le serveur Cloud Connect version 12.6 (1) prend en charge l'orchestration dans les scénarios suivants :
Remarque : l'ID CCO utilisé pour générer les clés API doit obligatoirement disposer des droits de mise à niveau logicielle nécessaires. L'ID CCO que vous utilisez doit disposer d'un abonnement SWSS (contrat de service) ou Flex valide pour bénéficier de l'autorisation nécessaire.
Remarque : vous devez vous connecter à https://devhub-download.cisco.com/console une fois tous les six mois pour prolonger la validité de la clé API.
1. Exécutez la commande utils image-repository set pour configurer le téléchargement artificiel comme indiqué dans l'image.
a. Fournissez l'URL de l'objet, https://devhub-download.cisco.com/binaries.
b. Fournissez le nom du référentiel d'objets, ent-platform-release-external.
c. Collez la clé API que vous avez générée. La clé API est indiquée sous forme d'astérisques pour des raisons de sécurité.
2. Exécutez la commande utils image-repository show pour afficher l'URL d'usine, le nom du référentiel et la clé d'API configurés dans le serveur Cloud Connect, comme indiqué dans l'image.
Remarque : avant d'exécuter la commande utils image-repository set sur l'interface de ligne de commande, accédez à l'URL du CLUF (https://software.cisco.com/download/eula) et acceptez le CLUF. Si ce n'est pas le cas, la commande utils image-repository set échoue avec une erreur : L'ID CCO utilisé pour générer la clé API n'est pas conforme au Contrat de licence utilisateur final, veuillez utiliser un ID CCO valide.
Consultez l'ID de bogue Cisco CSCvy78680 pour plus d'informations.
Remarque : ces deux commandes ne peuvent être exécutées qu'à partir du noeud éditeur du serveur Cloud Connect.
La réplication de la configuration du référentiel d'images se produit automatiquement du noeud éditeur au noeud abonné lorsque la commande utils image-repository set est exécutée avec des résultats positifs sur le noeud éditeur.
Remarque : l'interface de ligne de commande du jeu de référentiels d'images utils peut être utilisée à tout moment pour modifier l'option d'exportation du logiciel restreint ou non restreint dans le déploiement.
Redémarrez le serveur Cloud Connect pour appliquer le nettoyage et le téléchargement des logiciels restreints et non restreints. Le téléchargement démarre 10 minutes après le redémarrage.
Remarque : Remarques sur les opérations d'artifice :
Une fois les détails de l'artefact correctement configurés, les artefacts sont téléchargés localement sur le serveur Cloud Connect à 02h00, heure du serveur.
Les opérations d'orchestration, telles que l'installation de correctifs, la restauration ou la mise à niveau, ne peuvent être effectuées qu'après le téléchargement des artefacts.
Si les artefacts doivent être téléchargés immédiatement après les étapes de configuration, le serveur Cloud Connect peut être redémarré et le téléchargement démarre 10 minutes après le redémarrage.
L'utilisation des commandes CLI liées à l'orchestration est bloquée au début du téléchargement et cette durée dépend du nombre d'artefacts à télécharger.
Remarque : si le serveur Cloud Connect nécessite un proxy pour accéder à Internet, alors ES3 ou supérieur doit être installé. Consultez le Guide d'installation et de mise à niveau UCCE pour plus de détails sur la configuration du proxy.
Conditions préalables:
Pour intégrer chaque système Finesse, CUIC, VVB, IDS, LD à un serveur Cloud Connect, exécutez la commande utils system onboard begin à partir du noeud éditeur du cluster VOS respectif, comme illustré dans l'image.
1. Fournissez le nom de domaine complet du noeud éditeur Cloud Connect.
2. Fournissez le nom d'utilisateur de l'application pour le serveur Cloud Connect.
3. Fournissez le mot de passe utilisateur de l'application pour le serveur Cloud Connect.
Remarque : si le système (cluster) est intégré au serveur Cloud Connect avec une erreur partielle, vérifiez la raison de l'erreur et corrigez-la. Exécutez ensuite la commande utils system onboard update au lieu de la commande utils system onboard begin.
Remarque : l'intégration est autorisée uniquement lorsque les noeuds de l'éditeur et de l'abonné du serveur Cloud Connect sont accessibles.
Remarque : si le serveur Cloud Connect est endommagé et redéployé avec une nouvelle installation, l'administrateur doit exécuter utils system onboard remove du noeud VOS, puis exécuter utils system onboard begin pour intégrer à nouveau les noeuds VOS.
Remarque : pour vérifier/rechercher le nom d'utilisateur de l'application des serveurs Cloud Connect, exécutez la commande run sql select * from applicationuser sur l'interface de ligne de commande des serveurs Cloud Connect.
Le processus intégré permet d'établir une connexion sans mot de passe entre le noeud Cloud Connect et les noeuds Windows. Pour intégrer les noeuds Windows au noeud de contrôle d'orchestration, procédez comme suit :
Configurez la clé publique SSH sur les noeuds Windows :
a. Accédez à %Users%\<logonUser>\.ssh\ et créez le fichier authorized_keys, s'il n'existe pas. (Le type d'extension authorized_keys est File et ne peut pas être modifié)
Remarque : l'utilisateur ne doit pas être supprimé du système et doit être un utilisateur de domaine avec des privilèges d'administration de domaine ou d'administration locale.
b. Ouvrez le navigateur et entrez l'URL de l'éditeur Cloud Connect : https://<CloudConnectIP>:8445/inventory/controlnode/key
c. Fournissez vos identifiants d'utilisateur de l'application Cloud Connect. Une fois l'authentification réussie, une réponse d'API REST récupère la clé SSH publique Cloud Connect.
d. Copiez cette valeur de clé publique dans le fichier authorized_keys dans %Users%\<logonUser>\.ssh\.
Un exemple de la sortie de l'URL est affiché. Dans la sortie, copiez seulement la partie qui commence par ssh-rsa et se termine par root@localhost dans le fichier authorized_keys.
{"category":"PUBLISHER","hostName":"cc125clouda.uclabservices.com","publicKey":"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDfJDl7RUZ/Umdflp5r3IqMaoV8WSrr7iLBOWindC0lGeGPYkprVW2xq6H6I8FuEjnBkrfEe8DUahVDVe783lFTb9nGdgRxAF7LR1MpKFOqOV9WRY8btYwRb0ZViO/GDupB2jBNaAj4M2EPPkKoC5OhcZrZ+4Zry/GEMd9uVwziyOh/nBxGuqg28euMiU2+G7m3qE3wo4zoJlvyOHkoM4tKzpiqqn0VdIRQ5xPhOl771AW6Rsiq4naG0f/hmVF347goavmF0O0lf1CbF4RfMoO1zxxlj+zi7RE1jl9aRMtzRmZC4uyIIQFtrZBbBbkzbk8dJo1u9A7Ds1rUcdEuc0Vv root@localhost"}
Le fichier authorized_keys de l'exemple est affiché.
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDfJDl7RUZ/Umdflp5r3IqMaoV8WSrr7iLBOWindC0lGeGPYkprVW2xq6H6I8FuEjnBkrfEe8DUahVDVe783lFTb9nGdgRxAF7LR1MpKFOqOV9WRY8btYwRb0ZViO/GDupB2jBNaAj4M2EPPkKoC5OhcZrZ+4Zry/GEMd9uVwziyOh/nBxGuqg28euMiU2+G7m3qE3wo4zoJlvyOHkoM4tKzpiqqn0VdIRQ5xPhOl771AW6Rsiq4naG0f/hmVF347goavmF0O0lf1CbF4RfMoO1zxxlj+zi7RE1jl9aRMtzRmZC4uyIIQFtrZBbBbkzbk8dJo1u9A7Ds1rUcdEuc0Vv root@localhost
e. Répétez les étapes b, c et d pour récupérer la clé publique de l'abonné Cloud Connect (si Cloud Connect est configuré en haute disponibilité).
Remarque : les clés publiques de l'éditeur et de l'abonné Cloud Connect doivent être copiées dans un seul fichier authorized_keys. Les entrées de l'éditeur et de l'abonné doivent figurer sur des lignes séparées et ne doivent pas comporter d'espace supplémentaire, de virgule ou de caractère spécial à la fin de la ligne.
f. Redémarrez les services OpenSSH :
- Serveur SSH OpenSSH
- OpenSSH Authentication Agent
Dépannez la connexion SSH en procédant comme suit :
a. Accédez à C:\ProgramData\ssh et ouvrez le fichier sshd_config dans un éditeur de texte.
b. Localisez la section de ce fichier qui commence par # Logging
c. Supprimez les commentaires des lignes SyslogFacility et LogLevel.
d. Remplacez le SyslogFacility par LOCAL0 et le LogLevel par DEBUG, comme indiqué dans l'exemple
# Logging
SyslogFacility LOCAL0
LogLevel DEBUG
e. Enregistrez le fichier sshd_config, puis redémarrez le service OpenSSH SSH Server.
f. Le fichier journal est écrit dans C:\ProgramData\ssh\logs\sshd.log
1. Exécutez la commande utils system inventory export pour télécharger l'inventaire vers un serveur SFTP, comme indiqué dans l'image.
a. Fournissez l'adresse IP ou le nom de domaine complet d'un serveur SFTP.
b. Fournissez le nom d'utilisateur disposant d'un accès en lecture/écriture au serveur SFTP.
c. Entrez le mot de passe de l'utilisateur.
d. Fournissez le répertoire dans lequel écrire le fichier d'inventaire au format UNIX/Linux.
Exemple : /voice/ipcc/Enterprise/Orchestration
2. Modifiez l'inventaire pour inclure les composants VOS et Windows.
Remarque : le fichier inventory.conf est sensible aux indentations, veuillez consulter/utiliser des images et des exemples de fichiers de configuration
Des exemples de fichiers au format approprié peuvent être téléchargés ici : https://github.com/CXCCSummit/Repository
L'exemple de serveur VOS est illustré dans l'image :
L'exemple de Windows Server est illustré dans l'image :
3. Modifiez les chaînes du fichier d'inventaire, si nécessaire.
deploymentName : fournissez un nom unique pour le déploiement.
deploymentType : ce champ est utilisé pour la vérification de la compatibilité dans les procédures de mise à niveau, de restauration ou de transfert du commutateur.
Les types de déploiement pris en charge sont :
Remarque : consultez ces notes sur les types de déploiement pris en charge.
L'orchestration n'est pas prise en charge pour les modèles de déploiement d'agents 12000, 24000 et 26000.
Le modèle de déploiement HCS-SCC (Small Contact Center) n'est actuellement pas pris en charge pour l'orchestration.
Assurez-vous que les valeurs saisies dans ce champ sont conformes au format de liste des types de déploiement pris en charge. Le type de déploiement est sensible à la casse.
Remarque : l'administrateur peut mettre à jour ou modifier les valeurs par défaut, si nécessaire, en fonction de leur type de déploiement et de leur nom de déploiement préféré.
4. Exécutez la commande utils system inventory import sur le noeud Cloud Connect publisher pour importer l'inventaire mis à jour à partir du serveur SFTP, comme indiqué dans l'image.
a. Fournissez l'adresse IP ou le nom de domaine complet d'un serveur SFTP.
b. Fournissez le nom d'utilisateur disposant d'un accès en lecture/écriture au serveur SFTP.
c. Entrez le mot de passe de l'utilisateur.
d. Fournissez le répertoire dans lequel écrire le fichier d'inventaire au format UNIX/Linux.
Exemple : /voice/ipcc/Enterprise/Orchestration
e. Répondez « oui » pour permettre au nouveau fichier d'inventaire de remplacer l'inventaire actuel.
Pour valider l'intégration réussie des noeuds VOS et Windows et vérifier si la fonction d'orchestration est prête à être utilisée, exécutez la commande utils deployment test-connection comme indiqué dans l'image.
Pour télécharger RTMT à partir de Cloud Connect, accédez à https://FQDN:8443/plugins/CcmServRtmtPlugin.exe.
Vous pouvez également afficher les journaux mentionnés ci-dessous à l'aide de l'outil de surveillance en temps réel (RTMT) :
Journaux d'audit
L'essai d'audit des opérations administratives initié à partir de l'interface de ligne de commande d'orchestration sur Cloud Connect est capturé dans les journaux d'audit d'orchestration.
L'essai d'audit capture les détails de l'utilisateur, de l'action et de la date/heure de l'opération CLI.
Journaux CLI
Journaux réactifs
Le journal Ansible, généré pendant l'exécution de l'interface de ligne de commande utils patch-manager ms-patches install, capture les détails des mises à jour Windows, ainsi que le numéro de la base de connaissances (Ko) des mises à jour installées sur le noeud cible.
État de fonctionnement Journaux de synchronisation haute disponibilité
Journaux relatifs aux notifications par e-mail
Journaux de téléchargement de logiciels
Répertorier les fichiers journaux dans les répertoires respectifs
Révision | Date de publication | Commentaires |
---|---|---|
1.0 |
11-Oct-2022 |
Première publication |