®

Toad for Oracle 11.0

Installation Guide
© 2011 Quest Software, Inc.
ALL RIGHTS RESERVED.

This guide contains proprietary information protected by copyright. The software described in
this guide is furnished under a software license or nondisclosure agreement. This software may be
used or copied only in accordance with the terms of the applicable agreement. No part of this
guide may be reproduced or transmitted in any form or by any means, electronic or mechanical,
including photocopying and recording for any purpose other than the purchaser’s personal use
without the written permission of Quest Software, Inc.

The information in this document is provided in connection with Quest products. No license,
express or implied, by estoppel or otherwise, to any intellectual property right is granted by this
document or in connection with the sale of Quest products. EXCEPT AS SET FORTH IN
QUEST'S TERMS AND CONDITIONS AS SPECIFIED IN THE LICENSE AGREEMENT FOR
THIS PRODUCT, QUEST ASSUMES NO LIABILITY WHATSOEVER AND DISCLAIMS
ANY EXPRESS, IMPLIED OR STATUTORY WARRANTY RELATING TO ITS PRODUCTS
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTY OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-
INFRINGEMENT. IN NO EVENT SHALL QUEST BE LIABLE FOR ANY DIRECT,
INDIRECT, CONSEQUENTIAL, PUNITIVE, SPECIAL OR INCIDENTAL DAMAGES
(INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS, BUSINESS
INTERRUPTION OR LOSS OF INFORMATION) ARISING OUT OF THE USE OR
INABILITY TO USE THIS DOCUMENT, EVEN IF QUEST HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES. Quest makes no representations or warranties with respect
to the accuracy or completeness of the contents of this document and reserves the right to make
changes to specifications and product descriptions at any time without notice. Quest does not
make any commitment to update the information contained in this document.

If you have any questions regarding your potential use of this material, contact:

Quest Software World Headquarters

LEGAL Dept
5 Polaris Way
Aliso Viejo, CA 92656
email: [email protected]

Refer to our Web site (www.quest.com) for regional and international office information.

Trademarks

Quest, Quest Software, the Quest Software logo, Benchmark Factory, Spotlight, Toad, T.O.A.D.,
Toad World, vSpotlight, and vToad are trademarks and registered trademarks of Quest Software,
Inc in the United States of America and other countries. For a complete list of Quest Software’s
trademarks, please see http://www.quest.com/legal/trademark-information.aspx. Other trademarks
and registered trademarks are property of their respective owners.

Toad for Oracle 11.0

Installation Guide
August 24, 2011
Table of Contents
Installation Requirements 5
Required Windows Privileges 5
System Requirements 5
Virtualization Support 6

Install Toad 7
Install or Upgrade Toad 7
Install Toad on Citrix or Remote Desktop Services Systems 7
Uninstall Toad 8
Manually Import Toad Settings 8
Import Settings During Installation 8

Import Settings After Installation 9

Install Toad Silently 11

Extract MSI Files 11
Install Toad Silently 12
Install Patches Silently 12
Parameters for Silent Installations 12
Uninstall Toad Silently 16
Group Policy Manager 17
About Group Policy Manager 17
Installation Options 17

Upgrade Group Policy Manager 18

Appendix: Contact Quest 19
Contact Quest Support 19
Contact Quest Software 19
About Quest Software 19
Toad for Oracle Installation Guide 4
Table of Contents

Index 20
 1
Installation Requirements

Required Windows Privileges

In order to install and run Toad for Oracle, make a connection, and do basic operations, you must
have the following privileges:

Operating System Requirements

Windows 2000 l Read access to the Oracle client folder

Windows XP l Read/write privileges on the Oracle homes directories
Windows Server that you use for your connections
l Be a Power User or Administrator

Windows Vista l Read access to the Oracle client folder

Windows 7 l Read/write privileges on the Oracle homes directories
that you use for your connections
l If UAC (user account control) is enabled, you must have
administrator privileges

Note: Other functionality in Toad may require additional privileges.

System Requirements
Before installing Toad, ensure your system meets the following minimum hardware and software
requirements:

Memory 512 MB RAM required, 1 GB recommended

Note: The memory required may vary based on the following: 
l Applications that are running on your system
l Size and complexity of the database
l Amount of database activity
l Number of concurrent users accessing the database

