Skip to content
This repository was archived by the owner on Jun 13, 2025. It is now read-only.

Setup

Jump to bottom
anja edited this page Oct 12, 2017 · 6 revisions
ℹ️
 Before starting, please make sure you already set up the general KnowledgeFinder requirements: KnowledgeFinder - Prerequisites
Also this webservice requires an instance of Apache Solr running with KnowledgeFinder - Dataimport.

Install the prerequisites

Liferay v6.2 CE Server (Tomcat 7)

  • Download and unzip Liferay Tomcat Bundle 6.2.5 GA6 to an appropriate folder in your filesystem.

  • Create deploy folder in liferay installation
    {installation_folder}/liferay-portal-6.2-ce-ga6/deploy

Prepare Liferay

Startup Liferay

Commandline

  • Navigate to: {installation_folder}/liferay-portal-6.2-ce-ga6/tomcat-7.0.46/bin

  • Execute startup.bat (on windows) or startup.sh (on Unix/lLinux/Mac OS X).

  • Keep watching it until (30-60 seconds on modern computers) you see something like:
    INFO: Server startup in NNN ms

Under Linux it is also possible to create a service to start and stop liferay. See Administration Documentation for details.

Eclipse with Liferay IDE (for Development)

Install Liferay IDE

  • optional: needed for having the liferay server option in eclipse

  • search in eclipse marketplace for liferay and install the Liferay IDE

Setup Server

  1. Open the Servers view

  2. Create a new server

  3. Select Liferay, Inc. → Liferay v6.2 CE Server (Tomcat 7)

  4. Provide your Liferay Tomcat directory

  5. Start the Server

ℹ️
 If you encounter a java.lang.OutOfMemoryError on start up, add the VM argument "-XX:MaxPermSize=256m" to the servers run configuration.

To verify that liferay is running call http://SERVER_NAME:8080

Install Liferay Plugins

The compiled knowledgefinder .war files need to be copied to the liferays deploy folder. See Webservice - Build Project and Portlet- Build Project for the build documentations.

ℹ️
 On a server for the autodeploy to work, the owner and the group of the .war files need to be the same as ones running liferay
ℹ️
 The naming of the .war files is quite important. Check that they are named KnowledgeFinderWebservice.war and KnowledgeFinderPortlet.war otherwise the Application might not load properly

Add Portlet to Website

ℹ️
 If the portlet is not loaded properly, try to disable the authentication token:
1. Go to {LiferayDirectory}
2. create file portal-ext.properties
3. add "auth.token.check.enabled=false" to file and save
Security in Liferay Services https://www.liferay.com/de/documentation/liferay-portal/6.2/development/-/ai/service-security-layers-liferay-portal-6-2-dev-guide-05-en

Liferay Configuration

Roles

Configure Liferay to use the same roles as the plugins:#

  • login

  • go to Admin -→ Control Panel -→ Roles

  • add Regular Role

Access static data

If static data (like the data source) needs to be accessed by the webpage, the service.xml of the tomcat needs to be modified:
Under Host add a Context element with the attributes docBase and path. "docBase" is the absolute path to the folder with the static data and "path" the path that is displayed in the url.

<Host ...>
    ...
    <Context docBase="/srv/PROJECT_NAME/data" path="/data" />
</Host>

Clone this wiki locally