Versions Compared

Old Version 4

changes.mady.by.user jtel Support

Saved on

compared with

New Version Current

changes.mady.by.user jtel Support

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Content imported from a Scroll Translations translation file.
Sv translation
languageen

Master Server 

The PlatformUDPListener is installed on the master database(s).

Install Java

First of all, java is installed:

Translations Ignore


Code Block
languagebash
dnf -y install https://cdn.jtel.de/downloads/java/jdk-8u202-linux-x64.rpm


Install Platform UDP Listener

The Platform UDP Listener is installed with the following commands:

Translations Ignore


Code Block
cp -a /home/jtel/shared/JTELCarrierPortal/Utils/Install/PlatformUDPlistener/ /home/jtel/
cp -a /home/jtel/PlatformUDPlistener/init.dsystemd/jtel-listener.service /etc/init.d/systemd/system
rm -f /home/jtel/PlatformUDPlistener/conf/hazelcast.xml
cp -a /home/jtel/shared/hazelcast.xml /home/jtel/PlatformUDPlistener/conf/hazelcast.xml


Autostart Daemon

The Platform UDP Listener is enabled with the following commands:

Translations Ignore


Code Block
languagebash
cd /etc/init.d
chkconfigsystemctl enable jtel-listener
systemctl start jtel-listener on


Firewall Rules

The following configures the firewall, so the hazelcast cluster members can communicate with eachother:

Translations Ignore


Code Block
languagebash
firewall-cmd --zone=public --add-port=5701-5801/tcp --permanent
firewall-cmd --reload


Start Listener

Now, the listener is started:


Translations Ignore


Code Block
languagebash
service jtel-listener start


Update Script

To make updating the Platform UDP Listener simpler, a script is created:

Translations Ignore


Code Block
languagebash
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
languagede

Status
colourRed
titleThis page is only available in English

Sv translation
languagefr

Serveur maître 

Le PlatformUDPListener est installé sur la (les) base(s) de données principale(s).

Installer java

Tout d'abord, java est installé

Table of Contents
maxLevel3
printablefalse

Master Server 

Der PlatformUDPListener wird auf die Master-Datenbanken installiert.

Installation des Hazelcast Platform UDP Listeners

Auf alle Master Datenbanken muss der UDP Listener Prozess installiert werden. Dies benötigt eine Java-Laufzeitumgebung :

Translations Ignore


Code Block
languagebash
titleInstall Java runtime environment
yumdnf -y install https://cdn.jtel.de/downloads/java/jdk-8u202-linux-x64.rpm


Installer la plate-forme UDP Listener

Le Platform UDP Listener est installé avec les commandes suivantes Im Anschluss wird der UDP Listener mit folgenden Befehlen installiert :

Translations Ignore


Code Block
titleCopy platform UDP listener
cp -a /home/jtel/shared/JTELCarrierPortal/Utils/Install/PlatformUDPlistener/ /home/jtel/
 cp -a /home/jtel/PlatformUDPlistener/init.dsystemd/jtel-listener.service /etc/init.d
Als nächstes muss die Konfigurationsdatei des UDP Listeners der Umgebung angepasst werden. Hierfür muss die Datei 
systemd/system rm -f /home/jtel/PlatformUDPlistener/conf/hazelcast
.xml entsprechend angepasst werden
.
Hierbei sind insbesondere folgende zwei Abschnitte anzupassen:
Translations Ignore
Code Block
Code Block
languagexml
titleCluster 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
languagebash
titleDeploy the hazelcast.xml file to install additional roles
language
xml
titleCluster 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:

  1. Der primäre DATA-Server
  2. Jeder TEL-Server
  3. Jeder WEB-Server

Im spezifischen Fall des hier vorgestellten Installationsszenario, würden die Anpassungen folgendermaßen aussehen:

Translations Ignore
cp cp -a /home/jtel/shared/hazelcast.xml /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

Démon de démarrage automatique
Le Platform UDP Listener est activé avec les commandes suivantes :
 Translations Ignore

 Code Block
languagebash
titleUDP listener service autostartcd /etc/init.d
chkconfig
systemctl enable jtel-listener systemctl start jtel-listener
 onAls nächstes müssen in der Firewall die Port-Freigaben für den UDP Listener Dienst eingetragen und persistent gespeichert werden

Règles relatives aux pare-feu
Les éléments suivants configurent le pare-feu, afin que les membres de la grappe hazelcast puissent communiquer entre eux :
 Translations Ignore

 Code Block
languagebash
titleConfigure firewall
firewall-cmd --zone=public --add-port=5701-5801/tcp --permanent


 firewall-cmd --reload

Démarrer le Listener
Maintenant, le Listener est lancé 
Nun muss der UDP Listener manuell gestartet werden
 :

 Translations Ignore

 Code Block
languagebash
titleStart UDP Listener
service jtel-listener start
Um die Aktualisierung des USP Listeners zu vereinfachen, wird nun noch ein entsprechendes Skript erstellt

Script de mise à jour
Pour simplifier la mise à jour du Platform UDP Listener, un script est créé :
 Translations Ignore

 Code Block
languagebash
titleCreate 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