Atualização para o Essbase 21.8 Requer Configuração ODBC Manual

A atualização para o Essbase 21.8 Requer Configuração ODBC Manual

A implantação do Essbase 21.8 inclui drivers ODBC do DataDirect atualizados (versão 8.0.2). Depois de aplicar o Essbase 21.8 OPatch a uma implantação independente do Essbase, você precisará atualizar manualmente sua configuração ODBC (aplica-se no Linux e no Windows).

Esse problema o afetará se você estiver atualizando para o Essbase 21.8 a partir de uma versão anterior e precisar carregar dados/dimensões de origem externa para o Essbase usando drivers ODBC (conforme descrito em Acessar Dados Usando Conectividade ODBC).

Observação:

Quando você aplica o Essbase 21.8 OPatch, as versões mais antigas do driver ODBC (por exemplo, 7.1.6 ou 5.3) são removidas. Não há suporte para elas no Essbase 21.8 e elas não funcionarão.

O Essbase 21.8 é fornecido apenas com estas versões do driver ODBC DataDirect, e somente estas são suportadas:

[ODBC Drivers]
Oracle 8.1 MongoDB
Oracle 8.0 Amazon Redshift Wire Protocol
Oracle 8.0 Apache Hive Wire Protocol
Oracle 8.0 Apache Spark SQL
Oracle 8.0 DB2 Wire Protocol
Oracle 8.0 Greenplum Wire Protocol
Oracle 8.0 Informix Wire Protocol
Oracle 8.0 MySQL Wire Protocol
Oracle 8.0 Oracle Wire Protocol
Oracle 8.0 PostgreSQL Wire Protocol
Oracle 8.0 SQL Server Wire Protocol
Oracle 8.0 Sybase IQ Wire Protocol

Depois de aplicar o Essbase 21.8 OPatch,

Você deve atualizar manualmente sua configuração ODBC (aplicável tanto no Linux quanto no Windows).
A Oracle recomenda fazer backup manualmente de suas configurações ODBC para os drivers 7.1.6 mais antigos, caso você precise fazer rollback para uma versão anterior do Essbase que use esses drivers.

Instruções do Linux

Antes de começar, anote o local das configurações de driver mais antigas do 7.1.6 no domínio do servidor do Essbase:

odbc.ini, localizado em

<Domain Root>/<Domain Name>/config/fmwconfig/essconfig/core

odbcinst.ini, localizado em

<Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/7.1.6/odbcinst.ini

Bibliotecas de driver ODBC, localizadas em
```
<Essbase Product Home>/modules/
```

Se o Essbase estiver em execução, interrompa os servidores, conforme descrito em Iniciar, Interromper e Verificar Servidores.
Faça uma cópia de backup das configurações mais antigas do driver 7.1.6: odbc.ini (obrigatório) e odbcinst.ini (obrigatório se você estiver usando drivers de terceiros, como o Teradata).
Observação:
Para evitar sobregravação acidental, certifique-se de que seus backups de configuração do driver 7.1.6 sejam salvos em algum lugar fora do
```
<Essbase Product Home>/modules/
```
Exemplos de:
```
cp <Domain_Home>/config/fmwconfig/essconfig/core/odbc.ini <Oracle_HOME>/odbc.ini_orig
```
```
cp <Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/7.1.6/odbcinst.ini <Oracle_HOME>/odbcinst.ini_orig
```
Aplique o OPatch Essbase 21.8 (conforme descrito em Patch e Rollback).
Abra o odbc.ini para edição.

Substitua os nomes de driver antigos pelos novos, fornecendo o caminho absoluto da biblioteca na entrada do nome do Driver. Por exemplo, (substitua Oracle_HOME pelo caminho Oracle_HOME do sistema):

Alteração

Driver=<Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/7.1.6/lib/ARsqls27.so

para

Driver=<Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/8.0.2/lib/ARsqls28.so

Alteração

Driver=<Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/7.1.6/lib/ARdb227.so

para

Driver=<Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/8.0.2/lib/ARdb228.so

Alteração

Driver=<Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/7.1.6/lib/ARmysql27.so

para

Driver=<Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/8.0.2/lib/ARmysql28.so

