Oracle Data Access Components (ODAC)

Xcopy Version Installation Instructions

1. Download the ODAC (xcopy version) zip file to a directory for staging ODAC products.
2. Unzip ODAC (xcopy version) zip file to expand the contents.
   
   The following directories will be created:
   
   a) Instantclient_12_1 - Oracle Instant Client
   b) ODP.NET20 - Oracle Data Provider for .NET 2.0
   c) ODP.NET4 - Oracle Data Provider for .NET 4 -- contains both managed and unmanaged drivers
   d) ASP.NET - Oracle Providers for ASP.NET 2.0
   e) ASP.NET4 - Oracle Providers for ASP.NET 4
   f) OLEDB - Oracle Provider for OLEDB
   g) OraMTS - Oracle Services for MTS
   
   The install.bat will also be extracted to the same location as the ODAC zip file, which is used to install and configure a specific product.
    
3. If installing into an existing xcopy home, uninstall the existing version by following the instructions in the "Uninstallation Instructions" section of this README.
4. Execute install.bat to install and configure ODAC products.
   
   Note: Depending on the components to install/configure, administrative level privileges may be required. Oracle recommends running the batch file under the "Run as Administrator" context.
   
   To install all ODAC products, execute the following:
   
   install.bat all c:\oracle odac
   
   Each product can be also be installed and configured individually. As an example, executing the following will install only ODP.NET for .NET Framework 4
   
   install.bat odp.net4 c:\oracle odac
   
   where "c:\oracle", for example, is your installation directory and "odac" is the Oracle Home Name that is used for the registry keys. In this example, the registry entries for this install are created under HKLM\Software\Oracle\KEY_odac. Note that ODP.NET registry entries are simply created under HKLM\Software\Oracle\ODP.NET\ not under HKLM\Software\Oracle\KEY_<Oracle Home Name>. If multiple products are installed to the same destination directory, make sure that the Oracle Home Name that is specified as an argument to install.bat is the same for all those products.
   
   By default, when install.bat is executed for a given product, the product and its dependencies will be installed and configured WITHOUT a check to see if there is a newer version of the product or its dependencies already installed.
   
   Below is the product dependency information:
   
   a) Oracle Data Provider for .NET 2 depends on
      - Oracle Instant Client
   b) Oracle Data Provider for .NET 4 depends on
      - Oracle Instant Client (ODP.NET, Unmanaged Driver only)
   c) Oracle Providers for ASP.NET 2 depends on
      - Oracle Instant Client
      - Oracle Data Provider for .NET 2 (unmanaged driver)
   d) Oracle Providers for ASP.NET 4 depends on
      - Oracle Data Provider for .NET 4 (managed driver)
   e) Oracle Provider for OLEDB depends on
      - Oracle Instant Client
   f) Oracle Services for MTS depends on
      - Oracle Instant Client
   
   To not have the product dependencies installed and configured, execute install.bat with 'false' as the fourth parameter.
   
   For example, executing
   
   install.bat odp.net4 c:\oracle odac false
   
   will only install and configure ODP.NET 4 and not install and configure instant client. If the second to last argument is not specified, the product and its dependencies will be installed and configured.
   
   By default, machine_wide_configuration=true.
   If machine_wide_configuration option is true, ODP.NET assemblies are placed into the GAC and machine.config is configured, which impacts the entire machine. However, if machine_wide_configuration option is false, ODP.NET assemblies are not placed into the GAC and machine.config is not modified. Please simply execute install.bat without any parameters for more details. If setting machine_wide_configuration=false, ungac pre-existing ODP.NET and Oracle ASP.NET provider assemblies from all homes on the machine and unconfigure them from machine.config. This can be accomplished by following the instructions in the "Uninstallation Instructions" section of this README.
    
5. Add the install directory and install directory's bin subdirectory to the system PATH environment variable before any other Oracle directories. Otherwise, the products that are installed may not work properly as it will not be able to load the necessary DLLs. for example, if c:\oracle was provided as the install directory, add c:\oracle and c:\oracle\bin to the system PATH.
    
6. Note that install.bat sets the value of the NLS_LANG registry key at HKLM\Software\Oracle\KEY_<Oracle Home Name> to AMERICAN_AMERICA.WE8MSWIN1252 by default. Please modify install.bat or change this value in the registry after the install if necessary.
    
7. If OraMTS is installed, the Oracle<OracleHomeName>MTSRecoveryService is created with the LocalService account as the logon account. The credentials can be changed using the "services" administration tool. The default port used is 2030. Please read the OraMTS readme.txt for details. Note that after the install or the configuration, the service will not be started, since it requires the install directory and its bin directory to be included in the system PATH.
    
8. Applications using components from ODAC can use EZ CONNECT to connect to Oracle without depending on tnsnames.ora. Otherwise, configure or copy over tnsnames.ora from another machine and set TNS_ADMIN or ORACLE_HOME environment variable appropriately.