Versions Compared

Key

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

Table of Contents
maxLevel2
printablefalse

Installing the Meta-Role Software

In a standard installation scenario, a copy of the software repositories is also stored in the central share of the STORE role. This is therefore accessible from all machines of the jtel system. Access to the software repositories serves various purposes:

  1. All machines in the TEL role can execute the telephony applications (R5 scripts) directly from this central share. Alternatively, these components of the software can also be copied locally from the central share to the Windows machines to reduce network traffic during operation. However, this requires additional care when updating the system, since in this case, after updating the repository, the corresponding directories with the R5 scripts must be copied on all Windows machines.
  2. In case of initial installation or later updates, the database initialization or database update scripts are executed from here.
  3. Additional software components that are installed locally on different machines (e.g. connectors, plugins, UDP listener) are copied and updated from here

Installation of required additional software

Note: for redundant systems, do this on BOTH storage nodes.

Additional software must be installed to provide and update the jtel software repository. Since this can not only be obtained from the official CentOS package sources, other software sources must be configured:

Translations Ignore


Code Block
languagebash
titleInstall additional software sources - MySQL 8.x.
yum -y install https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm



Translations Ignore


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



The required software can then be installed and configured. The configuration is done under the user jtel.

Translations Ignore


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




If you need a proxy for GIT:

Translations Ignore


Code Block
languagebash
titleProxy for GIT
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 nodes.

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
titleChange user context
su jtel
cd



After entering these commands you can recognize the user change at the system prompt, which is now [jtel@acd-lb ~]$ (the system prompt consists of username@hostname current directory) The next step is to download the two software repositories with the jtel standard software.

This is done by entering the following commands:

Translations Ignore


Info
titleNew Repository Locations

Attention: new repository URLs - see here: New Repository Locations



Translations Ignore


Code Block
languagebash
titleDownload the development repositories
cd /srv/jtel/shared
git clone https://bitbucket.org/jtelgmbh/jtel.git JTEL
git clone https://bitbucket.org/jtelgmbh/jtelcarrierportal.git JTELCarrierPortal




In the event that specific adaptations or extensions have been programmed for the customer, the customer-specific software repository must also be downloaded. This is done exemplarily by a command which is structured as follows:

Translations Ignore


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



Both the source URL and the target directory are customer-specific in this case and differ from case to case.

In the downloaded software repositories, the software release to be installed at the customer must now be selected. In this case it is release 3.14:

Translations Ignore


Code Block
languagebash
titleSelect the desired release
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




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

Translations Ignore


Code Block
languagebash
titlePrepare data directories
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 required to clean up the directories of the portal. 

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

Caution: as ROOT.

Translations Ignore


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




Installieren zusätzlicher Softwarequellen
Sv translation
languagede

Table of Contents
maxLevel2
printablefalse

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:

Translations Ignore


Code Block
languagebash
title
Install additional software sources - MySQL 8.x.
yum -y install 
http
https://dev.mysql.com/get/
mysql
mysql80-community-release-
el6
el7-
5
3.noarch.rpm



Translations Ignore


Code Block
languagebash
titleInstall additional software sources - MySQL 5.6
yum -y install http://
mirror1
dev.
hs-esslingen
mysql.
de
com/
repoforge/redhat/el6/en/x86_64/rpmforge/RPMS/rpmforge-release-0.5.3-1.el6.rf.x86_64.rpm yum -y install yum-utils yum-config-manager --enable rpmforge-extras
get/mysql-community-release-el6-5.noarch.rpm



Anschließend kann die benötigte Software installiert und konfiguriert werden

...

installieren und konfigurieren für Benutzerkontext wechselnHerunterladen der Entwicklungs-RepositoriesHerunterladen eines kundenspezifischen Repositories

. Die Konfiguration erfolgt unter den User jtel.

Translations Ignore


Code Block
languagebash
titleInstall and configure GIT
yum -y install 
git
git2u mysql-community-client
su jtel
cd
git config --global user.name "jtel Support"
git config --global user.email "support@jtel.de"
cp ~/.gitconfig /home/jtel chown jtel:jtel /home/jtel/.gitconfig




Wenn man ein Proxy für GIT braucht:

Translations Ignore


Code Block
languagebash
titleProxy
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.

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
languagebash
title
Change 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

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



Translations Ignore


Code Block
languagebash
title
Download the development repositories
cd /home/jtel/shared
git clone https://
git
bitbucket.
jtel.de/scm/jtel
org/jtelgmbh/jtel.git JTEL
git clone https://
git
bitbucket.
jtel.de
org/
scm/jtel/carrierportal_jtel
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:

Translations Ignore


Code Block
languagebash
title
Download a custom repository
cd /home/jtel/shared
git clone https://
git
bitbucket.
jtel.de
org/
scm
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.

...

Gewünschtes Release auswählenDatenverzeichnisse vorbereiten Prozesse

14:

Translations Ignore


Code Block
languagebash
title
Select the desired release
cd /home/jtel/shared/JTELCarrierPortal
git checkout release/stable-3.
11
18
cd /home/jtel/shared/JTEL
git checkout release/stable-3.
11
18
cd /home/jtel/shared




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
languagebash
title
Prepare data directories
cd /home/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 /home/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.

