Quick-start installation

Owned by Pascal AUBRY
Last updated: May 02, 2008Version comment

esup-helpdesk can be deployed as a servlet or a portlet, but newbie users should try the quick-start first to get familiar with the product.

Requirements

esup-helpdesk is 100% java, it runs on Windows and Unix platforms. 

Requirements for linux

Requirements for Windows 

Download

Get the latest version (esup-helpdesk-quick-start-x.y.z-t.zip) from sourceforge and unzip in /usr/local/helpdesk/src (c:/helpdesk). 

Install

Rename build-quick-start-example.properties to build.properties and edit the file to fit to your local configuration. For a basic installation, only property cas.url needs to be changed. The file build.properties tells ant how the application will be installed.

Rename properties/config-example.properties to properties/config.properties and edit the file to fit to your local configuration. For a basic installation, only the properties marked REQUIRED need to be changed (read carefully the comments to understand the leaning of each property). The file properties/config.properties specifies the application behavior (at run-time).

Rename webapp/WEB-INF/web-servlet.xml to webapp/WEB-INF/web.xml, nothing should be changed in this file. This file is used by the servlet container (Tomcat) to configure the context of the application.

Create the directories used to store the uploaded files (see property uploadedFiles.path, e.g. /usr/local/helpdesk/files or c:/helpdesk/files) and the index (see property index.path, e.g. /usr/local/helpdesk/index or c:/helpdesk/index). 

Start

Simply executing ant start should start the application.

Test

Browse http://localhost:8080http://localhost:8080 and start using the application.

Each time you change a property of the configuration files, you have to restart the application (ant restart).