Astuces et Améliorations pour ASL3

Liste des configurations

Dans ce tutoriel, je vais expliquer, d'après mon expérience personnelle, comment optimiser, améliorer et personnaliser ASL3.

Voici la liste de ce que j'ai configuré pour personnaliser mon ASL3 :

Configurer un message personnalisé comme balise sur votre ASL3

1- Créez votre fichier audio

Utilisez un Générateur de Voix Off :

- Parmi les sites gratuits pour créer des fichiers audio sur internet, vous pouvez utiliser des plateformes comme voicegenerator.io.

- Pour plus de détails, consultez ce document PDF, chapitres 1 et 2, qui explique la procédure pour générer votre propre fichier audio.

2- Télécharger le fichier audio

- Il ne faut pasoublier que la structure des dossiers et fichiers sur ASL3 a légèrement changé. Si vous allez dans le dossier /var/lib/asterisk/sounds, car c'était le dossier par défaut pour les fichiers audios des anciennes versions d'Allstarlink, vous le trouverez vide.

- Le nouvel emplacement des fichiers audios dans ASL3 est désormais /usr/share/asterisk/sounds.

- Pour éviter tout conflit, nous allons télécharger notre fichier audio dans le dossier /usr/share/asterisk/sounds/custom.

3- Configurer ASL3

Comme exemple, j'ai créé un fichier audio que j'ai nommé "CN8VX.gsm".

- Éditez le fichier rpt.conf et ajoutez idrecording = /usr/share/asterisk/sounds/custom/CN8VX dans la section Configure your nodes here, sans ajouter l'extension après le nom.

- Ajoutez beaconing = 1 pour activer l’envoi de l'identifiant du répéteur. Attention!! l'activation de cette fonctionnalité est probablement illégale aux États-Unis.

idrecording

- Enfin, redémarrez Asterisk. Vous entendrez alors votre fichier audio.

Installer la synthèse vocale en langue française

Pour avoir la synthèse vocale en langue française sur votre répéteur ASL3.

1- Télécharger et copier le dossier pour la synthèse vocale française :

- Connectez-vous en SSH sur votre répéteur ASL3.

- Installer git :

sudo apt install git -y

- Accédez au dossier sounds :

cd /usr/share/asterisk/sounds

- Télécharger les fichiers audios depuis GitHub :

sudo git clone https://github.com/CN8VX/Sond_Asl_fr.git fr

- Changez le propriétaire de ces fichiers :

sudo chown -R asterisk:asterisk /usr/share/asterisk/sounds/fr

2- Activer la synthèse vocale française dans le répéteur :

- Éditez le fichier asterisk.conf qui se trouve dans le dossier /etc/asterisk/ avec la commande suivante :

sudo nano /etc/asterisk/asterisk.conf

- Effectuez vos modifications sous la section [options], lignes 33 et 82.

N’oubliez pas d’enlever le point-virgule ; devant "languageprefix" et "defaultlanguage" pour les activer :

[options]
languageprefix = yes
defaultlanguage = fr

- Après avoir effectué vos modifications, enregistrez et quittez.

- Puis éditez le fichier chan_dahdi.conf :

sudo nano /etc/asterisk/chan_dahdi.conf

- Allez à la section [channels], enlevez le point-virgule ; devant "language", puis écrivez "fr"

[channels]
;
; Default language
;
language=fr
;

- Après avoir effectué vos modifications, enregistrez et quittez.

- Enfin, redémarrez Asterisk avec la commande :

sudo astres.sh

3- Tester la synthèse vocale française

Après le redémarrage d’Asterisk, envoyez le code DTMF *712 et vous entendrez l'heure en français.

Installer l’interface graphique Supermon.

Supermon est une application Web qui fonctionne avec des pages en PHP, mais sur ASL3, PHP n'est pas installé par défaut.

1- Installation de Supermon

Pour cela, il faut l’installer avec cette commande via SSH:

sudo apt install php -y

sudo apt install php -y

Accédez au répertoire /usr/local/sbin :

cd  /usr/local/sbin

Puis copiez et collez cette commande en une seule ligne :

Accédez au répertoire /usr/local/sbin :

sudo wget  "http://2577.asnode.org:43856/supermonASL_fresh_install"   -O  supermonASL_fresh_install

Puis exécutez :

Accédez au répertoire /usr/local/sbin :

sudo chmod  +x  supermonASL_fresh_install
hash
sudo supermonASL_fresh_install

