Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Removed translated content for 'fr'
Sv translation
languageen

Initial Checks

RoleCheckComments
VPNConnectivity

Make sure the VPN is running OK, and that all systems are accessible by SSH and RDP.

Web ApplicationConnectivity

Connect via the IP address of the load balancer (if redundant, connect via the shared IP address).

Login as sysadmin, switch to a user with admin rights, and check a few views:

  • Agent Home
  • Mini Client
  • Supervisor
  • Execute a report
Test CallFunctionality

Make a test call.

Check that it is received by the system and that audio is heard.

If possible:

  • Make a call to an ACD queue which is forwarded to an agent.
  • Check the agent's Agent Home indicates the incoming call quickly and that the status of the call changes from ringing to busy (this indicates, the webserver is communicating with the platform UDP listener cluster).
  • Check that two way audio is heard.
Test Chat / WhatsappFunctionality

Make a test chat.

Make sure it is distributed to an agent, and that the agent can reply.

Virus ScannersActivity

No virus scanner should be installed on the telephony server. Virus scanners can have negative impact on live telephony systems and should not scan in and outgoing traffic in the network, or the filesystems used by jtel software. 

Component and Role Checks

RoleCheckComments
ALL LINUXUptime and Errors

Use:

uptime

to check for how long the system has been up.

If it has been restarted, then check the following for why:

less /var/log/messages

You may need to go back to an older file than the current log file to see why.

ALL LINUXDisk Space

Use:

df -h

to make sure the disk is not full.

Particularly on the database systems make sure this space will not run out soon.

Note: on some systems, /var/lib/mysql may be mounted separately.

Use: mount to verify how it is mounted or cat /etc/fstab

ALL LINUXCPU Load

Use both of the following to identify CPU load problems:

top

sar (historical)

sar -u 1 (real-time)

ALL LINUXTime Sync

Use the following commands to make sure the time sync is OK:

ntpq -p (older systems)

chronyc sources (newer systems)

timedatectl

ALL LINUXFile System writable

Sometimes, if a file system error has occurred, linux will either:

  • Not mount it at all (this is easy to see / find)
  • Mount it read-only (this is not so obvious)

Try writing to a file:

cat << EOFF > /root/test.txt
Test
EOFF
cat /root/test.txt
ALL LINUXExpected processes running?ps -ef | less
WINDOWSTime SyncCheck the ntp status using the monitor application.
WINDOWSCPU Load

Check the task manager to make sure no process is running very high CPU. 

Note: on a loaded system 50% or more CPU is perfectly fine, as long as it is either:

  • 8-Server
  • SIP and RTP Stack (Aculab)
DB

DB Master-Master

DB Slaves

Make sure replication is running:


SHOW SLAVE STATUS\G

Make sure MySQL is not crashing:

less /var/log/mysqld.log

LBRedundant LB

Check the status of the pcs cluster with:

pcs status

Make sure one of the load balancers has the shared IP address, and that all resources are started.

LBhaproxy Stats and Control Page

Open haproxy (on both load balancers in a redundant system) using the following url:

http://<load-balancer>:7777

Make sure the expected resources are present and all up:

  • Expected database servers (in a redundant solution) are up and running.
  • Only one load balancer is serving connections.
  • Only one of the DB masters has active connections.
STORERedundant Store

Check the status of DRBD with:

drbdadm status jtelshared

Make sure it is primary/primary (for older installations) or primary secondary (for newer installations).

Check the status of the pcs cluster with:

pcs status

Make sure all of the resources are started:

  • Mount of /srv/jtel/shared is started on one of the STORE servers
  • Samba is started on one of the STORE servers
  • The shared IP is started on one of the STORE servers
STORENon-Redundant Store

Check the status of the samba service:

smbstatus

ps -ef | grep samba

Make sure it is running. 

STORESpace

Check the available space on the store with 

df -h

TEL8-Server started

startup.cmd batch file window present?

giHal.exe batch file window present and running?

giAcu.exe (SIP Registrations) present and running (if required)?

8Server.exe present and running?

TEL8-Server health

Check errors / warnings for excessive error messages, such as ODBC errors or .r5 files not found errors.

ODBC errors can indicate a database problem (for example, a mysql crash), or a syntax error in a sql procedure.

File not found errors (particularly .r5 files) can indicate a storage problem.

TEL8-Server stuck initialising

If 8-Server says "Initialising" on all lines, and does not exit this status for a long time, then there may be connectivity problems to the storage.

This is best mitigated by making sure the samba credentials are correct, and that all "jtel" users have the same credentials.

TELTelephony Server not Receiving Calls

Start a wireshark trace for SIP using this capture filter:

port 5060 or ip[6:2] & 0x1fff != 0

If SIP messages are being received, then the problem might be a firewall rule injection by a domain policy. Check the firewall rules to make sure the required ports are opened.

TELPBX Connector

Telephony connector started and running?

Messages being received from the PBX?

TELPlatform UDP Listener

Check the Platform UDP listener is started

Does the cluster contain all expected members? For example:

TELDisk SpaceUse the windows explorer to make sure the disk is not full.
WEBWebservers

Check each webserver individually using

http://<server>:8080/CarrierPortal/sysadmin/login

Make sure it is possible to login.

Make sure the logo is visible (if not, this indicates a file share mount error to /home/jtel/shared)

WEBCertificate

Make sure the certificate is OK by accessing the system via the load-balancer (if necessary, using an alias in your hosts file).

This is mandatory, for example, for SalesForce integrations.

WEBStats Counters

To check the general health of the web application and database, the following stats pages can be used:

http(s)://<load-balancer>/CarrierPortal/pages/common/Stats.xhtml

Cache counters (average should be below 1 ms):

Page counters (average should be below 300 ms):

CHATApplication running

Make sure the chat application is running:

ps -ef | grep jtel-clientmessenger

RESTApplication running

Make sure the chat application is running:

ps -ef | grep jrest


Sv translation
languagede

Initiale Überprüfung

RollePrüfeKommentar
VPNErreichbarkeit

Vergewissern Sie sich, dass das VPN ordnungsgemäß läuft und dass alle Systeme per SSH und RDP erreichbar sind.

WebanwendungErreichbarkeit

Verbinden Sie sich über die IP-Adresse des Load Balancers (wenn redundant, verbinden Sie sich über die öffentliche IP-Adresse).

Melden Sie sich als sysadmin an, wechseln Sie zu einem Benutzer mit Admin-Rechten und prüfen Sie ein paar Ansichten:

  • Agent Home
  • Mini Client
  • Supervisor
  • Ausführen eines Berichts
TestanrufFunktionalität

Führen Sie einen Testanruf durch.

Prüfen Sie, ob es vom System empfangen wird und ob der Ton zu hören ist.

Wenn möglich:

  • Rufen Sie eine ACD-Warteschlange an, die an einen Agenten weitergeleitet wird.
  • Prüfen Sie, dass der Agent Home den eingehenden Anruf schnell anzeigt und dass der Status des Anrufs von klingelnd auf besetzt wechselt (dies zeigt an, dass der Webserver mit dem UDP-Listener-Cluster der Plattform kommuniziert).
  • Prüfen Sie, ob Zweiwege-Audio zu hören ist.
Test Chat / WhatsappFunktionalität

Machen Sie einen Test-Chat.

Vergewissern Sie sich, dass sie aaaaan das Chat Event an einen Agenten verteilt wird und dass dieser antworten kann.

VirenscannerAktivitätAuf dem Telefonie-Server sollte kein Virenscanner installiert sein. Virenscanner können schwerwiegende negative Auswirkungen auf Live-Telefonie Systeme haben und sollten nicht den ein- und ausgehenden Datenverkehr im Netzwerk oder die von der jtel Software verwendeten Dateisysteme scannen. 


RollePrüfeKommentar
ALLE LINUXBetriebszeit und Fehler

Befehle:

uptime

um zu prüfen, wie lange das System in Betrieb ist.

Wenn es neu gestartet wurde, dann prüfen Sie die folgenden Logs:

less /var/log/messages

Möglicherweise müssen Sie zu einer älteren Datei als der aktuellen Protokolldatei zurückgehen, um zu sehen, warum.

ALL LINUXFestplattenspeicher

Befehle:

df -h

um sicherzustellen, dass die Festplatte nicht voll ist.

Achten Sie besonders bei den Datenbanksystemen darauf, dass dieser Platz nicht bald zur Neige geht.

