Sv translation |
---|
|
Initial setup of the system dataThe 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 |
---|
language | bash |
---|
title | Change 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 |
---|
| 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 |
---|
language | bash |
---|
title | Initial 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:
| Parameter | Meaning | Value in this example |
---|
1 | _softwareHome | UNC 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 | _dataHome | UNC 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 | _webServerList | Comma-separated list of all WEB application servers. | 'acd-jb1,acd-jb2' | 4 | _telServerList | Comma-separated list of all TEL servers that execute call flow applications. | 'acd-tel1' | 5 | _daemonServer | TEL server on which the management applications are executed. | 'acd-tel1' | 6 | _loadBalancer | Name of the server on which the role LB is executed. | 'acd-lb' | 7 | _https | TRUE , if the load balancer provides the services via HTTPS, FALSE if not | FALSE |
Note |
---|
| 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 |
---|
language | bash |
---|
title | Values 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 |
---|
language | bash |
---|
title | Carry out DB and release update |
---|
| su jtel
cd /home/jtel/shared/JTELCarrierPortal/Update
sudo ./update_release.sh |
|
|
Sv translation |
---|
|
Ersteinrichtung der SystemdatenDie 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: |
...
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 |
---|
| 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: |
...
Initial 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" |
|
|
...
Im Falle dass für den Kunden noch spezifische Anpassungen oder Erweiterungen programmiert wurden die auch spezifische Anpassungen der Datenbank enthalten, muss zusätzlich das kundenspezifische Datenbank-Skript ausgeführt werden. Dies erfolgt exemplarisch durch einen Befehl der folgendermaßen aufgebaut ist:
Code Block |
---|
language | bash |
---|
title | Kundenspezifisches Datenbank-Skript |
---|
|
cd ~/shared/acme/DB
./update_all.sh root:fireball@localhost |
All diese Skripte geben Feedback über ihren Fortschritt und Erfolg. Sollte es bei der Ausführung eines dieser Skripte eine Fehlermeldung geben, so ist sorgfältig zu prüfen, ob die Übergebenen Parameter korrekt sind (z.B. Datenbankpasswort, Hostname). Eine erfolgreiche Ausführung sieht folgendermaßen aus:
...
title | Beispiel einer Ausführung |
---|
...
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: |
...
| Parameter | Bedeutung | Wert in diesem Beispiel |
---|
1 | _softwareHome | UNC 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 | _dataHome | UNC des Verzeichnisses in dem das jtel-System alle Programmdateien vorfindet. Dort befinden sich z.B. die |
|
...
Verzeichnisse JTELCarrierPortal |
|
...
und JTEL . | '//acd-lb/shared/' | 3 | _webServerList | Komma-Separierte Liste aller WEB-Application-Server. | 'acd-jb1,acd-jb2' | 4 | _telServerList | Komma-Separierte Liste aller TEL-Server die Call-Flow-Applikationen ausführen. | 'acd-tel1' | 5 | _daemonServer | TEL-Server auf dem die Verwaltungsapplikationen ausgeführt werden. | 'acd-tel1' | 6 | _loadBalancer | Name des Servers auf dem die Rolle LB ausgeführt wird. | 'acd-lb' | 7 | _https | TRUE , falls der Load Balancer die Dienste über HTTPS zur Verfügung stellt, FALSE falls nicht. | FALSE |
Note |
---|
| 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: |
...
| Values 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 |
---|
language | bash |
---|
title | Carry out DB and release update |
---|
| su jtel
cd /home/jtel/shared/JTELCarrierPortal/Update
sudo ./update_release.sh |
|
|
Sv translation |
---|
|
Configuration initiale des données du systèmeLes 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 |
---|
language | bash |
---|
title | Changer 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-db1 ~]$ (L'invite du système se compose du répertoire actuel username@hostname) En principe, la configuration initiale des données du système peut être effectuée à partir de n'importe quelle machine Linux, car chaque machine a accès aux scripts de la base de données et dispose d'un client MySQL. Pour des raisons de performances, il est toutefois conseillé d'effectuer cette opération sur le serveur DATA principal, car la charge du réseau est ainsi plus faible et la configuration initiale est rapide.
Note |
---|
| Si cette opération doit être effectuée à partir d'une autre machine, il est essentiel que le serveur DATA primaire est spécifié comme étant le serveur cible. L'exemple suivant suppose que l'opération est effectuée sur le serveur DATA primaire, donc le serveur cible est localhost . |
La configuration initiale de la base de données se fait à l'aide des commandes suivantes : Translations Ignore |
---|
Code Block |
---|
language | bash |
---|
title | Mise en place initiale de la base de données |
---|
| cd /home/jtel/shared/JTELCarrierPortal/DB/mySQL/init mysql -h localhost -u root -p<password> -vvv -f -n -q -e"source Init.sql" |
|
Après la première initialisation, certaines valeurs doivent encore être adaptées à l'environnement du système. Pour simplifier, une procédure spéciale de base de données est appelée, qui effectue presque tous les ajustements nécessaires pour un système standard. Cette procédure doit être dotée des paramètres suivants :
| Paramètre | Signification | Valeur dans cet exemple |
---|
1 | _softwareHome | UNC du répertoire dans lequel le système jtel stocke toutes les données. Vous y trouverez par exemple les répertoires Data , LogFiles et LogFilesCall . | '//acd-lb/shared/' | 2 | _dataHome | UNC du répertoire dans lequel le système jtel trouve tous les fichiers de programme. Vous y trouverez par exemple les répertoires JTELCarrierPortal et JTEL . | '//acd-lb/shared/' | 3 | _webServerList | Liste de tous les serveurs d'applications WEB, séparés par des virgules. | 'acd-jb1,acd-jb2' | 4 | _telServerList | Liste, séparée par des virgules, de tous les serveurs TEL qui exécutent des applications de flux d'appels. | 'acd-tel1' | 5 | _daemonServer | Le serveur TEL sur lequel les applications de gestion sont exécutées. | 'acd-tel1' | 6 | _loadBalancer | Nom du serveur sur lequel le rôle LB est exécuté. | 'acd-lb' | 7 | _https | TRUE , si l'équilibreur de charge fournit les services via HTTPS, FALSE sinon | FALSE |
Note |
---|
| Les règles suivantes s'appliquent aux spécifications UNC ou trajectoire : - Le séparateur est un "/ (slash)" et pas de "\ (backslash)".
- Les chemins doivent se terminer par /.
|
L'appel est effectué à l'aide de la commande suivante : Translations Ignore |
---|
Code Block |
---|
language | bash |
---|
title | Valeurs pour l'environnement du système |
---|
|
|
|
...
...
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)" |
|
À la fin de chaque installation, les scripts de mise à jour de la base de données doivent être exécutés une fois dans la base de données, car le script init.sql ne contient pas nécessairement toutes les dernières routines. Cela se fait avec les commandes suivantes, vues depuis le rôle STORE : Translations Ignore |
---|
Code Block |
---|
language | bash |
---|
title | Effectuer la mise à jour de la base de données et de la version |
---|
| su jtel cd /home/jtel/shared/JTELCarrierPortal/Update sudo ./update_release.sh |
|
|