Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languageen

Before Installation

This information is required before the basic installation of the system.

InformationCommentsExampleStatus

Hypervisor host 

Access to hypervisor:

  • IP address
  • login data of administrator / root or specific account 

Only reqired, if VMs are to be configured.

1.1.1.1
root / secret


Hypervisor type

The type of the hypervisor used is needed if the tools are not pre-installed.

Part of the standard installation is to install tools for Hyper-V or VMWare
If the hypervisor is neither of these, the tools must be installed by the customer.
HyperV / VMWare

Network

For the subnet(s) of the virtual machines:

  • IP range
  • Netmask
  • Default gateway 
  • Domain suffix

Network: 192.168.1.0
Netmask: 255.255.255.0
Gateway: 192.168.1.254
Domain Suffix: example.com


Naming convention

The required naming convention for the virtual machines.

Only reqired, if VMs are to be configured.

acd-dbm.example.com
acd-jb1.example.com
acd-tel1.example.com


DNS Servers

The addresses of the DNS servers used in the network are required.


192.168.1.254

Time server

The IP address of at least one reliable time server. 
If not available, is a reliable time server accessible via customer firewall by NTP?

A reliable NTP time server must be available for the installation.
Windows domain controllers are not always reliable NTP sources.

ptbtime1.ptb.de
ptbtime2.ptb.de
ptbtime3.ptb.de


CentOS Root Login

The root user and password is required for the CentOS servers.

If the root user is not supplied, the supplied user account must be able to execute commands with sudo and change to root with sudo -s.User: root
Password: secret

Windows Login

An AD domain user or a local user is required for the Windows Server(s).

This user must have local administrator rights to the machine.User: administrator
Password: secret

Internet connection

Available from the VMs directly or proxy server settings.

The installation cannot be performed without internet access.
If a proxy is required to access the internet, the proxy server address, port, user and password is required.

Proxy Server: proxy.example.com:8080

Windows updates

All windows updates should be performed on the windows server before handover.

The customer is responsible for updating the windows operating system. 

Virus scanners

Not all virus scanners are good news. The jtel system is a real-time communication system - and some virus scanners are very intrusive indeed (or just plain and simply badly configured) and can have a serious impact on system performance.

It is solely the customer's responsibility for deploying an adequate virus scanner. 



External file share

The file share used by the system can be external and provided, for example, by a high availability storage system. If this is to be external, an SMB file share is required and the following information:

  • User name
  • Password
Note, because Windows machines will inevitably use the logged in user and password when accessing the share, this is recommended to be the same as the username and password used on the windows machine(s). This is required to be so if the applications on the windows machine are to be configured as windows services.User: jtelacd
Password: secret

Firewall and Routing

All of the machines for the ACD installation will be installed with a firewall, and the necessary ports opened for communication between the machines.
An additional firewall between the servers of the ACD is not recommended.

A firewall between the PBX and the ACD must be correctly configured to allow SIP / RTP and the PBX connector from the jtel system to access the PBX.

A firewall between the servers is not recommended, better as a standalone solution in it's own subnet with a firewall covering access to the load balancer by http(s) for accessing the webservers.

A firewall between the PBX and the ACD is not recommended.

A proxy between the PBX and the ACD (for accessing the PBX connector) is definately not recommended and may cause serious problems with operation (timeouts and other errors).



Web Access

If a certificate is required (i.e. the portal should be accessed via https) then a certificate is to be provided before installation.

The certificate must be provided in .pem Format including the following:

  • Certificate for server
  • Intermediate CA certificate (chain)
  • Private Key



After Installation

InformationCommentsExampleStatus

LDAP(S)

  • Protocol 
  • Server URL
  • Port

Only required for LDAP / LDAPS authorization of logins.

For further information, visit this page 

ldaps://domaincontroller.example.com:636

Email Server

For sending email via SMTP:

  • Protocol and port
  • Username and password
  • E-mail sender

Server: smtp.example.com
Protocol: SMTPS / starttls
Port: 587
User: jtelacd@example.com
Password: secret
Sender: jtelacd@example.com

Tests after Basic Installation

It is recommended to perform the following tests after basic installation is complete:

TestRequired ResultStatus
SIP licenses installed and correct countCorrect count

