Documentar adequadamente as instalações de novas tecnologias raramente usadas

Question

Recebi a tarefa de verificar se uma combinação de NoSQL (neste caso, possivelmente, Neo4J ) e SQL-Server é uma solução possível para um problema de desempenho que temos tido.

Parte da minha análise técnica é a manutenção e estabilidade da plataforma.
E isso significa que eu preciso encontrar uma maneira de documentar adequadamente e manter aplicativos (o NoSQL) que raramente são usados. Em combinação com um aplicativo, temos diretrizes específicas e rígidas para (o SQL-Server).

A minha preocupação é principalmente que quando eu reviso configurações similares feitas no passado, aplicações únicas tendem a cair na caixa preta situações, apesar de terem sido originalmente criadas internamente.
Aqueles que não são black boxes tendem a cair sobre os ombros de uma única pessoa infeliz que acaba passando a maior parte do seu dia de trabalho mantendo e lidando com alguma tecnologia antiquada do banco de dados de acesso que ninguém quer tocar e é aparentemente crítico para a missão.

Como você, como o sortudo sysadmin que tem a tarefa de configurar e documentar esta plataforma, garante que sua monstruosa configuração impressionante resista ao teste do tempo? < br> Como as pessoas geralmente lidam com aplicativos menores em grandes corporações, esperançosamente, sem amarrar permanentemente seu próprio nome ao aplicativo?

    

Answer 1

Meu primeiro bloco de construção essencial é um plano de recuperação de desastres para a configuração impressionante em questão, por exemplo. uma receita passo a passo para reconstruí-lo do zero e restaurar seus dados do último backup. Isso inclui uma lista de componentes necessários e onde obtê-los, configuração completa e o procedimento para uma restauração completa dos dados do aplicativo a partir do último backup. Escrevendo e testando tal plano irá revelar muitos dos buracos mais abertos no conceito operacional, como dados que devem ser incluídos no backup, mas não, dependências esquecidas ou softwares dos quais ninguém sabe onde veio de.

O segundo bloco de construção essencial é um manual de operações que abrange as tarefas que ocorrem durante a operação regular. Isso também precisa ser testado , de preferência com um administrador que não esteja familiarizado com a configuração incrível executá-lo por esse período por um período de tempo relevante, com o administrador regular o fundo tomando notas e estando disponível em caso de emergências.

Se a configuração impressionante é de missão crítica, seu plano de recuperação de desastres será incluído nos exercícios regulares de emergência exigidos pelo seu SGSI. As férias anuais do administrador regular são uma oportunidade natural para testar novamente o manual de operações. Então, ambos são periodicamente verificados para estarem atualizados.

É claro que tudo isso cai se você não conseguir classificar a configuração incrível como missão crítica para começar.

    

Answer 2

De modo geral, eu divido minha documentação em vários estágios. O primeiro estágio é o desenvolvimento que é cronológico e documenta todas as etapas realizadas para criar o aplicativo. Eu começo com uma declaração de missão clara, seguida por uma lista de requisitos. Cada passo do desenvolvimento é então adicionado à medida que é concluído. Eu achei o vídeo capturando minhas sessões uma grande memória solicitando suporte. Pessoalmente eu uso um Ticket System (no meu caso RT) para este estágio da documentação.

O segundo estágio vem depois que o aplicativo foi testado & liberado. Aqui documentei a instalação (software, pacotes, ambiente requeridos). Tudo necessário para recriar o aplicativo. A última etapa é documentar os procedimentos de manutenção. Apenas aqueles procedimentos que são particularmente complicados são documentados.

Por fim, publico o segundo & último estágio em um wiki. Parece muito trabalho, mas quando a documentação se torna parte da sua rotina de trabalho, você realmente não percebe mais. E, claro, as chances de estar ligado a um desenvolvimento são drasticamente reduzidos.

Espero que isso tenha sido útil.