Instrucciones de instalación de ODAC 12.2c Release 1

Cuenta de Cloud Iniciar sesión en Cloud Registrarse para el Modo Gratuito de Cloud

Cuenta de Oracle

Comunícate con un especialista

Menú

Configuración y notas (12.2.0.1.0) de julio de 2017

La descarga incluye los siguientes productos:

a) Oracle Developer Tools for Visual Studio (12.2.0.1.0)

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

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

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

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

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

g) Servicios de Oracle para MTS (12.2.0.1.0)

h) Oracle Provider for 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 del sistema

Los siguientes elementos son necesarios para ODAC:

Sistema operativo Windows x64
- Windows 10 (ediciones Pro, Enterprise y Education), Windows 8.1 y Windows 8 (ediciones Pro y Enterprise), Windows 7 (ediciones Professional, Enterprise, Ultimate), Windows Server 2016 (ediciones Standard, Datacenter y Essentials), Windows Server 2012 R2 y Windows Server 2012 (ediciones Standard, Datacenter, Essentials y Foundation)
Acceso a un servidor de Oracle Database (Oracle 10g versión 2 o posterior)

Notas adicionales sobre los requisitos:

ODP.NET necesita Microsoft . Marco NET.
- ODP.NET (controlador administrado) requiere .NET Framework 4 o posterior hasta .NET Framework 4.7
- ODP.NET (controlador no administrado) requiere .NET Framework 3.5 SP 1 o posterior hasta .NET Framework 4.7
Oracle Developer Tools for Visual Studio requiere Microsoft Visual Studio 2017 o Visual Studio 2015

Nota: Las ediciones de Visual Studio Express no están soportadas con las herramientas de Oracle Developer. Sin embargo, ODP.NET es compatible con Visual Studio Express Edition.

Si usa transacciones distribuidas con ODP.NET, lea la guía para desarrolladores de ODP.NET, donde podrá obtener más información sobre cómo configurar una aplicación para usar transacciones distribuidas.

Instrucciones de instalación

Las instrucciones siguientes se aplican a la instalación de ODAC mediante Oracle Universal Installer. Las instrucciones de instalación de Xcopy se incluyen en la descarga.

Descargue el archivo zip de ODAC en un directorio temporal. Nota: No descargue este archivo en el directorio "Tmp".
Descomprima el contenido del archivo en el directorio.
Ejecute Oracle Universal Installer (OUI) iniciando el archivo setup.exe que se descomprimió en el mismo directorio. Necesitará privilegios de administrador.
OUI le dirigirá durante la instalación de ODAC en su equipo. Tras la instalación, puede eliminar el archivo zip y las carpetas y archivos descomprimidos.

Nota: Si hay instalado otro ODAC beta, desinstálelo antes de instalar esta versión de ODAC.

Instrucciones de desinstalación

Al desinstalar, use el tipo de instalación (es decir, Oracle Universal Installer, xcopy, NuGet y MSI) con el que instaló originalmente Oracle Home. No debe desinstalar desde una instancia de Oracle Home creada por otro tipo de instalación. Oracle recomienda encarecidamente que las desinstalaciones se ejecuten con la misma versión que instaló ODAC y que ODAC se desinstale antes que otros componentes Oracle instalados en Oracle Home.

Las instrucciones siguientes se aplican a la desinstalación de ODAC mediante Oracle Universal Installer. Las instrucciones de desinstalación de Xcopy se incluyen en la descarga.

Vaya al menú de inicio de Windows y seleccione "Universal Installer": (Todos los programas --> Oracle - < Nombre del directorio raíz de Oracle > --> Productos de instalación de Oracle --> Universal Installer). Si se solicita Control de cuentas de usuario, otorgue el privilegio.
Haz clic en el botón "Deinstall Products" (Desinstalar productos).
Elija las instancias de Oracle Home que desea desinstalar (es decir, Oracle Data Access Components for Oracle Client) desde el control de árbol. Haz clic en el botón "Remove" (Quitar). Si va a desinstalar otros componentes además de ODAC, asegúrese de desinstalar ODAC primero.
Confirme la desinstalación de las instancias de Oracle Homes. Para ello, haga clic en el botón "Yes" (Sí).

Para desinstalar ODAC sin interacción, ejecute lo siguiente en la línea de comando:

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

El comando anterior desinstala y desconfigura los componentes de ODAC. Sin embargo, este enfoque de desinstalación de ODAC dejará algunos binarios de Oracle Client y los archivos generados por el usuario en la instancia de Oracle Home. Para eliminar completamente todos los archivos y carpetas de Oracle Home, puede ejecutar el siguiente comando de Windows, además del primer comando:

2. rmdir <Ruta de Oracle Home>\\ /s