Hard Disk 75 MB
Space

Operating Windows 2000 (32-bit and 64-bit)

System
Toad for Oracle Installation Guide 6
Installation Requirements

Windows XP (32-bit and 64-bit)

Windows Server 2003 (32-bit and 64-bit)
Windows Vista (32-bit and 64-bit)
Windows Server 2008 (32-bit and 64-bit)
Windows Server 2008 R2 (64-bit)
Windows 7 (32-bit and 64-bit)
Note: When running on a 64-bit operating system, you must use the 32-
bit Oracle Client.

Database Oracle Client 8.1.7.4

Client Oracle Client 9.2.0.8
Oracle Client or Instant Client 10.2.0.3/10.2.0.4
Oracle Client or Instant Client 11.2.0.1
Note: Only the 32-bit Oracle client is supported.

Database Oracle 8.0.6; 8.1.7; 9i; 9i R2; 10g R1; 10g R2; 11g R1, 11g R2
Server Toad has been tested on Oracle Exadata 2.0 running Oracle database 11g
R2.
Important: It is recommended that your client version be of the same
release (or later) as your database server. This is an Oracle
recommendation to prevent performance issues.

Cloud Oracle databases running on Amazon EC2

Database
Service

Additional Microsoft Internet Explorer 6.0 or later (to view the Release Notes)
Software Adobe Acrobat Reader 7.0 or later (to view the Installation Guide)

Virtualization Support
Before installing Toad, review the following for virtualization support:

Application Citrix XenApp 5.0 has been tested.

Virtualization

Desktop Quest vWorkspace 7.0 has been tested.

Virtualization
(VDI)

Server VMware ESX Server 3.5 has been tested.

Virtualization

Note: Toad may work in virtualization environments other than the ones listed.
 2
Install Toad

Install or Upgrade Toad

When you install Toad you can also install the additional applications that come with your Toad
Bundle, such as SQL Optimizer (SQL Tuning), Knowledge Xpert, or Toad Data Modeler.

If you already have Toad installed and run the installer for a newer version, the new version
installs side-by-side to your previous version. The first time you run the new version you are
prompted to import your previous settings files.

Caution: If you also have the freeware version of Toad, you should not install the
commercial version over the freeware version. This will adversely affect some functions.
Install the commercial version in a different directory from the freeware version.

Notes:

l Toad supports importing settings only if the new version is within two releases of the
previous version. If your versions are more than two releases apart, you need to install an
intermediate version to successfully import the files.
l If you need to import your Toad settings from another computer, you can manually import
the settings. See "Manually Import Toad Settings" (page 8) for more information.

To install Toad for Oracle

1. Run the Toad bundle installation program from the DVD or download file.

2. Complete the wizard.

Note: On the Read-Only Installation page, select whether to install Toad as a typical
install with all features enabled, or whether you want to install as read-only. In read-only
mode, you cannot create, alter, or drop database objects.

Install Toad on Citrix or Remote Desktop

Services Systems
All user files are stored in a user_name directory. When a user opens Toad for the first time, Toad
copies the contents of this folder to the user’s associated Application Data folder for Toad.

Note: Write access is required to the Oracle directory if any of the users want to edit the
tnsnames.ora file by using the TNSNames Editor.
Toad for Oracle Installation Guide 8
Install Toad

To install Toad on a Citrix/Remote Desktop Services system

1. Connect to the system as an administrator.

2. Copy Toad to the Citrix/Remote Desktop Services server, if required.
3. Install Toad.
4. Right-click Toad.exe and select Properties. Make sure the Allow non-administrators to
run this program option is selected under Compatibility | User Account Privileges.

5. Repeat steps 2 through 4 for each server in the Citrix/Remote Desktop Services farm.

Note: Although you must install Toad on every server in the farm, you only need to
publish Toad once.

Uninstall Toad
When you use Toad, you create new Toad files such as SQL scripts, data output, or temp files.
When you run uninstall, Toad has no way of knowing what those files are, so it does not remove
files that you have created. You must manually delete them.

To uninstall Toad

» From Start | Programs | Quest Software | Quest Installer, select the Quest Installer, and
then follow the instructions for uninstalling the appropriate program.

Manually Import Toad Settings

Toad automatically prompts you to import your previous settings when you upgrade to a new
version. However, there are cases when you may need to manually import your Toad settings.

