Configurer une connexion CUCM

À quoi cela sert

Une connexion CUCM décrit comment EasyUC joint un Cisco Unified Communications Manager : adresse du publisher, utilisateur AXL, version AXL et, en option, serveur de messagerie vocale (Cisco Unity Connection). Chaque connexion représente un cluster CUCM. Tout le travail dans l’espace EasyUC Cisco passe par la connexion sélectionnée dans l’en-tête.

À partir de l’adresse saisie, EasyUC déduit lui-même les adresses pour AXL, le service temps réel (RIS), Extension Mobility et la collecte des journaux. Lors de l’enregistrement, EasyUC se connecte au CUCM via AXL, lit la version du CUCM et compte les utilisateurs finaux et les téléphones. Si un serveur de messagerie vocale est saisi, sa connexion est également vérifiée.

Via Actions sur une connexion, vous accédez à tous les autres paramètres de ce cluster, par exemple les règles de nommage, le CDR, la sauvegarde CUCM et le journal des modifications CUCM. Ces entrées ont leurs propres chapitres.

Prérequis

Connexion en tant qu’administrateur (ROLE_APP_ADMIN). La création et la modification de connexions ne sont attribuées à aucun autre rôle.
Licence avec le module cucm. La zone Voicemail du formulaire et la plupart des entrées sous Actions n’apparaissent que si la licence inclut le provisioning (provisioning).
Un application user dans le CUCM avec accès AXL. Pour les cartes de nœuds du tableau de bord, il a en plus besoin d’autorisations de serviceability, par exemple via le groupe « Standard CCM Server Monitoring ».
Le publisher CUCM est joignable en HTTPS depuis l’appliance EasyUC.
Pour la messagerie vocale : utilisateur, mot de passe et adresse du serveur Unity Connection, ainsi que le numéro de la messagerie vocale.
Lors de la configuration initiale, une seule connexion peut être créée. Les suivantes sont possibles une fois l’assistant de configuration terminé.

Procédure pas à pas : créer une connexion

Dans l’en-tête, sélectionnez l’espace de travail EasyUC Cisco.
Dans le menu, ouvrez Administration → CUCM & Provisioning → CUCM Connections. La page s’intitule Manage CUCM Connections.
Cliquez sur Create en haut à droite. La boîte de dialogue Create CUCM Connection s’ouvre.
Sous Alias, saisissez un nom unique, par exemple Zentrale.
Dans la zone CUCM, sélectionnez la AXL Version (11.5, 12.0, 12.5, 14.0 ou 15.0).
Saisissez l’AXL User et l’AXL Password.
Sous AXL URL, saisissez l’adresse du publisher, par exemple cucm-pub01.intern:8443. Si https:// n’est pas indiqué, EasyUC ajoute le protocole ; un chemin est ignoré.
Sous Settings, sélectionnez le Device Type : Phones, Device Profiles ou Phones and Device Profiles.
Laissez Interne Durchwahl (Ziffern) (numéro interne, chiffres ; le libellé n’existe qu’en allemand) à 0, ou saisissez une longueur de 2 à 10 si les numéros internes sont uniques au sein du cluster.
Si nécessaire, réglez Can a user log in to multiple devices? (visible uniquement si le type d’appareil inclut des Device Profiles) et Device Activation Service Enabled?.
Sélectionnez le Location Type : Normal ou Custom Enduser Attribute. Pour Custom Enduser Attribute, sélectionnez en plus l’Enduser Custom Attribute et saisissez au moins une plage avec From et To sous Ranges.
Si un serveur de messagerie vocale est connecté : laissez le commutateur de la zone Voicemail activé et renseignez Voicemail User, Voicemail Password, Voicemail URL et Voicemail Number. Sans messagerie vocale, désactivez le commutateur.
Cliquez sur Save. EasyUC vérifie la connexion au CUCM et au serveur de messagerie vocale. En cas de succès, la boîte de dialogue se ferme, le message Success s’affiche et la connexion apparaît dans la liste avec le badge enabled.
Sélectionnez la nouvelle connexion dans l’en-tête avant de modifier des sites, des modèles ou des appareils.

Procédure pas à pas : mettre à jour une connexion