Nota: Los archivos del directorio raíz de Oracle no se podrán recuperar una vez suprimidos. Antes de ejecutar el comando anterior, haga una copia de seguridad de todo lo que sea importante en Oracle Home. Si prefiere que el comando se ejecute sin interacción, puede lanzarlo así:

3. rmdir <Ruta de Oracle Home>\ /s /q

Inicio rápido de la configuración de conexión

Configuración automática

Al instalar ODAC en una nueva instancia de Oracle Home, OUI copia automáticamente los archivos de parámetros y la configuración de la nomenclatura local de Oracle (tnsnames.ora), el perfil (sqlnet.ora) y el directorio (ldap.ora) desde una instancia existente de Oracle Home a la instancia de Oracle Home de ODAC recién instalada, siempre que sean del mismo número de bits (es decir, las dos instalaciones deben ser de 32 bits, o bien las dos deben ser de 64 bits).

Como alternativa, se pueden copiar los archivos *.ora de otra instancia de Oracle Home existente, aparte del último activo, a la nueva instancia de Oracle Home de ODAC. OUI proporciona información de ubicación para estos archivos de hasta tres instancias de Oracle Homes adicionales (si las hubiera). Los archivos *.ora se pueden personalizar si la nueva instancia de Oracle Home utiliza una configuración diferente de la instancia de Oracle Home anterior, desde la que se copiaron los archivos.

Si se instala en una instancia existente de Oracle Home de ODAC o RDBMS, no se copiarán ni se crearán nuevos archivos *.ora.

Si se instala en un equipo sin ninguna instancia de Oracle Home previa, OUI le pedirá al usuario la información del alias de conexión de la base de datos. OUI creará automáticamente el archivo tnsnames.ora. Si no se proporciona ninguna información de alias, no se creará el archivo tnsnames.ora. Incluso si el usuario no tiene toda la información de conexión de base de datos disponible, Oracle recomienda insertar valores de marcador de posición durante el proceso de instalación y después modificar el archivo tnsnames.ora con valores reales en lugar de los marcadores de posición.

Instalar cambios en Machine.config para ODP.NET (controlador administrado)

Si se instala ODP.NET (controlador administrado), OUI copia automáticamente las entradas TNS_ADMIN y LDAP_ADMIN en el archivo machine.config de .NET si está presente en instancias de Oracle Home preexistentes y se selecciona la configuración de todo el equipo.

Configuración manual

Dos de los métodos más comunes de conectar un cliente de Oracle a una base de datos son EZCONNECT y TNSNAMES. EZCONNECT es el más fácil de configurar. TNSNAMES es mucho más fácil de mantener a largo plazo. Si está empezando con Oracle, le recomendamos que use EZCONNECT. Solo tiene que elegir uno u otro para conectarse.

En estas instrucciones de inicio rápido se supone que tiene un nombre de usuario y una contraseña válidos para el servidor de base de datos.

Nota: En las siguientes instrucciones de configuración, ORACLE_HOME representa el directorio en el que se ha instalado el directorio raíz del cliente de Oracle en la máquina. Un directorio típico para un directorio raíz de cliente de Oracle de OUI es:
C:\app\client\\product\12.1.0\client_1

Tiene que saber dónde está este directorio antes de continuar.

Configuración de EZCONNECT

1. Copie el archivo sqlnet.ora ubicado en el siguiente directorio:
ORACLE_HOME\Network\Admin\Sample\
en este directorio:
ORACLE_HOME\Network\Admin\

Este archivo le dice al cliente de Oracle con qué métodos (por ejemplo, EZCONNECT) el cliente de Oracle puede conectarse al servidor de base de datos Oracle.