Configuration of telephony server 

  • giAculab.cfg
  • StdCall_MCP.cfg
  • 8-Server License Count
channel_count = SIP licenses

Configuration of telephony server 

  • StdCall_MCP.cfg
Total channels, inbound and outbound channel counts correct.

Configuration of telephony server 

  • 8-Server License Count
Lines and P2 correspond to number of purchased agent / supervisor / queue / IVR and transfer channels

Symmetric RTP setup

  • mhp.cfg
File present and correct count

PBX Connector

  • Connected and functional
Receives messages regarding monitored extensions in log.
Time Synchronisation

All servers syncing with a reliable time server.

  • Windows: NTP Status 
  • Linux: ntpq -p 

Platform UDP ListenerConfigured and running on telephony and webservers, cluster connecting OK
MySQL replication

SHOW SLAVE STATUS\G output good on all DBs

  • For master-master on all DB servers
  • For master-slave on all slave servers

Telephony ServerNo errors when starting up
WebserversNo errors when starting up
Load Balancer

haproxy

  • available and reachable via port 7777
  • all webservers active
  • If master-master replication, masters are active-standby, slaves are active-active
  • Certificate installed if provided? http to https redirection implemented?

PBX Connection

  • Incoming Calls
  • Trunk setup in jtel portal
  • Incoming number converter correct and converts to E.164 correctly
  • Test internal, national and international numbers

PBX Connection

  • Outgoing Calls
  • Trunk setup in jtel portal
  • Outgoing number converter correct and converts to required format for PBX correctly
  • Calls to internal PBX extensions and external (national and international) numbers possible
  • dialler.8Server.IPs parameter setup to actual names of windows servers

System parametersCheck other system parameters and make any necessary modifications

Tests after System Configuration

It is recommended to perform the following tests after some configuration (setting up test numbers and an ACD group):


TestRequired ResultStatus
Configure an ACD group with a logged on agent and music on hold. Setup group to allow calls without logged in agents.
  • Login / logout OK

Incoming call to a test number, agent not available.
  • Music on hold is played

Incoming call on test number, agent available.
  • Agent home / mini client displays call status as soon as phone rings
  • Caller and agent can hear each other
  • Display of information in mini client and full client is OK and contains the required data and numbers in correct (international) format
  • Hold / Retrieve work in jtel portal
  • Call is cleared properly to both ends without delay when one party ends the call

Accept Call button
  • Works if configured and supported by the PBX connector
  • Automatic call answer can be set and works if configured and supported by the PBX connector

Number display on called device

  • Displayed number on agent device is OK
  • Number on agent device can be called back directly (without using the ACD)

Supervisor

  • Data from test calls is displayed and correct

Statistics
  • Data from test calls is retrievable via ACD and Service Number reports

PBX Connector
  • PBX extensions imported to PBX users correctly
  • Status of PBX users and agents change when the user is on the phone

Voice Mail - setup a rule to record a voice mail and activate this rule

  • Voice mail delivered
  • Voice mail can be retrieved via web application
  • Call-Back can be done to number which left voice mail


Sv translation
languagede

Before Installation

This information is required before the basic installation of the system.

InformationCommentsExampleStatus

Hypervisor host 

Access to hypervisor:

  • IP address
  • login data of administrator / root or specific account 

Only reqired, if VMs are to be configured.

1.1.1.1
root / secret


Hypervisor type

The type of the hypervisor used is needed if the tools are not pre-installed.

Part of the standard installation is to install tools for Hyper-V or VMWare
If the hypervisor is neither of these, the tools must be installed by the customer.
HyperV / VMWare

Network

For the subnet(s) of the virtual machines:

  • IP range
  • Netmask
  • Default gateway 
  • Domain suffix

Network: 192.168.1.0
Netmask: 255.255.255.0
Gateway: 192.168.1.254
Domain Suffix: example.com


Naming convention

The required naming convention for the virtual machines.

Only reqired, if VMs are to be configured.

acd-dbm.example.com
acd-jb1.example.com
acd-tel1.example.com


DNS Servers

The addresses of the DNS servers used in the network are required.


192.168.1.254

Time server

