Greenstone Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Basic Installation ======

//**Part of the [[en:beginner:index|Greenstone Beginner's Guide]]**// \\
===== <!-- id:bi-1 -->Obtaining Greenstone =====

<!-- id:bi-2 -->The main Greenstone downloads (Greenstone 2 and 3) are available on the [[http://www.greenstone.org/download| Greenstone download page]],
under //Latest Greenstone3 Distribution// or  //Latest Greenstone2 Distribution//. Click the link for your operating system, and, when prompted, save the file. 


===== Installation =====
<!-- bi-4 --> Upon downloading the installer, run the executable: On Windows and Mac you need to double-click 
it to launch the installation dialog, on Linux you first need to set the downloaded executable's 
permissions to executable before you can run it from the terminal.

<!-- bi-5 --> It may take some time for the Greenstone installation dialog to appear. 
Once the installation dialog displays, you generally need to keep pressing the Next button until 
it is finished. 

<!-- bi-6 --> **Note:** When the installer asks for the location to install Greenstone in, make sure to choose 
a location on your file system for which you have access privileges. If you are using Windows Vista/7,
we recommend you **do not install Greenstone in Program Files**, as the default file permissions for
this folder can cause issues when you attempt to run Greenstone. We recommend your 'User' directory or
your Documents folder as the installation destination, instead. This way Greenstone will be able to 
run without any extra steps. 


<!-- bi-7 --> If you do want to install Greenstone into Program Files on Windows Vista or 7 (and you have
administrator permissions on your computer), you can run 
the installer with administrator permissions by right clicking on the
 installer and choosing "Run as administrator".

<!-- bi-8 --> For more information on installation options, including downloading and compiling source code from source distributions or Subversion (SVN),  see the [[en:user_advanced:installation|Advanced Installation]] page.


===== Greenstone Suite =====
The basic Greenstone installation includes a suite of software. In Windows, you will find the following in //Start -> All Programs -> Greenstone//.
<TABAREA tabs="Greenstone3,Greenstone2">
<TAB>
=== Greenstone Librarian Interface (GLI) ===
The Greenstone Librarian Interface, or GLI, is a graphical tool for building new collections, 
altering or deleting existing collections, and exporting existing collections to stand-alone CD-ROMs.
For the average user, the GLI is where you will create and modify all of your Greenstone collections,
and is the focus of the Beginner's Guide.

=== Greenstone Server ===
The [[en:user:greenstone_server|Greenstone Server]] is how you "start up" your library for viewing in the browser. The server 
begins automatically when you enter the GLI. Because the server should work sufficiently 'out-of-the-box',
it is not covered in-depth in the Beginner's Guide. 

=== Greenstone Editor for Metadata Sets (GEMS) ===
[[en:user:metadata_sets#greenstone_editor_for_metadata_sets_gems|GEMS (Greenstone Editor for Metadata Sets)]] can be used to modify existing metadata 
sets or create new ones. GEMS can either be launched from the **Enrich** panel in the Librarian Interface
or from outside the Librarian Interface (in Windows by going to //Start -> Programs -> Greenstone -> GEMS//).

=== Uninstall ===
The Uninstall program included with your installation provides an easy way to remove the Greenstone
software from your computer, while giving you the option to keep or remove any collections you have created,
as well.

=== Documentation ===
The //Documentation// folder includes links to the [[http://www.greenstone.org|Greenstone page]] and [[http://wiki.greenstone.org|Greenstone wiki]],
as well as a short README file.
</TAB>
<TAB>
=== Greenstone Librarian Interface (GLI) ===
The Greenstone Librarian Interface, or GLI, is a graphical tool for building new collections, 
altering or deleting existing collections, and exporting existing collections to stand-alone CD-ROMs.
For the average user, the GLI is where you will create and modify all of your Greenstone collections,
and is the focus of the Beginner's Guide.

=== Greenstone Server ===
The [[en:user:greenstone_server|Greenstone Server]] is how you "start up" your library for viewing in the browser. The server 
begins automatically when you enter the GLI. Because the server should work sufficiently 'out-of-the-box',
it is not covered in-depth in the Beginner's Guide. 

=== Greenstone Editor for Metadata Sets (GEMS) ===
[[en:user:metadata_sets#greenstone_editor_for_metadata_sets_gems|GEMS (Greenstone Editor for Metadata Sets)]] can be used to modify existing metadata 
sets or create new ones. GEMS can either be launched from the **Enrich** panel in the Librarian Interface
or from outside the Librarian Interface (in Windows by going to //Start => Programs => Greenstone => GEMS//).

=== Remote Librarian Interface (ClientGLI) ===
As its name suggests, the [[en:user_advanced:remote_greenstone|Remote Librarian Interface]] is a tool for editing collections on a remote server.

=== Uninstall ===
The Uninstall program included with your installation provides an easy way to remove the Greenstone
software from your computer, while giving you the option to keep or remove any collections you have created,
as well.

=== Documentation ===
The //Documentation// folder includes links to the [[http://www.greenstone.org|Greenstone page]] and [[http://wiki.greenstone.org|Greenstone wiki]],
as well as a short README file.

</TAB>
</TABAREA>


**//Once you have successfully installed the Greenstone software, you are ready to start [[en:beginner:building_collections|building collections]].//**