Ouvrez EasyUC Cisco → Administration → CUCM & Provisioning → CUCM Connections.
Dans la ligne de la connexion, cliquez sur Actions. La fenêtre Menu s’ouvre.

Vue originale pour cette procédure Aller à l’étape 2
Le menu Actions ouvert appartient à la connexion CUCM sélectionnée. L’entrée de modification de la connexion ouvre ses paramètres. La capture montre comment accéder à la modification.

EasyUC · Environnement de test/démonstration Capture de l’interface en allemand
Actions d’une connexion CUCM

Le menu d’actions ouvert de la connexion du laboratoire mène à la modification de connexion et aux options fonctionnelles. La capture montre la navigation, sans identifiants ni modification enregistrée.
Cliquez sur Update Connection. La boîte de dialogue Update Connection affiche les valeurs enregistrées.
Modifiez les champs souhaités. En plus de la boîte de dialogue de création, la zone Voicemail contient le champ Voicemail Profile on Line. Le Location Type ne peut plus être modifié ici.
Cliquez sur Save. EasyUC se reconnecte via AXL et relit la version et les compteurs. En cas de succès, le message Success s’affiche.

Procédure pas à pas : désactiver ou activer une connexion

Ouvrez EasyUC Cisco → Administration → CUCM & Provisioning → CUCM Connections.
Dans la ligne de la connexion, cliquez sur Actions.
Cliquez sur Disable Connection. La modification prend effet immédiatement, sans demande de confirmation. Le badge de la colonne Alias passe à disabled.
Pour une connexion désactivée, le menu ne contient que Enable Connection. Un clic dessus réactive la connexion.
Si la connexion désactivée était sélectionnée dans l’en-tête, EasyUC passe à la connexion activée suivante.

Champs et options

Champs et options
Champ / action	Signification et utilisation
Alias	Nom de la connexion dans l’en-tête et dans les listes. Obligatoire, doit être unique.
AXL Version	Version de l’interface AXL : 15.0, 14.0, 12.5, 12.0 ou 11.5. Obligatoire. Après l’enregistrement, la liste affiche la version signalée par le CUCM.
AXL User / AXL Password	Application user du CUCM pour AXL. Obligatoire. EasyUC vérifie la connexion lors de l’enregistrement.
AXL URL	Adresse du publisher sous forme de nom d’hôte ou d’adresse IP, éventuellement avec port et `https://`. Obligatoire. EasyUC n’enregistre que le protocole, l’hôte et le port, et ajoute lui-même les chemins des services CUCM.
Device Type	Définit avec quoi la connexion travaille : `Phones`, `Device Profiles` (device profiles pour Extension Mobility) ou `Phones and Device Profiles`. Par défaut : `Phones and Device Profiles`.
Interne Durchwahl (Ziffern) (numéro interne, chiffres)	`0` = désactivé (par défaut). Avec 2 à 10 chiffres, EasyUC affiche aussi les renvois vers le numéro interne pour les numéros E.164. À n’utiliser que si ces numéros internes sont uniques au sein du cluster CUCM. La valeur `1` n’est pas autorisée : « Bitte 0 oder eine Länge von 2 bis 10 eingeben. » (veuillez saisir 0 ou une longueur de 2 à 10).
Can a user log in to multiple devices?	Visible uniquement pour les types d’appareils avec Device Profiles. Par défaut : désactivé.
Device Activation Service Enabled?	Par défaut : activé. Si l’option est cochée, EasyUC propose la sélection pour l’enregistrement automatique lors de la création de téléphones de bureau (par exemple lors de la copie ou du déplacement d’utilisateurs et dans le provisioning automatique).
Location Type	`Normal` : les sites sont affectés par des plages de numéros (par défaut). `Custom Enduser Attribute` : les sites sont affectés par un attribut personnalisé de l’utilisateur final du CUCM. Sélectionnable uniquement à la création.
Enduser Custom Attribute	Uniquement pour le type de site `Custom Enduser Attribute`. EasyUC lit les attributs définis dans le CUCM. Obligatoire pour ce type de site.
Ranges	Uniquement pour le type de site `Custom Enduser Attribute`. Avec Add, vous créez d’autres plages, avec rm vous en supprimez une. From et To sont obligatoires et ne peuvent contenir que des chiffres, éventuellement précédés d’un `+`. Une plage peut comprendre 1 000 000 de numéros au maximum.
Check for Translation Pattern/Route Pattern	Option par plage de numéros. Par défaut : désactivé.
Use for automatically insert	Option par plage de numéros. La plage sert à l’attribution automatique de numéros. Par défaut : activé.
Use a shorter Range for automatically insert?	Visible uniquement si l’insertion automatique est active. Affiche une seconde paire From/To qui restreint davantage les numéros attribués automatiquement.
Voicemail (switch)	Active ou désactive l’intégration de la messagerie vocale de la connexion. Visible uniquement avec une licence de provisioning. Lorsqu’il est désactivé dans Update Connection, EasyUC supprime de la connexion l’utilisateur, le mot de passe, l’URL et les paramètres du serveur de messagerie vocale.
Voicemail User / Voicemail Password / Voicemail URL	Accès au serveur Unity Connection. Obligatoire dès que le commutateur est activé. La même notation s’applique à l’URL qu’à l’AXL URL.
Voicemail Number	Numéro du système de messagerie vocale (voicemail pilot).
Voicemail Profile on Line	Uniquement dans Update Connection. Sélection d’un profil de messagerie vocale du CUCM.
Voicemail server have LDAP configured?	Doit correspondre à l’intégration d’annuaire du serveur Unity Connection. Par défaut à la création : activé.
Enable Voicemail Mailbox	“The EasyUC User will be able to see the Enduser Voicemail Messages” Par défaut : désactivé.
Enable Anonymous Messages	“The EasyUC user will not be able to see voicemail message information such as caller ID or caller number” Par défaut : désactivé.

