Skip Headers

Oracle® Database Client Release Notes
10g Release 1 (10.1.0.2.0) for Windows
Part No. B12179-01
 

 

Copyright © 2004,  Oracle. All rights reserved.

Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

Oracle® Database

Client Release Notes

10g Release 1 (10.1.0.2.0) for Windows

Part No. B12179-01

March 2004

These Release Notes contain important last minute information not included in the Oracle Database documentation library. They may also contain information regarding components that are no longer installed with the database.

This document contains these topics:

1 Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For additional information, visit the Oracle Accessibility Program Web site at

http://www.oracle.com/accessibility/
Accessibility of Code Examples in Documentation

JAWS, a Windows screen reader, may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, JAWS may not always read a line of text that consists solely of a bracket or brace.

Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.

2 Accessibility Software Recommendations

Our goal is to make Oracle products, services, and supporting documentation accessible to the disabled community. Oracle Database 10g release 1 (10.1.0.2.0) supports accessibility features. To make best use of these accessibility features, Oracle recommends the following software configuration:

Additional accessibility information for Oracle products can be found at

http://www.oracle.com/accessibility

For the latest configuration information, and for information on addressing accessibility and assistive technology issues, see the Oracle Accessibility FAQ at

http://www.oracle.com/accessibility/faq.html

3 Documentation

Documentation for Oracle Database 10g release 1 (10.1.0.2.0) is available at

http://otn.oracle.com/documentation/index.html

4 Location of README Files

Additional component README files are accessible after installation. They are located in:

5 Microsoft Active Directory Support

Microsoft Active Directory is supported with Oracle Database 10g release 1 (10.1).


See Also:

"Using Oracle Database with Microsoft Active Directory" in PDF format at http://otn.oracle.com/products/oraclenet/pdf/ADsupport_10g.pdf and in HTML format at http://otn.oracle.com/products/oraclenet/htdocs/ADsupport_10g.htm

6 New Features

This section describes new features of Oracle Database for Windows that are not documented elsewhere.

6.1 New Oracle C++ Call Interface Libraries Available for Windows

New Oracle C++ Call Interface (OCCI) libraries are available for Microsoft CRT debugging and for developing applications with Microsoft Visual C++ 7.0 .NET 2002 and Microsoft Visual C++ 7.1 .NET 2003.

6.1.1 Support for Debug Version of Microsoft Visual C++ 6.0

Applications that are linked with MSVCRTD.DLL (debug version of Microsoft C-Runtime) in order to debug memory issues should link with oraocci10d.lib and oraocci10d.dll. These files are for use with Microsoft Visual C++ 6.0. The installed location is ORACLE_BASE\ORACLE_HOME\oci\lib\msvc\vc6.

6.1.2 Support for Microsoft Visual C++ 7.0 .NET 2002

Applications developed in Microsoft Visual C++ 7.0 .NET 2002 should use oraocci10.lib and oraocci10.dll. The currently shipped OCCI DLL is built with Microsoft Visual C++ 6.0 and cannot be used from a Microsoft Visual C++ 7.0 .NET 2002 compiled application. This OCCI library links with the non-debug version of Microsoft CRT (MSVCR70.DLL). The installed location is ORACLE_BASE\ORACLE_HOME\oci\lib\msvc\vc7

6.1.3 Support for Debug Version of Microsoft Visual C++ 7.0 .NET 2002

Applications that are linked with MSVCR70D.DLL (debug version of Microsoft C-Runtime) in Microsoft Visual C++ 7.0 .NET 2002 in order to debug memory issues should link with oraocci10d.lib and oraocci10d.dll. The installed location is ORACLE_BASE\ORACLE_HOME\oci\lib\msvc\vc7.

6.1.4 Support for Microsoft Visual C++ 7.1 .NET 2003

Applications developed in Microsoft Visual C++ 7.1 .NET 2003 should use oraocci10.lib and oraocci10.dll. The currently shipped OCCI DLL is built with Microsoft Visual C++ 6.0 and cannot be used from a Microsoft Visual C++ 7.1 .NET 2003 compiled application. This OCCI DLL links with the non-debug version of Microsoft CRT (MSVCR71.DLL). The installed location is ORACLE_BASE\ORACLE_HOME\oci\lib\msvc\vc71.

6.1.5 Support for Debug Version of Microsoft Visual C++ 7.1 .NET 2003

Applications that are linked with MSVCR71D.DLL (debug version of Microsoft C-Runtime) in Microsoft Visual C++ 7.1 .NET 2003 in order to debug memory issues should link with oraocci10d.lib and oraocci10d.dll. The installed location is ORACLE_BASE\ORACLE_HOME\oci\lib\msvc\vc71.


Note:

