Installation de MyReport Center
Chapitre 3. Installation

MyReport Center et MyReport Server doivent pouvoir communiquer entre eux :

• Le serveur Center doit pouvoir communiquer avec le serveur MyReport (port 9089 par défaut).
• L'application MyReport Server doit connaitre les URLs de MyReport Center (Onglet "Serveur Web" de l'application "MyReport Server" à renseigner).

éléments installés par l'updater :

• Les deux sous-sites :

  • CenterExtension : sous-site Extension manager.
  • CenterExtensionAPI : sous-site pour la gestion API d' Extension Manager.

• Les deux pools d'applications :

  • extapi
  • extensions

• Explications :

  • urlExtensionManager : Permet à l'application d'accéder au site extensions pour le paramétrage de l'extension.

• Ouvrir le port de MyReport Server (par défaut : 9089) pour permettre son utilisation par le Serveur Web (Center).

• Pour une utilisation de MyReport Center sur une machine distante ou sur un serveur MyReport sécurisé avec un certificat SSL, suite à l'installation, il est nécessaire de modifier les fichiers de configuration ci-dessous :

  • Site	Chemin par défaut du fichier de configuration	Paramétrage à ajouter (partie en gras)
    Client Center	C:\inetpub\MyReportCenter\ClientCenter\assets\config\config-center.json	{ "urlServerCenter": "/api", "urlAuthentication": "/auth", "urlExtensionManager": "###MonServeurMyReport###/extensions", "urlExtensionManagerApi": "###MonServeurMyReport###/extapi", "hideKpisUntilMeasurements": false, "urlMyReportUpdaterInstaller": "", "enablePortDiscovery": true }
    Site d'authentification	C:\inetpub\MyReportCenter\ServerIdentity\appsettings.json	{ "urlClient": "/", "urlExtensionManagerClient": "###MonServeurMyReport###/extensions", "urlExtensionManagerApi": "###MonServeurMyReport###/extapi/api/v1", "applicationServer" : { "enabled" : true, "host" : "###MonServeurMyReport###", "port" : 9089, "SSLEnabled" : true, "certificat": "###NOM DU CERTIFICAT###" }, "identityProvider": { "isPermettreAuthentificationBE": true // Permet l'affichage d'une fenêtre intermédiaire permettant la connexion avec un utilisateur MyReport (hors fournisseur d'identité) même sur un compte avec un IdP de type Graph configuré. Sinon, l'utilisateur est directement redirigé pour authentification sur l'environnement de l'IdP. } }
    Site API	C:\inetpub\MyReportCenter\ServerCenter\appsettings.json	{ "Logging": { "LogLevel": { "Default": "Warning" } }, "AllowedHosts": "*", "urlAuthentication": "/auth", "AllowedHosts": "*", "ConnectionStrings": { "ExtensionManagerStorageAPI": "https://extension-manager-api.myreport.fr" }, "ExtensionGrpc": { "ChannelUrl": "http://localhost:9089" }, "Serilog": { }, "applicationServer" : { "enabled" : true, "host" : "###MonServeurMyReport###", "port" : 9089, "SSLEnabled" : true, "certificat": "###NOM DU CERTIFICAT###" } }

  • Explication

    • enabled : Indique que le serveur est dédié (par défaut à true).
    • host : Il s'agit de l'adresse du serveur MyReport BE qui est accessible depuis le serveur dédié.
    • port : Numéro de port utilisé par le serveur MyReport BE.
    • SSL Enabled : Cette option spécifie si le paramètre de connexion sécurisée est activé dans MyReport Server, permettant ainsi l'utilisation du protocole SSL/TLS pour chiffrer les communications.
    • Certificat : Il s'agit du nom de domaine associé au certificat SSL déclaré dans MyReport Server. Ce certificat est utilisé pour établir une connexion sécurisée entre MyReport Center et MyReport Server.

  Note

  Le fichier doit être dans un format JSON valide, il faut faire attention à rajouter une virgule avant "applicationServer".

Procédure d'installation :

• Vérification d'une installation précédente de IIS (IIS-WebServer et IIS-WebServerRole) et proposition d'installation

  • Si l'utilisateur accepte, le setup installe IIS, URL Rewrite et DotNetCoreBundle et demande le redémarrage de la machine.

  • Si l'utilisateur refuse, IIS, URL Rewrite et DotNetCoreBundle ne seront pas installés, et Center ne sera pas configuré automatiquement.

    Les fichiers de Center seront tout de même copiés, et l'utilisateur pourra faire une installation manuelle ultérieure.

• Si IIS est installé :

  • Le setup opère une vérification et l'installation de « URL Rewrite » et « DotNetCoreBundle ».
• Installation des applications lourdes MyReport.
• Copie des fichiers Center.

