Configuration de SKOOR Webservice

Démarrage / arrêt / redémarrage / état du service

Le service Web eRanger est configuré comme un service Linux et peut être géré à l'aide des commandes correspondantes :

# systemctl start eranger-webservice
# systemctl stop eranger-webservice
# systemctl restart eranger-webservice
# systemctl status eranger-webservice

Configuration

Sinon, la configuration standard devrait fonctionner immédiatement sans aucune modification.

Les modifications suivantes peuvent être apportées si nécessaire :

CORS (partage de ressources entre origines)

Si le service Web doit être utilisé par une application provenant d'une autre origine, cette origine doit être ajoutée à la liste blanche sous forme de liste séparée par des virgules.

# cors.allowed.origins=

Vous n'avez pas besoin d'ajouter l'URL où se trouvent SKOOR ou SKOOR Viewer. Les requêtes provenant de la même origine sont déjà autorisées par défaut.

Fournisseurs d'IA

Les fournisseurs d'IA sont principalement utilisés pour générer du code à partir du langage naturel. La fonctionnalité Text2SQL pour les requêtes de données en est un exemple.

SKOOR prend actuellement en charge les fournisseurs suivants :

SKOOR AI
- Operé par SKOOR, aucun besoin de partager des données avec d'autres fournisseurs tiers.
- Idéal comme point de départ.
- Offre une précision et des performances de base.
- Connexion HTTPS à ai.skoor.com requise.
- Déjà préconfiguré dans chaque installation SKOOR.
OpenAI
- Probablement le fournisseur le plus avancé.
- Nécessite un abonnement API auprès d'OpenAI.
- Connexion HTTPS aux servers API OpenAI requise.
Google Gemini
- Précision similaire à celle d'OpenAI.
- Relativement rapide.
- Nécessite une clé API de Google Cloud.
- Connexion HTTPS aux servers Google Cloud requise.

Les paramètres IA (par exemple, les clés API) peuvent être configurés dans /etc/opt/eranger/eranger-webservice.cfg.

ai.enable=true 
                        # Enables or disables the AI features
ai.openaiApiKey=<key>
                        # API key can be obtained from OpenAI 
ai.googleVertexAiApiKey=/etc/opt/eranger/googleVertexAiKey.json
                        # Google JSON API key can be obtained from the Google Cloud Console.
ai.googleVertexAiProjectId=<google-project-id>
                        
ai.googleVertexAiLocation=<location>
                        # Location of the AI servers. Zurich is europe-west6

Seul l'un des deux sites google ou openai peut être actif à la fois. Si ni google ni openai ne sont configurés, SKOOR AI sera utilisé automatiquement.

Port Tomcat

Si le port standard 8090 n'est pas disponible, il peut être modifié dans le fichier « /opt/eranger/eranger-webservice/eranger-webservice.conf » :

/opt/eranger/eranger-webservice/eranger-webservice.conf

# Spring Boot service config file
# Has to be in the same directory as the JAR file
MODE=service
JAVA_HOME=/opt/eranger/eranger-jre/current
APP_NAME=eranger-webservice
JAVA_OPTS="-Dserver.port=8091"
PID_FOLDER=/var/opt/run/eranger
LOG_FOLDER=/var/log/eranger
LOG_FILENAME=eranger-webservice.log

Le même port doit être configuré dans la configuration du proxy inverse dans « /etc/httpd/conf.d/eranger-webservice-proxy.conf » :

/etc/httpd/conf.d/eranger-webservice-proxy.conf

# mod_proxy setup for using httpd as a reverse proxy for tomcat
# has to placed in /etc/httpd/conf.d
ProxyPass /eranger-webservice http://localhost:8091
ProxyPassReverse /eranger-webservice http://localhost:8091
<Location "/eranger-webservice">
  setOutputFilter DEFLATE
  Require all granted
  Satisfy Any
  Order allow,deny
  Allow from all
</Location>

Fichier PID

Dans la configuration par défaut, un fichier PID est écrit dans « /var/opt/run/eranger ».

Si vous préférez un autre chemin d'accès, vous pouvez le configurer dans le fichier « /opt/eranger/eranger-webservice/eranger-webservice.conf ».

/opt/eranger/eranger-webservice/eranger-webservice.conf

# Spring Boot service config file
# Has to be in the same directory as the JAR file
MODE=service
JAVA_HOME=/opt/eranger/eranger-jre/current
APP_NAME=eranger-webservice
JAVA_OPTS="-Dserver.port=8091"
PID_FOLDER=/new/pid/path

Multi-location

Le service web est capable d'obtenir des données à partir de plusieurs backends SKOOR Engine à l'aide du tenantId.

Pour configurer des backends supplémentaires, il faut fournir un fichier de configuration eranger-webservice-<tenantId>.cfg distinct dans le dossier /etc/opt/eranger. Ce fichier est essentiellement une copie du fichier eranger-webservice.cfg par défaut avec une adresse eranger spécifique au tenant.

/etc/opt/eranger/eranger-websevice-<tenantId>.cfg

# eRanger Server Address
eranger.address=<host of Skoor server>

Vous n'avez pas besoin de modifier les fichiers files.root ou reports.root. Le serveur web gère lui-même la séparation de ces dossiers.

Une fois la configuration enregistrée, vous devriez pouvoir récupérer les données de l'SKOOR Engine configuré en fournissant soit l'en-tête de requête HTTP X-Tenant-Id, soit le paramètre URL tenantId.