The IP address of at least one reliable time server. 
If not available, is a reliable time server accessible via customer firewall by NTP?

A reliable NTP time server must be available for the installation.
Windows domain controllers are not always reliable NTP sources.

ptbtime1.ptb.de
ptbtime2.ptb.de
ptbtime3.ptb.de


CentOS Root Login

The root user and password is required for the CentOS servers.

If the root user is not supplied, the supplied user account must be able to execute commands with sudo and change to root with sudo -s.User: root
Password: secret

Windows Login

An AD domain user or a local user is required for the Windows Server(s).

This user must have local administrator rights to the machine.User: administrator
Password: secret

Internet connection

Available from the VMs directly or proxy server settings.

The installation cannot be performed without internet access.
If a proxy is required to access the internet, the proxy server address, port, user and password is required.

Proxy Server: proxy.example.com:8080

Windows updates

All windows updates should be performed on the windows server before handover.

The customer is responsible for updating the windows operating system. 

Virus scanners

Not all virus scanners are good news. The jtel system is a real-time communication system - and some virus scanners are very intrusive indeed (or just plain and simply badly configured) and can have a serious impact on system performance.

It is solely the customer's responsibility for deploying an adequate virus scanner. 



External file share

The file share used by the system can be external and provided, for example, by a high availability storage system. If this is to be external, an SMB file share is required and the following information:

  • User name
  • Password
Note, because Windows machines will inevitably use the logged in user and password when accessing the share, this is recommended to be the same as the username and password used on the windows machine(s). This is required to be so if the applications on the windows machine are to be configured as windows services.User: jtelacd
Password: secret

Firewall and Routing

All of the machines for the ACD installation will be installed with a firewall, and the necessary ports opened for communication between the machines.
An additional firewall between the servers of the ACD is not recommended.

A firewall between the PBX and the ACD must be correctly configured to allow SIP / RTP and the PBX connector from the jtel system to access the PBX.

A firewall between the servers is not recommended, better as a standalone solution in it's own subnet with a firewall covering access to the load balancer by http(s) for accessing the webservers.

A firewall between the PBX and the ACD is not recommended.

A proxy between the PBX and the ACD (for accessing the PBX connector) is definately not recommended and may cause serious problems with operation (timeouts and other errors).



Web Access

If a certificate is required (i.e. the portal should be accessed via https) then a certificate is to be provided before installation.

The certificate must be provided in .pem Format including the following:

  • Certificate for server
  • Intermediate CA certificate (chain)
  • Private Key



After Installation

InformationCommentsExampleStatus

LDAP(S)

  • Protocol 
  • Server URL
  • Port

Only required for LDAP / LDAPS authorization of logins.

Weitere Informationen hier. 

ldaps://domaincontroller.example.com:636

Email Server

For sending email via SMTP:

  • Protocol and port
  • Username and password
  • E-mail sender

Server: smtp.example.com
Protocol: SMTPS / starttls
Port: 587
User: jtelacd@example.com
Password: secret
Sender: jtelacd@example.com

Tests after Basic Installation

It is recommended to perform the following tests after basic installation is complete:

TestRequired ResultStatus
SIP licenses installed and correct countCorrect count

Configuration of telephony server 

  • giAculab.cfg
  • StdCall_MCP.cfg
  • 8-Server License Count
channel_count = SIP licenses

Configuration of telephony server 

  • StdCall_MCP.cfg
Total channels, inbound and outbound channel counts correct.

Configuration of telephony server 

  • 8-Server License Count
Lines and P2 correspond to number of purchased agent / supervisor / queue / IVR and transfer channels

Symmetric RTP setup

  • mhp.cfg
File present and correct count

PBX Connector

  • Connected and functional
Receives messages regarding monitored extensions in log.
Time Synchronisation

All servers syncing with a reliable time server.

  • Windows: NTP Status 
  • Linux: ntpq -p 

Platform UDP ListenerConfigured and running on telephony and webservers, cluster connecting OK
MySQL replication

SHOW SLAVE STATUS\G output good on all DBs

  • For master-master on all DB servers
  • For master-slave on all slave servers

Telephony ServerNo errors when starting up
WebserversNo errors when starting up
Load Balancer

