Alterações no formato do arquivo CSV de descoberta em massa do supervisor IMC

Introduction

Este documento descreve as alterações significativas no formato de arquivo de valor separado por vírgula (CSV) usado no perfil de descoberta. As alterações foram feitas para tornar mais flexível e robusto para os clientes fornecerem os parâmetros para os servidores rack. Além disso, a intenção é cobrir todos os formatos e os erros frequentes no formato encontrado no campo.

Informações de Apoio

O Cisco Integrated Management Controller Supervisor (IMCS) é um software de gerenciamento com funcionalidades robustas que gerencia servidores rack. Os usuários têm a capacidade de descobrir, inventariar, executar atualização de firmware e executar várias outras operações. A descoberta dos servidores rack pode ser realizada com a criação de um perfil de descoberta com a lista de endereços IP a serem descobertos. Os endereços IP podem ser fornecidos como uma lista de IPs, intervalo de IPs, sub-rede ou com o uso de um arquivo csv. As alterações de formato mencionadas neste documento dizem respeito a este arquivo csv.

Problema

Antes do IMCS 2.0.0.2

O formato de arquivo csv anterior ao IMCS 2.0.0.2 (ou seja, 2.0.0.1 e inferior) continha apenas endereços IP. Esses endereços IP foram fornecidos em todas as linhas, como mostrado na tabela aqui.

Formato inválido:

Os usuários às vezes inserem os endereços IP no sentido da coluna, conforme mostrado aqui.

   

IMCS 2.0.0.2 para IMCS 2.1.0.2

O formato foi alterado para pares chave-valor e suportou mais valores a serem fornecidos como parte do arquivo csv. Além disso, adicionou a flexibilidade para fornecer as entradas em qualquer sequência (ou seja, não há restrição estrita para fornecer as entradas em uma coluna específica). Por exemplo, as informações de contato podem ser fornecidas antes ou depois do endereço IP. As chaves são IP, Descrição, Localização, Contato, Marcas, Grupo de Rack.

Note: Os pares chave-valor omitidos não precisam ser fornecidos.

Por exemplo, se Description não estiver disponível para um servidor, o arquivo csv não precisará ter a entrada Description= para indicar que o valor está vazio. A primeira linha na captura de tela é um exemplo desse caso de uso.

Restrição:

A(s) chave(s) precisa(m) ser fornecida(s) em todas as linhas do arquivo csv.

Formato inválido:

   

Aqui estão alguns formatos inválidos encontrados no campo.

•    Fornecimento de todas as chaves:

As chaves que não têm valores são fornecidas no arquivo csv, o que causa uma exceção e faz com que a descoberta não aconteça. Na captura de tela aqui, as teclas Rack Group e Tags são fornecidas, embora não haja nenhum valor fornecido para elas.

•   Fornecimento das chaves como cabeçalhos e valores como entradas de coluna:

As chaves são fornecidas como cabeçalhos e os valores como entradas de coluna, como mostrado aqui. Isso causa o erro de que nenhum IP está disponível na primeira linha, o que resulta em nenhuma criação do perfil de descoberta.

Solução

IMCS 2.2.0.0

Daqui para a frente, o formato de arquivo csv é valores separados por vírgula, como mostrado aqui. As colunas são o endereço IP, a descrição, o local, o contato, o grupo de rack e as marcas. Você pode optar por omitir para fornecer os valores para entradas que não estão disponíveis/conhecidas no momento da criação do Perfil de descoberta.

As entradas não fornecidas são deixadas em branco, como mostrado na captura de tela aqui. No entanto, o campo de endereço IP é obrigatório.

Vários valores de tag podem ser fornecidos com valores delimitados por ponto e vírgula, como mostrado na captura de tela aqui.

Na captura de tela, há 2 tags (TagX e TagY) e o valor de cada tag associado ao servidor rack é ValueX e ValueY, respectivamente. Além disso, a coluna de contato pode ser qualquer valor de string, ou seja, pode conter ID de e-mail, número de telefone ou qualquer outro valor de string.

Alguns exemplos de entradas são mostrados na captura de tela aqui.

     

Note: Os formatos mais antigos não são suportados na versão IMCS 2.2.0.0

Restrição:

   

Restrições rígidas de coluna. Cada coluna deve conter apenas esse valor específico.

Perguntas freqüentes

(Q) O que acontece se o usuário tentar fornecer um csv com formato antigo no IMCS 2.2?

(A) O IMCS lança um erro no momento do upload para indicar que o formato é inválido.

(Q) Os valores de descrição, localização e marca podem aceitar espaços?

(A) Sim. Os espaços são aceitos nos valores Descrição, Localização e Etiqueta.

(Q) Os nomes de host podem ser fornecidos em vez de IPs na primeira coluna?

(A) Sim. Os nomes de host podem ser fornecidos.

(P) Se o grupo de racks não for mencionado, o que acontece?

(A) Se nenhum grupo de rack for especificado, o servidor de rack será adicionado em Grupo de Rack Padrão.

(P) O contato deve ser sempre uma ID de e-mail? Você pode fornecer um número de telefone ou outros valores?

(A) Sim, o contato pode ser qualquer valor. O IMCS aceita todos os valores de string.