• Visit TolvenHealth.com

Tolven Installer

Rev 0.2.0

Note: You will need "root" access to the target operating system. You will be asked to install a database and an LDAP server as part of this installation. Once the dependent products are installed, the Tolven installer will take care of the rest of the installation.

Overview

The Tolven Installer installs the core Tolven application server code and database schemas. The JBoss application server version 4.0.4 and Apache Tomcat 5.5 and a number of other components are embedded in the installation and will be installed automatically.

If you prefer, an alternate, advanced procedure allows you to install Tolven with Eclipse, Ant, and direct access to CVS. For more information, see the Tolven Developer's installation procedure.

Licensing and Redistribution

Tolven is distributed under the L-GPL. The Tolven kit insludes a number of components licensed under various terms including L-GPL, Apache, and other similar open source licenses. If you intend to redistribute Tolven, you should familiarize yourself with ALL embedded licenses which are included in the tolven/lib sub-directories.

Note that the installer itself, IzPack, is licensed under GPL which imposes stronger limitations on commercial use. If you plan to redistribute Tolven under a commercial license, you may want to consider using a different installer if GPL is too restrictive.

Target Platform

Tolven is plaform independent. The dependent components (Java 5 JDK, PostgreSQL, and openLDAP) have platform-dependent installation kits.

Windows note: This process will only work on an NTFS file system, FAT does not have the security features needed by some of the components. Other operating systems should not have a problem.

Configuration

The Tolven Installer can install Tolven in a distributed configuration or you may want to install everything on one box. You can install on Windows XP or Linux or a mixture of operating systems if you opt for a distributed environment.

For your first installation, you should put everything on one system and then "graduate" to a distributed configuration as you get comfortable with the various components. Indeed, we recommend you stick pretty close to all of the default/recommended choices for the first installation, especially passwords which can get complicated in this secure environment.

Footprint and Topology

Prior to installation, all the download files occupy less than 300MB of disk. The installed products require about 620MB. So a safe amount of disk to work with that won't require shuffling is about 1GB.

Tolven can be installed on a modest configuration of 256MB and ~1Ghz CPU, even a laptop. However, performance will suffer. As a database application, Tolven benefits from having a database server with fast disk IO such as 10,000RPM or faster drives, SCSI controllers and of course plenty of memory. Moving the database to a separate box with this configuration will help as the load increases. LDAP can also be on a separate box but that probably won't help much unless you're expecting a very large number of logins.

If distributed, the components (JBoss, postgreSQL, and openLDAP) should have a fast LAN connection between them.

Installing Dependent Components

Before installing Tolven, you must have three components already installed and available. A fourth, highly recommended component should also be installed. The mandatory components include:

• Java 5 Java Development Kit (JDK1.5.0 or later)
• PostgreSQL database (8.1 or later)
• openLDAP ldap server (Version 2.2)
• JXplorer LDAP browser

Complete the Install Dependent Components procedure (if not done already) before proceeding.

Once completed, you don't have to install these dependent components again, even if you install a new version of Tolven.

Download Tolven Installer

If you haven't done so already, download the Tolven installer from SourcForge.

Install Tolven

Double click the file or, if that doesn't work, in a command window type:

java -jar tolven-1.0.0.beta1.jar 

Start Tolven JBoss Server

From the start menu, select Tolven > Start Tolven JBoss

Once JBoss starts, you can access Tolven from a web browser at:

http://localhost:8080/Tolven