Diretórios_CGIs:

• Observe que existe dois diretórios cgi no servidor um para utilização geral, acessado pelo nome: /cgi-bin2/ e outro seu particular, acessado pelo nome /cgi-bin/. Com o diretório cgi particular você poderá instalar e configurar seus próprios scripts cgi.

Como identificar um arquivo CGI:

• O arquivo do script deverá ter a extensão ".cgi". Caso seu arquivo original seja ".pl", renomei-o para ".cgi".
• As extensões: . arj .zip .tar .gz significam que o arquivo está compactado, assim, antes de instalar no servidor, você deverá descompactá-lo, utilizando por exemplo o Winzip.

Dezenas de scripts CGI disponíveis para Download:

• Scripts Perl para Unix, visite: Cgi-resources.

Localização absoluta do diretorio cgi particular no servidor:

• A localização absoluta do seu diretório cgi no servidor é: /www/sites/seu-dominio.com.br/cgi-bin
  Onde seu-dominio.com.br é o nome do domínio com sua respectiva extensão.
• A localização absoluta do seu diretório htdocs no servidor é: /www/sites/seu-dominio.com.br/htdocs

Como acessar via Web diretamente um arquivo CGI:

• Para ativar diretamente o script via web utilize o endereço (exemplo):
  http://seu-dominio.com.br.com.br/cgi-bin/arquivo.cgi
  Onde seu-dominio.com.br é o nome do domínio com sua respectiva extensão e arquivo é o nome de seu script.

Interpretador Perl 5:

• Para que seu script possa ser executado é necessário indicar a localização do interpretador Perl 5. Deste modo, a primeira linha do script CGI deverá ser:
  #!/usr/local/bin/perl

Path do Sendmail e Data:

Path do sendmail:
/bin/sendmail
Exemplo:
$mailprog = '/bin/sendmail';

Path da Data:
/bin/date
Exemplo:
$date = "/bin/date";

Como comandar permissão de execução de um arquivo .cgi:

• Os arquivos dos scripts precisam de comando de autorização para serem executados, leia as instruções de instalação do programa para saber quais os comandos que cada arquivo necessita. Para mudar a autorização utilize, por exemplo, a versão mais nova do WS_FTP e após selecionar o arquivo, aperte o botão da direita do mouse (opção "chmod UNIX").
  Exemplo para chmod 755 -> rwx wx wx
  Onde: r-ler, w-escrever, x-executar
• Veja tabela explicativa dos tipos de chmod em: http://unixhelp.ed.ac.uk/tasks/permissions_num.html
  r = 4 ; w = 2 ; x = 1
  Ex: chmod 755 -> (4+2+1) (4+1) (4+1) -> rwx r-x r-x

Como transmitir ao servidor arquivos .cgi:

Arquivos .cgidevem ser gravados em seu diretorio /cgi-bin/ particular, e arquivos do tipo .htm ou .html devem ser gravados em algum local dentro de seu diretorio /htdocs/ .
Arquivos CGI (Perl) são arquivos em modo texto e para o upload/download destes deve-se utilizar via FTP a opção ASCII.

Erros mais freqüentes e soluções:

• Erro 403 Forbidden
  Principal ocorrência: Falta de autorização de execução do arquivo (chmod).
  Solução: Veja no tópico acima "Como comandar permissão de execução de um arquivo .cgi:"
  como comandar as autorizações para os arquivos do sistema que esta instalando. Normalmente é necessário comandar a autorização chmod 755 para os arquivos executáveis (.cgi) e aqueles que serão alterados/modificados pelo próprio sistema. Caso seu script possua manual de instalação é provável que ele indique exatamente quais são as autorizações necessárias.

• Erro 404
  Principal ocorrência: Página não localizada.
  Solução: Veja se o diretório apresentado na mensagem corresponde a localização do arquivo e corrija o link utilizado para acesso a esta página. Note que para acesso web a seu diretório cgi deve se acrescida a expressão /cgi-bin/, exemplo: http://seu-dominio.com.br/cgi-bin/muscript.cgi

• Erro 500 A1 - Caso de script que ainda não funcionou no servidor
  Principal ocorrência: Erro de grafia ou de estrutura no texto do script ou erro na configuração das variávies do script.
  Solução1: Inicie a instalação configurando o mínimo necessário para que o script possa funcionar no servidor como teste. Deixe para configurar/personlizar aspectos secundários como (cor, tradução do texto, e outros opcionais) após ter certificado que o script funciona.
  Solução2: Certifique-se de ter serguido todas a orientações constantes nesta página de suporte, ter gravado os arquivos nos diretórios corretos, e configurado corretamente as variáveis normalmente solicitadas logo no inicio do texto do próprio script.

• Erro 500 A2 - Caso de script que ainda não funcionou no servidor
  Principal ocorrência: Arquivos do script enviados ao servidor em modo Binary quando o correto seria em modo Ascii.
  Solução1: Via FTP, reenvie ao servidor os arquivos: .cgi, .pl, .txt e demais arquivos texto do script em modo Ascii.

• Erro 500 B - Caso de script que já funcionou no servidor
  Principal ocorrência: Erro de grafia ou de estrutura no texto do script.
  Solução1: Quando for fazer alterações/personalizações nos códigos html inseridos nos scripts, tenha sempre em mente que alguns caracteres como as aspas, apóstrofos e arrobas são considerados caracteres de código pela linguagem Perl (CGI). Assim quando for inserir caracteres especiais do Perl(CGI) como caracteres normais, estes deverão ser precedidos de uma barra invertida ("\"). Exemplo:
  Original:
  print "<body>\n";
  Modificado:
  print "<body BACKGROUND=\"fundo-2.gif\">\n";
  Solução2: Após a primeira instalação do script e sempre que realizar alterações no mesmo, mantenha sempre guardada uma cópia de segurança dos arquivos do sistema, para que na ocorrência de este erro você possa reestabelecer o sistema da útima vez que estava funcionando antes ter realizado mudanças no mesmo. Isto porque é muito difícil localizar erros em scripts cgi, sendo, na maioria da vezes, menos trabalhoso a reistalação do mesmo.

Recomendações/Restrições:

• Após a primeira instalação do script e sempre que realizar alterações no mesmo, mantenha sempre guardada uma cópia de segurança dos arquivos do sistema.
• A utilização de programas de Chat geram potencialmente ocorrências de problemas para o funcionamento do servidor. A istalação deste tipo de programa é permitida sob prévia consulta a Sede e deste que respeitados os limites de hits estipulados para o plano de hospedagem. Recomendamos no entanto o aluguel de salas de chat disponibilizadas prontas pela Sede, consulte-nos.
• Qualquer programa instalado na Sede é para exclusiva utilização do próprio Cliente, não podendo ser repassada (a utilização) a terceiros. Por exemplo, você pode instalar um fórum web para seu próprio gerenciamento e proveito, assim como de seus Clientes de domínio, mas não pode instalar para um amigo utilizar (tomar proveito) como se dele fosse o sistema.

Sugestões/Colaboração:

• Sugestões e colaborações são sempre bem vindas. A Sede aguarda suas sugestões de novos programas a serem por nós disponibilizados já pré-configurados, assim como o envio de algum script de interesse geral que você esteja utilizando para disponibilização aos demais Cliente