Some confusion on Lemon8 installation

[rmurphy00]

I have been trying to install Lemon8 XML - but am confused. I am running Ubuntu Server 8.04.

Firstly, I am not very clear on exactly what needs to be installed. Docvert, I believe, is required. Apache FOP also needs to be installed, correct?

About the <a href="http://www.lemon8.org/pages/docs#technology">Technology Used</a>:
1) CakePHP is just the framework that it runs on. There is not need to configure or install it otherwise. Correct?
2) PHP 5, Apache, MySQL -self-explanatory...part of LAMP. No out-of-ordinary configuration.
3) Docvert. This is where I got confused. I installed Docvert as per their <a href="http://holloway.co.nz/docvert/documentation/installing-from-debian-repo">Debuntu repo instructions</a>. It installed successfully. The Lemon8 README says to place the docvert_url (eg. http://myserver/docvert/web-service.php) in /app/config/bootstrap.php.
4) OpenOffice. Is this supposed to be installed? Or does it just resolve to OpenOffice.org (i.e. automatically does necessary work through OpenOffice.org)?
5) ParaCite. Same issue as OpenOffice, do I need to install it, or does it automatically access the appropriate data through its website?
6) Apache FOP. First I installed sun-java6-jre. Then I downloaded an Apache FOP binary and extracted it into a folder. As far as I can tell, it works. What do I need to do now? Do I need to specify the directory anywhere in any of the Lemon8 configuration files?
7) ISBNdB. Again, does this need to be installed? Or does Lemon8 automatically access the necessary tools online. Where do I get the isbndb_key?
NCBI: PubMed. Any installation or configuration needed for this, or will Lemon8 automatically utilize it?

Thanks a lot,
-Ray Murphy

[mj]

Hi Ray,

Thanks for taking the time to post; answers to each question:

1) Correct.
2) Correct.
3) Docvert only has to be installed and configured if you are using it for document conversion, eg. to allow uploading documents in MS-Word, RTF, etc. Uploading OpenDocument ODT files doesn't require Docvert to be installed. Once Docvert is installed and running correctly, then yes, entering the docvert_url as you describe is all that's required to configure L8X. I should also add that there is a Google Docs conversion alternative in the current CVS tree, but at the moment it requires a small change to the code to switch/enable it; the next CVS commit will include a UI for managing this, along with various other settings, so you don't have to modify bootstrap.php manually.
4) OpenOffice is required as part of the Docvert installation -- ie. it's not enough for Docvert to work to simply install the PHP files. There's more information on this at the Docvert installation docs.
5) The ParaCite perl files are included in L8X, so in order for it to work, you need to have perl installed on your system; it should be included in Ubuntu 8.04 by default, so you don't need to do anything.
6) FOP is also "optional", ie. it is only used for generating preview PDFs. Once you have a JRE, all that's required is to move the extracted FOP folder into /app/vendors/ and L8X should automatically see it from there.
7) You'll have to create a free account at ISBNDB to get an API key from them: https://isbndb.com/account/create.html. Once you have that, placing it into bootstrap.php will enable ISBNdb lookups.
8 ) No configuration is required for PubMed.

I also assume you're using the L8X beta release from back in June; the latest CVS has countless modifications and improvements (including lookups in CrossRef and WorldCat, and parsing with FreeCite and ParsCit), as we work toward a 1.0 release early in the new year. Please don't hesitate to ask if I can clarify anything here further or if you have any other questions! Oh, and I should add that one of the things the 1.0 release will have is a simplified installer interface to make getting L8X set up and running much easier.

MJ

[rmurphy00]

MJ,

Thanks a lot for your reply! It did help a lot!

I am still a little unsure about that docvert_url. Where do I get it from? (How come my docs link didn't work?)
I installed it the way the Docvert Ubuntu install docs told me to: apt-get(ting) two package from the repositories. I believe the instructions I followed told me to apt-get "dovert" and "docvert-openoffice". Does that satisfy the "OpenOffice" requirement you mentioned, or do I have to install some of the additional libraries mentioned in the Docvert docs (i.e. PyOdConverter via OOo Server:openoffice.org-headless, and/or php5-tidy)? Once all the necessary files are installed, where do I find the docvert_url?

That's cool the new version is out. I just realized that I was following the instructions from memory, on the newest version.
Running to take a look!

Thanks a lot,
-Ray Murphy

[mj]

Hi Ray,

Glad to help...

I haven't installed Docvert using the Ubuntu install, so you might have to check with Matthew on the docvert mailing list. Presumably if "apt-get install docvert docvert-openoffice" worked, then you should have all the requirements installed. I believe the web root in Ubuntu is /var/www, so you might want to have a look there for a docvert directory of some sort. A complete stab-in-the-dark guess would be to simply try pointing your browser at http://localhost/docvert/ and see what comes up. Once you find where docvert is running on your machine, appending web-service.php to the URL will give you the docvert_url that's required for L8X.

I'll set up an Ubuntu 8.04 VM in the next couple of days and see if I can replicate your environment. In the meantime, please share anything you may discover.

Cheers,
MJ

[rmurphy00]

Hi MJ,

I should have done this from this start, but I just ran "locate web-service.php" from a terminal shell and found it.
/var/www/ is indeed the Debuntu webroot, however that's usually for dynamic website files. /usr is where programs typically go.
So...I found web-service.php. It was in /usr/share/docvert/web-service.php.

And that means the docvert_url is: /usr/share/docvert/web-service.php .Correct?

This confused me a little because URL usually refers to a web address, and the example had an http://... rather than an internal path.

Thanks a lot,
-Ray Murphy

[mj]

Hi Ray,

Well, I'm glad you found docvert on your system, but even though it's located in /usr/share/docvert, it needs to be run through Apache since Docvert is a PHP Application. So, you'll have to have a look in your Apache config files (/etc/httpd/ or /etc/apache2 depending on your version) and see if there's a configuration for the URL for Docvert on your server. Did you try http://localhost/docvert/ ?

Your initial assumption is right, docvert_url is a URL, therefore a web address, so it has to point to an http:// location, and not an internal path. I would think that the Docvert installation should point to the Docvert URL, but obviously it's something that needs to be added.

MJ