From GreenstoneWiki

Contents 1 Configuration, mapping, log and database files 1.1 Greenstone2 1.1.1 Configuration files 1.1.1.1 Server Configuration files 1.1.1.2 GLI configuration files 1.1.1.3 Collection configuration files 1.1.2 Mapping files 1.1.3 Database files 1.1.4 Log files 1.2 Greenstone3 1.2.1 Configuration files 1.2.1.1 Server Configuration files 1.2.1.2 GLI Configuration files 1.2.1.3 Collection configuration files 1.2.2 Admin Configuration files = 1.2.3 Log files

Configuration, mapping, log and database files

Greenstone2

GSDLHOME is the main gsdl or greenstone directory.

Configuration files

Server Configuration files

main.cfg 

The main configuration file for the library. Includes things like activation of certain features (administration, collector, depositor, gliapplet, logging), the list of macro files to be used, the list of languages provided, customized default settings for cgi arguments.

lives in GSDLHOME/etc

gsdlsite.cfg 

lives either with library (or library.exe), generally in GSDLHOME/cgi-bin (for a web library) or in the same directory as server.exe (for Windows local library server)

oai.cfg 

OAI server configuration file

lives in GSDLHOME/etc

GLI configuration files

config.xml 

Configuration file for local GLI - stores settings such as library address, last collection open, warnings activated or deactivated etc.

On linux, lives in <USERHOME>/.gli, On Windows, lives in C:\Documents and Settings\<username>\Application Data\Greenstone\GLI

configRemote.xml 

Separate version for use with GLI client. Basically the same os the local version, but includes gliserver address. Needed so that you can run a local GLI at the same time as running GLI with a remote library server.

On linux, lives in <USERHOME>/.gli, On Windows, lives in C:\Documents and Settings\<username>\Application Data\Greenstone\GLI

Collection configuration files

*.col 

GLI configuration file specific to a collection. Includes information about whether the colleciton has been previously imported or built, and stores the import and build options specified in the Create panel for that collection.

lives in a collection's top level directory (GSDLHOME/collect/<collname>/<collname>.col)

collect.cfg 

Collection design file. Can be edited by hand, or is automatically generated by the GLI

lives in a collection's etc directory (GSDLHOME/collect/<collname>/etc)

build.cfg 

Generated automatically by collection building process. Includes build statistics, and information about indexes that have been built.

lives in a collection's index directory (GSDLHOME/collect/<collname>/index)

Mapping files

dc2marc-mapping.xml 

Maps Dublin Core to MARC field numbers

lives in GSDLHOME/etc

qdc2marc-mapping.xml 

Maps Qualified Dublin Core to MARC field numbers

lives in GSDLHOME/etc

marctodc.txt 

used by MARCPlug for mapping MARC field numbers to Greenstone-style metadata.

lives in GSDLHOME/etc

Database files

history.db 

stores search history information if this has been enabled (on preferences page)

lives in GSDLHOME/etc

users.db 

stores any user account settings generated by the administration facility. These accounts are used by the GLI client and GLI applet.

lives in GSDLHOME/etc

key.db 

stores random keys for users. Used in authenticaion and collector/depositor?? Not sure about this.

lives in GSDLHOME/etc

Log files

usage.txt 

log of all commands sent to the library - only generated if logging is enabled in main.cfg (set logcgiargs to true)

lives in GSDLHOME/etc

error.txt 

log of errors that occurred in the run time library

lives in GSDLHOME/etc

Greenstone3

GSDL3HOME is the main greenstone3 directory. GSDL3WEBHOME is, by default, the GSDL3HOME/web directory, but this may be moved to somewhere else.

Configuration files

Server Configuration files

global.properties 

Some global settings for the server, including gsdl3webhome, proxy information, and library urls.

lives in GSDL3WEBHOME/WEB-INF/classes

siteConfig.xml 

Configuration file for a site. Contains info such as site-wide services, soap connections to other servers. Replacement rules for text and metadata (used for macro replacement for greenstone 2 collections)

lives in GSDL3WEBHOME/sites/<site-name>

interfaceConfig.xml 

Configuration file for an interface. Contains info such as

lives in GSDL3WEBHOME/interfaces/<interface-name>

OAIConfig.xml 

the configuration file for the OAI server

lives in GSDL3WEBHOME/WEB-INF/classes

GLI Configuration files

config3.xml 

Greenstone3 equivalent of config.xml

config3Remote.xml 

Greenstone3 equivalent of configRemote.xml

Collection configuration files

collectConfig.xml 

Collection design file. Greenstone3 equivalent to collect.cfg. Can be edited by hand, or is automatically generated by the GLI

lives in a collection's etc directory (GSDL3HOME/collect/<collname>/etc)

buildConfig.xml 

Generated automatically by collection building process. Greenstone3 equivalent to build.cfg. Includes build statistics, and information about indexes that have been built.

lives in a collection's index directory (GSDL3HOME/collect/<collname>/index)

Admin Configuration files =

build.xml 

Ant build file for compilation, installation and running Greenstone3.

lives in GSDL3HOME

build.properties 

Some properties for ccompilation and installation of Greenstone3.

lives in GSDL3HOME

log4j.properties 

settings for the runtime logging

lives in GSDL3WEBHOME/WEB-INF/classes

Log files

greenstone.log 

lives in GSDL3WEBHOME/logs

server.log 

usage.log