Finding a New Home for a Client on Windows

30 08 2010

August 30, 2010

As I am sure that you are aware, there are compatibility problems between Oracle Databases and Oracle Clients that are from different releases.  The Oracle Database 11.1 documentation states the following:

“Upgrade Clients to the Current Release
You can upgrade any or all of your Oracle8i, Oracle9i, or Oracle Database 10g clients to Oracle Database 11g Release 1 (11.1). The Oracle Database 11g Release 1 (11.1) client can be used to access your Oracle8i, Oracle9i, Oracle Database 10g, and Oracle Database 11g Release 1 (11.1) databases.”

So, apparently the Oracle 11.1 client has no trouble communicating with a very old Oracle Database 8.1 release (I did not realize that the backward compatibility extended that far back).  But, what do you do if you are running a Windows client computer and need to able to access an Oracle database and an Oracle 8.0.5 database?  Are you out of luck?  A recent thread on the OTN forums asked a question that was very similar.  In the thread I provided three possible solutions:

  • If you have either the Professional or Ultimate editions of Windows 7. Download Microsoft’s free Windows XP Mode virtual machine and install the Oracle 9i client in that virtual machine. You should be able to create an icon that automatically launches the Windows XP mode virtual machine and then runs a specific program inside the virtual machine (I have not yet tested the auto-launch feature).
  • If the programs will use an ODBC connection, install one of the Oracle clients, create the ODBC connection that will use that client, install the other Oracle client, and create the ODBC connection that will use that client.
  • Modify the environment and start the program that will access the database using that modified environment.

Let’s take a closer look at the last option.  Let’s assume that we have an Oracle home set up on the computer, with the bin folder located here:


When a program starts on Windows, typically the current folder (directory) is searched for required support files, and then the folders in the system path (defined by the PATH environment variable) are checked in the specified order for the support files.  So, to change to this Oracle home we just need to place this location of our home’s bin folder at the start of the PATH environment variable.  To change that variable, open a Windows command prompt window (run cmd.exe) and type the following commands (note that the last command will cause the command prompt window to close):

SET PATH=C:\oracle\product\11.1.0\db_1\bin;%PATH%

The first line appends the selected Oracle home to the beginning of the PATH variable.  The second line starts SQL*Plus in a new window, with Windows automatically finding it in the modified search path; what is interesting is that SQL*Plus (or any program for that matter) remembers the PATH variable that was modified by the previous command (we could have modified several environment variables).  The end result might look like the following (assuming that you did not press the Enter key after typing EXIT – the background window will disappear if you pressed the Enter key):

Interesting, but how do we know that SQL*Plus is remembering the modified PATH variable?  We are able to confirm that the modified path is remembered using Microsoft’s Process Explorer utility by double-clicking on the sqlplus.exe entry in the program and then switching to the Environment tab:

As you are probably able to determine, I probably also should have changed the PERL5LIB location.  Now, let’s try a 8.1.7 client on the same computer:

SET PATH=C:\orant\bin;%PATH%

The resulting window will look like this, if you did not press the Enter key after typing EXIT  – the background window will disappear if you pressed the Enter key:

And the Process Explorer window might look like this:

Why stop at two examples?  We could do this in a command prompt window assuming that there are four Oracle homes):

SET PATH=C:\oracle\product\10.2.0\db_1\bin;%PATH%

SET PATH=C:\oracle\product\10.2.0\client_1\bin;%PATH%

SET PATH=C:\oracle\product\11.1.0\db_1\bin;%PATH%

SET PATH=C:\orant\bin;%PATH%

The end result, after manually aligning the windows, might look like this:

It does not need to be SQL*Plus that is started – it could be any program.  OK, but I don’t want to type a bunch of commands to launch the program.  No problem, just create a text file with a .bat extension:

If the default icon is not fancy enough, just right-click the file and create a shortcut.  You can then view the properties of the shortcut to change the icon:

