3CX Connexion

3CX Connexion #

Cette connexion fournit un service de collecte de données pour le 3CX plate-forme de communication. Il fournit une modélisation des données d'appel pour permettre l'utilisation de l'analyse des appels (tableaux de bord/Wallboards) sur des 3CX installations.

Cette page explique comment installer le 3CX Service de collecteur à distance sur un 3CX PBX

Exigences #

Les conditions suivantes doivent être remplies pour déployer ~.Dimensions.~ sur un 3CX installation.

  • Auto-hébergé 3CX Exécution de la version 18.0 ou ultérieure1 sous Linux
  • Compte utilisateur administrateur dédié sur le 3CX système

Information Circle info

Complet 3CX informations sur le support de la version de publication ici.

Le ~.Dimensions.~ 3CX s'exécutera sur le 3CX pour collecter des données et les transmettre à l'ordinateur principal ~.Dimensions.~ Solution cloud pour le stockage et l'analyse. Le collecteur utilise peu de ressources CPU, mais a un impact sur les besoins en mémoire du 3CX hôte.

Le tableau ci-dessous fournit un guide sur l'utilisation de la mémoire du collecteur.

Appels simultanés Utilisation prévue de la mémoire
4 - 32 ~ 350 Mo
48 - 64 ~ 600 Mo
96 - 128 ~ 750 Mo
192 - 256 ~ 900 Mo
512 - 1024 ~ 1024 Mo

Document note

Les besoins en mémoire sont affectés par le nombre d'appareils, d'utilisateurs et le taux d'appels. Soyez prêt à déployer plus de mémoire si nécessaire.


  1. Vérifiez que vos versions sont prises en charge ici avant la mise à niveau. ↩︎

Installation #

Étape 1 - 3CX Configuration du compte utilisateur #

Veuillez créer un ' Propriétaire du système' compte (avec un mot de passe complexe) pour ~.Dimensions.~ sur le 3CX instance:

image.png

Ce compte est utilisé par le ~.Dimensions.~ Logiciel collecteur permettant d'interroger les informations de configuration et de licence à partir du 3CX qui est nécessaire pour modéliser correctement le trafic d'appels.

Color Wand tip

Assurez-vous que ' Activer 2FA' est désactivé.

Color Wand tip

Les informations d'identification de l'utilisateur pour ce compte seront nécessaires à l'étape 2.

Étape 2 - ~.Dimensions.~ Création d'un compte client #

Dans le ~.Dimensions.~ portail revendeur, créez un nouveau PBX connexion, en entrant dans le 3CX Clé de licence, nom d'utilisateur/ext et mot de passe de l'étape précédente

image.png

Étape 3 - ~.Dimensions.~ 3CX Installation du collecteur #

Maintenant que le ~.Dimensions.~ Un compte client a été créé, le collecteur Dimensions peut être installé sur le 3CX instance. Une fois installé, il se reconnectera automatiquement au ~.Dimensions.~ Le compte client utilise les informations de clé de licence et commence à modéliser l'activité des appels et des utilisateurs.

  • SSH dans le 3CX instance.

  • Assurez-vous que vous commencez dans le dossier d'accueil des utilisateurs

CD $home
  • Téléchargez le script d'installation à partir du site Web du client pour cette région (NA, UK, EU ou AU)
wget -O install.sh https://clients. {région}.myreports.cloud/3cx/install.sh

Information Circle info

Remplacez {region} par n (Amérique du Nord), Royaume-Uni (Royaume-Uni), eu (Union européenne) ou au (Australie/Nouvelle-Zélande), en fonction de votre région.

Hand Left warning

Le -O flag écrase tout script existant dans ce dossier

  • Rendre le script exécutable
chmod +x ./install.sh
  • Exécutez le script en fournissant le numéro de version que vous souhaitez installer, par ex.
sudo ./install.sh dernier

Cela doit indiquer que le chemin d'installation est introuvable et effectuer une nouvelle installation sur /opt/RemoteCollector.ThreeCx/

image.png

Le collecteur doit maintenant être installé et doit commencer à transmettre les informations d'appel et d'utilisateur au serveur pour activer les fonctionnalités d'analyse.

Étape 4 - Personnalisations #

Si vous utilisez un port non standard sur votre 3CX système, vous devrez mettre à jour un ' settings.json' fichier avec les détails corrects pour le ~.Dimensions.~ 3CX Collecteur pour se connecter au 3CX système avec succès.

Modifiez le fichier suivant :

/opt/RemoteCollector.ThreeCx/settings.json

Modifiez les deux paramètres suivants :

 « AutoDetectHost » : false,
 « ThreeHostPort » : {CUSTOMVALUE}

Information Circle info

Le ' settings.json' est créé par le collecteur après son installation.

Un exemple de ' settings.json' lime:

{
  « PersistedSettings » : {
    « TenantId » : «  »,
    « LicenseKey » : «  »,
    « InstrumentationConnectionString » : «  »,
    « EnableAutoUpdate » : true,
    « AutoUpdateTime » : « 02:00:00 »,
    « AutoDetectHost » : false,
    « ThreeHostProtocol » : « https »,
    « ThreeHost » : « 127.0.0.1 »,
    « ThreeHostDisableSslValidation » : true,
    « ThreeHostPort » : 1234
}

Mise à niveau #

Automatiquement #

De la PBX Configuration du collecteur dans ~.Dimensions.~ Appuyez sur la touche Mise à niveau bouton.

Manuellement #

Exécutez le script avec le nouveau numéro de version et il mettra automatiquement à jour le logiciel :

sudo ./install.sh 1.87.2

Le message doit indiquer qu'une installation a été trouvée et qu'elle est en cours de mise à niveau

image.png

Désinstaller #

Exécutez le script avec Supprimer comme paramètre

sudo ./install.sh supprimer

Cela vous demandera si vous souhaitez retirer le connecteur

image.png

Appuyez sur Y Pour continuer, cela supprimera le service, tous les fichiers et journaux.

Installation d'une version spécifique #

Si le support vous le demande, vous devrez peut-être installer une version spécifique du collecteur (pour prendre en charge une version plus ancienne 3CX ou tester un correctif par exemple).

Pour installer une version spécifique, entrez la version spécifique plutôt que Dernier :

sudo ./install.sh 1.87.1
Hand Left warning
Ne le faites que si l'assistance vous le demande.

Contrôler le service #

Arrêter le service

systemctl stop RemoteCollector.ThreeCx.service

Démarrer le service

systemctl start RemoteCollector.ThreeCx.service

Obtenir l'état du service

systemctl status RemoteCollector.ThreeCx.service

Voir les journaux de service

Voir les journaux

journalctl -xeu RemoteCollector.ThreeCx.service

Suivez les journaux en direct :

journalctl -xefu RemoteCollector.ThreeCx.service

Journaux #

Par défaut, les journaux sont installés pour

/opt/RemoteCollector.ThreeCx/logs

Ceux-ci sont zippés dans un dossier d'archive sur une base quotidienne.

image.png

Les journaux peuvent être récupérés à partir du client à l'aide du bouton Push logs dans le menu Modifier PBX Écran du portail revendeur :

image.png

Voir Installé 3CX Version #

Pour afficher la version installée de 3CX en cas de connexion via SSH :

politique apt-cache 3cxpbx

Cela renverra la version installée et la dernière version disponible.

image.png