Configurer Essbase sous Windows

Vous devez configurer Essbase sous Windows à l'aide de l'outil de configuration après l'installation.

Prérequis et remarques

  • Fusion Middleware doit déjà être installé et Oracle Essbase doit être installé dans le même répertoire d'accueil Oracle. Reportez-vous à Installation de Fusion Middleware.
  • La base de données relationnelle prise en charge doit être installée, comme indiqué dans les conditions préalables à l'installation. Reportez-vous à Installer une base de données relationnelle.
  • Si vous utilisez l'authentification EPM Shared Services, vous devez déjà avoir installé une version d'EPM prise en charge, avec les utilisateurs EPM Shared Services créés et configurés, et connaissez les détails de votre répertoire de base Oracle et de votre instance EPM.
    • Si vous utilisez l'authentification EPM Shared Services, elle doit être exécutée pendant la configuration Essbase. Si EPM Shared Services n'est pas en cours d'exécution, certains numéros de port doivent être configurés manuellement pour éviter les conflits de port. Lorsque vous configurez Essbase, vous devez être prudent et être conscient des ports déjà utilisés par les services EPM sur cet hôte, et de choisir et d'utiliser uniquement des ports valides qui ne sont pas utilisés par un service ou une application sur cet hôte. Vous devez également définir ces numéros de port inutilisés en conséquence dans l'interface utilisateur ou dans le fichier de réponses.
  • Si vous utilisez Microsoft SQL Server (MSSQL) en tant que base de données pour les schémas du référentiel Essbase (RCU), vous devez exécuter le processus de modification de la base de données et d'application des considérations de regroupement et de schéma d'adresse correctes avant d'exécuter l'outil de configuration Essbase. Pour plus d'informations, reportez-vous à Configuration de Microsoft SQL Server en tant que base de données du référentiel pour les schémas Essbase.
  • Pré-créer des schémas RCU pour Essbase explique le processus si vous choisissez de pré-créer des schémas RCU avant la configuration plutôt que de les créer pour vous à l'aide de l'outil de configuration. Si vous utilisez une connexion HTTPS sécurisée à l'aide d'un portefeuille, vous pouvez précréer des schémas.
  • Dans le Panneau de configuration de Windows > Horloge et région > Région, sélectionnez l'onglet Administration. Cliquez sur Modifier les paramètres locaux du système, puis activez la case Bêta : utiliser le format Unicode UTF-8 pour la prise en charge de langues à l'échelle mondiale.
  • Essbase sous Windows ne peut pas avoir plusieurs configurations ou instances sur le même hôte.

  • Vous devez appliquer les patches suivants au répertoire de base Oracle avant de créer des schémas RCU, que vous utilisiez ou non des schémas pré-créés. Consultez les derniers patches de la section Essbase Release Notes pour le déploiement indépendant, ou contactez le support technique pour vérifier les versions de patch appropriées.

    • 28186730 - La dernière version de OPatch 13.9.4.2.x pour FMW/WLS
    • 31676526 : patch 12.2.1.4.0 pour avertissement RCU TNS_ADMIN
    • 30540494 - patch 12.2.1.4.0 pour bogue RCU RAC
    • 30754186 - patch 12.2.1.4.0 pour bogue RCU RAC
  • Tous les ports ne doivent pas se trouver dans la plage de ports éphémères, ni être utilisés par d'autres logiciels en cours d'exécution. Reportez-vous à Evitement des conflits de ports.
  • Chaque serveur géré doit être affecté à une machine, la représentation logique de l'ordinateur qui héberge une ou plusieurs instances de serveur. Le nom de la machine doit être unique par rapport aux autres ressources configurables du domaine.
  • Si vous prévoyez d'installer et de configurer plusieurs instances Essbase sur site, pour prendre en charge le basculement en cas d'incident, vous avez besoin d'un équilibreur de charge front-end et les instances doivent être configurées sur différents hôtes. Comme indiqué, Essbase sous Windows ne peut pas avoir plusieurs configurations ou instances sur le même hôte. Reportez-vous à Configuration d'un équilibreur de charge pour prendre en charge le basculement.
  • Si le service Essbase doit être configuré ou disponible en tant que service Windows Essbase, pour démarrer et arrêter le service Essbase, PowerShell doit se trouver dans la variable PATH de l'environnement. Vous devez également activer le service Windows Essbase lors de la configuration pour installer le service Windows.
  • Si vous êtes connecté via Smart View, à l'aide de l'URL /aps/SmartView, vous devez modifier l'URL. Reportez-vous à Rediriger vers une nouvelle URL de connexion Essbase Smart View. Vous pouvez également configurer la redirection vers la nouvelle URL sur le serveur Web. Si vous utilisez Oracle HTTP Server (OHS) ou HTTPD Server, redirigez l'URL lors de la modification de la configuration d'Oracle HTTP Server, comme indiqué dans la puce précédente.
  • Pour accéder au fichier de réponses et l'utiliser, vous devez définir les variables d'environnement TEMP et TMP pour l'utilisateur, comme suit :
    1. Dans la barre des tâches Windows, cliquez avec le bouton droit de la souris sur l'icône Windows et sélectionnez Système.
    2. Sur la page Paramètres, sous l'en-tête Paramètres associés à droite, cliquez sur Informations sur les systèmes, puis sur Paramètres système avancés.
    3. Sélectionnez Variables d'environnement.
    4. Cliquez sur Nouveau pour créer de nouvelles variables d'environnement TEMP et TMP ou sur Modifier pour modifier les variables d'environnement existantes TEMP et TMP avec vos valeurs de variable utilisateur. Vous pouvez utiliser la même valeur pour les deux.
    5. Après avoir défini, ouvrez une nouvelle commande ou une invite de commande pour refléter le nouvel ensemble de variables.