Just about any EXE file will contain a couple of icons, as will some DLL files.  The result looks like this:

If we were using this approach to start an application program that uses a specific Oracle home, it probably would make sense to change the properties of the shortcut to run using a minimized window to prevent a brief screen flash to black when the batch file executes.



8 responses

1 09 2010
joel garry

Nothing to do with Oracle, but our MIS manager has been running 64 bit enterprise 7 for a while with the XP mode, and has run into several incompatibilities, including the print drivers available working differently enough from real XP to blow off what our production users would need to use. It’s starting to be a problem as we need to replace older stuff. I’m sure there will be some workaround, but I’m glad I can stay on the db side most of the time.

1 09 2010
Charles Hooper


Thank you for the information. I need to spend a little more time experimenting with XP Mode. So far I have been unable to install Oracle Database in XP Mode – the install stops at about 83%, complaining that it cannot find a file. I might have a corrupt installer package. Letting installer programs “reboot” the virtual machine is also problematic.

That is interesting that printer drivers are having problems in the virtual machine. Are these network printers or local printers? If local, are they attached by parallel port or USB?

9 09 2010
joel garry

Network printers. The people involved resolved the problem somehow, but I didn’t get what they did. But the app still doesn’t show network printers on shared drives without twiddling about in its advanced settings.

10 09 2010
Charles Hooper

Thank yout for the additional information. I wonder if the network/server administrator had to load 32 bit drivers on the server, so that the 32 bit XP Mode could automatically download the correct drivers when it connected to the network printer.

3 09 2010
Chris Antognini

Hi Charles

I’m really surprised that the documentation says… “You can upgrade any or all of your Oracle8i, Oracle9i, or Oracle Database 10g clients to Oracle Database 11g Release 1 (11.1). The Oracle Database 11g Release 1 (11.1) client can be used to access your Oracle8i, Oracle9i, Oracle Database 10g, and Oracle Database 11g Release 1 (11.1) databases.”
In fact, as you can read in MOS note “Client / Server / Interoperability Support Between Different Oracle Versions [ID 207303.1]”, only databases as of are support by a 11.1 client.


3 09 2010
Charles Hooper

Hi Chris,

Thank you for pointing out the documentation error (Database Upgrade Guide 11g Release 1 – Introduction to the Database Upgrade Process). I thought that I remembered that the Oracle 10g client permitted connections to as far back as an 8i database, and that the Oracle 11g client permitted connections to 9i databases. However, an initial search of found the above mentioned Database Upgrade Guide in the documentation, and I decided that I must have remembered incorrectly.

A search for Doc ID 207303.1 found a couple of additional Metalink (MOS) notes:
* Metalink (MOS) Doc ID 273972.1 reports that the 10g Instant Client will connect to databases, but not databases
* Metalink (MOS) Bug 3437884 reports that an ORA-3134 will incorrectly result when a 10g client attempts to connect to a databases, and that problem is addressed by using the (R2) client rather than the older 10g (, client.
* Metalink (MOS) Doc ID 844327.1 reports problems with Oracle Forms 11.0.0 connecting to an 8i database, with the only solution being to upgrade the database.

Considering the above (corrected) information, the 11g client should report an ORA-3134 when attempting to connect to an or lower database – and that explains why the original poster in the OTN thread referenced in this blog article was attempting to use a 9i client to connect to an 8i database, while an 11g client was also installed on the same computer.

Thank you again for the correction.

26 09 2011
Oracle – tnsping – Message 3513 not found; product=NETWORK; facility=TNS « RNM

[…] on “Message 3513 not found”, but with a bit of guidance from Ed Stevens’ and Charles Hooper’s blogs I checked my PATH variable and found […]

28 12 2015
Locating Oracle's Network Configuration Files :: edstevensdbaedstevensdba

[…] Charles Hooper has a nice blog article that relates.  See Finding a New Home for a Client on Windows. […]

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s

%d bloggers like this: