User Tools

Site Tools


en:user:exporting_collections
This version is outdated by a newer approved version.DiffThis version (2016/09/27 04:08) is a draft.
Approvals: 0/1

This is an old revision of the document!


Exporting collections

Greenstone 2 can export collections to CD/DVD-ROMs.

Commandline export

In Windows:

cd C:\Users\<username>\Greenstone
setup


In Linux, cd to Greenstone directory:

source setup.bash


Move into the directory of the collection you want to export:

cd collect\<collection-name>

Creating CD/DVD-ROM Collections

Greenstone collections can be exported and written into a CD/DVD that can run independently on Windows machines.

Choose File → Write CD/DVD image…. In the resulting popup window, select the collection or collections that you wish to export by ticking their check boxes. You can optionally enter a name for the CD-ROM: this is the name that will appear in the menu when the CD-ROM is run. If a name is not entered, the default Greenstone Collections will be used. You can also specify whether the resulting CD-ROM will install files onto the host machine when used or not. Click <Write CD/DVD image> to start the export process.

The necessary files for export are written to:

Greenstone → tmp → exported_xxx

where xxx will be similar to the name you have entered. If you didn't specify a name for the CD-ROM, then the folder name will be exported_collections.

You need to use your own computer's software to write these on to CD-ROM. On Windows XP this ability is built into the operating system: assuming you have a CD-ROM or DVD writer insert a blank disk into the drive and drag the contents of exported_xxx into the folder that represents the disk.

The result will be a self-installing Windows Greenstone CD-ROM or DVD, which starts the installation process as soon as it is placed in the drive.

Output collections

Go to the GLI, choose File-"Write CD/DVD image" from the menu. The window "Write CD/DVD image" will pop up and require you to fill in some information.

  • CD/DVD name (Give a name of the CD/DVD) for example: myCollects
  • Two options for launching the library. The default option is "CD/DVD will install some files when used (faster)"
  • All available collections are listed in the "Available collections". Select the collections by clicking the name of the collection. Once a collection is selected, the general information of the collection will be displayed in the "Selected collection's detail"
  • The estimated size of selected collections in total can be seen near the end of the window
  • Click button "Write CD/DVD image" to finish the collections output.
  • The output collections are saved at GSDLhome/tmp/myCollects

Write into a CD/DVD

Start a CD/DVD recorder software, add the myCollects folder into the CD/DVD, then click the button to burn a CD/DVD.

Running exported collections on Windows

myCollects/Setup.exe (if necessary, install some files to speed up the launch)

myCollects/gsdl/server.exe (directly enter into the library)

Creating CD/DVD-ROM's from Collections

Installing the Plugin

NB - the plug-in does not work from remote machines - you must use the GLI on the server itself, or alternately use the commandline.

  • Install into gsdl\bin\windows
  • For Remote Machines (not recommended since plugin only works on server)
  • unzip your gsdl-2.xx-export.zip file on local machine
  • ftp the contents of the gsdl-2.xx… onto the hosting machine

Creating Collections From the Command Line (exportcol.pl)

  • source setup.bash (in the Greenstone directory)
  • perl -S bin/script/exportcol.pl -nonetscape <collection-name>

<!-- id:44 -->Using a Greenstone CD-ROM

The Greenstone digital library software itself comes on a CD-ROM, and you or your system manager have probably installed it on your system, following the instructions in the Greenstone Digital Library Installer's Guide. If so, Greenstone is already installed on your computer and you should skip the rest of this section.

Some Greenstone collections come on a self-contained Greenstone CD-ROM that includes enough of the software to run just that collection. To use it, simply put it into the CD-ROM drive on any Windows PC. Most likely (if “autorun” is enabled on your PC), a window will appear inviting you to install the Greenstone software. If not, find the CD-ROM disk drive (on current Windows systems you can get this by clicking on the My Computer icon on the desktop) and double-click it, then the Setup.exe file inside it. The Greenstone Setup program will be entered, which guides you through the setup procedure. Most people respond yes to all the questions.

When the installation procedure has finished, you'll find the library in the Programs submenu of the Windows Start menu, under the name of the collection (for example, “Development Library” or “United Nations University”).

Once the software has been installed, the library will be entered automatically every time you re-insert the CD-ROM if autorun is enabled.

Customizing Export

Some notes on customising export - specifically for DSpacePlugout, but also applicable elsewhere;

  1. you can create a folder for modified plugouts for a specific collection in the same way you do for collection specific plugins

collects/<collectname>/perllib/plugouts

  1. export.pl is very similar to import.pl with many similar options.
  2. sub get_dc_metadata in BasPlugOut.pm can be modified to handle qualified dublin core. ( see https://list.scms.waikato.ac.nz/mailman/private/greenstone-devel/2007-February/001586.html )
  3. try export.pl at the prompt fro a list of options not available when exporting from the gli (note that gli defaults are sensible)

Additional Resources

<TABAREA tabs="Greenstone3,Greenstone2"> <TAB> The tutorial on moving a collection from Greenstone to DSpace demonstrates how to export a collection via the commandline. </TAB> <TAB> The following tutorials involve exporting collections:

</TAB> </TABAREA>

en/user/exporting_collections.1474949310.txt.gz · Last modified: 2016/09/27 04:08 by anupama