GUIA DE INSTALAÇÃO
Contents
1. 1 Selecione Avan ado para obter a tela Op es Avan adas 2 Selecione Home e cllique em Adicionar Preencha os campos como mostrado a seguir Campo Directory C Program Files gsal Campo Alias gsdl Permiss es de Acesso Ler Permiss es de Aplica o Nenhuma Clique OK Isto tornar os arquivos do Greenstone acess veis ao servidor web 3 Retorne a op o Op es Avan adas selecione gsdl e clique Adicionar Preencha os campos como mostrado a seguir Campo Diret rio C Program Files gsdl cgi bin Campo Alias cgi bin Permiss es de Acesso Nenhuma Permiss es da Aplica o Executar Clique em OK Isto permite que o programa library exe do Greenstone seja executado pelo servidor web 4 Ir para a URL http localhost gsdl cgi bin library exe Nota voc precisa especificar a extens o exe com o PWS e IIS 19 Configurando o seu Site 5 Configurando o seu Site 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 5 1 As Permiss es de Arquivos Esta se o irrelevante para Windows 95 98 pois estes sistemas n o identif2. los de serem processados pelo interpretador da linguagem macro Note que a defini o da macro content n o cont m nenhum cabe alho ou rodap html Se voc deseja modificar o cabe alho ou o rodap de sua p gina voc deveria definir as macros header para cabe alho e ou footer para rodap adicionando as ao arquivo yourhome dm no formul rio 23 Personalizando sua Instala o _macroname_ e Por exemplo a barra verde do lado esquerdo abaixo nas p ginas do Greenstone definida pela macro do cabe alho header e quando ela tem o valor null ela ser removida como indicado no final da figura 4 6 2 Como fazer as coisas funcionarem Voc ter que contar para o Greenstone sobre sua nova home page yourhome dm O sistema l os arquivos macro que est o especificados no arquivo de configura o central main cfg ent o caso voc crie algum arquivo novo voc deve inclu lo no arquivo central A ordem nos nomes faz diferen a as defini es mais recentes t m preced ncia Assim para fazer o software da biblioteca digital do Greenstone utilizar a home page na figura 3 ao inv s da padr o primeiro coloque o arquivo yourhome dm na figura 4 no diret rio macros Ent o edite o arquivo de configura o main cfg para substituir o home dm com yourhome dm na lista de arquivos macro que s o carregadas na inicializa o 6 3 Redirecionando a URL para o Greenstone Voc poder querer redirecionar uma URL mais conven
3. o podem ser acionadas desde que haja metadados adequados dispon veis Ela incluida automaticamente quando o software instalado O Greenstone tamb m prov algumas cole es exemplo bem documentadas cuja p gina sobre descreve como foram constru das Estas cole es demonstram v rias capacidades do Greenstone O programa de instala o perguntar se voc quer inclu las na sua instala o pessoal o espa o de disco aproximado requerido para cada cole o mostrado abaixo 14 As Cole es do Greenstone demo dls e wrdpdf e gsarch e cltbib e cltext e MARC e oai e image e authen e garish isis e O Demo do Greenstone 7 Mb cole o Subconjunto da Biblioteca de Desenvolvimento 150 Mb Demonstra es MSWord e PDF 4 Mb A Cole o dos Arquivos Hist ricos do Greenstone 5 Mb Cole o Bibliogr fica 7 Mb Suplemento Bibliogr fico 1 Mb exemplo com MARC 1 Mb A cole o Demo do OAI 18 Mb Cole o simples de imagens 1 Mb A formata o e autentica o da cole o demo 8 Mb Vers o Garish da cole o demo 8 Mb exemplo CDS ISIS 1 Mb Um pequeno subconjunto da HDL Se voc criar uma segunda c pia desta cole o os recursos completos somente aparecem se os seus novos arquivos fornecerem as informa es apropriadas de metadados Da mesma maneira que o Demo Greenstone este um subconjunto da HDL por m bem maior Ela cont
4. Cover Texts you must enclose the copies in covers that carry clearly and legibly all these Cover Texts Front Cover Texts on the front cover and Back Cover Texts on the back cover Both covers must also clearly and legibly identify you as the publisher of these copies The front cover must present the full title with all words of the title equally prominent and visible You may add other material on the covers in addition Copying with changes limited to the covers as long as they preserve the title of the Document and satisfy these conditions can be treated as verbatim copying in other respects If the required texts for either cover are too voluminous to fit legibly you should put the first ones listed as many as fit reasonably on the actual cover and continue the rest onto adjacent pages If you publish or distribute Opaque copies of the Document numbering more than 100 you must either include a machine readable Transparent copy along with each Opaque copy or state in or with each Opaque copy a computer network location from which the general network using public has access to download using public standard network protocols a complete Transparent copy of the Document free of added material If you use the latter option you must take reasonably prudent steps when you begin distribution of Opaque copies in quantity to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the
5. es de arquivos corretamente em alguns diret rios e voc ser questionado para dar estas informa es necess rias Finalmente ser requisitada a voc uma senha para o usu rio administrador admin Por default todo o software Greenstone instalado no diret rio usr local gsdl caso seja o usu rio raiz que est realizando a instala o e caso contr rio no diret rio gsdl onde o diret rio home do usu rio A instala o do c digo bin rio leva somente alguns minutos com tempo suficiente para voc responder as quest es apropriadas Se voc instalar o c digo fonte o script de instala o ir compil lo o que pode levar de dez minutos a uma hora dependendo da velocidade de seu processador Para desinstalar o software digite cd gsdl ou usr local gsdl caso seja o usu rio raiz quem tenha instalado o Greenstone sh Uni nstall sh Durante o procedimento de instala o voc ser questionado se voc quer instalar alguma cole o do Greenstone A cole o Demo do Greenstone instalada automaticamente outras cole es do CD ROM s o descritas na se o 3 A configura o do servidor web Unix Se voc j tem um servidor web algumas pequenas mudan as ser o necess rias na configura o para a instala o do Greenstone O script de instala o explica estas modifica es Voc provavelmente precisar de ajuda do seu administrador de rede para reconfigurar o servidor web ele ou
6. m 250 publica es livros relat rios e revistas em v rias reas do desenvolvimento humano a completa HDL cont m 1 230 publica es Ela t m a mesma estrutura que o Demo Greenstone E um pouco complexa e se voc est iniciando o seu aprendizado com bibliotecas digitais talvez seja interessante verificar outras cole es primeiro como demonstra es MSWord e PDF the Arquivos Greenstone ou a Cole o de Imagens Simples Aqui voc encontrar alguns documentos em formatos PDF MSWord RTF and Postscript demonstrando a habilidade para construir cole es com documentos de tipos diferenciados O arquivo de configura o da cole o bem simples Uma cole o de mensagens de email das listas hist ricas do Greesntone que utiliza o plugin Email dividindo arquivos em formatos de email O arquivo de configura o da cole o bem simples Com aproximadamente 4 000 entradas bibliogr ficas esta cole o incorpora uma interface de busca baseada em formul rio que permite a busca por campos E bastante complexa Esta pequena cole o de 10 entradas bibliogr ficas ilustram os recursos da supercole o que permite a busca de v rias cole es ao mesmo tempo Ela trabalha junto com a cole o Bibliografia e os seus arquivos de configura o s o quase os mesmos Baseada em arquivos MARC da Biblioteca do Congresso esta cole o simples e n o permite busca baseada em formul rio Utiliz
7. Isto imediatamente abre uma caixa de di logo que aciona seu navegador interne e carrega a p gina da Biblioteca Digital Greenstone no seu navegador A cole o Demo do Greenstone estar acess vel a partir desta p gina inicial A caixa de di logo cont m um item de menu Arquivo que lhe permitir trocar o navegador padr o utilizado pelo Greenstone N o importa se voc utiliza o Netscape ou o Internet Explorer exceto se voc estiver executando o Windows 2000 neste caso n s recomendamos que voc utilize o Internet Explorer Biblioteca Web Windows e Unix Se voc estiver utilizando a Biblioteca Web ap s a instala o do software e configura o do servidor web utilize esta URL para entrar no Greenstone htto ocalhost gsdl cgi bin library A cole o Demo do Greenstone est acess vel a partir desta pagina O Coletor Um link para o Coletor fornecido na pagina web da biblioteca digital Administra o Um link para a p gina de Administra o fornecido na p gina web da biblioteca digital O usu rio administrador nomeado admin com uma senha especificada durante o processo de instala o O administrador autorizado a adicionar novos usu rios e a construir cole es 2 4 A Interface de Biblioteca do Greenstone GLI A Interface de Biblioteca do Greenstone GLI uma ferramenta para ajudar no desenvolvimento de bibliotecas digitais para o Greenstone Ela lhe dar acesso funcionalidade de const
8. end of it in parentheses the name of the original author or publisher of that section if known or else a unique number Make the same adjustment to the section titles in the list of Invariant Sections in the license notice of the combined work In the combination you must combine any sections Entitled History in the various original documents forming one section Entitled History likewise combine any sections Entitled Acknowledgements and any sections Entitled Dedications You must delete all sections Entitled Endorsements 6 COLLECTIONS OF DOCUMENTS You may make a collection consisting of the Document and other documents released under this License and replace the individual copies of this License in the various documents with a single copy that is included in the collection provided that you follow the rules of this License for verbatim copying of each of the documents in all other respects You may extract a single document from such a collection and distribute it individually under this License provided you insert a copy of this License into the extracted document and follow this License in all other respects regarding verbatim copying of that document 7 AGGREGATION WITH INDEPENDENT WORKS A compilation of the Document or its derivatives with other separate and independent documents or works in or on a volume of a storage or distribution medium is called an aggregate if the copyright resulting from the compilati
9. local adicional para a procura de documentos Alias gsdl C Program Files gsdl lt Directory C Program Files gsdl gt Options Indexes MultiViews FollowSymLinks AllowOverride None Order allow deny Allow from all lt Directory gt Isto significa que quaisquer URLs que t m o formato procurado pelo primeiro argumento do Alias gsdl sao encontradas como arquivos no lugar correspondente ao segundo argumento Em outras palavras URLs da forma http localhost gsdl ser o buscadas como arquivos no diret rio C Program Files gsdl Por exemplo se for apresentada a URL http localhost gsdl hello html o servidor web tentar recuperar o arquivo C Program Fileslgsdllhello html Entretanto a URL hAttp localhost hello html procura no diret rio regular htdocs pelo arquivo C Program Files Apache GrouplApachelhtdocslhello html exatamente como antes Assegure se de adicionar a diretiva Alias depois da diretiva ScriptAlias Se voc direcionar o Apache para o alias gsdl antes de gsdl cgi bin voc ter a URL gsdl cgi bin library utilizando a diretiva Alias ao inv s do ScriptAlias o que seria interpretado como uma requisi o de um documento em vez do resultado da execu o de um programa A sa da seria visualizar o arquivo do programa bin rio como uma p gina do navegador Web em vez de execut lo Seguran a Voc deveria estar a par de que caso a vers o da biblioteca web do Greenstone esteja configurada seguind
10. o Simples Para instalaar a vers o Windows a partir do CD ROM insira o disco no drive por exemplo o drive D Se o procedimento de instala o n o iniciar automaticamente ap s 20 segundos clique no menu In cio selecione Executar e digite D lsetup exe onde D a letra que identifica o seu drive CD ROM Para o ambiente Windows 3 1 selecione Run do File manager e digite D Windows win3 fisetup exe Para a instala o simples simplesmente aceite as op es padr es clicando no bot o Pr ximo Isso tudo o que voc precisa fazer O Greenstone instalado no diret rio C Program Fileslgsdl Uma vez que a instala o esteja completa inicie o sistema Greenstone clicando no bot o In cio abra o menu Programas e selecione Biblioteca Digital Greenstone Isto lhe trar a caixa de di logo simplesmente clique em Entrar na Biblioteca O seu navegador internet ser inicializado automaticamente e carregar a pagina da Biblioteca Digital do Greenstone que deve se parecer com o exemplo na figura 2 Voc entra na cole o demo do Greenstone clicando neste cone 4 O Procedimento de Instala o amp Netscape slok File Edit View Go Window Help ir ASAS Back Forward Reload Home Search Guide Print Security Stop ut Bookmarks A Location http toetoe cs waikato ac nz 8080 gsdl cgi bin library exe select a collection The Collector Helps you create new collections modify or add to e
11. or disclaimer the original version will prevail If a section in the Document is Entitled Acknowledgements Dedications or History the requirement section 4 to Preserve its Title section 1 will typically require changing the actual title 9 TERMINATION You may not copy modify sublicense or distribute the Document except as expressly provided for under this License Any other attempt to copy modify sublicense or distribute the Document is void and will automatically terminate your rights under this License However parties who have received copies or rights from you under this License will not have their licenses terminated so long as such parties remain in full compliance 10 FUTURE REVISIONS OF THIS LICENSE The Free Software Foundation may publish new revised versions of the GNU Free Documentation License from time to time Such new versions will be similar in spirit to the present version but may differ in detail to address new problems or concerns See http www gnu org copyleft Each version of the License is given a distinguishing version number If the Document specifies that a particular numbered version of this License or any later version applies to it you have the option of following the terms and conditions either of that specified version or of any later version that has been published not as a draft by the Free Software Foundation If the Document does not specify a version number of this License
12. processo de instala o para todas as diferentes vers es voc somente ter que verificar a parte relacionada ao seu sistema operacional A se o 3 descreve as cole es de demonstra o de bibliotecas digitais que est o inclusas na distribui o A se o 4 explica como configurar os servidores web mais comuns como o Apache e Microsoft PWS IIS para trabalhar com o Greenstone A se o 5 descreve v rias op es de configura o do Greenstone e a se o 6 mostra como personalizar a p gina web da sua instala o de biblioteca digital Finalmente o Ap ndice 7 lista os softwares associados e como obt los Documentos Relacionados O conjunto completo da documenta o do Greenstone inclui cinco volumes Guia de Instala o da Biblioteca Digital Greenstone este documento Guia do Usu rio da Biblioteca Digital Greenstone Guia do Desenvolvedor da Biblioteca Digital Greenstone A Biblioteca Digital Greenstone do Papel Cole o Biblioteca Digital Greenstone Utilizando o Organizador Copyright Copyright O 2002 2003 2004 2005 2006 2007 por Projeto Biblioteca Digital da Nova Zel ndia at Universidade de Waikato Nova Zel ndia A permiss o cedida para c pia distribui o e ou modifica o deste documento dentro dos termos da Licen a gratuita de Documenta o GNU Vers o 1 2 ou posterior publicada pela Funda o de Software Livre sem se es invariantes sem textos de Capa A c pia da licen a est inclu d
13. somente Biblioteca Web Windows e Unix O Coletor Administra o 2 4 A Interface de Biblioteca do Greenstone GLI 9 Executando no ambiente Windows Executando no ambiente Unix Obtendo ajuda Compilando a Interface de Biblioteca do Greenstone 2 5 Testando e Resolvendo Problemas 10 Resolvendo Problemas 2 6 Para aprender mais 12 3 As Cole es do Greenstone 13 4 Configurando o Servidor Web 15 4 1 O Servidor Web Apache 15 Configurando o diret rio cgi bin do Greenstone O documento diret rio raiz Seguran a 4 2 Os Web servers PWS e IIS 5 Configurando o seu Site 5 1 As Permiss es de Arquivos 5 2 A configura o do arquivo gsdlsite cfg 6 Personalizando sua Instala o 6 1 Exemplo 6 2 Como fazer as coisas funcionarem 6 3 Redirecionando a URL para o Greenstone Ap ndice dos Softwares Associados Servidor Web Apache Perl GCC GDBM Java runtime environment O compilador Java GNU Free Documentation License 17 19 19 19 21 21 23 23 25 25 25 25 25 25 26 27 1 Vers es do Greenstone 1 Versoes do Greenstone O software Greenstone pode ser executado em diversas plataformas e com varias configura es como resumido na Figura 1 Existem v rias quest es que afetam ou podem afetar o procedimento de instala o Antes de continuar na leitura considere os seguintes fatores e Voc est utilizando o ambiente Windows ou Unix e Se voc utiliza o Windows est utilizando a vers o Wi
14. sua instala o Greenstone e execute o script gli sh Este script verifica se o Greenstone o Java Runtime Environment e o Perl est o instalados e listados na vari vel de ambiente PATH al m de iniciar a Interface de Biblioteca do Greenstone Obtendo ajuda A Interface de Biblioteca do Greenstone tem v rios recursos de ajuda online possivel obter ajuda clicando no bot o Help no canto direito da tela Ele abre um texto para uma se o que relata o que voc est fazendo em qual dos pain is da GLI voc se encontra Voc pode selecionar qualquer parte do texto de ajuda para aprender o que voc precisa saber Utilize o Compilando a Interface de Biblioteca do Greenstone Se voc realizou o download da fonte da distribui o Geenstone voc ter o c digo fonte Java da Interface de Biblioteca Para compil lo seu computador precisa do Java Development Kit O Ap ndice 7 explica como obt lo Para compilar o c digo fonte execute o arquivo makegli bat Windows ou makegli sh Unix Uma vez compilados voc j pode executar a GLI como descrito acima 2 5 Testando e Resolvendo Problemas Para testar o Greenstone direcione o seu navegador Web para a p gina do Greenstone e explore a cole o Demo e qualquer outra cole o que voc tenha 11 O Procedimento de Instala o instalado N o se preocupe voc n o pode quebrar nada Clique livremente a maioria das as imagens que aparecem na tela s o clic veis s o
15. tem um servidor web sendo executado voc poder optar por continuar com ele Em ambientes Unix ser necess rio executar um servidor web e Voc sabe como reconfigurar um servidor web Se voc n o quer utilizar o servidor web do Greenstone voc vai ter de reconfigurar o seu servidor existente para reconhecer o Greenstone 3 O Procedimento de Instala o 2 O Procedimento de Instala o As vers es do Greenstone est o dispon veis tanto para Windows como para Unix como bin rios e arquivos fonte A interface de usu rio do Greenstone ulitiza um navegador web Netscape Navigator ou Internet Explorer vers es 4 0 ou posteriores em ambos os casos podem ser utilizadas Caso voc ainda n o tenha um navegador Web vers es Windows do Netscape s o fornecidas no CD ROM 2 1 Windows Se voc um usu rio Unix por favor pule para a se o 2 2 Para usu rios Windows se voc quer apenas uma instala o simples e b sica v pelo procedimento instala o simples O sistema Greenstone ocupa aproximadamente 40 Mb de espa o em disco Se voc escolhe qualquer op o que n o seja a configura o b sica voc ter que decidir se utilizar o c digo bin rio ou o c digo fonte Na d vida escolha o c digo bin rio O procedimento de instala o o mesmo para ambos As se es seguintes lhe mostram as op es dispon veis Quando voc tiver terminado a instala o poder pular para a se o 2 3 Instala
16. to five words as a Front Cover Text and a passage of up to 25 words as a Back Cover Text to the end of the list of Cover Texts in the Modified Version Only one passage of Front Cover Text and one of Back Cover Text may be added by or through arrangements made by any one entity If the Document already includes a cover text for the same cover previously added by you or by arrangement made by the same entity you are acting on behalf of you may not add another but you may replace the old one on explicit permission from the previous publisher that added the old one The author s and publisher s of the Document do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any Modified Version 5 COMBINING DOCUMENTS You may combine the Document with other documents released under this License under the terms defined in section 4 above for modified versions provided that you include in the combination all of the Invariant Sections of all of the original documents unmodified and list them all as Invariant Sections of your combined work in its license notice and that you preserve all their Warranty Disclaimers The combined work need only contain one copy of this License and multiple identical Invariant Sections may be replaced with a single copy If there are multiple Invariant Sections with the same name but different contents make the title of each such section unique by adding at the
17. you may choose any version ever published not as a draft by the Free Software Foundation How to use this License for your documents 33 GNU Free Documentation License To use this License in a document you have written include a copy of the License in the document and put the following copyright and license notices just after the title page Copyright c YEAR YOUR NAME Permission is granted to copy distribute and or modify this document under the terms of the GNU Free Documentation License Version 1 2 or any later version published by the Free Software Foundation with no Invariant Sections no Front Cover Texts and no Back Cover Texts A copy of the license is included in the section entitled GNU Free Documentation License If you have Invariant Sections Front Cover Texts and Back Cover Texts replace the with Texts line with this with the Invariant Sections being LIST THEIR TITLES with the Front Cover Texts being LIST and with the Back Cover Texts being LIST If you have Invariant Sections without Cover Texts or some other combination of the three merge those two alternatives to suit the situation If your document contains nontrivial examples of program code we recommend releasing these examples in parallel under your choice of free software license such as the GNU General Public License to permit their use in free software
18. BIBLIOTECA DIGITAL GREENSTONE GUIA DE INSTALA O lan H Witten e Stefan Boddie Departmento de Ci ncias da Computa o Universidade de Waikato Nova Zel ndia O Greenstone um pacote de software para construir e distribuir cole es de bibliotecas digitais Ele prov uma nova forma de organizar a informa o e public la na internet ou CD ROM O Greenstone produzido pelo Projeto de Biblioteca Digital da Nova Zel ndia na Universidade de Waikato e desenvolvido e distribu do em coopera o com a UNESCO e da ONG Human Info E um software de c digo aberto dispon vel em http greenstone org sob os termos da Licen a P blica Geral do Gnu Queremos garantir que este software funcione corretamente para voc Por favor reporte qualquer problema a greenstone cs waikato ac nz Greenstone gsdl 2 50 Marco de 2004 Sobre este manual Este documento explica como instalar o software Greenstone para uso pessoal O documento tamb m descreve como obter software livre associado como o servidor web Apache e o Perl Esta documenta o foi escrita com o objetivo de tornar o procedimento de instala o o mais simples poss vel O software pode ser executado em diferentes plataformas e com diferentes configura es Consequentemente existem v rias quest es que afetam ou podem afetar o processo de instala o A se o 1 menciona algumas quest es que voc ter que considerar antes de instalar o Greenstone A se o 2 detalha o
19. D ROM mude o diret rio para a raiz do CD ROM mount cdrom cd cdrom mude este diret rio para o diret rio que cont m rn os scripts de instala o do Unix inicie o processo de instala o um expl cito sh utilizado pois muitas instala es pro bem os programas de serem executados a partir do CD ROM sh Install sh O ltimo comando inicia um di logo interativo que requisita a informa o necess ria 8 O Procedimento de Instala o para a instala o do Greenstone no seu sistema e lhe apresenta detalhes de cada comando executado no momento O procedimento de instala o come a perguntando a voc em qual diret rio o Greenstone ser instalado O primeiro arquivo instalado ser o programa de desinstala o que remove qualquer instala o parcial caso voc problemas ou termine a instala o de modo prematuro Em seguida voc escolhe se quer instalar os arquivos bin rios ou o c digo fonte Voc ent o ser questionado sobre a configura o do servidor web Voce precisa ter um diret rio execut vel cgi normalmente cgi bin em sistemas Unix voc pode tanto criar um novo como utilizar algum existente Se voc criar um novo voc precisar entrar com esta informa o no arquivo de configura o de seu servidor web Em qualquer dos casos voc precisa entrar com o endere o web do diret rio cgi O di logo de instala o lhe guiar durante todas estas escolhas E importante configurar as permiss
20. Development Kit de http java sun com j2se downloads html E necess ria a vers o 1 4 0 ou superior 27 GNU Free Documentation License GNU Free Documentation License Version 1 2 November 2002 Copyright C 2000 2001 2002 Free Software Foundation Inc 51 Franklin St Fifth Floor Boston MA 02110 1301 USA Everyone is permitted to copy and distribute verbatim copies of this license document but changing it is not allowed 0 PREAMBLE The purpose of this License is to make a manual textbook or other functional and useful document free in the sense of freedom to assure everyone the effective freedom to copy and redistribute it with or without modifying it either commercially or noncommercially Secondarily this License preserves for the author and publisher a way to get credit for their work while not being considered responsible for modifications made by others This License is a kind of copyleft which means that derivative works of the document must themselves be free in the same sense It complements the GNU General Public License which is a copyleft license designed for free software We have designed this License in order to use it for manuals for free software because free software needs free documentation a free program should come with manuals providing the same freedoms that the software does But this License is not limited to software manuals it can be used for any textual work regardless of subject matter or
21. a o do Apache utilizam a barra ao inv s da barra invertida que o padr o do ambiente Windows Isso significa que qualquer URL da forma http localhost gsdl cgi bin ser buscada no diret rio C Program Files gsdl cgi bin e executada pelo servidor web Se for apresentada com a URL http localhost gsdl cgi bin hello por exemplo o servidor web tentar recuperar o arquivo C Program Files gsdl cgi bin hello e execut lo Entretanto a URL Attp focalhost cgi bin hello procura no diret rio regular cgi bin do Apache pelo arquivo C Program Files Apache Group Apache cgi binlhello e o executa da mesma forma que ele fez anteriormente O documento diret rio raiz O documento diret rio root a raiz da estrutura de diret rios do seu servidor web Quando instalado o Apache tem um documento raiz of C Program Files Apache GrouplApachelhtdocs Isso significa que quando apresentado com a URL http localhost hello html o servidor web tentar recuperar um arquivo chamado hello html do diret rio mencionado V rios arquivos do Greenstone t m que ser lidos pelo servidor web O modo mais f cil de fazer esta tarefa utilizar a diretiva Alias que semelhante ao ScriptAlias exceto pelo fato de que se aplica a p ginas web simples e n o a scripts cgi Adicione estas linhas no arquivo de configura o do Apache depois da diretiva ScriptAlias para ter o 17 Configurando o Servidor Web diret rio C Program Fileslgsd como um
22. a na se o entitulada Licen a gratuita de Documenta o GNU Agradecimentos O software Greenstone o resultado do esfor o de colabora o entre varias pessoas Rodger McNab e Stefan Boddie s o os principais arquitetos e implementadores V rias contribui es foram feitas por David Bainbridge George Buchanan Hong Chen Michael Dewsnip Katherine Don Elke Duncker Carl Gutwin Geoff Holmes Dana McKay John McPherson Craig Nevill Manning Dynal Patel Gordon Paynter Bernhard Pfahringer Todd Reed Bill Rogers John Thompson e Stuart Yeates Outros membros do projeto da Biblioteca Digital da Nova Zel ndia ajudaram com conselhos e inspira o para o desenvolvimento do sistema Mark Apperley Sally Jo Cunningham Matt Jones Steve Jones Te Taka Keegan Michel Loots Malika Mahoui Gary Marsden Dave Nichols e Lloyd Smith Gostar amos tamb m de agradecer a todos que contribu ram com os pacotes de licen as GNU inclu dos nesta distribui o MG GDBM PDFTOHTML PERL WGET WVWARE e XLHTML Contents 1 Vers es do Greenstone 1 2 O Procedimento de Instala o 3 2 1 Windows 3 Instala o Simples Arquivos bin rios do Windows A configura o do web server para Windows somente para a vers o de Biblioteca Web O c digo de fonte Windows 2 2 Unix 6 Bin rios do Unix C digo fonte Unix A instala o Unix A configura o do servidor web Unix 2 3 Como encontrar o Greenstone 9 Biblioteca local para o Windows
23. a servidor web Para executar a Biblioteca Web voc tamb m precisa de e Software para servidor Web Uma possibilidade o Apache verifique o Ap ndice 7 e O Coletor Este componente que inclu do tanto na Biblioteca Local quanto na Biblioteca Web lhe permite construir cole es contendo material de sua escolha O Coletor n o funciona em m quinas com Windows 3 1 3 11 A configura o do web server para Windows somente para a vers o de Biblioteca Web Uma vantagem da vers o da Biblioteca Local do Greenstone que ela roda fora da caixa de maneira f cil e n o requer nenhuma configura o especial Para a vers o de Biblioteca Web entretanto alguns ajustes s o necess rios na configura o do seu servidor web Se voc j tem um servidor web algumas pequenas mudan as ter o que ser feitas na configura o para a instala o do Greenstone funcionar O script de instala o explica as altera es para o servidor Web Apache verifique a se o 4 2 para instru es de como configurar os servidores web PWS e IIS Talvez voc precise da ajuda de seu administrador de rede para reconfigurar o web server existente eles devem ser capazes de compreender as instru es indicadas no script de instala o Se voc ainda n o tem um servidor web voc ter que instalar um Verifique o Ap ndice 7 para informa es sobre o servidor Web Apache Posteriormente voc ter que configur lo apropriadamente A
24. ada pois o software funciona fora da caixa e n o necessariamente requer um servidor web N s explicaremos sobre ambos o servidor web Apache que est gratuitamente dispon vel em software livre nas plataformas Windows e Unix verifique o Ap ndice 7 para detalhes o Microsoft Personal Web Server PWS e o servidor Internet Information Services IIS O PWS o servidor Microsoft padr o para Windows 95 98 o IIS o servidor padr o para o Windows 2000 e Windows XP o Windows NT pode utilizar ambos A descri o do Apache se aplica igualmente para a Biblioteca Web das vers es Windows e Unix embora seja mostrado aqui com as vari veis e terminologias do ambiente Windows a se o PWS IIS se aplica somente para a Biblioteca Web do Windows Uma vez instalado o servidor web o pr ximo passo a instala o do Greenstone Assumiremos que durante o processo de instala o voc realizou a a o default em todas as etapas clicando no bot o pr ximo O resultado a cria o do diret rio C Program Files gsdl com o armazenamento dos arquivos bin rios al m de alguns arquivos de suporte Todos os servidores web utilizam a URL especial localhost para denotar o computador em que o servidor web est sendo executado Portanto quando voc instala um servidor web voc pode verificar seus documentos html digitando a URL http localhost no seu navegador ap s a sua instala o Se o seu computador tem um dom nio configur
25. ado ele utilizado para identifica o do computador e sites remotos em vez do localhost Ent o no computador da Biblioteca Digital da Nova Zel ndia http nzdl org e http localhost s o equivalentes Se voc digitar http nzdl org no seu computador voc acessar o servidor web da Biblioteca Digital da Nova Zel ndia enquanto se voc digitar http localhost lhe direcionar ao servidor web de seu computador 4 1 O Servidor Web Apache O servidor web Apache normalmente instalado em C Program Files Apache GrouplApache e configurado para ter o diret rio cgi bin no subdiret rio cgi bin e o documento root no subdiret rio Ihtdocs E poss vel reconfigur lo atrav s da edi o do arquivo de configura o C Program Files Apache GrouplApachelconfihttpd conf E um arquivo texto f cil de ler e verificar como as coisas est o configuradas Dependendo de como o software de rede de seu computador esteja configurado voc pode precisar adicionar esta linha ao arquivo httpd conf do Apache ServerName localhost Se esta linha n o est inclu da o sistema tentar encontrar o nome do seu servidor Entretanto esta a o pode n o ser executada devido a bugs em vers es do windows Neste caso o Apache finalizar automaticamente quando iniciado Uma mensagem de erro ser exibida por m apagada imediatamente e voc provavelmente n o 16 Configurando o Servidor Web conseguir l la Configurando o diret rio cgi bi
26. age Ao inv s de edit lo recomendamos que voc crie um novo arquivo digamos yourhome dm Ele ser parecido com o arquivo home dm por m utilizar o package home que quem faz o trabalho atual de maneira diferente Quando voc faz uma home page diferente deve haver algum modo de link la para as p ginas da biblioteca digital para que seja poss vel realizar a busca e navega o nas cole es de seu sistema A solu o adotada pelo Greenstone a utiliza o de macros Esta a raz o pela qual o arquivo da home page tem a extens o dm e n o html um arquivo macro ao inv s de um arquivo regular html Mas nao quail este arquivo macro cont m apenas html com alguns detalhes espec ficos citados abaixo A linguagem macro cont m v rios recursos poderosos e somente uma pequena parte deles listada abaixo verifique o Guia do Desenvolvedor da Biblioteca Digital Greenstone para mais informa es Exemplo Ft Netscape Oy Xx File Edit View Go Window Help HOME HELP PREFERENCES Your own Greenstone home page Search page for the demo collection Click here About page for the demo collection Click here Preferences page for the demo collection Click here Home page Click here Help page Click here Administration page Click here The Collector Click here a http localhost gsdl cqi bin library e p 00 00 00 0 Oprompt 1 Document 1011 1 en 50 20 home 7 A figura 3 mos
27. ando o Protocolo Open Archive e a op o Import From ele recupera o hist rico dos metadados sendo poss vel utiliz los para construir uma cole o com estes registros Neste caso eles s o imagens portanto os plugins OAI e Image s o utilizados Esta cole o bem b sica de imagens n o cont m texto nem metadados expl citos o que a torna n o muito real stica O arquivo de configura o o mais simples que pode haver Utilizando o mesmo material da cole o original Demo do Greenstone duas caracter sticas independentes podem ser mostradas a formata o de documentos fora do padr o e controle de acesso aos documentos utilizando a autentica o de usu rio Esta cole o tamb m cont m o mesmo material do demo Greenstone A sua apar ncia foi alterada para demonstrar como as p ginas geradas podem ser configuradas de modo diferente Ele se baseia na utiliza o de um arquivo macro sem um padr o definido que fornecido pelo Greenstone Esta cole o constru da a partir de um banco de dados CDS ISIS com aproximadamente 150 entradas bibliogr ficas Utiliza o plugin ISISPlug que l os arquivos de padr o ISIS mst e fdt e os converte para os metadados do Greenstone 15 Configurando o Servidor Web 4 Configurando o Servidor Web Nesta se o descrito como configurar o seu servidor web para trabalhar com o Greenstone Note que isto n o necess rio quando a Biblioteca Local do Windows utiliz
28. c los no arquivo htaccess dentro do seu diret rio raiz de documentos do seu servidor Na realidade fazer isso tem duas vantagens Primeiro as mudan as em htaccess t m um efeito imediato quando o tiver que iniciar novamente o servidor Apache para verificar as mudan as em httpd conf Em segundo lugar em 24 Personalizando sua Instala o ambientes Unix voc geralmente tem que estar logado como usu rio root para editar o arquivo httpd conf considerando que voc n o edite o arquivo htaccess 25 Ap ndice dos Softwares Associados Ap ndice dos Softwares Associados Aqui explicamos como obter os pacotes de software mencionados acima Servidor Web Apache Para executar qualquer vers o do Greenstone separada da vers o da Biblioteca Local do Windows voc precisa de um servidor web externo V rias aplica es particularmente as maiores j ter o provavelmente um servidor web Se voc estiver utilizando Linux o Apache pode estar no seu disco de instala o por m n o foi selecionado durante o processo de instala o O servidor web Apache do site www apache org software livre e f cil de ser instalado Perl O Greenstone utiliza a linguagem Perl quando est construindo as cole es No ambiente Windows o Perl inclu do automaticamente com os pacotes do Greenstone A maioria dos sistemas Unix j tem o Perl instalado por m caso ele n o esteja presente o c digo fonte e arquivos bin rios de uma gra
29. 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 Fileslgsdlletc 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 5 2 A configura o do arquivo gsdlsite cfg 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 gsadl 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 20 Configurando o seu Site 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 gwegi cgi bi
30. e comando Se funcionar o problema com as permiss es do arquivo verifique a Se o 5 1 Se n o funcionar a vari vel gsdlhome provavelmente est configurada de maneira errada no arquivo de configura o gsdlsite cfg verifique a Se o 12 O Procedimento de Instala o Eu estou tendo problemas Leia o Guia de Usu rio da Biblioteca Digital do quando uso o Coletor Greenstone Se o Eu adicionei um novo Verifique se o diret rio C lProgram usu rio mas ele parece n o Filesigsdlletc e todos os seus arquivos t m conseguir acessar o sistema permiss o de escrita see Section 5 1 2 6 Para aprender mais Para aprender mais a respeito de detalhes da instala o do Greenstone verifique o Guia do Desenvolvedor da Biblioteca Digital Greenstone Ele inclui por exemplo detalhes de estruturas de diret rios criados e informa o de como configurar o site do Greenstone 13 As Cole es do Greenstone 3 As Cole es do Greenstone V rias cole es de demonstra o do Greenstone est o inclu das no CD ROM Se voc tiver acesso a internet poder fazer o download de outras cole es pr compiladas ou nao do website do Projeto da Bilioteca Digital da Nova Zel ndia nzdl org A cole o Demo do Greenstone um pequeno subconjunto da Biblioteca de Desenvolvimento Humanit rio HDL uma j ia de cole o Esta cole o ilustra que relativamente ricas possibilidades de navega
31. e page the name of the publisher of the Modified Version as the publisher D Preserve all the copyright notices of the Document E Add an appropriate copyright notice for your modifications adjacent to the other copyright notices F Include immediately after the copyright notices a license notice giving the public permission to use the Modified Version under the terms of this License in the form shown in the Addendum below G Preserve in that license notice the full lists of Invariant Sections and required Cover Texts given in the Document s license notice H Include an unaltered copy of this License I Preserve the section Entitled History Preserve its Title and add to it an item stating at least the title year new authors and publisher of the Modified Version as given on the Title Page If there is no section Entitled History in the Document create one stating the title year authors and publisher of the Document as given on its Title Page then add an item describing the Modified Version as stated in the previous sentence J Preserve the network location if any given in the Document for public access to a Transparent copy of the Document and likewise the network locations given in the Document for previous versions it was based on These may be placed in the History section You may omit a network location for a work that was published at least four years before the Document itself or if the original publisher of t
32. ela dever estar habilitado para entender as instru es de sa da indicadas pelo script de instala o Para a sua conveni ncia a sa da do script de instala o escrita em um arquivo nomeado INSTALL RECORD no diret rio escolhido para a instala o do Greenstone Se voc n o tem um servidor web ser necess ria a sua instala o O Ap ndice 7 apresenta informa es sobre o servidor Apache Ser necess ria a sua configura o apropriada A se o 4 apresenta os detalhes da instala o do servidor Apache que s o afetados pelo Greenstone e como devem ser alterados Aproximadamente 6 linhas devem ser inclu das no arquivo de configura o 9 O Procedimento de Instala o N o necess rio ser o usu rio raiz para realizar o processo de instala o acima Entretanto se for necess ria a configura o de um servidor Apache j existente talvez sejam necess rios os privil gios espec ficos do usu rio raiz dependendo de como est configurado o servidor Apache Se voc mesmo instalar o Apache n o precisar dos privil gios do usu rio raiz E se voc precisa contornar um administrador de rede que n o coopera sempre h a alternativa de instalar um segundo servidor Apache em seu computador mesmo se j houver um instalado 2 3 Como encontrar o Greenstone Biblioteca local para o Windows somente Se voc est usando a Biblioteca Local simplesmente execute o programa Greenstone do menu Iniciar
33. he Title of such a section when you modify the Document means that it remains a section Entitled XYZ according to this definition The Document may include Warranty Disclaimers next to the notice which states that this License applies to the Document These Warranty Disclaimers are considered to be included by reference in this License but only as regards disclaiming warranties any other implication that these Warranty Disclaimers may have is void and has no effect on the meaning of this License 2 VERBATIM COPYING You may copy and distribute the Document in any medium either commercially or noncommercially provided that this License the copyright notices and the license notice saying this License applies to the Document are reproduced in all copies and that you add no other conditions whatsoever to those of this License You may not use technical measures to obstruct or control the reading or further copying of the copies 29 GNU Free Documentation License you make or distribute However you may accept compensation in exchange for copies If you distribute a large enough number of copies you must also follow the conditions in section 3 You may also lend copies under the same conditions stated above and you may publicly display copies 3 COPYING IN QUANTITY If you publish printed copies or copies in media that commonly have printed covers of the Document numbering more than 100 and the Document s license notice requires
34. he version it refers to gives permission K For any section Entitled Acknowledgements or Dedications Preserve the Title of the section and preserve in the section all the substance and tone of each of the contributor acknowledgements and or dedications given therein L Preserve all the Invariant Sections of the Document unaltered in their text and in their titles Section numbers or the equivalent are not considered part of the section titles M Delete any section Entitled Endorsements Such a section may not be included in the Modified Version N Do not retitle any existing section to be Entitled Endorsements or to conflict in title with any Invariant Section O Preserve any Warranty Disclaimers If the Modified Version includes new front matter sections or appendices that qualify as Secondary Sections and contain no material copied from the Document you may at your option designate some or all of these sections as invariant To do this add their titles to the list of Invariant Sections in the Modified Version s license notice These titles must be distinct from any other section titles You may add a section Entitled Endorsements provided it contains nothing but endorsements of your Modified Version by various parties for example statements of peer review or that the text has been approved by an organization as the authoritative definition of a standard 31 GNU Free Documentation License You may add a passage of up
35. ical or political position regarding them The Invariant Sections are certain Secondary Sections whose titles are designated as being those of Invariant Sections in the notice that says that the Document is released under this License If a section does not fit the above definition of Secondary then it is not allowed to be designated as Invariant The Document may contain zero Invariant 28 GNU Free Documentation License Sections If the Document does not identify any Invariant Sections then there are none The Cover Texts are certain short passages of text that are listed as Front Cover Texts or Back Cover Texts in the notice that says that the Document is released under this License A Front Cover Text may be at most 5 words and a Back Cover Text may be at most 25 words A Transparent copy of the Document means a machine readable copy represented in a format whose specification is available to the general public that is suitable for revising the document straightforwardly with generic text editors or for images composed of pixels generic paint programs or for drawings some widely available drawing editor and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters A copy made in an otherwise Transparent file format whose markup or absence of markup has been arranged to thwart or discourage subsequent modification by readers is not Transparent An
36. icam 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 Filesigsdl 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 Fileslgsdlletc 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
37. iente para o seu programa Greenstone cgi Por exemplo no seu sistema a URL http nzdl org que um atalho para http nzdl org index html redirecionada para http nzdl org cgi bin library O servidor web Apache webserver realiza isso com a diretiva Redirect Junto com outras diretivas ela se encontra no arquivo de configura o C Program Files Apache GrouplApachelconflhttpd conf Para redirecionar a URL http www seuservidor com para http www seuservidor com cgi bin library adicione a seguinte linha em httpd conf Redirect index html http www yourserver com cgi bin library Ent o voc vai acessar o seu sistema da biblioteca digital diretamente a partir da URL http www seuservidor com Se ao inv s disso voc quiser que uma URL como http www seuservidor com greenstone seja direcionada para http www seuservidor cgi bin library inclua ai o arquivo httpd conf Redirect greenstone http www yourserver com cgi bin library Se o seu computador n o tem um nome de dominio como o exemplo www seuservidor com acima simplesmente substitua www seuservidor com por localhost nas linhas acima Desde que o seu navegador esteja sendo executado na mesma m quina que o servidor web o que certamente acontece se o seu computador n o t m um nome de dom nio isso tem o mesmo efeito que os redirecionamentos acima Ao inv s de inserir redirecionamentos adicionais de diretivas no arquivo httpd conf voc pode igualmente colo
38. image format is not Transparent if used for any substantial amount of text A copy that is not Transparent is called Opaque Examples of suitable formats for Transparent copies include plain ASCII without markup Texinfo input format LaTeX input format SGML or XML using a publicly available DTD and standard conforming simple HTML PostScript or PDF designed for human modification Examples of transparent image formats include PNG XCF and JPG Opaque formats include proprietary formats that can be read and edited only by proprietary word processors SGML or XML for which the DTD and or processing tools are not generally available and the machine generated HTML PostScript or PDF produced by some word processors for output purposes only The Title Page means for a printed book the title page itself plus such following pages as are needed to hold legibly the material this License requires to appear in the title page For works in formats which do not have any title page as such Title Page means the text near the most prominent appearance of the work s title preceding the beginning of the body of the text A section Entitled XYZ means a named subunit of the Document whose title either is precisely XYZ or contains XYZ in parentheses following text that translates XYZ in another language Here XYZ stands for a specific section name mentioned below such as Acknowledgements Dedications Endorsements or History To Preserve t
39. last time you distribute an Opaque copy directly or through your agents or retailers of that edition to the public It is requested but not required that you contact the authors of the Document well before redistributing any large number of copies to give them a chance to provide you with an updated version of the Document 4 MODIFICATIONS You may copy and distribute a Modified Version of the Document under the conditions of sections 2 and 3 above provided that you release the Modified Version under precisely this License with the Modified Version filling the role of the Document thus licensing distribution and modification of the Modified Version to whoever possesses a copy of it In addition you must do these things in the Modified Version A Use in the Title Page and on the covers if any a title distinct from that of the Document and from those of previous versions which should if there were any be listed in the History section of the Document You may use the same title as a previous version if the original publisher of that version gives permission B List on the Title Page as authors one or more persons or entities 30 GNU Free Documentation License responsible for authorship of the modifications in the Modified Version together with at least five of the principal authors of the Document all of its principal authors if it has fewer than five unless they release you from this requirement C State on the Titl
40. links para outras informa es Se voc mantiver o mouse parado sobre uma imagem a maioria dos navegadores rapidamente mostrar uma mensagem pop up que conta o que acontecer se voc clicar Experimente Escolha palavras comuns como o e e para fazer a busca isso provavelmente retornar algumas respostas e nada vai se quebrar Para mais informa es verifique o Guia do Usu rio da Biblioteca Digital Greenstone Resolvendo Problemas Problema Experimente o seguinte Biblioteca Local somente para ambiente Windows Quando eu inicio o Greenstone meu computador requisita a discagem para o meu provedor de servi os Internet Clique no bot o Cancelar na caixa de di logo Isto normalmente soluciona o problema Quando eu inicio o Greenstone meu computador ainda requisita a discagem para o meu provedor de servi os internet Escolha a Vers o Restrita quando voc iniciar o Greenstone Esta vers o funciona somente com o Netscape Quando eu direciono o meu navegador para a p gina da biblioteca digital exibida uma mensagem de que a p gina n o pode ser encontrada Verifique a configura o de proxy internete a desabilite os proxies use Editar Preferencias no Netscape ou Op es de Internet no Explorer Biblioteca Web Windows e Unix O Coletor parece estar funcionando de maneira bastante lenta Quando eu inicio o Apache ele imediatamente finalizado Voc est utili
41. mendamos fortemente que voc instale seu servidor web antes de instalar o Greenstone isso vai facilitar em muito para responder as perguntas questionadas durante o procedimento de instala o Se voc quiser construir novas cole es de bibliotecas digitais voc tamb m precisa do Perl se ele ainda n o se encontra em seu sistema Para verificar isso abra uma janela do terminal digite per v e verifique se uma mensagem aparece especificando entre outras coisas o n mero da vers o Para a maioria das vers es do Linux o Perl instalado por default O Ap ndice 7 d informa es sobre como obter o Apache e o Perl C digo fonte Unix O c digo fonte o mesmo para usu rios Unix e Windows Ele foi compilado e testado em Linux Solaris e Macintosh OS X e deveria ser uma rotina f cil a quest o da sua portabilidade para outras distribui es de Unix Para compilar o c digo fonte do Greenstone no Unix voc precisa de e GCC o compilador Gnu C e GDBM o administrador de dados Gnu Para executar o software Greenstone voc tamb m precisa de um servidor web e do Perl como descrito acima em Bin rios do Unix A instala o Unix Para instalar a vers o Unix a partir do CD ROM insira o disco no drive e digite monte o dispositivo de CD ROM este comando pode ser diferente de um sistema para outro em OS X por exemplo voc executaria o cd para o diret rio Volumes e iria para o subdiret rio apropriado do C
42. n do Greenstone O diret rio cgi bin considerado pelo servidor web como um diret rio de programas execut veis A diretiva ScriptAlias do Apache utilizada para criar um diret rio cgi bin Note que esta diretiva pode tornar qualquer diret rio um diret rio cgi bin execut vel n o necess rio ter o nome cgi bin Da mesma maneira um diret rio nomeado cgi bin n o especial at que a diretiva ScriptAlias seja aplicada a ele Quando instalado o Apache tem um diret rio cgi bin C Program Files Apache GrouplApachelcgi bin Isso significa que se a URL http localhost cgi bin hello for digitada o servidor web ir tentar executar um arquivo chamado hello localizado dentro do diret rio mencionado acima H um programa Greenstone chamado library exe que precisa ser executado pelo servidor web ele por sua vez l um arquivo chamado configura o do site Greenstone gsdlsite cfg que precisa estar localizado no mesmo diret rio A melhor maneira de configurar isso utilizar a diretiva Apache ScriptAlias para criar um novo diret rio cgi bin E mostrado a seguir a parte do arquivo de configura o httpd conf do Apache que adiciona C Program Files gsal cgi bin como um diret rio cgi bin adicional ScriptAlias gsdl cgi bin C Program Files gsdl cgi bin lt Directory C Program Files gsdl cgi bin gt Options None AllowOverride None lt Directory gt um fato curioso que os arquivos de configur
43. n library maxrequests is the most requests a fastcgi process will serve before it exits This can be set toa 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 hAttpprefix 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 Fileslgsdllimages ele contem todas as imagens gif utilizadas na interface Em qualquer instala o padr o do Greenstone este diret rio sempre ser httoprefix 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 fa
44. nde parte de plataformas Unix est presente em www perl com E necess rio ao menos a vers o Perl 5 0 ou qualquer vers o acima desta GCC A vers o Unix do Greenstone pode ser executada com o compilador Gnu C o GCC O Greenstone faz bastante uso da bilioteca padr o do C n s descobrimos que ela foi descontinuada em algumas vers es antigas do GCC por favor nos comunique se voc tiver problemas de STL Note que esta versao do Greenstone nao compila com o GCC 3 0 GDBM Todas as vers es do Greenstone utilizam o Gnu Database Manager GDBM Ele utilizado com todas as vers es Windows do Greenstone e instalado automaticamente durante o processo de instala o Os sistemas Linux j t m o GDBM ent o n s n o o provemos para este sistema A maioria dos sistemas Unix j o tem por m caso seja necess rio poss vel baix lo realizar o download em www gnu org Java runtime environment Para usar a Interface de Biblioteca do Greenstone voc ter ter uma vers o do Java Runtime Environment Se voc ainda n o o tem instalado ou alguma vers o no CD ROM voc pode baixar realizar o download da ltima vers o em 26 Ap ndice dos Softwares Associados http java sun com j2se downloads html necess ria a vers o 1 4 0 ou posterior O compilador Java Para compilar o c digo fonte da Interface de Biblioteca do Greenstone voc precisa primeiro instalar o Java Development Kit E poss vel baixar o J2SE Software
45. ndows 3 1 3 11 ou alguma vers o mais recente Embora seja poss vel visualizar cole es em m quinas que utilizem o 3 1 3 11 e que utilizem outros computadores em uma mesma rede n o ser poss vel construir novas cole es O Greenstone completo pode ser executado somente em 95 98 Me e NT 2000 e Se voc est com o ambiente Unix voc utiliza o Linux ou alguma outra vers o do Unix No caso do Linux existe a vers o bin ria do sistema completo j inclu da e sua instala o f cil Para os outros tipos de Unix ser necess ria a instala o do c digo fonte e a sua compila o Para isso talvez seja necess rio que voc instale alguns softwares adicionais em sua m quina e Se o ambiente Windows NT 2000 ou Unix voc consegue realizar o login como administrator ou raiz Isso talvez seja necess rio para configurar o servidor web adequadamente para o Greenstone e Voc quer o c digo fonte Se voc utiliza o Windows ou Linux voc pode instalar apenas os bin rios Por m voc pode querer o c digo fonte tamb m ele se encontra na distribui o do Greenstone e Voc quer construir novas cole es de bibliotecas digitais Se a resposta sim voc precisa ter o Perl que dispon vel em c digo livre para ambos ambientes Windows e Unix 2 Vers es do Greenstone e O seu computador est executando um servidor web O software Greenstone j vem com um servidor web Windows Entretanto se voc j
46. o as instru es acima qualquer pessoa ter permiss o para realizar o download de arquivos no diret rio gsdl Isso inclui os arquivos de ndices e arquivos fontes de qualquer cole o que voc crie banco de dados logs de utiliza o etc Se isso um problema para voc modifique a configura o do seu web server para melhorar a seguran a Para o servidor Apache utilize as seguintes linhas no arquivo de configura o ao inv s daquelas listadas na se o anterior Alias gsdl C Program Files gsdl lt Directory C Program Files gsdl gt Order allow deny Deny from all lt FilesMatch gifljpe glpnglcess mov impeglps lpdf doclrtf jarlclass sS gt Order allow deny Allow from all lt FilesMatch gt lt Directory gt Isto significa que somente os arquivos cujas extens es tiverem o mesmo crit rio da express o regular na linha FilesMatch poder o ser baixados 4 2 Os Web servers PWS e IIS Embora nem o PWS ou o IIS sejam instalados por default em atuais ambientes Windows poss vel instal los com facilidade atrav s do painel de controle utilizando a op o Add Remove programs Se eles ainda n o estiverem no seu CD ROM da distribui o Windows voc ter que baix los no site web da Microsoft www microsoft com 18 Configurando o Servidor Web O procedimento de configura o do Greenstone id ntico para o PWS e IIS Execute o Personal Web Manager realizando as seguintes a es
47. on is not used to limit the legal rights of the compilation s users beyond what the individual works permit When the 32 GNU Free Documentation License Document is included in an aggregate this License does not apply to the other works in the aggregate which are not themselves derivative works of the Document If the Cover Text requirement of section 3 is applicable to these copies of the Document then if the Document is less than one half of the entire aggregate the Document s Cover Texts may be placed on covers that bracket the Document within the aggregate or the electronic equivalent of covers if the Document is in electronic form Otherwise they must appear on printed covers that bracket the whole aggregate 8 TRANSLATION Translation is considered a kind of modification so you may distribute translations of the Document under the terms of section 4 Replacing Invariant Sections with translations requires special permission from their copyright holders but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections You may include a translation of this License and all the license notices in the Document and any Warranty Disclaimers provided that you also include the original English version of this License and the original versions of those notices and disclaimers In case of a disagreement between the translation and the original version of this License or a notice
48. ou hate the squirly green bar down the left hand side of the page uncomment these lines _header_ Voc pode utilizar a figura 4 como um template para criar sua pr pria pagina especializada Greenstone Basicamente ela define uma macro chamada content Dentro das chaves html normal E poss vel inserir textos adicionais junto com quaisquer comandos de formata o html para colocar o conte do que voc quer ver na p gina O texto em html normal caso queira poss vel incluir hyperlinks e utilizar todos os recursos inclu dos na linguagem html Para fazer o seu link da nova home page em p ginas de outras bibliotecas digitais voc precisa uitlizar as palavras m gicas apropriadas Na linguagem macro palavras m gicas s o palavras cercadas por tra o inferior underscore E poss vel ver isso na figura 4 Por exemplo _httppagehome_ lhe direcionar para a home page _httppagehelp_ para a p gina de ajuda e assim por diante Em alguns casos sera necess ria a inclus o do nome da cole o Por exemplo _httpquery_ amp c demo especifica a p gina de busca para a cole o demo para outras cole es necess rio substituir demo pelo nome de cole o adequado A defini o da macro content puro html Qualquer c digo padr o html pode ser substitu do dentro de uma defini o da macro Entretanto os caracteres especiais Y Y e _ devem ser utilizados juntos com a barra invertida para preven
49. quadamente Assim para recompilar o Greenstone de tal maneira que ele produza CD ROMS que funcionem em vers es anteriores do Windows voc precisa de e O compilador Microsoft Visual C compiler vers es 4 0 ou 4 2 e Uma vers o externa do STL o template da biblioteca padr o do C O STL empacotado com o Greenstone para o uso destas vers es de compiladores Note que o procedimento de instala o no Windows n o tenta compilar o Greenstone para voc se voc escolher instalar o c digo fonte Para as instru es espec ficas sobre a plataforma e compiladores veja o documento Install txt que est localizado no diret rio C Program Fileslgsd por default durante o processo de instala o 2 2 Unix Esta se o escrita para usu rios Unix Os usu rios Windows dever o pular para a Se o 2 3 Voc precisa escolher entre instalar o c digo fonte ou o c digo bin rio O c digo bin rio ocupa aproximadamente 50Mb de disco o c digo fonte requer aproximadamente 160 Mb para a compila o Bin rios do Unix O c digo bin rio requer uma distribui o Linux baseada em Intel x86 que inclua o 7 O Procedimento de Instala o suporte bin rio ELF Algumas das distribui es que t m este crit rio s o RedHat 5 1 SuSE Linux 6 1 Debian 2 1 Slackware 4 0 As vers es mais recentes destas distribui es deveriam funcionar tamb m Voc precisar de um servidor web n s recomendamos o Apache Tamb m reco
50. ru o de cole o do Greenstone em uma interface de f cil manuseio 10 O Procedimento de Instala o A GLI instalada automaticamente com todas as distribui es do Greenstone Est localizada no subdiret rio gli no n vel superior do diret rio do Greenstone C Program Files gsadl gli por default Note que a GLI executada em conjunto com o Greenstone e n o trabalhar corretamente se n o estiver localizada em um subdiret rio da instala o do Greenstone Este o seu caso se voc fez o download de uma das distribui es do Greenstone Para utilizar a GLI seu computador precisar do ambiente Java Runtime Environment Se voc ainda n o o instalou o instalador lhe apresentar uma vers o j inclusa no CD ROM No ambiente Unix voc tamb m dever assegurar que o Perl est instalado no ambiente Windows o Perl j est incluso no software Greenstone Caso voc tenha algum problema usando ou executando a Interface de Biblioteca por favor reporte o erro para greenstone cs waikato ac nz Executando no ambiente Windows Para executar a GLI no ambiente Windows selecione a pasta gli na instala o do Greenstone utilizando o Windows Explorer e fa a um click duplo no arquivo gli bat Este arquivo checa se o Greenstone o Java Runtime Environment e o Perl est o instalados e inicia a Interface de Biblioteca Greenstone Executando no ambiente Unix Para executar a GLI no ambiente Unix v ao diret rio gli da
51. s computadores na mesma rede consigam acessar a biblioteca Por m o servidor web t m configurabilidade limitada 5 O Procedimento de Instala o O software de Biblioteca Local determina automaticamente se o seu computador tem software de rede instalado ou se est conectado em uma rede Ele opera corretamente sobre qualquer combina o destas condi es Entretando existem dois poss veis problemas que podem ser encontrados O Greenstone pode e causar uma chamada de linha discada n o requisitada e falha na execu o porque o software de rede est instalado por m instalado incorretamente Uma vers o restrita da Biblioteca Local fornecida com o objetivo de uso para estas situa es A vers o restrita somente opera com Netscape e n o com o Internet Explorer Quando voc executar a vers o de Biblioteca Local do Greenstone a caixa de di logo contem um bot o que lhe permite usar a vers o restrita Ao menos que algum dos problemas listados acima ocorra voc deveria sempre utilizar a vers o padr o Biblioteca Web Isto habilita qualquer computador com um servidor web a visualizar cole es pr constru das do Greenstone Assim como a Biblioteca Local acima a cole o DEMO do Greenstone ser automaticamente instalada Voc poder instalar tamb m outras cole es do CD ROM veja a se o 3 A Biblioteca Web difere da Biblioteca Local porque tem o objetivo de operar em computadores que j tenham o software par
52. se o 4 d conta detalhada dos passos da instala o do servidor web que afetam o Greenstone e como eles podem ser 6 O Procedimento de Instala o alterados Aproximadamente meia d zia de linhas s o alteradas no arquivo de configura o O c digo de fonte Windows O c digo fonte do Windows ocupa 50 Mb de espa o de disco por m para compil lo voc precisar de aproximadamente 90Mb Para compilar os fontes no Windows voc precisa de e O compilador Microsoft Visual C Ainda estamos verificando alguns problemas compilando o Greenstone com v rias portas do Windows utilizando o GNU GCC Voc n o precisar do GDBM o administrador de banco de dados Gnu por que ele j est inclu do na distribui o fonte do Greenstone Provavelmente voc n o conseguir compilar o Greenstone em uma m quina Windows 3 1 3 11 No caso de voc recompilar o Greenstone e querer usar esta vers o para criar CD ROMs voc precisa notar que o c digo produzido por vers es recentes do compilador Visual C n o consegue ser executado em Windows 3 1 3 11 apesar de n o haver problemas com vers es posteriores do Windows 95 98 Me NT 2000 Se voc quiser que seus CD ROMs operem em vers es anteriores de Windows voc precisar de uma vers o diferente do compilador De qualquer maneira o Greenstone utiliza o STL a biblioteca padr o de C e embora estes compiladores tenham o STL as vers es fornecidas n o funcionam ade
53. st 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 21 6 1 Personalizando sua Instala o 6 Personalizando sua Instala o Provavelmente a primeira coisa que voc vai querer fazer uma vez com o Greenstone instalado e rodando ser a personalizar a home page O arquivo que gera a home page do Greenstone chamado de home dm e est localizado no subdiret rio macros no qual voc instalou o Greenstone O caminho padr o em ambientes Windows C Program Filesigsal Este arquivo um arquivo texto que voc precisar editar para criar uma nova home p
54. tra o exemplo de uma nova home page para a biblioteca digital Cada um dos links Click here lhe direcionar para um recurso do Greenstone Esta p gina foi gerada pelo arquivo chamado yourhome dm mostrado na figura 4 22 Personalizando sua Instala o package home content lt h2 gt Your own Greenstone home page lt h2 gt lt ul gt lt table gt lt tr valign top gt lt td gt Search page for the demo collection lt br gt lt td gt lt td gt lt a href httpquery amp c demo gt Click here lt a gt lt td gt lt tr gt lt tr gt lt td gt About page for the demo collection lt td gt lt td gt lt a href httppageabout amp c demo gt Click here lt a gt lt td gt lt tr gt lt tr gt lt td gt Preferences page for the demo collection lt td gt lt td gt lt a href httppagepref amp c demo gt Click here lt a gt lt td gt lt tr gt lt tr gt lt td gt Home page lt td gt lt td gt lt a href httppagehome gt Click here lt a gt lt td gt lt tr gt lt tr gt lt td gt Help page lt td gt lt td gt lt a href hnttppagehelp gt Click here lt a gt lt td gt lt tr gt lt tr gt lt td gt Administration page lt td gt lt td gt lt a href httppagestatus gt Click here lt a gt lt td gt lt tr gt lt tr gt lt td gt The Collector lt td gt lt td gt lt a href httppagecollector gt Click here lt a gt lt td gt lt tr gt lt table gt lt ul gt if y
55. whether it is published as a printed book We recommend this License principally for works whose purpose is instruction or reference 1 APPLICABILITY AND DEFINITIONS This License applies to any manual or other work in any medium that contains a notice placed by the copyright holder saying it can be distributed under the terms of this License Such a notice grants a world wide royalty free license unlimited in duration to use that work under the conditions stated herein The Document below refers to any such manual or work Any member of the public is a licensee and is addressed as you You accept the license if you copy modify or distribute the work in a way requiring permission under copyright law A Modified Version of the Document means any work containing the Document or a portion of it either copied verbatim or with modifications and or translated into another language A Secondary Section is a named appendix or a front matter section of the Document that deals exclusively with the relationship of the publishers or authors of the Document to the Document s overall subject or to related matters and contains nothing that could fall directly within that overall subject Thus if the Document is in part a textbook of mathematics a Secondary Section may not explain any mathematics The relationship could be a matter of historical connection with the subject or with related matters or of legal commercial philosophical eth
56. xisting ones or delete collections Administration lows you to add new users summarizes the collections in the system gives technical information on the Greenstone installation Greenstone Tells you about the Greenstone software and the New Zealand Digital Library Project where it originated x Document Done 7 Arquivos bin rios do Windows Existem dois programas bin rios separados para o Windows no CD ROM a Biblioteca Local e a Biblioteca Web A instala o padr o descrita acima seleciona a vers o da Biblioteca Local Recomendamos fortemente que voc utilize esta vers o A Biblioteca Web muito mais dif cil de configurar somente necess ria se voc j utiliza um servidor web e quer utiliz lo tamb m para o Greenstone Apesar do seu nome modesto a Biblioteca Local apresenta completa capacidade de ser concisa e de servir disponibilizar as informa es via web Biblioteca Local Ela habilita qualquer computador Windows a servir visualizar cole es pr constru das do Greenstone A cole o Demo do Greenstone ser instalada automaticamente voc poder instalar tamb m outras cole es dispon veis no CD ROM Section 3 O software da Biblioteca Local o mesmo utilizado pelos CD ROMs produzidos pelo sistema do Greenstone A Biblioteca Local feita para o uso de computadores isolados ou de computadores que ainda n o t m um software para servidor web Ela cont m um pequeno servidor web interno para que outro
57. zando o Netscape no ambiente Windows 2000 Se a resposta for sim tente utilizar o Internet Explorer somente no Windows 2000 parece haver alguma incompatibilidade com o Netscape Adicione uma diretiva ServerName localhost no arquivo de configura o do Apache verifique a se o 4 1 Quando eu direciono o meu navegador para a biblioteca digital ele mostra um lixo um arquivo bin rio Verifique a diretiva ScriptAlias no arquivo de configura o do Apache certifique se que ela est localizada antes da diretiva Alias verifique as Se es 4 2 e 4 3 Eu consigo acessar a p gina do Greenstone Figure 2 mas o icone da cole o Demo n o aparece Execute o programa library no diret rio cgi bin a partir do prompt do DOS ou do shell para gerar as informa es necess rias para ajudar na localiza o do problema Ambas as vers es Quando eu tento acessar a p gina da biblioteca digital no meu navegador exibida uma mensagem dizendo que a p gina n o pode ser encontrada Tente utilizar o ip 127 0 0 1 em vez de localhost Este n mero de IP reservado tamb m pode ser utilizado para acessar seu computador local Meu navegador exibe uma mensagem dizendo que n o pode encontrar main cfg Verifique se os arquivos do Greenstone existem e se t m permiss o de serem lidos por qualquer usu rio Se voc estiver utilizando a biblioteca Web tente executar o programa library da linha d
Download Pdf Manuals
Related Search