Installer PBXware
Bienvenue dans le guide d’installation de PBXware, une solution de téléphonie professionnelle tout-en-un basée sur le système de gestion d’appels VoIP.
Ce document est conçu pour vous guider étape par étape tout au long du processus d’installation de PBXware sur votre serveur, en assurant une configuration optimale pour vos besoins en matière de communication.
Avant de commencer, veuillez vous assurer que vous disposez de tous les prérequis nécessaires, y compris l’accès à un serveur compatible, une connexion internet stable, ainsi que les informations spécifiques à votre configuration réseau.
INFORMATION :
L’installation de PBXware nécessite des connaissances de base en gestion de serveurs. Il est utile d’avoir une certaine expérience en réseau, systèmes d’exploitation Linux et plateformes de virtualisation (comme VMware ou Hyper-V).
Ce document décrit les étapes pour installer manuellement PBXware.
L’installation de PBXware nécessite des connaissances de base en gestion de serveurs. Il est utile d’avoir une certaine expérience en réseau, systèmes d’exploitation Linux et plateformes de virtualisation (comme VMware ou Hyper-V).
Prérequis
- Plateforme matérielle ou virtuelle : Une machine physique (par exemple, un serveur bare-metal) ou une machine virtuelle
- Image ISO de PBXware : Téléchargez la dernière version de l’ISO de PBXware depuis le centre de téléchargements
- Média de démarrage : Une clé USB bootable, un ISO gravé, ou la possibilité de démarrer depuis le réseau (par exemple, via une carte ILO sur un serveur physique).
- Compatibilité matérielle : Assurez-vous que votre matériel est compatible avec les exigences de PBXware décrites dans la section ci-dessous.
Ces prérequis garantissent une installation fluide et efficace de PBXware sur votre système.
Configuration requise
Ressources requises pour les installations PBXware :
| Minimum | Suggéré | |
|---|---|---|
| CPU | Quad Core x86 CPU1 | Quad Core ou plus récent Xeon CPU |
| RAM | 2 Go2 | 4 Go |
| Stockage | 10 Go HDD | 20 Go SSD |
| Réseau | Carte réseau 1 Go | Carte réseau 1 Go avec OOBM³ sur une carte réseau dédiée |
1 – Processeur de bureau Intel Gen 8 et plus récent (Gen 8 publié en 2017)
2 – 2 Go est minimum pour l’édition Business, cependant les éditions Call Center (sans Clickhouse) et Multi-Tenant nécessitent un minimum de 4 Go de RAM sur les installations standalone.
3 – OOBM (Out Of Band Management) – IPMI, iDRAC, iLO ou plateforme similaire.
Si la base de données Clickhouse est utilisée, le processeur doit prendre en charge les instructions SSE4.2
Les processeurs compatibles incluent :
- Intel® : Celeron®, Pentium® II, Pentium III, Pentium 4, Xeon™, Core®, Core® 2, Core® iX, Atom
- AMD™ : Athlon™, Athlon MP, Athlon XP, série Athlon X, Duron™, Opteron™
- Via : C3, C7
Veuillez noter que si le serveur fonctionne à partir d’une IP LAN privée, le pare-feu doit être configuré pour ouvrir/rediriger certains ports.
Les exigences matérielles ci-dessus devraient être suffisantes pour les systèmes à usage faible à modéré.
Cependant, en raison d’un grand nombre de variables telles que le nombre d’extensions actives, le nombre d’appels simultanés, le nombre de groupes de sonnerie, l’enregistrement d’appels, le transcodage, etc., la seule façon de savoir si le matériel spécifique répondrait à vos besoins est de faire des tests approfondis ou de déployer un matériel qui dépasse nos recommandations matérielles suggérées.
De plus, veuillez vous assurer de prendre en compte l’expansion future du système, car chaque mise à niveau matérielle future entraînera un temps d’arrêt du système et une possible interruption de service pour vos utilisateurs. Par conséquent, une certaine marge matérielle est fortement recommandée pour chaque installation.
Veuillez noter que les seules plateformes OS officiellement supportées pour PBXware sont les distributions suivantes :
- Linux Gentoo
- Artix (basées sur Arch).
Navigateurs pris en charge
Liste non exhaustive de tous les navigateurs pouvant prendre en charge l’affichage de PBXware :
- Chrome
- Firefox
- Safari
- Opéra
- Microsoft Edge
- Brave
- …
Assistance par le support
Afin de fournir un support complet en cas de nécessité, nous avons besoin d’un accès au système par les protocoles SSH, HTTP/HTTPS. Les éléments suivants sont requis :
• Accès au serveur système en tant qu’utilisateur ‘root’
• Configuration réseau opérationnel, redirection ou ouverture de ports vers les ports 2020, 80, 81 et 443.
Guide d’installation
PBXware peut être installé par l’une des méthodes suivantes :
- La méthode d’installation sur CD-ROM
- La méthode d’installation sur USB
- La méthode d’installation sur SERVERware
- La méthode d’installation par image VMware
Afin de fournir un support complet en cas de nécessité, nous avons besoin d’un accès au système par les protocoles SSH, HTTP/HTTPS. Les éléments suivants sont requis :
- La méthode d’installation USB est similaire à la méthode CD ROM. La seule différence est le support de démarrage qui contient les fichiers d’installation de PBXware.
- L’installation Virtual Server est un système PBXware contenu dans un vServer (VPS) sur l’installation de SERVERware.
- L’image VMware est pré-installée avec PBXware afin que vous puissiez la tester sur votre propre ordinateur sans matériel spécial dédié.
N’importe lequel des méthodes d’installation résultera dans l’installation et le démarrage de la machine et tous les logiciels nécessaires, permettant à l’administrateur de se connecter à cette machine à partir d’un navigateur.
NOTE :
Si votre instance se situe derrière un pare-feu, certains ports sont à ouvrir, veuillez trouver la liste des ports ci-dessous.
Ports à ouvrir
Voici la liste des différents ports à ouvrir sur votre pare-feu si votre instance PBXware se situe derrière celui-ci.
Ouvrir ces ports assurera un bon fonctionnement de PBXware.
Ports de mise à jour
- TCP : 873
Interface web
- TCP : 80, 81, 443
Accès SSH
- TCP : 2020
Trafic SIP
- TCP : 10001, 5060-5069
- UDP : 4000-4999, 5060-5069, 10000-20000
Trafic IAX
- TCP : 5037, 5038
- UDP : 4569
PWProxy
- TCP : 10005, 10007, 10009
Annuaire centralisé
- TCP : 11389, 11636
BSSUP (Accès support)
- TCP : 2244
Installation physique
L’installation peut être réalisée à l’aide de l’option LiveCD ou en créant une clé USB bootable, mais l’installation à l’aide d’une clé USB bootable sera réalisée beaucoup plus rapidement.
Les instructions relatives à la création d’une clé USB amorçable sont disponibles sur le lien suivant :
TUTO : Créer une clé USB bootable pour installer PBXware
Insérez la clé USB sur un des ports USB de la machine physique, puis mettez sous tension la machine.
Suivez désormais : Étapes d’installation
Installation CD-ROM
ATTENTION :
La méthode CD-ROM installera PBXware sur le disque dur et effacera toutes les données, systèmes d’exploitation et autres fichiers déjà existants.
Pour installer système à l’aide d’un CD-ROM, procédez comme suit :
- Téléchargez et gravez l’image du CD-ROM à partir de notre lien de téléchargement
- Démarrez le système, attendez que le programme d’installation démarre et suivez les instructions à l’écran
- Le système sera installé et redémarré. Une fois le système démarré, l’écran affichera l’adresse IP obtenue.
- Veuillez vous connecter à l’assistant de configuration à l’aide de votre navigateur Web préféré en accédant à http://ADRESSE_IP (par exemple : http://192.168.1.2).
IMPORTANT :
L’assistant de configuration demande un nom d’utilisateur/mot de passe de afin d’empêcher tout accès non autorisé.
Les valeurs par défaut sont :
- nom d’utilisateur : root
- mot de passe : pbxware
L’assistant de configuration vous demandera de modifier le mot de passe dans l’une des étapes de l’assistant de configuration. Une fois modifié, il est très important de se souvenir de ce mot de passe car il s’agit du mot de passe de la racine du système et de l’assistant de configuration.
Installation par clé USB
Téléchargez l’image ISO à partir de notre lien de téléchargement
1. Copiez l’image ISO téléchargée sur une clé USB à l’aide d’un créateur de support bootable (type Rufus)
2. Insérez la clé USB sur votre machine
3. Configurez le BIOS de votre machine pour qu’il démarre à partir du périphérique USB
4. Démarrez votre machine, attendez que le programme d’installation démarre et suivez les instructions à l’écran
5. Suivez la partie Étapes d’installation.
Installation via ServerWARE
1. Dans l’onglet VPS, cliquez sur le bouton Create VPS.
2. Renseignez les options demandées par l’assistant de création telles que le nom, le template (version), les ressources matérielles & le réseau.
3. Une fois la machine virtuelle PBXware avec SERVERware créée, accédez à l’adresse IP dans votre navigateur et vous atterrirez sur l’assistant de configuration. Ici, configurez votre système.
4. Suivez désormais ce guide pour déployer votre standard PBXware.
NOTE :
Lorsque la VPS est créée sur SERVERware, l’OS ainsi que PBXware sont installés automatiquement sans aucune action de votre part.
Vous pouvez, dès lors, accéder à l’interface graphique de PBXware.
Installation sur un hyperviseur (VMware, Proxmox, Hyper-V)
Pour installer PBXware sur un hyperviseur, vous devez télécharger l’image ISO PBXware à partir de notre plateforme de téléchargements
NOTE IMPORTANTE :
Afin d’installer PBXware sur une machine virtuelle VMware, certains paramètres doivent obligatoirement être configurés.
Afin d’installer et de démarrer correctement la machine sur un environnement VMware (ESXi, vSphere, Workstation…), il vous faudra vous assurer que les deux paramètres suivants sont configurés :
• Type de contrôleur SCSI
• Options de démarrage
Le contrôleur SCSI doit être défini sur LSI Logic Parallel comme le montre l’image :
Le microprogramme doit être défini sur BIOS comme le montre l’image :
Ces options ne diffèrent pas entre la création de la machine virtuelle sur l’ESXi directement ou sur la plateforme de centralisation vSphere.
Une fois le téléchargement terminé, extrayez l’image téléchargée sur votre disque et ouvrez le dossier extrait. Importez le fichier PBXware_x.iso avec VMware Player/Workstation/Fusion ou Proxmox dans l’option « Lecteur de CD/DVD » et exécutez la machine virtuelle.
1. Démarrez la machine virtuelle en vous assurant que vous avez bien sélectionné le fichier ISO dans votre lecteur CD/DVD virtuel, attendez que le programme d’installation démarre et suivez les instructions à l’écran
2. Suivez la partie Étapes d’installation
NOTE POUR HYPER-V :
Un fichier au format .iso a été spécialement conçu pour les installations Hyper-V.
Ce fichier permet de charger les modules de réseau spécifiques à Hyper-V.
Veuillez cliquer ici pour le télécharger.
Démarrage & installation de PBXware
Si votre installation a été effectuée ailleurs que sur un environnement SERVERware, vous devrez suivre les étapes d’installation suivantes.
Une fois la machine virtuelle créée et démarrée, l’assistant d’installation vous aidera à configurer PBXware pour un premier démarrage.
1. Démarrez la machine physique/virtuelle
2. Sur l’accueil de l’assistant d’installation, vous pourrez aperçevoir l’adresse IP détectée par votre machine.
L’adresse IP PBXware peut être obtenue par :
• Obtention du serveur DHCP
• Connexion d’un moniteur à l’unité PBXware et obtention de l’adresse IP à partir de l’invite de commande en saisissant la commande ifconfig
• Installation de PBXware Finder sur une machine Windows également connectée au même réseau. PBXware Finder peut être téléchargé sur ce lien
Sélectionnez l’option Next.
3. Sélectionnez le disque sur lequel vous souhaitez installer PBXware & cliquez sur Next
4. Confirmez que vous souhaitez bien utiliser ce disque pour installer PBXware & cliquez sur Next
5. PBXware formattera les partitions du disque choisi 
6. Une fois les partitions formattées, PBXware sera installé sur le disque choisi 
7. Configurez désormais la carte réseau que vous souhaitez utiliser. Celle-ci sera détectée automatiquement. Cliquez sur Next
8. Sélectionnez une des quatre options qui permettent respectivement de :
• Configurer la carte réseau choisie
• Créer une carte réseau virtuelle en mode pont
• Créer une carte réseau virtuelle en mode liaison
• Créer une carte réseau virtuelle en mode liaison & pont
Sélectionnez une des quatre options & cliquez sur Next
9. Sélectionnez la carte réseau que vous souhaitez configurer & cliquez sur Next
10. Les options de la carte réseau choisie seront affichées dans le résumé suivant :
11. Sélectionnez une des deux options qui permettent d’utiliser le DHCP ou d’assigner une adresse IP manuellement & cliquez sur Next.
12. Cliquez sur Finish pour finaliser la configuration de votre interface réseau 
13. Une récapitulatif de l’installation s’affiche désormais. Celui-ci vous informe que le système a été installé avec succès et qu’un redémarrage est nécessaire. Cliquez sur Next. 
14. Redémarrez votre système (celui-ci redémarrera automatiquement au bout de 20 secondes sans action de votre part). 
15. PBXware a été installé avec succès. Accédez désormais à l’adresse IP mentionnée pour pouvoir accéder à l’assistant de configuration en ligne de PBXware.
IMPORTANT :
L’assistant de configuration demande un nom d’utilisateur/mot de passe de afin d’empêcher tout accès non autorisé.
Les valeurs par défaut sont :
- nom d’utilisateur : root
- mot de passe : pbxware
L’assistant de configuration vous demandera de modifier le mot de passe dans l’une des étapes de l’assistant de configuration. Une fois modifié, il est très important de se souvenir de ce mot de passe car il s’agit du mot de passe de la racine du système et de l’assistant de configuration.
Assistant d’installation
Une fois l’installation de l’OS terminée, rendez-vous sur un navigateur web à l’adresse IP de votre instance PBXware pour démarrer le déploiement.
L’assistant d’installation est conçu pour recueillir les données essentielles afin de rendre le système opérationnel. Une fois l’assistant d’installation terminé, le système devrait être entièrement sous licence, entièrement opérationnel et prêt à être utilisé.
Si vous avez décidé d’installer PBXware sur une autre plateforme que SERVERware, le mot de passe par défaut pour accéder à l’assistant d’installation est pbxware.
EULA
Détails de l’administrateur
- E-mail/Confirmer l’E-mail
L’adresse e-mail fournie est utilisée comme nom d’utilisateur pour se connecter.
- Mot de passe/Confirmer le mot de passe
Le mot de passe fourni est utilisé pour se connecter
Détails du serveur
- Mot de passe root
PBXware vous demande ce mot de passe lors de la connexion au système/SSH et lors de l’accès aux services du système par l’interface web.
- Confirmer le mot de passe
Retapez le mot de passe root saisi dans le champ ci-dessus.
- Fuseau horaire
Sélectionnez le fuseau horaire dans lequel se trouve PBXware.
Licence
La partie licence vous permet d’entrer une licence valide (non-active). Si le système possède plus d’une carte réseau, toutes les adresses MAC trouvées seront affichées.
- Type de licence
Sélectionnez un type de licence pour le système. Le système est livré avec deux types de licence : Licence Gratuite et Requested (payante).
- Numéro de licence
Entrez le numéro de licence de PBXware, sélectionnez l’adresse MAC s’il y en a plusieurs et cliquez sur ‘Next’ pour enregistrer.
- L’adresse MAC associée à PBXware.
REMARQUE : La machine doit avoir accès à une connexion Internet afin de récupérer la licence. Si plus d’une adresse MAC est présente, sélectionnez celle que vous souhaitez associer à PBXware et cliquez sur ‘Next’.
Localité
Localité permet d’entrer les valeurs « locales » du système afin de définir toutes les valeurs nécessaires au fonctionnement normal du système.
- Pays
Sélectionnez le pays dans lequel PBXware est situé.
- Indicatif
L’indicatif téléphonique où se trouve PBXware, par exemple, si PBXware se trouve en France, vous devrez définir ‘33’.
- Longueur de l’extension
Le nombre de chiffres que PBXware va associer aux extensions locales.
Si ce champ est réglé sur ‘3’, toutes les extensions locales auront une plage de 100-999.
Si ce champ est réglé sur ‘4’, toutes les extensions locales auront une plage de 1000-9999...
- Police / Pompiers / Ambulance
Le numéro de téléphone des services d’urgence dans la région où se trouve PBXware (ex : Police : 17, Pompiers : 18, Ambulance : 15)
PBXware possède une option pour appeler ces services d’urgence à travers certains trunks. Si tous les canaux sont occupés, un appel actif sera interrompu afin de composer ces numéros en urgence.
Musique d’attente
- Musique d’attente libre de droits (Royalty Free)
Cette opération permet de télécharger une musique libre de droits qui peut être utilisée comme musique d’attente par défaut. Elle pourra être modifiée ultérieurement.
Confirmation
Enfin, l’étape de confirmation vous permet de revérifier toutes les valeurs et de terminer l’assistant ou de recommencer depuis le début. Si vous cliquez sur « Confirmer et finaliser« , l’assistant de configuration se termine et le navigateur est redirigé vers l’écran de connexion du système.
Si vous cliquez sur ce bouton, tous les détails fournis seront réinitialisés et vous reviendrez à la première étape.
Cliquez sur ce bouton pour confirmer les données fournies dans l’assistant d’installation et finaliser l’installation. Tous les détails fournis seront appliqués et l’assistant d’installation vous redirigera vers l’écran de connexion de PBXware.
Connexion au système
- Écran de connexion
Afin de vous connecter au système, veuillez diriger votre navigateur vers : http://ADRESSE_IP/ (Par exemple : http://192.168.1.2/)
- Adresse mail
Il s’agit de l’adresse électronique de l’administrateur que vous avez définie dans l’assistant de configuration initiale.
- Mot de passe
Il s’agit du mot de passe de l’administrateur que vous avez défini dans l’assistant de configuration initial
PBXware est désormais pleinement installé et prêt à être mis en production.
Suivez notre guide Premiers pas pour commencer à déployer vos premières extensions & configurations.
