Introduction

Ce guide traite de l'installation du SKOOR Dashboard Viewer. Pour l'installation de SKOOR Engine ou de Red Hat, veuillez consulter le guide d'installation de SKOOR Engine. Pour plus d'informations sur l'architecture des composants du tableau de bord, veuillez consulter la page Composants dans la section Architecture de ce guide.

Prérequis

• Le dépôt RPM SKOOR est disponible

Matériel

Système du Dashboard Viewer

Le Viewer Service s’exécute sur une petite machine. 2 Go de RAM et 2 cœurs de processeur suffiront.

Système du fournisseur de tableaux de bord

En général, le service « Fournisseur de tableaux de bord » est installé sur le serveur SKOOR Engine. Si ce serveur a été dimensionné avec une marge suffisante, ce composant devrait fonctionner correctement sur le même système. De plus, dans la plupart des cas, un composant « Tableaux de bord » est déjà installé et présente les mêmes prérequis.

Logiciels

Système Dashboard Viewer

Le Dashboard Viewer nécessite le serveur Apache httpd ainsi que le module mod_ssl. Veuillez installer les paquets RPM correspondants à partir des dépôts et démarrer le serveur :

$ sudo yum install httpd mod_ssl
$ sudo /sbin/service httpd start

Configurez httpd pour qu’il démarre au démarrage du système :

$ sudo systemctl enable httpd

Configurez firewalld :

$ sudo firewall-cmd --add-port=443/tcp --permanent
$ sudo firewall-cmd --reload

Avant d'installer les composants SKOOR, SELINUX doit être désactivé :

# vi /etc/selinux/config
SELINUX=permissive

# setenforce 0
#
# sestatus
...
Current mode:                 permissive
...

Enfin, le Dashboard Viewer a besoin d’un fournisseur de tableau de bord qui lui fournit les données provenant du SKOOR Webservice.

Système « Dashboard Provider »

Les composants SKOOR suivants doivent être installés sur le système où le Dashboard Provider sera installé :

• eranger-webservice

• eranger-dashboards

De plus, bien entendu, une instance de l’SKOOR Engine doit être disponible.

Installation

Système Dashboard Viewer

Installez à partir du dépôt RPM de SKOOR à l'aide de yum :

sudo yum install eranger-nodejs eranger-dashboard-viewer-service eranger-doc

Pour configurer le Dashboard Viewer, ouvrez le fichier /etc/opt/eranger/eranger-dashboard-viewer-service.json.

Exemple :

{
  "port": 8092,
  "presharedKey": "1234567890",
  "logLevel": "debug",
  "defaultUsername": "dashboard-user",
  "defaultPassword": "dashboard-user"
}

Vérifiez l'état du Dashboard Viewer en accédant à l'URL suivante à l'aide d'un navigateur :

https://<NOM du server du viewer>/SKOOR Dashboard Viewer Service/status

Le résultat devrait se présenter comme suit :

{"status":"ok"}

En supposant que le Dashboard Viewer soit accessible sous son propre nom de domaine complet (FQDN), par exemple hostname.domain.com. Configurez la redirection directement vers la page d’accueil du Dashboard Viewer en ajoutant les lignes suivantes dans le fichier de configuration SSL d’Apache /etc/httpd/conf.d/ssl.conf (dans le bloc <VIRTUALHOST *:443> existant) :

<VirtualHost *:443> #find this existing block in your ssl configuration file and add the lines below

    # Rewrite only / without anything else to /skoor-dashboard-viewer/
    RewriteEngine On
    RewriteRule ^/$ https://%{SERVER_NAME}/skoor-dashboard-viewer/ [R,L]

Pour que cette configuration fonctionne, le répertoire DocumentRoot doit exister. Créez-le, puis redémarrez le serveur Web à l’aide des commandes suivantes :

$ sudo mkdir -p /srv/eranger/html
$ sudo systemctl restart httpd

Système Dashboard Provider

Installez les paquets nodejs et dashboard-viewer-provider :

$ sudo yum install eranger-dashboard-viewer-provider

Configurez le Viewer Provider Dashboard Viewer en modifiant le fichier /etc/opt/eranger/eranger-dashboard-viewer-provider.json. Voici une brève description des propriétés disponibles :

 Exemple :
 

{
  "logLevel": "debug",
  "webserviceUrl": "http://localhost:8090",
  "authUrl": "http://localhost:8094",
  "tenantId": "default",
  "viewerServices": {
    "dashboard-viewer": {
      "url": "https://<viewer server name or ip>/skoor-dashboard-viewer-service",
      "presharedKey": "1234567890"
    }
  }
}

Redémarrez maintenant le service fournisseur :

sudo systemctl restart eranger-dashboard-viewer-provider.service

Mise à jour

Mettez à jour n'importe quel paquet SKOOR à l'aide de la commande `yum update` :

$ sudo yum update eranger-dashboards-*.rpm

Smoke test

Ouvrez l'URL https://<NOM du server de visualisation>/SKOOR Dashboard Viewer dans un navigateur web. Un tableau de bord visible par l'utilisateur par défaut configuré devrait s'afficher sans qu'il soit nécessaire de se connecter au préalable. Si cette fonctionnalité est disponible, il est possible de basculer vers un autre tenant en ajoutant le paramètre URL tenantId à l’URL : https://<NOM du server de visualisation>/SKOOR Dashboard Viewer?tenantId=someTenant

Dans le menu utilisateur, le lien « Connexion » permet de se connecter avec un autre utilisateur, généralement un utilisateur autorisé à afficher des informations privilégiées qui ne devraient pas être visibles par l’utilisateur par défaut :

Cliquez sur « Connexion » et saisissez vos identifiants, en indiquant éventuellement un autre tenant avant le nom d’utilisateur :

Les tableaux de bord privés devraient désormais être visibles.