Toad Development Suite

for Oracle 12.1

Installation Guide
 2013 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 purchasers 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: legal@quest.com

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 Softwares
trademarks, please see http://www.quest.com/legal/trademark-information.aspx. Other trademarks
and registered trademarks are property of their respective owners.

Toad Development Suite for Oracle 12.1

Installation Guide
September 04, 2013
Contents
Requirements iv
About Toad Editions iv
System Requirements v
Virtualization Support vi

Required Windows Privileges vii

Install Toad Editions viii
Install Toad Editions viii
License Toad Editions ix
Silently Install Toad Editions x
About Installing Silently x
Extract MSI Files x
Install through Command Line xii
Command-Line Parameters (Toad for Oracle) xii
Install Code Tester through Command Line xv
Install Benchmark Factory through Command Line xvi
Install Patches Silently xvii
Uninstall Toad for Oracle through Command Line xviii
Install Product Licenses during Silent Installation xix
Configure the License File xix

Appendix: Contact Quest xx

 1
Requirements

About Toad Editions

By purchasing one of the Toad for Oracle Editions, you have obtained not only a powerful
Oracle application development tool, but other tools to help you maintain and develop your
Oracle database applications.

This guide is an executive overview of the Toad Development Suite for Oracle. It provides basic
information about installing the products, including system requirements and the use of the
Quest Installer. See the specific Installation Guide for each product for more information about
each application, including troubleshooting information.

The following Quest Software applications are included in this edition:

l Toad for Oracle Xpert

l Quest Code Tester for Oracle

l Benchmark Factory for Databases - Oracle Edition

Promotion: Licensees of the Toad DBA and Development Suite for Oracle are entitled to a
perpetual license of Toad Data Point Professional. To install, please visit the download page on
the Quest Software support portal. License keys for the Toad DBA and Development Suite for
Oracle will enable the use of Toad Data Point Professional..

Note: The DB Admin Module can be added to any Toad edition.

In many cases, if functionality is disabled within Toad for Oracle, you may not have an
appropriate license to use it. When Toad is running, you can see which components are licensed
by selecting Help | About.
Toad Development Suite for Oracle Installation Guide v
Requirements

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

Platform 1 GHz processor

Memory 1 GB RAM required for 32-bit

2 GB RAM required for 64-bit
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 By Toad Edition:

Space
1 GB Toad Development Suite for Oracle

By Product:

120 MB Toad for Oracle 32 bit

150 MB Toad for Oracle 64 bit

100 MB Quest Code Tester for Oracle

120 MB Benchmark Factory for Databases - Oracle Edition

Operating Windows Server 2003 (32-bit and 64-bit)

System Windows XP (32-bit and 64-bit)
Windows Vista (32-bit and 64-bit)
Windows Server 2008 (32-bit and 64-bit) - 2 CPU required
Windows Server 2008 R2 (64-bit) - 2 CPU required
Windows 7 (32-bit and 64-bit)
Windows 8 (32-bit and 64-bit)
Windows Server 2012 (64-bit)
Exception:
64-bit Toad's SQL Tracker requires Windows Vista or later.
Toad Development Suite for Oracle Installation Guide vi
Requirements

Benchmark Factory does not support Windows Server 2008 R2, Windows 8,
or Windows Server 2012.

Database Oracle Client 9.2.0.8

Client Oracle Client or Instant Client 10.2.0.3/10.2.0.4
Oracle Client or Instant Client 11.2.0.1/11.2.0.3
Oracle Client or Instant Client 12c
Note: You must use the 32-bit version of Toad with the 32-bit Oracle client,
and the 64-bit version of Toad with the 64-bit Oracle client.

Database Oracle 8.0.6; 8.1.7; 9i; 9i R2; 10g; 10g R2; 11g, 11g R2, 12c.
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.
Exceptions:
l Code TesterRequires 9.2.0.6 or later

Cloud Oracle databases running on Amazon EC2

Database Exception:
Service
l Benchmark FactoryHas not been tested

IPv6 Internet Protocol Version 6 (IPv6) is being adopted by the US Federal

Government and industries around the world. In its most basic format, the
new protocol uses 128-bit addresses instead of 32-bit addresses used by the
current IPv4 to route packets over the Internet. Toad for Oracle features such
as FTP access the Internet through third-party vendors such as /nSoftware's
IP*Works that are IPv6 compliant. For access to Web sites by way of the
Toad Online window, Toad simply invokes the user-defined or default Web
browser.

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 your Toad Edition, review the following for virtualization support.

Application Citrix XenApp 5.0 and 6.5 have been tested.

