Installatie JFire server via het installatieprogramma jfire-jboss-installer
Als u JFire wilt gaan gebruiken dan is het aangeraden om deze versie te downloaden en te installeren. Ga naar de website van JFire en download de JFire beta release (0.9.4 Tough Trader). U dient zowel de server als de client te downloaden.
Tip: Het is aanbevolen om het installatieprogramma, JFire-Max_0.9.4-beta_tough-trader_jfire-jboss-installer.jar voor de installatie van de server te downloaden. Dit programma begeleidt u volledig bij de initialisatie en installatie van JFire server.
Hierna zal ik u begeleiden bij de installatie van de JFire server in combinatie met een MySQL database. Meer informatie over het installeren van MySQL kunt u elders op mijn weblog vinden.
Allereerst ga ik de JFire server installeren:
Ga naar de folder waarin u het installatieprogramma, JFire-Max_0.9.4-beta_tough-trader_jfire-jboss-installer.jar, hebt opgeslagen en start het programma.
U gaat nu een aantal schermen doorlopen voor het initialiseren van uw JFire server.
Scherm JFire installation
Kies hier voor de optie User Defined. Deze optie biedt u de mogelijkheid om alle instellingen te zien en waar nodig aan te passen aan uw situatie.
Klik op de knop Next om naar het volgende scherm te gaan.
Scherm License
Accepteer de licentie door de optie Yes aan te vinken en klik daarna op de knop Next om naar het volgende scherm te gaan.
If you want to start using JFire it is recommended to download and install this version.
Go to the website of JFire and download the JFire beta release (0.9.4 Tough Trader). You need to download both the server and the client.
Tip: It is recommended to download the installation program, JFire-Max_0.9.4-beta_tough-trader_jfire-jboss-installer.jar for the server installation. This program guides you through the intialisation and installation of the JFire server.
Hereafter I will guide you through the installation of the JFire server in combination with a MySQL database. More information on MySQL is available elsewhere on my weblog.
First I am going to install the JFire server:
Go to the folder where you stored the installationprogram, JFire-Max_0.9.4-beta_tough-trader_jfire-jboss-installer.jar, and start the program.
You will have to go through a number of screens for setting up your JFire server.
Screen JFire installation
Choose the option User Defined. When you select this option you will be able to see all the settings and adapt these to your situation where necessary.
Click on the button Next for the next screen.
Screen License
Accept the license and Click on the button Next for the next screen.
Als u de JFire server in een specifieke directory wilt installeren dan kunt u dat hier aangeven in het veld installation directory.
Klik op de knop Next om naar het volgende scherm te gaan.
Scherm Installation options
In dit scherm kunt u aangeven hoe de JFire server geïnstalleerd moet worden onder uw Windows.
Wanneer u de JFire server als een service onder Windows wilt installeren dan dient u de optie Install as service aan te vinken.
Klik op de knop Next om naar het volgende scherm te gaan.
Scherm Local Server
Dit scherm bevat de instellingen voor uw JFire server.
Een aantal velden moet u invullen of accepteren.
- Server Id: danga.server.jfire.org
Tik hier de identificatie van uw server in.
- Server name: danga
Tik hier de naam van uw server in.
- Server type: jboss_40x.
Accepteer de waarde.
- Initial context URL: jnp://127.0.0.1:1099
Accepteer de waarde.
- Deploy base directory: C:\ProgramFiles\jfire-server\server\default\deploy\JFire.last
Op basis van de specifieke folder die u eerder hebt opgegeven wordt het pad naar de deploy base directory samengesteld. U kunt deze directory accepteren of eventueel hier nog aanpassen.
- Server configurator: ServerConfiguratorJBossMySQL
Kies hier de configurator die bij uw database management systeem hoort.
- RMI host:
blank laten
Klik nu op de knop Next om naar het volgende scherm te gaan.
Scherm Database presets
Kies hier de database omgeving die u wilt gebruiken. Deze keuze is noodzakelijk zodat de juiste databaseinstellingen voor het volgende scherm opgehaald kunnen worden.
Klik nu op de knop Next om naar het volgende scherm te gaan.
Scherm Database
Hier kunt u al de configuratieinstellingen voor uw databaseserver invoeren door de voorgestelde waarden te accepteren of te overschrijven.
- Driver name (non-transactional): com.mysql.jdbc.Driver
De JDBC driver naam voor uw SQL server. Accepteer deze waarde.
- Driver name (local transactions): com.mysql.jdbc.Driver
De JDBC driver naam voor uw SQL server. Accepteer deze waarde.
- Driver name (xa transactions): com.mysql.jdbc.jdbc2.optional.MysqlXADataSource
Accepteer deze waarde.
- Connection URL template: jdbc:mysql://localhost/${databaseName}
Accepteer deze waarde.
- Name prefix: JFire_
Accepteer deze waarde.
- Name suffix:
Laat blank.
- Username: jfire
Dit is de gebruiker die autorisatie heeft om databases aan te maken in het database management systeem dat u gekozen heeft. U kunt hier ook de root administrator login van uw database invullen.
- Password:
Voer het wachtwoord in van de gebruiker.
- Adapter: org.nightlabs.jfire.servermanager.db.DatabaseAdapterMySQL
- Type mapping: mySQL
- Datasource configuration file: db-${organisationID}-ds.xml
- Configuration template file: ../server/default/deploy/JFire.last/JFireBase.ear/db-mysql-ds.template.xml
Klik op de knop Next om naar het volgende scherm te gaan.
Tip: Het kan zijn dat u een errormelding krijgt omdat de door u opgevoerde gebruiker niet de juiste autorisatie heeft om een database aan te maken in de MySQL DBMS. U kunt dan ofwel de gebruiker root opvoeren in het database scherm ofwel via uw MySQL Administrator de gebruiker jfire aanmaken. Als deze gebruiker al bestaat dan kunt u deze het beste verwijderen en opnieuw aanmaken door een clone van de root gebruiker te nemen.
Scherm JDO
De instellingen in dit scherm moet u accepteren zoals ze zijn.
Klik op de knop Next om naar het volgende scherm te gaan.
Scherm Root Organisation
De instellingen in dit scherm mag u accepteren wanneer u geen overkoepelende organisatie wilt gebruiken.
Klik op de knop Next om naar het volgende scherm te gaan.
Scherm First Organisations
In dit scherm kunt u aangeven welke bedrijven aangemaakt moeten worden. Standaard staat het demo-bedrijf Chez Francois wine store aangevinkt en kunt u aangeven of u nog een eigen organisatie wilt aanmaken.
Vink deze laatste optie aan en klik op de knop Next om verder te gaan.
Scherm First organisation
Wanneer u de laatste optie in het voorgaande scherm hebt aangevinkt zal het scherm First organisation geopend worden. Hier moet u de gegevens van uw eerste bedrijf invoeren.
- Organisation Id: danga.jfire.org
De identificatiecode van uw organisatie.
- Organisation name: danga-company
De naam van uw organisatie.
- Admin user name: danga
De loginnaam van de beheerder.
- Admin password:
Het wachtwoord van de beheerder
- Admin password (again):
Nogmaals het wachtwoord van de beheerder ter verificatie.
Klik op de knop Next om naar het volgende scherm te gaan.
Scherm Test Suite
Wanneer de JFire server wordt opgestart zal een test-bericht gestuurd worden naar een opgegeven e-mailadres. Voor productiedoeleinden is het niet nodig om dit in te vullen.
Verwijder het vinkje bij het veld Send a report if tests failed en klik op de knop Next om verder te gaan.
Scherm Perform installation
Nu bent u aan het einde van de initialisatie gekomen en kunt u in het scherm Perform installation de opdracht geven om de installatie te starten. Klik hiervoor op de knop Finish.
In het volgende scherm kunt u de voortgang van de installatie volgen. Dit gaat enige tijd duren.
Toch raad ik u aan om de voortgang in het begin te volgen want het kan gebeuren dat uw virusscanner of Windows met een melding komt dat een actie geblokkeerd is en u vraagt of u deze wilt toestaan.
Wanneer de installatie afgerond is kunt u op de knop Close klikken om het installatieprogramma te verlaten.
Alvorens de JFire client te installeren moet u de JFire Server opstarten. Ga naar de directory waarin de JFire Server is geïnstalleerd en open de folder bin. Start nu de JFire Server via het bestand run.bat.
De volgende stap is de installatie van de JFire client:
Ga naar het zip-bestand met de client-software en pak het bestand uit naar de folder jfire-client.
Start nu het programma jfire.exe (onder Windows). Ik zal binnenkort verder ingaan op de werking van de JFire client en de aangeboden functionaliteit.
If you want to use a specific directory for the JFire server you can indicate it here in the field installation directory.
Click on the button Next for the next screen.
Screen Installation options
The settings in this screen allow you to indicate how the JFire server need to be installed under Windows.
If you want to install the JFire server as a service under Windows then you have to select the option Install as service.
Click on the button Next for the next screen.
Screen Local Server
This screen contains the settings for your JFire server.
You will have to accept or enter values in some fields.
- Server Id: danga.server.jfire.org
Enter the id for your server.
- Server name: danga
Enter the name for your server.
- Server type: jboss_40x.
Accept the value.
- Initial context URL: jnp://127.0.0.1:1099
Accept the value.
- Deploy base directory: C:\ProgramFiles\jfire-server\server\default\deploy\JFire.last
Based on the specific directory you entered earlier the path to the deploy base directory is constructed. You only need to accept the value.
- Server configurator: ServerConfiguratorJBossMySQL
Here you will have to choose the configurator for the database management system that you want to use.
- RMI host:
Leave blank.
Click on the button Next for the next screen.
Screen Database presets
Select the database environment that you want to use. The choice is needed to ensure the correct settings for the database are loaded in the next screen.
Click on the button Next for the next screen.
Screen Database
Here you need to enter the configuration settings of your database server.
You can accept values or overwrite them.
- Driver name (non-transactional): com.mysql.jdbc.Driver
The JDBC driver name for your SQL server. Accept the value.
- Driver name (local transactions): com.mysql.jdbc.Driver
The JDBC driver name for your SQL server. Accept the value.
- Driver name (xa transactions): com.mysql.jdbc.jdbc2.optional.MysqlXADataSource
Accept the value.
- Connection URL template: jdbc:mysql://localhost/${databaseName}
Accept the value.
- Name prefix: JFire_
Accept the value.
- Name suffix:
Leave blank.
- Username: jfire
The user that is allowed to create a database in the database management system.
Accept the value.
- Password:
Enter the password for the above user.
- Adapter: org.nightlabs.jfire.servermanager.db.DatabaseAdapterMySQL
- Type mapping: mySQL
- Datasource configuration file: db-${organisationID}-ds.xml
- Configuration template file: ../server/default/deploy/JFire.last/JFireBase.ear/db-mysql-ds.template.xml
Click on the button Next for the next screen.
Tip: If you get an error message for the user you will have to enter the user root or go back to the MySQL Administrator and recreate the user jfire, make a clone from the user root.
Screen JDO
Accept all settings.
Click on the button Next for the next screen.
Screen Root Organisation
If you are not using a root organisation you can accept all the settings and continue.
Click on the button Next for the next screen.
Screen First Organisations
Enter the companies you want to create. Standard the demo-organisation Chez Francois wine store is selected and you can indicate that you want to create your own organisation.
Select the last option and Click on the button Next for the next screen.
Screen First organisation
When you indicated that you want to create your own organisation in the previous screen the screen First organisation will open.
- Organisation Id: danga.jfire.org
The id of your organisation.
- Organisation name: danga-company
The name of your organisation.
- Admin user name: danga
The login of the adminstrator.
- Admin password:
The password of the administrator.
- Admin password (again):
Again the password of the administrator.
Click on the button Next for the next screen.
Scherm Test Suite
For production purposes the settings are not required.
Deselect the Send a report if tests failed and Click on the button Next for the next screen.
Screen Perform installation
You finished the initialisation and you can start the installation now. Click on the button Finish.
In the next screen you can follow the progress of the installation . This will take some time.
My advice is to keep following the progress because it can happen that your virusscanner or Windows comes up with a message that an action is blocked and will ask you whether you allow it.
When the installation if finished just hit the button Close .
Before installing the JFire client you will need to start the JFire Server. Go to the directory where you installed the server and open the folder bin. Now start the server using run.bat.
The next step is the installation of the JFire client:
Go to the zip-file with the client-software and unpack the file to the folder jfire-client.
Now start the program jfire.exe (under Windows). I will soon explain the JFire client and functionality more in depth.
