wiki:AdministratorTutorial/Installation

Installation

How to setup organik.

In this tutorial, we assume you install OrganiK on the server www.example.com in the directory "organik". The address http://www.example.com/organik/ represents the example server. Replace it with your configuration.

Requirements:

  • Apache
  • MySQL 5.0.45
  • PHP 5.0.4 with curl apt-get install php5-curl. This is needed for testing support. 'php5-imap' is required for email notifications. Note that with PHP 5.3 you will get tons of warnings (and maybe errors). PHP 5.2 seems to be ok.
  • Java 6 runtime
  • A Mail Transfer Agent. Postfix has been configured and used in with OrganiK in order to send the notifications required by email.

Required Steps:

  • Create a folder "organik" on your apache webserver's directory
  • Install the modified OrganiK Drupal 6 version 6.13 (including custom modules) into a LAMP
    • svn checkout https://organik.opendfki.de/repos/trunk/drupal/organikdrupal organik
  • make a settings.php file according to drupal standards in sites/default/settings.php
  • go to the website and follow the drupal instructions.
  • remember your administrator account and password
  • Result: you can reach http://www.example.com/organik/

Activating the modules:

Making the content private

  • By default the content inserted in OrganiK is public -allowing everyone to access the content created
  • To make content accessible only to authenticated users go to 
    • Administer 
      • User Management
        • Roles
  • Click on "edit permissions" for the anonymous user
  • Uncheck the access content checkbox

Changing the theme:

Install the java ContentAnalyserImplementation?:

  • If you do not have Java 6 installed, Install it. We strongly recommend SUN java.
    • Ensure that your JAVA_HOME is configured (i.e. by setting JAVA_HOME=<yourpathtojava> in /etc/bash.bashrc)
  • If you do not have tomcat running already, go to the console and, as root, install tomcat.
    • sudo apt-get install tomcat5.5
  • find your tomcat webapps folder. On ubuntu, it is /usr/share/tomcat5.5/server/webapps
  • deploy and start the servlet contained in this war file LdaTextAnalyser.war
  • deploy the war file OrganikTextAnalyzerServlet.war
    • the war file must be deployed by unzipping it, you will not be able to use the application as zipped war-file.
    • verify that the upload worked by opening the webpage. In a testcase, that would be http://www.example.com:8180/OrganikTextAnalyzerServlet/
    • this should show something (also, this page should show something, an empty white page is ok)
    • the webapplication needs access to the drupal database, it uses mysql for this. The application needs the permission to use sockets, you may have to adapt your catalina.policies accordingly.
    • in WEB-INF/web.xml, configure the drupal database server user name and password. See ContentAnalyserImplementation#Configuration? for more.
  • Result: open http://www.example.com:8180/OrganikTextAnalyzerServlet/, enter a meaningful english text, press the button, some keywords and numbers are returned.

Configure organik-drupal to connect to the java parts

  • in organik, go to site configuration organik_nlp: http://www.example.com/organik/?q=admin/settings/organik_nlp
    • set organik nlp server to http://www.example.com:8180/OrganikTextAnalyzerServlet/TextAnalyzerServlet and press "save". This assumes that the Java part is installed at http://www.example.com:8180/OrganikTextAnalyzerServlet/TextAnalyzerServlet
    • verify that the NLP server works: a message "The current configuration ... works" should appear on this page.
    • another way to verify it is: go to organik nlp node settings and for page and story set Apply all suggested terms on every update. press "save configuration"
  • 'Result: create a new story and save it. This should create annotations after you saved the page.

Install ApertureDataAdapter if you want to add external files to OrganiK.

Troubleshooting

  • when the java-parts (nlp) are not working

Next

Last modified 7 years ago Last modified on 07/12/10 14:00:14