[Dica] DWWW - "Not Found" e "Internal Server Error" - como corrigir / resolver

[Sampayu]

Originalmente desenvolvido para a distribuição Debian e posteriormente portado para distribuições *Ubuntu, o pacote dwww (abreviação de "Debian WWW") possibilita acessar as páginas manuais (os manuais que compõem a documentação do sistema Linux e que, em inglês, são denominados manpages) diretamente no navegador web (browser), bastando para tanto acessar http://localhost/dwww/index.html - e isso torna o acesso e a leitura das manpages muito mais fácil, rápida, prática, versátil e confortável.

No entanto, pelo menos na versão 1.13.1, dois problemas ocorrem durante a instalação do dwww:
1) O módulo CGI do servidor web Apache não é ativado, embora a ativação dele seja necessária para o correto funcionamento do dwww, tendo em vista que o dwww essencialmente cria um website baseado em CGI (páginas dinamicamente geradas a partir de scripts) e necessita do servidor web Apache instalado, ativo (em execução) e com suporte a CGI ativado, para que o Apache possa executar esse website do dwww a partir de um servidor virtual; e
2) Contém um erro de grafia no parâmetro Last modified do script dwww-convert, o que impossibilita o funcionamento do módulo CGI do Apache, quando esse módulo está ativado.

É graças ao problema 1 que qualquer tentativa de acesso ao dwww fará com que o navegador web mostre a seguinte mensagem de erro:

Not Found

The requested URL /cgi-bin/dwww was not found on this server.

...e é graças ao problema 2 que, quando o problema 1 for resolvido (e, portanto, o dwww estiver funcionando), qualquer tentativa de acessar uma página manual via dwww fará o navegador web mostrar uma mensagem de erro que começa assim:

Internal Server Error

The server encountered an internal error or misconfiguration and was unable to complete your request.

Para resolver o problema 1, abra uma janela do emulador de terminal do shell Linux e execute este supercomando:

Código Selecionar Expandir

sudo a2enmod cgid ; sudo service apache2 restart

...que instruirá o servidor Apache a ativar o cgid, que é o daemon (serviço de ativação automática) do módulo CGI, e em seguida reiniciar a si mesmo, de modo que essa ativação do CGI surta efeito no servidor Apache.

Para resolver o problema 2, retorne à janela do emulador de terminal do shell Linux e execute este supercomando:

Código Selecionar Expandir

sudo sed -i -e 's|Last modified: |Last-modified: |' "/usr/sbin/dwww-convert" ; sudo service apache2 restart

...que renomeará o parâmetro Last modified para Last-modified, dentro do script dwww-convert, e em seguida reiniciará o servidor Apache, para que essa modificação surta efeito. Por incrível que pareça, essa pequena diferença de grafia do parâmetro é a culpada pelo problema 2.

Uma vez sanados os dois problemas acima, o dwww deverá funcionar normalmente.

Nota de rodapé:
Caso os comandos da dica acima não tenham resolvido o problema, certifique-se de que o Apache esteja instalado e em execução. Você pode desinstalar o Apache e o dwww, em seguida instalá-los novamente e então colocá-los em execução por intermédio deste supercomando, a ser executado no terminal do shell:

Código Selecionar Expandir

sudo apt-get purge apache2 dwww -y ; sudo apt-get update ; sudo apt-get check ; sudo apt-get autoremove -y ; sudo apt-get clean ; sudo apt-get install apache2 dwww --reinstall -y ; sudo service apache2 stop; sudo service apache2 start

...e então experimente repetir os comandos da dica acima, para se certificar de que os problemas 1 e 2 não ocorram após o Apache e o dwww serem reinstalados. 

[galactus]

Sampayu com sua dicas Ninjas!

Como sempre, mantendo o excelente  nível de seus tutoriais!

[Sampayu]

Sampayu com sua dicas Ninjas!

Como sempre, mantendo o excelente  nível de seus tutoriais!

Obrigado, galactus.