Procedimentos ou ferramentas da documentação da instalação do software complexo [fechado]

Question

Precisamos distribuir e manter um aplicativo de software um tanto complexo, cujo instalador não instala nem configura todas as partes necessárias em qualquer tipo possível de servidor (nem é esperado que ele).

Eu fui a pessoa responsável pela instalação até agora e tenho conhecimento de todas as muitas armadilhas e truques para fazer com que a instalação funcione sem problemas. Agora, temos mais pessoas que queremos treinar neste procedimento e esperamos minimizar minha necessidade de segurá-las enquanto elas estiverem aprendendo.

A coisa é, um documento linear para todos os casos possíveis estaria longe de ser ideal, porque há muitos caminhos possíveis no processo, dependendo do ponto de partida (Windows Server 2003 32/64 bits, Windows Server 2008 32/64 bits , SQL Server 2005 32/64 bits, Windows XP Pro SP2 / SP3, .NET 2.0 SP1 / SP2) e em todos os problemas possíveis que surgem em cada combinação.

Então, estou procurando uma ferramenta projetada com este cenário em mente, gerando documentação com base em um conjunto de parâmetros de entrada (configuração das máquinas) ou, melhor ainda, uma ferramenta que guiará o processo de instalação. com base no que está acontecendo e que pode registrar novos problemas e mapeá-los para soluções conhecidas.

Eu posso imaginar escrever tal ferramenta, mas não parece um problema (muito) trivial. Esta parece ser a interseção de uma base de conhecimento e um sistema especialista.

Então, o que você faz? Assuma a derrota e tenha enormes documentos lineares e FAQs como KBs?

    

Answer 1

Tudo bem, tenho dois comentários. Primeiro, aquele que você quer ouvir (embora você provavelmente não esteja esperando isso).

O Mecanismo de Gamebook ( link ) parece que pode ser o que você quer, já que você está essencialmente falando sobre um " Crie o seu próprio tipo de aventura. Vá para a página 45 se você estiver instalando no Windows XP, página 26, se você atacar o druida.

2º comentário: Você provavelmente está fazendo isso da maneira errada. O que você realmente deve fazer é escrever um wrapper para esse instalador que seja inteligente o suficiente para conhecer suas plataformas e tenha instruções específicas necessárias para essa plataforma. É (talvez) mais trabalho, mas parece que vai poupar tempo a todos a longo prazo.

    

Answer 2

O problema com a instalação linear é a falta de idempotência, ou a capacidade de repetir a tarefa repetidamente com os mesmos resultados, e se ocorrer uma falha, ela pega exatamente onde foi quebrada (depois de consertar o que a quebrou, Claro: -)).

Se uma instalação manual falhar na metade, você geralmente terá que desfazer tudo de novo. Digite o fator humano e você pode ter um desastre esperando para acontecer.

Eu não tenho uma resposta para o mundo do Windows, mas o Unix / Linux tem duas excelentes ferramentas de gerenciamento de configuração que são projetadas para idempotência: Chef e Puppet. Embora os procedimentos de instalação linear possam ser desejados para algumas coisas, essas ferramentas serão retomadas de onde parou se algo inesperado ocorreu e algo não foi instalado completamente.

    

Answer 3

Eu provavelmente seguiria o caminho do wiki: Usando uma página wiki por questão de configuração com links para outras páginas wiki, dependendo das respostas. O fluxo através da instalação seria representado seguindo os links correspondentes. Conforme surgem novos problemas, você cria novas páginas wiki.

Em seguida, dependendo do wiki, você poderá imprimir as páginas wiki de maneira agradável e combiná-las na ordem desejada para as diferentes instalações do servidor.

    

Answer 4

Por que não criar uma página html portátil com links que podem ser abertos em um navegador com uma navegação no estilo do assistente, ou seja, "clique neste link se você tiver um servidor windows 2003", etc. etc.