Nicht-Unicode-Aggregatspeicheranwendung in Unicode-Modus konvertieren

Bevor Sie eine Aggregate Storage-Anwendung aus Essbase 11g On-Premise exportieren, um die Migration in Essbase 26ai vorzubereiten, konvertieren Sie sie in den Unicode-Modus.

Clientseitige Konfiguration - So richten Sie ESSCMD/ESSCMDQ auf einem Windows-Client ein

Laden Sie über die Essbase 26ai-Weboberfläche den Essbase-Client für Windows und den MaxL-Client herunter.
Extrahieren Sie den MaxL-Client in ein MaxLClient-Verzeichnis.
Extrahieren Sie den ESSCMD-Client in ein Verzeichnis EssbaseClient.
Kopieren Sie das Skript startMAXL.bat aus dem Verzeichnis MaxLClient in das Verzeichnis EssbaseClient. Benennen Sie das Skript in startEsscmd.bat um.
Bearbeiten Sie die Datei startEsscmd.bat, und fügen Sie eine neue Einstellung hinzu, um esscmd anstelle von esscmd.sh aufzurufen:
```
"%ESSBASEPATH%\bin\esscmd" %*
```
Speichern Sie die Datei. Führen Sie sie als Administrator aus, und testen Sie die Anmeldung bei Essbase 26ai Marketplace oder einem unabhängigen Deployment.

Anmeldesyntax:
```
login https://<servername_or_IP>/essbase/agent <user> <password>
```
Nachdem Sie bestätigt haben, dass es funktioniert, laden Sie ESSCMDQ für Windows von https://www.oracle.com/middleware/technologies/esscmdq-sampleapps-downloads.html herunter.
Extrahieren Sie ESSCMDQ.exe in das Verzeichnis EssbaseClient/bin.
Kopieren Sie das Skript startEsscmd.bat in startEsscmdQ.bat.
Bearbeiten Sie die Datei startEsscmdQ.bat so, dass sie esscmdq statt esscmd aufruft:
```
"%ESSBASEPATH%\bin\esscmdq" %*
```
Speichern Sie die Datei. Führen Sie sie als Administrator aus, und testen Sie die Anmeldung bei Essbase 26ai Marketplace oder einem unabhängigen Deployment.

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

Hinweis:

Verwenden Sie keine IDCS/MSAD-Benutzer-ID für die Verbindung. Verwenden Sie einen "nativen" Benutzer zur Anmeldung.
Wenn Sie einen Proxy-Server verwenden, müssen Sie möglicherweise die folgenden Einstellungen zu den startEssmcd/q.bat-Skripten hinzufügen:
- HTTP_PROXY=<proxyserver> festlegen:<port>
- HTTPS_PROXY=<proxyserver> festlegen:<port>

Serverseitige Konfiguration - Direkte Einrichtung auf dem Essbase-Server

Konvertieren Sie die kopierte Aggregate Storage-Anwendung mit MaxL Shell in den Unicode-Modus, wie unten beschrieben.
Ändern Sie den ESSLANG-Wert in der Quell-Outline von der nativen Codierung in UTF-8, wie unten beschrieben.

Konvertieren Sie die kopierte Aggregate Storage-Anwendung mit MaxL Shell in den Unicode-Modus:

Melden Sie sich mit MaxL Shell bei der Essbase 11g On-Premise-Quellinstanz an.
Führen Sie die MaxL-Anweisung alter application <copied_app> set type unicode_mode aus, um die Anwendung in Unicode zu konvertieren.
Beispiel:
```
MaxL> alter application SampleBck set type unicode_mode;
```
Weitere Informationen zur MaxL finden Sie unter Alter-Anwendung (Aggregatspeicher).

Hinweis:

Alle der folgenden Vorgänge müssen für die kopierte Anwendung und nicht für die Quellanwendung ausgeführt werden.

Ändern Sie den ESSLANG-Wert in der Quell-Outline von der nativen Codierung in UTF-8.