(Opcional) Substitua as descrições antigas do driver por novas.
- Altere Oracle 7.1 SQL Server Wire Protocol para Oracle 8.0 SQL Server Wire Protocol
- Altere Oracle 7.1 DB2 Wire Protocol Driver para Oracle 8.0 DB2 Wire Protocol Driver
- Altere Oracle 7.1 MySQL Wire Protocol para Oracle 8.0 MySQL Wire Protocol
Salve odbc.ini.
Edite o arquivo odbcinst.ini, <Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/8.0.2/odbcinst.ini.

Exemplo do DB2

(substitua Oracle_HOME pelo caminho Oracle_HOME do sistema):
```
Driver=<Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/8.0.2/Ardb228.so
```
Exemplo para Teradata

Copiando e colando suas entradas relacionadas ao Teradata no arquivo de backup, <Oracle_HOME>/odbcinst.ini_orig, adicione informações sobre o driver ODBC do Teradata para odbcinst.ini:
```
Teradata=Installed
[Teradata]
Driver=/opt/teradata/client/20.00/odbc_64/lib/tdataodbc_sb64.so
APILevel=CORE
ConnectFunctions=YYY
DriverODBCVer=3.51
SQLLevel=1
```
Salve odbcinst.ini.
Inicie o Essbase, conforme descrito em Iniciar, Interromper e Verificar Servidores.

Observação:

Se você precisar reverter o OPatch do Essbase 21.8, também precisará restaurar seu arquivo odbc.ini de backup (e odbcinst.ini, se estiver usando drivers de terceiros, como o Teradata). Exemplo:

cd <DOMAIN_HOME>/config/fmwconfig/essconfig/core
cp odbc.ini.orig odbc.ini

Instruções para Windows

No Windows, os DSNs do sistema configurados anteriormente – conforme descrito em Configurar a Origem de Dados ODBC (Windows) – não funcionarão após a aplicação do OPatch do Essbase 21.8. É necessário reconfigurar o DSN do sistema para utilizar os drivers 8.0.2.

Se o Essbase estiver em execução, interrompa os servidores, conforme descrito em Iniciar, Interromper e Verificar Servidores.
Aplique o OPatch Essbase 21.8 (conforme descrito em Patch e Rollback).
No servidor Windows do Essbase, abra o Editor do Registro do Windows (no menu Iniciar, execute regedit).
Navegue até Computer\HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI.
Clique com o botão direito do mouse em ODBC.INI e selecione Exportar. Salve-o como um backup, caso precise reverter o OPatch. Por exemplo, salve a configuração como odbc.orig.reg.
Navegue até Computer\HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBCINST.INI.
Clique com o botão direito do mouse em ODBCINST.INI e selecione Exportar. Salve-o como um backup, caso precise reverter o OPatch. Por exemplo, salve a configuração como odbcini.orig.reg.
Navegue até Computer\HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI\ODBC Data Sources.
Para a entrada denominada essbase_datasource, clique com o botão direito do mouse e selecione Modificar.

Alteração
- Oracle 7.1 SQL Server Wire Protocol
  
  para
  
  Oracle 8.0 SQL Server Wire Protocol
- Alteração
  
  Oracle 7.1 DB2 Wire Protocol Driver
  
  para
  
  Oracle 8.0 DB2 Wire Protocol Driver
- Alteração
  
  Oracle 7.1 MySQL Wire Protocol
  
  para
  
  Oracle 8.0 MySQL Wire Protocol
No Essbase Windows Server, navegue até <ESSBASE_PRODUCT_HOME>\modules\oracle.essbase.datadirect.odbc\8.0.2.
Faça uma cópia de backup de ODBC802.reg (por exemplo, ODBC802_orig.reg).
Edite ODBC802.reg, substituindo todas as ocorrências de $ODBC_PATH pelo caminho absoluto dos drivers ODBC – por exemplo, C:\\Oracle\\Middleware\\Oracle_Home\\essbase\\modules\\oracle.essbase.datadirect.odbc\\.
Clique duas vezes no arquivo ODBC802.reg editado. Isso editará o registro do Windows para que as entradas dos drivers DataDirect 8.0.2 sejam agrupadas com o Essbase 21.8.
Inicie o Essbase, conforme descrito em Iniciar, Interromper e Verificar Servidores.

Observação:

Se você precisar reverter o OPatch do Essbase 21.8, também precisará restaurar as entradas de registro do Windows ODBC.INI e ODBCINST.INI de backup. Por exemplo, exclua a entrada ODBC.INI do regedit e, em seguida, clique duas vezes em odbc.orig.reg para restaurar a entrada anterior. Como alternativa, você pode importar/mesclar as entradas do registro.