Cet article a pour objectif de montrer comment installer un serveur TOSIAM très simplement.

Prérequis

Installer un java JDK 11, 17 ou 21 (La variable d’environnement JAVA_HOME doit être définie.)

Installation

Télécharger la distribution Quick Start de TOSIAM. Extraire l’archive dans un répertoire <ROOT>. Un répertoire tosiam-quickstart-2.25.0 est créé. C’est la racine de la distribution (répertoire <INSTALL>)

Ouvrez une fenêtre Terminal (bash sur linux, cmd pour Windows) depuis le répertoire <INSTALL>

Windows
Linux

set TOSIAM_HOME=%cd%
cd bin
tosiam.bat up

export TOSIAM_HOME=$PWD
cd bin
./tosiam.sh up

Un serveur TOSIAM basé sur un serveur Tomcat 9.0 est lancé puis configuré automatiquement.

Accéder à la Console d’admin et connectez avec le compte amadmin/password

La console se présente ainsi: console

Notes:

Le répertoire de données de TOSIAM est <INSTALL>/data
Pour arrêter le serveur TOSIAM, utiliser la commande tosiam(.sh|.bat) down
Pour supprimer une configuration existante en vue de repartir de zéro, utiliser la commande tosiam(.sh|.bat) down (si serveur up), puis tosiam(.sh|.bat) delete

Scripter une configuration.

TOSIAM s’appuie sur l’outil en ligne de commmande ssoadm pour configurer par script un serveur TOSIAM. La distribution TOSIAM QuickStart permet d’invoquer facilement cet outil. Nous allons à titre d’exemple créer un realm, élément de base d’une configuration.

Ouvrez une fenêtre Terminal (bash sur linux, cmd pour Windows) depuis le répertoire <INSTALL>

Windows
Linux

set TOSIAM_HOME=%cd%
cd bin
ssoadm.bat create-realm --realm ref

export TOSIAM_HOME=$PWD
cd bin
./ssoadm.sh create-realm --realm ref

Depuis la console, vous pouvez constater la présence du realm ref: console