Para o Greenstone funcionar adequadamente, as permissões de acesso para certos arquivos devem ser configuradas de modo apropriado. Além disso, há um arquivo de configuração associado a cada site do Greenstone. O procedimento de instalação cria uma configuração genérica baseada nas suas opções de instalação; entretanto o seu conteúdo pode ser adaptado a diferentes situações. Esta seção explica estas duas questões.

Esta seção é irrelevante para Windows 95/98, pois estes sistemas não identificam os donos de arquivos.

Nos ambientes Windows NT, 2000 e Unix, os scripts cgi não são executados como usuários normais, pois os usuários não podem ser identificados na Web. Ao invés disso, eles utilizam o usuário que iniciou o servidor web (nos sistemas Windows), ou um usuário especial (geralmente chamado de nobody ou ninguém em ambientes Unix). Por isso todos os arquivos e diretórios em C:\Program Files\gsdl precisam ter permissão de leitura (ou talvez ao menos o usuário do script-cgi, chamado de “ninguém”, deve ter esta permissão) . Para testar se as permissões dos arquivos foram configuradas de forma correta, execute o programa library.exe da linha de comando. Se os arquivos estão localizados corretamente, porém com as permissões configuradas erroneamente, ele conseguirá executar da linha de comando - isto é, quando você executá-lo -porém não de um navegador. Um outro teste possível é realizar o login como outro usuário para verificar se as permissões de arquivo são específicas para o seu usuário original.

Para trabalhar com um navegador web, todos os diretórios do Greenstone devem ter permissão de leitura. Além disso, o diretório C:\Program Files\gsdl\etc e todo o seu conteúdo devem ter permissão de escrita. Este é o diretório no qual o programa da biblioteca escreve o log de utilização, erro e inicialização, além de vários bancos de dados de usuários. Se você tem dúvidas em ter este diretório com permissão de escrita, você pode configurá-lo para que somente os arquivos errout.txt, initout.txt, key.db, users.db, history.db e usage.txt tenham permissão de escrita pelo usuário cgi.

Se as permissões dos arquivos não estiverem configuradas de maneira correta para C:\Program Files\gsdl\etc, provavelmente você terá problemas com a autenticação de usuários e a busca no histórico, além da falta de geração do log de utilização (usage.txt).

O procedimento de instalação cria um arquivo de configuração genérico do Greenstone baseado nas escolhas de sua instalação. Em nossa instalação o arquivo é C:\Program Files\gsdl\cgi-bin\gsdlsite.cfg e o conteúdo está listado a seguir:

# Site configuration file for Greenstone.
# Lines begining with
# are comments.
# This file should be placed in the same directory as your library
# executable file. it should be edited to suit your site.
# points to the GSDLHOME directory
gsdlhome “C:/Program Files/gsdl ”
# this is the http address of GSDLHOME
# if your webservers DocumentRoot is set to $GSDLHOME
# then httpprefix can be commented out
httpprefix /gsdl
# this is the http address of the directory which
# contains the images for the interface.
httpimg /gsdl/images
# should contain the http address of this cgi script. This
# is not needed if the http server sets the environment variable
# SCRIPT_NAME
#gwcgi         /cgi-bin/library
# maxrequests is the most requests a fastcgi process
# will serve before it exits. This can be set to a
# low figure (like 1) while debugging and then set
# to a high figure (like 10000) when everything is
# working well.
#maxrequests 10000

Você poderá costumizar a sua instalação editando este arquivo, embora provavelmente você não precisará fazer isso.

A linha gsdlhome simplesmente direciona para o diretório C:\Program Files\gsdl.

httpprefix é o endereço web do diretório em que o Greenstone está instalado. Nós explicamos anteriormente como criar um alias para que URLs da forma http://localhost/gsdl/ … sejam buscadas no diretório C:\Program Files\gsdl. A inserção da linha httpprefix/gsdl no arquivo de configuração gsdlsite estabelece a mesma convenção para o Greenstone.

httpimg é o endereço web do diretório C:\Program Files\gsdl\images; ele contem todas as imagens gif utilizadas na interface. Em qualquer instalação padrão do Greenstone este diretório sempre será httpprefix/images, e a linha no arquivo acima geralmente não é modificada.

gwcgi é o endereço web do programa cgi da biblioteca. Ele não é requerido pela maioria dos servidores web (incluindo o Apache), e deveria continuar comentado. Não retire o comentário ao menos que você tenha certeza da necessidade de fazê-lo, pois isto pode causar problemas.

maxrequests somente é utilizado por versões do Greenstone compiladas com a opção “fast-cgi”. A versão de distribuição binária não inclui esta opção porque nem todos os servidores web estão configurados para suportá-la. Fastcgi aumenta a velocidade de execução dos programas cgi mantendo-os na memória entre as chamadas do software, ao invés de carregá-lo do disco cada vez que uma página é requisitada pelo Greenstone. Porém a quantidade de memória utilizada pode aumentar, quanto maior o tempo que o programa estiver na memória. Uma vez que o número máximo de requisições de páginas maxrequests forem geradas, o programa cgi é finalizado, liberando a memória acumulada. Para responder à próxima requisição por uma página Web, o programa cgi é lido do disco novamente, e um novo ciclo de requisições de páginas é iniciado. A maioria das instalações utilizam o protocolo padrão cgi, o que significa que o número máximo de requisições de páginas maxrequests pode ser ignorado de maneira segura.