If you just need to import your connection settings or saved SQL, Toad has features that allow
you to easily import and export them from one copy of Toad to another. Review the following
topics in the online help for additional information:

l Import/Export Connection Settings

l Import/Export Saved SQL

Watch the Manually Importing Toad for Oracle Settings video on Quest's video channel.

Note: Toad supports importing settings only if the new version is within two releases of the
previous version. If your versions are more than two releases apart, you need to install an
intermediate version to successfully import the files.

Import Settings During Installation

If you are installing a new version of Toad on the same computer that has your previous Toad
version already installed, just complete the wizard to import your old settings. Complete this
Toad for Oracle Installation Guide 9
Install Toad

procedure if your old settings are not located on the same computer.

To import settings during installation

1. On your old computer, open Windows Explorer and locate the Toad settings folder.

Tip: To find the settings folder, select View | Toad Options | General. The folder
location is listed in the Application data directory field.

2. Copy the folder to the new computer, a network it can connect to, or a storage device.

3. Install and open Toad on the new computer.

Note: You need your license key to complete this step.

4. Select Copy previous user files on the Initial Setup wizard.

5. Click and navigate to the copied folder.

6. Click Finish.

Import Settings After Installation

You may need to manually import your settings after installation if:

l You accidentally selected to perform a clean install when you installed a new
version of Toad
l You have already installed Toad on a new computer and your Toad settings are on
another computer

To import settings after installation

1. If your Toad settings are on another computer, complete the following steps:

a. On your old computer, open Windows Explorer and locate the Toad
settings folder.

Tip: To find the settings folder, select View | Toad Options | General. The folder
location is listed in the Application data directory field.

b. Copy the folder to the new computer, a network it can connect to, or a
storage device.

2. Open the settings folder for the new installation of Toad.

Tip: To find the settings folder, select View | Toad Options | General. The folder
location is listed in the Application data directory field.

3. Close any open instances of Toad.

4. Delete everything in the new settings folder except for the QSAuth11.key file, if it is
Toad for Oracle Installation Guide 10
Install Toad

present.

Note: QSAuth11.key is a license key issued with old versions of Toad, but it is still valid
for new versions of Toad. If this file is not in your Toad settings folder, then you have a
new Toad license key.

5. Open the new installation of Toad.

6. Select Copy previous user files on the Initial Setup wizard.

7. Click and select the Toad settings folder you want to import.
8. Click Finish.
Toad for Oracle Installation Guide 11
Install Toad Silently

Install Toad Silently

Extract MSI Files

In order to perform a silent install, you must first extract the MSI file from the Quest Installer.
The extraction log contains the command line parameters needed to perform default installations.
However, you may want to change parameters to fit your environment or standards. See
"Parameters for Silent Installations" (page 12) for more information.

Note: You do not need to install the Quest Installer on any of the computers where you
are silently installing Toad products. The Quest Installer is only used to extract the
required MSI files.

To extract MSI files from the Quest Installer

1. Run your Toad bundle from the command prompt, including the correct path to the
directory where it resides and the /extract parameter. Since the executable contains
spaces, remember to include quotation marks. For example:

2. Complete the wizard. Review the following for additional information:

Product Selection Description

Page

Select the Verify that all the products you want to extract display in this
product you list. If a product does not display, you should start over and
want to extract select an edition that contains all the files.

Finish Page Description

Readme.txt Click this link to open the extraction log as well as the
command-line parameters that are needed to perform default
installations of the products. This file also defines the order in
which the products need to be installed to satisfy the
dependencies between the products.
Toad for Oracle Installation Guide 12
Install Toad Silently

Install Toad Silently

To install Toad silently

1. Extract the MSI from the Quest Installer. See "Extract MSI Files" (page 11) for more
information.

2. Enter an install command similar to the following:

msiexec /i "<path to msi file\ToadforOracle_

version.msi>"INSTALLDIR="<installation folder>"
ADDLOCAL=Client,Server/q /l*v <path to install log, including file
name>

For example:

msiexec /i "C:\Documents and

Settings\Johndoe\desktop\ToadforOracle11.0.exe"INSTALLDIR="C:\Programs\Quest
Software\Toad for Oracle" ADDLOCAL=Client,Server/q /l*v
"C:\install.log"