haproxy

  • available and reachable via port 7777
  • all webservers active
  • If master-master replication, masters are active-standby, slaves are active-active
  • Certificate installed if provided? http to https redirection implemented?

PBX Connection

  • Incoming Calls
  • Trunk setup in jtel portal
  • Incoming number converter correct and converts to E.164 correctly
  • Test internal, national and international numbers

PBX Connection

  • Outgoing Calls
  • Trunk setup in jtel portal
  • Outgoing number converter correct and converts to required format for PBX correctly
  • Calls to internal PBX extensions and external (national and international) numbers possible
  • dialler.8Server.IPs parameter setup to actual names of windows servers

System parametersCheck other system parameters and make any necessary modifications

Tests after System Configuration

It is recommended to perform the following tests after some configuration (setting up test numbers and an ACD group):


TestRequired ResultStatus
Configure an ACD group with a logged on agent and music on hold. Setup group to allow calls without logged in agents.
  • Login / logout OK

Incoming call to a test number, agent not available.
  • Music on hold is played

Incoming call on test number, agent available.
  • Agent home / mini client displays call status as soon as phone rings
  • Caller and agent can hear each other
  • Display of information in mini client and full client is OK and contains the required data and numbers in correct (international) format
  • Hold / Retrieve work in jtel portal
  • Call is cleared properly to both ends without delay when one party ends the call

Accept Call button
  • Works if configured and supported by the PBX connector
  • Automatic call answer can be set and works if configured and supported by the PBX connector

Number display on called device

  • Displayed number on agent device is OK
  • Number on agent device can be called back directly (without using the ACD)

Supervisor

  • Data from test calls is displayed and correct

Statistics
  • Data from test calls is retrievable via ACD and Service Number reports

PBX Connector
  • PBX extensions imported to PBX users correctly
  • Status of PBX users and agents change when the user is on the phone

Voice Mail - setup a rule to record a voice mail and activate this rule

  • Voice mail delivered
  • Voice mail can be retrieved via web application
  • Call-Back can be done to number which left voice mail


Sv translation
languagefr

Avant l'installation

Ces informations sont nécessaires avant l'installation de base du système.

InformationCommentairesExempleStatut

Hôte de l'hyperviseur 

Accès à l'hyperviseur :

  • Adresse IP
  • les données de connexion de l'administrateur / root ou compte spécifique 

Nécessaire seulement, si les VM doivent être configurées.

1.1.1.1
root / secret


Type d'hyperviseur

Le type d'hyperviseur utilisé est nécessaire si les outils ne sont pas préinstallés.

Une partie de l'installation standard consiste à installer des outils pour Hyper-V ou VMWare
Si l'hyperviseur n'est ni l'un ni l'autre, les outils doivent être installé par le client.
HyperV / VMWare

Réseau

Pour le(s) sous-réseau(x) des machines virtuelles :

  • Plage IP
  • Mask réseau
  • Passerelle par défaut 
  • Suffixe du domaine

Réseau: 192.168.1.0
Masque de réseau : 255.255.255.0
Passerelle : 192.168.1.254
Suffixe de domaine : example.com


Convention d'appellation

La convention de dénomination requise pour les machines virtuelles.

Nécessaire seulement, si les VM doivent être configurées.

acd-dbm.example.com
acd-jb1.example.com
acd-tel1.example.com


Serveur DNS

Les adresses des serveurs DNS utilisés dans le réseau sont requises.


192.168.1.254

Serveur de temps

L'adresse IP d'au moins un serveur de temps fiable. 
S'il n'est pas disponible, un serveur de temps fiable est-il accessible par NTP via le pare-feu du client ?

Un serveur de temps NTP fiable doit être disponible pour l'installation.
Les contrôleurs de domaine Windows ne sont pas toujours des sources NTP fiables.

ptbtime1.ptb.de
ptbtime2.ptb.de
ptbtime3.ptb.de


Connexion CentOS Root

L'utilisateur root et le mot de passe sont nécessaires pour les serveurs CentOS.

Si l'utilisateur root n'est pas fourni, le compte utilisateur fourni doit être capable d'exécuter des commandes avec sudo et de passer en root avec sudo -s.Utilisateur: root
Mot de passe: secret