Virtualization l Exception: Benchmark FactoryHas not been tested

Desktop Quest vWorkspace 7.0 has been tested.

Virtualization
Toad Development Suite for Oracle Installation Guide vii
Requirements

(VDI) Exception:
l Benchmark FactoryHas not been tested

Server Oracle VM 3.1 has been tested.

Virtualization Exception:
l Benchmark Factory for Databases - Oracle Edition has not been
tested.
VMware ESX Server 3.5 has been tested.
Exception:
l Benchmark FactoryHas not been tested

l Code TesterHas not been tested

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

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 XP l Read access to the Oracle client folder

Windows Server l Read/write privileges on the Oracle Homes directories
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

Windows 8 l Read access to the Oracle client folder

Windows Server 2012 l Read/write privileges on the Oracle Homes directories
that you use for your connections

Note: Other functionality in Toad may require additional privileges.

 2
Install Toad Editions

Install Toad Editions

You can install any or all of the products that are included in your Toad Edition using the
Quest Installer.

Notes:
l See the Quest Installer Release Notes for detailed information about the current version of
the Quest Installer.
l You can also install Toad Edition products silently. Silent installation provides a
convenient method for deploying Toad products to multiple machines. See
"Extract MSI Files"

To install a Toad Edition

1. Run the Toad Edition installation program.

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

Destination Select a directory to install the applications in your Toad edition. The
directory default directory is C:\Program Files\Quest Software.
Note: This directory sets the base directory for the installation of all
Quest products.

Individual Expand a product in the product list to select additional installation

Products features such as install type, installation directory, and so on.
Note: For additional information about other products, see the
appropriate product Installation Guide.
Toad Development Suite for Oracle Installation Guide ix
Install Toad Editions

License Toad Editions

Beginning with Toad 10.1, all products within a Toad edition share a licensing key. For best
results, when you have completed installation of your products, run Toad for Oracle first and
enter the license key when prompted. This ensures that all installed products reflect the
appropriate license key.

Upgrade Existing Licenses

If you have previously licensed versions of Toad for Oracle or the other products in this edition,
your old license keys will continue to work. If you are upgrading to a different edition and have
been issued a new key, use the following procedure.

To upgrade an existing license

1. Launch Toad for Oracle.

2. Select Help | Licensing and enter your new license key. Any new features are enabled
automatically, and any additional Toad products are licensed using this key.
 3
Silently Install Toad Editions

About Installing Silently

In order to perform a silent install, you must first extract the MSI file from the Quest Installer.
Once the extraction completes, you can easily install all of the selected products through the
silent install batch file, or individually install the products through the command line.

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 install silently
1. Extract the MSI from the Quest Installer.

2. Silently install the products. Select one of the following options:

Run silent install Run SilentInstall.bat to install all of the selected products. This
batch file file is located with the extracted MSI files.
This is the easiest option to install silently. It uses all of the
default options to install the products.

Install through Execute command-line parameters to install one product at a

command line time.
This option allows you to change the parameters to fit your
environment or standards, such as installing to a different
directory.

Extract MSI Files

nnTo 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:
Toad Development Suite for Oracle Installation Guide xi
Silently Install Toad Editions

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

"specified Click this link to open the directory where your files have
location" link been extracted. This directory also includes the silent
installation batch file (SilentInstall.bat).
The batch file contains the commands to silently install all the
products that you selected from the relative path. The install
requires the applicable directories from the locations that you
extract to and installs each product to the default directory.

"Readme.txt" Click this link to open the extraction log as well as the
link 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.
This option allows you to change the parameters to fit your
environment or standards, such as installing to a different
directory.
Toad Development Suite for Oracle Installation Guide xii
Install through Command Line

Install through Command Line

To silently install Toad for Oracle through the command line
1. Extract the MSI from the Quest Installer.

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\ToadforOracle12.1.exe"
INSTALLDIR="C:\Programs\Quest Software\Toad for Oracle"
ADDLOCAL=Client,Server /q /l*v "C:\install.log"

Command-Line Parameters (Toad for Oracle)

nnYou can use the following parameters to silently install Toad for Oracle:

Option Parameter Description

/l Package|ProductCode Installs or configures the product.

Toad Development Suite for Oracle Installation Guide xiii
Install through Command Line

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 pReinstalls only if a file is
missing.
l oReinstalls if a file is missing
or an older version is installed.
l eReinstalls if a file is missing
or an equal or older version is
installed.
l dReinstalls if a file is missing
or a different version is installed.
l cReinstalls 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 aForces all files to be
reinstalled.
l uRewrites all required, user-
specific registry entries.
l mRewrites all required,
computer-specific registry entries.
l sOverwrites all existing
shortcuts.
l vRuns 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.

