======= Service stats.chatons.org =======

StatoolInfos est un outil et un protocole pour partager des informations sur une fédération de services. Une instance du service est hébergée sur le site [[https://stats.chatons.org/chapril.xhtml|chatons.org]].

====== Déploiement ======

=====Configuration de Java =====
Java :
<code>
=(^-^)=root@grof:~# apt-get install openjdk-11-jre-headless
[…]
Souhaitez-vous continuer ? [O/n] o
[…]
=(^-^)=root@grof:~# java -version
openjdk version "11.0.9" 2020-10-20
OpenJDK Runtime Environment (build 11.0.9+11-post-Debian-1deb10u1)
OpenJDK 64-Bit Server VM (build 11.0.9+11-post-Debian-1deb10u1, mixed mode, sharing)
</code>

=====Configuration d'Apache =====

Création d'un fichier générique qui sera includé plus tard :
<code>
=(^-^)=root@grof:/srv/chaprilinfos# cat /etc/apache2/chaprilinfos.conf 
    Alias "/.well-known/chaprilinfos/" "/srv/chaprilinfos/well-known/chaprilinfos/"
    <Directory "/srv/chaprilinfos/well-known/chaprilinfos/">
        Options +Indexes
        Require all granted
    </Directory>
</code>

=====Configuration de Nginx =====
Création d'un fichier générique qui sera includé plus tard :
<code>
=(^-^)=root@allo:/etc/nginx#  cat /etc/nginx/chaprilinfos.conf
   location /.well-known/chaprilinfos/ {
       types {
            text/plain    properties;
       }

       alias /srv/chaprilinfos/well-known/;
       autoindex on;
   }
</code>
=====Espace de travail =====
Dossiers de travail :
<code>
mkdir -p /srv/chaprilinfos/{conf,inputs,well-known}
</code>


===== Ajout d'un service dans ChaprilInfos =====

Configurer l'accès well-known en ajoutant à la fin de la configuration Apache du site :
<code>
    # ChaprilInfos
    Include chaprilinfos.conf
</VirtualHost>
</code>

Ou au début du fichier de la configuration Nginx du site :
<code>
    # ChaprilInfos.
    include /etc/nginx/chaprilinfos.conf;
</code>

Puis ajouter :
  * un fichier de configuration dans /srv/chaprilinfos/conf/<service>chaprilorg.conf ;
  * un fichier de déclaration dans /srv/chaprilinfos/well-known/<service>chaprilorg.properties.

Peupler le well-known :
<code>
cd /srv/chaprilinfos/
./bin/statoolinfos build conf/foochaprilorg.conf
</code>

====== Actualiser un service ChaprilInfos ======

Sur la vm du service, éditer le fichier de déclaration du service ''/srv/chaprilinfos/inputs/foochaprilorg.properties''.

Une documentation des propriétés est disponible là : https://framagit.org/chatons/chatonsinfos/-/blob/master/MODELES/service.properties

Puis re-peupler le dossier well-known exposé sur le web :
<code>
cd /srv/chaprilinfos/
./bin/statoolinfos build conf/foochaprilorg.conf
</code>

Puis vérifier dans https://stats.chatons.org/chapril.xhtml