Convertir une application en mode Unicode en mode "aggregate storage" non Unicode

Avant d'exporter une application en mode "aggregate storage" à partir d'Essbase 11g sur site en vue de la migration vers Essbase 26ai, convertissez-la en mode unicode.

Configuration côté client : pour configurer ESSCMD/ESSCMDQ sur un client Windows

  1. Dans l'interface Web Essbase 26ai, téléchargez le client Essbase pour Windows et le client MaxL.

  2. Extraire le client MaxL vers un répertoire MaxLClient.

  3. Extrayez le client ESSCMD dans un répertoire EssbaseClient.

  4. Copiez le script startMAXL.bat du répertoire MaxLClient vers le répertoire EssbaseClient. Renommez le script en startEsscmd.bat.

  5. Modifiez le fichier startEsscmd.bat et ajoutez un nouveau paramètre pour appeler esscmd, au lieu de esscmd.sh : 

    "%ESSBASEPATH%\bin\esscmd" %*

  6. Enregistrez le fichier. Exécutez-le en tant qu'administrateur et testez la connexion à Essbase 26ai Marketplace ou au déploiement indépendant.

    Syntaxe de connexion :

    login https://<servername_or_IP>/essbase/agent <user> <password>

  7. Une fois que vous avez confirmé son fonctionnement, téléchargez ESSCMDQ pour Windows à partir de https://www.oracle.com/middleware/technologies/esscmdq-sampleapps-downloads.html.

  8. Extrayez ESSCMDQ.exe vers le répertoire EssbaseClient/bin.

  9. Copiez le script startEsscmd.bat dans startEsscmdQ.bat.

  10. Modifiez le fichier startEsscmdQ.bat pour appeler esscmdq au lieu de esscmd : 

    "%ESSBASEPATH%\bin\esscmdq" %*

  11. Enregistrez le fichier. Exécutez-le en tant qu'administrateur et testez la connexion à Essbase 26ai Marketplace ou au déploiement indépendant.

    Syntaxe de connexion :

    login https://<servername_or_IP>/essbase/agent <user> <password>

Remarques :

  • N'utilisez pas d'ID utilisateur IDCS/MSAD pour vous connecter. Utilisez un utilisateur natif pour vous connecter.
  • Si vous utilisez un serveur proxy, vous devrez peut-être ajouter les paramètres suivants aux scripts startEssmcd/q.bat :
    • définir HTTP_PROXY=<serveur proxy> :<port>
    • définir HTTPS_PROXY=<serveur proxy> :<port>

Configuration côté serveur : pour la configurer directement sur le serveur Essbase

  1. Convertissez l'application en mode Unicode en mode "aggregate storage" copiée à l'aide de MaxL Shell, comme décrit ci-dessous.

  2. Modifiez la valeur ESSLANG dans l'outline source de l'encodage natif en UTF-8, comme décrit ci-dessous.

