Instruções de Instalação do ODAC 12.2c Release 1

Conta na Nuvem Faça login na Nuvem Inscreva-se no Modo Gratuito na Nuvem

Conta da Oracle

Fale com um especialista

Configuração e Observações (12.2.0.1.0) julho de 2017

O download inclui os seguintes produtos:

a) Oracle Developer Tools for Visual Studio (12.2.0.1.0)

b) Oracle Data Provider para .NET 4 (12.2.0.1.0)

c) Oracle Data Provider para .NET 2 (12.2.0.1.0)

d) Oracle Providers para ASP.NET 4 (12.2.0.1.0)

e) Oracle Providers para ASP.NET 2 (12.2.0.1.0)

f) Oracle Data Provider para .NET Oracle TimesTen In-Memory Database (12.2.0.1.0)

g) Oracle Services para MTS (12.2.0.1.0)

h) Oracle Provider para OLE DB (12.2.0.1.0)

i) Oracle ODBC Driver (12.2.0.1.0)

j) Oracle SQL*Plus (12.2.0.1.0)

k) Oracle Call Interface (12.2.0.1.0)

l) Oracle C++ Call Interface (12.2.0.1.0)

m) Oracle Instant Client (12.2.0.1.0)

n) Oracle Universal Installer (12.2.0.1.0)

Requisitos do Sistema

Os seguintes itens são necessários para o ODAC:

Sistema operacional Windows x64
- Windows 10 (Edições Pro, Enterprise e Education), Windows 8.1 e Windows 8 (Edições Pro e Enterprise), Windows 7 (Edições Professional, Enterprise, Ultimate), Windows Server 2016 (Edições Standard, Datacenter e Essentials), Windows Server 2012 R2 e Windows Server 2012 (Edições Standard, Datacenter, Essentials e Foundation)
Acesso a um Servidor do Oracle Database (Oracle 10g Versão 2 ou posterior)

Observações Adicionais sobre os Requisitos:

ODP.NET requer Microsoft .NET Framework.
- ODP.NET, o Driver Gerenciado requer o .NET Framework 4 ou posterior até o .NET Framework 4.7
- ODP.NET, o Driver não Gerenciado requer o .NET Framework 3.5 SP 1 ou posterior até o .NET Framework 4.7
O Oracle Developer Tools for Visual Studio requer o Microsoft Visual Studio 2017 ou Visual Studio 2015

Observação: As edições do Visual Studio Express não são compatíveis com as Oracle Developer Tools. No entanto, o ODP.NET é compatível com o Visual Studio Express Edition.

Se você usar transações distribuídas com o ODP.NET, leia o Guia do ODP.NET Developer para obter mais informações sobre como configurar um aplicativo para usar transações distribuídas.

Instruções de Instalação

As instruções a seguir se aplicam à instalação do ODAC usando o Oracle Universal Installer. As instruções de instalação do Xcopy estão incluídas no download.

Faça o download do arquivo zip do ODAC em um diretório temporário. Observação: Não faça o download deste arquivo no diretório "Tmp".
Descompacte o conteúdo no diretório.
Execute o Oracle Universal Installer (OUI) iniciando o setup.exe descompactado no mesmo diretório. Você precisará de privilégios de administrador.
O OUI guiará você na instalação do ODAC em sua máquina. Após a instalação, você poderá excluir o arquivo zip e as pastas e arquivos descompactados.

Observação: Se outra versão beta do ODAC estiver instalada, desinstale-a antes de instalar esta versão do ODAC.

Instruções de Desinstalação

Ao desinstalar, use o tipo de instalação (por exemplo, Oracle Universal Installer, xcopy, NuGet e MSI) com o qual você instalou originalmente o Oracle Home. Você não deve desinstalar a partir de um Oracle Home criado por outro tipo de instalação. A Oracle recomenda altamente que as desinstalações sejam executadas com a mesma versão que instalou o ODAC e que o ODAC seja desinstalado primeiro antes de outros componentes Oracle instalados no Oracle Home.

