Configurar Relatório de Inventário de Serviços HCM-F

Introduction

Este documento descreve como os relatórios do Inventário de serviços (SI) são criados em uma implantação da Solução de colaboração hospedada (HCS) 9.2.1 e as interações entre o inventário de serviços do Cisco Hosted Collaboration Mediation Fulfillment (HCM-F) e o Cisco Unified Communications Domain Manager (CUCDM) 8.1.X durante esse processo.

Prerequisites

Requirements

Não existem requisitos específicos para este documento.

Componentes Utilizados

As informações neste documento são baseadas nestas versões de software e hardware:

• 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.

Informações de Apoio

O Cisco HCS SI é um aplicativo que fornece relatórios para provedores de serviços para fins de faturamento. Esses relatórios contêm dados sobre clientes, assinantes, dispositivos e outros detalhes atualmente provisionados no CUCDM. Além disso, o SI pode gerar relatórios diretamente dos servidores de aplicativos Cisco Unified Communications Manager e Cisco Unity Connection para clientes provisionados no Cisco HCM-F que não têm um CUCDM configurado. O SI transfere automaticamente os arquivos de relatório em intervalos configuráveis regulares para servidores SFTP remotos. Os provedores de serviços usam esses relatórios para gerar registros de cobrança para seus clientes.

Fluxo de trabalho

1. Os relatórios SI são agendados e configurados pelo administrador através da Configuração do Inventário de serviços.
2. Com base em uma programação definida, o serviço Web do SI envia uma solicitação SOAP (Simple Object Access Protocol) ao CUCDM.
3. O CUCDM recebe essa solicitação SOAP e dispara uma transação para criar dados relacionados ao inventário de serviços e o CUCDM envia esses dados para o HCM-F SI via SFTP.
4. O SI vê o(s) novo(s) arquivo(s), descompacta(m) o(s) arquivo(s) e processa(s) o(s) arquivo(s).
5. O SI eventualmente gera um(s) arquivo(s) .si.
6. O SI cria cópias de backup de todos os arquivos, o que inclui .si, para recuperação posterior e suporte de campo, se necessário.
7. O SI transfere o(s) arquivo(s) .si para o(s) host(s) SFTP conforme configurado na GUI.

Prerequisites

HCM-F e CUCDM devem ser instalados e configurados. Esses serviços devem ser ativados e iniciados no HCM-F:

• Banco de dados Cisco CDM
• Cisco Tomcat
• IU do Cisco HCS SI

Use o Cisco HCS North Bound Interface Web Service, se planeja configurar o SI através da interface administrativa do SI. Use o Cisco HCS Fulfillment Service se planeja configurar o SI através do Cisco HCM-F NBI. Certifique-se de que o Cisco HCS CUCDMSync Service esteja em execução se planeja executar o Cisco HCS CUCDMSync Service. Use o Cisco HCS Provisioning Adapter Service para que a sincronização automática possa propagar os dados do CUCDM para o Repositório de dados compartilhados. O SI obtém os dados de conexão do CUCDM do Repositório de dados compartilhados. O Cisco HCS Provisioning Adapter Service provisiona credenciais e informações de SNMP, bem como provisiona dados de Syslog remotos em dispositivos do Cisco Unified Communications Manager.

Os serviços necessários diferem entre um relatório do CUCDM e um relatório do aplicativo UC suportado.

Para relatórios do CUCDM, você precisa destes serviços:

• Serviço de adaptador de provisionamento do Cisco HCS
• Cisco Tomcat
• Inventário de serviços do Cisco HCS
• IU do Cisco HCS SI
• Banco de dados Cisco CDM
• Serviço de conclusão do Cisco HCS
• Serviço Cisco HCS CUCDMSync
• Serviço Cisco HCS UCSMSync
• Serviço VCenterSync do Cisco HCS

Para obter relatórios de aplicativos UC compatíveis, você precisa destes serviços:

• Serviço de adaptador de provisionamento do Cisco HCS
• Cisco Tomcat
• Inventário de serviços do Cisco HCS
• IU do Cisco HCS SI
• Banco de dados Cisco CDM

Os serviços Web devem ser ativados e iniciados no 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 |

Configurar

Note: Use a Command Lookup Tool ( somente clientes registrados) para obter mais informações sobre os comandos usados nesta seção.

Certifique-se de ter adicionado o CUCDM como uma instância de aplicativo de gerenciamento no HCM-F. Isso ocorre porque o Inventário de serviços HCM-F depende de dados do CUCDM para gerar relatórios de SI, portanto, ele precisa ser adicionado.

