Débuter avec openfire
Sur cette page
Installation
Openfire est disponible en téléchargement sur [site Web Ignite Realtime] [1] Il est également possible de télécharger le code source relatif[entrer la description du lien ici][2]
Installateur Windows :
- Exécutez simplement l’exe et suivez les instructions de base comme n’importe quel programme (répertoire d’installation, raccourci, etc.).
Installation Unix-Linux-Mac :
- Extrayez dans un dossier arbitraire ou suivez les instructions de base comme n’importe quel programme
Vous pouvez trouver des instructions détaillées sur [documentation officielle][3]
[1] : https://www.igniterealtime.org/downloads/index.jsp [2] : https://www.igniterealtime.org/downloads/source.jsp [3] : http://download.igniterealtime.org/openfire/docs/latest/documentation/install-guide.html
Installer
La configuration d’Openfire est basée sur une combinaison d’entrées de configuration xml et de base de données. Après la première installation, exécuter Openfire mènera au déploiement d’un panneau d’administration Web écoutant sur le port 9090. Le point de terminaison pour y accéder est généralement sur http://machinenamewhereinstalled:9090 et signalé dans le journal d’Openfire au démarrage.
L’accès au panneau d’administration aboutira à la configuration de l’assistant Web. Il est possible de suivre l’assistant ou de l’éviter pour configurer un serveur Openfire déjà configuré, par exemple avec un domaine, des utilisateurs et d’autres configurations donnés (pour cloner ou déplacer une autre installation).
Ce dont vous avez besoin avant de démarrer l’assistant
Openfire nécessite l’accès à une base de données pour la persistance des données, comme les utilisateurs enregistrés et de nombreuses autres configurations. Dans le dossier Openfire, en suivant le chemin <Openfire_home>/database
, il est possible de trouver le script refusé de la base de données à exécuter sur une base de données existante.
Openfire nécessitera de sélectionner un pilote de base de données et d’insérer des informations d’identification pour accéder à votre base de données.
Comme alternative, il est possible de laisser Openfire créer une [base de données HSQLDB][1] intégrée (mais pas toujours confortable à développer); De plus, si Openfire est configuré avec les informations d’identification de la base de données des subventions d’administrateur, il pourra démarrer le script de base de données lui-même pendant l’assistant de manière transparente.
Gardez à l’esprit la portée que l’installateur souhaite atteindre pour obtenir le bon comportement.
Notes d’Oracle :
- Les pilotes Oracle ODBC n’ont pas de licence Opensource standard, donc
ne peut pas être livré avec Openfire ; utiliser le téléchargement depuis [Oracle
site Web][2] et copiez avant de démarrer l’assistant dans
Répertoire
<Openfire_Home>/lib
. - Le script d’Oracle peut nécessiter des mises à jour en fonction de la cible de la base de données Oracle version, vérifiez le fichier avant de l’exécuter.
Ce dont vous avez besoin pour éviter l’assistant
S’il faut éviter l’assistant, il faut :
- Configurez correctement <Openfire_home>/conf/openfire.xml
- Configurez correctement <Openfire_home>/conf/security.xml
- Exporter la table
ofProperty
openfire.xml et security.xml
Pour cloner (et donc “déplacer”) une installation, assurez-vous que le drapeau est configuré sur true sous la balise jive
<setup>true</setup>
Pour répliquer une installation avec les mêmes paramètres (par exemple sur plusieurs environnements tels que le développement et la maintenance), vérifiez la configuration de la balise de base de données et assurez-vous de la clé de chiffrement. Voici à quoi ressemblent les clés cryptées
<database>
<defaultProvider>
<username encrypted="true">QXxDT1fOVuvrY=</username>
<password encrypted="true">QXxDT1fO1jnAiTGZq6u=</password>
</defaultProvider>
</database>
Et cela ressemble à des clés non chiffrées
<database>
<defaultProvider>
<username>admin</username>
<password>password</password>
</defaultProvider>
</database>
l’attribut encrypted
c’est juste un espace réservé (encrypted=“false” n’a aucun effet) : le nom d’utilisateur et le mot de passe sont considérés comme cryptés si dans <Openfire_home>/conf/security.xml
il y a la balise de cryptage déclarée avec des entrées comme dans la valeur par défaut comportement comme celui-ci :
<security>
<encrypt>
<!-- This can be set to "AES" or "Blowfish" (default) at setup time -->
<algorithm>AES</algorithm>
<key>
</key>
<property>
<!--
This list includes the names of properties that have been marked for
encryption. Any XML properties (from openfire.xml) that are listed here
will be encrypted automatically upon first use. Other properties
(already in the database) can be added to this list at runtime via the
"System Properties" page in the Openfire console.
-->
<name>database.defaultProvider.username</name>
<name>database.defaultProvider.password</name>
</property>
</encrypt>
Supprimez ces 2 entrées de nom pour utiliser un mot de passe simple
<encrypt>
<!-- This can be set to "AES" or "Blowfish" (default) at setup time -->
<algorithm>AES</algorithm>
<key>
</key>
<property>
</property>
</encrypt>
du tableau des propriétés
ofProperty
est une table qui doit être exportée pour cloner la configuration entre 2 serveurs Openfire. Il y a cependant 3 entrées sur lesquelles se concentrer et peut-être éditées :
xmpp.domain
si le domaine de la nouvelle installation Openfire n’est pas égal à partir de la source unadmin.authorizedJIDs
doit être modifié en conséquence pour mettre à jour le jid des administrateursdatabase.defaultProvider.serverURL
doit être modifié si la base de données changements.
Exemple d’encart :
Insert into OFPROPERTY (NAME,PROPVALUE) values ('admin.authorizedJIDs','[email protected]');
Insert into OFPROPERTY (NAME,PROPVALUE) values ('database.defaultProvider.serverURL','jdbc:oracle:thin:@...');
Insert into OFPROPERTY (NAME,PROPVALUE) values ('xmpp.domain','environmentDomain');
[1] : http://hsqldb.org/ [2] : http://www.oracle.com/technetwork/database/windows/downloads/utilsoft-098155.html