2. El cliente de Oracle debe especificar un nombre de usuario, una contraseña y una fuente de datos válidos para conectarse al servidor de base de datos. Puede usar el formato EZCONNECT para especificar una fuente de datos. En el atributo de origen de datos ODP.NET, utilice el siguiente formato para definir cómo se conecta el cliente al servidor de base de datos:
[//]host[:port][/service_name]

host = el nombre de host del equipo del servidor de base de datos
port = el puerto del equipo del servidor de base de datos en el que se escuchan las solicitudes de conexión entrantes
service_name = el nombre global de la base de datos

Por ejemplo, estas son algunas cadenas de conexión con una sintaxis válida:

"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"

Si no se especifica el número de puerto, se usa 1521 de manera predeterminada.

Configuración de TNSNAMES

Un nombre de servicio de red de Oracle permite que el cliente de Oracle use un alias sencillo para conectarse al servidor de base de datos. La definición del alias contiene toda la información necesaria para crear una conexión con el servidor de base de datos. La información de alias se almacena en el archivo tnsnames.ora que normalmente se encuentra en el directorio ORACLE_HOME\Network\Admin. Este alias se usa como el valor de la fuente de datos en la cadena de conexión. Las instalaciones de ODAC no crean un archivo tnsnames.ora, por lo que debe crear uno. En las siguientes instrucciones se supone que tiene que crear un nuevo archivo tnsnames.ora.

1. Copie el archivo tnsnames.ora ubicado en el siguiente directorio:
ORACLE_HOME\Network\Admin\Sample\
en este directorio:
ORACLE_HOME\Network\Admin\

Copiar



<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 = el nombre de acceso directo que identifica el descriptor de conexión. En la cadena de conexión de ODP.NET, los desarrolladores establecen como valor del atributo "Data Source" (fuente de datos) el alias de la fuente de datos.
hostname or IP = el nombre de host o la dirección IP del equipo del servidor de base de datos
port = el puerto del equipo del servidor de base de datos en el que se escuchan las solicitudes de conexión entrantes. En general, este valor se establece en el puerto "1521".
database service name = el nombre global de la base de datos

Hay que modificar según corresponda el alias de la fuente de datos, el nombre de host y la dirección IP, el puerto y el nombre del servicio de base de datos en tnsnames.ora. Si el cliente de Oracle no reconoce las entradas de TNS del archivo ORACLE_HOME\network\admin\tnsnames.ora, cree un archivo ORACLE_HOME\oracle.key con cualquier editor de texto y escriba la siguiente línea:
SOFTWARE\ORACLE\< clave de inicio >

donde < clave de inicio > es la clave del registro para ODAC Oracle Home. Por ejemplo, si se ha utilizado la ubicación del directorio raíz de Oracle por defecto durante la instalación, la entrada adecuada para el archivo oracle.key sería la siguiente: SOFTWARE\ORACLE\KEY_OraClient12c_home1

Configuración de todo el equipo

ODAC ofrece la opción de instalar en una configuración de todo el equipo o en una configuración que no abarque todo el equipo para ODP.NET administrado y no administrado. La configuración de todo el equipo incluye colocar el ensamblado de proveedor en la caché global de ensamblados (GAC) y actualizar machine.config con el controlador de la sección de configuración e información de DbProviderFactory. Si se selecciona la configuración que no abarca todo el equipo, no se realiza ninguno de estos cambios. De forma predeterminada, la instalación de ODAC utiliza una configuración que no abarca todo el equipo para una nueva instalación de Oracle Home y reinstala.

Si planea instalar ODAC y la instalación de NuGet para ODP.NET 12.2.0.1 en el mismo equipo, debe configurar ODP.NET con una configuración que no abarque todo el equipo. También debe asegurarse de que no haya otras versiones de ODP.NET 12.2.0.1 versiones instaladas en todo el equipo.

Los usuarios pueden reconfigurar ODP.NET desde la configuración de todo el equipo a una configuración que no abarca todo el equipo reinstalando ODP.NET en la misma instancia de Oracle Home en la que ya está instalado ODP.NET de la misma versión. Por ejemplo, si ya ha configurado ODP.NET en todo el equipo, puede reconfigurarlo reinstalando ODP.NET en la misma instancia de Oracle Home y seleccionando la opción de configuración que abarca todo el equipo.

Para aplicaciones que dependen de una versión de ODP.NET no configurada en todo el equipo, es importante tener en cuenta que A) El ensamblado o ensamblados de ODP.NET de los que depende la aplicación deberán copiarse en el directorio de la aplicación, y B) se requerirá la configuración adecuada de .NET para usar Provider Factory o la configuración específica de proveedor. Consulte el Capítulo 2 de la Guía para desarrolladores de ODP.NET para obtener más información.

Problemas comunes de instalación y configuración

ODAC no admite la instalación en una instancia de Oracle Server Home existente. ODAC se puede instalar en una instancia de Oracle Client Home existente si comparten las dos primeras versiones principales para las versiones 12.x y anteriores (es decir, ODAC 12.2 no se puede instalar en una instancia de Home de ODAC 12.1) o si comparten la versión principal para Oracle 18 y posteriores (es decir, Oracle 18 no se puede instalar en una instancia de Home de Oracle 19). Al instalar en una instancia de Oracle Client Home existente se debe utilizar la misma tecnología de instalación. OUI ODAC solo se puede instalar en una instancia de Home de OUI ODAC; MSI ODAC en una instancia de Home de MSI ODAC; y xcopy ODAC en una instancia de Home de xcopy ODAC.

Compruebe si, durante el proceso de desinstalación, se ha eliminado oci.dll del directorio ORACLE_HOME existente. Si no se ha eliminado oci.dll, siga estos pasos para eliminar la DLL.

