Voraussetzung

Requirement

The system must first be updated to a version with Das System muss vorher auf eine Version mit MySQL 8.x geupdatet werden (Release 3.15 bis to 3.17).

Vorbereitung für die Aktualisierung

Preparation for the update

With every update there is a golden rule that must be strictly followed regardless of the customer's wishesBei jeder Aktualisierung gibt es eine goldene Regel, die unabhängig von den Wünschen des Kunden strikt befolgt werden muss:

Authoritative Share Bestimmen

Bei manchen Installationen, ist das File-Share auf ein System, der vom Kunden bereitgestellt wird.

In diesen Fall erfolgt das Checkout der Repositories lokal auf den Load-Balancer auf den Non-Authoritative Share, die Dateien werden aber später auf den "Authoritative" File-Share kopiert.

Determine Authoritative Share 

In some installations, the file share is on a system provided by the customer.

In this case, the repositories are checked out locally to the load balancer on the non-authoritative share, but the files are later copied to the "authoritative" file share.

After changes should be checked for the Authoritative File-ShareNach Änderungen sollte auf den Authoritative File-Share geprüft werden.

Authoritative File-Share

Dieser ist This is /home/jtel/shared

Non-Authoritative File-Share

Dieser ist This is /srv/jtel/shared

Determine if Authoritative

Wenn If /home/jtel/shared auf den Load-Balancer von einem Fremdsystem gemountet ist, dann ist es in der Regel nicht authoritative.is mounted on the load balancer from a third-party system, it is usually not authoritative.

You can easily determine this by creating a file on Dies kann man einfach bestimmen, indem man eine Datei auf /srv/jtel/shared erzeugt. Erscheint dies nicht shared. If this does not appear in /home/jtel/shared, so ist then /srv/jtel/shared nicht is not authoritative.

Datensicherung

Es sollte unbedingt eine Datensicherung angefertigt werden. Das MINIMUM ist dass die Datenbank gesichert wird, und das Datenverzeichnis gesichert wird, dies sollte jedoch nur die Notlösung sein.

Besser ist ein Snapshot aller beteiligten virtuellen Maschinen, im Kaltzustand (heruntergefahren).

Die Gefahr besteht, dass wenn ein Snapshot im laufenden Betrieb gezogen wird (insbesondere der Datenbankmaschinen), dass dieser nicht konsistent ist.

Data backup

A data backup should unconditionally be made. The MINIMUM is that the database is backed up and the data directory is backed up, but this should only be a stopgap solution.

Better is a snapshot of all virtual machines involved, in cold state (shut down).

There is a risk that if a snapshot is taken during operation (especially of the database machines), it may not be consistent.

Manual backup

Dienste Stoppen

service jboss stop

service wildfly stop

service jtel-listener stop

service jtel-

clientmessenger stop

Backup database (

on DB

master)

Enter the corresponding password at <password>:

su jtel
cd
mkdir -p /home/jtel/shared/Backup
mysqldump -u root -p<password> --add-drop-database --add-drop-table --events --routines --triggers --databases JTELWeb JTELStats JTELStats2 JTELLog | gzip > /home/jtel/shared/Backup/backup-$(hostname -s)-database-$(date +%F-%H%M%S).sql.gz

Backup Data

Dies kann über den Windows Explorer oder ein entsprechender cp Befehl auf den Linux erfolgen.

Directory

This can be done via the Windows Explorer or a corresponding cp command on the Linux.

Remember GIT status (Authoritative Share)

From the load balancer, check the GIT status:

cd /home/jtel/shared/JTEL
git status
git rev-parse HEAD
(

save 

output)
 
cd /home/jtel/shared/JTELCarrierPortal
git status
git rev-parse HEAD
(

save 

output)
 
# 

IF 

A 

custom 

directory 

exists
 
cd /home/jtel/shared/Customer_Directory
git status
git rev-parse HEAD
(

save 

Snapshot Sicherung

Dies erfolgt über die VMWare Konsole, oder Hyper-V Konsole. Dies wird üblicherweise durch den Kunden durchgeführt.

Bestätigung

Rücksicherung

Snapshots

Die Snapshots werden alle wieder aktiviert, und hochgefahren. Es sollte ein normaler Betrieb mit den alten Software-Stand herrschen.

Manuelle Rücksicherung

output)