The current Oracle C++ Call Interface library for Microsoft Visual C++ 6.0 is available as in previous releases.
  • oraocci10.lib is available in ORACLE_BASE\ORACLE_HOME\oci\lib\msvc.

  • oraocci10.dll is available in ORACLE_BASE\ORACLE_HOME\bin.

  • Copies of these two files are also installed in ORACLE_BASE\ORACLE_HOME\oci\lib\msvc\vc6.



Note:

Ensure that the LIB and PATH environment variables are set appropriately for the Visual C++ compiler version being used. For example, if you are using Visual C++ 7.0, then add directory ORACLE_BASE\ORACLE_HOME\oci\lib\msvc\vc7 to the LIB and PATH variables. Environment variables can be set from the Windows Control Panel or using the SET command.

7 Components Requiring Separate Installations

Some components are no longer installed with the Oracle Database software. A list of installation changes is provided in Oracle Database Installation Guide for Windows.


See Also:

"Additional Software Installations" in Oracle Database Installation Guide for Windows

In addition to that list, Oracle Database 10g release 1 (10.1) includes Oracle Internet Directory client tools, but not Oracle Internet Directory server components. The latter ship with Oracle 10g Application Server. If the Oracle Internet Directory client tools are needed for Oracle Database components, then they must be run from an Oracle 10g Application Server installation.

The Oracle Internet Directory client tools are the LDAP command-line tools, the Oracle Internet Directory SDK, and Oracle Directory Manager. The Oracle Internet Directory server components include the directory server, the directory replication server, the directory integration server, and various tools for starting and stopping them.

8 Desupported Components

The following components are desupported in this release:

9 Open Bugs and Known Issues

This section describes bugs and known issues for Oracle Database for Windows:

9.1 Installation on Windows 2000 with Service Pack 4

Oracle Universal Installer may appear and then disappear on Windows 2000 with Service pack 4. This is because of an underlying JRE bug. There are three workarounds, depending on what you are installing.

For an Enterprise Manager Grid Control installation, run

install\setup.exe -J-Dsun.java2d.noddraw=true

For an Oracle Database installation, run

install\setup.exe -J-Dsun.java2d.noddraw=true

For a Cluster Ready Services installation, run

install\setup.exe -J-Dsun.java2d.noddraw=true 
-Doracle.installer.formCluster=true 

9.2 User Threads

Oracle Database Platform Guide for Windows discusses "User Threads", a new feature of Oracle Database for Windows. This new feature is available in the 64-bit version of Oracle Database, which Oracle plans to release at a later date. It is not available in the current 32-bit release of Oracle Database for Windows.

9.3 Readme Text Files

Some Readme text files contain Unix line breaks. If you simply double-click these files, they will open in Notepad by default, and Notepad does not recognize Unix line breaks. Use write.exe or edit.com instead.

9.4 Oracle Net Configuration Assistant and Active Directory

If you use Oracle Net Configuration Assistant to complete directory access configuration with Active Directory, and the Active Directory server already has an Oracle Context, then select the following non-default radio button:

  • Select the directory server you want to use, and configure the directory server for Oracle usage. (Create or upgrade Oracle Schema and Oracle Context as necessary.)

Oracle Net Configuration Assistant will report that the Oracle Context does not exist. Ignore this and choose to create the Oracle Context anyway. Directory access configuration will complete without trying to re-create the existing Oracle Context.

9.5 Oracle Net Manager and Active Directory

If you use Oracle Net Manager with Active Directory for creating and managing net service names from this release, then partial net service names are created. Oracle recommends that you not use Oracle Net Manager with Active Directory.

If you are already using Active Directory from a previous Oracle release, then you can continue to use Oracle Net Manager from that release to create net service names in Active Directory for Oracle Database 10g databases.

9.6 Quick Tour Not Available in Oracle Change Management Pack

Quick Tour is not available in Oracle Change Management Pack. If you try to run it, then an error results.

9.7 Error When Viewing Period SQL Execution Plan in Korean

Viewing the execution plan of a Period SQL in Korean causes an internal server error. This problem is unique to Korean; it does not reproduce in Japanese or Chinese. The only workaround currently available is to run the product in a non-Korean language when you need to view this page.

9.8 NTS Authentication Failure with .NET Remote Objects

If NTS authentication is used with an Oracle client as a .NET remote object impersonating a user credential, then NTS authentication will fail with the error ora-12638 Credential Retrieval Failed. This happens due to the failure of the Windows API AcquireCredentialsHandle() in the NTS adapter inside the .NET remote object. Refer to OracleMetalink for more details.

10 Documentation Corrections and Additions

This section contains these topics:

10.1 Globalization Support

