calaos_config est l’outil qui permet de consulter et de modifier les réglages du serveur Calaos depuis un terminal. C’est lui qu’utilisent la plupart des pages de ce chapitre.
Il travaille sur la configuration locale du serveur, rangée dans le dossier /mnt/calaos/config.
Cet outil ne concerne que les réglages du serveur : identifiants, notifications, options de fonctionnement. Vos entrées/sorties, vos règles et vos scénarios se gèrent depuis Calaos Installer, pas ici.
Connectez-vous au serveur en SSH (voir Accès SSH), puis utilisez l’une des quatre commandes suivantes.
| Commande | Effet |
|---|---|
calaos_config list | Affiche tous les réglages et leur valeur |
calaos_config get CLÉ | Affiche la valeur d’un réglage |
calaos_config set CLÉ VALEUR | Modifie un réglage |
calaos_config del CLÉ | Supprime un réglage |
Chaque réglage est identifié par une clé, c’est-à-dire un nom court sans espace.
La commande la plus utile pour commencer :
calaos_config list
Elle affiche l’intégralité des réglages actuels de votre serveur, un par ligne, sous la forme clé: valeur. C’est le meilleur moyen de découvrir ce qui est configuré sur votre installation.
Cette commande ne modifie rien, vous pouvez la lancer sans crainte.
calaos_config get cn_user
affiche la valeur du réglage cn_user, c’est-à-dire le nom d’utilisateur de connexion au serveur.
calaos_config set cn_user mon_utilisateur
Le changement est enregistré immédiatement. Certains réglages ne sont pris en compte qu’après un redémarrage du serveur Calaos.
calaos_config del NOM_DU_RÉGLAGE
Le réglage disparaît de la configuration, et le serveur reprend son comportement par défaut pour cette option.
| Clé | Rôle |
|---|---|
cn_user | Nom d’utilisateur de connexion au serveur |
cn_pass | Mot de passe de connexion au serveur |
Voir Changer les mots de passe.
| Clé | Rôle |
|---|---|
latitude | Latitude de votre habitation |
longitude | Longitude de votre habitation |
Ces deux valeurs permettent au serveur de calculer les heures de lever et de coucher du soleil, indispensables aux règles horaires qui en dépendent. Voir Date & Heure.
| Clé | Rôle |
|---|---|
smtp_server | Adresse du serveur d’envoi, sous la forme smtp://serveur |
smtp_port | Port du serveur d’envoi |
smtp_auth | true si le serveur demande une authentification |
smtp_tls | true pour une connexion chiffrée |
smtp_username | Identifiant |
smtp_password | Mot de passe |
Voir Email.
| Clé | Rôle |
|---|---|
notif/battery_mail_enabled | Prévenir par email quand une pile est faible |
notif/battery_push_enabled | Prévenir par notification mobile quand une pile est faible |
notif/io_connected_mail_enabled | Prévenir par email quand un équipement se connecte ou se déconnecte |
notif/io_connected_push_enabled | Prévenir par notification mobile quand un équipement se connecte ou se déconnecte |
Toutes attendent true ou false. L’envoi d’emails suppose d’avoir configuré le serveur d’envoi au préalable. Voir Zigbee.
| Clé | Rôle |
|---|---|
calaos_server_host | Force l’interface à se connecter à un serveur précis, et désactive la détection automatique. Une adresse IP suffit |
show_cursor | Affiche ou non le curseur de la souris à l’écran |
dpms_enable | Active la mise en veille automatique de l’écran |
dpms_standby | Délai avant la mise en veille, en minutes |
Voir Écran tactile.
| Clé | Rôle |
|---|---|
debug_enabled | Active les journaux détaillés du serveur |
debug_level | Niveau de détail global |
debug_domains | Niveau de détail par domaine, sous la forme domaine:niveau,domaine:niveau |
À n’activer que le temps d’un diagnostic. Voir Journaux.
Cette liste couvre les réglages les plus courants. calaos_config list vous montre ceux qui sont réellement définis sur votre installation.
N’éditez pas les fichiers de configuration à la main pendant que le serveur tourne. Vos modifications risquent d’être écrasées, et un fichier mal formé empêchera le serveur de démarrer. Passez toujours par calaos_config.
Les réglages sont stockés dans le fichier local_config.xml, dans /mnt/calaos/config. Ce dossier contient aussi l’historique des configurations envoyées depuis Calaos Installer, décrit dans Sauvegarder sa configuration.
Un appel à calaos_config sans argument affiche l’aide de l’outil.