As instruções a seguir se aplicam à desinstalação do ODAC usando o Oracle Universal Installer. As instruções de desinstalação do Xcopy estão incluídas no download.

Navegue até o Menu Iniciar do Windows e selecione "Universal Installer": (Todos os Programas --> Oracle - < Nome do Oracle Home > --> Produtos de Instalação da Oracle --> Universal Installer). Se o Controle de Conta de Usuário for solicitado, conceda o privilégio.
Clique no botão "Desinstalar Produtos".
Escolha os Oracle Home a serem desinstalados (por exemplo, Oracle Data Access Components para Oracle Client) no controle em árvore. Clique no botão "Remover". Se você estiver desinstalando outros componentes além do ODAC, desinstale primeiro o ODAC.
Confirme a desinstalação dos Oracle Home clicando no botão "Sim".

Para desinstalar o ODAC silenciosamente, execute o seguinte na linha de comando:

1.<Caminho do Oracle Home>\oui\bin\setup.exe -silent -deinstall DEINSTALL_LIST={"oracle.odac.client","12.2.0.1.0"} ORACLE_HOME=<Caminho do Oracle Home>

O comando acima desinstala e desconfigura os componentes ODAC. No entanto, essa abordagem de desinstalação do ODAC deixará alguns binários do Oracle Client e todos os arquivos gerados pelo usuário na Página Inicial da Oracle. Para remover completamente todos os arquivos e pastas da Página Inicial da Oracle, é possível executar o seguinte comando do Windows, além do primeiro comando:

2. rmdir <Caminho do Oracle Home>\ /s

Observação: Os arquivos do Oracle Home não poderão ser recuperados após terem sido excluídos. Faça backup de tudo que é importante no Oracle Home antes de executar o comando acima. Se você deseja executar esse mesmo comando silenciosamente, execute o seguinte:

3. rmdir <Caminho do Oracle Home>\ /s /q

Início Rápido de Configuração da Conexão

Configuração Automática

Ao instalar o ODAC em um novo Oracle Home, o OUI copia automaticamente os arquivos e configurações de parâmetros de nomes locais (tnsnames.ora), perfil (sqlnet.ora) e diretório (ldap.ora) de um Oracle Home já existente em um ODAC home recentemente instalado, desde que compartilhem o mesmo número de bits (por exemplo, ambas são instalações de 32 bits ou de 64 bits).

Como alternativa, os arquivos *.ora já existentes podem ser copiados de outro Oracle Home já existente, além do último ativo, para o novo Oracle Home do ODAC. O OUI fornece informações de localização para esses arquivos de até três outros Oracle Homes já existentes, se houver. Os arquivos *.ora poderão ser personalizados se o novo Oracle Home usar uma configuração diferente do Oracle Home anterior do qual os arquivos foram copiados.

Se estiver instalando em um Oracle Home do ODAC ou RDBMS já existente, nenhum arquivo *.ora novo será copiado ou criado.

Se estiver instalando em uma máquina sem Oracle Homes anteriores, o OUI solicitará ao usuário as informações de alias de conexão com o banco de dados. O OUI criará automaticamente o arquivo tnsnames.ora. Se nenhuma informação de alias for fornecida, nenhum arquivo tnsnames.ora será criado. Mesmo se o usuário não tiver todas as informações de conexão com o banco de dados prontamente disponíveis, a Oracle recomenda inserir os valores de espaço reservado durante o processo de instalação e modificar o arquivo tnsnames.ora posteriormente com valores reais para substituir os espaços reservados posteriormente.

Instale Alterações no Machine.config para o ODP.NET, Driver Gerenciado

Na instalação do ODP.NET, Driver Gerenciado, o OUI, copiará automaticamente as entradas TNS_ADMIN e LDAP_ADMIN no arquivo .NET maching.config se estiverem presentes nos Oracle Home preexistentes e a configuração ampla do computador estiver selecionada.

Configuração Manual