The instructions documented in the "Using Oracle9i Database Language and Territory Definition Files with Oracle Database 10g" section of the 10g release 1 (10.1) Database README, related to the ORA_NLS10 environment variable are not correct. This is because the ORACLE_BASE\ORACLE_HOME\nls\data\old directory contains the definitions files which have changed in Oracle Database 10g release 1 (10.1) only, and not the complete set of the database locale definition files. To switch back to the Oracle 9i definitions, you need to first copy the content of ORACLE_BASE\ORACLE_HOME\nls\data into a new directory (ORACLE_BASE\ORACLE_HOME\nls\data\9i for example); next, populate this directory with the content from ORACLE_BASE\ORACLE_HOME\nls\data\old. Now you can set your ORA_NLS10 variable to point to this new directory.

Please refer to the Oracle Database Globalization Support Guide and the README for more information regarding the changes in the Language and Territory definition files between Oracle9i database and Oracle Database 10g.

10.2 Grid Features

Oracle Database New Features for Oracle Database 10g release 1 (10.1) lists two Grid features that are not available in the first release of Oracle Database 10g, Resonance and Transparent Session Migration. These features will be available in an upcoming release.

10.3 Full-Text Searching with Oracle Text

For full-text searching with Oracle Text, you must create XML tables manually.

If you will need to use Oracle Text indexes for text-based ora:contains searches over a collection of XML elements, then do not use XML schema annotation storeVarrayAsTable="true". This annotation causes element collections to be persisted as rows in an Index Organized Table (IOT). Oracle Text does not support IOTs.

To be able to use Oracle Text to search the contents of element collections, set parameter genTables="false" during schema registration. Then create the necessary tables manually, without using the clause ORGANIZATION INDEX OVERFLOW. The tables will then be heap-organized instead of index-organized (IOT), as shown in Example 1.

Example 1 Manually Creating a Heap-Organized Table that Conforms to an XML Schema

CREATE TABLE PurchaseOrder of XMLTYPE
  XMLSCHEMA http://localhost:8080/home/SCOTT/poSource/xsd/purchaseOrder.xsd
  ELEMENT "PurchaseOrder"
  VARRAY "XMLDATA"."ACTIONS"."ACTION"
    STORE AS TABLE ACTION_TABLE ((PRIMARY KEY 
      (NESTED_TABLE_ID, ARRAY_INDEX)))
  VARRAY "XMLDATA"."LINEITEMS"."LINEITEM"
    STORE AS TABLE LINEITEM_TABLE ((PRIMARY KEY 
      (NESTED_TABLE_ID, ARRAY_INDEX)));

10.4 View Descriptions

Oracle Database Performance Tuning Guide, Chapter 10, "Instance Tuning Using Performance Views", has two incorrect view descriptions. The view names and correct descriptions are as follows:

  • V$EVENT_HISTOGRAM

    The V$EVENT_HISTOGRAM view displays a histogram of the number of waits, the maximum wait, and total wait time on an event basis.

  • V$SYSTEM_WAIT_CLASS

    The V$SYSTEM_WAIT_CLASS view provides the instance wide time totals for the number of waits and the time spent in each class of wait events. [This description removes the reference to object number.]

10.5 Configuring Management Service Processes

In Oracle High Availability Architecture and Best Practices, Chapter 8, "Using Enterprise Manager for Monitoring and Detection", the section "Configure At Least Two Service Processes and Load Balance Them" should read as follows:

For the middle tier, the baseline recommendation is to have a minimum of two Management Service processes, using a hardware server load balancer to mask the location of an individual Management Service process and a failure of any individual component. This provides immediate coverage for a single failure in the most critical components in the Enterprise Manager architecture with little interruption of service for all systems monitored using Enterprise Manager. Management Service processes connect to the repository instances using Oracle Net.

10.6 Monolingual Linguistic Sorting

In Oracle Database Globalization Support Guide, Chapter 5, "Linguistic Sorting and String Searching", the section called "Monolingual Linguistic Sorts" should end with the following note:

Monolingual linguistic sorting is not available for non-Unicode multibyte database character sets. If a monolingual linguistic sort is specified when the database character set is non-Unicode multibyte, then the default sort order is the binary sort order of the database character set. One exception is UNICODE_BINARY. This sort is available for all character sets.

10.7 Windows Terminal Services and Remote Desktop Connection Support

Oracle supports both installation and runtime for Windows Terminal Services (also known as Remote Desktop Connection in Windows XP). Disregard limitations on such support that appear in:

  • Oracle Database Installation Guide for Windows

  • Oracle Database Client Installation Guide for Windows

  • Oracle Database Companion CD Installation Guide for Windows

  • Oracle Real Application Clusters Installation and Configuration Guide