Este documento discute a importância da documentação da infraestrutura de rede e fornece exemplos do que deve ser documentado, incluindo diagramas de rede, ativos de rede, endereçamento IP, internet, servidores e políticas. Ele também enfatiza a necessidade de manter a documentação atualizada através de uma política de atualização.

1. Documentação da Infraestrutura de Rede
09, de março 2012 Infraestrutura Administração em Sistemas.
A tarefa de documentar a infraestrutura de rede é encarada muitas vezes como
uma atividade burocrática e tediosa. Entretanto, a documentação é uma boa prática de
contribui para melhorar o gerenciamento da rede e para que os profissionais sejam
mais produtivos.
O ideal seria que a documentação fosse elaborada e atualizada automaticamente
por alguma ferramenta. Caso isto não seja possível, inicie com uma documentação
básica e vá incrementando até atender as suas necessidades.
No meu caso eu uso o Word para ir criando os diagramas, mas é claro caso você
conheça um Software Livre mais apropriado para desenho dos diagramas de topologia,
favor compartilhe nos comentários.
Com o crescimento da rede o modelo de documentação inicial mostrou-se
inviável. Procurei ferramentas mais adequadas e optei por implantar o uso do Google
Doc http://www.google.com/google-d-s/hpp/hpp_pt-PT_pt.html (link para quem tiver
interesse), assim cada membro da equipe DEVE registrar todas as alterações realizadas.
Dessa forma facilitava as tarefa, modifica e já estava disponível para toda a equipe,
claro há outras formas, mas estou compartilhando a minha experiência.
O que documentar?
Não é simples elaborar e, principalmente, manter atualizada a documentação da
rede. Os itens que compõe a documentação variam muito de acordo com a
complexidade do ambiente de rede e da metodologia de trabalho adotada.
Encontrei na internet algumas boas sujeitões de modelo de documentação de
rede, que em minha opinião contendo uma lista mínima de itens que, deveriam constar
em uma boa documentação de rede e ainda sim tem quando alguém se da ao trabalho
para fazê-la deixa muito a desejar:
DOCUMENTAÇÃO DA INFR-ESTRUTURA DE TI
Topologia de rede
Diagrama da topologia lógica
Diagrama de Vlans

2. Diagramas da topologia física
Estrutura da árvore LDAP (ou Active Directory, ser for o caso)
Topologia do Storage
Layout do datacenter e dos racks.
Ativos de rede
Roteadores (nome, IP, marca, modelo, localização)
Switches (nome, IP, marca, modelo, localização)
Firewalls (nome, IP, marca, modelo, localização)
Centrais telefônicas
Endereçamento IP e roteamento
Mapa de endereços IPs (Ex: classe C com IPs válidos da empresa)
Subredes utilizadas (endereço de rede, máscara, default gateway)
Esquema de roteamento
Internet
Qual o provedor do seu link Internet
Tecnologia utilizada (MPLS, Frame Relay)
Número de circuito, telefone de suporte, SLA
Lista dos domínios que sua empresa registrou e qual a data de expiração
Servidores DNS e registros DNS existentes (A, Mx, etc)
Documentação dos servidores
Nome do servidor, IP, Finalidade, SO instalado
Informações de hardware do servidor (processador, memória, disco, partições)
Serviços instalados
Documentação da instalação
Políticas e procedimentos
Política de Segurança
Checklist de instalação de servidores
Padrões para criação de contas de usuários e grupos

3. Padrões de nomenclatura para equipamentos de rede e servidores
Lista dos serviços críticos
Softwares adquiridos
Número de licenças, versões
Modalidade de licenciamento
Hardware adquirido
Marca, modelo, especificações
Data de aquisição
Detalhes de garantia
Imagens de instalação dos PCs
Scripts base de configuração dos switches
Telefones de contato
0800 do fornecedor do link Internet
Telefones dos prestadores de serviços e fornecedores
Telefones para acionar a garantia de equipamentos
Além de incluir uma boa documentação não se esqueça de definir uma Política
de Atualização e documentar a mesma, para que esta não se torne desatualizada e
inútil. Liste os responsáveis pelas atualizações, períodos, revisão e padrões que devem
ser utilizados.
Em caso de falhas em serviços críticos, as informações de configuração contidas
no repositório podem ajudar a minimizar o tempo de recuperação destes serviços.
A importância da documentação é tão grande, pois se um dia a pessoa
responsável pelas área sai da empresa, o conhecimento acumulado estará registrado e
disponível para que possa substituir esse profissional outros da equipe, bem mais fácil,
economizando tempo e dinheiro.
Exemplo de documentação, links abaixo:
http://www.silvio.me/wp-content/uploads/2009/07/Modelo-Documentacao-
Rede.pdf