Configurer le rapport d'inventaire des services HCM-F

Introduction

Ce document décrit comment les rapports d'inventaire des services (SI) sont créés dans un déploiement HCS (Hosted Collaboration Solution) 9.2.1 et les interactions entre l'inventaire des services HCM-F (Hosted Collaboration Mediation Fulfillment) de Cisco et CUCDM (Cisco Unified Communications Domain Manager) 8.1.X au cours de ce processus.

Conditions préalables

Conditions requises

Aucune spécification déterminée n'est requise pour ce document.

Components Used

Les informations contenues dans ce document sont basées sur les versions de matériel et de logiciel suivantes :

• CUCDM 8.1.X
• HCM-F 9.2.1

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. If your network is live, make sure that you understand the potential impact of any command.

Informations générales

Cisco HCS SI est une application qui fournit des rapports aux fournisseurs de services à des fins de facturation. Ces rapports contiennent des données sur les clients, les abonnés, les périphériques et d'autres détails actuellement provisionnés sur CUCDM. En outre, SI peut générer des rapports directement à partir des serveurs d'applications Cisco Unified Communications Manager et Cisco Unity Connection pour les clients provisionnés dans Cisco HCM-F qui n'ont pas de CUCDM configuré. SI transfère automatiquement les fichiers de rapport à intervalles réguliers configurables vers des serveurs SFTP distants. Les fournisseurs de services utilisent ces rapports afin de générer des enregistrements de facturation pour leurs clients.

Flux de travail

1. Les rapports SI sont planifiés et configurés via la configuration de l'inventaire des services par l'administrateur.
2. Sur la base d'un calendrier défini, le service Web SI soumet une demande SOAP (Simple Object Access Protocol) à CUCDM.
3. CUCDM reçoit cette demande SOAP et déclenche une transaction afin de créer des données relatives à l'inventaire des services et CUCDM envoie ces données à HCM-F SI via SFTP.
4. SI voit les nouveaux fichiers, décompresse les fichiers et traite les fichiers.
5. SI finit par produire un ou plusieurs fichiers .si.
6. SI crée des copies de sauvegarde de tous les fichiers, qui incluent .si, pour une récupération ultérieure et la prise en charge sur site si nécessaire.
7. SI transfère le ou les fichiers .si vers les hôtes SFTP tels qu'ils sont configurés dans l'interface utilisateur graphique.

Conditions préalables

HCM-F et CUCDM doivent être installés et configurés. Ces services doivent être activés et démarrés sur HCM-F :

• Base de données Cisco CDM
• Cisco Tomcat
• Interface utilisateur de Cisco HCS SI

Utilisez le service Web d'interface de liaison nord Cisco HCS si vous prévoyez de configurer SI via l'interface d'administration SI. Utilisez Cisco HCS Fulfillment Service, si vous prévoyez de configurer SI via Cisco HCM-F NBI. Assurez-vous que le service Cisco HCS CUCDMSync est en cours d'exécution si vous prévoyez d'exécuter le service Cisco HCS CUCDMSync. Utilisez le service Cisco HCS Provisioning Adapter pour que la synchronisation automatique puisse propager les données CUCDM au référentiel de données partagées. SI obtient les données de connexion pour CUCDM à partir du référentiel de données partagées. Le service Cisco HCS Provisioning Adapter fournit des informations d'identification et des informations SNMP, ainsi que des données Syslog distantes sur les périphériques Cisco Unified Communications Manager.

Les services requis diffèrent entre un rapport CUCDM et un rapport d'application UC pris en charge.

Pour les rapports CUCDM, vous avez besoin des services suivants :

• Service d'adaptateur de provisionnement Cisco HCS
• Cisco Tomcat
• Inventaire des services Cisco HCS
• Interface utilisateur de Cisco HCS SI
• Base de données Cisco CDM
• Service d'exécution Cisco HCS
• Service Cisco HCS CUCDMSync
• Service Cisco HCS UCSMSync
• Service Cisco HCS VCenterSync

Pour les rapports d'applications UC prises en charge, vous avez besoin des services suivants :

• Service d'adaptateur de provisionnement Cisco HCS
• Cisco Tomcat
• Inventaire des services Cisco HCS
• Interface utilisateur de Cisco HCS SI
• Base de données Cisco CDM

Les services Web doivent être activés et démarrés sur CUCDM 8.1.X.

=>[webservices] # 