ESSCMDQ herunterladen

Laden Sie die plattformspezifische Version "11.1.2.4.010+" von ESSCMDQ von ESSCMDQ herunterladen in Ihre EPM 11g-Quellinstanz herunter.
Dekomprimieren Sie die Dateien direkt in das Verzeichnis, in dem ESSCMD in der Installation vorhanden ist.
Linux
$ESSBASEPATH/bin
Beispiel:
```
./Middleware/EPMSystem11R1/products/Essbase/EssbaseServer/bin/ESSCMDQ
```
Unter Windows
%ESSBASEPATH%\bin
Beispiel:
```
.\Middleware\EPMSystem11R1\products\Essbase\EssbaseServer\bin\ESSCMDQ.exe
```
Um die Werte der Umgebungsvariablen in der EPM 11g-Quellinstallation zu ermitteln, prüfen Sie die Umgebungsdatei.
Linux:
```
./Middleware/user_projects/<epm_instance>/EssbaseServer/essbaseserver1/bin/setEssbaseEnv.sh
```
Unter Windows:
```
./Middleware/user_projects/<epm_instance>/EssbaseServer/essbaseserver1/bin/setEssbaseEnv.bat
```
Standardmäßig ist <epm_instance> epmsystem1.

Kopie des vorhandenen Skripts erstellen

Linux

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

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

Unter Windows

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

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

Ändern Sie in diesem neu erstellten Skript den Aufruf von ESSCMD in ESSCMDQ.

Fügen Sie kurz vor dieser letzten Zeile (gerade vor dem Aufruf von ESSCMDQ) folgende Zeilen hinzu:
Linux
```
export ESSCMDQ_UTF8MODE=1
export ESSLANG=.UTF-8@Binary
```
Unter Windows
```
set ESSCMDQ_UTF8MODE=1
set ESSLANG=.UTF-8@Binary
```

Stellen Sie sicher, dass Sie die kopierte Anwendung gestoppt haben, bevor Sie die Modellstruktur konvertieren.
Erstellen Sie nun unter ARBORPATH einen Ordner client.
Kopieren Sie den Anwendungsordner aus dem Verzeichnis ARBORPATH/app in das Clientverzeichnis. Für die ASOBck-App zum Beispiel:

Linux
```
$ARBORPATH/app/ASOBck as $ARBORPATH/client/ASOBck
```
Unter Windows
```
%ARBORPATH%\app\ASOBck as %ARBORPATH%\client\ASOBck
```
Führen Sie die folgenden Befehle in ESSCMDQ aus, nachdem Sie Folgendes gestartet haben.

Hinweis:
ESSCMDQ ist interaktiv, sodass Parameter für jeden Befehl im interaktiven Modus gefunden werden können. Um zu sehen, was ein Parameter bedeutet, geben Sie den Befehl ein, z. B. OpenOtl, und drücken Sie die Eingabetaste, um das Menü mit der Erläuterung des Parameters anzuzeigen. Oder geben Sie den Befehl ESSCMDQ ein und drücken Sie die Eingabetaste, ohne Parameter, und das Parametermenü wird angezeigt.

Linux-Beispiel
```
./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
```
Windows-Beispiel
```
.\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
```
Beachten Sie, dass Locale der native ESSLANG-Wert sein muss, der in der Essbase 11g On-Premise-Quellumgebung verwendet wird.

Beispiel (Linux-Syntax)
```
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
```

Stellen Sie sicher, dass beim Ausführen der oben genannten Befehle keine Fehler angezeigt werden. Kopieren Sie dann für jeden Cube nur die Outline-Datei aus dem Clientverzeichnis zurück in das Anwendungsverzeichnis.

Beispiel (Linux-Syntax):

#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.

Starten Sie ESSCMDQ erneut mit:

Linux

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

Unter Windows

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

und jeden Cube neu strukturieren.

#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

Beispiel:


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