Linux FPAC-HOWTO, Amateur Radio.: Configuration of FPAC

5. Configuration de FPAC

FPAC est configuré avec un seul fichier. Ce fichier est nommé "fpac.conf" et doit être placé dans le répertoire /etc/ax25/ .

5.1 Le fichier de configuration fpac.conf

Voici un exemple de fichier fpac.conf.

Ce fichier est constitué de mots clés pour lesquels on donne des valeurs ou des blocs de valeurs. Un bloc est toujours terminé par un "End"'

#
# FPAC configuration file
#

#
# Informations on the node
#

L2call    = F6FBB-10
L3call    = F6FBB-11
DNIC      = 2080
Address   = 931502
Coverage  = 931602 931202 931102
InetPort  = 1022
Password  = mypassword
City      = Roquettes
Locator   = JN03QL
UserPort  = *
DefPort   = 1
InetAddr  = 44.151.31.6    *** uniquement en version 3.23 ***
#
# Other commands
#

Command
        BBs = /usr/sbin/call_tcp serveur 1022
        CLuster = connect f6krq-3 2080931501
        STat = /bin/cat /var/ax25/fpac/fpacstat.dat /var/ax25/fpac/fpacstat.day
        CONVers = /usr/sbin/convers -l %u
        Telnet =
end

#
# Other SysOp commands
#

Sysop
        DIsk = /bin/df -k
        RM   = /bin/rm /tmp/%1
        LS   = /bin/ls -l /tmp/%1
        CAT  = /bin/cat /tmp/%1
        YGET = /usr/sbin/yapp -u /tmp/%1
        YPUT = /usr/sbin/yapp -d /tmp/%1
        SYSop= /usr/sbin/fpacshell
end

#
# Other applications
#

Application
        F6FBB-1 = /usr/sbin/call_tcp serveur 1022
End

#
# List of routes to port
#

AddPort = UHF
        Address = 931402
        Port = 5
End

AddPort = BEX
        Address = 931302
        Port = 0
End

#
# List of users on specific port
#

User = F6BEX
        Path = F6BEX
        Port = 2
End

#
# List of aliases
#

Alias = F6FBB-2
        Path = F6FBB-2,931501
End

Alias = F6FBB-3
        Path = F6KRQ-3,931501
End

#
# List of adjacent nodes
#

Node = Prat
        Path     = F5JTU-9
        DNIC     = 2080
        Address  = 909501
        Port     = 3
End

Node = Rebigue
        Path     = F6BEX-9
        DNIC     = 2080
        Address  = 931501
        Port     = 0
End

Node = Test
        Path     = F6FBB-9
        DNIC     = 2080
        Address  = 931503
        Port     = 5
End

#
# Routes to adjacent nodes
#

Routes
        DNIC = 2080

        1 = Rebigue
        2 = Rebigue
        3 = Rebigue
        4 = Rebigue
        5 = Rebigue
        6 = Rebigue
        7 = Prat
        8 = Rebigue

        909 = Prat

        909202 = Rebigue
        909502 = Rebigue

        931201 = Rebigue
        931501 = Rebigue

        931203 = Test
        931503 = Test

        911 = Prat
        930 = Prat
        934 = Prat
        946 = Rebigue
        965 = Rebigue
        966 = Prat
        981 = Rebigue
        981501 = Prat
        982 = Rebigue
End

5.2 Information sur l'en-tête

Tous les mots-clés de l'en-tête sont obligatoires et doivent être définis.

#
# Informations on the node
#

L2call    = F6FBB-10
L3call    = F6FBB-11
DNIC      = 2080
Address   = 931502
Coverage  = 931602 931202 931102
InetPort  = 1022
Password  = mypassword
City      = Roquettes
Locator   = JN03QL
UserPort  = *
DefPort   = 1

