De installatie van JFire voor development doeleinden staat uitgebreid beschreven in de wiki van JFire onder de link Getting started with JFire development. Op deze webpagina klikt u op de link Development Environment Setup om naar de instructies voor het automatisch inrichten van JFire te gaan.

Ik heb deze instructies recent doorlopen en op basis van de opgedane ervaring de stappen beschreven die gevolgd moeten worden om de JFire development operationeel te maken. Ik ga in mijn aanpak iets verder dan de JFire instructie door het opstarten van de JFire development server eveneens uit te voeren vanuit Eclipse.

Stap 1: Downloaden en installeren van Java SDK
Als u Java SDK versie 5.0 en Eclipse SDK versie 3.3 reeds hebt geïnstalleerd op uw computer dan kunt u stap 1 en 2 overslaan.

Stap 2: Downloaden, installeren en inrichten van de Eclipse SDK
Het advies is om een nieuwe workspace te gebruiken voor de JFire omgeving om problemen met een bestaande workspace te voorkomen.

- Start Eclipse en ga naar het menu File.

- Selecteer de menuoptie Switch Workspace, Other voor het openen van de Workspace Launcher.

In het dialoogscherm klik op de knop Browse voor het openen van de verkenner. Nu kunt u een nieuwe directory aanmaken voor uw workspace. Als u in het dialoogscherm op de knop OK klikt zal Eclipse opnieuw opgestart worden met de nieuwe workspace.

Stap 3: Installatie van de NightlyBuild plug-in
In stap 3 gaat u de plug-in installeren die zorg draagt voor het downloaden van de JFire sources en noodzakelijke libraries. Verder zorgt deze plug-in voor het registreren van de Eclipse library variabelen en het genereren (build) van de JFire plugin.

Voor installatie van deze plugin ga naar het menu Help en selecteer de menuoptie Software Updates > Find and Install.

- Selecteer in het dialoogscherm Install/Update de optie Search for new features to install en klik op de knop Next om verder te gaan. Nu krijgt u het overzicht van alle geregistreerde updates sites.

- Klik op de knop New Remote Site om de NightlyBuild update site toe te voegen.

- Vul de naam en URL van de site in, klik op de knop OK en daarna op de knop Finish

Naam: Nightlabs NightlyBuild
URL: http://www.nightlabs.de/updatesites/development

In het dialoogscherm Updates vink het vierkant Nightlabs NightlyBuild aan en klik op de knop Next. Als u de node Nightlabs NightlyBuild opent ziet u onderaan in de node Development Tools de laatste versies van volgende features verschijnen:
- NightLabs NightlyBuild Plugin 1.0.57
- Sourceforge XDoclet 1.3.20071206
- NightLabs Base 1.0.4
- NightLabs Base 1.0.5

[U kunt de NightLabs Base 1.0.4 versie deactiveren en alleen de laatste versie van de feature NightLabs Base aanvinken.]

Zoals ik al eerder aangaf is de JFire plug-in onder de LGPL licentie beschikbaar. Geef in het dialoogscherm Install aan dat u de licentievoorwaarden accepteert en klik op de knop Finish.

Om vervuiling van de Eclipse-omgeving te voorkomen installeer ik de plug-in’s als een extensie in een afzonderlijke map.

- Selecteer de NightLabs Base en de NightLabs NightlyBuild Plugin in de kolom Feature Name en klik op de knop Change Location.

- Klik op de knop Add Location voor het toevoegen van een nieuwe locatie. Ik heb onder C:\ProgramFiles\ een map eclipse-extensions aangemaakt voor het opslaan van plug-in’s.

Maak nu de map JFire aan. Automatisch wordt onder deze map eveneens de map eclipse met daarin het bestand .eclipseextension aangemaakt.

Selecteer de XDoclet in de Feature Name kolom en klik op de knop Change Location en maak nu de map XDoclet.

- Klik op de knop Finish voor het starten van de update manager.