• Si IIS est installé, le setup vérifie si un site IIS utilise le dossier de Center :

  • Si un site existe, l'installation est terminée.

  • Sinon :

    • Le setup demande à l'utilisateur s'il veut l'installer automatiquement et lui demande de choisir un port parmi la liste suivante (filtrés sur les ports déjà utilisés par IIS) : 80, 81, 82, 8080, 8081, 8082.
    • Le setup effectue la configuration des sites et des pools d'applications pour une installation standard en localhost sur le port choisi.

Création des Pools d'applications

• Lancer le Gestionnaire des services Internet (IIS)
• Cliquer sur le nœud serveur
• Cliquer droit sur " Pools d'applications"
• Cliquer sur ajouter "Ajoute un pool d'applications"

• Tableau 3.1. Configuration du Pool d'application Center

  Paramètre	Valeur
  Version du CLR.NET	Aucun code managé
  Identité	LocalSystem (ou utilisateur ayant les droits sur les MySystems)

  
  

• Tableau 3.2. Configuration du Pool d'application CenterAPI

  Paramètre	Valeur
  Version du CLR.NET	Aucun code managé
  Identité	LocalSystem (ou utilisateur ayant les droits sur les MySystems)

  
  

• Tableau 3.3. Configuration du Pool d'application CenterAuth

  Paramètre	Valeur
  Version du CLR.NET	Aucun code managé
  Identité	LocalSystem (ou utilisateur ayant les droits sur les MySystems)

  
  

• Tableau 3.4. Configuration du Pool d'application CenterExtension

  Paramètre	Valeur
  Version du CLR.NET	Aucun code managé
  Identité	LocalSystem (ou utilisateur ayant les droits sur les MySystems)

  
  

• Tableau 3.5. Configuration du Pool d'application CenterExtensionAPI

  Paramètre	Valeur
  Version du CLR.NET	Aucun code managé
  Identité	LocalSystem (ou utilisateur ayant les droits sur les MySystems)

  
  

Création du site "Center"

• Tableau 3.6. Dans l'arborescence sur la gauche, faire un clic droit sur "Sites", puis sélectionner "Ajouter un site"

  Nom du site	Center
  Chemin d'accès physique	C:\inetpub\MyReportCenter\ClientCenter
  Port	8080
  Pool d’applications	Center

  
  

Création du sous-site "api"

• Tableau 3.7. Click droit sur le site Center => « Ajouter une application »

  Alias	api
  Chemin d'accès physique	C:\inetpub\MyReportCenter\ServerCenter
  Pool d’applications	CenterAPI

  
  

• Retirer les règles de réécriture d’URL si elles existent

  • Sélectionner l’application « api »
  • Double-cliquer sur « Réécriture d’URL »
  • Supprimer la règle « pushState »

Création du sous-site "auth"

• Tableau 3.8. Click droit sur le site Center => « Ajouter une application »

  Alias	auth
  Chemin d'accès physique	C:\inetpub\MyReportCenter\ServerIdentity
  Pool d’applications	CenterAuth

  
  

• Retirer les règles de réécriture d’URL si elles existent

  • Sélectionner l’application « auth »
  • Double-cliquer sur « Réécriture d’URL »
  • Supprimer la règle « pushState »

Création du sous-site "extapi"

• Tableau 3.9. Click droit sur le site Center => « Ajouter une application »

  Alias	extapi
  Chemin d'accès physique	C:\inetpub\MyReportCenter\APIExtensionManager
  Pool d’applications	CenterExtensionAPI

  
  

• Retirer les règles de réécriture d’URL si elles existent

  • Sélectionner l’application « extapi»
  • Double-cliquer sur « Réécriture d’URL »
  • Supprimer la règle « pushState »

Création du sous-site "extensions"

• Tableau 3.10. Click droit sur le site Center => « Ajouter une application »

  Alias	extensions
  Chemin d'accès physique	C:\inetpub\MyReportCenter\ClientExtensionManager
  Pool d’applications	CenterExtension

  
  

• Retirer les règles de réécriture d’URL si elles existent

  • Sélectionner l’application « extensions»
  • Double-cliquer sur « Réécriture d’URL »
  • Supprimer la règle « pushState »

• Internet Information Services

  • Outils d'administration Web

    • Console de gestion IIS

  • Services World Wide Web

    • Fonctionnalités de performances

      • Compression du contenu statique

    • Fonctionnalités HTTP communes

      • Contenu statique
      • Document par défaut
      • Erreurs HTTP
      • Exploration de répertoire

    • Intégrité et diagnostics

      • Journalisation HTTP

    • Sécurité

      • Filtrage des demandes
• .NET Framework 3.5

• .NET Framework 4.8 (ou 4.6) Advanced Services

  • ASP .NET 4.8 (ou 4.6)
  • Services WCF/Partage de port TCP