Chapter 2. Installing [fleXive]

Table of Contents

Quickstart
Prerequisites
Using [fleXive]
The [fleXive] Installer
Maven support
Further steps
[fleXive] installation guide for JBoss 4.2.2 GA
Required libraries
System configuration
Database Setup
Deployment
Starting [fleXive]
Refining your configuration
[fleXive] installation guide for Glassfish 2 and 3
Required libraries
Running the ant task
Database Setup
Setting up and starting Glassfish
Creating the Connection pools
Deployment
Building [fleXive] from source
Troubleshooting
Multiple JBoss installations
JBossCache, Linux and IPv6
Apache ANT

Quickstart

  1. The Sun Java 6 Platform, Standard Edition Development Kit

    1. Set your 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)
  2. 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).

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.