Connexion Windows

Un utilisateur du domaine AD ou un utilisateur local est nécessaire pour le(s) serveur(s) Windows.

Cet utilisateur doit avoir des droits d'administrateur local sur la machine.Utilisateur: administrator
Mot de passe: secret

Internet connection

Disponible à partir des VM directement ou des paramètres du serveur proxy.

L'installation ne peut pas être effectuée sans accès à Internet.
Si un proxy est nécessaire pour accéder à l'internet, l'adresse du serveur proxy, le port, l'utilisateur et le mot de passe sont requis.

Serveur Proxy: proxy.example.com:8080

Mises à jour Windows

Toutes les mises à jour Windows doivent être effectuées sur le serveur Windows avant le transfert.

Le client est responsable de la mise à jour du système d'exploitation Windows. 

Scanners de virus

Tous les scanners de virus ne sont pas une bonne nouvelle. Le système jtel est un système de communication en temps réel - et certains scanners de virus sont très intrusifs (ou tout simplement mal configurés) et peuvent avoir un impact sérieux sur les performances du système.

Il est de la seule responsabilité du client de déployer un scanner de virus adéquat. 



Partage de fichiers externes

Le partage de fichiers utilisé par le système peut être externe et fourni, par exemple, par un système de stockage à haute disponibilité. Si ce dernier doit être externe, un partage de fichiers SMB est nécessaire et les informations suivantes sont requises :

  • Nom d'utilisateur
  • Mot de passe
Notez que les machines Windows utiliseront inévitablement l'utilisateur et le mot de passe connectés lors de l'accès au partage, il est recommandé que ces informations soient identiques au nom d'utilisateur et au mot de passe utilisés sur la ou les machines Windows. Cela doit être le cas si les applications sur la machine Windows doivent être configurées comme des services Windows.Utilisateur: jtelacd
Mot de passe: secret

Pare-feu et routage

Toutes les machines pour l'installation de l'ACD seront installées avec un pare-feu, et les ports nécessaires seront ouverts pour la communication entre les machines.
Un pare-feu supplémentaire entre les serveurs de l'ACD n'est pas recommandé.

Un pare-feu entre le PBX et l'ACD doit être correctement configuré pour permettre au SIP / RTP et au connecteur PBX du système jtel d'accéder au PBX.

Un pare-feu entre les serveurs n'est pas recommandé, mieux vaut une solution autonome dans son propre sous-réseau avec un pare-feu couvrant l'accès à l'équilibreur de charge par http(s) pour accéder aux serveurs web.

Lepare-feu entre le PBX et l'ACD n'est pas recommandé.

Un proxy entre le PBX et l'ACD (pour accéder au connecteur du PBX) n'est certainement pas recommandé et peut causer de sérieux problèmes de fonctionnement (timeouts et autres erreurs).



Accès Web