Toad Development Suite for Oracle Installation Guide xiv
Install through Command Line

Option Parameter Description

/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
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 iStatus messages.

l wNonfatal warnings.

l eAll error messages.

l aStart up of actions.

l rAction-specific records.

l uUser requests.

l cInitial UI parameters.

l mOut-of-memory or fatal exit

information.
l oOut-of-disk-space messages.

l pTerminal properties.

l vVerbose output.

l xExtra 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, qnNo UI

l qbBasic UI. Use qb! to hide

the Cancel button.
Toad Development Suite for Oracle Installation Guide xv
Install through Command Line

Option Parameter Description

l qrReduced UI with no modal

dialog box displayed at the end
of the installation.
l qfFull 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

i Prevents users from accessing the

Internet via Toad by disabling all
Internet access in Toad. This can be
combined with the 'p' parameter; for
example: RESTRICTIONS=p,i

Install Code Tester through Command Line

To silently install Code Tester through the command line
1. Extract the MSI from the Quest Installer.

2. Enter the following command:

Toad Development Suite for Oracle Installation Guide xvi
Install through Command Line

msiexec.exe /i <path to msi file/QuestCodeTester_ version.msi> /qn

Where version is the full version, including the build number (for
example, 1.8.4.447).

You can also specify an install directory by entering the following command:

MSIExec.exe /i <path to msi file/QuestCodeTester_version.msi> /qn

INSTALLDIR="<destination directory>"

Install Benchmark Factory through Command Line

To silently install Benchmark Factory through the command line
1. Extract the MSI from the Quest Installer.

2. Enter the following command:

msiexec.exe /i <path to msi file\BenchmarkFactory_version.msi> /qn

INSTALLDIR=<destination directory>

Where version is the full version, including the build number (for example, 6.0.0.147).
Toad Development Suite for Oracle Installation Guide xvii
Install Patches Silently

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"
Toad Development Suite for Oracle Installation Guide xviii
Uninstall Toad for Oracle through Command Line

Uninstall Toad for Oracle through

Command Line
To silently uninstall Toad through the command line
Enter a command similar to the following:

msiexec /x "<path to msi file\ToadforOracle_version.SetupFull.msi>" /q

Toad Development Suite for Oracle Installation Guide xix
Install Product Licenses during Silent Installation

Install Product Licenses during Silent

Installation
You can install a license as part of the silent install process by pushing a windows registry file
to the target machine and importing it to the registry.

Configure the License File

When a silent install is performed, a License Key template (Questkey.reg) is extracted into the
selected directory. You can use this template to enter the key(s) that you would like to use on
the target PC.

The following represents the contents of the sample registry key:

Windows Registry Editor Version 5.00

[HKEY_CURRENT_USER\Software\{08439167-4CA5-48E9-A810-A3A7C0B80B06}]

[HKEY_CURRENT_USER\Software\{08439167-4CA5-48E9-A810-A3A7C0B80B06}\Local]

[HKEY_CURRENT_USER\Software\{08439167-4CA5-48E9-A810-A3A7C0B80B06}
\Local\REPLACE_WITH_KEY]
"SiteMessage"="REPLACE_WITH_SITEMESSAGE"
"ProductName"="REPLACE_WITH_PRODUCTNAME"
"ProductVersion"="REPLACE_WITH_PRODUCTVERSION"

Review the following to configure the license file:

l Do not change the first two lines as they are the key entries to add a license.

l In the template, replace REPLACE_WITH_???? with the relevant information supplied

with your license.

l Since the license key is used to create a folder in the registry, you can add additional
licenses in the same file by replicating the last four lines.

l The license(s) are ready for use once the Questkey.reg file has been pushed and
imported to the registry and the entries are available on the remote machine.Any
product that is run in the Toad bundle reads and validates the license and removes the
entries from the registry.

l Your product(s) are ready for use when the license is validated.
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 our Support Portal at www.quest.com/support. From our Support Portal,
you can do the following:

l Retrieve thousands of solutions from our Knowledge Base

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 www.quest.com/support.

Contact Quest Software

Email info@quest.com

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, Inc

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.

Established in 1987, Quest Software (Nasdaq: QSFT) provides simple and innovative IT
management solutions that enable more than 100,000 global customers to save time and money
across physical and virtual environments. Quest products solve complex IT challenges ranging
from database management, data protection, identity and access management, monitoring, user
workspace management to Windows management. For more information, visit www.quest.com.