Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Content imported from a Scroll Translations translation file.
Caution - Run as rootNote: execute as ROOT.

Sv translation
languageen

Installation of required additional software

Install GIT

Git is required, to checkout the software.

Translations Ignore


Code Block
languagebash
dnf -y install git
su jtel
cd
git config --global user.name "jtel Support"
git config --global user.email "support@jtel.de"


Configure GIT proxy server (optional)

If you need a proxy for GIT:

Translations Ignore


Code Block
languagebash
git config --global http.proxy http://<proxy_server>:<port>


Downloading the jtel software for the first time

Note: for redundant systems, do this on the ACTIVE storage node.

Change to jtel User

The following operations are no longer performed in the context of the root user but must be performed in the context of the jtel user. To do this, you can either log in as user jtel in a separate SSH session or, if you are already logged in as user root, you can switch to the context of the jtel user. This is done with the following command:

Translations Ignore


Code Block
languagebash
su jtel
cd


Clone jtel Software

Next, the jtel Software is cloned. This will be done in 2 steps, as a user name and password is required for each one.

Translations Ignore


Code Block
languagebash
cd /srv/jtel/shared
git clone https://bitbucket.org/jtelgmbh/jtel.git JTEL


Code Block
languagebash
cd /srv/jtel/shared
git clone https://bitbucket.org/jtelgmbh/jtelcarrierportal.git JTELCarrierPortal


Clone Customer Software

If specific software has been programmed for the customer, the customer-specific software repository must also be downloaded. This is done by a command which is structured as follows, for the example customer acme:

Translations Ignore


Code Block
languagebash
titleDownload a custom repository
cd /srv/jtel/shared
git clone https://bitbucket.org/jtelgmbh/cacme-software.git acme


Change to required Software Release

In the downloaded software repositories, the software release to be used must now be selected. In this case it is release 3.20:

Translations Ignore


Code Block
languagebash
titleSelect the desired release
cd /srv/jtel/shared/JTELCarrierPortal
git checkout release/stable-3.2022
cd /srv/jtel/shared/JTEL
git checkout release/stable-3.2022
# For customer specific software only
# cd /srv/jtel/shared/acme
# git checkout develop
cd /srv/jtel/shared


Note, that the customer specific release is usually develop, as customer releases are not branched or tagged when the jtel Software is branched or tagged.

Create Required Directories

The last step is to create the directories for central logging, standard data import and the main data directory:

Translations Ignore


Code Block
languagebash
cd /srv/jtel/shared
mkdir -p LogFiles LogFilesCall Import/{Clients,ServiceNumbers}/{Done,In,Problems}
cp -a JTELCarrierPortal/Data .
cp -a JTEL/Data/system/gui Data/system
cd /srv/jtel/shared/JTELCarrierPortal/Update
bash ./get_binaries.sh


Cleaner processes

A CRON job is used to clean up the directories of the portal. 

With redundancy, configure this on both STORE. Since the directory is only mounted on one, but we don't know which one is active, the command must be executed on both.

Status
colourRed
title
Translations Ignore