show

|OPTION |VALUE |DESCRIPTION |
|------ |----- |----------- |
|Enabled |True |Enable Webservice |
|8.1.0 |True |Enable version 8.1.0 webservices interface |
|8.0.0 |False |Enable version 8.0.0 compatible webservices interface |

Configuration

Note: Utilisez l'Outil de recherche de commande (clients inscrits seulement) pour obtenir plus d'informations sur les commandes utilisées dans cette section.

Vérifiez que vous avez ajouté CUCDM en tant qu'instance d'application de gestion dans HCM-F. Cela s'explique par le fait que l'inventaire des services HCM-F s'appuie sur les données de CUCDM pour générer des rapports SI, et qu'il doit donc être ajouté.

Pour ce faire, sélectionnez Infrastructure Manager > Management Network > Management Application > Add New.

• Version de l'API - Dans cette liste déroulante, sélectionnez 8.1.0 ou 8.0.

  Lorsque vous vous intégrez à une version CUCDM antérieure à 8.1.2, la version de l'API doit être définie sur 8.0. La version de l'API peut être définie sur 8.0 ou 8.1 lorsque vous vous intégrez à CUCDM 8.1.2 ou version ultérieure. En outre, notez que si la version de l'API 8.0 est configurée, les liaisons SIP ne seront pas synchronisées et seul le nom de l'emplacement sera synchronisé pour le site du client.

• Port : le port est défini par défaut sur 8181. Il s'agit du port SOAP utilisé par SI afin d'envoyer le premier message SOAP à CUCDM.
  
  
• Informations d'identification : sélectionnez le type d'informations d'identification ADMIN et indiquez un ID utilisateur (dans ce cas, hcmf). Cet utilisateur est utilisé pour accéder à CUCDM.

Note: Cet utilisateur doit également exister dans CUCDM avec le même mot de passe. Afin de vérifier ceci, dans l'interface utilisateur graphique de CUCDM choisissez General Administration > Administration Users.

Lorsque vous ajoutez/configurez cet utilisateur, vérifiez que l'accès au service Web a été vérifié. (Cet utilisateur est utilisé par HCM-F SI afin d'envoyer une demande de service Web à CUCDM, il doit donc être activé.)

La génération de rapports provenant de CUCDM est désormais couverte. SI peut cependant également générer des rapports directement à partir d'une application UC prise en charge, de Cisco Unified Communications Manager et des serveurs d'applications Cisco Unity Connection pour les clients qui sont provisionnés dans Cisco HCM-F et qui n'ont pas de CUCDM configuré.

Si CUCDM n'est pas configuré, vous devez ajouter manuellement des serveurs d'applications Cisco Unified Communications Manager (CUCM) et Cisco Unity Connection (CUC) afin d'exécuter un rapport d'inventaire des services.

1. Choisissez Infrastructure Manager > Customer Management > Customer > Cluster. Sélectionnez l'application en question. Par exemple, votre serveur CUCM ou CUC, comme illustré dans cette image.

   

2. Ajoutez les informations d'identification PLATFORM et ADMIN à chacune des applications comme illustré dans cette image.

   

Ajouter des informations d'identification

Pour ajouter des informations d'identification,

1. Cliquez sur l'onglet Informations d'identification.
2. Cliquez sur Ajouter nouveau.
3. Sélectionnez le type d'informations d'identification.

   Note: PLATFORM et ADMIN sont DEUX requis pour exécuter la collection de rapports d'application UC.

4. Renseignez les champs User ID, Password et Re-enter Password.
5. Click Save.
6. Répétez cette opération pour ajouter le type d'informations d'identification suivant.

Ajouter une adresse réseau

1. Cliquez sur l'onglet Adresse réseau.
2. Cliquez sur Ajouter nouveau.
3. Sélectionnez l'espace réseau : Espace du fournisseur de services.
4. Entrez l'adresse IPV4.

   Ceci est requis pour Cisco Unified Communications Manager et Cisco Unity Connection.

Applications de cluster

Répétez toutes les étapes pour la prochaine application de cluster.

Configurez ensuite l'élément Service Inventory sur la page Service Inventory Configuration sur HCM-F, comme illustré dans cette image.

Page Présentation

Vous pouvez définir ici le planning qui définit le moment auquel le rapport doit commencer.

1. Cochez la case Activer la planification.

   Note: La version du format de rapport est ici la clé.

   

