Questo documento offre una spiegazione ed esempi dei due metodi utilizzati per aggiornare l'adattatore per telefono analogico (ATA). Questo documento potenzia le informazioni contenute in Aggiornamento del software Cisco ATA 186.
Cisco raccomanda la conoscenza delle caratteristiche operative di base dei dischi ATA. Fare riferimento alla configurazione base Cisco ATA 186 per ulteriori informazioni di base.
Le informazioni fornite in questo documento si basano sulle seguenti versioni software e hardware:
Le versioni del software ATA inferiori alla 2.xx supportano solo il metodo di aggiornamento dei file eseguibili.
Le versioni del software ATA superiori alla 2.xx supportano entrambi i metodi di procedura Executable File e TFTP.
Nota: non è possibile eseguire l'aggiornamento dall'immagine di caricamento all'avvio 2.15 (020726a) alla versione 3.0.0. Per ulteriori informazioni, fare riferimento all'ID bug Cisco CSCed78906 (solo utenti registrati).
Nota: se si utilizzano i dischi ATA forniti dopo marzo 2004, non è possibile effettuare il downgrade di tali dischi ATA a immagini precedenti alla versione 3.1.0 a causa della differenza hardware. I nuovi dischi ATA devono eseguire la versione 3.1 o successive. Non possono eseguire la versione 2.xx. Il software fornito con ciascuna ATA è solo un'immagine del carico di avvio e deve essere aggiornato all'ultima immagine SCCP, SIP o un'altra immagine proveniente da Cisco.com in base a Configurazione di Cisco ATA per SCCP.
Con Cisco CallManager 3.1, ATA è configurato come telefono IP Cisco 7960. Con Cisco CallManager 3.2 e versioni successive, i dischi ATA vengono visualizzati nella casella a discesa della pagina di configurazione di Cisco CallManager. Fare riferimento alla sezione Importante Modifica della registrazione di Cisco CallManager per SCCP delle Note di rilascio per Cisco ATA 186 e Cisco ATA 188 release 2.16.ms.
Le informazioni discusse in questo documento fanno riferimento a dispositivi usati in uno specifico ambiente di emulazione. Su tutti i dispositivi menzionati nel documento la configurazione è stata ripristinata ai valori predefiniti. Se la rete è operativa, valutare attentamente eventuali conseguenze derivanti dall'uso dei comandi.
Per ulteriori informazioni sulle convenzioni usate, consultare il documento Cisco sulle convenzioni nei suggerimenti tecnici.
Esistono due modi per aggiornare il software in un dispositivo ATA:
Entrambi questi metodi sono semplici una volta compresi. Il primo metodo implica un certo grado di interazione manuale, mentre il secondo metodo è più automatizzato.
Un errore comune è lasciare il TFTP abilitato quando si aggiorna manualmente un ATA. Dopo un riavvio, ATA recupera il profilo dal server TFTP specificato e sostituisce l'aggiornamento manuale. Controllare il parametro UseTftp e assicurarsi che sia impostato su 0 prima dell'aggiornamento manuale.
Nota: il software ATA versione 1.xx non supporta il metodo di aggiornamento TFTP. È necessario utilizzare il metodo Executable File per aggiornare ATA con versioni inferiori a 2.xx. Inoltre, prima di aggiornare un sistema è necessario conoscere due regole importanti:
Se la versione ATA è 1.34 o precedente, non è possibile eseguire l'aggiornamento diretto alla versione 2.10 o successiva. È necessario utilizzare l'immagine transition.zup descritta più avanti in questo documento. Eseguire prima l'aggiornamento a questa versione intermedia e quindi all'immagine di destinazione.
È molto importante non spegnere i dischi ATA durante il processo di upgrade/downgrade. Lo spegnimento dell'unità durante l'aggiornamento potrebbe danneggiare permanentemente l'ATA e richiederà la restituzione dell'unità a Cisco per la sostituzione. Se si desidera spegnere e riaccendere l'apparecchio, scollegare prima il cavo Ethernet, attendere 20 secondi, quindi spegnere l'apparecchio.
Per il metodo Executable File, è sufficiente un PC in cui è possibile archiviare i file di immagine ATA ed eseguire l'utilità di aggiornamento ata186us.exe. L'unico requisito è che il dispositivo ATA abbia una connettività IP al PC. Non è necessario un server FTP o TFTP.
Nota: per gli utenti di Windows XP, sono stati segnalati alcuni casi in cui gli aggiornamenti del metodo di file eseguibile non riescono quando si utilizza l'utilità di aggiornamento ata186us.exe su un PC che esegue Windows XP. Per ulteriori informazioni, fare riferimento al documento sull'aggiornamento dei dischi ATA: Problema con il metodo di aggiornamento dei file eseguibili con Windows XP per ulteriori informazioni sul problema.
Per questo metodo di aggiornamento del sistema è possibile utilizzare due tipi di file. I file .zup contengono l'immagine eseguita nell'ATA (equivalente a Cisco IOS®) e le immagini .kup contengono le lingue utilizzate dall'ATA per Interactive Voice Response (IVR). Queste due immagini possono essere caricate separatamente e una può essere aggiornata senza che sia necessario aggiornare l'altra. È raro aggiornare le immagini con estensione kup e nella maggior parte dei casi è necessario considerare solo il file con estensione zup. Tuttavia, leggere sempre il software Cisco ATA186 Terminal Adapter (solo utenti registrati) e le note sulla versione in caso di modifiche.
Sia i file di immagine .zup che l'utilità di aggiornamento ata186us.exe possono essere scaricati dal percorso di download su Cisco.com. Tra i file disponibili in questo sito, sono disponibili i seguenti file .zip:
file zip con nomi che iniziano con ata186-v e terminano con caratteri che riflettono la versione dell'immagine e la data di creazione. Questi file contengono file immagine .zup. Ogni versione e protocollo VoIP include un file .zup diverso che include H.323 e MGCP (Media Gateway Control Protocol/Simple Gateway Control Protocol). Nei file .zip sono inclusi anche altri file che forniscono ulteriori informazioni.
L'utilità di aggiornamento ata186us.exe è inclusa nel file ata186us1.zip.
Il file ata186us.txt include ulteriori informazioni sui passaggi e i comandi necessari per eseguire l'aggiornamento.
In questa sezione vengono descritti i passaggi necessari per aggiornare un ATA 186 utilizzando il file eseguibile dell'utilità di aggiornamento. Nell'esempio, viene aggiornato un'unità dalla versione 2.xx alla versione 2.13.
Controllare il livello attuale del software nell'ATA.
Il livello del software determina se è necessario utilizzare o meno il file transition.zup. Se necessario, il file .zup di transizione è disponibile nel file .zip che è possibile scaricare dal percorso di download del software Cisco ATA186 Terminal Adapter (solo utenti registrati). Questo file è incluso nei file .zip delle versioni 2.10 e successive dell'immagine. È possibile trovare la versione corrente dell'ATA nei due modi seguenti:
Utilizzare la tastiera del telefono collegata a Cisco ATA 186 e immettere 123#. L'IVR comunica il numero di versione all'utente.
Individuare il numero di versione nell'angolo inferiore sinistro della pagina Web di configurazione di ATA all'indirizzo http://<ip_of_ATA>/dev. Di seguito è riportato un esempio dell'angolo sinistro di questa pagina.
È sempre meno frequente che sia necessario utilizzare il file transition.zup. In questo esempio, poiché l'aggiornamento è dalla versione ATA 2.xx alla 2.13, non è necessario. Se necessario, il processo è lo stesso tranne che in due passaggi che prevedono la transizione tramite l'immagine transition.zup.
Una volta conosciuto il nome dell'immagine, è necessario preparare il PC per l'aggiornamento. I file immagine con estensione zup devono essere copiati in una directory (in questo caso C:\ATA). È inoltre necessario verificare la connettività IP con il comando ping, come mostrato in questa casella DOS.
Questa finestra mostra i risultati dell'esecuzione del file.
Eseguire l'eseguibile ata186us per preparare il PC per la richiesta da parte dell'ATA. Il parametro -d(1,2,3) imposta il livello di descrizione dettagliata per il debug, mentre il parametro -any(2) specifica l'idoneità del software da scaricare. Per ulteriori informazioni, fare riferimento a Aggiornamento del software Cisco ATA 186.
Come mostra la finestra al punto 3, l'applicazione indica esattamente cosa deve essere inserito nel telefono. Quindi, sollevare il telefono e immettere la stringa 100#127*18*106*8000#.
Una volta completato l'aggiornamento, il PC lo segnala con il messaggio Done uploading code. Questo messaggio è seguito dall'indirizzo IP dell'ATA e dalla data/ora.
Al termine del processo di upgrade, l'ATA si reimposta. Non è necessario spegnere il computer.
Il secondo metodo utilizzato per aggiornare il sistema ATA è tramite TFTP. In questo modo, non vi è alcuna interazione tra l'amministratore e il particolare dispositivo ATA ogni volta che viene eseguito un aggiornamento. Il dispositivo ATA è inizialmente configurato per verificare con un server TFTP se è necessario apportare modifiche alla configurazione, alla versione del software o alla versione della lingua. La frequenza con cui l'ATA esegue il polling al server TFTP è configurabile. Esiste un file (profilo) univoco per ciascun ATA che contiene le informazioni specifiche per ciascun dispositivo.
Questi sono i passaggi necessari per aggiornare un ATA 186 dalla versione 2.xx alla 2.13 utilizzando il metodo TFTP.
Creare il profilo per ATA.
Il file example_uprofile.txt è incluso nel file .zip e può essere scaricato dal percorso di download del software Cisco ATA 186 Terminal Adapter (solo utenti registrati). Questo file deve essere modificato per soddisfare i requisiti specifici (software e configurazione) per i dischi ATA. I campi modificati per questo test sono quelli elencati nella tabella.
Per una spiegazione di tutti questi parametri, fare riferimento al file example_uprofile.txt, in particolare alla sezione Parametri di aggiornamento del firmware, o a Aggiornamento del software Cisco ATA 186.
Parametri example_uprofile.txt |
---|
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 |
Nota: i dati verificano che la nuova immagine software sia diversa dall'immagine già in esecuzione in modo da consentire l'esecuzione automatica del metodo di aggiornamento TFTP e non sprecare la larghezza di banda con tentativi di aggiornamento continui. Esegue questo controllo confrontando gli IMAGEID delle due immagini software. Se i due valori sono identici, l'ATA non tenta di scaricare la nuova immagine software.
Tutte le immagini degli aggiornamenti software includono la data di creazione. Prima dell'inizio del 2002, le immagini software includevano solo il mese e il giorno (ad esempio, 0803a). All'inizio del 2002, tutte le release includono anche l'anno (ad esempio, 020521a).
È possibile derivare un ID immagine univoco dalla data di creazione nel nuovo nome software anteponendo 0x alla data di creazione per formare un numero esadecimale. Nella tabella di esempio, il nome del software è ata186-v2-14-020521a.zup e l'ID IMMAGINE è 0x020521a.
L'ATA è in grado di controllare direttamente il proprio IMAGEID software attualmente in esecuzione. Tuttavia, per la nuova data di creazione del software, si basa sul valore immesso nel campo IMAGEID del parametro UpgradeCode. Per immettere correttamente questo valore, è necessario derivare l'ID immagine del nuovo software. In realtà, qualsiasi IMAGEID consente l'aggiornamento a condizione che sia diverso da quello corrente. Tuttavia, per ridurre le attività TFTP non necessarie, vale la pena immettere l'ID IMMAGINE corretto.
Osservare l'angolo inferiore sinistro della pagina di configurazione di ATA all'indirizzo http://<ip_of_ATA>/dev per verificare la versione software attualmente in esecuzione su ATA.
Una volta apportate le modifiche, salvare il file con un nome di quindici caratteri che lo identifichi in modo univoco tra tutti i dati.
Il formato del nome deve essere ataxxxxxxxxxx, dove ogni xx è la rappresentazione esadecimale a due cifre in minuscolo di ogni numero intero nell'indirizzo MAC dei dati. Ad esempio, se l'indirizzo MAC dell'unità ATA è 1.2.3.4.5.6, il nome del file è ata010203040506. L'indirizzo MAC può essere recuperato tramite l'opzione IVR#24 o nella sezione inferiore sinistra della pagina Web di configurazione dell'unità ATA all'indirizzo http://<ip_of_ATA>/dev.
Nelle versioni ATA successive alla 2.11, il nome del file può essere trovato tramite un'opzione IVR#84 nel menu o nella sezione in basso a sinistra della pagina web di configurazione dei dischi ATA all'indirizzo http://<ip_of_ATA>/dev. Se si esegue ATA versione 2.11 o precedente, è necessario convertire manualmente l'indirizzo MAC nel formato corretto oppure utilizzare lo strumento atapname.exe per generare il nome file, come mostrato di seguito.
Una volta che il file di testo esiste con il nome appropriato, deve essere convertito in formato binario in modo che il dispositivo ATA possa leggerlo. Questa formattazione viene eseguita utilizzando il comando cfgfmt.exe. Questo file eseguibile è incluso nel file .zip che può essere scaricato dal percorso di download del software Cisco ATA186 Terminal Adapter Software (solo utenti registrati).
Il nuovo file (o profilo) deve essere spostato sul server TFTP.
Questo profilo viene recuperato dal dispositivo ATA che utilizza le informazioni in esso contenute per configurare o aggiornare se stesso.
Il passaggio successivo consiste nello spostare i file immagine richiesti sul server TFTP nella stessa directory del file del profilo.
Il nome del file immagine dipende dalla data di creazione del software:
Il software con una data di build precedente a 010907 supporta solo le immagini .kxz per il metodo di aggiornamento TFTP. La build del software utilizzato nel test era precedente a questa data ed era necessario il file .kxz. Questo file è stato incluso nel file .zip scaricato dal percorso di download del software Cisco ATA186 Terminal Adapter Software (solo utenti registrati). Anche se raramente necessarie, le immagini di aggiornamento del metodo TFTP per il linguaggio ATA IVR hanno estensioni .kbx.
Il software con una data di creazione successiva a 010907 supporta sia i file di immagine .kxz/.kbx che .zup/.kup per il metodo di aggiornamento TFTP. Pertanto, le immagini .zup/.kup possono ora essere utilizzate sia per il metodo di aggiornamento File eseguibile che per il metodo di aggiornamento TFTP. Di conseguenza, le immagini con estensione kxz/.kbx non vengono più incluse nel file zip.
Quando il profilo e le immagini sono pronti, indicare all'ATA di iniziare a controllare con il server TFTP la disponibilità di aggiornamenti.
A tale scopo, è possibile utilizzare il protocollo DHCP (Dynamic Host Configuration Protocol), i menu IVR o il browser Web. Di seguito sono riportati i campi in questione nella pagina web di configurazione di ATA all'indirizzo http://<ip_of_ATA>/dev.
In questo caso, i dati sono configurati per contattare il server TFTP all'indirizzo IP 172.18.106.10 ogni due minuti. Se si desidera forzare il controllo dei dati con il server TFTP prima di CfgInterval, digitare http://<ATA_IP_ADDR>/refresh nel browser Web.
Eseguire sul PC un file eseguibile incluso nel file zip per facilitare la risoluzione dei problemi. È possibile scaricarlo dal percorso di download del software Cisco ATA186 Terminal Adapter (solo utenti registrati).
Questo file di debug (prserv.exe) funge da server di aggiornamento che acquisisce le informazioni di debug inviate dal software ATA all'indirizzo IP o al numero di porta del PC. Le informazioni vengono compilate dall'ATA in un file di registro leggibile. Questo file può includere l'impostazione della chiamata, le cifre composte e altre informazioni importanti che esulano dall'ambito del presente documento.
Questo è l'output del log prserv.exe e mostra i file hellos dal ATA al server TFTP e indica che l'aggiornamento è riuscito.
Poiché in questo output di registro vengono visualizzate le comunicazioni tra il PC e l'ATA, non viene visualizzato il file con estensione exe avviato nel PC. La schermata del log mostra queste fasi:
Due hellos dall'ATA con indirizzo IP 10.120.13.100 e ID build 0803a. Si noti che le informazioni incluse in queste guide includono l'indirizzo IP, l'ID build e altre informazioni correlate al processo TFTP.
Un altro saluto oltre venti secondi dopo da ATA con lo stesso indirizzo IP ma un ID build diverso 0110a. Questa modifica indica che l'aggiornamento è riuscito. Notare che altre informazioni sono state incluse in questo saluto, come il nome del profilo (00070edcd02d), e che il controllo TFTP successivo è tra 120 secondi (nextTftp 12000).
Altre linee, come 41: 30;0,0,0,0, che indica i pacchetti keepalive della sessione.
Per ulteriori informazioni e esempi sulla risoluzione dei problemi relativi all'uso di prserv.exe, fare riferimento a Configurazione e risoluzione dei problemi di un ATA 186 con gateway Cisco IOS e Configurazione e risoluzione dei problemi di un ATA 186 con gateway Cisco IOS.
Questa funzione è supportata in Cisco CallManager versione 3.2 o successive ed è il metodo consigliato da Cisco per SCCP. Devono essere soddisfatti i seguenti requisiti:
Il supporto XML deve essere attivato in Cisco ATA (l'impostazione predefinita è attivata). Il supporto XML è configurato con il bit 31 del parametro ConnectMode. Per ulteriori informazioni, fare riferimento a ConnectMode.
Questa procedura può essere eseguita solo dall'amministratore di Cisco CallManager.
Ottieni l'ultima immagine di segnalazione dal sito Web Cisco. Per istruzioni su dove trovare il software sul sito Web Cisco e su come posizionare i file sul server TFTP Cisco CallManager, fare riferimento a Configurazione del server TFTP con il software Cisco ATA. Il file immagine ha estensione zup. Completare questi passaggi per aggiornare contemporaneamente tutti i Cisco ATA:
Scaricare l'ultimo software Cisco ATA release per SCCP dal sito Web Cisco e memorizzare i file sul server Cisco CallManager TFTP. per ulteriori informazioni, fare riferimento a Configurazione del server TFTP con il software Cisco ATA.
Andare alla schermata principale di Cisco CallManager Administration.
Dal menu Sistema, scegliere Impostazioni predefinite dispositivo. Viene visualizzata la schermata Impostazioni predefinite dispositivo.
Nell'elenco Tipo di dispositivo, individuare il tipo di dispositivo Cisco ATA 186. Nel campo Load Information accanto al tipo di dispositivo Cisco ATA 186, immettere il nome dell'immagine di segnalazione da utilizzare per aggiornare i Cisco ATA. L'immagine di segnalazione ha estensione .zup, ad esempio ATA186-v2-15-ms-020812a.zup.
Fare clic sul pulsante Aggiorna nella parte superiore della schermata Impostazioni predefinite dispositivo.
Dal menu Periferica, scegliere Telefono. Viene visualizzata la schermata Trova ed elenca telefoni.
Nell'area accanto al pulsante Trova, immettere le lettere dati, quindi fare clic su Trova. Viene nuovamente visualizzata la schermata Trova ed elenca telefoni, che ora contiene tutti i Cisco ATA connessi a Cisco CallManager.
Selezionare la casella a sinistra della colonna Device Name (Nome dispositivo) per selezionare tutti i Cisco ATA mostrati.
Fare clic sul pulsante Reimposta selezione nella parte inferiore della schermata Trova ed elenca telefoni.
Viene visualizzata la finestra a comparsa Reset Device (Reimposta dispositivo). Fare clic su Reimposta periferica. Viene visualizzata la finestra di dialogo Reset Device (Reimposta dispositivo). Fare clic su Reset per completare la procedura.
Viene visualizzata una casella di conferma. Fare clic su OK. Durante l'aggiornamento, il pulsante di funzione di ciascuna unità Cisco ATA lampeggia.
Quando il pulsante smette di lampeggiare, l'aggiornamento è completato e il dispositivo si registra nuovamente su Cisco CallManager.