L2call est l'indicatif principal du node vu par les utilisateurs. Une connexion à cet indicatif donne accès à fpacnode. Si il est utilisé comme digipeater, il donne accès à une station locale ou distante via le réseau.
L3call est l'indicatif utilisé pour transporter les trames X25. Cet indicatif ne peut être connecté par des utilisateurs (aucun texte n'est envoyé). Il peut être utilisé par des nodes distants pour transporter le X25 avec le PID 01 (X25). L'utilisation de cet indicatif comme digipeater donne une connexion blanche et une déconnexion, aucun message ou information n'est renvoyée. Plutôt utilisé par une bbs locale (même machine) pour accéder au réseau fpac.
DNIC désigne le champ "pays" de l'adresse ROSE en rapport au standard CCITT. C'est 2080 pour la France. Quelques autres pays sont donnés en annexe.
Address est l'adresse générale du node.
Coverage est la liste des adresses que le node doit ajouter à son adresse principale.
InetPort est le numéro de port (décimal) écouté par FPAC pour des connexions Telnet.
Password est le mot de passe d'accès avec la commande SYS
City est la localité du node
Locator est le QTH locator du node
UserPort est la liste des ports accessibles aux utilisateurs. Une étoile "*" autorise tous les ports.
DefPort est le port ou les connexions sortantes sont dirigées par défaut.

5.3 Zone Commande

La zone commande permet d'ajouter ou enlever des commandes du menu principal. Sachez que ces commandes sont exécutées avec des privilèges root, afin d'éviter des commandes destructrices.

#
# Other commands
#

Command
        BBs = /usr/sbin/call_tcp serveur 1022
        CLuster = connect f6krq-3 2080931501
        STat = /bin/cat /var/ax25/fpac/fpacstat.dat /var/ax25/fpac/fpacstat.day
        CONVers = /usr/sbin/convers -l %u
        Telnet =
end

La zone Commande inclut une liste de mots-clés qui apparaissent dans le menu principal de fpacnode. Si aucune valeur est spécifiée pour une commande donnée, cette commande sera enlevée du menu par défaut.

Un mot-clé identique à une commande existante permet de redéfinir celle-ci.

Les lettres en majuscules du mot-clé correspondent aux caractères demandés pour que cette commande soit exécutée.

La valeur du mot-clé doit pouvoir être exécutée par Linux. L'utilisateur peut être lié avec la commande, en envoyant du texte puis en recevant le résultat. Ensuite il retourne avec le menu de commandes fpacnode.

La commande connect permet de lancer une connexion L2 ou L3. Si un port est spécifié après le "connect" alors la connexion L2 locale est lancée. Si aucun port n'est spécifié, une connexion L3 arrive à terme si l'indicatif est un indicatif Netrom ou FPAC connu. Dans le cas d'une connexion L3 et qu'aucune adresse est spécifiée (toujours 10 chiffres), alors la base de données (Pages Blanches, WP) est interrogée avec l'indicatif que l'on souhaite connecter.

5.4 Zone Sysop

La zone sysop permet d'ajouter des commandes supplémentaires lorsque la commande SYS est passée. Généralement des commandes de maintenance sont ajoutées, sachez que ces commandes sont exécutées avec des droits root donc éviter des commandes destructrices pour le système.

#
# Other SysOp commands
#

Sysop
        DIsk = /bin/df -k
        RM   = /bin/rm /tmp/%1
        LS   = /bin/ls -l /tmp/%1
        CAT  = /bin/cat /tmp/%1
        YGET = /usr/sbin/yapp -u /tmp/%1
        YPUT = /usr/sbin/yapp -d /tmp/%1
        SYSop= /usr/sbin/fpacshell
end

5.5 Zone Application

La zone application comporte un ensemble de lignes, chacune des lignes permet d'associer une application LINUX à un indicatif donc lorsque l'utilisateur connecte cet indicatif, il est relié au programme Linux.

#
# Other applications
#

Application
        F6FBB-1 = /usr/sbin/call_tcp serveur 1022
End

5.6 Zone AddPort

La zone AddPort comporte un ou plusieurs blocs, chaque bloc permet de définir le nom de port sous FPAC, son adresse et son nom sous Linux (fichier axports). Si un utilisateur distant essaie de connecter quelqu'un avec cette adresse, ce port sera tentée sur ce port.