2. Sélectionnez la version du format de rapport que vous souhaitez que l'application SI fournisse. Assurez-vous d'utiliser les versions compatibles de SI et de toute application UC prise en charge. Pour plus d'informations sur la compatibilité, consultez la matrice de compatibilité pour la solution de collaboration hébergée Cisco.

   La version du format de rapport Cisco HCS 9.1(1) est uniquement compatible avec CUCDM version 8.1 et ultérieure. La version du format de rapport Cisco HCS 9.0(1) est compatible avec CUCDM version 8.0 et ultérieure. Si vous exécutez une version antérieure du logiciel CUCDM, sélectionnez la version 8.6(2) du format de rapport.

Rapport SI CUCDM

1. Afin de s'assurer que les formats de rapport HCS des versions 9.1(1) et 9.0(1) sont générés correctement, accédez à Infrastructure Manager > Management Application. Sur cette page, assurez-vous de choisir la version 8.0 ou 8.1 du logiciel CUCDM et non la version 7.4.
2. Configurez ensuite la page Configuration de la page Service Inventory Configuration sur HCM-F.

   

   

3. Dans la section Paramètres de l'inventaire des services, configurez le nom d'hôte/adresse IP du serveur SI. Le nom d'hôte SI doit être entré en tant qu'adresse IP ou nom de domaine complet. Si le serveur CUCDM n'est pas configuré avec DNS activé, saisissez une adresse IP dans le champ Hostname. 

   Le champ Nom d'utilisateur est grisé (codé en dur).

   CUCDM utilise le nom d'utilisateur, adminsftp, afin de transférer des données à l'application SI. Vous ne pouvez pas mettre à jour ce champ.

