Versions Compared

Old Version 11

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: Removed translated content for 'fr'
Sv translation
languageen

Table of Contents
maxLevel3
printablefalse

Initial setup of the system data

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. 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 user jtel. 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-db1 ~]$ (The system prompt consists of username@hostname current directory)

In principle, the initial setup of the system data can be done from any Linux machine, because every machine has access to the database scripts and has a MySQL client. For performance reasons, however, it is advisable to perform this operation on the primary DATA server, as this way the network load is lowest and the initial setup is quick.


Note
titleATTENTION

If this operation is to be performed from another machine, it is essential that the primary DATA server is specified as the target server. The following example assumes that the operation is performed on the primary DATA server, so the target server is localhost.

The initial setup of the database is done with the following commands:

Translations Ignore


Code Block
languagebash
titleInitial setup of the database
cd /home/jtel/shared/JTELCarrierPortal/DB/mySQL/init
mysql -h localhost -u root -p<password> -vvv -f -n -q -e"source Init.sql"



After the first initialization, some values must still be adapted to the system environment. To simplify this, a special database procedure is called, which makes almost all the necessary adjustments for a standard system. This procedure must be given the following parameters:


ParameterMeaningValue in this example
1_softwareHomeUNC of the directory in which the jtel system stores all data. There you will find e.g. the directories Data, LogFiles and LogFilesCall.'//acd-lb/shared/'
2_dataHomeUNC of the directory in which the jtel system finds all program files. There you will find e.g. the directories JTELCarrierPortal and JTEL.'//acd-lb/shared/'
3_webServerListComma-separated list of all WEB application servers.'acd-jb1,acd-jb2'
4_telServerListComma-separated list of all TEL servers that execute call flow applications.'acd-tel1'
5_daemonServerTEL server on which the management applications are executed.'acd-tel1'
6_loadBalancerName of the server on which the role LB is executed.'acd-lb'
7_httpsTRUE, if the load balancer provides the services via HTTPS, FALSE if notFALSE


Note
titleACHTUNG

The following rules apply to UNC or path specifications:

  • The separator is a "/ (slash)" and no "\ (backslash)"
  • The paths must end with /.

The call is made using the following command:

Translations Ignore


Code Block
languagebash
titleValues to the system environment
mysql -u root -p<password> -v -e "CALL JTELWeb.Hardstyle_ReconfigureFullSystem('//acd-store/shared/','//acd-store/shared/','acd-jb1,acd-jb2','acd-tel1','acd-tel1','acd-lb',FALSE)"



At the end of each installation, the database update scripts should be run once through the database, because the init.sql script does not necessarily contain all the latest routines.

This is done with the following commands, viewed from the STORE role:

Translations Ignore


Code Block
languagebash
titleCarry out DB and release update
su jtel
cd /home/jtel/shared/JTELCarrierPortal/Update
sudo ./update_release.sh




Sv translation
languagede

Table of Contents
maxLevel3
printablefalse

Ersteinrichtung der Systemdaten

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



Nach Eingabe dieser Befehle erkennt man den Benutzerwechsel am Systemprompt, welches nun [jtel@acd-db1 ~]$ lautet (Das Systemprompt setzt sich zusammen ausbenutzername@hostname aktuelles Verzeichnis).
Die Ersteinrichtung der Systemdaten kann prinzipiell von jeder Linux-Maschine aus gemacht werden, da jede Maschine Zugriff auf die Datenbank-Skripte hat und über einen MySQL-Client verfügt. Aus Performance-Gründen ist es aber ratsam, diese Operation auf dem primären DATA-Server  auszuführen, da so die Netzwerkbelastung am geringsten ist und die Ersteinrichtung schnell von Statten geht.


Note
titleACHTUNG

Wenn diese Operation von einer anderen Maschine ausgeführt werden sollte, dann ist unbedingt darauf zu achten, daß als Zielserver der primäre DATA-Server angegeben wird. Im Nachfolgenden Beispiel wird davon ausgegangen, dass die Operation auf dem primären DATA-Server ausgeführt wird, der Zielserver ist also localhost.

Die Ersteinrichtung der Datenbank erfolgt über folgende Befehle:

Translations Ignore


Code Block
languagebash
titleInitial setup of the database
cd /home/jtel/shared/JTELCarrierPortal/DB/mySQL/init
mysql -h localhost -u root -p<password> -vvv -f -n -q -e"source Init.sql"



Nach der Erstinitialisierung müssen noch einige Werte an die Systemumgebung angepasst werden. Um dies zu vereinfachen, wird eine spezielle Datenbankprozedur aufgerufen, die nahezu alle benötigten Anpassungen für ein Standard-System vornimmt. Diese Prozedur muss folgende Parameter übergeben bekommen:


ParameterBedeutungWert in diesem Beispiel
1_softwareHomeUNC des Verzeichnisses in dem das jtel-System alle Daten unterbringt. Dort befinden sich z.B. die Verzeichnisse Data, LogFiles und LogFilesCall.'//acd-lb/shared/'
2_dataHomeUNC des Verzeichnisses in dem das jtel-System alle Programmdateien vorfindet. Dort befinden sich z.B. die Verzeichnisse JTELCarrierPortal und JTEL.'//acd-lb/shared/'
3_webServerListKomma-Separierte Liste aller WEB-Application-Server.'acd-jb1,acd-jb2'
4_telServerListKomma-Separierte Liste aller TEL-Server die Call-Flow-Applikationen ausführen.'acd-tel1'
5_daemonServerTEL-Server auf dem die Verwaltungsapplikationen ausgeführt werden.'acd-tel1'
6_loadBalancerName des Servers auf dem die Rolle LB ausgeführt wird.'acd-lb'
7_httpsTRUE, falls der Load Balancer die Dienste über HTTPS zur Verfügung stellt, FALSE falls nicht.FALSE


Note
titleACHTUNG

Bei den UNC bzw. Pfadangaben gelten folgende Regeln:

  • Das Trennzeichen ist ein / (slash) und kein \ (backslash)
  • Die Pfade müssen mit / enden

Der Aufruf erfolgt mittels folgendem Befehl:

Translations Ignore


Code Block
languagebash
titleValues to the system environment
mysql -u root -p<password> -v -e "CALL JTELWeb.Hardstyle_ReconfigureFullSystem('//acd-store/shared/','//acd-store/shared/','acd-jb1,acd-jb2','acd-tel1','acd-tel1','acd-lb',FALSE)"



Am Ende jeder Installation, sollten die Datenbank-Update-Skripte einmal über die Datenbank laufen, denn das Init.sql Skript beinhaltet nicht zwangsläufig alle neusten Routinen.

Dies geschieht mit folgende Befehle, von der Rolle STORE aus gesehen:

Translations Ignore


Code Block
languagebash
titleCarry out DB and release update
su jtel
cd /home/jtel/shared/JTELCarrierPortal/Update
sudo ./update_release.sh