Snapshot Backup

This is done via the VMWare console, or Hyper-V console. This is usually done by the customer.

Confirmation

Restore

Snapshots

The snapshots are all reactivated and booted. There should be normal operation with the old software.

Manual Restoration

With all services stopped, restore the database. Enter the corresponding password at <password>:

cp /home/jtel/shared/Backup/backup-acd-dbm-database-2016-06-30-293211.sql.gz .
gunzip backup-acd-dbm-database-2016-06-30-293211.sql.gz
mysql -u root -p<password> -e"backup-acd-dbm-database-2016-06-30-293211.sql"

Parallel dazu, kann das alte Data Verzeichnis zurückgespielt werden.

In parallel, the old data directory can be restored.

Further steps may be necessary (restore GIT repositories, restore 8 servers, ...) depending on which components were affected by the updateGgf. sind weitere Schritte erforderlich (GIT Repositories zurücksichern, 8-Server zurücksichern, ...) je nach dem welche Komponenten beim Update betroffen waren.

Die Aktualisierung des Systems

Es sei hier noch mal erwähnt: alle jtel-Dienste des Systems müssen herunter gefahren sein. 

Danach kann mit der Aktualisierung begonnen werden. Die Schritte erfolgen in der hier dokumentierten Reihenfolge

Aktualisierung der Software auf dem STORE

The updating of the system

It should be mentioned again: all jtel services of the system must be shut down. 

After that the update can be started. The steps are performed in the order documented here

Updating the software on the STORE

This step must be performed as user "jtel"Dieser Schritt muss als Benutzer "jtel" erfolgen.

Prüfung ob Änderungen / Patches vorhanden sind

Check if changes / patches are available

Before updating the software, you should check whether files in the respective directory have been changedBevor die Software aktualisiert wird, sollte noch geprüft werden, ob im jeweiligen Verzeichnis Dateien geändert wurden.

Here is an example based on the software directory JTELCarrierPortal

su jtel
cd /home/jtel/shared/JTELCarrierPortal
git status
git rev-parse HEAD
exit

If this indicates that files have been modified, caution is advised.

The project engineer must first check whether the changes are local bug fixes that have been incorporated into the release. If this is the case, the changes can be deleted before updating. If this is not done, the update may fail!

su jtel
cd /home/jtel/shared/JTELCarrierPortal
git checkout -- .
exit

Eine allgemeine Vorgehensweise kann in einem solchen Fall aber nicht beschrieben werden. Hier muss von Fall zu Fall geprüft werden, wie vorgegangen wird.

However, a general procedure cannot be described in such a case. In this case, the procedure must be checked on a case-by-case basis.

If file mode changes should be ignored, the following command can be used:

git config core.fileMode false

Aktualisierung der Repositories (Immer auf Non-Authoritative Share)

Updating the repositories (always on non-authoritative share)

The following command sequence updates all software directories to the latest version of the respective chosen release.

su jtel
cd /srv/jtel/shared/JTELCarrierPortal
git pull
cd /srv/jtel/shared/JTEL
git pull
cd /srv/jtel/shared/Customer_Directory
git pull
exit

Falls Fehler beim GIT auftreten, beispielsweiseIf errors occur in GIT, for example:

Merge-Konflikt Conflict in (Dateinamefile name)

Oder

fatal: Verweigere den Merge von nicht zusammenhängenden Historien.Deny the merge of unrelated histories.

