Introduction
...
...
Connecting the Starface v6 |
|
...
PBX requires licensing the o-byte connector from o-byte and installation on the Starface PBX. This guide covers the configuration of the jtel System |
|
...
...
...
IP-Adress of the Starface endpoint |
|
...
. Either the IP from the local network, or a public IP-Adress if the Starface is located elsewhere. |
|
...
jtel requires a phone number and user for testing. Additional instructions on configuration of the Starface PBX and the o-byte Connector can be obtained from o-byte. |
jtel STARFACE v62 Service - LinuxThe jtel STARFACE v62 |
jtel STARFACE v6.2 Service
...
Service must be installed on one of the telephony server machines. | Translations Ignore |
|---|
| Code Block |
|---|
| sudo dnf install dotnet-sdk-8.0
mkdir -p /home/jtel/jtel-starface-listener
cd /home/jtel/jtel-starface-listener
cp -r /home/jtel/shared/JTELCarrierportal/WebServices/Install/Starface/StarfaceSoapService/* .
unzip bin.zip
sudo install.sh
mv bin/appsettings.json .
# change configuration as required
vi appsettings.json # normaly no changes required
sudo systemctl start jtel-starface-listener.service
sudo systemctl status jtel-starface-listener.service
# Testing
curl -k https://localhost:56745/jtelStarface6v2SOAPServiceLibrary?wsdl |
|
If the windows firewall is active, add a rule to allow http traffic into the web service. Use the following in a cmd window as administrator: | Translations Ignore |
|---|
| Code Block |
|---|
| netsh advfirewall firewall add rule name="jtelStarface6v2SOAPWindowsService" dir=in action=allow protocol=TCP localport=56745 edge=no |
|
Note, if the STARFACE is in a different network, you will need to change to edge=yes and configure a public remote IP-Adress in the SIP and RTP firewall rules to provide access. Trunk and Trunk Group ConfigurationLogin as sysadmin to the jtel Portal. Use System Settings ... Trunks to configure a trunk for each 8-Server machine. Note, the machine ID is set in the 8-Server configuration (usually the last part of the IP address of the machine). Image Added
Create a new trunk group for each STARFACE PBX. |
...
The following parameters are required. | Parameter | Value |
|---|
| Name | For example STARFACE | | Country Code | Select the correct country code | | Outgoing Trunk Selection | Trunk Group for Internal Numbers | Set to the same trunk group (explicitely) | | Trunk Group for External Numbers | Set to the same trunk group (explicitely) | | Generall access for outbound calls | Only check this option, if this is a single customer installation. | | Number Translator | Incoming Caller | E.164 with + incoming | | Incoming Called | STARFACE - remove converter parameter (usually 019900) | | Converter Parameter | 019900 | | Outgoing Caller | VOIP - Add prefix "sip:+", then E.164 number and postfix "@<Converter Parameter> | | Converter Parameter | <IP_Address_8-Server>:5060 For example: 192.168.1.1:5060 | | Outgoing Called | VOIP - Add prefix "sip:", then E.164 number and postfix "@<Converter Parameter>" | | Converter Parameter | <IP_Address_STARFACE>:5060 For example: 192.168.1.100:5060 | | Internal Number Length | Set to the maximum length of internal PBX extension numbers, for example 3 |
Add the trunk created above for the PBX to the Trunks page. DO NOT FORGET THIS, OR IT WILL NOT WORK! See the screenshot below for an example configuration: Image Added
Service-Numbers are configured as fully qualified E.164 numbers. Agent Telephone Numbers / PBX Internal DestinationsAgent telephone numbers are configured only with the number of the internal extension, not as fully qualified E.164 numbers. Create the SOAP User as an agent in jtel and give the username and password to the starface provider for Module configuration
Old - WindowsCopy FilesCopy the following directory to the telephony server: | Translations Ignore |
|---|
| Code Block |
|---|
Source Directory:
\\acd-store\shared\JTELCarrierPortal\WebServices\Install\Starface\ServiceV62
Target Directory:
c:\jtelStarface6v2SOAPWindowsService |
|
Check ConfigurationCheck the configuration file jtelStarface6v2SOAPWindowsService.exe.config if any changes are required. The most likely changes would be to the sections: - <connectionStrings>- for connecting to the database
- <appSettings> - for specifying the machine and UDP port of the acd Daemon Process
- <log4net> - for specifying the location of the log file
|
...
Configure Firewall - Starface Located In Local Network
Add a rule to allow http traffic into the web service.
...
Install as ServiceUsing a command window, as Administrator: | Translations Ignore |
|---|
| Code Block |
|---|
c:
cd \jtelStarface6v2SOAPWindowsService
c:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe -install jtelStarface6v2SOAPWindowsService.exe |
|
|
| Sv translation |
|---|
|
| Info |
|---|
| Pour connecter le PBX Starface v6, il faut obtenir une licence pour le connecteur d'octets auprès de o-byte et l'installation sur le PBX Starface. Ce guide couvre la configuration du système jtel. Des instructions supplémentaires sur la configuration du PBX Starface et du connecteur o-byte peuvent être obtenues auprès de o-byte. |
service STARFACE v6.2 jtelLe service jtel STARFACE v6.2 doit être installé sur l'une des machines du serveur de téléphonie. Copier les fichiersCopiez le répertoire suivant sur le serveur de téléphonie : | Translations Ignore |
|---|
| Code Block |
|---|
Répertoire source: \\acd-store\shared\JTELCarrierPortal\WebServices\Install\Starface\ServiceV62 Target Directory: c:\jtelStarface6v2SOAPWindowsService |
|
Vérifiez la configuration :Vérifiez le fichier de configuration jtelStarface6v2SOAPWindowsService.exe.config si des changements sont nécessaires. Les changements les plus probables porteraient sur les articles : - <connectionStrings>- pour se connecter à la base de données
- <appSettings> - pour spécifier la machine et le port UDP du processus de démon acd
- <log4net> - pour préciser l'emplacement du fichier journal
Si le pare-feu Windows est actif, ajoutez une règle pour autoriser le trafic http dans le service web. Utilisez ce qui suit dans une fenêtre cmd comme administrateur: | Translations Ignore |
|---|
| Firewall | netsh advfirewall firewall add rule name="jtelStarface6v2SOAPWindowsService" dir=in action=allow protocol= | TCPTDP localport=56745 edge=no |
|
|
Configure Firewall - Starface Located At External Network
...
Notez que si la STARFACE fait partie d'un autre réseau, vous devrez passer à edge=yes. Installer en tant que serviceEn utilisant une fenêtre de commande, comme Administrateur: | Translations Ignore |
|---|
| Code Block |
|---|
c: cd \jtelStarface6v2SOAPWindowsService c:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe -install jtelStarface6v2SOAPWindowsService.exe |
|
Trunc et Configuration des groupes de troncConnectez-vous en tant que sysadmin au portail de jtel. Système d'utilisation Paramètres ... Troncs pour configurer un tronc pour chaque machine à 8 serveurs. Notez que l'ID de la machine est défini dans la configuration à 8-server (généralement la dernière partie de l'adresse IP de la machine). Image Added
Créer un nouveau groupe de tronc pour chaque STARFACE PBX. Les paramètres suivants sont requis. | Paramètre | Valeur |
|---|
| Nom | Par exemple STARFACE | | Code du pays | Sélectionnez le bon code de pays | | Sélection du tronc sortant | Groupe de travail pour les numéros internes | Réglé sur le même groupe de troncs (explicitement) | | Groupe de tronc pour les numéros externes | Réglé sur le même groupe de troncs (explicitement) | | Accès général pour les appels sortants | Ne cochez cette option que s'il s'agit d'une installation pour un seul client. | | Traducteur du numéro | Appelant entrant | E.164 avec + entrant | | Appelé entrant | STARFACE - supprimer le paramètre du convertisseur (généralement 019900) | | Paramètres du convertisseur | 019900 | | Appel sortant | VOIP - Ajouter le préfixe "sip:+", puis le numéro E.164 et le préfixe postal "@<Converter Parameter> | | Paramètres du convertisseur | <IP_Address_8-Server>:5060 Par exemple: 192.168.1.1:5060 | | Appelé sortant | VOIP - Ajouter le préfixe "sip :", puis le numéro E.164 et le postfix "@<Converter Parameter>". | | Paramètres du convertisseur | <IP_Address_STARFACE>:5060 Par exemple: 192.168.1.100:5060 | | Longueur du numéro interne | Fixer la longueur maximale des numéros d'extension PBX internes, par exemple 3 |
Ajoutez le tronc créé ci-dessus pour le PBX à la page Trunks. N'OUBLIEZ PAS CELA, OU CELA NE FONCTIONNERA PAS ! Voir la capture d'écran ci-dessous pour un exemple de configuration : Image Added
Les numéros de service sont configurés comme des numéros E.164 pleinement qualifiés. Numéros de téléphone des agents / Destinations internes des PBXLes numéros de téléphone des agents sont configurés uniquement avec le numéro du poste interne, et non comme des numéros E.164 pleinement qualifiés.
|
| Sv translation |
|---|
|
| Code Block |
|---|
| Der Anschluss der Starface v6 TK-Anlage erfordert die Lizenzierung des o-byte Anschlusses von o-byte und die Installation auf der Starface TK-Anlage.
Diese Anleitung behandelt die Konfiguration des jtel Systems.
jtel benötigt die IP-Adresse des Starface Endpunktes. Entweder die IP aus dem lokalen Netzwerk, oder eine öffentliche IP-Adresse, wenn sich das Starface an einem anderen Ort befindet.
jtel benötigt eine Rufnummer und einen Benutzer für den Test.
Weitere Anleitungen zur Konfiguration der Starface-Telefonanlage und des o-byte Connectors können bei o-byte angefordert werden. |
jtel STARFACE v6.2 DienstDer jtel STARFACE v6.2 Service muss auf einem der Telefonie-Server-Maschinen installiert sein. Dateien KopierenKopieren Sie das folgende Verzeichnis auf den Telefonieserver: | Translations Ignore |
|---|
| Code Block |
|---|
Source Directory:
\\acd-store\shared\JTELCarrierPortal\WebServices\Install\Starface\ServiceV62
Target Directory:
c:\jtelStarface6v2SOAPWindowsService |
|
KonfigurationÜberprüfen Sie die Konfigurationsdatei jtelStarface6v2SOAPWindowsService.exe.config, ob Änderungen erforderlich sind. Am wahrscheinlichsten sind Änderungen an den Abschnitten: - <connectionStrings>- für die Verbindung mit der Datenbank
<appSettings> - für die Angabe des Rechners und des UDP-Ports des acd-Daemon-Prozesses <log4net> - für die Angabe des Speicherorts der Protokolldatei
Firewall KonfigurierenWenn die Windows-Firewall aktiv ist, fügen Sie eine Regel hinzu, die http-Verkehr für den Webdienst zulässt. Verwenden Sie in einem cmd-Fenster als Administrator den folgenden Befehl: | Translations Ignore |
|---|
| Code Block |
|---|
| netsh advfirewall firewall add rule name="jtelStarface6v2SOAPWindowsService" dir=in action=allow protocol=TCP localport=56745 edge=no |
|
Wenn sich das STARFACE in einem anderen Netzwerk befindet, müssen Sie auf edge=yes |
Install as Service
...
umstellen und eine öffentliche Remote-IP-Adresse in den SIP- und RTP-Firewall-Regeln konfigurieren, um den Zugang zu ermöglichen. Als Dienst installierenVerwenden Sie ein Befehlsfenster als Administrator: | Translations Ignore |
|---|
| Code Block |
|---|
c:
cd \jtelStarface6v2SOAPWindowsService
c:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe -install jtelStarface6v2SOAPWindowsService.exe |
|
Trunk |
...
Login as sysadmin to the jtel Portal.
Configure Trunks
Use System Settings ... Trunks to configure a trunk for each 8-Server machine.
...
und Trunk-Gruppen KonfigurationMelden Sie sich als Systemadministrator am jtel Portal an. Trunks KonfigurierenVerwenden Sie Systemeinstellungen → Trunks, um eine Leitung für jeden 8-Server-Rechner zu konfigurieren. Beachten Sie, dass die MachineID in der 8-Server-Konfiguration festgelegt wird (normalerweise der letzte Teil der IP-Adresse des Rechners). Image Modified
|
Create a new trunk group for each STARFACE PBX.
Legen Sie für jede STARFACE Telefonanlage eine neue Leitungsgruppe an. Die folgenden Parameter sind erforderlich |
...
...
| Wert |
|---|
| Name | For example STARFACE | | Country Code |
|
...
| Wählen Sie die korrekte Ortsvorwahl | | Outgoing Trunk Selection | Trunk |
|
...
| -Gruppe für interne Ziele | Auf dieselbe Trunk-Gruppe einstellen | | Trunk-Gruppe für externe Ziele | Auf dieselbe Trunk-Gruppe einstellen | | Frei verfügbar für ausgehende Anrufe |
|
...
| Only check this option, if this is a single customer installation. | | Number Translator |
|
...
| Eingehend Anrufer Nummer | E.164 with + incoming |
|
...
| Eingehend Angerufene Nummer | STARFACE - remove converter parameter (usually 019900) | | Converter Parameter | 019900 | | Outgoing Caller | VOIP - Add prefix "sip:+", then E.164 number and postfix "@<Converter Parameter> | | Converter Parameter | <IP_Address_8-Server>:5060 For example: 192.168.1.1:5060 | | Outgoing Called | VOIP - Add prefix "sip:", then E.164 number and postfix "@<Converter Parameter>" | | Converter Parameter | <IP_Address_STARFACE>:5060 For example: 192.168.1.100:5060 | | Internal Number Length | Set to the maximum length of internal PBX extension numbers, for example 3 |
Add the trunk created above for the PBX to the Trunks page. DO NOT FORGET THIS, OR IT WILL NOT WORK! See the screenshot below for an example configuration: Image Modified
Service-Numbers are configured as fully qualified E.164 numbers. Agent Telephone Numbers / PBX Internal DestinationsAgent telephone numbers are configured only with the number of the internal extension, not as fully qualified E.164 numbers.
|