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
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 |
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.
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:
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.
tip
Assurez-vous que ' Activer 2FA' est désactivé.
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
É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
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.
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/
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}
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 #
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
Désinstaller #
Exécutez le script avec Supprimer comme paramètre
sudo ./install.sh supprimer
Cela vous demandera si vous souhaitez retirer le connecteur
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
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.
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 :
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.