4. Dans le champ Password (Mot de passe), saisissez le mot de passe du compte utilisateur adminsftp. Cette étape est requise comme confirmation d'identité pour des raisons de sécurité. Ce mot de passe est identique au mot de passe administrateur HCS que vous avez configuré lors de l'installation de Cisco HCM-F (ou modifié après l'installation). 

   Note: CUCDM apprend ce mot de passe de SI lorsque SI envoie la demande SOAP d'origine.

5. Dans la section Paramètres SFTP du fournisseur de services, configurez le nom d'hôte et le port (22) avec le nom d'utilisateur/mot de passe du serveur SFTP auquel vous enverrez les fichiers de rapport .si.

Dépannage

Cette section fournit des informations que vous pouvez utiliser pour dépanner votre configuration.

Les journaux importants sont les suivants :

• activelog tomcat/logs/catalina.out - inclut les messages de demande et de réponse à destination et en provenance de CUCDM.
• activelog tomcat/logs/si/log4j - contient toutes les opérations spécifiques aux SI.

Note: Si vous utilisez SI sans CUCDM, consultez également ces journaux :
- /var/log/active/hcs/chpa - Fichiers journaux du service de l'adaptateur de provisionnement
- /var/log/active/hcs/ucpa - fichiers journaux du service ucpa

Complétez ces étapes afin de définir les niveaux de journal au niveau Détaillé (débogage) :

1. Saisissez la commande :

   admin:

   set trace tracelevel

   [an error occurred while processing this directive]
2. Entrez la commande traclevel (utilisez la commande CLI show tracelevels afin de trouver les tractelevels autorisés) - Détaillé
3. Entrez le nom du service - Cisco Tomcat

   Les enregistrements sont mis à jour avec succès.

Une fois cela fait, attendez la prochaine génération de rapport selon votre planning. La première chose à vérifier est si vous pouvez voir la transaction dans VOSS. Recherchez une transaction appelée CreateServiceInventory. Cette transaction doit aboutir.

Notez que vous pouvez voir l'ID utilisateur dans le résultat de la transaction est l'utilisateur hcmf qui a été configuré précédemment dans HCM-F ainsi que sur CUCDM.

Une fois cela fait, vérifiez si les fichiers ont été correctement intégrés dans SI. Il est important de comprendre comment fonctionne la structure des données du rapport dans SI. Le format d'un fichier SI est un fichier ASCII avec l'extension de fichier « .si ». (L'extension de fichier pour le format commun d'inventaire du service d'applications UC est .ucsi)

Ainsi, dans des circonstances normales, CUCDM envoie les fichiers SI bruts (compressés) à HCM-F. HCM-F (SI) masse ensuite les données. (SI voit les nouveaux fichiers, décompresse les fichiers et traite les fichiers.) Dans la structure des fichiers, il existe un certain nombre de répertoires et chacun d'entre eux a sa propre signification en fonction de l'état des données. Ces dossiers sont accessibles uniquement par le centre d'assistance technique (TAC) au cours d'une session de dépannage via le compte racine.

Plus précisément, tous les fichiers sont stockés ici dans SI : /opt/hcs/si/backup/

• dmuncompressé/ - c'est là que vous décompressez et placez les fichiers reçus de CUCDM.
• cntranslation/ - alors les fichiers sont traduits comme une étape intermédiaire et ceux-ci vont dans ce répertoire.
• cisco-normalized/ - puis un seul fichier est produit (copie de la sortie finale) et il est inséré ici.
• sp-normalized/ - en fonction de la taille de fichier maximale configurée sur l'interface utilisateur graphique, le fichier mentionné précédemment est divisé en blocs en fonction de la taille de remplissage maximale configurée (puis ils sont renumérotés pour le séquençage).

/opt/hcs/si/backup/dmuncompressed
[root@hcmf921 dmuncompressed]#
20150522210000GMT+1+CUCDM+1+1.dsi  20150622121500GMT+1+CUCDM+1+1.dsi
20150523210000GMT+1+CUCDM+1+1.dsi  20150623121500GMT+1+CUCDM+1+1.dsi
20150524210000GMT+1+CUCDM+1+1.dsi  20150624121500GMT+1+CUCDM+1+1.dsi
20150525210000GMT+1+CUCDM+1+1.dsi  20150625121500GMT+1+CUCDM+1+1.dsi
20150526210000GMT+1+CUCDM+1+1.dsi  20150626121500GMT+1+CUCDM+1+1.dsi
[root@hcmf921 dmuncompressed]#

/opt/hcs/si/backup/cntranslated
[root@hcmf921 cntranslated]#
20150602210000GMT+1+CUCDM+1+1.tsi  20150703121500GMT+1+CUCDM+1+1.tsi
20150603210000GMT+1+CUCDM+1+1.tsi  20150704121500GMT+1+CUCDM+1+1.tsi
20150604210000GMT+1+CUCDM+1+1.tsi  20150705121500GMT+1+CUCDM+1+1.tsi
20150605210000GMT+1+CUCDM+1+1.tsi  20150706121500GMT+1+CUCDM+1+1.tsi
[root@hcmf921 cntranslated]#

/opt/hcs/si/backup/cisco-normalized
[root@hcmf921 cisco-normalized]#
10000GMT+1+CUCDM+1+1.csi  20150703121500GMT+1+CUCDM+1+1.csi
20150603210000GMT+1+CUCDM+1+1.csi  20150704121500GMT+1+CUCDM+1+1.csi
20150604210000GMT+1+CUCDM+1+1.csi  20150705121500GMT+1+CUCDM+1+1.csi
20150605210000GMT+1+CUCDM+1+1.csi  20150706121500GMT+1+CUCDM+1+1.csi
20150606210000GMT+1+CUCDM+1+1.csi  20150707121500GMT+1+CUCDM+1+1.csi
20150607210000GMT+1+CUCDM+1+1.csi  20150708121500GMT+1+CUCDM+1+1.csi
20150608210000GMT+1+CUCDM+1+1.csi  20150709090000GMT+1+CUCDM+1+1.csi

/opt/hcs/si/backup/sp-normalized
[root@hcmf921 sp-normalized]#
20150528210000GMT+1+CUCDM+1+1.si  20150628121500GMT+1+CUCDM+1+1.si
20150529210000GMT+1+CUCDM+1+1.si  20150629121500GMT+1+CUCDM+1+1.si
20150530210000GMT+1+CUCDM+1+1.si  20150630121500GMT+1+CUCDM+1+1.si
20150531210000GMT+1+CUCDM+1+1.si  20150701121500GMT+1+CUCDM+1+1.si
20150601210000GMT+1+CUCDM+1+1.si  20150702121500GMT+1+CUCDM+1+1.si

Pour extraire les fichiers journaux de SI, entrez ces commandes

file get activelog  tomcat/logs/catalina.out
file get activelog tomcat/logs/si/log4j/XXXXXX (where XXXX are the filenames
 you want to gather)

Vérification

Aucune procédure de vérification n'est disponible pour cette configuration.