Ce document fournit une explication et des exemples des deux méthodes utilisées pour mettre à niveau l'adaptateur de téléphone analogique (ATA). Ce document complète les informations contenues dans Mise à niveau du logiciel Cisco ATA 186.
Cisco vous recommande de connaître les caractéristiques opérationnelles de base de l'ATA. Référez-vous à Configuration de base de Cisco ATA 186 pour plus d'informations générales.
Les informations contenues dans ce document sont basées sur les versions de matériel et de logiciel suivantes :
Les versions du logiciel ATA inférieures à 2.xx prennent uniquement en charge la méthode de mise à niveau de fichier exécutable.
Les versions du logiciel ATA supérieures à 2.xx prennent en charge les méthodes de procédure de mise à niveau du fichier exécutable et TFTP.
Remarque : Vous ne pouvez pas mettre à niveau l'image de chargement de démarrage 2.15 (020726a) vers la version 3.0.0. Référez-vous à l'ID de bogue Cisco CSCed78906 (clients enregistrés uniquement) pour plus de détails.
Remarque : Si vous utilisez les ATA expédiés après mars 2004, ces ATA ne peuvent pas être rétrogradés vers une image antérieure à la version 3.1.0 en raison de la différence matérielle. Les nouveaux ATA doivent exécuter la version 3.1 ou ultérieure. Ils ne peuvent pas exécuter la version 2.xx. Le logiciel fourni avec chaque ATA est une image de chargement de démarrage uniquement et doit être mis à niveau vers la dernière image SCCP, SIP ou autre de Cisco.com, conformément à Configuration du Cisco ATA pour SCCP.
Avec Cisco CallManager 3.1, l'ATA est configuré en tant que téléphone IP Cisco 7960. Avec Cisco CallManager 3.2 et les versions ultérieures, les ATA apparaissent dans la liste déroulante de la page de configuration de Cisco CallManager. Reportez-vous à la section Modification importante de l'enregistrement de Cisco CallManager pour SCCP des Notes de version pour Cisco ATA 186 et Cisco ATA 188 version 2.16.ms.
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.
Pour plus d'informations sur les conventions utilisées dans ce document, reportez-vous à Conventions relatives aux conseils techniques Cisco.
Il existe deux façons de mettre à niveau le logiciel dans un périphérique ATA :
Ces deux méthodes sont simples une fois comprises. La première méthode implique un certain degré d'interaction manuelle tandis que la seconde méthode est plus automatisée.
Une erreur courante consiste à laisser le TFTP activé lorsque vous mettez à niveau manuellement un ATA. Après un redémarrage, l'ATA récupère le profil à partir du serveur TFTP spécifié et remplace la mise à niveau manuelle. Vérifiez le paramètre UseTftp et assurez-vous qu'il est défini sur 0 avant la mise à niveau manuelle.
Remarque : le logiciel ATA version 1.xx ne prend pas en charge la méthode de mise à niveau TFTP. Vous devez utiliser la méthode Executable File pour mettre à niveau ATA avec des versions inférieures à 2.xx. En outre, vous devez connaître deux règles importantes avant de mettre à niveau un système :
Si l'ATA exécute la version 1.34 ou antérieure, vous ne pouvez pas effectuer directement la mise à niveau vers la version 2.10 ou ultérieure. Vous devez utiliser l'image transition.zup décrite plus loin dans ce document. Mettez d'abord à niveau vers cette version intermédiaire, puis vers votre image cible.
Il est très important que vous ne mettiez pas l'ATA hors tension pendant le processus de mise à niveau/rétrogradation. La mise hors tension de l'unité lors de la mise à niveau peut endommager définitivement l'ATA et nécessite que l'unité soit renvoyée à Cisco pour remplacement. Si vous souhaitez mettre l'unité hors tension puis sous tension, débranchez d'abord le câble Ethernet, attendez 20 secondes, puis mettez l'unité hors tension en toute sécurité.
Pour la méthode Executable File, vous n'avez besoin que d'un PC où vous pouvez stocker les fichiers image ATA et où vous pouvez exécuter l'utilitaire de mise à niveau ata186us.exe. La seule condition requise est que le périphérique ATA dispose d'une connectivité IP au PC. Aucun serveur FTP ou TFTP n'est nécessaire.
Remarque : Pour les utilisateurs de Windows XP, des cas ont été signalés où les mises à niveau de la méthode de fichier exécutable échouent lors de l'utilisation de l'utilitaire de mise à niveau ata186us.exe sur un PC exécutant Windows XP. Reportez-vous à Mise à niveau des ATA : Problème avec la méthode de mise à niveau de fichier exécutable avec Windows XP pour plus d'informations sur ce problème.
Vous pouvez utiliser deux types de fichiers pour cette méthode de mise à niveau du système. Les fichiers .zup contiennent l'image qui s'exécute dans l'ATA (équivalent à Cisco IOS®) et les images .kup contiennent les langues utilisées par l'ATA pour la réponse vocale interactive (IVR). Ces deux images peuvent être chargées séparément et l'une peut être mise à niveau sans nécessiter la mise à niveau de l'autre. Il est rare de mettre à niveau des images .kup et, dans la plupart des cas, seul le fichier .zup doit être pris en compte. Toutefois, veuillez toujours lire les notes de version du logiciel de l'adaptateur de terminal Cisco ATA186 (clients enregistrés uniquement) et en cas de modification.
Les fichiers image .zup et l'utilitaire de mise à niveau ata186us.exe peuvent être téléchargés à partir de l'emplacement de téléchargement sur Cisco.com. Parmi les fichiers disponibles sur ce site, ces fichiers .zip sont disponibles :
fichiers .zip dont les noms commencent par ata186-v et se terminent par des caractères qui reflètent la version de l'image et la date de build. Ces fichiers contiennent des fichiers image .zup. Il existe un fichier .zup différent pour chaque version et protocole VoIP qui inclut H.323 et Media Gateway Control Protocol/Simple Gateway Control Protocol (MGCP/SGCP). D'autres fichiers qui donnent plus d'informations sont également inclus dans les fichiers .zip.
L'utilitaire de mise à niveau ata186us.exe est inclus dans le fichier ata186us1.zip.
Le fichier ata186us.txt contient plus d'informations sur les étapes et les commandes requises pour effectuer la mise à niveau.
Les étapes nécessaires à la mise à niveau d'un ATA 186 à l'aide du fichier exécutable de l'utilitaire de mise à niveau sont décrites ici. Dans cet exemple, une unité de la version 2.xx à la version 2.13 est mise à niveau.
Vérifiez le niveau actuel du logiciel dans l'ATA.
Le niveau logiciel détermine si vous devez utiliser ou non le fichier transition.zup. Si nécessaire, le fichier transition.zup se trouve dans le fichier .zip que vous pouvez télécharger à partir de l'emplacement de téléchargement du logiciel de la carte de terminal Cisco ATA186 (clients enregistrés uniquement). Ce fichier est inclus dans les fichiers .zip pour les versions d'image 2.10 et ultérieures. Vous pouvez trouver la version actuelle de l'ATA de deux manières :
Utilisez le clavier de numérotation de votre téléphone connecté à votre Cisco ATA 186 et saisissez 123#. L'IVR vous annonce le numéro de version.
Recherchez le numéro de version dans le coin inférieur gauche de la page Web de configuration de l'ATA à l'adresse http://<ip_of_ATA>/dev. Voici un exemple du coin gauche de cette page.
Il est de moins en moins courant d'exiger l'utilisation du fichier transition.zup. Dans cet exemple, étant donné que la mise à niveau est de la version 2.xx vers la version 2.13, elle n'est pas nécessaire. Si nécessaire, le processus est le même sauf en deux étapes qui passent par l'image transition.zup.
Une fois que vous connaissez le nom de l'image, vous devez préparer le PC à la mise à niveau. Les fichiers image .zup doivent être copiés dans un répertoire (dans ce cas C:\ATA). La connectivité IP doit également être vérifiée avec la commande ping comme le montre cette zone DOS.
Cette fenêtre affiche les résultats de l'exécution du fichier.
Exécutez l'exécutable ata186us pour préparer le PC à la requête de l'ATA. Le paramètre -d(1,2,3) définit le niveau de description détaillée pour le débogage tandis que le paramètre -any(2) spécifie la pertinence du logiciel à télécharger. Référez-vous à Mise à niveau du logiciel Cisco ATA 186 pour plus d'informations.
Comme le montre la fenêtre de l'étape 3, l'application vous indique exactement ce qui doit être entré dans le téléphone. Ensuite, décrochez le téléphone et entrez la chaîne 100#127*18*106*8000#.
Une fois la mise à niveau terminée, le PC l'indique avec le message Terminé de téléchargement de code. Ce message est suivi de l'adresse IP de l'ATA et de la date/heure.
Une fois le processus de mise à niveau terminé, l'ATA se réinitialise. Il n'est pas nécessaire de se mettre hors tension.
La deuxième méthode utilisée pour mettre à niveau le système ATA consiste à utiliser TFTP. De cette manière, il n'y a aucune interaction entre l'administrateur et le périphérique ATA particulier chaque fois qu'une mise à niveau est effectuée. Le périphérique ATA est initialement configuré pour vérifier avec un serveur TFTP si des modifications de configuration, de version logicielle ou de version de langue doivent être apportées. La fréquence à laquelle l'ATA interroge le serveur TFTP est configurable. Il existe un fichier (profil) unique pour chaque ATA qui contient les informations spécifiques à chaque périphérique.
Voici les étapes nécessaires pour mettre à niveau un ATA 186 de la version 2.xx vers la version 2.13 à l'aide de la méthode TFTP.
Créez le profil de l'ATA.
Le fichier .zip contient un fichier exemple_uprofile.txt qui peut être téléchargé à partir de l'emplacement de téléchargement du logiciel de la carte de terminal Cisco ATA 186 (clients enregistrés uniquement). Ce fichier doit être modifié pour correspondre aux exigences particulières (logiciel et configuration) de l'ATA. Les champs modifiés pour ce test sont ceux répertoriés dans le tableau.
Pour une explication de tous ces paramètres, reportez-vous au fichier exemple_uprofile.txt, en particulier à la section Firmware Upgrade Parameters ou à Mise à niveau du logiciel Cisco ATA 186.
exemple_uprofile.txt Paramètres |
---|
UseTftp:1 TftpURL:172.18.106.10 cfgInterval:120 EncryptKey:0 !--- This field was not changed but is listed for emphasis. !--- The EncryptKey parameter must be set to zero (0) !--- if the profile is not encrypted. !--- Make sure the EncryptKey parameter is identical !--- in both of the ATA's existing configuration !--- and the profile created. Otherwise, the ATA is !--- not able to decrypt the profile. ToConfig:0 upgradecode:3,0x301,0x0400,0x0200,172.18.106.10,69, 0x020521a,ata186-v2-14-020521a.zup !--- For an upgrade to an image build earlier than 010907, !--- the above line needs to be !--- changed to something similar to this next line !--- (depending on the specific build date): !--- Note: If you have accidentally specified the !--- firmware filename in both the upgradecode and upgradelang !--- parameters, there is no way to recover from this !--- situation because the Flash is corrupted. upgradecode:3,0x301,0x0400,0x0200,172.18.106.10,69, 0x010803a,ata186-v2-13-0110a.kxz !--- Note that .zup files are used for TFTP upgrades as !--- well as executable file upgrades. !--- However, .zup files are only supported for TFTP !--- upgrades with images of build date !--- later than 010907 (see step 6). When this !--- test upgrade was performed, the .kxz !--- file was the only file type supported for TFTP !--- upgrades. This file was !--- included in the .zip file downloaded from Cisco.com. !--- The Cisco.com .zip file no longer includes !--- the .kxz file, and the .zup file is now the only !--- image file type you use. Dhcp:0 StaticIp:10.120.13.100 StaticRoute:10.120.13.1 StaticNetMask:255.255.255.0 GateWay:10.120.11.100 UID0:105 UID1:106 TimeZone:20 NTPIP:172.18.10 |
Remarque : L'ATA vérifie que la nouvelle image logicielle est différente de l'image qui s'exécute déjà afin de permettre à la méthode de mise à niveau TFTP de se produire automatiquement et de ne pas gaspiller de bande passante avec des tentatives de mise à niveau continues. Il effectue cette vérification en comparant les IMAGEID des deux images logicielles. Si les deux valeurs sont identiques, l'ATA ne tente pas de télécharger la nouvelle image logicielle.
Toutes les images de mise à niveau logicielle ont leur date de génération incluse. Avant le début de 2002, les images logicielles incluaient uniquement le mois et le jour (par exemple, 0803a). Au début de 2002, toutes les versions incluent également l'année (par exemple, 20521a).
Un IMAGEID unique peut être dérivé de la date de build dans le nouveau nom du logiciel en préservant la date de build avec 0x pour former un nombre hexadécimal. Dans la table d'exemple, le nom du logiciel est ata186-v2-14-020521a.zup et l'IMAGEID est 0x020521a.
L'ATA peut vérifier directement son IMAGEID logiciel en cours d'exécution. Cependant, pour la nouvelle date de génération du logiciel, elle dépend de la valeur que vous entrez dans le champ IMAGEID du paramètre UpgradeCode. Vous devez dériver l'IMAGEID du nouveau logiciel pour entrer cette valeur correctement. En réalité, tout IMAGEID permet à la mise à niveau de fonctionner à condition qu'elle soit différente de la version actuelle. Cependant, pour réduire l'activité TFTP inutile, il est utile d'entrer l'IMAGEID correct.
Consultez le coin inférieur gauche de la page de configuration de l'ATA à l'adresse http://<ip_of_ATA>/dev pour vérifier la version du logiciel qui s'exécute actuellement sur votre ATA.
Une fois les modifications effectuées, enregistrez le fichier sous la forme d'un nom de quinze caractères qui l'identifie de manière unique parmi tous vos ATA.
Le format du nom doit être ataxxxxxxxxxxxxxx où chaque xx est la représentation hexadécimale inférieure à deux chiffres de chaque entier dans l'adresse MAC de votre ATA. Par exemple, si l'ATA a l'adresse MAC 1.2.3.4.5.6, le nom du fichier est ata010203040506. L'adresse MAC peut être récupérée via l'option IVR#24 ou dans la section inférieure gauche de la page Web de configuration de l'ATA à l'adresse http://<ip_of_ATA>/dev.
Dans les versions ATA ultérieures à la version 2.11, le nom du fichier se trouve via une option IVR#84 dans le menu ou dans la section inférieure gauche de la page Web de configuration de l'ATA à l'adresse http://<ip_of_ATA>/dev. Si vous exécutez ATA version 2.11 ou antérieure, l'adresse MAC doit être convertie manuellement au format correct ou utilisez l'outil atapname.exe pour générer le nom de fichier comme indiqué ici.
Une fois que ce fichier texte existe avec le nom approprié, il doit être converti en binaire pour que le périphérique ATA puisse le lire. Cette mise en forme est effectuée à l'aide de la commande cfgfmt.exe. Ce fichier exécutable est inclus dans le fichier .zip qui peut être téléchargé à partir de l'emplacement de téléchargement du logiciel de la carte de terminal Cisco ATA186 (clients enregistrés uniquement).
Le nouveau fichier (ou profil) doit être déplacé vers le serveur TFTP.
Ce profil est récupéré par le périphérique ATA qui utilise les informations qu'il contient pour se configurer ou se mettre à niveau.
L'étape suivante consiste à déplacer les fichiers image requis sur le serveur TFTP dans le même répertoire que le fichier de profil.
Le nom du fichier image dépend de la date de génération du logiciel :
Les logiciels dont la date de build est antérieure à 010907 prennent uniquement en charge les images .kxz pour la méthode de mise à niveau TFTP. La création du logiciel utilisé dans le test était antérieure à cette date et le fichier .kxz était requis. Ce fichier a été inclus dans le fichier .zip qui a été téléchargé à partir de l'emplacement de téléchargement du logiciel de carte de terminal Cisco ATA186 (clients enregistrés uniquement). Bien que rarement nécessaires, les images de mise à niveau de la méthode TFTP pour le langage IVR ATA ont des extensions .kbx.
Le logiciel dont la date de build est postérieure à 010907 prend en charge les fichiers image .kxz/.kbx et .zup/.kup pour la méthode de mise à niveau TFTP. Par conséquent, les images .zup/.kup peuvent maintenant être utilisées à la fois pour les méthodes de mise à niveau Fichier exécutable et TFTP. Par conséquent, les images .kxz/.kbx ne sont plus incluses dans le fichier .zip.
Une fois le profil et les images prêts, demandez à l'ATA de commencer à vérifier les mises à jour auprès du serveur TFTP.
Cela peut se faire via le protocole DHCP (Dynamic Host Configuration Protocol), les menus IVR ou via le navigateur Web. Les champs en question sur la page Web de configuration de l'ATA à l'adresse http://<ip_of_ATA>/dev sont affichés ici.
Dans ce cas, l'ATA est configuré pour contacter le serveur TFTP à l'adresse IP 172.18.106.10 toutes les deux minutes. Si vous voulez forcer l'ATA à vérifier auprès du serveur TFTP avant l'intervalle CfgInterval, tapez http://<ATA_IP_ADDR>/update sur votre navigateur Web.
Exécutez un fichier exécutable sur votre PC qui est inclus dans le fichier .zip pour faciliter le dépannage. Vous pouvez le télécharger à partir de l'emplacement de téléchargement du logiciel de la carte de terminal Cisco ATA186 (clients enregistrés uniquement).
Ce fichier de débogage (prserv.exe) sert de serveur de mise à niveau qui capture les informations de débogage envoyées par le logiciel ATA à l'adresse IP/numéro de port de votre ordinateur. Il compile les informations de l'ATA dans un fichier journal lisible. Ce fichier peut inclure la configuration des appels, les numéros composés et d'autres informations pertinentes qui ne sont pas comprises dans ce document.
Il s'agit de la sortie du journal prserv.exe et affiche les paquets HELLO de l'ATA vers le serveur TFTP et indique que la mise à niveau a réussi.
Puisque ce journal affiche les communications entre le PC et l'ATA, il n'affiche pas le .exe qui est démarré sur votre PC. La capture d'écran du journal montre les étapes suivantes :
Deux HELLO de l'ATA avec l'adresse IP 10.120.13.100 et l'ID de build 0803a. Notez que les informations incluses dans ces paquets incluent l'adresse IP, l'ID de build, ainsi que d'autres informations liées au processus TFTP.
Un autre Hello plus de vingt secondes plus tard de l'ATA avec la même adresse IP mais un ID de build différent 0110a. Cette modification signifie que la mise à niveau a réussi. Notez que d'autres informations ont été incluses dans ce Hello, telles que le nom du profil (00070edcd02d), et que la prochaine vérification TFTP est effectuée dans 120 secondes (nextTftp 12000).
Autres lignes, telles que 41 : 30 ; 0,0,0,0, qui indiquent les messages de test d'activité de session.
Référez-vous à Configuration et dépannage d'un ATA 186 avec des contrôleurs d'accès Cisco IOS et Configuration et dépannage d'un ATA 186 avec une passerelle Cisco IOS pour plus d'informations et des exemples de dépannage à l'aide de prserv.exe.
Cette fonctionnalité est prise en charge dans Cisco CallManager version 3.2 ou ultérieure et est la méthode recommandée par Cisco pour SCCP. Ces exigences doivent être respectées :
La prise en charge XML doit être activée dans Cisco ATA (la valeur par défaut est activée). La prise en charge XML est configurée avec le bit 31 du paramètre ConnectMode. Référez-vous à ConnectMode pour plus d'informations.
Cette procédure ne peut être exécutée que par l'administrateur de Cisco CallManager.
Obtenez la dernière image de signalisation à partir du site Web de Cisco. Reportez-vous à Configuration du serveur TFTP avec le logiciel Cisco ATA pour obtenir des instructions sur l'emplacement du logiciel sur le site Web de Cisco et sur la façon de placer les fichiers sur le serveur TFTP de Cisco CallManager. Le fichier image a l'extension .zup. Complétez ces étapes afin de mettre à niveau tous les ATA Cisco simultanément :
Téléchargez la dernière version du logiciel Cisco ATA pour SCCP à partir du site Web de Cisco et stockez les fichiers sur le serveur TFTP de Cisco CallManager. Référez-vous à Configuration du serveur TFTP avec le logiciel Cisco ATA pour plus d'informations.
Accédez à l'écran principal Administration de Cisco CallManager.
Dans le menu Système, sélectionnez Device Defaults. L'écran Device Defaults (Paramètres par défaut du périphérique) s'affiche.
Dans la liste Type de périphérique, recherchez le type de périphérique Cisco ATA 186. Dans le champ Load Information (Charger les informations) en regard du type de périphérique Cisco ATA 186, saisissez le nom de l'image de signalisation à utiliser pour mettre à niveau les Cisco ATA. L'image de signalisation a une extension .zup, par exemple ATA186-v2-15-ms-020812a.zup.
Cliquez sur le bouton Mettre à jour en haut de l'écran Device Defaults.
Dans le menu Périphérique, sélectionnez Téléphone. L'écran Rechercher et répertorier les téléphones s'affiche.
Dans la zone en regard du bouton Rechercher, saisissez les données de lettres, puis cliquez sur Rechercher. L'écran Find and List Phones (Rechercher et répertorier les téléphones) réapparaît et contient désormais tous les Cisco ATA connectés à votre Cisco CallManager.
Cochez la case à gauche de la colonne Nom du périphérique afin de sélectionner tous les ATA Cisco affichés.
Cliquez sur le bouton Reset Selected en bas de l'écran Find and List Phones.
La fenêtre contextuelle Reset Device s'affiche. Cliquez sur Reset Device. La fenêtre contextuelle Reset Device s'affiche. Cliquez sur Réinitialiser pour terminer la procédure.
Une boîte de dialogue de confirmation s'affiche. Click OK. Le bouton de fonction de chaque Cisco ATA clignote lors de sa mise à niveau.
Une fois que le bouton cesse de clignoter, la mise à niveau est terminée et le périphérique se réenregistre dans Cisco CallManager.