# Installation et mise à jour
Nous vous recommandons de planifier soigneusement l'installation dès l'étape de sélection de l'équipement en fonction des scénarios d'utilisation prévus.
# Vérification de la clé d'enregistrement
Avant d'installer TrueConf Server, assurez-vous de disposer d'une clé d'enregistrement. Vous l'avez probablement déjà reçue lors du téléchargement de l'installateur du serveur depuis notre site ou lors de son achat auprès de l'un de nos partenaires. Dans ce cas, passez cette étape et allez directement à l'installation de TrueConf Server. Sinon, vous devrez obtenir la clé comme indiqué dans la section "Enregistrement".
# Installation du serveur
TrueConf Server est fourni sous la forme d'un package incluant la partie serveur et des applications clientes pour le système d'exploitation Windows. Les applications clientes de TrueConf pour d'autres systèmes d'exploitation populaires sont disponibles sur le site web de TrueConf (des liens pour les télécharger peuvent être trouvés sur la page d'accueil TrueConf Server).
Lors de l'installation de TrueConf Server Free derrière un pare-feu, il est nécessaire d'ouvrir le port 4310 pour notre serveur d'enregistrement reg.trueconf.com afin de compléter l'enregistrement.
Si vous avez acheté une licence payante, il n'est pas nécessaire d'ouvrir un port et vous pourrez utiliser l'enregistrement hors ligne.
# Quels services seront ajoutés au système d'exploitation après l'installation
# Windows
TrueConf Server — service principal. Elle est responsable du fonctionnement des fonctions de base du système de visioconférence : appels point à point, visioconférences, messagerie, etc.
TrueConf Database — service de serveur de base de données. La base de données stocke les discussions et les journaux. Le fonctionnement de TrueConf Server Manager dépend du service TrueConf Database.
TrueConf Web Manager — est responsable du fonctionnement du panneau de contrôle TrueConf Server, de la page d'accueil, de l'area personal, du planificateur, de l'application web (connexion à la conférence via un navigateur utilisant WebRTC), ainsi que des paramètres HTTPS. Si ce service est désactivé, vous ne pourrez pas utiliser les fonctionnalités mentionnées ci-dessus.
TrueConf Server Manager — gestionnaire d'interaction avec le registre Windows et les fichiers de configuration. Nécessaire pour afficher certaines données dans le panneau de contrôle TrueConf Server.
TrueConf Bridge — un service qui reçoit des messages websocket (commandes) des applications web et les convertit en messages de transport compréhensibles pour TrueConf Server.
# Linux
trueconf — le service principal, le moteur du serveur. Il est responsable du fonctionnement des fonctions de base du système de visioconférence : appels point à point, visioconférences, messagerie, etc.
trueconf-db — est le service de base de données. La base contient toutes les données de TrueConf Server : discussions, liste des utilisateurs, conférences, groupes, liste des paramètres du serveur web, etc.
trueconf-web — est responsable du fonctionnement du panneau de contrôle TrueConf Server, de la page d'accueil, de l'aire personnelle, du planificateur, de l'application web (WebRTC) et des paramètres HTTPS. Si ce service est désactivé, vous ne pourrez pas utiliser les fonctionnalités mentionnées ci-dessus.
trueconf-manager — gestionnaire de bases de données et de fichiers de configuration. Nécessaire pour afficher certaines données dans le panneau de contrôle TrueConf Server.
trueconf-php — le service est responsable du traitement de certains scripts et est un service système interne.
trueconf-bridge — un service qui reçoit des messages websocket (commandes) des applications web et les convertit en messages de transport compréhensibles pour TrueConf Server.
# Installation sur le système d'exploitation Windows
Sur la page qui s'affiche après avoir rempli le formulaire, accédez à l'onglet Windows et cliquez sur le bouton Download TrueConf Server.
Une fois le fichier d'installation téléchargé, lancez-le pour commencer l'installation. Le processus d'installation prendra moins d'une minute.
Pendant le processus d'installation, vous pouvez spécifier :
Port TCP Web — pour accéder au panneau de contrôle via HTTP;
Port TCP de la base de données — pour accéder au système de rapports du serveur.
Le port de la base de données pour les rapports du serveur est par défaut 5444; il est sélectionné lors de l'installation et ne peut pas être modifié par la suite (sauf par une réinstallation complète de TrueConf Server). Pour le panneau de contrôle, le port par défaut est 80 ou 8888 (si le port 80 n'est pas disponible). Si les ports 80 et 8888 sont tous deux indisponibles, vous devrez le spécifier vous-même lors de l'installation.
Si le panneau de contrôle ne s'ouvre pas sur le port spécifié après l'installation, il se peut qu'il soit occupé par un autre processus, et vous devrez alors configurer un autre port manuellement.
Si le port du panneau de contrôle n'est pas égal à 80 (pour une connexion HTTP) ou à 443 (pour une connexion HTTPS), vous devez le spécifier explicitement dans la barre d'adresse du navigateur après les deux-points suivant le nom d'hôte pour ouvrir le panneau de contrôle (par exemple, http://localhost:8080).
Une fois l'installation terminée, le panneau de contrôle de l'administrateur s'ouvrira automatiquement dans le navigateur.
Pour accéder au panneau de contrôle, vous devez entrer le nom d'utilisateur et le mot de passe de votre compte système sous lequel le serveur a été installé.
# Installation sur les systèmes d'exploitation Linux
Les étapes principales pour l'installation sur Linux à partir d'un fichier (paquet téléchargé) sont présentées ci-dessous. Une option d'installation à partir du dépôt est également disponible et décrite dans la section correspondante de l'article sur l'installation détaillée pour chaque système d'exploitation :
Étant donné que TrueConf Server inclut son propre serveur web, il est recommandé d'installer un système d'exploitation sans serveur web préinstallé pour éviter d'éventuels conflits.
Étape 1.
Tout d'abord, il est nécessaire d'ajouter à l'OS un utilisateur sous lequel l'installation sera effectuée et qui aura accès au panneau de contrôle du serveur. Vous pouvez utiliser le compte créé lors de l'installation de l'OS.
Vous ne pouvez pas utiliser trueconf comme nom pour un utilisateur du système d'exploitation ! Cela est dû au fait qu'un utilisateur portant ce nom sera automatiquement ajouté dans le système d'exploitation pour lancer certains services TrueConf Server en son nom. Si un tel utilisateur existe déjà, il doit être supprimé.
Pour savoir comment créer un utilisateur sous Linux, veuillez vous référer à la description dans la section configuration initiale du serveur.
Étape 2.
Sur la page qui s'affiche après avoir rempli le formulaire, allez dans l'onglet Linux où sont décrites les étapes suivantes.
Cliquez sur le lien dans le deuxième point pour accéder aux instructions détaillées d'installation de TrueConf Server pour Linux sur notre blog.
Étape 3.
Téléchargez le programme d'installation pour votre système d'exploitation.
Étape 4.
Lors d'un déploiement manuel, accédez au répertoire contenant le package d'installation téléchargé et exécutez les commandes indiquées ci-dessous en tant qu'administrateur, en fonction de votre système d'exploitation, où server-installation-file est le nom du fichier.
Sur Debian, Astra Linux :
apt install -yq ./server-installation-file.deb
Sur CentOS :
- Pour assurer le bon fonctionnement de TrueConf Server sur CentOS, il est nécessaire de désactiver SELinux, le système de contrôle d'accès des processus aux ressources du système d'exploitation. Pour cela, exécutez la commande suivante sous le compte administrateur :
sed -i 's/^SELINUX=.*/SELINUX=disabled/g' /etc/selinux/config
2. Vous devez également connecter le dépôt EPEL :
dnf install epel-release
3. Ce n'est qu'après cela que vous pouvez installer TrueConf Server :
dnf install -y server-installation-file.rpm
Lors de l'exécution de la commande d'installation à partir d'un fichier sur un système d'exploitation Linux, vous pouvez spécifier une liste d'utilisateurs ayant accès au panneau de contrôle dans un paramètre supplémentaire, sans utiliser la fenêtre de saisie des identifiants. Pour cela, ajoutez le paramètre TCADMINS_USERS=[users] à la commande d'installation avec la liste des utilisateurs nécessaires du système d'exploitation, par exemple sur Debian :
sudo TCADMINS_USERS=main_admin,second_admin apt install ./server-installation-file.deb
ou
sudo TCADMINS_USERS=main_admin apt install ./server-installation-file.deb
Étape 5.
Lors de l'installation, un champ apparaîtra pour saisir les noms des utilisateurs du système d'exploitation qui auront accès administratif au panneau de contrôle du serveur. Indiquez le nom de l'utilisateur précédemment créé.
Étape 6.
Les services TrueConf seront ajoutés dans le système d'exploitation, comme décrit précédemment. Le serveur web et le gestionnaire doivent démarrer automatiquement après l'installation.
Depuis un autre ordinateur de votre réseau local, accédez à la page du serveur installé en utilisant l'adresse IP de l'ordinateur sous Linux. Pour connaître l'adresse IP sur Linux, utilisez la commande ip a.
Pour accéder au panneau de configuration, le port par défaut choisi est le 80 ou le 8888 (si le port 80 n'est pas disponible). Si les ports 80 et 8888 sont tous deux indisponibles, vous devrez configurer un autre port manuellement après l'installation.
Si le port du panneau de contrôle n'est pas égal à 80 (pour une connexion HTTP) ou à 443 (pour une connexion HTTPS), vous devez le spécifier explicitement dans la barre d'adresse du navigateur après les deux-points suivant le nom d'hôte pour ouvrir le panneau de contrôle (par exemple, http://localhost:8080).
Comment accéder au panneau de contrôle depuis l'extérieur du réseau local (par exemple, lors de l'installation sur un serveur cloud) est expliqué en détail dans l'article de la base de connaissances.
Puisque le serveur n'est pas encore enregistré, la page d'authentification s'ouvrira avec les droits d'administrateur à la place de la page d'accueil. Connectez-vous avec les informations d'identification de l'utilisateur précédemment créé pour procéder à l'enregistrement du serveur.
# Comment changer le port pour accéder au panneau de contrôle sans réinstaller le serveur
Pour les systèmes d'exploitation Windows
Accédez au répertoire d'installation du serveur (par défaut
C:\Program Files\TrueConf Server).Ouvrez le fichier
\httpconf\conf\listen.confà l'aide de n'importe quel éditeur de texte (assurez-vous d'avoir les droits d'administrateur).Modifiez le numéro de port dans le paramètre
Listen <номер порта>(par exemple,Listen 8888), puis enregistrez les modifications apportées.Ouvrez le fichier
\manager\etc\manager.tomlavec les droits d'administrateur et spécifiez ce même port dans le paramètre :
[web]
connection = "http://127.0.0.1:80"
2
Par exemple, remplacer le port 80 par 8888 :
[web]
connection = "http://127.0.0.1:8888"
2
5. Redémarrez l'ordinateur sur lequel TrueConf Server est installé.
Pour les systèmes d'exploitation Linux
Lors de l'installation sur un système d'exploitation de la famille Linux, la fenêtre de sélection du port pour accéder au panneau de contrôle ne s'affiche pas. Par conséquent, si vous devez modifier ce port, cela ne peut être fait qu'après l'installation.
Accédez au répertoire
/opt/trueconf/server/etc/webmanager/avec les droits de superutilisateur.Ouvrez le fichier
httpd.confavec n'importe quel éditeur de texte.Modifiez le numéro de port dans le paramètre
Listen <номер порта>(par exemple,Listen 8888), puis enregistrez les modifications apportées.Ouvrez le fichier
/opt/trueconf/server/etc/manager/manager.tomlavec n'importe quel éditeur de texte et spécifiez ce même port dans le paramètre :
[web]
connection = "http://127.0.0.1:80"
2
Par exemple, remplacer le port 80 par 8888 :
[web]
connection = "http://127.0.0.1:8888"
2
5. Redémarrez les services trueconf-manager et trueconf-web en utilisant les commandes :
sudo systemctl restart trueconf-manager
sudo systemctl restart trueconf-web
2
# Mise à jour du serveur de visioconférence
La mise à jour de TrueConf Server se fait également via des fichiers d'installation ou (sur Linux) via des dépôts. Il est important de noter que lors de la mise à jour d'une version majeure (lorsque les deux premiers chiffres changent, par exemple, de 4.5 à 4.7 ou de 4.7 à 5.0), une nouvelle enregistrement de TrueConf Server sera nécessaire car la clé matérielle (clé HW) changera. Un enregistrement sera également nécessaire si la configuration du matériel suivant change sur la machine physique ou virtuelle avec TrueConf Server :
modèle de processeur (notez que le nombre de cœurs virtuels (vCPU) n'affecte pas la licence);
taille de stockage (SSD ou HDD);
système d'exploitation utilisé.
Pour plus de détails sur la mise à jour de TrueConf Server, veuillez consulter l'article correspondant.
# 🆘 Résolution des problèmes courants lors de l'installation
# Erreur avec gnupg lors de l'installation depuis le dépôt sur Debian
Si lors de l'installation depuis le dépôt sur Debian, une erreur du type suivant apparaît dans le terminal :
E : gnupg, gnupg2 et gnupg1 ne semblent pas être installés, mais l'un d'entre eux est requis pour cette opération
cela signifie que le système d'exploitation n'a pas l'utilitaire cryptographique préinstallé gnupg.
Dans ce cas, installez le paquet manquant à l'aide de la commande :
sudo apt install gnupg2
# Erreur après avoir saisi le login administrateur lors de l'installation
Si lors de la saisie de l'identifiant administrateur à l'étape 5 de l'installation sur les systèmes d'exploitation Debian vous faites une erreur en indiquant un identifiant inexistant, l'installation peut se terminer par une erreur :
E: Le sous-processus /usr/bin/dpkg a retourné un code d'erreur (1)
Dans ce cas, vous devez exécuter la commande en tant que superutilisateur.
echo PURGE | sudo debconf-communicate trueconf-server
Cela supprimera les données de configuration du paquet enregistrées dans le système d'exploitation. Pour plus de détails, consultez la documentation officielle (opens new window).
Ensuite, relancez le processus d'installation depuis la première étape.
# Impossible d'accéder au panneau de contrôle
Si vous ne parvenez pas à accéder au panneau de contrôle TrueConf Server après l'installation, cela peut être dû à plusieurs raisons :
vous essayez d'accéder au panneau de contrôle depuis l'extérieur du réseau local (par exemple, si vous avez installé le serveur sur un VPS);
l'utilisateur avec lequel vous essayez de vous connecter n'a pas accès (rappelez-vous qu'il doit s'agir d'un utilisateur du système d'exploitation dans le groupe approprié);
sur CentOS Stream, si le mot de passe de l'utilisateur du système (administrateur de TrueConf Server) a été modifié, il sera nécessaire d'exécuter la commande :
sudo setfacl -m u:trueconf:r /etc/shadow
Pour savoir comment résoudre le problème d'accès à l'interface d'administration (panneau de configuration), consultez notre base de connaissances.
# Quels sont le nom d'utilisateur et le mot de passe administrateur par défaut ?
Pour accéder au panneau de contrôle (interface d'administration web) de TrueConf Server, un compte système est utilisé, aucun nouveau compte n'est créé lors de l'installation. L'accès est géré en ajoutant les comptes système nécessaires à un groupe spécifique. Pour plus de détails, consultez la description des paramètres d'accès au panneau de contrôle.