[greenstone-users] Design and Build of pdf in linux - Challenge

From Sandton Consulting Ltd
DateWed Apr 6 13:09:54 2011
Subject [greenstone-users] Design and Build of pdf in linux - Challenge
In-Reply-To (4D995749-4070205-cs-waikato-ac-nz)
Thanks a lot Anupama,
□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ We will go thru these options and let you know the results.
We sincerely appreciate your assistance.


Ogo Adesanya

--- On Sun, 4/3/11, Greenstone Team <greenstone_team@cs.waikato.ac.nz> wrote:

From: Greenstone Team <greenstone_team@cs.waikato.ac.nz>
Subject: Re: [greenstone-users] Design and Build of pdf in linux - Challenge
To: "Sandton Consulting Ltd" <mgmt@sandtonconsulting.com>, "Anupama of Greenstone Team" <greenstone_team@cs.waikato.ac.nz>, greenstone-users@list.scms.waikato.ac.nz
Date: Sunday, April 3, 2011, 10:29 PM

Hello Boye,

There's not enough information provided as to the manner in which things are going wrong, but there's 2 things I can think of that you could try (please also answer my questions below).
So we know that your Greenstone can work with same PDF files work on Windows, and that they are unable to process these files on Linux. Perhaps your environment is not set up right.

- You appear to be using GLI (the Greenstone Librarian Interface application). Are there any errors shown in the output? More detailed error messages would appear if you went to the File menu > Preferences > Mode. Then tick "Expert" and click OK. Rebuild your collection and this time there may be more specific error messages in the build log area of the Create Panel. Can you copy the relevant section of the output (the error messages) and send this to us.
- If your Linux system is an Ubuntu and the Greenstone version you happen to be using is 2.83 or earlier, then it may be a problem with Perl. In that case, see suggestion 2 below.

1. Otherwise, try the following first. We're going to try building from the command-line, instead of from GLI (the Greenstone Librarian application), just to check whether it has something to do with the environment.

a) Open a linux terminal (x-term) and go into your Greenstone installation folder:
$ cd /type/the/full/path/to/your/greenstone/installation/

b) Next, set up the Greenstone environment by typing the following in your x-term:
$ source setup.bash

c) Run the import script -- which is the first step of the build process - and provide the name of collection you wish to build as argument to it:
$ import.pl -removeold <type your collection's name>

Are there any errors at this stage (check for errors in the text that moves past in the terminal during the execution of the import.pl command)?

d) Next run the 2nd step of the build process, once again providing the collection name as argument:
$ buildcol.pl -removeold <type your collection's name>

Once again, does the output show any errors?

e) If all went well, rename the folder "building" inside your collection folder to "index":
$ cd collect/<type your collection's name>
$ mv building index

! If the above worked for some reason, then the environment GLI runs in when it is launched is different from the environment that the command-line scripts manage to work in.

f) If steps d and e above showed up no errors to do with your PDF files, then go back to your Greenstone installation folder and run the Greenstone server from there to visit your collection page:
> cd /type/the/full/path/to/your/greenstone/installation/
> ./gs2-server.sh
This should launch a dialog. Press its central button to go to your Greenstone digital library's home page and from there manoeuvre to your collection.

2. If suggestion 1 above did not work, and your work is urgent, then I think it a good idea for you to try out the latest version of Greenstone (released last Friday): Greenstone 2.84. This latest Greenstone version can work with a plugin extension which makes it cope with later versions of PDF. It may be that doing so will bypass your linux-specific problems of handling the PDFs you have:

a) Download the Greenstone 2.84 installer for *Linux* by clicking the link at the top of http://www.greenstone.org/download
(or visit http://sourceforge.net/projects/greenstone/ and press the green Download button)

b) Then run the installer to install Greenstone2.84. Make sure to install it somewhere else than your previous Greenstone installation.

c) Next, point your browser to http://trac.greenstone.org/browser/gs2-extensions/pdf-box/trunk/pdf-box-java.tar.gz
Click on the small red "download" link on that page and make sure to save this file (the PDF-Box Greenstone extension) into your Greenstone 2.84 installations "ext" folder.

d) Use a terminal (x-term) to cd into your Greenstone installation folder and then go into its ext folder where you have saved the tar.gz file downloaded above. Then extract this archive file in this location:
$ cd /type/the/full/path/to/your/Greenstone 2.84/installation/
$ cd ext
$ tar -xvzf pdf-box-java.tar.gz

e) Copy your collection folder across from the old Greenstone installation into the new one:
$ cp□□□-r□□□/<full/path/to/your/OLD-Greenstone-installation>/collect/<type name of PDF collection>□□□/<full/path/to/your/Greenstone 2.84/installation>/collect/.

(Note that the folder "collect" is the name of the directory containing your collection which is to be copied. The "collect" folder exists in all normal Greenstone installations, so you need to type it as shown. Just replace the strings inside the <> marks.)

f) In a *fresh* terminal (this is important, so make sure to open a brand new x-term), go back to your Greenstone installation folder and run GLI from here:
$ cd /full/path/to/your/Greenstone 2.84/installation/
$ ./gli/gli.sh

The reason you need a fresh x-term is because when GLI is run this time, it will know to set up the Greenstone environment all over again. And this time, it will detect the new PDF Box extension that you downloaded and unpacked in steps c and d.

g) Go to File > Open. Click the "Change Dir..." button at the bottom and, in the dialog that appears, make sure it is pointing to the collect folder inside your new Greenstone 2.84 installation. (Else use the Change Dir dialog to go to the Greenstone 2.84 installation's collect directory.) Now open your collection. This should open the collection you copied into your Greenstone 2.84.

h) Go into the Design panel. Make sure that on the left hand side, "Document Plugins" is selected. Then, to the right, double click on the PDFPlugin in the list of Document plugins. In the Plugin Configuration dialog that appears, scroll down to the section titled "Autoload Converters" and tick the checkbox next to "pdfbox_conversion".
This tells GLI to use the PDFBox extension to process PDF files. This extension to the PDFplugin allows newer PDF versions to be processed as well.

i) Now go to GLI's Create Panel and click the Build button. Hopefully there will be no errors this time and your PDFs will get processed. Then click the Preview button to preview your collection.

If you still have problems after trying the above, then, in your next e-mail will you send us the error messages from the build output? And also tell us what version of Greenstone you are using and what particular Linux (Ubuntu for example).

Best of luck,

> Sandton Consulting Ltd wrote:

> Hello ,
>□ □ □ □ □ □□□We are a company interested in Greenstone Digital library software.
> We have this challenge pdf files in Greenstone linux environment . When we attach pdf files , we go on to Design and build our pdf files, the pdf files are rejected . The same pdf files are accepted
> and we build with them in Greenstone for Windows.
> Please assist us to solve this problem of Design and Build of pdf files in Greenstone for linux environment.
> Please it is urgent.
> Thanking you
> Boye Adesanya

-------------- next part --------------
An HTML attachment was scrubbed...
URL: https://list.scms.waikato.ac.nz/mailman/private/greenstone-users/attachments/20110404/6ccf452d/attachment-0001.html