2- Configuration du mot de passe pour activer le panneau de configuration :

Accédez au répertoire /var/www/html/supermon :

cd /var/www/html/supermon

Puis tapez la commande suivante :

sudo htpasswd -cB .htpasswd admin

Tapez votre mot de passe suivis par Enter.

New password:

Retapez votre mot de passe suivis par Enter.

Re-type new password:

Enfin, tapez la commande suivante :

sudo chmod 777 astdb.php

À l'aide de votre navigateur Web, accédez à l'adresse IP de votre nœud :
http://IP_du_serveur/supermon ou http://nom_de_hôte/supermon

Voici le résultat que vous allez obtenir :

l'interface web de Supermon par default

3- Configuration et personnalisation de l'interface web de Supermon

Dans l'exemple ci-dessus l'interface web et par default, il n'y a pas d'indicatif ni de numéro de nœud...

Pour configurer et personnaliser l'interface web, il faut faire des modifications sur deux fichier : global.inc et allmon.ini

Configuration du premier fichier global.inc :

Il y a deux méthodes pour faire les modifications.

1 Première méthode, c'est directement depuis l'interface web:

- Il suffit d'appuyer sur le bouton Configuration Editor puis sélectionner Supermon - global.inc et d'appuyer sur le bouton Edit file.

- Vous aurez une page où il y a des lignes à modifier.

- Après avoir effectué vos modifications, appuyez sur le bouton " WRITE you Edit" puis sur le bouton " Return to Index".

2 Deuxième méthode, c'est via les lignes de commande, pour cela il faut que vous vous connectez en SSH.

Puis tapez la commande suivante :

sudo nano /var/www/html/supermon/global.inc

<?php
// Set the values to your parameters
// ONLY change text between quotes
//
// Your callsign Only:
$CALL = "Your callsign";
//
// Your name:
$NAME = "Your name";
//
// Your location:
$LOCATION = "Anywhere, USA";
//
// Second line header title:
$TITLE2 = "12345 Cloud Server";
//
// Third line header title:
$TITLE3 = "AllStarLink/IRLP/EchoLink/Digital - Bridging Control Center";
//
// Background image - specify path if not /var/www/html/supermon
// Leaving BACKGROUND null "" results in BACKGROUND_COLOR:
$BACKGROUND = "background.jpg";
//
// Background color if no image:
$BACKGROUND_COLOR = "blue";
//
// Height of background - matches image height:
$BACKGROUND_HEIGHT = "124px";
//
//
// Enable [Database] button – For quick review of entire AllStar internal database:
$DATABASE_TXT = "/tmp/database.txt";
//
// Node number(s) to display, if Streaming Audio:
//$STREAMING_NODE = "12345";
//
// Node number(s) to display, if Archiving Audio:
//$ARCHIVING_NODE = "12345";
//
// Archive Web address, if Archiving Audio locally or remotely:
$ARCHIVE_URL="/supermon/custom/archive/";
//
// Enable custom server name for Supermon browser tab:
$SMSERVERNAME = "12345 Cloud";
//
// Supermon screen REFRESH delay time in seconds
// Default is 21600 seconds, six hours:
$REFRESH_DELAY = "2700";
//
// Supermon program loop delay (polling) setting.
// Higher delay can significantly reduce your Supermon web server network bandwidth usage on large open systems.
// Default is 500000 (0.50 secs).
// Minimum setting is 300000 (0.30 seconds), maximum is 30000000, (30.0 seconds):
//$SMLOOPDELAY = "700000";
//
// Show number of core dump files that may exist, IF any
$SHOW_COREDUMPS = "yes";
//
// Show weather conditions and temperature for Zip code area:
//$LOCALZIP = "33917";
//
// Set/show personal or club logo tile-picture in Supermon header:
//$MY_TILE = "tile_name.jpg";
//
// Set/show a second additional personal or club logo tile-picture in Supermon header:
//$MY_TILE2 = "usflag.jpg";
//
// Enable a NEW Supermon button to launch any other Dashboard like DVSwitch or Pi-Star:
$DVM_URL_NAME = "Digital Dashboard";
$DVM_URL = "http://Pi-Star";
//$DVM_URL = "http://your_url.com";
//
// Enable a Maintainer email address link in your Supermon page footer:
//$MAINTAINER = "<a href=\"MailTo:WXYZ@whereever.com\">Name, WXYZ</a>";
//
// This needs further testing on RPi-ASL systems ...
// When your RPi2-4 system is running on a LAN network with a router/firewall,you do NOT need this variable set!
// If your RPi2-4 system is directly connected to the internet without a firewall/router,
// Supermon can hang trying to get both the WAN and LAN addresses.
// Set this variable to "yes" to disable checking for a LAN address and report only the WAN address.
// This will eliminate the hanging of Supermon in this case:
//$WANONLY = "yes";
//
?>