- Klik later in het verificatiescherm op de knop Install All. Hierna worden de plug-in’s geïnstalleerd.

Stap 4: Initialisatie van de workspace
In stap 4 wordt u gevraagd de workspace te initialiseren.

Nadat Eclipse is opgestart open het menu Nightly en selecteer de optie Initialize Workspace.

- Klik op de knop Load.

Daarna ziet u alle verschillende modules van JFire.

- Selecteer de JFire-Max-HEAD dan worden alle modules geïnitialiseerd en klik op de knop Next.

Let op: de functie Initialize Workspace heeft de Java JDK nodig in plaats van de JRE. In het dialoogscherm Basic Settings klik op de drop-down box van het veld Java Home en geef de locatie op waar uw JDK staat.

- Klik op de knop Next. In het volgende scherm accepteer de standaard instellingen en klik op de knop Finisch.

Eclipse start nu met het ophalen van de JFire software sources en initialiseren van de JFire workspace. U kunt nu gerust een uurtje gaan wandelen want hier gaat enige tijd overheen. Het is zelfs mogelijk dat uw omgeving volledig vastloopt. Probeer dan met de functie Update Workspace het initialiseren van de JFire workspace terug op te starten. Als u een errorboordschap krijgt start dan opnieuw de functie Initialize Workspace.

Wanneer het initialiseren is afgerond kunt u al de modules waaruit JFire bestaat terugvinden in de Package Explorer.

Stap 5: Inrichten MySQL Database
Instructies voor het installeren van MySQL kunt u vinden in mijn bloart Installatie MySQL Database en Upgrade van MySQL 5.0 naar MySQL 5.1 onder Windows

- Start de MySQL Administrator via Start > Uw programma’s > MySQL > MySQL Administrator.

- Selecteer de optie User Administration

- Klik met uw rechtermuisknop in de linkeronderhoek onder de gebruiker root en selecteer de menuoptie Add new user

- Onder het tabblad User Information voer de gegevens van de nieuwe gebruiker in:
MySQL User = jfire
Password = jfire_password

- Onder het tabblad Schema Priveleges selecteer het schema information_schema en kopieer al de priveleges uit de rechterkolom daarnaartoe. Doe hetzelfde voor het schema MySQL.

Stap 6: Opstarten van de JFire development server
In stap 6 gaat u de JFire development server starten.

Wanneer u de server de eerste maal opstart zal de server een errormelding geven. Start de server daarna opnieuw op.

Voor het opstarten van de JFire development server hebt u twee mogelijkheden:
1) handmatig
2) met behulp van het Eclipse Server Tools Project

1) Voor het handmatig starten van de JFire development server ga naar de folder C:\DataFiles\eclipse\jfire-workspace\deploy\jboss\bin\ en start het bestand run.bat op.

Wanneer de JBoss Server is opgestart ziet u onderaan het consolescherm de volgende regel verschijnen:
14:25:13,015 INFO [Server] JBoss (MX MicroKernel) [4.2.0.GA (build: SVNTag=JBoss_4_2_0_GA date=200705111440)] Started in 2m:31s:15ms

2) Voor het starten met behulp van het Eclipse Server Tools Project volg de instructies in mijn bloart Opstarten van de jFire development server met de Eclipse Server Tools.

Wanneer de JBoss Server is opgestart ziet u onderaan het consolescherm de volgende regel verschijnen:
19:01:54,078 INFO [Server] JBoss (MX MicroKernel) [4.2.0.GA (build: SVNTag=JBoss_4_2_0_GA date=200705111440)] Started in 2m:17s:610ms

Stap 7: Configureren van JFire
In stap 7 gaat u de JFire server en MySQL server configureren.

- Nadat de JBoss server is opgestart start uw Internet Explorer of andere webbrowser en ga naar de URL ga naar http://127.0.0.1:8080/jfire voor het configureren van JFire.

U kunt ook de interne webbrowser van Eclipse openen via het menu Windows en selecteer de optie Show View > Other.

