O que eu uso para manter a documentação do servidor?

4

Eu tive que documentar os servidores que eu uso e não sei o que usar para armazenar os dados. Você poderia sugerir a melhor maneira de manter a documentação do servidor? Eu crio uma base de dados que contém a documentação de harware e software, ou eu uso páginas wiki ou SVN? Ou se houver uma ferramenta que armazene a documentação, forneça o link.

    
por Radu 27.03.2012 / 17:25

11 respostas

4

Eu pessoalmente uso um pequeno programa chamado The Guide , que eu acho muito mais rápido do que usar um wiki (que eu também uso) . Você pode até incorporar arquivos do Excel diretamente nas páginas, assim como muitos outros tipos de arquivos.

Há uma versão portátil , para que você possa levá-la em qualquer lugar em uma unidade flash USB. Eu só queria que houvesse um cliente Linux que pudesse ler os mesmos arquivos.

No entanto, um wiki ou o Google Docs é melhor para colaboração.

    
por 27.03.2012 / 20:43
4

Não há uma maneira melhor de fazer isso. Depende strongmente do ambiente, das pessoas, dos sistemas, do orçamento e das preferências individuais.

Antes de escolher a melhor opção, você precisa entender seus requisitos. Requisitos específicos, não apenas "onde eu coloco minha documentação?" Qual hardware / software você tem disponível agora? Quantas pessoas estarão usando isso? Qual orçamento eu tenho para hardware e / ou software? Isto é apenas para documentação do servidor, ou outra documentação técnica será incluída? Outros grupos precisarão de acesso à documentação? Quão segura a documentação precisa ser? Depois de responder a algumas delas, você pode conferir suas opções.

Se você é uma loja da Microsoft, provavelmente está indo em direção às ferramentas deles. Se você é uma loja de ferramentas Open Source, provavelmente tenderá para algo Open Source. Se você gosta da capacidade de fazer mudanças rápidas, um Wiki é um ótimo caminho a percorrer. Se você gosta de sua documentação separada em conjuntos de arquivos, um compartilhamento de arquivos ou o SharePoint pode ser a solução correta. Se você gosta de muitas capturas de tela para acompanhar sua documentação, o OneNote pode ser a resposta certa. Se você quer algo semelhante a Wiki, mas auto-contido (Wiki-in-a-file), então o TiddlyWiki é uma ótima ferramenta.

Entre suas muitas opções (não uma lista abrangente):

O mais importante é que você use algo . Documentação é fundamental. Além disso, certifique-se de mantê-lo simples e com pouca sobrecarga. É tão importante manter a documentação atualizada quanto escrevê-la na frente. Se a atualização de sua documentação não for tão fácil quanto possível (e incluída em políticas para ajudar a garantir que ela seja atualizada), as pessoas não farão isso. Você não quer que as pessoas ignorem as atualizações da documentação porque é um saco para atualizar.

    
por 27.03.2012 / 17:52
3

Bem, não sei quais são seus requisitos específicos em detalhes, mas posso aconselhá-lo sobre o que evitar (com base na minha experiência pessoal).

Não use documentos de escritório para documentação, como o OpenOffice ou o Word, pois eles armazenam seus dados em seus próprios formatos, como .doc ou .odt. Isso pode ser muito doloroso quando você muda para outro sistema de documentação depois.

Também posso aconselhar você a não armazenar sua documentação em arquivos .txt. Embora sejam fáceis de manusear (podem ser movidos sem grandes esforços, podem ser pesquisados, etc.), esta é uma maneira muito ineficiente de organizar suas coisas. Especialmente quando você deseja incorporar imagens ou vídeos em seus documentos.

O SVN não é uma maneira ruim de manter seus dados, mas tem desvantagens quando você deseja permitir que outros usuários acessem seus dados. Além disso, você precisa fazer atualizações de svn, checkouts etc. o tempo todo. Isso pode ser irritante (eu tenho repositórios de documentação do SVN eu mesmo ..).