Install Patches Silently

If you already have Toad installed and want to upgrade silently, you must include
REINSTALLMODE=vo REINSTALL=ALL in the command. If these parameters are not included, the
MSI registers that Toad is already installed and does not upgrade it.

For example, if you are currently in the directory where the MSI resides, entering the following
command installs to the standard location:

msiexec.exe /i <path to msi file\ToadforOracle<version>SetupFull.msi>

REINSTALLMODE=vo REINSTALL=ALL

You can also set additional parameters or run the MSI from a location other than the active
directory. For example:

msiexec /i "C:\Documents and Settings\johndoe\desktop\

ToadforOracleSetupFull.msi REINSTALLMODE=vo REINSTALL=ALL
INSTALLDIR="C:\Programs\Quest Software\Toad for Oracle\" /q /l*v
"C:\install.log"

Parameters for Silent Installations

The following parameters are available for a silent installation:

Option Parameter Description

/l Package|ProductCode Installs or configures the product.

Toad for Oracle Installation Guide 13
Install Toad Silently

Option Parameter Description

/f [p|o|e|d|c|a|u|m|s|v] Repairs the product. This option ignores

Package|ProductCode any property values entered in the
command-line. The default argument list
for this option is 'omus.' The following
options are available:
l p—Reinstalls only if a file is
missing.
l o—Reinstalls if a file is missing
or an older version is installed.
l e—Reinstalls if a file is missing
or an equal or older version is
installed.
l d—Reinstalls if a file is missing
or a different version is installed.
l c—Reinstalls if a file is missing
or the stored checksum does not
match the calculated value. This
option only repairs files that have
msidbFileAttributesChecksum in
the Attributes column of the File
table.
l a—Forces all files to be
reinstalled.
l u—Rewrites all required, user-
specific registry entries.
l m—Rewrites all required,
computer-specific registry entries.
l s—Overwrites all existing
shortcuts.
l v—Runs from source and re-
caches the local package. Do not
use this option for the initial
installation of the product or
feature.

/a Package Installs the product on the network.

/x Package/ProductCode Uninstalls the product.

/l [i|w|e|a|r|u|c|m|o|p|v|x|+|!|*] Writes logging information to a logfile

Logfile in the specified path. The path to the
Toad for Oracle Installation Guide 14
Install Toad Silently

Option Parameter Description

logfile location must already exist. The

installer does not create the directory
structure for the logfile. Flags indicate
which information to log. If no flags are
set, the default is 'iwearmo.' The
following options are available:
l i—Status messages.
l w—Nonfatal warnings.
l e—All error messages.
l a—Start up of actions.
l r—Action-specific records.
l u—User requests.
l c—Initial UI parameters.
l m—Out-of-memory or fatal exit
information.
l o—Out-of-disk-space messages.
l p—Terminal properties.
l v—Verbose output.
l x—Extra debugging information.
Only available on Windows
Server 2003.
l +—Append to existing file.
l !—Flush each line to the log.
l "*"—Log all information except
for the v and x options. To
include the v and x options, enter
"/l*vx".

/q n|b|r|f Sets the user interface level. Review the

following options:
l q, qn—No UI
l qb—Basic UI. Use qb! to hide
the Cancel button.
l qr—Reduced UI with no modal
dialog box displayed at the end
of the installation.
Toad for Oracle Installation Guide 15
Install Toad Silently

Option Parameter Description

l qf—Full UI and any authored

FatalError, UserExit, or Exit
modal dialog boxes at the end.
l qn+—No UI except for a modal
dialog box displayed at the end.
l qb+—Basic UI with a modal
dialog box displayed at the end.
The modal box does not display
if you cancel the installation. Use
qb+! or qb!+ to hide the Cancel
button.
l qb- —Basic UI with no modal
dialog boxes. Note that /qb+- is
not a supported UI level. Use qb-
! or qb!- to hide the Cancel
button.
Note: The ! option is available with
Windows Installer 2.0 and works only
with basic UI. It is not valid with the
full UI.

RESTRICTIONS p Prevents users from saving their

connection password by disabling the
Save password field in the Database
Login window. For example:
RESTRICTIONS=p
Toad for Oracle Installation Guide 16
Install Toad Silently

Uninstall Toad Silently

