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
  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
           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 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 o responveis pelas
áreassai 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

Documentação da infraestrutura de rede

  • 1.
    Documentação da Infraestruturade 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
  • 2.
    Diagrama de Vlans 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
  • 3.
    Padrões para criaçãode contas de usuários e grupos 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 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 o responveis pelas áreassai 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