Convertissez l'application en mode Unicode copiée en mode "aggregate storage" à l'aide de MaxL Shell :

  1. Connectez-vous à l'instance Essbase 11g sur site source à l'aide de MaxL Shell.

  2. Exécutez l'instruction MaxL alter application <copied_app> set type unicode_mode pour convertir l'application en Unicode.

    Exemple : 
    MaxL> alter application SampleBck set type unicode_mode;
    Pour plus d'informations sur MaxL, reportez-vous à Modification d'application (stockage d'agrégation).

Remarques :

Toutes les opérations suivantes doivent être effectuées sur l'application copiée et non sur l'application source.
Modifiez la valeur ESSLANG dans l'outline source en remplaçant le codage natif par UTF-8.

  1. Télécharger ESSCMDQ

    1. Téléchargez la version "11.1.2.4.010+" spécifique à la plate-forme d'ESSCMDQ à partir de Télécharger ESSCMDQ vers votre instance EPM 11g source.
    2. Décompressez les fichiers directement dans le répertoire où ESSCMD est présent dans l'installation.

      Pour Linux

      $ESSBASEPATH/bin
      Exemple : 
      ./Middleware/EPMSystem11R1/products/Essbase/EssbaseServer/bin/ESSCMDQ

      Pour Windows

      %ESSBASEPATH%\bin
      Exemple : 
      .\Middleware\EPMSystem11R1\products\Essbase\EssbaseServer\bin\ESSCMDQ.exe

      Pour connaître les valeurs des variables d'environnement dans votre installation EPM 11g source, vérifiez le fichier d'environnement.

      Pour Linux :
      ./Middleware/user_projects/<epm_instance>/EssbaseServer/essbaseserver1/bin/setEssbaseEnv.sh
      Pour Windows: procédez comme suit :
      ./Middleware/user_projects/<epm_instance>/EssbaseServer/essbaseserver1/bin/setEssbaseEnv.bat

      Par défaut, <epm_instance> est epmsystem1.

    3. Créer une copie du script existant

      Pour Linux 

      ./Middleware/user_projects/epmsystem1/EssbaseServer/essbaseserver1/bin/startEsscmd.sh

      comme

      ./Middleware/user_projects/epmsystem1/EssbaseServer/essbaseserver1/bin/startEsscmdQ.sh

      Pour Windows 

      .\Middleware\user_projects\epmsystem1\EssbaseServer\essbaseserver1\bin\startEsscmd.bat

      comme

      .\Middleware\user_projects\epmsystem1\EssbaseServer\essbaseserver1\bin\startEsscmdQ.bat

      Dans ce script nouvellement créé, remplacez l'appel de ESSCMD par ESSCMDQ.

    4. Juste avant cette dernière ligne (juste avant l'appel à ESSCMDQ), ajoutez les lignes suivantes :

      Pour Linux 
      export ESSCMDQ_UTF8MODE=1
export ESSLANG=.UTF-8@Binary

      Pour Windows 

      set ESSCMDQ_UTF8MODE=1
set ESSLANG=.UTF-8@Binary

  2. Assurez-vous d'avoir arrêté l'application copiée avant de convertir l'outline.

  3. Maintenant, créez un dossier client sous ARBORPATH.

  4. Copiez le dossier d'application du répertoire ARBORPATH/app vers le répertoire client. Pour l'application ASOBck, par exemple :

    Pour Linux 

    $ARBORPATH/app/ASOBck as $ARBORPATH/client/ASOBck

    Pour Windows 

    %ARBORPATH%\app\ASOBck as %ARBORPATH%\client\ASOBck

  5. Exécutez les commandes suivantes dans ESSCMDQ après avoir lancé les opérations suivantes :

    Remarques :

    ESSCMDQ est interactif, de sorte que les paramètres de chaque commande peuvent être trouvés en mode interactif. Pour voir ce que signifie un paramètre, entrez la commande, telle qu'OpenOtl, puis appuyez sur Entrée pour voir le menu expliquant le paramètre. Vous pouvez également entrer la commande ESSCMDQ et appuyer sur Entrée, sans aucun paramètre, et le menu des paramètres s'affiche.

    Exemple Linux

    ./Middleware/user_projects/epmsystem1/EssbaseServer/essbaseserver1/bin/startEsscmdQ.sh
openotlex2 1 1 appName dbName outlineName Y Y Locale N 0

    writeotlex 0 1 1 appName dbName outlineName 2

    Exemple Windows

    .\Middleware\user_projects\epmsystem1\EssbaseServer\essbaseserver1\bin\startEsscmdQ.bat
openotlex2 1 1 appName dbName outlineName Y Y Locale N 0
    writeotlex 0 1 1 appName dbName outlineName 2

    Notez que Locale doit être la valeur ESSLANG native utilisée dans l'environnement Essbase 11g sur site source.

    Par exemple (syntaxe Linux)

    
mkdir $ARBORPATH/client
cp -r $ARBORPATH/app/ASOBck $ARBORPATH/client

./Middleware/user_projects/epmsystem1/EssbaseServer/essbaseserver1/bin/startEsscmdQ.sh
openotlex2 1 1 ASOBck Basic Basic Y Y "Japanese_Japan.MS932@Binary" N 0
writeotlex 0 1 1 ASOBck Basic Basic 2
exit

  6. Assurez-vous qu'aucune erreur n'est affichée lors de l'exécution des commandes ci-dessus. Ensuite, pour chaque cube, copiez uniquement le fichier d'outline du répertoire client vers le répertoire d'application.

    Par exemple (syntaxe Linux) :
    #Now copy back the converted outline only for each cube. For ASOBck app -
cp $ARBORPATH/client/ASOBck/Basic/Basic.otl $ARBORPATH/app/ASOBck/Basic/Basic.otl

#Note: The artifact files (.txt or .csc), which were created in native locale, may need to be converted to UTF-8 manually using third party tools which help in converting text encoding.

  7. Lancez à nouveau ESSCMDQ à l'aide de :

    Pour Linux 

    ./Middleware/user_projects/epmsystem1/EssbaseServer/essbaseserver1/bin/startEsscmdQ.sh

    Pour Windows 

    .\Middleware\user_projects\epmsystem1\EssbaseServer\essbaseserver1\bin\startEsscmdQ.bat

    et restructurer chaque cube.

    #Please replace hostname, username, password, appname and cubename with appropriate values
login 'hostname' 'username' 'password'
select appname cubename
openotl 2 1 appname cubename outlinename y y 0
writeotl 0 2 1 appname cubename outlinename
restructotl 1
closeotl 0
unlockobj 1 appname cubename outlinename
logout
exit

    Exemple :

    
login localhost:1423 user password
select ASOBck Basic
openotl 2 1 ASOBck Basic Basic y y 0
writeotl 0 2 1 ASOBck Basic Basic
restructotl 1
closeotl 0
unlockobj 1 ASOBck Basic Basic
logout
exit