Dois dos métodos mais comuns para conectar um cliente Oracle a um banco de dados são EZCONNECT e TNSNAMES. O EZCONNECT é o mais fácil de configurar. O TNSNAMES tem uma manutenção mais fácil a longo prazo. Se você é novo na Oracle, recomendamos o uso do EZCONNECT. Você só precisa escolher um ou outro para se conectar.

Essas instruções de início rápido supõem que você tenha um nome de usuário e senha válidos para o servidor de banco de dados.

Observação: Nas instruções de configuração a seguir, ORACLE_HOME representa o diretório em que o Oracle Client Home foi instalado em sua máquina. Um diretório típico para um Oracle Client Home do OUI é:
C:\app\client\\product\12.1.0\client_1

Você precisará saber onde está esse diretório antes de continuar.

Configuração do EZCONNECT

1. Copie o arquivo sqlnet.ora localizado no seguinte diretório:
ORACLE_HOME\Network\Admin\Sample\
para este diretório:
ORACLE_HOME\Network\Admin\

Este arquivo informa ao cliente Oracle por quais métodos (por exemplo, EZCONNECT) é possível se conectar ao servidor do banco de dados da Oracle.

2. O cliente Oracle deve especificar nome de usuário, senha e fonte de dados válidos para se conectar ao servidor de banco de dados. Para especificar uma fonte de dados, você pode usar o formato EZCONNECT. No atributo da fonte de dados do ODP.NET, use o seguinte formato para definir como o cliente se conecta ao servidor de banco de dados:
[//]host[:port][/service_name]

host = o nome de host da máquina do servidor do banco de dados
port = a porta da máquina do servidor do banco de dados na qual escuta solicitações de conexão recebidas
service_name = o nome global do banco de dados

Por exemplo, veja a seguir algumas cadeias de conexão sintaticamente válidas:

"user id=hr;password=hr;data source=//sales-server:1521/sales.us.acme.com"

"user id=hr;password=hr;data source=//sales-server/sales.us.acme.com"

"user id=hr;password=hr;data source=sales-server/sales.us.acme.com"

Se o número da porta não for especificado, 1521 será usado por padrão.

Configuração de TNSNAMES

O nome de serviço do Oracle Net permite que o cliente Oracle use um alias simples para se conectar ao servidor de banco de dados. A definição de alias contém todas as informações necessárias para criar uma conexão com o servidor de banco de dados. As informações de alias são armazenadas no arquivo tnsnames.ora geralmente localizado no diretório ORACLE_HOME\Network\ Admin. Esse alias é usado como o valor da fonte de dados na sua cadeia de conexão. As instalações do ODAC não criam um arquivo tnsnames.ora; portanto, você precisa criar um. As instruções a seguir assumem que você precisará criar um novo arquivo tnsnames.ora.

1. Copie o arquivo tnsnames.ora localizado no seguinte diretório:
ORACLE_HOME\Network\Admin\Sample\
para este diretório:
ORACLE_HOME\Network\Admin\

Cópia



<data source alias> = 
          (DESCRIPTION = 
          (ADDRESS = (PROTOCOL = TCP)(HOST = <hostname or IP>)(PORT = <port>)) 
          (CONNECT_DATA = 
          (SERVER = DEDICATED) 
          (SERVICE_NAME = <database service name>)))

data source alias = o nome do atalho fornecido para identificar o descritor da conexão. Na cadeia de conexão do ODP.NET, os desenvolvedores definem o atributo "Data Source" para o alias da fonte de dados.
hostname ou IP = o nome do host da máquina do servidor de banco de dados ou endereço IP
port = a porta da máquina do servidor do banco de dados na qual escuta solicitações de conexão recebidas. Em geral, esse valor é definido como porta "1521".
database service name = o nome global do banco de dados

O alias da fonte de dados, o nome do host/IP, a porta e o nome do serviço de banco de dados no tnsnames.ora devem ser modificados adequadamente. Se as entradas de TNS no arquivo ORACLE_HOME\network\admin\tnsnames.ora não forem reconhecidas pelo cliente Oracle, crie um arquivo ORACLE_HOME\oracle.key usando qualquer editor de texto e digite a seguinte linha:
SOFTWARE\ORACLE\< home key >

onde < home key > é a chave de registro para o Oracle Home do ODAC. Por exemplo, se o local padrão do Oracle Home fosse usado durante a instalação, a entrada apropriada para o arquivo oracle.key seria a seguinte: SOFTWARE\ORACLE\KEY_OraClient12c_home1

Configuração Ampla do Computador

O ODAC oferece a opção de instalação do ODP.NET gerenciado e não gerenciado na configuração ampla do computador ou não ampla. A configuração ampla do computador inclui colocar o conjunto do provedor no GAC e atualizar o machine.config com o manipulador de seção de configuração e as informações do DbProviderFactory. Se a configuração não ampla do computador for selecionada, nenhuma dessas alterações será feita. Por padrão, a instalação do ODAC usa a configuração não ampla do computador para uma nova instalação e reinstalações do Oracle Home.

Se você planeja instalar o ODAC e a instalação do NuGet para ODP.NET 12.2.0.1 na mesma máquina, o ODP.NET deverá ser a configuração não ampla do computador. Além disso, verifique se não há outras versões do ODP.NET 12.2.0.1 instaladas na configuração ampla do computador.

Os usuários podem reconfigurar o ODP.NET de configuração ampla do computador para não ampla reinstalando o ODP.NET no mesmo Oracle Home em que o ODP.NET da mesma versão já está instalado. Por exemplo, se você já tiver a configuração ampla do computador do ODP.NET, poderá reconfigurá-lo reinstalando o ODP.NET no mesmo Oracle Home E selecionando a opção de configuração não ampla.

Para aplicativos que dependem de uma versão do ODP.NET que não foi uma configuração ampla, é importante observar que A) será necessário copiar o(s) assembly/assemblies do ODP.NET dos quais o aplicativo depende no diretório do aplicativo e B) serão necessárias configurações corretas do .NET config para usar a configuração do Provider Factory e/ou especifica do Provedor. Consulte o Capítulo 2 do Guia do Desenvolvedor ODP.NET para obter mais detalhes.

