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/
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
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
See instructions here.
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:
wget http://eaditor.googlecode.com/files/eaditor-.1108.zip unzip eaditor-.1108.zip sudo mv eaditor /usr/local/projects
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.
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
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>
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.
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.