Para fazer isso, escolha Gerenciador de infraestrutura > Rede de gerenciamento > Aplicativo de gerenciamento > Adicionar novo.

• Versão da API - Nessa lista suspensa, escolha 8.1.0 ou 8.0.

  Quando você se integra a uma versão do CUCDM anterior à 8.1.2, a versão da API deve ser definida como 8.0. A versão da API pode ser definida como 8.0 ou 8.1 quando você se integra ao CUCDM 8.1.2 ou posterior. Além disso, observe que se a versão da API 8.0 estiver configurada, os troncos SIP não serão sincronizados e apenas o nome do local será sincronizado para a Localização do cliente.

• Porta - O padrão da porta é 8181. Esta é a porta SOAP usada pelo SI para enviar a primeira mensagem SOAP ao CUCDM.
  
  
• Credenciais - Escolha o tipo de credencial ADMIN e forneça uma ID de usuário (neste caso, hcmf). Esse usuário é usado para acessar o CUCDM.

Note: Esse usuário também precisa existir no CUCDM com a mesma senha. Para verificar isso, na GUI do CUCDM escolha General Administration > Administration Users.

Ao adicionar/configurar este usuário, verifique se o acesso ao serviço Web foi verificado. (Este usuário é usado pelo HCM-F SI para enviar uma solicitação de serviço da Web para o CUCDM, portanto, ele precisa ser ativado.)

A geração de relatórios com origem no CUCDM já foi abordada. A SI, no entanto, também pode gerar relatórios diretamente de um aplicativo UC suportado, do Cisco Unified Communications Manager e dos servidores de aplicativos do Cisco Unity Connection para clientes provisionados no Cisco HCM-F que não têm um CUCDM configurado.

Se você não tiver um CUCDM configurado, será necessário adicionar servidores de aplicativos Cisco Unified Communications Manager (CUCM) e Cisco Unity Connection (CUC) manualmente para executar um relatório de Inventário de serviços.

1. Escolha Gerente de infraestrutura > Gerenciamento do cliente > Cliente > Cluster. Escolha o aplicativo em questão. Por exemplo, seu servidor CUCM ou CUC, como mostrado nesta imagem.

   

2. Adicione as credenciais PLATAFORM e ADMIN a cada um dos aplicativos conforme mostrado nesta imagem.

   

Adicionar credenciais

Para adicionar credenciais,

1. Clique na guia Credenciais.
2. Clique em Adicionar novo.
3. Escolha o Tipo de Credencial.

   Note: A PLATAFORMA e ADMIN são necessárias para executar a Coleta de relatórios de aplicativos UC.

4. Preencha os campos ID de usuário, Senha e Reinserir senha.
5. Click Save.
6. Repita para adicionar o próximo Tipo de Credencial.

Adicione o endereço de rede

1. Clique na guia Network Address (Endereço de rede).
2. Clique em Adicionar novo.
3. Selecione o espaço de rede: Espaço do provedor de serviços.
4. Digite o endereço IPV4.

   Isso é necessário para o Cisco Unified Communications Manager e para o Cisco Unity Connection.

Aplicativos de cluster

Repita todos para o próximo aplicativo de cluster.

Em seguida, configure a peça Inventário de serviços na Página Configuração do Inventário de serviços no HCM-F, como mostrado nesta imagem.

Página de visão geral

Aqui você pode definir a agenda que define quando você deseja que o relatório comece.

1. Certifique-se de marcar a caixa de seleção Habilitar programação.

   Note: A Versão do formato do relatório é a chave aqui.

   

2. Selecione a versão do formato de relatório que você deseja que o aplicativo SI forneça. Certifique-se de usar as versões compatíveis do SI e qualquer aplicativo UC suportado. Para obter informações sobre compatibilidade, consulte Matriz de compatibilidade para Cisco Hosted Collaboration Solution.

   A versão do formato do relatório do Cisco HCS 9.1(1) só é compatível com o CUCDM versão 8.1 e posterior. A versão do formato do relatório do Cisco HCS 9.0(1) é compatível com o CUCDM versão 8.0 e posterior. Se você executar uma versão anterior do software CUCDM, escolha a versão do formato do relatório 8.6(2).

Relatório CUCDM do SI

