Table of Contents
The Sun Java 6 Platform, Standard Edition Development Kit
JAVA_HOME and JDK_HOME
environment variable to your JDK root directory (e.g.
JAVA_HOME=/usr/lib/jvm/java-6-sun
on Linux,
C:\Java\jdk1.6.0_15
on Windows)
If you want to create your own projects: a build tool, either Apache Ant or Apache Maven.
The easiest way to get started is to download the Java-based installer. It provides a preconfigured [fleXive] instance that can be accessed with the administration GUI. WebDAV and CMIS connectors are also included.
The common options for custom development and deployment are:
Create a new EAR or WAR project with a Maven archetype. EAR projects default to JavaEE 5, while standalone WAR deployments (not part of an EAR) require a JavaEE 6 container.
To use [fleXive] in an existing project, include the flexive-ejb artifact.
To use the administration GUI in a JavaEE 6 application server (web or full profile), download
and deploy
flexive-admin.war
from the download page.
Run the Java-based installer from our download page. If your browser does not give you the
option
to run it directly, double-click on the downloaded
flexive-installer.jar
file or launch it from the command line with
java -jar flexive-installer.jar.
In a headless environment (a server without a graphics environment), you cannot use the GUI installer. Launch the console version with java -jar flexive-installer.jar -console instead.
Start the [fleXive] server using the created shortcut, or manually using the
start.sh
(for Unix, Mac) or
start.bat
(Windows) scripts in the installation directory.
Open the [fleXive] administration GUI using the shortcut from the desktop or the program group or
point your browser to
http://localhost:8080/flexive/adm/ and login with the default credentials
(supervisor/supervisor).
Create a new [fleXive] project and install it:
mvn -B archetype:generate -DarchetypeGroupId=com.flexive -DarchetypeArtifactId=flexive-archetype-ear -DarchetypeVersion=0.8 -DarchetypeRepository=http://repo.flexive.org/maven2/ -DartifactId=hello-flexive -DgroupId=test -Dversion=1.0-SNAPSHOT
cd hello-flexive
mvn install
Invoke the Jetty container for the WAR artifact:
cd war
mvn jetty:run
Point your browser to
http://localhost:8080/flexive/
and login with the default credentials
(supervisor/supervisor).
To deploy the EAR to your application server, you need to configure a datasource and possibly install a few libraries. Please follow the guide for your vendor:
JBoss 4.2 (also applies to 5.0+)
Glassfish 2.1 (also applies to 3.0+)
Geronimo 2.1 (Wiki)
WebLogic 10.3 (Wiki)
Create a new [fleXive]-based WAR and install it:
mvn -B archetype:generate -DarchetypeGroupId=com.flexive -DarchetypeArtifactId=flexive-archetype-war -DarchetypeVersion=0.8 -DarchetypeRepository=http://repo.flexive.org/maven2/ -DartifactId=hello-flexive -DgroupId=test -Dversion=1.0-SNAPSHOT
cd hello-flexive
mvn package
Deploy the WAR artifact from the
target
directory to your application server. If you want to use the administration GUI
for managing the repository, download and deploy
flexive-admin.war
from the download page.
For further information on [fleXive] Maven support please continue with the section called “ Building applications with Apache Maven ”.
Now that you got [fleXive] up and running, you might...
watch the screencasts on our homepage giving you an introduction to the administration GUI and to the process of writing applications with [fleXive],
walk through the tutorials if you want to create applications using [fleXive],
or read more about writing applications with [fleXive]
If you had troubles installing [fleXive], please go to the troubleshooting section or ask in the forums.