Hinweis: Auf einigen Systemen könnte das Verzeichnis /var/lib/mysql seperat angebunden sein.

Verwende: mount um herauszufinden, wo die Anbindung sich befindet, oder cat /etc/fstab

ALL LINUXCPU Auslastung

Verwenden Sie die beiden folgenden Möglichkeiten, um Probleme mit der CPU-Last zu erkennen:

top

sar (Historisch)

sar -u 1 (Echtzeit)

ALL LINUXZeitsynchronisierung

Use the following commands to make sure the time sync is OKVerwenden Sie die folgenden Befehle, um sicherzustellen, dass die Zeitsynchronisation in Ordnung ist:

ntpq -p (older systemsältere Systeme)

chronyc sources (newer systemsneuere Systeme)

timedatectl

ALL LINUXDateisystem beschreibbar

Manchmal, wenn ein Dateisystemfehler aufgetreten ist, wird linux das Dateisystem entweder:

  • gar nicht anbinden (Dieser Status ist einfach erkennbar)

oder:

  • es im Modus "Nur Lesen" bzw. read only anbinden (Dies ist nicht offenslichtlich erkennbar)

Versuchen Sie, in eine Datei zu schreiben:

cat << EOFF > /root/test.txt
Test
EOFF
cat /root/test.txt
ALL LINUXLaufen erwartete Prozesse?ps -ef | less
WINDOWSZeit SynchronisierungPrüfen Sie den ntp-Status mit der Monitor-Anwendung.
WINDOWSCPU Auslastung

Prüfen Sie den Task-Manager, um sicherzustellen, dass kein Prozess eine sehr hohe CPU-Leistung erbringt. 

Hinweis: Auf einem belasteten System sind 50 % oder mehr CPU völlig in Ordnung, vor allem bei folgenden Prozessen:

  • 8-Server
  • SIP and RTP Stack (Aculab)
DB

DB Master-Master

DB Slaves

Stellen Sie sicher, dass die Replikation läuft:


SHOW SLAVE STATUS\G

Stellen Sie sicher, dass MySQL nicht abstürzt:

less /var/log/mysqld.log

LBRedundante LB

Prüfen Sie den Status des pcs cluster mit:

pcs status

Stellen Sie sicher, dass einer der Load Balancer die gemeinsame IP-Adresse hat und dass alle Ressourcen gestartet sind.

LB

haproxy Statistik and Seite zum Statusüberblick


Öffnen Sie haproxy (auf beiden Load Balancern in einem redundanten System) mit der folgenden url:

http://<load-balancer>:7777

Vergewissern Sie sich, dass die erwarteten Ressourcen vorhanden und alle aktiviert sind:

  • Die erwarteten Datenbankserver (in einer redundanten Lösung) sind in Betrieb.
  • Nur ein Load Balancer bedient Verbindungen.
  • Nur einer der DB-Master hat aktive Verbindungen.
STORERedundant Redundantes Store

Prüfen Sie den Status von DRBD mit:

drbdadm status jtelshared

Stellen Sie sicher, dass es sich um der status primär/primär (bei älteren Installationen) oder primär-sekundär (bei neueren Installationen) handeltangezeigt wird.

Prüfe the status of the pcs cluster with:

pcs status

Make sure all of the resources are started:

  • Mount of /srv/jtel/shared is started on one of the STORE servers
  • Samba is started on one of the STORE servers
  • The shared IP is started on one of the STORE servers
STORENonNicht-Redundant Redundantes Store

Prüfe the status of the samba service:

smbstatus

ps -ef | grep samba

Make sure it is running. Stellen Sie sicher, dass der Dienst läuft.

STORESpaceSpeicherplatz

Prüfe the available space on the store with den verfügbaren Speicherplatz am store mit: 

df -h

TEL8-Server startedgestartet

startup.cmd batch file window presentfenster geöffnet?

giHal.exe batch file window present and runningfenster geöffnet?

giAcu.exe (SIP Registrations) present and running (if requiredRegistrierung) fenster geöffnet (falls erforderlich)?

8Server.exe present and runningfenster geöffnet?

TEL8-Server healthstatus

Prüfe errors / warnings for excessive error messages, such as ODBC errors or nach bestimmten Fehlerbildern, wie zum Beispiel ODBC Errors oder .r5 files not found errors.