Problemas Comuns de Instalação e Configuração

O ODAC não oferece suporte à instalação em um Oracle Server Home. O ODAC pode ser instalado em um Oracle Client home já existente se eles compartilharem as duas primeiras versões principais do 12.x e anteriores (por exemplo, o ODAC 12.2 não pode ser instalado em um ODAC 12. home) ou se eles compartilharem a versão principal do Oracle 18 e posterior (ou seja, o Oracle 18 não pode ser instalado em um Oracle 19 home). Ao instalar em um Oracle Client Home já existente, a mesma tecnologia do instalador deverá ser usada. O OUI ODAC pode ser instalado somente em um OUI ODAC home; o MSI ODAC em um MSI ODAC home e xcopy ODAC em xcopy ODAC home.

Verifique se o oci.dll no diretório ORACLE_HOME já existente foi removido durante o processo de desinstalação. Se o oci.dll não foi removido, siga estas etapas para remover a DLL.

Consulte primeiro as notas de versão para quaisquer limitações ou problemas conhecidos.
Verifique se os componentes de acesso a dados da Oracle foram baixados corretamente, comparando o tamanho do download com o listado na página de download.
Se você tiver mais de um Oracle Home instalado na mesma máquina (por exemplo, o Oracle 12c Release 1 cliente e Oracle 12c Release 2 cliente), ao instalar o Oracle 12.2 cliente, o OUI estabelecerá esse cliente como o Oracle Home que todos os seus aplicativos já existentes usarão. Para obter mais informações sobre o uso de vários Oracle Homes com ODP.NET, Driver não Gerenciado, consulte a documentação do ODP.NET.
É altamente recomendável que o ODAC seja instalado em um novo Oracle Home. A instalação do ODAC sobre um Oracle Home já existente pode interromper os aplicativos Oracle. Se você instalar em um Oracle Home já existente, certifique-se de interromper todos os serviços do Windows usando esse Oracle Home (por exemplo, OracleMTSRecoveryService) e de que seja um Oracle Client Home.

