Installation Guide

From DOC

Jump to: navigation, search

Contents

Overview

The Tolven installation is not intended for end-users. The process described here may involve installing and configuring a Java JDK, database server, LDAP server, application/web server, and various security components.

Installation is done in three parts:

  1. Download software
  2. Install Software
  3. Configure Software

A key decision to make at this point is which Database and LDAP server products to use. See prerequisites below.

Each prerequisite component will be installed separately, typically into separate locations: Java JDK, Database server, and LDAP server. Then, Tolven is installed into three more folders:

  • Tolven-config - This folder contains configuration elements that will not change from version to version.
  • Tolven install-dir - This folder holds Tolven software that will change from version to version.
  • The Tolven Application server folder contains the application and web container.

In general, you will only be changing contents in the tolven-config directory. Tolven will then deploy information from this directory to the application server. You should avoid making changes directly to the application server. This will allow you to upgrade this software more easily.

Download

Tolven provides two styles of installation: on-line and off-line.

Note: Off-line is not yet available

  • on-line installation only downloads the components needed for any particular configuration.
  • on-line installation requires an active Internet connection for the repositoryInit phase of the installation.
  • on-line installation is convenient when multiple sources of plugins are used.
  • on-line installation allows incremental updates of the Tolven software with minimal download time and configuration disruption.
  • off-line installation provides a snapshot of Tolven software in a single zip file (excluding prerequisite software).
  • off-line installation requires no Internet access other than the downloads.
  • You can switch between on-line and off-line installation at a later time.

The installation process begins by downloading software components.

Installing Prerequisite Software

A Tolven installation requires that a number of prerequisite software products be installed. Later, during configuration, you will be directed how to configure these prerequisite components to work with Tolven.

Installing these prerequisites and Tolven itself should take less than two hours. However, if these components are new to you, then it may take longer. If, on the other hand, you have a platform with most of these components already installed, then the installation time could be much shorter.

Once installed, these prerequisites need not be changed when a new version of Tolven is installed unless specifically directed to do so in the release notes.

Java (Prerequisite)

Install Java

Install Database (Prerequisite)

Install one of the following database products if not already installed:

Install PostgreSQL
Install Oracle

The database server does not need to be on the same machine as the Tolven Application Server.

LDAP (Prerequisite)

Install OpenLDAP

The LDAP server does not need to be on the same machine as the Tolven Application Server.

Install Application Server

Install one of the following application server containers.

Install Tolven JBoss (Note that this kit is customized for Tolven)

Install Tolven

Install Tolven

Next Steps

Configuration Guide

Personal tools