Convertir aplicación de almacenamiento agregado no Unicode en modo Unicode

Antes de exportar una aplicación de almacenamiento agregado de Essbase 11g local como preparación para la migración a Essbase 26ai, conviértala en modo unicode.

Configuración del cliente: para configurar ESSCMD/ESSCMDQ en un cliente de Windows

Desde la interfaz web de Essbase 26ai, descargue el cliente de Essbase para Windows y el cliente MaxL.
Extraiga el cliente MaxL en un directorio MaxLClient.
Extraiga el cliente ESSCMD en un directorio EssbaseClient.
Copie el script startMAXL.bat del directorio MaxLClient en el directorio EssbaseClient. Cambie el nombre del script a startEsscmd.bat.
Edite el archivo startEsscmd.bat y agregue una nueva configuración para llamar a esscmd, en lugar de esscmd.sh:
```
"%ESSBASEPATH%\bin\esscmd" %*
```
Guarde el archivo. Ejecutarlo como administrador y probar el inicio de sesión en Essbase 26ai Marketplace o el despliegue independiente.

Sintaxis de inicio de sesión:
```
login https://<servername_or_IP>/essbase/agent <user> <password>
```
Después de confirmar que funciona, descargue ESSCMDQ para Windows desde https://www.oracle.com/middleware/technologies/esscmdq-sampleapps-downloads.html.
Extraiga ESSCMDQ.exe en el directorio EssbaseClient/bin.
Copie el script startEsscmd.bat en startEsscmdQ.bat.
Edite el archivo startEsscmdQ.bat para llamar a esscmdq en lugar de esscmd:
```
"%ESSBASEPATH%\bin\esscmdq" %*
```
Guarde el archivo. Ejecutarlo como administrador y probar el inicio de sesión en Essbase 26ai Marketplace o el despliegue independiente.

Sintaxis de inicio de sesión:
```
login https://<servername_or_IP>/essbase/agent <user> <password>
```

Note:

No utilice un ID de usuario de IDCS/MSAD para conectarse. Utilice un usuario 'nativo' para conectarse.
Si utiliza un servidor proxy, puede que necesite agregar la siguiente configuración a los scripts startEssmcd/q.bat:
- definir HTTP_PROXY=<proxyserver>:<port>
- definir HTTPS_PROXY=<proxyserver>:<port>

Configuración del servidor: para configurar directamente en el servidor de Essbase

Convierta la aplicación de almacenamiento agregado copiada al modo Unicode mediante shell MaxL, como se describe a continuación.
Cambie el valor de ESSLANG dentro del esquema de origen de la codificación nativa a UTF-8, como se describe a continuación.

Convierta la aplicación de almacenamiento agregado copiada al modo Unicode mediante el shell MaxL:

Inicie sesión en la instancia local de Essbase 11g de origen mediante shell MaxL.
Ejecute la sentencia MaxL alter application <copied_app> set type unicode_mode para convertir la aplicación en Unicode.
Por ejemplo:
```
MaxL> alter application SampleBck set type unicode_mode;
```
Para obtener más información sobre el MaxL, consulte Alter Application (Aggregate Storage).

Note:

Todas las operaciones siguientes se deben realizar en la aplicación copiada y no en la aplicación de origen.

Cambie el valor de ESSLANG dentro del esquema de origen de la codificación nativa a UTF-8.

Descargar ESSCMDQ
1. Descargue la versión "11.1.2.4.010+" específica de la plataforma de ESSCMDQ de Descargue ESSCMDQ en su instancia de EPM 11g de origen.
2. Descomprima los archivos directamente en el mismo directorio donde ESSCMD está presente en la instalación,
  Para Linux
  $ESSBASEPATH/bin
  Por ejemplo:
```
./Middleware/EPMSystem11R1/products/Essbase/EssbaseServer/bin/ESSCMDQ
```
  Para Windows
  %ESSBASEPATH%\bin
  Por ejemplo:
```
.\Middleware\EPMSystem11R1\products\Essbase\EssbaseServer\bin\ESSCMDQ.exe
```
  Para conocer los valores de las variables de entorno en la instalación de EPM 11g de origen, compruebe el archivo de entorno.
  Para Linux:
```
./Middleware/user_projects/<epm_instance>/EssbaseServer/essbaseserver1/bin/setEssbaseEnv.sh
```
  Para Windows:
```
./Middleware/user_projects/<epm_instance>/EssbaseServer/essbaseserver1/bin/setEssbaseEnv.bat
```
  Por defecto, <epm_instance> sería epmsystem1.
3. Hacer una copia del script existente
  
  Para Linux
```
./Middleware/user_projects/epmsystem1/EssbaseServer/essbaseserver1/bin/startEsscmd.sh
```
  como
```
./Middleware/user_projects/epmsystem1/EssbaseServer/essbaseserver1/bin/startEsscmdQ.sh
```
  Para Windows
```
.\Middleware\user_projects\epmsystem1\EssbaseServer\essbaseserver1\bin\startEsscmd.bat
```
  como
```
.\Middleware\user_projects\epmsystem1\EssbaseServer\essbaseserver1\bin\startEsscmdQ.bat
```
  En este script recién creado, cambie la llamada de ESSCMD a ESSCMDQ.
4. Justo antes de esta última línea (justo antes de la llamada a ESSCMDQ), agregue las siguientes líneas:
  Para Linux
```
export ESSCMDQ_UTF8MODE=1
export ESSLANG=.UTF-8@Binary
```
  Para Windows
```
set ESSCMDQ_UTF8MODE=1
set ESSLANG=.UTF-8@Binary
```
Asegúrese de que ha parado la aplicación copiada antes de convertir el esquema.
Ahora cree una carpeta client en ARBORPATH.
Copie la carpeta de la aplicación del directorio ARBORPATH/app en el directorio del cliente. Para la aplicación ASOBck, por ejemplo:

Para Linux
```
$ARBORPATH/app/ASOBck as $ARBORPATH/client/ASOBck
```
Para Windows
```
%ARBORPATH%\app\ASOBck as %ARBORPATH%\client\ASOBck
```

Ejecute los siguientes comandos en ESSCMDQ después de iniciar lo siguiente.

Note:

ESSCMDQ es interactivo, por lo que los parámetros para cada comando se pueden encontrar en modo interactivo. Para ver lo que significa un parámetro, introduzca el comando, como OpenOtl, y, a continuación, pulse Intro para ver el menú que explica el parámetro. O bien, introduzca el comando ESSCMDQ y pulse Intro, sin ningún parámetro, y se mostrará el menú de parámetros.

Ejemplo en 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

Ejemplo en 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

Tenga en cuenta que Locale debe ser el valor de ESSLANG nativo utilizado en el entorno local de origen de Essbase 11g.

Por ejemplo (sintaxis de 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

Asegúrese de que no se muestren errores al ejecutar los comandos anteriores. A continuación, para cada cubo, copie solo el archivo de esquema del directorio del cliente en el directorio de la aplicación.

Por ejemplo (sintaxis de 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.

Vuelva a iniciar ESSCMDQ mediante:

Para Linux

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

Para Windows

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

y reestructurar cada cubo.

#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

Por ejemplo:


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