Service start / stop / restart /status

Le Webservice eRanger est configuré comme un service Linux et peut être géré avec les commandes correspondantes :

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

Configuration

La configuration standard devrait fonctionner sans aucun changement.

Les changements suivants peuvent être effectués si nécessaire :

Fournisseurs d'IA

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

SKOOR prend actuellement en charge les fournisseurs suivants :

• SKOOR AI

  • Opéré par SKOOR, aucun besoin de partager des données avec d'autres fournisseurs tiers.

  • Bon point de départ.

  • Fournit 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 à l'API d'OpenAI.

  • Connexion HTTPS aux serveurs API d'OpenAI requise.

• Google Gemini

  • Précision similaire à celle d'OpenAI.

  • Relativement rapide.

  • Nécessite une clé API de Google Cloud.

  • Connexion HTTPS aux serveurs de Google Cloud requise.

Les paramètres de l'IA (par exemple, les clés API) peuvent être configurés à l'adresse /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

Seules les adresses google et openai peuvent être actives en même temps. 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 un chemin différent est préféré, il peut être configuré 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-tenance

Le webservice est capable d'obtenir des données de plusieurs Backends SKOOR Engine en utilisant le tenantId.

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

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

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

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