Code Block
languagebash
titleCleaner processes in /etc/cron.daily
cat <<EOFF > /etc/cron.daily/jtel_portal_cleaner.sh << EOFF 
find /srv/jtel/shared/Data/clients/*/reports -type f -mtime +2 -delete
EOFF
chmod +x /etc/cron.daily/jtel_portal_cleaner.sh




Installation der Meta-Rolle Software

In einem Standard-Installations-Szenario wird in der Zentral-Freigabe der Rolle STORE auch eine Kopie der Software-Repositories abgelegt. Diese ist demnach von allen Maschinen des jtel Systems erreichbar. Der Zugriff auf die Software-Repositories dient verschiedenen Zwecken:

  1. Alle Maschinen der Rolle TEL können die Telefonie-Applikationen (R5-Skripte) direkt von dieser zentralen Freigabe heraus ausführen. Alternativ können diese Komponenten der Software auch von der zentralen Freigabe lokal auf die Windows-Maschinen kopiert werden um den Netzwerkverkehr im laufenden Betrieb zu reduzieren. Dies erfordert allerdings zusätzliche Sorgfalt beim aktualisieren des Systems, da in diesem Fall nach dem Aktualisieren des Repositories die entsprechenden Verzeichnisse mit den R5-Skripten auf allen Windows-Maschinen kopiert werden müssen.
  2. Im Falle der Erstinstallation oder späteren Aktualisierungen, werden von hier die Datenbank-Initialisierungs- bzw. Datenbank-Aktualisierung-Skripte ausgeführt.
  3. Weitere Software-Komponenten die auf verschiedenen Maschinen lokal installiert werden (z.B. Konnektoren, Plugins, UDP Listener) werden von hier kopiert und aktualisiert

Installation benötigter Zusatzsoftware

Hinweis: bei Redundante Systeme, dies auf BEIDE Storage Nodes ausführen.

Für die Bereitstellung und Aktualisierung des jtel Software-Repositories muss zusätzliche Software installiert werden. Da diese nicht nur aus den offiziellen CentOS Paketquellen bezogen werden kann, müssen noch weitere Software-Quellen konfiguriert werden:

yum -y install https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm

Sv translation
languagede
toc

Status

maxLevel

colour

2

Red

printablefalse
Translations Ignore
Code Block
languagebash
titleInstall additional software sources - MySQL 8.x.
titleThis page is only available in English

Sv translation
languagefr

Installation des logiciels supplémentaires nécessaires

Installer GIT

Il est nécessaire d'avoir un Git pour vérifier le logiciel.

Translations Ignore


Code Block
languagebash
titleInstall additional software sources - MySQL 5.6
yumdnf -y install http://dev.mysql.com/get/mysql-community-release-el6-5.noarch.rpm

Anschließend kann die benötigte Software installiert und konfiguriert werden. Die Konfiguration erfolgt unter den User jtel.

Translations Ignore
Code Block
languagebash
titleInstall and configure GIT
yum -y install git2u mysql-community-client
git su jtel
 cd
 git config --global user.name "jtel Support"
 git config --global user.email "support@jtel.de"


Configurer le serveur proxy GIT (facultatif)

Si vous avez besoin d'une procuration pour le TIG Wenn man ein Proxy für GIT braucht :

Translations Ignore


Code Block
title
languagebashProxy for GIT
git config --global http.proxy http://<proxy_server>:<port>

Erstmaliges Herunterladen der jtel Software

Hinweis: bei Redundante Systeme, dies auf den AKTIVEN Storage Nodes ausführen.


Téléchargement du logiciel jtel pour la première fois

Note : pour les systèmes redondants, faites-le sur le nœud de stockage ACTIF.

Passage à l'utilisateur jtel

Les opérations suivantes ne sont plus effectuées en étant utilisateur root mais doit être exécuté en étant utilisateur jtel. Pour ce faire, vous pouvez soit vous connecter en tant qu'utilisateur jtel dans une session SSH distincte ou, si vous êtes déjà connecté en tant qu'utilisateur root,vous pouvez basculer vers le contexte de l'utilisateur jtel. Cela se fait avec la commande suivante Die folgenden Operationen erfolgen nicht mehr im Kontext des Benutzers root sondern müssen im Kontext des Benutzers jtel ausgeführt werden. Dafür kann man sich entweder in einer separaten SSH Sitzung als Benutzer jtel anmelden oder, wenn man bereits als Benutzer root angemeldet ist, in den Kontext des Benutzers jtel wechseln. Dies erfolgt durch folgenden Befehl :

Translations Ignore


Code Block
languagebashtitleChange user context
su jtel
 cd

Nach Eingabe dieser Befehle erkennt man den Benutzerwechsel am Systemprompt, welches nun [jtel@acd-lb ~]$ lautet (Das Systemprompt setzt sich zusammen aus benutzername@hostname aktuelles Verzeichnis) Als nächstes werden nun die beiden Software-Repositories mit der jtel Standardsoftware heruntergeladen.

Dies erfolgt durch Eingabe folgender Befehle:

Translations Ignore
Info
titleNew Repository Locations


Cloner le logiciel jtel

Ensuite, le logiciel jtel est cloné. Cela se fera en deux étapes, puisqu'un nom d'utilisateur et un mot de passe sont nécessaires pour chacune d'entre elles.

Achtung: neue Repository URLs - siehe hier: New Repository Locations

Translations Ignore


Code Block
languagebashtitleDownload the development repositories
cd /homesrv/jtel/shared
 git clone https://bitbucket.org/jtelgmbh/jtel.git JTEL


Code Block
languagebash
cd /srv/jtel/shared 
git clone https://bitbucket.org/jtelgmbh/jtelcarrierportal.git JTELCarrierPortal
Im Falle dass für den Kunden noch spezifische Anpassungen oder Erweiterungen programmiert wurden, muss zusätzlich das Kundenspezifische Software-Repository heruntergeladen werden. Dies erfolgt exemplarisch durch einen Befehl der folgendermaßen aufgebaut ist


Cloner le logiciel client

Si un logiciel spécifique a été programmé pour le client, le dépôt de logiciels spécifiques au client doit également être téléchargé. Cela se fait par une commande qui est structurée comme suit, pour l'exemple acme client :

Translations Ignore


Code Block
languagebash
titleDownload a custom repositoryTélécharger un dépôt personnalisé
cd /homesrv/jtel/shared
 git clone https://bitbucket.org/jtelgmbh/cacme/-software.git acme

Sowohl die Ursprungs-URL als auch das Zielverzeichnis sind in diesem Fall kundenspezifisch und von Fall zu Fall verschieden.

In den Heruntergeladenen Software-Repositories muss nun noch das beim Kunden zu installierende Software-Release ausgewählt werden. In diesem Fall ist es das Release 3.14


Modification de la version du logiciel requise

Dans les dépôts de logiciels téléchargés, il faut maintenant sélectionner la version du logiciel à utiliser. Dans ce cas, il s'agit de la version 3.20 :

Translations Ignore


Code Block
languagebash
titleSelect the desired Sélectionnez la release souhaitée
cd /homesrv/jtel/shared/JTELCarrierPortal
 git checkout release/stable-3.18
22 cd /homesrv/jtel/shared/JTEL
 git checkout release/stable-3.18
22 # For customer specific software only # cd /srv/jtel/shared/acme # git checkout develop cd /homesrv/jtel/shared


Il est à noter que la version spécifique au client est généralement développée, car les versions clients ne sont pas branchées ou étiquetées lorsque le logiciel jtel est branché ou étiqueté.

Créer les répertoires nécessaires

La dernière étape consiste à créer les répertoires pour l'enregistrement central, l'importation de données standard et le répertoire de données principal Als letzter Schritt werden nun noch die Verzeichnisse für die zentrale Protokollierung, den Standard-Datenimport und das zentrale Datenverzeichnis angelegt :

Translations Ignore


Code Block
languagebashtitlePrepare data directories
cd /homesrv/jtel/shared
 mkdir -p LogFiles LogFilesCall Import/{Clients,ServiceNumbers}/{Done,In,Problems}
 cp -a JTELCarrierPortal/Data .
 cp -a JTEL/Data/system/gui Data/system
 cd /homesrv/jtel/shared/JTELCarrierPortal/Update
 bash ./get_binaries.sh

Cleaner Prozesse

Damit die Verzeichnisse des Portals aufgeräumt werden, wird ein CRON Job benötigt. 

Bei Redundanz, auf beide STORE. Da das Verzeichnis nur auf einer gemountet ist, aber wir wissen nicht welche, muss der Befehl auf beide ausgeführt werden.


Des processus plus propres

Un travail de CRON est nécessaire pour nettoyer les répertoires du portail. 

En cas de redondance, configurez-le sur les deux MAGASINS. Comme le répertoire n'est monté que sur un seul, mais que nous ne savons pas lequel est actif, la commande doit être exécutée sur les deux.

Achtung: als Note : exécuter en tant que ROOT.

Translations Ignore


Code Block
languagebash
titleCleaner processes in Des processus plus propres dans /etc/cron.daily
cat <<EOFF > /etc/cron.daily/jtel_portal_cleaner.sh
 << EOFF find /srv/jtel/shared/Data/clients/*/reports -type f -mtime +2 -delete
 EOFF
 chmod +x /etc/cron.daily/jtel_portal_cleaner.sh