Getting Started with
Light Portal Framework
Requirements
- Java 1.5 or higher
- Servlet 2.4 Engine:
- Tomcat 5.5.26
- Jetty
- Websphere 6.0
- Geronimo
- JBoss
- Weblogic
1. Get Java 1.5 or higher Ready
If you have not already done so, download and install Java.
2. What Database do you want
Light Portal requires a database to persistent user information. The
following databases are tested:
- HSQLDB - Hypersonic SQL
- MySQL
- Oracle
- Postgres
- DB2
- Sybase
- SQL Server
Light Portal is distributed with the HSQLDB database configured as the
default, the database configuration can be configured at
/WEB-INF/classes/hibernate.cfg.xml.
3. Servlet Engines
In theory, Light Portal can be run under any servlet
container supporting the 2.4 specification or greater. Successful Light
Portal applications have been deployed using:
- Tomcat 5.5.26 or higher
- Jetty
- Websphere
- Geronimo
- JBoss
4. Installing Light Portal from Source or Binary Distributions
Depending on what you want to do, you have the choice of installing
Light Portal from a binary release or from the sources. If you want to
modify the core functionality of Light Portal or contribute to the
development of Light Portal, you need to work with the sources. If you
are
only interested in building your own custom enterprise portal, you can
start with a binary release of Light Portal. Most people should start
with
the binary distribution.
You can deploy Light Portal binary to Tomcat according to the
following steps:
- download lightPortal.war
- put lightPortal.war to tomcat/webapps/
- start tomcat
- access Light Portal at http://localhost:8080/lightPortal{version}/ (admin
user name and password: [email protected]/admin)
Light Portal is distributed with the HSQLDB database configured as the
default, the database configuration can be configured at
/WEB-INF/classes/hibernate.cfg.xml. You can configure to connect to
Mysql database according to the following steps:
- create a database at Mysql : create database light;
- configurer database connection at
tomcat/webapps/lightPortal/classes/hibernate.cfg.xml
<property
name="dialect">org.hibernate.dialect.MySQLDialect</property>
<property
name="connection.driver_class">com.mysql.jdbc.Driver</property>
<property
name="connection.url">jdbc:mysql://localhost:3306/light</property>
<property
name="connection.username">[user name]</property>
<property
name="connection.password">[password]</property>
- restart tomcat
- by default, Light Portal will recreate tables after every time
start tomcat, if you want to disable this feature, configure it at
/webapps/lightPortal/WEB-INF/portal-security.xml, set reCreateTable
property to false.
- import reference data to mysql: mysql -p -h [DBSERVER] [database name] < lightData.sql, the file is located at /WEB-INF/dbscripts/lightData.sql.
- restart tomcat