Configuration du deuxième fichier allmon.ini :

1Depuis l'interface web : appuyer sur le bouton Configuration Editor puis sélectionner Supermon - allmon.ini et d'appuyer sur le bouton Edit file.

- Après avoir effectué vos modifications, appuyez sur le bouton WRITE you Edit puis sur le bouton Return to Index

2Ou en ligne de commande, ce connectez en SSH

Tapez la commande suivante:

sudo nano /var/www/html/supermon/allmon.ini

[All Nodes]
system=Nodes
nodes=1998,1999
menu=yes

[1998]
system=Nodes
host=127.0.0.1:5038
user=admin
passwd=secret
hideNodeURL=no
menu=yes

[1999]
system=Nodes
host=127.0.0.1:5038
user=admin
passwd=secret
hideNodeURL=no
menu=no ; Pour ne pas être visible dans le menu

[LsNodes]
url="/cgi-bin/lsnodes_web?node=1998"
menu=yes

[DVSwitch]
url="http://DVSwitch.org/"
menu=yes

;[D-Star]
;url="http://www.DStarinfo.com/reflectors.aspx"
;menu=yes

[Pi-Star]
url="http://PiStar.uk/"
menu=yes

[QRZ]
url="http://QRZ.com/db/CN8VX"
menu=yes

sudo nano /etc/asterisk/manager.conf

Le résultat après la modification des deux fichiers: "allmon.ini" et "global.inc"

Installer le thème Supermon

Installer le thème Supermon pour centrer les tableaux et changer la couleur.

Maintenant qu'on a installé et configuré Supermon, nous allons le moderniser en ajoutant des couleurs et en centrant le contenu de la page.

J'ai créé un fichier CSS que l'on peut télécharger depuis GitHub et l'ajouter dans le dossier de Supermon pour effectuer ces modifications.

Pour cela, il faut suivre les instructions qui se trouvent dans CSS-theme-for-supermon.

Après avoir rafraichir la page web de Supermon, vous aurais un résultat similaire à l’image ci-dessous :

L’interface web de Supermon après l’ajout du thème

Activer le journal des connexions et des déconnexions.

Avec Supermon, il est possible de consulter le journal des connexions et des déconnexions. Cependant, dans ASL3, cette fonctionnalité est désactivée par défaut.

Pour l'activer, il est nécessaire d'éditer le fichier rpt.conf et d'ajouter les deux lignes suivantes dans la section configure your nodes here :

connpgm=/usr/local/sbin/supermon/smlogger 1
discpgm=/usr/local/sbin/supermon/smlogger 0

Après avoir effectué vos modifications, enregistrez et quittez. Redémarrez Asterisk.

Ensuite, effectuez un test en vous connectant puis en vous déconnectant d'un nœud. Vous constaterez que dans la fenêtre "Connection Log" apparaîtront les lignes des connexions et des déconnexions.

Il est important de noter qu'en activant le journal des connexions et des déconnexions, la taille du fichier connectlog augmentera progressivement au fur et à mesure des connexions et des déconnexions. À terme, ce fichier peut devenir très volumineux et saturer l'espace disque, en particulier si vous utilisez une carte SD de faible capacité (8 ou 16 Go). Il est donc essentiel de mettre en place une rotation des fichiers journaux.

Pour cette raison, nous allons configurer une rotation pour les fichiers connectlog :

- Il faut vérifier si logrotate est installé.

logrotate --version

sudo apt update && sudo apt install logrotate

ls -l /etc/cron.daily/logrotate

- Créez un fichier nommé "asterisklog" :

sudo nano /etc/logrotate.d/asterisklog

- Ajoutez les lignes suivantes :

- Créez un fichier nommé "asterisklog" :

/var/log/asterisk/connectlog /var/log/asterisk/messages.log {
    missingok
    rotate 5
    weekly
    copytruncate
    create 0640 asterisk asterisk
    postrotate
        /usr/sbin/asterisk -rx 'logger reload' > /dev/null 2> /dev/null
    endscript
}
                

