...
| Sv translation |
|---|
|
Der PlatformUDPListener wird auf die Master-Datenbanken installiert. Auf alle Master Datenbanken muss der UDP Listener Prozess installiert werden. Dies benötigt eine Java-Laufzeitumgebung: | Translations Ignore |
|---|
| Code Block |
|---|
| language | bash |
|---|
| title | Install Java runtime environment |
|---|
| yum -y install https://cdn.jtel.de/downloads/java/jdk-8u202-linux-x64.rpm |
|
Im Anschluss wird der UDP Listener mit folgenden Befehlen installiert: | Translations Ignore |
|---|
| Code Block |
|---|
| title | Copy platform UDP listener |
|---|
| cp -a /home/jtel/shared/JTELCarrierPortal/Utils/Install/PlatformUDPlistener/ /home/jtel/
cp -a /home/jtel/PlatformUDPlistener/init.d/jtel-listener /etc/init.d |
|
Als nächstes muss die Konfigurationsdatei des UDP Listeners der Umgebung angepasst werden. Hierfür muss die Datei /home/jtel/PlatformUDPlistener/conf/hazelcast.xml entsprechend angepasst werden. Hierbei sind insbesondere folgende zwei Abschnitte anzupassen: | Translations Ignore |
|---|
| Code Block |
|---|
| language | xml |
|---|
| title | Cluster identity |
|---|
| <group>
<name>jtel-cluster-NAME</name>
<password>jtel-cluster-pass</password>
</group> |
|
Da nicht hundertprozentig auszuschließen ist, dass sich im Netz weitere auf Hazelcast basierende Applikationen befinden können (wie z.B. weitere jtel-Systeme in größeren Cloud-Umgebungen, ist es wichtig für das entsprechende jtel-System den Cluster-Namen und das Cluster-Passwort zu individualisieren. Ein weiterer wichtiger Abschnitt betrifft die Zusammensetzung des Clusters. Im Auslieferungszustand ist die Konfigurationsdatei so ausgelegt, dass die Cluster-Members sich mittels Multicast finden und kommunizieren. Diese Methode sollte im Wirkbetrieb nicht verwendet werden, da sie zusätzlichen überflüssigen Netzwerkverkehr erzeugt und auch Auswirkungen auf andere Applikationen haben kann. Des weiteren wäre dafür eine Firewall-Konfiguration erforderlich, die hier nicht weiter erörtert wird. Aus diesem Grunde ist diese Kommunikationsform abzuschalten (<multicast enabled="false" />) und hingegen die Liste der Kommunikationspartner einzutragen. Dabei ist darauf zu achten, dass der entsprechende Abschnitt, der im Auslieferungszustand auskommentiert ist, aktiviert werden muss. Die Liste der Kommunikationspartner setzt sich folgendermaßen zusammen: - Der primäre DATA-Server
- Jeder TEL-Server
- Jeder WEB-Server
Im spezifischen Fall des hier vorgestellten Installationsszenario, würden die Anpassungen folgendermaßen aussehen: | Translations Ignore |
|---|
| Code Block |
|---|
| language | xml |
|---|
| title | Cluster composition |
|---|
| <network>
<join>
<!-- DO NOT USE MULTICAST IN PRODUCTION ENVIRONMENTS -->
<multicast enabled="false" />
<!-- USE THIS SECTION INSTEAD AND ADAPT THE LIST OF MEMBERS -->
<tcp-ip enabled="true">
<member>192.168.1.21</member>
<member>192.168.1.31</member>
<member>192.168.1.32</member>
<member>192.168.1.40</member>
</tcp-ip>
</join>
</network> |
|
Da diese Konfigurationsdatei auf allen oben aufgelisteten Servern existieren muss und exakt gleich sein muss, empfiehlt es sich die nun angepasste Datei kurzfristig ins freigegebene Verzeichnis zu kopieren, so dass sie bei der Installation der folgenden Rollen direkt von dort bezogen werden kann: | Translations Ignore |
|---|
| Code Block |
|---|
| language | bash |
|---|
| title | Deploy the hazelcast.xml file to install additional roles |
|---|
| cp /home/jtel/PlatformUDPlistener/conf/hazelcast.xml /home/jtel/shared |
|
Der UDP Listener Dienst wird mit folgendem Befehl in die Liste der automatisch startenden Dienste aufgenommen: | Translations Ignore |
|---|
| Code Block |
|---|
| language | bash |
|---|
| title | UDP listener service autostart |
|---|
| cd /etc/init.d
chkconfig jtel-listener on |
|
Als nächstes müssen in der Firewall die Port-Freigaben für den UDP Listener Dienst eingetragen und persistent gespeichert werden: | Translations Ignore |
|---|
| Code Block |
|---|
| language | bash |
|---|
| title | Configure firewall |
|---|
| firewall-cmd --zone=public --add-port=5701-5801/tcp --permanent
firewall-cmd --reload |
|
Nun muss der UDP Listener manuell gestartet werden:
| Translations Ignore |
|---|
| Code Block |
|---|
| language | bash |
|---|
| title | Start UDP Listener |
|---|
| service jtel-listener start |
|
Um die Aktualisierung des USP Listeners zu vereinfachen, wird nun noch ein entsprechendes Skript erstellt: | Translations Ignore |
|---|
| Code Block |
|---|
| language | bash |
|---|
| title | Create the update script |
|---|
| cat <<EOFF > /usr/local/bin/updatepl.sh
#!/bin/bash
service jtel-listener stop
cp /home/jtel/shared/JTELCarrierPortal/Utils/Install/PlatformUDPlistener/bin/platform-UDP-listener-1.0-jar-with-dependencies.jar /home/jtel/PlatformUDPlistener/bin
chown jtel:jtel /home/jtel/PlatformUDPlistener/bin/*
service jtel-listener start
EOFF
chmod +x /usr/local/bin/updatepl.sh |
|
|
| Sv translation |
|---|
|
Le PlatformUDPListener est installé sur le master-databases.
Le processus UDP Listener doit être installé sur toutes les bases de données principales. Cela nécessite un environnement d'exécution Java :
| Translations Ignore |
|---|
| Code Block |
|---|
| language | bash |
|---|
| title | Installer l'environnement Java runtime |
|---|
|
yum -y install https://cdn.jtel.de/downloads/java/jdk-8u202-linux-x64.rpm |
Ensuite, le Listener UDP est installé avec les commandes suivantes :
| Translations Ignore |
|---|
| Code Block |
|---|
| title | Copier Plate-forme Listener UDP |
|---|
|
cp -a /home/jtel/shared/JTELCarrierPortal/Utils/Install/PlatformUDPlistener/ /home/jtel/ cp -a /home/jtel/PlatformUDPlistener/init.d/jtel-listener /etc/init.d |
Ensuite, le fichier de configuration de l'UDP Listener doit être adapté à l'environnement. Pour cela, le fichier /home/jtel/PlatformUDPlistener/conf/hazelcast.xmldoit être adapté en conséquence. En particulier, les deux sections suivantes doivent être adaptées :
| Translations Ignore |
|---|
| Code Block |
|---|
| language | xml |
|---|
| title | Identité du cluster |
|---|
|
<group> <name>jtel-cluster-NAME</name> <password>jtel-cluster-pass</password> </group> |
Comme il ne peut être exclu à 100% que d'autres applications basées sur Hazelcast puissent être présentes sur le réseau (comme d'autres systèmes jtel dans des environnements cloud plus importants), il est important d'individualiser le nom et le mot de passe du cluster pour le système jtel correspondant.
Une autre section importante concerne la composition du groupe. Dans l'état de livraison, le fichier de configuration est conçu de manière à ce que les membres du cluster se trouvent les uns les autres et communiquent par multicast. Cette méthode ne doit pas être utilisée en direct, car elle génère un trafic réseau supplémentaire inutile et peut également affecter d'autres applications. En outre, cela nécessiterait une configuration de pare-feu, qui n'est pas expliquée plus loin ici. Pour cette raison, cette forme de communication doit être désactivée (<multicast enabled="false" />) et la liste des partenaires de communication inscrits. Veuillez noter que la section correspondante, qui est commentée dans l'état de livraison, doit être activée. La liste des partenaires de communication est composée comme suit :
- Le serveur de données primaire
- Chaque serveur-TEL
- Chaque serveur-WEB
Dans le cas spécifique du scénario d'installation présenté ici, les ajustements seraient les suivants :
| Translations Ignore |
|---|
| Code Block |
|---|
| language | xml |
|---|
| title | Composition du cluster |
|---|
|
<network> <join> <!-- DO NOT USE MULTICAST IN PRODUCTION ENVIRONMENTS --> <multicast enabled="false" /> <!-- USE THIS SECTION INSTEAD AND ADAPT THE LIST OF MEMBERS --> <tcp-ip enabled="true"> <member>192.168.1.21</member> <member>192.168.1.31</member> <member>192.168.1.32</member> <member>192.168.1.40</member> </tcp-ip> </join> </network> |
Comme ce fichier de configuration doit exister sur tous les serveurs énumérés ci-dessus et doit être exactement le même, il est recommandé de copier le fichier maintenant adapté dans le répertoire partagé pendant une courte période, afin de pouvoir l'obtenir directement à partir de là lors de l'installation des rôles suivants :
| Translations Ignore |
|---|
| Code Block |
|---|
| language | bash |
|---|
| title | Déployez le fichier hazelcast.xml pour installer des rôles supplémentaires |
|---|
|
cp /home/jtel/PlatformUDPlistener/conf/hazelcast.xml /home/jtel/shared |
Le service UDP Listener est ajouté à la liste des services démarrant automatiquement avec la commande suivante :
| Translations Ignore |
|---|
| Code Block |
|---|
| language | bash |
|---|
| title | Démarrage automatique du service UDP listener |
|---|
|
cd /etc/init.d chkconfig jtel-listener on |
Ensuite, les parts de port pour le service UDP Listener doivent être saisies et stockées de façon permanente dans le pare-feu :
| Translations Ignore |
|---|
| Code Block |
|---|
| language | bash |
|---|
| title | Configurer le pare-feu |
|---|
|
firewall-cmd --zone=public --add-port=5701-5801/tcp --permanent firewall-cmd --reload |
Il faut maintenant lancer manuellement l'UDP Listener :
| Translations Ignore |
|---|
| Code Block |
|---|
| language | bash |
|---|
| title | Démarrer l'UDP Listener |
|---|
|
service jtel-listener start |
Pour simplifier la mise à jour de l'UDP Listener, un script correspondant est maintenant créé :
| Translations Ignore |
|---|
| Code Block |
|---|
| language | bash |
|---|
| title | Créer le script de mise à jour |
|---|
|
cat <<EOFF > /usr/local/bin/updatepl.sh #!/bin/bash service jtel-listener stop cp /home/jtel/shared/JTELCarrierPortal/Utils/Install/PlatformUDPlistener/bin/platform-UDP-listener-1.0-jar-with-dependencies.jar /home/jtel/PlatformUDPlistener/bin chown jtel:jtel /home/jtel/PlatformUDPlistener/bin/* service jtel-listener start EOFF chmod +x /usr/local/bin/updatepl.sh |
|