1. Para garantir que os formatos de relatório HCS versão 9.1(1) e 9.0(1) sejam gerados corretamente, navegue para Gerente de infraestrutura > Aplicativo de gerenciamento. Nesta página, escolha o software CUCDM versão 8.0 ou 8.1 e não a versão 7.4.
2. Em seguida, configure a página de configuração na página de configuração do Inventário de serviços no HCM-F.

   

   

3. Na seção Configurações do Inventário de serviços, configure o nome do host/endereço IP do servidor SI. O nome de host do SI deve ser inserido como um endereço IP ou um nome de domínio totalmente qualificado. Se o servidor CUCDM não estiver configurado com DNS habilitado, insira um endereço IP no campo Nome do host. 

   O campo Nome de usuário está acinzentado (codificado).

   O CUCDM usa o nome de usuário, adminsftp, para transferir dados para o aplicativo SI. Não é possível atualizar este campo.

4. No campo Senha, digite a senha para a conta de usuário adminsftp. Esta etapa é necessária como uma confirmação de identidade para fins de segurança. Essa senha é igual à senha do administrador do HCS que você configurou durante a instalação do Cisco HCM-F (ou foi alterada após a instalação). 

   Note: O CUCDM aprende essa senha do SI quando o SI envia a solicitação SOAP original.

5. Na seção Configurações SFTP do provedor de serviços, configure o nome do host e a porta (22) junto com o nome de usuário/senha do servidor SFTP para o qual você enviará os arquivos de relatório .si.

Troubleshoot

Esta seção disponibiliza informações para a solução de problemas de configuração.

Os registros importantes são:

• activelog tomcat/logs/catalina.out - inclui mensagens de solicitação e resposta para e do CUCDM.
• ativelog tomcat/logs/si/log4j - contém todas as operações específicas do SI.

Note: Se você usar o SI sem CUCDM, também reveja estes registros:
- /var/log/ative/hcs/chpa - Provisionamento de arquivos de log de serviço do adaptador
- /var/log/ative/hcs/ucpa - arquivos de log de serviço ucpa

Conclua estes passos para definir os níveis de log para o nível Detalhado (depuração):

1. Insira  o comando:

   admin:

   set trace tracelevel

   [an error occurred while processing this directive]
2. Digite o tracelevel (use o comando CLI show traconze para localizar os níveis de rastreamento permitidos) - Detalhado
3. Digite o nome do serviço - Cisco Tomcat

   Os registros foram atualizados com êxito.

Quando isso for feito, aguarde a próxima geração de relatório de acordo com sua programação. A primeira coisa a verificar é se você pode ver a transação no VOSS. Procure uma transação chamada CreateServiceInventory. Esta transação deve ser bem-sucedida.

Observe que você pode ver a ID do usuário na saída da transação como o usuário hcmf configurado anteriormente tanto no HCM-F como no CUCDM.

Quando isso for feito, verifique se os arquivos foram corretamente inseridos no SI. É importante entender como a estrutura de dados do relatório funciona no SI. O formato de um arquivo SI é um arquivo baseado em ASCII com a extensão de arquivo ".si". (A extensão do arquivo do formato comum do Inventário de serviços de aplicativos UC é .ucsi)

Assim, em circunstâncias normais, o CUCDM envia os arquivos SI brutos (compactados) para o HCM-F. O HCM-F (SI) massageia os dados. (A SI vê o(s) novo(s) arquivo(s), descompacta(m) o(s) arquivo(s) e processa(s).) Dentro da estrutura do arquivo há vários diretórios e cada um deles tem seu próprio significado dependendo do estado dos dados. Essas pastas podem ser acessadas somente pelo Technical Assistance Center (TAC) durante uma sessão de solução de problemas por meio da conta raiz.

Especificamente, todos os arquivos são armazenados aqui no SI: /opt/hcs/si/backup/

• dmuncompressed/ - é aqui que você descompacta e coloca os arquivos recebidos do CUCDM.
• cntraduzido/ - os arquivos são convertidos como uma etapa intermediária e eles vão para este diretório.
• cisco-normalized/ - então um único arquivo é produzido (cópia da saída final) e ele entra aqui.
• sp-normalized/ - com base no tamanho máximo de arquivo configurado na GUI, o arquivo mencionado anteriormente é dividido em blocos com base no tamanho máximo de preenchimento configurado (então eles são renumerados para sequenciamento).

/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

Para extrair os arquivos de log do SI, insira estes comandos

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

Verificar

No momento, não há procedimento de verificação disponível para esta configuração.