Exécuter l'outil de configuration

  1. Si vous n'avez pas poursuivi la configuration à la fin de l'installation, lancez l'outil de configuration.
    1. Dans le répertoire de base Oracle, dans lequel Essbase et Fusion Middleware sont installés, ouvrez un terminal dans \essbase\bin. Par exemple, ouvrez un terminal dans <Oracle_Home>\essbase\bin.
    2. Lancez l'outil de configuration à l'aide du script de commande config.cmd.
      config.cmd
      Le script peut être exécuté avec des paramètres (tels que -mode, -log, -log priority, -responseFile). Si vous utilisez le paramètre responseFile, tous les champs sont remplis avec des entrées de configuration précédentes, à l'exception des mots de passe. Pour en savoir plus sur les options de script de configuration, exécutez config.cmd -help.
  2. Sur la page Bienvenue, cliquez sur Suivant.
  3. Dans la page Détails du domaine, procédez comme suit.
    1. Acceptez la valeur par défaut (le cas échéant) ou entrez votre nom de domaine, par exemple, essbase_domain.
    2. Acceptez la valeur par défaut (le cas échéant) ou saisissez le chemin racine du domaine, par exemple :
      C:\Oracle_home\dist\domains
    3. Acceptez la valeur par défaut ou entrez le répertoire de votre application, par exemple :
      C:\Oracle_home\dist\applications\essbase
      Il est recommandé de séparer le répertoire des applications des fichiers de configuration.
    4. Entrez le nom et le mot de passe d'un compte d'administrateur WebLogic que vous utiliserez pour gérer les serveurs Essbase et middleware.
      • Si vous utilisez WebLogic Embedded LDAP, cet administrateur dispose également d'un rôle d'administrateur de service Essbase.
      • Si vous utilisez EPM Shared Services, cet administrateur est uniquement destiné à l'instance WebLogic du domaine Essbase. L'administrateur EPM Shared Services sera provisionné avec le rôle d'utilisateur Essbase : Administrateur de service.
    5. Cliquez sur Suivant.
  4. Dans la page de connexion à la base de données, procédez comme suit :
    1. Acceptez la valeur par défaut ou entrez le type de base de données. Il s'agit de la base de données relationnelle prise en charge, par exemple, Oracle Database.
    2. Entrez la chaîne de connexion, par exemple :
      myhost.example.com:1521/orcl
      Reportez-vous à Formats de chaîne de connexion.
    3. Choisissez de créer des schémas maintenant ou d'utiliser des schémas pré-créés que vous avez créés à l'aide de l'utilitaire RCU Fusion Middleware dans Pré-créer des schémas RCU pour Essbase, en tant que tâche de workflow de préconfiguration. Si vous utilisez Microsoft SQL Server (MSSQL) dans la configuration, reportez-vous au prérequis associé ci-dessus.
    4. Entrez un préfixe de schéma, par exemple ESS26AI. Il doit s'agir d'une nouvelle chaîne unique, contenant de 1 à 12 caractères alphanumériques et commençant par une lettre.
    5. Entrez un mot de passe de schéma qui sera partagé pour tous les nouveaux schémas.
    6. Pour le nom utilisateur et le mot de passe de l'administrateur, entrez les informations d'identification de tout utilisateur disposant du rôle sysdba pour Oracle Database. Il peut s'agir de l'utilisateur sys par défaut ou de l'administrateur de base de données Microsoft. Le nom d'utilisateur doit commencer par une lettre et contenir entre 5 et 128 caractères alphanumériques. Le mot de travail doit commencer par une lettre, comporter entre 8 et 30 caractères, contenir au moins un chiffre et éventuellement des caractères spéciaux ($ # _).
    7. Cliquez sur Suivant.
  5. Dans la page Configuration du gestionnaire de noeuds, procédez comme suit :
    1. Acceptez les valeurs par défaut ou entrez la chaîne du nom de machine du gestionnaire de noeuds, qui gère les clusters. Tous les ports ne doivent pas se trouver dans la plage de ports éphémères, ni être utilisés par d'autres logiciels en cours d'exécution. Reportez-vous à Evitement des conflits de ports.
    2. Pour l'adresse d'écoute du gestionnaire de noeuds, vous pouvez saisir ou sélectionner votre nom d'hôte complet (où WebLogic est installé avec votre installation Fusion Middleware). Il peut également s'agir d'une adresse de système d'exploitation. Pour référence, reportez-vous à Configuration des adresses d'écoute.
    3. Cliquez sur Suivant.
  6. Sur la page Configuration des ports du serveur WebLogic, configurez-la en fonction des choix que vous avez effectués lors de l'installation.
    Acceptez les valeurs par défaut ou saisissez des valeurs. Les valeurs de l'écran ci-dessus ne sont que des exemples. Spécifiez des ports clairs et sécurisés pour chacun des serveurs. Reportez-vous à Options de configuration du serveur. Tous les ports ne doivent pas se trouver dans la plage de ports éphémères, ni être utilisés par d'autres logiciels en cours d'exécution. Reportez-vous à Evitement des conflits de ports.
    1. Pour sécuriser les connexions à l'aide de TLS Everywhere (Transport Layer Security), cochez la case Mode de connexion sécurisée. Votre certificat auto-signé est alors reconnu. Si vous ne l'avez pas déjà fait, consultez cette rubrique : A propos de la sécurisation de votre communication et de votre réseau. Si la sécurité TLS est déployée, le port par défaut est le port sécurisé du serveur géré. La valeur de port par défaut est 9000 pour non sécurisé et 9001 pour sécurisé. Il est recommandé d'utiliser secure (9001).

      Si vous configurez Essbase pour qu'il utilise une base de données relationnelle non Oracle en tant que base de données du référentiel RCU, vous devrez peut-être prendre des mesures supplémentaires, une fois le déploiement Essbase terminé, pour configurer les pilotes ODBC de votre système afin de prendre en charge le cryptage sécurisé/TLS. Consultez les instructions de configuration du pilote de base de données.

    2. [Facultatif] Pour limiter l'accès à des hôtes spécifiques (pour un environnement multi-accueil), indiquez ou sélectionnez un domaine, par exemple localhost, dans les champs d'adresse d'écoute. Si vous ne sélectionnez/entrez pas de valeurs d'adresses d'écoute, les adresses d'écoute s'appliquent à toutes les interfaces et adresses, et tous les hôtes mis en correspondance sont accessibles.
    3. Cliquez sur Suivant.
  7. Sur la page Configuration des ports Essbase, procédez comme suit.
    1. Acceptez les valeurs par défaut ou entrez des valeurs pour le port d'agent, le port sécurisé d'agent (utilisé pour la communication sécurisée à l'aide de TLS) et les ports minimum et maximum pour les serveurs d'applications Essbase.
      • Le port de l'agent indique le port de l'agent Essbase. La valeur par défaut est 1423.
      • Le port sécurisé de l'agent indique le port que l'agent Essbase utilise pour la communication sécurisée lorsqu'il est en mode de connexion sécurisée avec TLS (Transport Layer Security). La valeur par défaut est 6423.
      • Lorsque plusieurs instances du serveur Essbase sont installées sur un hôte, vous devez spécifier un numéro de port unique pour chaque instance.
      • Tous les ports ne doivent pas se trouver dans la plage de ports éphémères, ni être utilisés par un autre logiciel en cours d'exécution. Reportez-vous à Evitement des conflits de ports.
      • La plage entre les ports Min et Max doit être d'au moins 1000, en fonction de la quantité utilisée.
    2. Cliquez sur Suivant.
  8. Dans la page de configuration du fournisseur d'identités, procédez comme suit.
    1. Si vous ne l'avez pas déjà fait, consultez la rubrique Sélectionner un fournisseur d'authentification.
    2. WebLogic est la valeur par défaut. Si vous utilisez actuellement EPM Shared Services et souhaitez continuer, cochez la case Activer le fournisseur d'identités EPM Shared Services. L'exemple de fenêtre montre le fournisseur EPM sélectionné. Lorsque cette option est activée, les champs EPM vous permettent de confirmer ou de spécifier les emplacements du répertoire de base Oracle EPM et de l'instance Oracle. Pour plus de détails sur ces éléments, reportez-vous à la section A propos du répertoire d'accueil Middleware, du répertoire d'accueil EPM Oracle et de l'instance EPM Oracle.
    3. Pour que le service Windows Essbase soit configuré ou disponible, pour démarrer et arrêter le service Essbase, PowerShell doit se trouver dans la variable d'environnement PATH. Vous devez également activer le service Windows Essbase lors de la configuration pour installer le service Windows. Pour utiliser cette fonctionnalité, vous devez sélectionner Activer le service Windows Essbase sur cette page pour installer le service Windows. Le démarrage et l'arrêt du service Windows Essbase sont effectués à l'aide de Windows SCM.
    4. Cliquez sur Suivant.
  9. Consultez la page Configuration Summary. Notez l'emplacement du fichier journal (le cas échéant) et celui du fichier de réponses. Cet exemple de fenêtre peut différer des valeurs ou entrées sélectionnées. Vous pouvez utiliser le fichier réponse (.rsp) pour enregistrer vos choix de configuration et remplir les mêmes valeurs de champ (à l'exclusion des mots de passe) dans une configuration future basée sur l'interface utilisateur ou en mode silencieux. Si vous souhaitez exécuter une configuration future à l'aide d'un fichier .rsp, vous pouvez également exécuter la configuration jusqu'à la page récapitulative, puis cliquer sur Annuler au lieu de Configurer et réutiliser le fichier de réponses ultérieurement. Le fichier .rsp est enregistré à l'emplacement temporaire répertorié dans le résumé en tant qu'emplacement du fichier de réponses. Si vous prévoyez de l'utiliser pour automatiser une configuration future, veillez à l'enregistrer dans un emplacement plus permanent, car les répertoires tmp peuvent être nettoyés régulièrement. Reportez-vous à Exemple de fichier de réponse et de paramètres.
  10. Cliquez sur Configurer. Sur la page Progression de la configuration, vers la fin du traitement de l'outil de configuration, les composants de la plate-forme Essbase sont démarrés. Lorsque la progression atteint 100 %, cliquez sur Suivant.
  11. Sur la page Configuration terminée, vérifiez les détails, puis cliquez sur Terminer. Notez que cet exemple de fenêtre ne reflète pas nécessairement vos valeurs ou entrées sélectionnées. Vous pouvez maintenant vous connecter à Essbase. Pour les URL de connexion, reportez-vous à URL de client Essbase, REST et Smart View.

    Remarques :

    Si vous avez configuré Essbase en toute sécurité avec une base de données externe à l'aide d'un alias TNS_ADMIN, par exemple, adwsql_low?TNS_ADMIN=C:/Users/opc/Documents/EssbaseADWS, vous devez effectuer les opérations suivantes pour que la connexion puisse être traitée par le serveur Essbase :

    1. Modifier: 
      <DOMAIN_HOME>\bin\setStartupEnv.cmd
    2. Ajoutez la ligne suivante au script de démarrage, avant l'utilisation de -DODBC_URL= : 
      set TNS_ADMIN=C:/Users/opc/Documents/EssbaseADWS
    3. Modifiez la ligne suivante : 
      -DODBC_URL='OCI;SERVICE=adwsql_low?TNS_ADMIN=C:/Users/opc/Documents/EssbaseADWS'

      to

      -DODBC_URL='OCI;SERVICE='adwsql_low'
Les options et tâches avancées et post-configuration peuvent être examinées dans la section Advanced Configuration Topics. Cela inclut des rubriques sur la suppression de schémas RCU, la configuration du serveur Essbase et Oracle HTTP, etc.