Exécution

Démarrer le serveur

Une fois l’installation effectuée, la commande ci-dessous va démarrer le serveur SAINet:

java -jar external/SNV4SRV-server/target/SNV4SRV-server-full-embedded.jar --runtime <runtime> --start

Le serveur va démarrer et au bout de quelques minutes, le bloc de texte suivant sera affiché:

================================================
SAINet Embedded Server version 4.10.0-20201007-122115.
The domain payara is now up and running. (inst:PYA, env:#local)
The GlassFish/Payara installation dir is /tmp/gfembed14043435345614509593tmp
The SAINet runtime dir is /home/server/runtime_ori
Ports used: HTTP=9090, HTTPS=9191, ADMIN=5858
URL: http://localhost:9090/SNV4SRV-ws-war/EPS
Host: sagittarius/127.0.1.1
================================================
You can use <ctrl> + C to shut it down.

A partir de ce moment, il est possible d’ouvrir un navigateur et de se rendre sur l’URL https://localhost:9191. Après avoir accepté l’avertissement relatif au certificat, une page affichera comme quoi SAINet est en ligne et vous permet de télécharger l’installeur du client riche qui vous permettra de vous connecter.

Par défaut sur un nouveau serveur, les informations de connexion sont:

• Utilisateur: saierp
• Mot de passe: bootStrap373746

Si un client riche SAINet est déjà installé sur la machine, il suffit de changer l’URL dans le fichier SAINETV4.ini.

Il est possible d’avoir plusieurs serveurs lancés en même temps sur la même machine. Le bloc de texte final indique quels sont les ports à utiliser.

En cas de problème

Parfois vous pouvez vous retrouver devant une erreur de démarrage du serveur telle que celle ci :

Server is starting...
...
java.lang.RuntimeException: Unable to deploy SAINet EAR (C:\Users\remi\AppData\Local\Temp\gfembed5146000458384952507tmp)
        at ch.saierp.sainet.embedded.server.SAINetServer.start(SAINetServer.java:1753)
        at ch.saierp.sainet.embedded.server.cli.SAINetServerMain.lambda$startServer$14(SAINetServerMain.java:1129)
        at java.base/java.util.concurrent.FutureTask.run(FutureTask.java:264)
        at java.base/java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1128)
        at java.base/java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:628)
        at java.base/java.lang.Thread.run(Thread.java:834)
. 50375ms
 error.

Si le serveur n’arrive pas à démarrer, il est possible d’utiliser l’option --verbose pour savoir plus précisément où se trouve le problème. Généralement, il peut s’agir des points suivants:

• Le projet n’a pas été compilé avec la dernière version de la branche sur laquelle vous vous trouvez, ou alors vous êtes sur le master et vous n’avez pas recompilé depuis le dernier git pull.
• Le code à chaud ne compile pas (projets server/SNV4SRV-dbcode ou server/SNV4SRV-dbcode-apis).

En cas de doute, se référer à la compilation.

Arrêter le serveur

Il suffit de faire <ctrl> + c dans la console où il a été lancé pour arrêter le serveur.

Mettre à jour le serveur

Pour mettre à jour un serveur installé dans <runtime>, utiliser la commande suivante:

java -jar external/SNV4SRV-server/target/SNV4SRV-server-full-embedded.jar --runtime <runtime> --update