the local repository must be reset. This can be done as follows (example for muss das lokale Repository resettet werden. Dies kann wie folgt (Beispiel für stable-3.18 auf on JTELCarrierPortal) geschehen:

su jtel
cd /srv/jtel/shared/JTELCarrierPortal
git reset --hard origin/release/stable-3.18

Auschecken des gewünschten Releases

Checking out the desired release

After the GIT PULL is done, the corresponding release must be checked out if a release other than git status is desired.

su jtel
cd /srv/jtel/shared/JTELCarrierPortal
git checkout release/stable-3.18
cd /srv/jtel/shared/JTEL
git checkout release/stable-3.18
cd /srv/jtel/shared/Customer_Directory
git checkout release/stable-3.18
exit

git fetch --unshallow

git config remote.origin.fetch "+refs/heads/*:refs/remotes/origin/*"

git fetch origin

Copy files to Authoritative Share

Only if there is an Nur wenn es ein Authoritative / Non-Authoritative share gibt.

Dies geschieht mit folgender Skript

This is done with the following script

Komplettaktualisierung

Translations Ignore
Code Block language bash title	Complete update cd /srv/jtel/shared/JTELCarrierPortal/ bash update_fileshare.sh

Aktualisierungsskripte laufen lassen

Run update scripts

The following update script makes all necessary changes. This is executed as root or jtel with sudo. Here with jtel user:

cd /home/jtel/shared/JTELCarrierPortal/Update
sudo ./update_release.sh

Ggf. wird man zuerst nach den sudo Passwort gefragt. 

Das Skript fragt nach den entsprechenden Master Datenbank, Benutzer, Passwort, und Name des Kundenverzeichnisses indem ggf. spezifische Software für den Kunden liegt.

You may be asked for the sudo password first. 

The script asks for the corresponding master database, user, password, and name of the customer directory where specific software for the customer may be located.

The questions can be answered, usually with the following answers, knowledge of <password> for the database assumedDie Fragen können, in der Regel mit folgende Antworten beantwortet werden, Kenntnis von <password> für die Datenbank vorausgesetzt:

• mysql host address: acd-dbm
• mysql user name: root
• mysql password: <password>
• customer directory:

Falls kein Customer Directory vorhanden ist, kann dies leer gelassen werden. Das Vorhandensein von Kundenspezifische Software kann mit If there is no customer directory, this can be left empty. The presence of custom software can be checked with ls /home/jtel/shared geprüft werden - dort die Namen der Verzeichnisse anschauen. Nur den Namen des Verzeichnisses angeben! Beispielsweise acme - there you can see the names of the directories. Enter only the name of the directory! For example acme

The update is then carried outAnschließend wird das Update durchgeführt.

Binaries Herunterladen

Die Binaries werden mit folgenden Befehl heruntergeladen:

Download Binaries

The binaries are downloaded with the following command:

cd /home/jtel/shared/JTELCarrierPortal/Update
su jtel
bash get_binaries.sh

Update of the Platform UDP

Listener

Master

Databases

Bei Release With release 3.18 und höherand higher, wird Java 8 verwendetis used. Das The (vorhandeneexisting) Java 7 muss deinstalliert werden, und Java 8 wird installiert.Wir verwenden den openjdk, sodass es unter Linux Updatefähig bleibt.must be uninstalled and Java 8 will be installed.

We use the openjdk so that it remains updateable under Linux.

service jtel-listener stop
yum -y remove jdk.x86_64
yum -y install https://cdn.jtel.de/downloads/java/jdk-8u202-linux-x64.rpm

The update of the Platform UDP Listener must be executed as user "root" and is performed on the master databases by entering the following command:

updatepl.sh

Dieser Befehl aktualisiert den Listener und startet ihn. Der Erfolg kann durch Sichtung der Datei This command updates the listener and starts it. The success can be checked by viewing the file /home/jtel/PlatformUDPlistener/log/listener.log geprüft werden.

Telefonieservern

Telephony servers

Here you have to check if Java 8 is installed. If necessary, download Java 8 from one of the sources here (these are BCL licensed versions, i.e. license-freeHier ist zu prüfen ob Java 8 installiert ist. Ggf. Java 8 von einer der Quellen hier herunterladen (dies sind BCL lizenzierte Versionen, also Lizenzfrei):

• https://www.oracle.com/technetwork/java/javase/downloads/java-archive-javase8-2177648.html
• https://cdn.jtel.de/downloads/java/jdk-8u202-windows-x64.exe

Das Start-Skript für den Platform-Listener kopiert die neue Version des Listeners selbstThe start script for the platform listener copies the new version of the listener itself.

Aktualisierung der WEB Server

Der JBOSS Server wird komplett ersetzt durch ein Wildfly Server.

Hazelcast Konfiguration sichern

Falls keine Sicherung bereits vorhanden:

Updating the WEB servers

The JBOSS server is completely replaced by a Wildfly server.

Backup Hazelcast configuration

If no backup already exists:

cp /home/jtel/jboss-as-7.1.1.FINAL/standalone/configuration/hazelcast.xml /home/jtel/shared

Uninstalling JBOSS Server

and Java 7

Als As root:

Translations Ignore
Code Block service jboss stop yum -y remove jdk.x86_64 cd /home/jtel chkconfig jboss off rm -f /etc/init.d/jboss rm -f /etc/cron.daily/jboss-logmaint.sh rm -f /etc/cron.daily/jboss-restart.sh rm -f /usr/local/bin/updatejb.sh rm -Rf jboss-as-7.1.1.FINAL

Install Java 8

and Wildfly

yum -y install https://cdn.jtel.de/downloads/java/jdk-8u202-linux-x64.rpm
wget http://cdn.jtel.de/downloads/jboss/wildfly-18.0.1.Final.

05.tar.gz
tar xzf wildfly-18.0.1.Final.

05.tar.gz
rm -f wildfly-18.0.1.Final.

05.tar.gz
mkdir -p wildfly-18.0.1.Final/standalone/deployments
chown -R jtel:jtel wildfly-18.0.1.Final
mkdir -p /home/jtel/upload
chown -R jtel:jtel /home/jtel/upload
ln -s /home/jtel/wildfly-18.0.1.Final wildfly-current

cp /home/jtel/wildfly-current/init.d/wildfly /etc/init.d/wildfly
ln -s /home/jtel/wildfly-current/default/wildfly /etc/default/wildfly
cd /etc/cron.daily
ln -s /home/jtel/wildfly-current/bin/jboss-logmaint.sh
ln -s /home/jtel/wildfly-current/bin/jboss-restart.sh
cd /usr/local/bin
ln -s /home/jtel/wildfly-current/bin/updatejb.sh
chkconfig wildfly on

Configure Wildfly

Die The hazelcast.xml muss kopiert werden, und die Standardeinstellungen für die Datenbank müssen angepasst werden.Im folgenden <password> bitte entsprechend ersetzen:must be copied and the default settings for the database must be adjusted.

In the following replace <password> please accordingly:

Translations Ignore

Code Block DBPRI=acd-dbm DBSTA=acd-dbs DBREP=acd-dbr DBPWD=<password> sed -i -e "s/DATA_PRIMARY/${DBPRI}/g" -e "s/DATA_STATS/${DBSTA}/g" -e "s/DATA_REPORTS/${DBREP}/g" -e "s/DB_PASSWORD/${DBPWD}/g" /home/jtel/wildfly-current/standalone/configuration/standalone.xml unset DBPWD unset DBREP unset DBSTA unset DBPRI cp /home/jtel/shared/hazelcast.xml /home/jtel/wildfly-current/standalone/configuration/

Aktualisierung der Portalsoftware

Die Aktualisierung der Portalsoftware muss als Benutzer "root" auf dem Webserver ausgeführt werden und erfolgt durch Eingabe folgendem Befehls:

Updating the portal software

The update of the portal software must be executed as user "root" on the web server and is done by entering the following command:

updatejb.sh

Dieser Befehl aktualisiert die Portalsoftware und startet den wildfly Server. Der Erfolg kann durch Sichtung der Datei This command updates the portal software and starts the wildfly server. The success can be checked by viewing the file /home/jtel/wildfly-current/standalone/log/server.log geprüft werden.

 Dort sollten in der Log-Datei folgende Einträge zu sehen sein, wenn die Aktualisierung erfolgreich war:

Image Removed

Aktualisierung des 8Servers

Die Aktualisierung des 8Server erfolgt im Windows-Explorer mittels GIT. Hierfür wird mit einem Rechtsklick auf das Verzeichnis C:\8Server\deploy ein GIT Pull durchgeführt, und auf das gewünschte Version nach dem Pull gewechselt.

Möchte man nicht auf die letzte Version, sondern auf eine spezifische Version aktualisieren, erfolgt dies Über "git checkout" mit Angabe des Releases.

Nach dem Aktualisieren, muss die Version dann installiert werden. Bei einem Daemon-Server erfolgt dies mit dem Befehl:

C:
cd \8Server\Install
copy_keyfile_en_daemon.cmd

Bei einem Telefonie-Server mit Aculab Media Service erfolgt dies mit folgendem Befehl:

C:
cd \8Server\Install
copy_keyfile_en_mcp.cmd

Im Anschluss kann der 8Server gestartet werden.

Aktualisierung der Konnektoren

Grundsätzlich gilt: die entsprechenden Dateien aus dem Software-Verzeichnis im STORE müssen ins Zielverzeichnis kopiert werden.

Diese kommen in der Regel aus dem Bereich JTELCarrierPortal/WebServices/Install

Abschließende Arbeiten

Ist die Aktualisierung beendet und die Anlage ohne Fehler wieder hochgefahren, sind folgende Aufgaben zwingend auszuführen:

• Anmelden ans Portal. Kurzer Test um zu sehen, dass auch Agenten und Supervisoren zu sehen bekommen, was sie erwarten.
• Testanruf! Idealerweise gibt es eine Testnummer. Falls nicht, eine der regulären Servicerufnummern anrufen. Prüfen, dass der 8Server korrekt antwortet.
  • Testanruf mit beobachtung des Portals.
    Als User anmelden, und schauen ob ein Anruf im Portal korrekt angezeigt wird, wenn es dem Agenten zugestellt wird.

 There you should see the following entries in the log file if the update was successful:

Image Added

Updating Client Messenger

If Chat Server is installed.

For  jtel portal versions >= 3.25, make sure to edit systemd and/or init.d:

If you are using init.d:

vi /home/jtel/ClientMessenger/init.d/jtel-clientmessenger

# make sure this line exists
-Djava.net.preferIPv4Stack=true \

# make sure this line contains \&serverTimezone=Europe/Berlin
-Dde.jtel.platform.clientmessenger.connection=jdbc:mysql://acd-dbm/JTELWeb?user=root\&password=<password>\&characterEncoding=utf8\&serverTimezone=Europe/Berlin \

# copy to etc
cp /home/jtel/ClientMessenger/init.d/jtel-clientmessenger /etc/init.d/
chmod 755 /etc/init.d/jtel-clientmessenger 

If you are using systemd:

vi /home/jtel/ClientMessenger/systemd/jtel-clientmessenger.service  

# make sure this line exists
-Djava.net.preferIPv4Stack=true \

# make sure this line contains &serverTimezone=Europe/Berlin
-Dde.jtel.platform.clientmessenger.connection=jdbc:mysql://acd-dbm/JTELWeb?user=root&password=<Password>&characterEncoding=utf8&serverTimezone=Europe/Berlin \

# copy to systemd
cp /home/jtel/ClientMessenger/systemd/jtel-clientmessenger.service /etc/systemd/system/jtel-clientmessenger.service
systemctl daemon-reload

Then update:

updatesc.sh

Update of the 8Server

The 8Server is updated in Windows Explorer using GIT. To do this, right-click on the directory C:\8Server\deploy to perform a GIT pull and switch to the desired version after the pull.

If you do not want to update to the last version, but to a specific version, you can do this via "git checkout", by indicating the release.

After updating, the version must then be installed. For a daemon server, this is done with the command:

C:
cd \8Server\Install
copy_keyfile_en_daemon.cmd

For a telephony server with Aculab Media Service, this is done with the following command:

C:
cd \8Server\Install
copy_keyfile_en_mcp.cmd

Afterwards the 8Server can be started.

Updating the connectors

Basically: the corresponding files from the software directory in the STORE must be copied into the target directory.

These usually come from JTELCarrierPortal/WebServices/Install

Final work

Once the update has been completed and the system restarted without errors, the following tasks must be performed:

• Login to the portal. Short test to see that agents and supervisors also get to see what they expect.
• Test call! Ideally there is a test number. If not, call one of the regular service numbers. Check that the 8Server answers correctly.
  
  • Test call with observation of the portal.
    Log in as a user, and see if a call is displayed correctly in the portal when it is delivered to the agent.