Columns of the list

Columns of the list
Champ / action	Signification et utilisation
Alias	Nom de la connexion avec le badge enabled ou disabled. Pour le type de site `Custom Enduser Attribute`, s’y ajoutent l’attribut et les plages de numéros ; avec l’intégration Teams activée, MS Teams Prefix et MS Teams Strip.
CUCM	Hôte de l’adresse AXL, version du CUCM (`v.` …) et compteurs endusers, endusers phones et phones. Pour les connexions activées, également CUCM License : au survol apparaît License Requirements by Type avec les colonnes Type et Current Usage ; la dernière ligne indique l’heure de la dernière mise à jour.
Voicemail	Hôte du serveur de messagerie vocale, ou croix rouge si aucun serveur de messagerie vocale n’est connecté.
Ph. Security / Dir URI / Ph. Control / CDR	Coche ou croix par fonction. Avec le CDR activé, le lien logs ouvre les journaux CDR de la connexion.
MoH Nodes	Nœuds MoH sélectionnés ou All.
CURRI	Icône d’information avec l’adresse du service CURRI global pour cette connexion.
Enduser Site	État du site utilisateur final : enabled, Only CFA, request, phonebook et les trois zones de messagerie vocale.
Actions	Bouton Actions avec le menu de la connexion.

Vérifier le résultat et circonscrire les erreurs

Après l’enregistrement, la colonne CUCM affiche la version lue et les compteurs. Si des valeurs s’y affichent, la connexion AXL fonctionne.
« Could not connect to CUCM server or username/password do not match » : le CUCM rejette la connexion AXL ou ne répond pas à AXL. Vérifiez l’utilisateur, le mot de passe, la version AXL et le rôle AXL de l’utilisateur.
« Could not connect to host » : l’adresse n’est pas joignable depuis l’appliance. Vérifiez le nom d’hôte, le port, le DNS et le pare-feu.
« This value should not be blank. » sous un champ : renseignez le champ obligatoire. Lorsque la messagerie vocale est activée, l’utilisateur, le mot de passe et l’URL du serveur de messagerie vocale sont eux aussi obligatoires.
« You cannot have all connections disabled » : la dernière connexion activée ne peut pas être désactivée.
« You can add just one connection during install » : lors de la configuration initiale, une seule connexion est possible.
Si une entrée manque sous Actions, la connexion est désactivée ou la licence n’inclut pas le provisioning.
Après un changement de certificat sur le CUCM, les requêtes échouent tant que le nouveau certificat n’a pas été accepté. Voir le chapitre « Vérifier et accepter un certificat CUCM ».