Table of Contents
This page is in the 'old' namespace, and was imported from our previous wiki. We recommend checking for more up-to-date information using the search box.
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 :