openfireAan de slag met openfire


Opmerkingen

Deze sectie geeft een overzicht van wat openfire is en waarom een ontwikkelaar het zou willen gebruiken.

Het moet ook alle grote onderwerpen binnen open vuur vermelden en een link naar de gerelateerde onderwerpen. Aangezien de Documentatie voor openfire nieuw is, moet u mogelijk eerste versies van die gerelateerde onderwerpen maken.

Installatie

Openfire is beschikbaar om te downloaden op de Ignite Realtime-website. Het is ook mogelijk om de relatieve broncode te downloaden. Voer hier de linkbeschrijving in

Windows installatie:

  • Voer gewoon de exe uit en volg de basisinstructies zoals elk programma (installatiemap, snelkoppeling etc.).

Installatie van Unix-Linux-Mac:

  • Pak uit in een willekeurige map of volg de basisinstructies zoals elk programma

U vindt gedetailleerde instructies in de officiële documentatie

Opstelling

Openfire setup is gebaseerd op een combinatie van XML-configuratie en database-ingangen. Na de eerste installatie zal Openfire leiden tot het implementeren van een webbeheerpaneel dat luistert op poort 9090. Eindpunt voor toegang is meestal op http: // machinenamwhereinstalled: 9090 en gemarkeerd tijdens het opstarten van Openfire.

Toegang tot het admin-paneel komt terecht in de webgebaseerde wizardconfiguratie. Het is mogelijk om de wizard te volgen of te vermijden om een reeds geconfigureerde Openfire-server in te stellen, bijvoorbeeld met een bepaald domein, gebruikers en andere configuraties (om een andere installatie te klonen of te verplaatsen).

Wat je nodig hebt voordat je de wizard start

Openfire vereist toegang tot een database voor gegevenspersistentie, zoals geregistreerde gebruikers en vele andere configuraties. In de map <Openfire_home>/database is het mogelijk om het pad <Openfire_home>/database te volgen om het geweigerde script van de database te vinden voor uitvoering op een bestaande database.

Openfire moet een databasestuurprogramma selecteren en referenties invoegen om toegang te krijgen tot uw database.

Als alternatief is het mogelijk om Openfire een ingebedde (maar niet altijd gemakkelijk te ontwikkelen) HSQLDB-database te laten maken ; meer, als Openfire is geconfigureerd met database-referenties van admin-subsidies, zal het in staat zijn om het databasescript zelf tijdens de wizard transparant te lunchen.

Houd in gedachten wat de scope is die het installatieprogramma wil bereiken om het juiste gedrag te verkrijgen.

Oracle merkt op:

  • Oracle ODBC-stuurprogramma's hebben geen standaard opensource-licentie en kunnen daarom niet worden geleverd met Openfire; om de download van de Oracle-website te gebruiken en te kopiëren voordat u de wizard start in de map <Openfire_Home>/lib .
  • Het script van Oracle heeft mogelijk updates nodig, afhankelijk van de doelversie van de Oracle-database. Controleer het bestand voordat u het uitvoert.

Wat u nodig hebt om de wizard te vermijden

Als het nodig is om de wizard te vermijden, moet u:

  1. Configureer correct <Openfire_home> /conf/openfire.xml
  2. Configureer correct <Openfire_home> /conf/security.xml
  3. Export van ofProperty

openfire.xml en security.xml Om een installatie te klonen (en dus te "verplaatsen"), moet u de vlag instellen op true onder de jive tag

<setup>true</setup> 
 

Als u een installatie met dezelfde params wilt repliceren (bijvoorbeeld in meerdere omgevingen zoals ontwikkelen en onderhoud), bekijk dan de configuratie van de database-tag en zorg ervoor dat u over de coderingssleutel beschikt. Zo ziet het eruit als gecodeerde sleutels

  <database> 
    <defaultProvider> 
      <username encrypted="true">QXxDT1fOVuvrY=</username>  
      <password encrypted="true">QXxDT1fO1jnAiTGZq6u=</password>
    </defaultProvider> 
  </database> 
 

En dit ziet eruit als niet-gecodeerde sleutels

  <database> 
    <defaultProvider> 
      <username>admin</username>  
      <password>password</password>
    </defaultProvider> 
  </database> 
 

encrypted attribuut het is gewoon een tijdelijke aanduiding (versleuteld = "onwaar" heeft geen effect): gebruikersnaam en wachtwoord worden als versleuteld beschouwd als in <Openfire_home>/conf/security.xml de versleutelde tag is opgegeven met items zoals in het standaardgedrag zoals deze :

<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>  
 

Verwijder die 2 namen om gewoon wachtwoord te gebruiken

  <encrypt> 
    <!-- This can be set to "AES" or "Blowfish" (default) at setup time -->  
    <algorithm>AES</algorithm>  
    <key> 
    </key>  
    <property> 
    </property> 
  </encrypt>
 

van de tabel met eigenschappen

ofProperty is een tabel die moet worden geëxporteerd om de configuratie tussen 2 Openfire-servers te klonen. Er zijn echter 3 ingangen om op te focussen en misschien bewerkt:

  • xmpp.domain als het domein van de nieuwe Openfire-installatie niet gelijk is aan bron één
  • admin.authorizedJIDs moeten dienovereenkomstig worden gewijzigd om de jid van beheerders bij te werken
  • database.defaultProvider.serverURL moet worden gewijzigd als de database verandert.

Voorbeeld van invoegen:

Insert into OFPROPERTY  (NAME,PROPVALUE) values ('admin.authorizedJIDs','admin@environmentDomain');
Insert into OFPROPERTY (NAME,PROPVALUE) values ('database.defaultProvider.serverURL','jdbc:oracle:thin:@...');
Insert into OFPROPERTY (NAME,PROPVALUE) values ('xmpp.domain','environmentDomain');