- Enregistrez, quittez et redémarrez Asterisk.

En suivant ces étapes, vous garantirez une gestion optimale des journaux de connexion et de déconnexion, évitant ainsi la saturation de votre espace disque et assurant une performance stable de votre système ASL3.

Installer l’interface graphique AllScan.

AllScan est une application Web gratuite et open source qui fournit des fonctionnalités de gestion des favoris, l'intégration des statistiques AllStarLink et des fonctions de surveillance et de contrôle des connexions.

AllScan est entièrement compatible avec HamVOIP et les versions antérieures d'ASL. Cependant, ASL3 est fortement recommandé en raison de ses nombreuses améliorations significatives et de sa prise en charge des plateformes x64 (comme les mini-PC Dell Wyse 3040 ou Beelink T5, qui sont plus performants et plus économiques que les Raspberry Pi).

- Pré-Installation

Pour installer AllScan avec ASL3, assurez-vous que Allmon, ou Supermon s'il est installé, soit correctement configuré et pleinement opérationnel.

Si Supermon est installé, AllScan vous proposera d'utiliser le fichier favorites.ini du répertoire Supermon.

Si vous utilisez Supermon2 au lieu de Supermon ou si vous souhaitez placer votre fichier favorites.ini dans un autre dossier, vous pouvez définir l'emplacement de recherche de ce fichier sur la page Cfgs d'AllScan.

- Installation d'AllScan

Pour installer AllScan, suivez simplement les instructions dans la section Install / Update du GitHub officiel. Cela rend le processus facile et sans complications.

Après l'installation et la création de votre compte administrateur, vous serez dirigé vers l'interface graphique d'AllScan, comme illustré ci-dessous.

L’interface graphique d'AllScan

Activer un Node Echolink.

Sachez que les nodes Echolink qui peuvent être activés sur AllStarLink doivent être soit en mode -L soit en mode -R.

Pour configurer votre NODE, vous devez éditer le fichier echolink.conf et bien remplir les informations sous la section [el0].

[el0]
call = INVALID                      ; Remplacez par votre indicatif!
pwd = INVALID                       ; Remplacez par votre mot de passe enregistrée sur Echolink!
name = YOUR NAME                    ; Remplacez par votre nom!
qth = INVALID                       ; Remplacez par votre QTH!
email = INVALID                     ; Remplacez par votre adresse e-mail enregistrée sur Echolink!
node = 00000000                     ; Remplacez par votre numéro de nœud ECHOLINK attribué!
; Data for EchoLink Status Page
lat = 0.0                           ; Latitude en degrés décimaux
lon = 0.0                           ; Longitude en degrés décimaux
freq = 0.0                          ; non obligatoire Fréquence en MHz
tone = 0.0                          ; non obligatoire CTCSS Tone (0 pour aucune)
power = 0                           ; 0=0W, 1=1W, 2=4W, 3=9W, 4=16W, 5=25W, 6=36W, 7=49W, (Power in Watts)
height = 0                          ; 0=10 1=20 2=40 3=80 4=160 5=320 6=640 7=1280 (AMSL in Feet)
gain = 0                            ; Gain in db (0-9)
dir = 0                             ; 0=omni 1=45deg 2=90deg 3=135deg 4=180deg 5=225deg (Direction)

maxstns = 20                        ; Définit le nombre maximal de connexions simultanées d’utilisateurs

rtcptimeout = 10                    ; Définit le délai avant qu’une connexion EchoLink soit considérée comme inactive
recfile = /tmp/echolink_recorded.gsm    ;
astnode = 1999                     ; Identifiant du nœud AllStarLink qui sera utilisé pour l’intégration avec EchoLink.!
context = radio-secure             ; Default in code is echolink-in

; Max 4 servers
server1 = nasouth.echolink.org
server2 = naeast.echolink.org
server3 = servers.echolink.org
server4 = backup.echolink.org
                    

Une fois que vous avez configuré votre NODE Echolink, vous devez l’activer dans le fichier "modules.conf".

Pour ce faire, suivez les étapes suivantes :

Éditez le fichier modules.conf.

- Recherchez la ligne suivante :

noload => chan_echolink.so

- Remplacez-la par :

load => chan_echolink.so

- Enregistrez, quittez et redémarrez Asterisk.

✅ Et voilà, votre NODE Echolink est maintenant activé via votre nœud AllStarLink.