To uninstall Toad silently

» Enter a command similar to the following:

msiexec /x "<path to msi file\ToadforOracle_

version.SetupFull.msi>" /q
 3
Group Policy Manager

About Group Policy Manager

The Toad Group Policy Manager is a free utility which is currently available with a licensed
copy of Toad for Oracle. Quest Software reserves the right to remove, change or alter this utility
at any time.

It is strongly recommended that you read all of the Group Policy Editor documentation before
deploying this feature. Group Policy Editor documentation can be found in the Group Policy
Editor Help file, or in the GrpPlcyEdtr.pdf file, both of which are installed when you install the
Group Policy Editor.

The Group Policy Manager functionality consists of the following parts, which do not have to
reside on the same computer:

l Group Policy Server—Windows service that controls delivery of policy files to individual
Toad instances.
l Group Policy Editor—Setup groups and policies and publish policies to the policy server.
This should be installed on the administrator's computer.
l Toad Policy files—Contain the restrictions provided by the Group Policy Server. All
client installations of Toad include a toad.pdl file in the installation directory. If you are
planning on using the managed environment, this .pdl file must be replaced with a
managed file (that includes a group assignment for receiving policies) before that instance
of Toad can be controlled.

For full information about the Toad Policy Manager, please see the Toad Policy Editor help file.

Installation Options
You have the following options to install the Group Policy Manager:

l Full Install—Installs the Group Policy Server and the Group Policy Editor to the
same location.
l Group Policy Server—Installs only the Group Policy Server.

l Group Policy Editor—Installs only the Group Policy Editor.

Note: If you want to use the server and the editor from the same computer, you must
select the Full install option. Otherwise the installed parts will not be able to
communicate.
Toad for Oracle Installation Guide 18
Group Policy Manager

Upgrade Group Policy Manager

When you upgrade the Group Policy Server, the Quest Installer will locate the previous
installation path and upgrade the Server within that directory. Because of this, the
Installation path notation in the installer may not be honored if there is an old version of
the Server installed.

To upgrade Toad Group Policy Editor and maintain any settings and files you have created using
a pre-9.5 version, you will need to move the pre-9.5 files as described in the following
procedure.

To move Group Policy Manager files

» Move the following files from the current Editor directory to your preferred
directory path:

l Group Policy.ini
l Group PolicyGUI.ini
l Entire Files subdirectory

The default path is:

\Program Files\Quest Software\Toad Group Policy Manager\Editor

Appendix: Contact Quest

Contact Quest Support

Quest Support is available to customers who have a trial version of a Quest product or who have
purchased a Quest product and have a valid maintenance contract. Quest Support provides
unlimited 24x7 access to SupportLink, our self-service portal. Visit SupportLink at
http://support.quest.com.

From SupportLink, you can do the following:

l Retrieve thousands of solutions from our online Knowledgebase

l Download the latest releases and service packs
l Create, update and review Support cases

View the Global Support Guide for a detailed explanation of support programs, online services,
contact information, policies and procedures. The guide is available at: http://support.quest.com.

Contact Quest Software

Email [email protected]

Quest Software, Inc.

World Headquarters
Mail 5 Polaris Way
Aliso Viejo, CA 92656 
USA

Web site www.quest.com

See our web site for regional and international office information.

About Quest Software

Quest Software simplifies and reduces the cost of managing IT for more than 100,000 customers
worldwide. Our innovative solutions make solving the toughest IT management problems easier,
enabling customers to save time and money across physical, virtual and cloud environments. For
more information about Quest go to www.quest.com.
 Q
Index Quest Installer, extract MSI files 11

C R

Citrix Remote Desktop Services

install 7 install 7

support 6 requirements

F privileges 5

files, extract MSI 11 system 5

G S

Group Policy Manager silent installation 12

install options 17 extract MSI files 11

upgrade 18 parameters 12

I system requirements 5

import T

Toad settings 8 Toad for Oracle, silent install 12

install U

Citrix 7 uninstall 8

locally 7 silently 16

parameters for silent 12 upgrade 7

Remote Desktop Services 7 V

Toad for Oracle silently 12 VDI 6

M virtualization support 6

MSI files, extracting 11 VMWare 6

N vWorkspace 6

network, silent nstallation 12

parameters, silent install 12

privileges, for installation 5