A melhor maneira que vi até agora é usar um Wiki ou uma combinação de um CRM (usamos o Sugar CRM) e o sistema de arquivos. Eu prefiro sistemas Wiki quando eles têm um sistema de controle de versão e gerenciamento de usuários. Isso permite uma colaboração fácil, você pode fazer quase tudo e é livre na maneira como se organiza.

    
por 27.03.2012 / 19:54
3

Temos usado o Device42 para documentação de servidores e datacenters. Ótima ferramenta e esses caras estão constantemente adicionando recursos. Também não é muito caro, cerca de US $ 250 para 100 dispositivos.

    
por 04.04.2012 / 08:23
2

Eu darei minha recomendação pessoal para o OneNote. É a capacidade de rapidamente capturar screenshots de instalação e alterações (e então realmente poder pesquisar o texto NAS IMAGENS ) com o win-S é um recurso matador.

    
por 27.03.2012 / 18:04
1

Nós usamos Wiki aqui. Ótima ferramenta, especialmente se você estiver compartilhando documentos para edição internamente

    
por 27.03.2012 / 17:45
1

Pastas com planilhas com informações sobre cada servidor, docs / pdfs de manuais do usuário, informações de contato para OEMs / VARs / Suporte, etc.

Então pegue algo como dropbox / sugarsync / etc. e verifique se você está sincronizando tudo na Web para que qualquer coisa que você atualize seja replicada. Você vai gostar disso em uma situação de DR.

    
por 27.03.2012 / 17:53
1

O que eu fiz é:

Documentou cada servidor no MS Word:

A documentação inclui: a) Detalhes do hardware do servidor (Número de NICs, Controladores RAID, versões de firmware de cada placa, versão da BIOS, número de discos físicos e versões de firmware.

b) Layout Raid: Tipo de Raid Level (s), membros de disco físico em discos virtuais, números de disco do Windows (isso me ajuda a identificar qual disco do Windows é o que está no meu servidor e nível de invasão).

c) Configuração de Rede: Configurações de IP, Configurações de Firewall, portas de entrada permitidas, saída permitida / não permitida.

d) Sistema operacional instalado: Versão, chave usada, data de instalação, local do arquivo de página, quaisquer outros despejos de driver ou aplicativos que eu tenha mantido nele, aplicativos instalados e sites da Web (se necessário).

e) Suporte ao servidor / suporte do fornecedor: tipo de suporte, número de contato, etiqueta de serviço.

Eu usei o Diagrama de Topologia do AD para visualizar nossa infraestrutura do AD e salvei como PDF.

Eu tenho um script instalado chamado "Racktables" que é opensource, usa um banco de dados mysql - muito fácil de configurar.

O que eu uso para Plot my Rakks Server Room e há servidores, então eu converto os arquivos do MS Word para PDF e anexar a esses racks.

Você também pode usar o script do projeto SYDI Documentation para documentar seus servidores: link

Espero que ajude Rihatum

    
por 27.03.2012 / 18:56
1

No lado do código aberto, dedicado a guardar documentação em computadores, software, impressoras (e como isso mudou com o tempo) é GLPI .

Para recursos adicionais, há também uma base de conhecimento, sistema para rastrear quais computadores estão conectados onde (no nível da rede). Incluiu sistema de tickets para relatar / resolver problemas e help desk.

    
por 04.04.2012 / 09:11
0

O NodeSystems foi projetado para manter a documentação do servidor. Como efeito colateral, também gera um diagrama interativo.

Confira a demonstração on-line aqui: link

    
por 04.07.2014 / 19:36
-1

Confira o link do SCC (coletor de configuração do servidor) que tem clientes para o Win32, a maioria dos Linux e outros Un * x para obter informações de configuração e mantém atualizado com versionamento para auditorias, etc.

Em uma empresa anterior, adicionamos um arquivo de texto baseado nele ao servidor, que é então analisado para ajudar a "documentar" a função / proprietário do servidor específico, etc.

Mas, sim, ainda há a necessidade de um compartilhamento de documento / wiki para coisas como adicionar / remover discos neste ou naquele sistema para os operadores e a equipe de suporte.

    
por 09.07.2013 / 13:55