Installation

From LoopFuse Wiki

Jump to: navigation, search

This guide walks you through installing LoopFuse One View, whether you are building from source or downloading the binary distribution.

Contents

[edit]

Minimum system requirements

  • MS Windows, Mac OSX, and any Unix-like operating system.
  • 512MB RAM
  • 100 MB free disk space.
  • Java JDK 5 or higher (which can be downloaded from http://java.sun.com/javase/downloads/index_jdk5.jsp).
  • JBoss Application Server. We suggest running with JBossAS 4.0.5, which can be download from http://labs.jboss.com/portal/jbossas/download (and is what is included within the bundled distribution).
  • MySQL 4/5. The bundled distribution uses Hypersonic, which is NOT suggested for a production environment.
    • LooopFuse One View uses Hibernate ORM, allowing the application to be database-agnostic.
[edit]

Installation

LoopFuse OneView is obtainable in 3 different forms; one being a bundled distribution which includes everything needed to run LoopFuse OneView in a single download and the other is just the LoopFuse OneView web archives. Alternatively, you can checkout the entire codebase from our CVS repository.

[edit]

Installing from Bundled Download

The bundled distribution is the easiest way to get LoopFuse OneView up and running quickly and includes JBossAS 4.0.5 and uses the Hypersonic embedded database distributed with JBossAS. Although it is fine for a quick demo, HypersonicDB is NOT suggested for production use.

  1. Download the bundled distribution from our download page.
  2. Unzip the distribution.
  3. Navigate to your unarchived directory. You should see this structure:
  4. To start LoopFuse, execute LoopFuse-OneView\JBoss\bin\run.bat (LoopFuse-OneView\JBoss\bin\run.sh on Linux)
[edit]

Installing from Binary/War Download

If you want to setup and configure an environment to run LoopFuse OneView, without using the bundled version (i.e. just deploying the LoopFuse web archives), the following instructions can be followed which provide the most flexibility in deployment environment.

  1. Download the binary/war distribution from our download page.
  2. Unzip the distribution.
  3. The distribution should contain the following files:
    1. loopfuse-demo.war A demo website where users can click around, download PDFs, and fill out forms.
    2. loopfuse-recorder.war Source code that records user activity.
    3. loopfuse-admin.war Web application that marketing and sales administrators will log in to, to view data, generate lists, and export to CRM.
  4. Now you need to configure your JBoss Application Server for LoopFuse. Follow these instructions to configure JBoss AS
  5. To start LoopFuse, execute \path\to\JBoss\bin\run.bat (\path\to\JBoss\bin\run.sh on Linux)
[edit]

Installing from Source

  • Obtain the sources, following the instructions on this page
  • Set up your environment by defining the JBOSS_HOME environment variable. You will need this system variable set, for the autodeploy in the build to work. 
JBOSS_HOME=/path/to/jboss
  • Build the sources:
    • Using ANT, run the build file oneview_os/build.xml so it deploys all wars to your JBoss deployment directory: 
ant deploy-all
  • Now you need to configure your JBoss Application Server for LoopFuse. Follow these instructions to configure JBoss AS
  • To start LoopFuse, execute \path\to\JBoss\bin\run.bat (\path\to\JBoss\bin\run.sh on Linux)
[edit]

Running LoopFuse OneView

Once you have your runtime environment setup and the LoopFuse OneView applications configured and deployed, you can start JBossAS by running the run.bat or run.sh (for Windows, use run.bat) found in the JBossAS bin directory (i.e. [JBOSS_HOME]/bin). The first time JBossAS is run, it might take a while to fully start as will have to create the database tables and populate with sample data.

Once JBossAS has started and assuming you have deployed the sample web site, you can then browse to http://localhost:8080/loopfuse-demo. This will take you to the home page for the Wonders of the World, Real Estate Sales. From there you can click around the demo site, fill out contact forms, etc. You'll also notice that while you are doing this, the hits and registrations are being recorded as seen in the JBossAS console window.

Next, you can log into LoopFuse OneView administration application, which can be found at http://localhost:8080. You will be presented with a login page. The default login username and password is admin. Once you login, you will be able to navigate the LoopFuse OneView administration application.

Retrieved from "http://www.loopfuse.org/wiki/index.php/Installation"
Personal tools