Achtung: als ROOT.

Translations Ignore


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




Sv translation
languagefr

Table of Contents
maxLevel2

| xargs rm EOFF

printablefalse

Installation du logiciel Meta-Role

Dans un scénario d'installation standard, une copie des dépôts de logiciels est également stockée dans la partie centrale du rôle MAGASIN. Il est donc accessible à partir de toutes les machines du système jtel. L'accès aux dépôts de logiciels répond à plusieurs objectifs :

  1. Toutes les machines du rôle TEL peut exécuter les applications de téléphonie (scripts R5) directement à partir de cette part centrale. Alternativement, ces composants du logiciel peuvent également être copiés localement depuis le partage central vers les machines Windows afin de réduire le trafic réseau pendant le fonctionnement. Toutefois, cela nécessite une attention supplémentaire lors de la mise à jour du système, car dans ce cas, après la mise à jour du référentiel, les répertoires correspondants avec les scripts R5 doivent être copiés sur toutes les machines Windows.
  2. En cas d'installation initiale ou de mises à jour ultérieures, les scripts d'initialisation ou de mise à jour de la base de données sont exécutés à partir d'ici.
  3. Les composants logiciels supplémentaires qui sont installés localement sur différentes machines (par exemple les connecteurs, les plugins, l'auditeur UDP) sont copiés et mis à jour à partir d'ici

Installation des logiciels supplémentaires nécessaires

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

Des logiciels supplémentaires doivent être installés pour fournir et mettre à jour le dépôt de logiciels de jtel. Comme celui-ci ne peut pas être obtenu uniquement à partir des sources officielles du progiciel CentOS, d'autres sources logicielles doivent être configurées :

Translations Ignore


Code Block
languagebash
titleInstaller des sources logicielles supplémentaires - MySQL 8.x.
yum -y install https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm



Translations Ignore


Code Block
languagebash
titleInstaller des sources logicielles supplémentaires - MySQL 5.6
yum -y install http://dev.mysql.com/get/mysql-community-release-el6-5.noarch.rpm



Le logiciel requis peut alors être installé et configuré. La configuration se fait sous l'utilisateur jtel.

Translations Ignore


Code Block
languagebash
titleInstaller et configurer le GIT
yum -y install git222 mysql-community-client su jtel cd git config --global user.name "jtel Support" git config --global user.email "support@jtel.de"




Si vous avez besoin d'une procuration pour le TIG :

Translations Ignore


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



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

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

Les opérations suivantes ne sont plus effectuées dans le cadre de l'utilisateur root mais doit être effectuée dans le cadre de l'utilisateur jtel. Pour ce faire, vous pouvez soit vous connecter en tant qu'utilisateur jtel dans une session SSH séparée, soit, si vous êtes déjà connecté en tant qu'utilisateur root, vous pouvez passer au contexte de l'utilisateur jtel. Cela se fait avec la commande suivante :

Translations Ignore


Code Block
languagebash
titleChanger context utilisateur
su jtel cd



Après avoir entré ces commandes, vous pouvez reconnaître le changement d'utilisateur à l'invite du système, qui est maintenant [jtel@acd-lb ~]$ (l'invite du système se compose du répertoire actuel de username@hostname) L'étape suivante consiste à télécharger les deux dépôts de logiciels avec le logiciel standard de jtel.

Cela se fait en entrant les commandes suivantes :

Translations Ignore


Info
titleNouveaux lieux de dépôt

Attention : nouvelles URL de dépôt - voir ici : New Repository Locations



Translations Ignore


Code Block
languagebash
titleTélécharger les dépôts de développement
cd /srv/jtel/shared git clone https://bitbucket.org/jtelgmbh/jtel.git JTEL git clone https://bitbucket.org/jtelgmbh/jtelcarrierportal.git JTELCarrierPortal




Dans le cas où des adaptations ou des extensions spécifiques ont été programmées pour le client, le dépôt de logiciels spécifiques au client doit également être téléchargé. Ceci est fait de manière exemplaire par une commande qui est structurée comme suit :

Translations Ignore


Code Block
languagebash
titleTélécharger un dépôt personnalisé
cd /srv/jtel/shared git clone https://bitbucket.org/jtelgmbh/cacme/software.git acme



Dans ce cas, l'URL source et le répertoire cible sont tous deux spécifiques au client et diffèrent d'un cas à l'autre.

Dans les dépôts de logiciels téléchargés, il faut maintenant sélectionner la version du logiciel à installer chez le client. Dans ce cas, il s'agit de la release 3.14 :

Translations Ignore


Code Block
languagebash
titleSélectionnez la release souhaitée
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




La dernière étape consiste à créer les répertoires pour l'enregistrement central, l'importation de données standard et le répertoire central de données :

Translations Ignore


Code Block
languagebash
titlePréparer des répertoires de données
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



Des processus plus propres

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

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

Attention : en tant que ROOT.

Translations Ignore


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