a) Renomeie oci.dll para oci.dll.delete.
b) Reinicie sua máquina.
c) Exclua oci.dll.delete, que não deve mais ser usado após a reinicialização.
d) Instale o novo ODAC.
Se você instalar o ODAC em um Oracle 12.2c Home já existente, os componentes ODAC já instalados não serão instalados por padrão. Você deve selecionar manualmente os componentes ODAC a serem instalados durante o processo de instalação (por exemplo, marque a caixa de seleção ao lado dos componentes ODAC a serem instalados). Isso é recomendado para todos os componentes ODAC que você deseja usar, especialmente ODP.NET.
Esta instalação fornece arquivos de configuração de política que podem redirecionar aplicativos ODP.NET 10.2 e 11.1 já existentes para a versão atual do ODP.NET. Os arquivos de políticas estão localizados nos diretórios ORACLE_HOME\odp.net\PublisherPolicy\2.x and ORACLE_HOME\odp.net\PublisherPolicy\4. A instalação do ODP.NET NÃO colocará DLLs de política do ODP.NET no GAC, o que significa que os aplicativos já existentes continuarão usando a mesma versão do ODP.NET que estavam usando antes.
Instalar o ODP.NET em um novo Oracle Home significa que você pode não ter acesso a nenhum dos aliases do Oracle Data Source de uma instalação anterior. Para garantir que você esteja usando esses atributos de fonte de dados já existentes, copie o arquivo tnsnames.ora no diretório ORACLE_HOME\network\admin da instalação anterior do Oracle Home para o mesmo diretório em sua nova instalação. Ou você pode criar os aliases de conexão manualmente, seguindo o Início Rápido de Configuração de Conexão anterior.
O Oracle Database é compatível com o do Oracle Home User, especificado no momento da instalação do Oracle Database. O Oracle Home User é usado para executar os serviços do Windows no Oracle Home. O Oracle Home User pode ser uma conta virtual, uma Conta de Usuário Padrão do Windows (não uma conta de Administrador) ou uma conta interna do Windows. Para saber mais sobre o Oracle Home User, consulte o Guia da Plataforma do Oracle Database para Microsoft Windows.
Se as Ferramentas do Oracle Developer (ODT) para Visual Studio 12.1.0.2.0 (parte do ODAC 12c Release 3) ou posterior estiverem instaladas em uma máquina e a máquina deverá ser rebaixada para ODT 12.1.0.1.2 (parte do ODAC 12c Release 2) ou anterior, a versão mais recente de ODT deverá ser desinstalada antes de instalar a versão mais antiga de ODT. Caso isso não seja feito, determinados recursos ODT, como a Depuração PL/SQL serão impedidos de funcionar.
A desinstalação de ODP.NET anterior ao ODAC 12c Release 3 pode fazer com que entradas com referências de assembly do .NET 2.x sejam inseridas no machine.config do .NET 4.0. Isso pode causar erros de execução lado a lado, a menos que a entrada da seção de configuração para "oracle.unmanageddataaccess.client" que faz referência à versão 2.x do Oracle.DataAccess.Client seja removida manualmente do machine.config do .NET 4.0. Também é recomendável que uma entrada DbProviderFactories que faça referência à versão 2.x do Oracle.DataAccess.Client seja removida manualmente.

Visualização de Documentação do ODP.NET

A documentação em PDF e HTML pode ser visualizada na página ORACLE_HOME\ODACDoc\DocumentationLibrary\welcome.html. Para visualizar esta página, vá ao Menu Iniciar --> Oracle - < Oracle Home > --> Application Development --> Oracle Data Access Components Documentation.

Além disso, a documentação da Oracle é instalada como parte da Ajuda do Visual Studio Dynamic.

Suporte e Relatórios de Erros

Para quaisquer erros e problemas, você pode participar de um dos fóruns de discussão de OTN para ODAC.