Atualizar endpoints do TMS

Introduction

Este documento explica o novo procedimento para atualizar terminais via TelePresence Management Suite (TMS). Há uma nova interface de programação de aplicativos (API) e, a partir dessa versão, o próprio endpoint recupera o pacote de software do Cisco TMS. Isso está documentado nas notas de versão do Software versão TC6.

Atualizar um endpoint

Quando você atualiza um endpoint no TMS por meio do menu Atualização de sistemas, isso é o que acontece:

1. O TMS inicia uma conexão com o endpoint.
   
   
2. O endpoint executa um POST HTTP para o código, enquanto fornece seus próprios detalhes:
   
   

   POST /tms/public/external/management/systemmanagementservice.asmx HTTP/1.1
   
   Host: 10.48.36.42
   
   Accept: */*
   
   Content-Type: text/xml; charset=utf-8
   
   User-Agent: Cisco/TC
   
   Accept-Charset: ISO-8859-1,utf-8
   
   Content-Length: 759
   
   
   <?xml version="1.0" encoding="utf-8"?><env:Envelope xmlns:
     env="http://schemas.xmlsoap.org/soap/envelope/"
           xmlns="http://www.tandberg.net/2004/11/SystemManagementService/">
     <env:Body 
   xmlns="http://www.tandberg.net/2004/11/SystemManagementService/">
       <PostEvent>
         <Identification>
           <SystemName>NewYork</SystemName>
           <MACAddress>00:50:60:08:54:C6</MACAddress>
           <IPAddress>10.10.0.180</IPAddress>
           <ProductType>TANDBERG Codec</ProductType>
           <ProductID>Cisco Codec</ProductID>
           <SWVersion>TC7.0.2.aecf2d9</SWVersion>
           <HWBoard>101790-6 [B0]</HWBoard>
           <SerialNumber>FTT1703007B</SerialNumber>
         </Identification>
       <Event>Boot</Event>
     </PostEvent></env:Body>
   </env:Envelope>
   
   

3. O TMS responde com um 200 OK que informa ao endpoint onde baixar o software e se ele está inserido na chave de versão do TMS:
   
   

   HTTP/1.1 200 OK
   
   Cache-Control: private, max-age=0
   
   Content-Type: text/xml; charset=utf-8
   
   Date: Wed, 12 Mar 2014 14:01:06 GMT
   
   Content-Length: 1420
   
   
   <soap:Body>
       <PostEventResponse
           xmlns="http://www.tandberg.net/2004/11/SystemManagementService/">
           <PostEventResult>
               <Management>
                   <Command>
                       </Command>
                   <Software>
                       <ReleaseKey />
                       <SessionId>
                           4fae46a9-2e37-4edc-b3dc-97dbde2dc282
                           </SessionId>
                       <Package>
                           <VersionId>
                               TC6.3.0
                               </VersionId>
                           <URL>
                               http://10.48.36.42/tms/public/data/SystemSoftware/s52010tc6_3_0.pkg
                               </URL>
                       </Package>
                       <Feedback>
                           <URL>
                               http://10.48.36.42/tms/public/feedback/code.aspx
                               </URL>
                           </Feedback>
                       </Software>
                   </Management><

4. O endpoint faz o download do software:
   
   

   GET /tms/public/data/SystemSoftware/s52010tc6_3_0.pkg HTTP/1.1
   
   Host: 10.48.36.42
   
   Accept: */*
   
   Content-Type: text/xml; charset=utf-8
   
   User-Agent: Cisco/TC
   
   Accept-Charset: ISO-8859-1,utf-8

Você também pode ver isso nos logs do ponto de extremidade (arquivo all.log):

appl[1642]: 63256.49 PROV I: provision(): software upgrade 
 url='http://10.48.36.42/tms/public/data/SystemSoftware/s52010tc6_3_0.pkg' 
 release-key=''appl[1642]: 63256.50 PROV I: Starting normal download
appl[1642]: 63256.50 PROV I: Starting download from 
 http://10.48.36.42/tms/public/data/SystemSoftware/s52010tc6_3_0.pkg 
 to //upgrade/pkg.tmp

...

appl[1642]: 63429.93 PROV I: HttpDownloader(this=0x42411588): 
 done downloading 297386594B (from http://10.48.36.42/tms/public/data/
 SystemSoftware/s52010tc6_3_0.pkg to //upgrade/pkg.tmp)

...

appl[1642]: 63429.93 PROV I: Renaming from //upgrade/pkg.tmp 
 to //upgrade/image to start seeding

...

[1642]: 63489.96 PROV I: Renaming from //upgrade/image to //upgrade/pkg 
 to start upgrade

Verificar o TMS

No TMS, você pode configurar qual diretório usar para as imagens de software. Clique em TMS Tools -> Diretory Locations:

Você pode ver o que está configurado em Administrative Tools -> Configuration -> General Settings -> Software FTP Diretory.

Note: O diretório deve ser uma subpasta de \wwwTMS\ e as contas de serviço do TMS devem ter acesso a gravação. Esta pasta precisa ser hospedada pelo IIS. A maneira mais fácil de verificar isso é abrir o Gerenciador dos Serviços de Informações da Internet (IIS), navegar até a pasta e clicar em Explorar no menu direito.

Há também uma configuração em Administrative Tools -> Configuration -> Network Settings -> URL where Software Packages Can Download (Ferramentas Administrativas -> Configuração -> Configurações de Rede -> URL where Software Packages Can Download (Pacotes de Software Podem Ser Baixados), mas isso não é adequado para endpoints que executam o TC Versão 6.x e posterior.

Histórico de revisões