Chapter 5. Installation

5.1. JDK Installation
5.2. Create your BELTS User
5.3. Unpack BELTS
5.4. Setup your database
5.4.1. Postgres Installation
5.5. Web Server Port Setup
5.6. HTTP Proxy Setup
5.7. Mail Dispatcher Service
5.8. Provider Setup
5.8.1. Learning Exchange Provider
5.8.2. BELTS Provider
5.9. Scheduled Update Setup
5.10. Setup your Curriculum Organiser
5.11. Setup your EdNA Searcher
5.12. Setup your Privacy Statement
5.13. Setup your Terms and Conditions
5.14. Start the BELTS server
5.15. Running as a service
5.15.1. Running as a Windows service
5.15.2. Running as a Linux service
[Note]Note

BELTS comes in two downloadable versions: the “full” version, which provides its own copy of JBoss Version 4.0.1, and a “minimal” version, which is designed to be copied over an existing JBoss Version 4.0.1 installation.

Before installing the minimal version, you need to be aware that there are two JBoss system files that are required to be modified for BELTS. These files are:

  • BELTS_HOME/server/default/conf/jboss-service.xml and

  • BELTS_HOME/server/default/conf/login-config.xml

If you are already running other JBoss applications, you will need to ensure that you merge the changes in these files across, so that you don't overwrite changes that have been made for other applications.

In addition, the dom4j jar file in the JBoss Version 4.0.1 installation, needs to be replaced due to an incompatibility in the way that classes from this package are serialised.

After installation, copy dom4.jar from JBOSS_HOME/server/default/deploy\belts-services.sar to JBOSS_HOME/lib.

5.1. JDK Installation

Installation of this release requires Version 1.4.2 of the Java Development Kit, available from http://java.sun.com/. The JAVA_HOME environment variable should be set to the home directory of your JDK installation in a manner appropriate to your operating system.