en:user:exporting_collections
Differences
This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
en:user:exporting_collections [2015/10/07 06:22] – external edit 127.0.0.1 | en:user:exporting_collections [2023/03/13 01:46] (current) – external edit 127.0.0.1 | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | |||
+ | |||
+ | |||
====== Exporting collections ====== | ====== Exporting collections ====== | ||
Line 4: | Line 7: | ||
Greenstone 2 can export collections to CD/ | Greenstone 2 can export collections to CD/ | ||
+ | **NOTE:**\\ Collections with **Lucene as indexer and/or JDBM as database type won't work with Greenstone 2 collections exported to CD-ROM**. Lucene and JDBM work with Java and Java is not part of the export, so searching (lucene) and browsing (jdbm) won't work.\\ We advise that collections built with lucene and/or jdbm are rebuilt with mgpp as indexer and gdbm as database before exporting. | ||
===== Commandline export ===== | ===== Commandline export ===== | ||
- | |||
- | |||
- | < | ||
- | <TAB> | ||
- | In Windows: | ||
- | < | ||
- | cd C: | ||
- | gs3-setup | ||
- | </ | ||
- | |||
- | \\ | ||
- | In Linux, cd to Greenstone directory: | ||
- | < | ||
- | source gs3-setup.bash | ||
- | </ | ||
- | \\ | ||
- | |||
- | Move into the directory of the collection you want to export: | ||
- | |||
- | < | ||
- | cd web\sites\localsite\collect\< | ||
- | </ | ||
- | </ | ||
- | --> | ||
- | <!-- | ||
- | ################################################################################################ | ||
- | --> | ||
- | < | ||
In Windows: | In Windows: | ||
< | < | ||
Line 52: | Line 27: | ||
cd collect\< | cd collect\< | ||
</ | </ | ||
- | |||
- | < | ||
- | </ | ||
Line 72: | Line 44: | ||
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. | 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. | ||
+ | |||
+ | ==== Can Greenstone3 export to CD/DVD-ROM Collections? | ||
+ | |||
+ | //**The objectives versus what has been implemented so far**// | ||
+ | * GS2 can export to CDROMs/DVDs that run on Windows. The linux and mac GS2 binaries will produce Windows CD-ROMs or DVDs. But GS2 can't produce non-Windows optical discs. | ||
+ | * GS3 should ideally be able to run off a read-only location such as a CD/DVD. The infrastructure necessary to support this had been added, by creating a gsdl3.writablehome property which uses the system' | ||
+ | * The idea is to set Greenstone 3 up the way you like for a CD-ROM or DVD, with your collections ready. Then you should be able to put it into a read-only location such as a disc, and it should be able to work, using a greenstone folder in the temp location to write out output. | ||
+ | * A lot of the infrastructure is there. And a GS3 installation on a linux machine can create the material for a linux disc, GS3 on windows machines can create the contents for a windows disc and Macs can create contents for discs that will run on Macs. The bitness of the architecture (whether the OS is 32 or 64 bit) that it will be running on should probably also match. | ||
+ | * What's not yet there, but what had been envisioned and which is on our wishlist, is for a GS3 installation on any OS to create a cross-platform disc. Some work had already been done to this end with the creation of bin/linux, bin/windows and bin/mac folders to keep binaries separate, so that all three could theoretically be included in one universal binary. The lib folder didn't have to be divided into separate OS subfolders because linux uses .so else .a extensions, macs use .bundle and windows use .dll. It's thought there is support for a bitness subfolder for binaries, but the lib folder set up does not allow for 32 bit and 64 bit variants of an operating system to co-exist, as the file extensions would be the same. | ||
+ | * There is no graphical way to produce the disc. Specifically, | ||
+ | |||
+ | In short, GS3 is still be able to produce content for discs that can run on machines running the same OS as where the content was generated. This needs to be tested to confirm it still works.\\ Assuming the feature is still functioning, | ||
+ | |||
+ | // | ||
+ | - you'd set up the collections you want to transfer to the DVD by creating and building them with any indexer other than solr. Just preview your collections to make sure they look okay and work locally as expected. | ||
+ | - Then write the entire GS3 installation out to your DVD, collections and all. My linux GS3 installation does not fit on a CD-RW, I'm not sure if a GS3 installation has a larger or smaller footprint on a Mac and Windows. | ||
+ | - Now you've burnt your disc, you should be able to run the ./ | ||
+ | The very first time you run gs3-server.sh, | ||
+ | |||
+ | The cumulative changes made to get GS3 working off a disc can be seen at [[http:// | ||
+ | |||
+ | Be aware that the OS on which the GS3 is installed, and which is the GS3 that's transferred to disc, should match the OS on which the GS3 will end up running. So assuming that the windows and mac GS3s can run off CDs as well, you'll perhaps want to install all OS versions for 32/64 bit onto a DVD. The windows binary should work irrespective of the bitness of the binary vs the machine it is run on. | ||
+ | |||
+ | //**Current situation as at Oct 2015**// | ||
+ | Tested writing out to CDRW a linux GS3 binary installation containing the lucene demo collection. Also tested Mac and Windows. The above all worked on these OS when tested around Oct 2015. Specifics: | ||
+ | |||
+ | * The mac Mountain Lion and Yosemite machines here had no optical drive. But we tested it with read-only GS3/web and GS3/ | ||
+ | * Running the GS3.07 off of a disc had also been tested on Windows with the updated build.xml, and that's fine too, including solr. | ||
+ | |||
+ | The one thing remaining to test is to create a universal binary that includes all the 64 bit Win/Lin/Mac bin subfolders and combines their lib folders, and create a universal binary that includes all the 32 bit versions, and test both of those. | ||
+ | |||
=====Output collections===== | =====Output collections===== | ||
Line 89: | Line 92: | ||
- | =====Write | + | =====Write |
Start a CD/DVD recorder software, add the myCollects folder into the CD/DVD, then click the button to burn 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. | ||
Line 119: | Line 122: | ||
- | ===== <!-- id:44 -->Using a Greenstone CD-ROM ===== | + | ===== Using a Greenstone CD-ROM ===== |
- | <!-- id:45 -->The Greenstone digital library software itself comes on a 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 | and you or your system manager have probably installed it on your system, following | ||
the instructions in the // | the instructions in the // | ||
Greenstone is already installed on your computer and you should skip the rest of this section. | Greenstone is already installed on your computer and you should skip the rest of this section. | ||
- | <!-- id:46 -->Some Greenstone collections come on a self-contained Greenstone CD-ROM | + | 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 | 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), | it into the CD-ROM drive on any Windows PC. Most likely (if “autorun” is enabled on your PC), | ||
Line 135: | Line 138: | ||
respond //yes// to all the questions. | respond //yes// to all the questions. | ||
- | <!-- id:47 -->When the installation procedure has finished, you'll find the library in | + | When the installation procedure has finished, you'll find the library in |
the // | the // | ||
(for example, “Development Library” or “United Nations University”). | (for example, “Development Library” or “United Nations University”). | ||
- | <!-- id:48 -->Once the software has been installed, the library will | + | Once the software has been installed, the library will |
be entered automatically every time you re-insert the CD-ROM if autorun is enabled. | be entered automatically every time you re-insert the CD-ROM if autorun is enabled. | ||
- | <!-- /mv:2 --> | + | |
Line 160: | Line 163: | ||
- | <TABAREA tabs="Greenstone3, | + | <tabbox |
- | <TAB> | + | The tutorial on [[http://files.greenstone.org/ |
- | The tutorial on [[http://wiki.greenstone.org/wiki/gsdoc/ | + | <tabbox Greenstone2> |
- | </TAB> | + | |
- | <TAB> | + | |
The following tutorials involve exporting collections: | The following tutorials involve exporting collections: | ||
* [[http:// | * [[http:// | ||
* [[http:// | * [[http:// | ||
- | </TAB> | + | </tabbox> |
- | </ | + | |
en/user/exporting_collections.1444198961.txt.gz · Last modified: 2016/09/27 04:08 (external edit)