#
# List of routes to port
#

AddPort = UHF
        Address = 931402
        Port = 5
End

AddPort = BEX
        Address = 931302
        Port = 0
End

5.7 Zone User

La zone User comporte un ou plusieurs blocs, chaque bloc défini un utilisateur sur le port associé. Si un utilisateur distant essaie de connecter cet utilsateur, le port spécifié sera utilisé.

#
# List of users on specific port
#

User = F6BEX
        Path = F6BEX
        Port = 2
End

5.8 Zone Alias

La zone Alias est similaire à la zone application mais lance une nouvelle connexion en fonction de l'indicatif demandé.
Une connexion sur l'indicatif F6FBB-3 est re-routée vers F6KRQ-3, adresse 931501 (le DNIC du node est utilisé par défaut).

La zone Alias comporte un ou plusieurs blocs, chaque bloc définit un alias.

#
# List of aliases
#

Alias = F6FBB-2
        Path = F6FBB-2,931501
End

Alias = F6FBB-3
        Path = F6KRQ-3,931501
End

5.9 Zone Node

La zone Node comporte un ou plusieurs blocs, chaque bloc permet de définir un node adjacent.

#
# List of adjacent nodes
#

Node = Prat
        Path     = F5JTU-9
        DNIC     = 2080
        Address  = 909501
        Port     = 3
        NoWp     = 0
End

Node = Rebigue
        Path     = F6BEX-9
        DNIC     = 2080
        Address  = 931501
        Port     = 0
End

Node = Test
        Path     = F6FBB-9
        DNIC     = 2080
        Address  = 931503
        Port     = 5
End

Chaque bloc définit le nom du node adjacent, il sera utilisé plus bas pour la table de routage. Attention aux majuscules/minuscules. Quatre mots clé doivent être définis :

Path définit l'indicatif/ssid du node adjacent, il peut être précédé par un ou plusieurs digipeaters.
DNIC définit le DNIC (4 chiffres) du node adjacent.
Address définit l'adresse principale du node distant.
Port définit sur quel port la node distant est connecté (tiré de /etc/axports).
NoWP = 1 spécifie que le node distant n'accepte pas les WP (pages blanches) par défaut = 0.

N'oubliez pas de terminer chaque bloc avec un "End" sur une ligne.

5.10 Zone Routes

Cette zone comporte un seul bloc qui permet de définir la table de routage.

Le routage commence par les destinations hiérarchiques avec DNIC puis les adresses classées de gauche à droite, toujours de manière hiérarchique.

DNIC, 4 chiffres pour le pays
Address, jusqu'à 6 chiffres pour la région/département/3chiffres. Cette organisation dépend du pays.

#
# Routes to adjacent nodes
#

Routes
        DNIC = 2080

        1 = Rebigue
        2 = Rebigue
        3 = Rebigue
        4 = Rebigue
        5 = Rebigue
        6 = Rebigue
        7 = Prat
        8 = Rebigue

        909 = Prat

        909202 = Rebigue
        909502 = Rebigue

        931201 = Rebigue
        931501 = Rebigue

        931203 = Test
        931503 = Test

        911 = Prat
        930 = Prat
        934 = Prat
        946 = Rebigue
        965 = Rebigue
        966 = Prat
        981 = Rebigue
        981501 = Prat
        982 = Rebigue
End

La ligne DNIC concerne les adresses de routages qui la suivent, une nouvelle ligne DNIC peut être définie pour un autre pays. Une ligne avec "End" termine le bloc.

Si l'information de l'adresse est inférieure à 6 chiffres, toutes les adresses commençant par cette valeur seront routées vers le node correspondant.

Le nom du node doit être défini dans la zone Node.

L'adresse la plus longue est prioritaire, par exemple :

        DNIC = 2080
        981 = Rebigue
        981501 = Prat

Toutes les adresses débutant par 981 pour le DNIC 2080 seront routées vers "Rebigue" excepté 981501 qui sera routé vers "Prat". L'ordre de déclaration n'est pas important, les adresses sont sorties selon l'algorithme de routage.