Configuration d'Essbase sous Linux

Vous devez configurer Essbase sous Linux à l'aide de l'outil de configuration, soit à la fin de l'installation d'Essbase, soit en lançant l'outil de configuration ultérieurement, 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 Connaître 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 en cours d'exécution lors de la configuration Essbase 26ai. 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 connaître les ports déjà utilisés par les services EPM sur cet hôte, et choisir et utiliser uniquement les 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 Essbase. Si vous utilisez une connexion HTTPS sécurisée à l'aide d'un portefeuille, vous pouvez précréer des schémas.
  • 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 on-premise, pour prendre en charge le basculement, vous avez besoin d'un équilibreur de charge frontal. Reportez-vous à Configuration d'un équilibreur de charge pour prendre en charge le basculement.
  • 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 l'élément précédent.

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 config.sh. 
      $ ./config.sh
      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.sh -help.
  2. Sur la page d'accueil, cliquez sur Suivant.
  3. Dans la page Détails du domaine, procédez comme suit :
    1. Pour Nom de domaine, acceptez la valeur par défaut (le cas échéant) ou entrez votre nom de domaine ; par exemple, essbase_domain
    2. Pour la racine de domaine, acceptez la valeur par défaut (si elle est correcte) ou entrez le chemin racine de votre domaine ; par exemple,
      /scratch/user/oracle_home/domains
      Si vous installez des instances Essbase supplémentaires, utilisez une racine de domaine différente pour chacune d'elles.
    3. Pour Application Directory, acceptez la valeur par défaut ou entrez votre répertoire d'application ; par exemple,
      /scratch/user/oracle_home/applications/essbase
      Il est recommandé de séparer le répertoire des applications des fichiers de configuration.
    4. Pour le compte d'administrateur WebLogic, 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 Database Connection, procédez comme suit :
    1. Pour le type de base de données, 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. Dans Chaîne de connexion, entrez la chaîne de connexion à la base de données. Par exemple,
      myhost.example.com:1521/orcl
      Reportez-vous à Formats de chaîne de connexion.
    3. Pour le référentiel Essbase, choisissez de créer des schémas maintenant ou d'utiliser les 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. Dans Préfixe de schéma, entrez un préfixe unique et significatif, 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. Pour Schema Password, 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 passe doit commencer par une lettre, comporter entre 8 et 30 caractères, contenant 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. Pour le nom de la machine, acceptez les valeurs par défaut ou entrez la chaîne du nom de la 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 le port du gestionnaire de noeuds, acceptez la valeur par défaut, sauf si vous savez que votre organisation a choisi une valeur différente lors de la configuration de Fusion Middleware. Pour référence, reportez-vous à la section Managing Ports.
    3. Pour l'adresse d'écoute du gestionnaire de noeuds, vous pouvez saisir votre nom d'hôte Linux complet (où WebLogic est installé avec votre installation Fusion Middleware). Il peut également s'agir d'une adresse de système d'exploitation. Pour plus d'informations, reportez-vous à Changing the Port Numbers Used by Oracle Fusion Middleware.
    4. 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.
    Spécifiez des ports clairs et sécurisés pour chacun des serveurs. Reportez-vous à Managing Ports. 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 un domaine, par exemple localhost, dans les champs d'adresse d'écoute. Si vous n'indiquez/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 Essbase Server 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 le fournisseur d'identités par défaut, mais il n'est pas recommandé pour les environnements de production. 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. [Facultatif] Vous pouvez éventuellement saisir un nom pour inscrire l'instance Essbase auprès des services partagés. Si aucun nom n'est fourni, EPM génère le nom de l'instance inscrite.
    4. Cliquez sur Suivant.
  9. Consultez la page Configuration Summary. Notez l'emplacement du fichier journal et du fichier de réponses. 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. Vous pouvez désormais vous connecter à Essbase. Reportez-vous à URL de client Essbase, REST et Smart View.
Consultez les options et tâches avancées et post-configuration dans la section Advanced Configuration Topics. Il s'agit des rubriques suivantes : suppression de schémas RCU, configuration d'Essbase et du serveur HTTP Oracle, etc.