- In het dialoogscherm Show View open de node General en selecteer de optie Internal Web Browser.

- Voer op de adresregel de URL http://127.0.0.1:8080/jfire en klik op de groene pijl aan het eind van het de regel.

U krijgt nu de melding dat het de eerste keer is dat u de connectie maakt met uw JFire server.

- Klik op de knop Start configuration.

- Configureer nu uw local server:
Server ID = [jfire.danga.nl] De unieke identifier voor uw server. Het is een goed gebruik om de DNS hostname op te nemen in de server id wanneer de server deel uitmaakt van een netwerk met meerdere organisaties.

Server Name = [DanGa JFire development server] De naam van uw JFire server.

Server Type = [jboss_40x] Het type applicatie server dat u gebruikt. Waarschijnlijk hoeft de opgegeven waarde [jboss_40x] niet aangepast te worden.

Initial Context URL = Dit is de URL die gebruikt wordt door de JNDI InitialContext om met uw server te communiceren. U moet hier een juiste waarde gebruiken omdat een aantal interne componenten lokale authenticatie toepassen alsof zij een connectie maken vanaf een remote host. Dit geldt ondermeer voor de datastore-initialisation routine.

Accepteer de opgegeven waarde [jnp://127.0.0.1:1099] voor uw development server. De JNDI server luistert naar poort 1099.

Meer informatie over JNDI InitialContext kunt u vinden in een artikel op de website van www.javaworld.com.

Deploy Base Directory = Accepteer de opgegeven waarde.

Server Configurator = Selecteer uit de lijst de waarde org.nightlabs.jfire.jboss.serverconfigurator.ServerConfiguratorJBossMySQL. Let op: wanneer u deze waarde later aanpast nadat uw server is geïnialiseerd verliest u uw volledige configuratie.

- Klik op de knop Save om uw lokale server configuratie op te slaan.

- Configureer nu uw database instellingen:
Een organisatie in JFire vertegenwoordigd een bedrijf of andere entiteit die gebruikt maakt van het systeem. Elke organisatie beschikt over een eigen database waarin de gegevens worden opgeslagen.

Selecteer de database MySQL en klik op de knop Load Default Values. Waarschijnlijk kunt u alle default waarden accepteren.

Driver Name for non-transactional use = [com.mysql.jdbc.Driver]

Driver Name for local transactional use = [com.mysql.jdbc.Driver]

Driver Name for xa (distributed) transactions = [com.mysql.jdbc.jdbc2.optional.MysqlXADataSource]

Hint: De MySQL JDBC Driver is terug te vinden onder de directory \deploy\jboss\server\default\lib\.

URL = [jdbc:mysql://localhost/${databaseName}] De database URL is een JDBC URL met daarin een variabele voor de naam van de database. De database wordt aangemaakt door de JFire server wanneer u een organisatie aanmaakt.

Name Prefix = [JFire_] Dit is de prefix die wordt toegekend aan de JFire databases.

Name Suffix = [] Dit is de suffix die wordt toegekend aan de JFire databases.

User Name = [jfire] De gebruikersnaam van de gebruiker die over voldoende rechten beschikt voor creatie van een database onder MySQL.

Password = [jfire_password]

Hint: Verifieer eerst of uw gebruikersnaam en wachtwoord toegang heeft tot de MySQL database.

Adapter = [org.nightlabs.jfire.servermanager.db.DatabaseAdapterMySQL] Accepteer de opgegeven waarde.

Type Mapping = [mySQL]

Datasource Configuration File = [db-${organisationID}-ds.xml]

Datasource Configuration Template File = [../server/default/deploy/JFire.last/JFireBase.ear/db-mysql-ds.template.xml]

- Klik op de knop Save om uw database instellingen op te slaan.

- Configureer nu de JDO instellingen:
JFire maakt gebruikt van de JDO standaard voor de persistente opslag van gegevens. Het JDO raamwerk wordt geleverd door de module JFireBase. JFire maakt één afzonderlijke JDO datastore aan per organisatie. Een database wordt in principe aangemaakt wanneer u de knoppen aanklikt voor het opzetten van een nieuwe organisatie in JFire.

Configuration Directory = [../server/default/deploy/JFire_JDO_${organisationID}.last/]

Configuration File =[jdo-${organisationID}-ds.xml]

Configuration Template File = [../server/default/deploy/JFire.last/JFireBase.ear/jdo-jpox-1.2-ds.template.xml]

- Klik op de knop Save om uw JDO instellingen op te slaan.

- Configureer nu uw Root Organisation instellingen:
In elk JFire netwerk bestaat er één speciale organisatie die de netwerk-brede standaarden bepaald. Deze organisatie wordt de root-organisation genoemd. Er wordt gesproken van een JFire netwerk wanneer meerdere JFire organisaties interageren. Interactie is slechts mogelijk wanneer bepaalde velden globaal zijn gedefinieerd of mappings bestaan. JFire gebruikt beide principes zodat maximale flexibiliteit is gegarandeerd.

Elke organisatie registreert zich in de root-organisatie op het moment dat de organisatie is aangemaakt. Na bevestiging van de root-organisatie kan de organisatie een lijst opvragen van de bekende organisaties in het netwerk.

De root-organisatie moet bestaan en online zijn wil men een multitenancy (multigebruikers) netwerk opzetten. Wanneer de Organisation ID blank gelaten wordt dan wordt een stand-alone organisatie opgezet.

Let op: Het is niet mogelijk om de organisatievorm later te wijzigen.

- Klik op de knop Save om uw Root Organisation instellingen op te slaan.

- Configureer nu de instellingen van uw First Organisation:
Organisation ID = [chezfrancois.jfire.org] Maak gebruik van de organisatie ChezFrancois wanneer u over demo dat wilt beschikken.

Organisation Name = [Chez François Wine Store] Geef uw organisatie een toepasselijke naam.

- Klik op de knop Save om uw First Organisation instellingen op te slaan.

- Maak nu de Admininstrator gebruiker aan voor uw organisatie:
User ID = [francois]

Password = [test]

- Klik op de knop Save om de Administrator gebruiker instellingen op te slaan.

Tip: De default instellingen liggen opgeslagen in het bestand Config-org.nightlabs.jfire.servermanager.config.JFireServerConfigModule.xml in de folder deploy\jboss\server\default\deploy\JFire.last\JFireBase.ear\config\.

- Configureer nu de SMTP Server:
Het is niet duidelijk welke instellingen hier benodigd zijn. Vermoedelijk is dit bedoeld voor JFire servers die op een andere machine draaien.

- Klik op de knop Save om de SMTP Server instellingen op te slaan.

Hierna krijgt u een overzicht van de door u ingevoerde instellingen. Als deze instellingen juist zijn klik dan op de knop Perform initialisation.

Hint: Wanneer u nu een scherm krijgt met errors dan moet u de JFire server configuratie resetten en opnieuw starten met het configureren van de JFire server. Het is aangeraden om alvorens het configureren te starten een tweetal keer de server te stoppen en te herstarten. Voor het resetten van de JFire server ga naar mijn bloart Reset de JFire Server Configuratie

Wanneer de configuratie van de JFire server gelukt is dan verschijnt u de melding Server initialization was successful.

De volgende MySQL databases zijn aangemaakt:
- jfire_jbossmq
- jfire_chezfrancois_jfire_org

Dit kunt u controleren door uw MySQL Aministrator op te starten en de folder Catalogs te openen.

Stap 8: Openen van de JFire organisatie chezfrancois.jfire.org
Omdat het consolescherm steeds alle informatie geeft over de activiteiten van de server is het verstandig om nu een externe browser te openen en naar de URL http://127.0.0.1:8080/jfire te gaan.

Voer de gegevens in die gevraagd worden en het Welcome to JFire scherm opent.

Blijf deze weblog volgen als u hierover meer wilt weten!