Si un certificat est requis (c'est-à-dire que le portail doit être accessible via https), un certificat doit être fourni avant l'installation.

Le certificat doit être fourni en format .pem comprenant ce qui suit :

  • Certificat pour le serveur
  • Certificat CA intermédiaire (chaîne)
  • Clé privée



Après l'installation

InformationCommentairesExempleStatut

LDAP(S)

  • Protocole 
  • URL du serveur
  • Port

Uniquement nécessaire pour l'autorisation de connexion LDAP / LDAPS 

Pour plus d'informations, consultez cette page.

ldaps://domaincontroller.example.com:636

Serveur d'email

Pour l'envoi d'email via SMTP :

  • Protocole et port
  • Nom d'utilisateur et mot de passe
  • Expéditeur de l'e-mail

Serveur: smtp.example.com
Protocole: SMTPS / starttls
Port: 587
Utilisateur: jtelacd@example.com
Mot de passe: secret
Expéditeur: jtelacd@example.com

Tests après l'installation de base

Il est recommandé d'effectuer les tests suivants une fois l'installation de base terminée :

TestRésultat requisStatut
Licences SIP installées et comptage correctComptage correct

Configuration du serveur de téléphonie 

  • giAculab.cfg
  • StdCall_MCP.cfg
  • Nombre de licences 8-Server
channel_count = licences SIP

Configuration du serveur de téléphonie 

  • StdCall_MCP.cfg
Le nombre total de canaux, le nombre de canaux entrants et sortants sont corrects.

Configuration du serveur de téléphonie 

  • Nombre de licences 8-Server
Les lignes et P2 correspondent au nombre d'agents / superviseur / files d'attente / IVR et canaux de transfert achetés

Configuration symétrique de la RTP

  • mhp.cfg
Dossier présent et comptage correct

Connecteur PBX

  • Connecté et fonctionnel
Reçoit les messages concernant les extensions surveillées dans le journal.
Synchronisation du temps

Tous les serveurs se synchronisent avec un serveur de temps fiable.

  • Windows : NTP Statut 
  • Linux: ntpq -p 

Plate-forme UDP ListenerConfiguré et fonctionnant sur la téléphonie et les serveurs web, connexion au cluster OK
Réplication de MySQL

SHOW SLAVE STATUS\G bon rendement sur toutes les BD

  • Pour maître-maître sur tous les serveurs DB
  • Pour maître-esclave sur tous les serveurs esclaves

Serveur téléphoniquePas d'erreurs lors du démarrage
Serveurs webPas d'erreurs lors du démarrage
Équilibreur de charge

haproxy

  • disponible et joignable via le port 7777
  • tous les serveurs web actifs
  • En cas de réplication maître-maître, les maîtres sont en veille active, les esclaves sont actifs-actifs
  • Certificat installé s'il est fourni ? Redirection http vers https mise en œuvre ?

Connecteur PBX

  • Appels entrants
  • Configuration du tronc dans le portail de jtel
  • Conversion correcte des numéros entrants et conversion correcte en E.164
  • Tester les numéros internes, nationaux et internationaux

Connecteur PBX

  • Appels sortants
  • Configuration du tronc dans le portail de jtel
  • Conversion correcte du numéro sortant et conversion correcte au format requis pour le PBX
  • Possibilité de passer des appels vers des extensions PBX internes et des numéros externes (nationaux et internationaux)
  • dialler.8Server.IPs paramétrage des noms réels des serveurs Windows

Paramètres du SystèmeVérifier les autres paramètres du système et apporter les modifications nécessaires

Tests après la configuration du système

Il est recommandé d'effectuer les tests suivants après une certaine configuration (mise en place de numéros de test et d'un groupe ACD):


TestRésultat requisStatut
Configurez un groupe ACD avec un agent connecté et de la musique en attente. Configurer un groupe pour autoriser les appels sans agent connecté.
  • Connexion / déconnexion OK

Appel entrant vers un numéro test, agent non disponible.
  • La musique en attente est jouée

Appel entrant sur le numéro test, agent disponible.
  • Accueil agent / mini-client affiche le statut de l'appel dès que le téléphone sonne
  • L'appelant et l'agent peuvent s'entendre
  • L'affichage des informations dans le mini-client et le client complet est correct et contient les données et les numéros requis dans un format (international) correct
  • Retenir / Récupérer le travail dans le portail de jtel
  • L'appel est correctement autorisé aux deux extrémités sans délai lorsque l'une des parties met fin à l'appel

Accepter le bouton d'appel
  • Fonctionne si configuré et supporté par le connecteur PBX
  • La réponse automatique à l'appel peut être configurée et fonctionne si elle est configurée et prise en charge par le connecteur PBX

Affichage du numéro sur l'appareil appelé

  • Le numéro affiché sur l'appareil de l'agent est correct
  • Le numéro de l'appareil de l'agent peut être rappelé directement (sans utiliser le ACD)

Superviseur

  • Les données des appels tests sont affichées et correctes

Statistiques
  • Les données des appels de test peuvent être récupérées via les rapports ACD et les numéros de service

Connecteur PBX
  • Importation correcte des extensions PBX pour les utilisateurs de PBX
  • Le statut des utilisateurs et des agents du PBX change lorsque l'utilisateur est au téléphone

Messagerie vocale - définir une règle pour l'enregistrement d'un message vocal et activer cette règle

  • Messagerie vocale
  • La messagerie vocale peut être consultée via une application web
  • Le rappel peut se faire au numéro qui a laissé la boîte vocale