Greenstone Wiki - en:user_advanced

archive_formats

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Greenstone Archive Formats During the import portion of the build process, Greenstone stores all metadata--extracted metadata, extracted text, and assigned metadata--in an XML format for use. Then, during the actual collection building, this metadata is processed by a plugin and utilized for creating browsing classifiers, partitions, and indexes.

classifiers

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Browsing Classifiers The information used to support browsing is stored in the collection information database, and is placed there by classifiers that are called during the final phase of buildcol.pl. Classifiers, like plugins, are specified in a collection's configuration file. For each one there is a line starting with the keyword

collection_building

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Advanced collection building In the GLI, the actual building of the collection is done in the Create panel. There are many options associated with the building process. Many of these are available in the GLI when in expert mode (File -> Preferences

collection_database

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Collection Database The collection database dictates how data about your collection is stored. Greenstone comes with two database options: GDBM and JDBM. They are essentially the same; JDBM is simply a Java implementation of GDBM. They are flat file database engines. You can select which of these to use in the

command_line_building

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Command Line Building It is possible to create and build collections directly from the command line. This page provides the basic information on building Greenstone collections on the command line. The first section shows how to rebuild a collection that has been created and edited in GLI. GLI doesn't do proper incremental building, so for large collections, it may save time to set up a collection using GLI and build it on the command line.

command_line_download

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Downloading from the command line Greenstone allows you to download files from the internet using a variety of protocols: * Web: downloads web pages and files via HTTP and FTP. * MediaWiki: downloads web pages and files via HTTP from a MediaWiki website.

debug

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Debugging Greenstone Collection Building * GLI, expert mode * building on the command line Debugging the interface * add debug=1 to the url, add in a debug info link to the page. Clicking on this link will give a list of options for seeing the raw xml source of the page, the transform files etc

document_identifiers

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Document Identifiers Every document in a Greenstone collection gets given a unique object identifier (OID). This is used in URLs to refer to that document. There are several methods used for assigning identifiers. The method can be changed using the OIDtype option. This option is available as an import option and as a plugin option. Setting it for import will mean that all plugins will use that setting. Setting it for a plugin will mean that only that plugin will use the setting, overriding the…

fli

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Running FLI, the Fedora Librarian Interface The purpose of FLI FLI is built on top of GLI. Just as with GLI, it allows you to drag-and-drop documents into a collection which it will then build. The building process of FLI is different in that it will export the documents into a

google_analytics

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Using Google Analytics Here are just some notes I am making as I try to work out how to use this. * - to sign up It seems that you sign up to google analytics with your google account. Then you can add websites to be analysed. Useful website:

greenbug

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Greenbug Greenbug is an online XSL template editor for Greenstone3. Named Greenbug as it is a bit like Firebug, but for Greenstone, not Firefox. To use Greenbug you must have DebugService in the list of services in your siteConfig.xml file. This service handles the saving and retrieving of the XSL templates, and is included by default.

greenstone_databases

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Information about the databases Greenstone uses Greenstone comes with several database systems included: gdbm, jdbm, SQLite. When building a collection, you can control which of these is used. In GS3, the default is jdbm. In terms of user account management, GS3 uses "Java DB" that's bundled with Java (since an early version of Java), see

greenstone_extensions

Anonymous (anonymous@undisclosed.example.com) — 2025-07-25T02:55:10+00:00

Greenstone Extensions OpenOffice The Open Office extension provides a document conversion facility if Open Office or LibreOffice is already installed on the system. In order to use the Open Office extension, * You will need Open Office or LibreOffice installed. You may need to create an environment variable called SOFFICE_HOME and set this to the full path of your OpenOffice or LibreOffice installation folder, if:

greenstone2_with_iis

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Running greenstone2 using IIS Note: we don't use IIS, test Greenstone with it, or recommend it. Greenstone binaries come with Apache included. Apache has a much better security record, and of course it's open source. Note: These notes are quite old (written for version 2.82), but included here just in case

greenstonesqlplugs

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Editing archives metadata and/or fulltext using a MySQL database Like the GreenstoneMETSPlugin, the GreenstoneSQLPlugin is another alternative to using the GreenstoneXMLPlugin. You can choose to use the GreenstoneSQLPlugout and GreenstoneSQLPlugin (they work together) in place of the GreenstoneXMLPlugin and the default plugout GreenstoneXMLPlugout

gs2_administration_pages

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Greenstone 2 Administration Pages An “administrative” facility is included with every Greenstone 2 installation.To access this facility, click the appropriate link on the front page. The entry page gives information about each of the collections offered by the system. Note that

gs2_format

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Advanced Greenstone 2 Formatting Topics Displaying Language Names instead of Codes Often documents will have language metadata in two letter codes, such as en, fr, ja, or maybe three letter codes, like eng, fre, ger. Lets say our documents have two letter language codes, in the dc.Language metadata field. And we want to display this in our search results. We can add

gs2_server

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Advanced Server: Greenstone 2 Setting up an Apache Webserver Setting up an Apache web server to work with Greenstone 2. Installing the Apache web server on Linux and MacOS (Leopard) A walkthrough for Linux on how to set up Apache's httpd.2.2.8 web server for Greenstone v2.80. The following should hopefully work with other releases of the Apache's HTTP Server as well.

gs2_user_management

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Greenstone 2 User Management Creating a new user You need to use the administration facility. You can access the administration page by clicking the Administration Page button on the home page of your Greenstone installation. If this is not present, enable it by setting

gs3_collection_groups

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Collection Grouping in Greenstone 3 You can group collections in Grenstone 3. This can clean up the home page if you have a lot of collections, as a group will have a single icon on the home page. CLicking it takes you to a home page for the group: only those collection in the group will be displayed here.

gs3_custom_doc_display

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Customisations to Document Display in Greenstone 3 Customizing the Image Slider To customize the image slider. Look at the web/interfaces/default/js/document_scripts.js If you want to customise things in here for just one collection, add a file eg js/custom-document.js into the collection. document_scripts is included in the page by the "javascriptForDocumentView" template, in transform/pages/document.xsl. If you look at this you can see that it calls a template "customJavascriptForDocumentVie…

gs3_displayitems

Anonymous (anonymous@undisclosed.example.com) — 2023-12-21T07:40:48+00:00

Display Items in Greenstone 3 DisplayItems are used in the collectionConfig.xml file to customise bits of text, in a language specific manner. For example, they are used for: * search field names * classifier names * collection name and description

gs3_https

Anonymous (anonymous@undisclosed.example.com) — 2025-09-10T00:14:32+00:00

Running Greenstone3 over HTTPS There are two main ways of running Greenstone 3 using HTTPS: * [Preferred] Running an Apache server configured to support HTTPS, and reverse proxying the Tomcat server * Setting up Tomcat to run using HTTPS Using Apache to reverse proxy Tomcat

gs3_server

Anonymous (anonymous@undisclosed.example.com) — 2025-06-27T03:00:30+00:00

Greenstone 3 Apache Tomcat Server Tomcat is a servlet container, and Greenstone3 runs as a servlet inside it. The file $GSDL3SRCHOME/packages/tomcat/conf/server.xml is the Tomcat configuration file. A Tomcat Context represents a web application. The Context for Greenstone3 is given by the file $GSDL3SRCHOME/packages/tomcat/conf/Catalina/localhost/greenstone3.xml. This tells Tomcat where to find the files for the application including its web.xml file (in the $GSDL3HOME folder, ie the web fo…

gs3_user_management

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Greenstone 3 User Management Greenstone software comes equipped with a system for registering and administering users. Greenstone users can register as a user with a login and password. Administrators can then assign them into various groups. These user groups are used for authenticating login to a

ice_cite

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Processing PDFs with Icecite and the UnknownConverterPlugin The contents of this page were originally created as the final section of the Greenstone 3 tutorial "Using the UnknownConverterPlugin to make unsupported document formats searchable", with that tutorial intended to appear officially in public with GS3.09. However this section has been removed from the tutorial for the following reasons:

index

Anonymous (anonymous@undisclosed.example.com) — 2023-11-29T00:24:33+00:00

Advanced User Information This section of the wiki includes useful information for tasks which are beyond the normal ones of running GLI and building collections. We think of it as aimed for the Greenstone system administrator. Other advanced information can be found in the

installation_287

Anonymous (anonymous@undisclosed.example.com) — 2025-07-15T00:07:16+00:00

Advanced Installation: Greenstone2 : 2.87 and prior Advanced Installation Index Page - from here you can access GReenstone3 versions of this page. For most users, the main Greenstone download (also called the "binary") with default settings is sufficient, and is very easy to install. However, there are some instances where you may want or need to go through a more advanced installation process:

installation_310

Anonymous (anonymous@undisclosed.example.com) — 2025-07-15T00:06:42+00:00

Advanced Installation : 3.10 and prior Up to date for GS3.10, checked 20 Feb 2021. This page is up to date for 3.06 (5 November 2014). Much of it was checked again to be up to date after 3.08. Advanced Installation Index Page - from here you can access different versions of this page.

installation_311

Anonymous (anonymous@undisclosed.example.com) — 2025-07-15T00:08:14+00:00

Advanced Installation: 3.11 Updated on 30 Sep 2021, with changes that do not apply for Greenstone 3.10 and earlier. Advanced Installation Index Page - from here you can access different versions of this page. For most users, the main Greenstone download (also called the "binary") with default settings is sufficient, and is very

installation_312

Anonymous (anonymous@undisclosed.example.com) — 2025-07-18T05:36:29+00:00

Advanced Installation: 3.12 TODO: currently just copied from 3.11 version. update for 3.12 For installation instructions for older versions of Greenstone, please see the Advanced Users Installation Index Page. For most users, the main Greenstone download (also called the "binary") with default settings is sufficient, and is very

installation

Anonymous (anonymous@undisclosed.example.com) — 2026-05-07T06:03:50+00:00

Advanced Installation For most users, the main Greenstone download (also called the "binary") with default settings is sufficient, and is very easy to install. However, there are some instances where you may want or need to go through a more advanced installation process:

lucene

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Indexing Using Lucene Lucene can be used as the collection indexer instead of MG/MGPP. You can select Lucene in GLI from the Search part of the Design Pane. See the Searching page for more information about the differences between MG, MGPP and Lucene. Editing the collection's configuration file

metadata

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Advanced Metadata Topics Obtaining a list of all subject headings in a collection Diego Spano explains: There is no direct way to do that, but there is a workaround. Run the following commands in your terminal: 1. To set up the GS environment, type:

more_about_classifiers_gs2

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

More about Classifiers (Greenstone 2) I've added a new type of classification to my collection. How do I create and add the navigation bar images? Visit this page and follow the instructions. Note: this is only necessary for Greenstone v2.62 and earlier (newer versions use

oai_server_gs2

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Greenstone 2 OAI server Greenstone comes with a built-in OAI data provider. This runs as a CGI program called oaiserver.cgi, and is installed in the Greenstone cgi-bin directory. It can be accessed via the same URL as the Greenstone library (replacing

oai_server_gs3

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Greenstone 3 OAI server The Greenstone3 OAI data provider facility comes enabled by default. It runs as a servlet called "oaiserver", and can be accessed using the same URL as the library, by replacing library with oaiserver. For example, http://localhost:8080/greenstone3/oaiserver

oai

Anonymous (anonymous@undisclosed.example.com) — 2024-05-01T00:22:40+00:00

OAI The Open Archives Initiative Protocol for Metadata Harvesting (OAI-PMH) allows for interoperability between document repositories. * Data Providers expose their metadata using OAI-PMH * Service Providers or harvesters access this metadata by making service requests. Greenstone allows you to both harvest metadata provided by others and make the metadata for your own collections accessible via OAI-PMH.

public_tomcat_win10

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Windows 10 instructions to make your GS3 tomcat web server public Follow these instructions only for briefly testing a public GS3 tomcat, such as for the Validating the Greenstone OAI server section of the tutorial Setting up your Greenstone OAI Server, as I'm not sure the following method is robust against potential security threats.

remote_greenstone

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Remote Greenstone Remote Greenstone involves using a version of GLI locally to edit collections on a remote Greenstone server, thus allowing users to collaborate on collections (at different times), and without a local Greenstone installation. Client GLI vs applet - now deprecated.

remote_greenstone2

Anonymous (anonymous@undisclosed.example.com) — 2023-03-19T21:17:02+00:00

Setting up Remote Greenstone for Greenstone 2 Building Greenstone collections remotely Until now, using the GLI has required either a complete Greenstone installation, or the GLI applet to be installed on a server machine. In both cases, collaboration on collections is not possible.

remote_greenstone3

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Setting up Remote Greenstone for Greenstone 3 Preliminary notes for those using the Greenstone 3.03 binary release * Make back-up copies of your gsdlCGI4gs3.pm and gliserver4gs3.pl * Download the slightly modified versions of the two server-side files from SVN:

scheduled_building

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Scheduled Building (under construction) In the upcoming release of Greenstone 2, the Greenstone Librarian Interface (GLI) will contain a new feature called The Scheduler. This feature allows the user to schedule periodic (i.e. hourly, daily, weekly) builds of their Greenstone collection while he/she is offline. This will benefit collections that have documents added on an hourly, daily or weekly basis.

script_options

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Greenstone Scripts This is a list of Greenstone scripts, with all available options and their descriptions and value information. To run any of these scripts, you must first setup the Greenstone environment in your terminal. To do this, cd to the Greenstone folder and run the setup script:

security

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Security in Greenstone Collections Greenstone software comes equipped with a system for registering and administering users. Greenstone users can register as user with a login and password. Administrators can then assign them into various groups. For user management information, see

solr

Anonymous (anonymous@undisclosed.example.com) — 2026-02-26T23:41:17+00:00

Indexing Using SOLR In Greenstone 3, (version 3.06rc1 onwards) you can use SOLR as the collection indexer (in place of MG/MGPP/Lucene). See for more details about SOLR. There is only rudimentary, partial support in GLI for building a Greenstone collection with solr as the indexer. At present, GLI will preserve solr-specific elements, such as the

upgrading_greenstone

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Upgrading your Greenstone Installation Greenstone upgrades involve installing the latest version in a separate place to your existing installation, then copying over collections, and repeating any interface modifications in the new version. Once you have the new version working, then you need to change to serving up that one instead of the original.

using_databaseplugin

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Using Database Plugin DatabasePlugin uses Perl's DBI module to import records from a database. DBI includes back-ends for mysql, postgresql, comma separated values (CSV), MS Excel, ODBC, sybase, etc. You will need to have the DBI module installed, as well as the appropriate back end module(s).

using_expand_macros_script

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Using the expand_macros.pl script * The expand_macros.pl script allows you to get a list of all macros and where they are defined (in order to have macros defined in the c++ source included as well, you may specify the path to your Greenstone source directory; see the usage information of the script for details):

web_editor

Anonymous (anonymous@undisclosed.example.com) — 2024-06-03T23:51:54+00:00

Online Document Editing in Greenstone 3 Greenstone 3 allows you to edit the content and metadata of documents online in a web browser. This functionality is available to logged-in users who have been assigned to either the "all-collections-editor" group, or the "collname-collection-editor" group, where collname is the short identifier of the collection (its folder name in the collect folder).

webswing_gli

Anonymous (anonymous@undisclosed.example.com) — 2025-09-08T01:58:52+00:00

Webswing GLI Webswing is a technology that allows java programs to run in a browser. Greenstone 3.11 and later comes with webswing enabled, so that GLI can be run in a browser, allowing remote users the ability to build and edit collections on the server without having to install Greenstone (and Remote GLI).

z3950

Anonymous (anonymous@undisclosed.example.com) — 2023-03-13T01:46:31+00:00

Z39.50 Z39.50 is an international client/server protocol for searching bibliographic data. It can use the Internet Protocol (TCP/IP), which makes the databases on a server available from almost anywhere around the globe. It is widely used, for example, in on-line library catalogues. It allows a user to search one or more databases and retrieve the results of the query.