ODBC-Fehler können auf ein Datenbankproblem (z. B. einen mysql-Absturz) oder einen Syntaxfehler in einer sql-Prozedur hinweisen

Fehler bei nicht gefundenen Dateien (insbesondere .r5-Dateien) können auf ein Problem am STORE hinweisen errors can indicate a database problem (for example, a mysql crash).File not found errors (particularly .r5 files) can indicate a storage problem.

TEL8-Server stuck bleibt bei "initialising" stecken

If Wenn 8-Server says in allen Zeilen "Initialising" on all lines, and does not exit this status for a long time, then there may be connectivity problems to the storage.

This is best mitigated by making sure the samba credentials are correct, and that all "jtel" users have the same credentials.

anzeigt und diesen Status lange Zeit nicht verlässt, gibt es möglicherweise Probleme mit der Verbindung zum STORE.

Dies wird am besten dadurch entschärft, dass Sie sicherstellen, dass die Samba-Anmeldeinformationen korrekt sind und dass alle "jtel"-Benutzer dieselben Anmeldeinformationen haben.

TELTelefonie Server empfängt keine Anrufe

Starten Sie eine Wireshark-Aufzeichnung für SIP mit diesem Aufzeichnungsfilter

TELTelephony Server not Receiving Calls

Start a wireshark trace for SIP using this capture filter:

port 5060 or ip[6:2] & 0x1fff != 0

If SIP messages are being received, then the problem might be a firewall rule injection by a domain policy. Prüfe the firewall rules to make sure the required ports are openedWenn SIP-Nachrichten empfangen werden, könnte das Problem eine Firewall-Regelinjektion durch eine Domänenrichtlinie sein. Prüfen Sie die Firewall-Regeln, um sicherzustellen, dass die erforderlichen Ports geöffnet sind.

TELPBX ConnectorKonnektor

Telefonie-Anschluss gestartet und läuft?

Werden Nachrichten von der Telefonanlage empfangen

Telephony connector started and running?

Messages being received from the PBX?

TELPlatform UDP Listener

Prüfe the , ob der Platform UDP listener is startedListener gestartet ist

Enthält der Cluster alle erwarteten Mitglieder? Zum BeispielDoes the cluster contain all expected members? For example:

TELDisk SpaceSpeicherplatzVerwenden Sie den Windows-Explorer, um sicherzustellen, dass die Festplatte nicht voll istUse the windows explorer to make sure the disk is not full.
WEBWebserversWeb-Server

Prüfen Sie jeden Webserver einzeln mitPrüfe each webserver individually using

http://<server>:8080/CarrierPortal/sysadmin/login

Make sure it is possible to login.

Stellen Sie sicher, dass die Anmeldung möglich ist.

Stellen Sie sicher, dass das Logo sichtbar ist (falls nicht, deutet dies auf einen Fehler beim Einhängen der Dateifreigabe in Make sure the logo is visible (if not, this indicates a file share mount error to /home/jtel/shared hin)

WEBCertificate

Make sure the certificate is OK by accessing the system via the load-balancer (if necessary, using an alias in your hosts file).

This is mandatory, for example, for SalesForce integrations.

Zertifikat

Stellen Sie sicher, dass das Zertifikat in Ordnung ist, indem Sie über den Load-Balancer auf das System zugreifen (ggf. unter Verwendung eines Alias in Ihrer Hosts-Datei).

Dies ist z. B. für SalesForce-Integrationen zwingend erforderlich.

WEBStatistik Zähler

Um den allgemeinen Zustand der Webanwendung und der Datenbank zu prüfen, können die folgenden Statistikseiten verwendet werden

WEBStats Counters

To Prüfe the general health of the web application and database, the following stats pages can be used:

http(s)://<load-balancer>/CarrierPortal/pages/common/Stats.xhtml

Cache counters (average should be below -Zähler (Durchschnitt sollte unter 1 ms liegen):

Page counters (average should be below Seitenzähler (Durchschnitt sollte unter 300 ms liegen):

CHATApplication runningApplikation läuft

Stellen Sie sicher, dass die Chat-Anwendung läuftMake sure the chat application is running:

ps -ef | grep jtel-clientmessenger

RESTApplication runningApplikation läuft

Stellen Sie sicher, dass die Chat-Anwendung läuftMake sure the chat application is running:

ps -ef | grep jrest