Consulte primero las notas de la versión para ver cuáles son los problemas o las limitaciones que ya se conocen.
Compruebe si se descargaron correctamente los componentes de acceso a datos de Oracle comparando el tamaño de la descarga con el que figura en la página de descarga.
Si tiene más de una instancia de Oracle Home instaladas en el mismo equipo (p.ej., el cliente Oracle 12c Release 1 o el cliente Oracle 12c Release 2), al instalar el cliente de Oracle 12.2, OUI establecerá este cliente como la instancia de Oracle Home que todas las aplicaciones existentes utilizarán. Para obtener más información sobre el uso de múltiples instancias de Oracle Home con ODP.NET (controlador no administrado), consulte la documentación de ODP.NET.
Es muy recomendable instalar ODAC en una nueva instancia de Oracle Home. La instalación de ODAC sobre una instancia de Oracle Home puede provocar errores de aplicaciones de Oracle existentes. Si lo instala sobre una instancia de Oracle Home existente, asegúrese de detener todos los servicios de Windows que utilizan esa instancia de Oracle Home (por ejemplo, OracleMTSRecoveryService) y de que sea una instancia de Oracle Client Home.

a) Cambie el nombre de oci.dll a oci.dll.delete.
b) Reinicie su máquina.
c) Suprima oci.dll.delete, que ya no debe estar en uso después de reiniciar.
d) Instale el nuevo ODAC.
De manera predeterminada, si instala ODAC sobre una instancia de Home de Oracle 12.2c existente, los componentes de ODAC ya instalados no se instalarán. Debe seleccionar manualmente los componentes de ODAC que se instalarán durante el proceso de instalación (es decir, marque las casillas de los componentes de ODAC que desea instalar). Esto se recomienda para todos los componentes de ODAC que desee utilizar, especialmente ODP.NET.
Esta instalación proporciona archivos de configuración de políticas que pueden redirigir aplicaciones existentes de ODP.NET 10.2 y 11.1 a la versión actual de ODP.NET. Los archivos de políticas se encuentran en los directorios ORACLE_HOME\odp.net\PublisherPolicy\2.x and ORACLE_HOME\odp.net\PublisherPolicy\4. La instalación de ODP.NET no colocará los archivos DLL de política de ODP.NET en la GAC, lo que significa que las aplicaciones existentes seguirán utilizando la misma versión de ODP.NET que antes.
La instalación de ODP.NET en una nueva instancia de Oracle Home significa que es posible que no tenga acceso a ninguno de los alias de fuente de datos de Oracle de una instalación anterior. Para asegurarse de que utiliza estos atributos de fuentes de datos existentes, copie el archivo tnsnames.ora en el directorio ORACLE_HOME\network\admin de la instalación anterior de Oracle Home al mismo directorio en la nueva instalación. También puede crear los alias de conexión manualmente siguiendo las instrucciones de la sección anterior Inicio rápido de la configuración de conexión.
Oracle Database admite, en el momento de su instalación, el uso de Oracle Home User. Oracle Home User se utiliza para ejecutar los servicios de Windows para la instancia de Oracle Home. Oracle Home User puede ser una cuenta virtual, una cuenta de usuario de Windows estándar (no una cuenta de administrador) o una cuenta integrada de Windows. Para obtener más información sobre Oracle Home User, consulte la Guía de la plataforma Oracle Database para Microsoft Windows.
Si Oracle Developer Tools (ODT) para Visual Studio 12.1.0.2.0 (parte de ODAC 12c Release 3) o posterior está instalado en un equipo y se va a instalar en el equipo una versión inferior, ODT 12.1.0.1.2 (parte de ODAC 12c Release 2) o anterior, hay que desinstalar la versión de ODT más reciente antes de instalar la versión anterior de ODT. No hacerlo evitará que funcionen algunas características de ODT, como la depuración de PL/SQL.
La desinstalación de ODP.NET antes de ODAC 12c Release 3 puede provocar que las entradas con referencias al ensamblado .NET 2.x se incluyan en el archivo machine.config de .NET 4.0. Esto puede provocar errores de ejecución en paralelo, a menos que la entrada de la sección de configuración para "oracle.unmanageddataaccess.client" que hace referencia a la versión 2.x de Oracle.DataAccess.Client se elimine manualmente del archivo machine.config de .NET 4.0. También se recomienda eliminar manualmente una entrada de DbProviderFactories que haga referencia a la versión 2.x de Oracle.DataAccess.Client.

Consultar la documentación de ODP.NET

Puede consultar la documentación en formatos PDF y HTML desde la página ORACLE_HOME\ODACDoc\DocumentationLibrary\welcome.html. Para ver esta página, vaya al menú Inicio --> Oracle - < Oracle Home > --> Application Development --> Oracle Data Access Components Documentation.

Además, la documentación Oracle se instala como parte de la Ayuda dinámica de Visual Studio.

Soporte e informes de errores

En caso de error o problema, puede participar en uno de los foros de debate de OTN para ODAC.