User Tools

Site Tools


eaditor:ubuntu_installation

EADitor Installation

Summary

These instructions are specific to Ubuntu, but can be followed generally for other Unix-based operating systems. In short, download the EADitor solr-home zip file and unzip to /usr/local/projects and set write appropriate write permissions on the Solr data folders (or, in Ubuntu, set the owner to tomcat6). Next, install Apache Tomcat and download and place both war files (solr-eaditor and orbeon) into webapps. Start Tomcat and navigate to http://localhost:8080/orbeon/eaditor/

Detailed Instructions

Java JDK

Tomcat requires the Sun Java JDK. Skip these steps if Sun Java is already installed and set to the default JDK.

sudo apt-get install sun-java6-jdk

Note

If running Ubuntu 10.04 or later, Sun Java has a new PPA

sudo add-apt-repository ppa:sun-java-community-team/sun-java6
sudo apt-get update
sudo apt-get install sun-java6-jdk

Set Sun Java as Default

See instructions here.

Installation of EADitor Solr Home and Data

The following instructions assume sudo privileges on an Ubuntu machine. The instructions are largely transferable to other Unix-based operating systems, like RedHat Fedora Linux and MacOSX, though the Tomcat installation folders may differ from Ubuntu.

From home directory:

  • Make projects folder: `sudo mkdir /usr/local/projects`
  • Download and unzip eaditor-.1108.zip to /usr/local/projects:
wget http://eaditor.googlecode.com/files/eaditor-.1108.zip
unzip eaditor-.1108.zip
sudo mv eaditor /usr/local/projects
  • Set write permissions to the Solr data folders for both cores
sudo chown -R tomcat6:tomcat6 /usr/local/projects/eaditor/solr-home/indexes/published/data
sudo chown -R tomcat6:tomcat6 /usr/local/projects/eaditor/solr-home/indexes/unpublished/data
sudo chown -R tomcat6:tomcat6 /usr/local/projects/eaditor/solr-home/indexes/vocabularies/data

Note if using a different operation system and you are unsure of the tomcat username, use `chmod -R 777` to set full-access write permissions to all users.

Installation of Apache Tomcat and Associated Webapps

Apache Tomcat is the required container for various servlets Numishare is dependent upon.

sudo apt-get install tomcat6

The configuration file is located at /etc/default/tomcat6

Additional JAVA_OPTS can be set to increase the maximum and minimum memory usage and other such options. EADitor runs optimally at 1024MB of memory or greater devoted to Java. See Orbeon documentation for more information.

Edit the configuration file to specify JAVA_HOME

sudo vi /etc/default/tomcat6

Uncomment the JAVA_HOME line and set to /usr/lib/jvm/java-6-sun

Solr

Download solr-eaditor.war from the Downloads section and copy it into Tomcat's webapps folder.

wget http://eaditor.googlecode.com/files/solr.war
sudo cp solr.war /var/lib/tomcat6/webapps

The solr home is hardcoded into web.xml within the war file. Lines 37-41 can be modified or commented out (which requires a solr.xml configuration file within Tomcat's conf/Catalina/localhost) to reflect a different installation folder.

    <env-entry>
       <env-entry-name>solr/home</env-entry-name>
       <env-entry-value>/usr/local/projects/eaditor/solr-home</env-entry-value>
       <env-entry-type>java.lang.String</env-entry-type>
    </env-entry>

Orbeon

Download orbeon.war from the Downloads section and copy it into Tomcat's webapps folder.

wget http://eaditor.googlecode.com/files/orbeon.war
sudo cp orbeon.war /var/lib/tomcat6/webapps

This includes the EADitor XForms application pre-installed and Orbeon's internal eXist XML database preconfigured with the appropriate collection folders and files. The user “guest” with group “guest” owns the content within eXist. By default the guest password is “guest” and the admin password is blank. This must be changed before putting the application into production on the web.

Running the Application

Refer to Tomcat documenation for starting and stopping the server.

After the war files have been successfully deployed, navigate to http://localhost:8080/orbeon/eaditor/admin/ to configure EADitor.

eaditor/ubuntu_installation.txt · Last modified: 2012/03/12 13:37 by egruber