Toad™ for Oracle® 2015 SuitesInstallation Guide

© 2015 Dell Inc.ALL RIGHTS RESERVED.

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

The information in this document is provided in connection with Dell Software products. No license, express or implied, byestoppel or otherwise, to any intellectual property right is granted by this document or in connection with the sale of DellSoftware products. EXCEPT AS SET FORTH IN DELL SOFTWARE’S TERMS AND CONDITIONS AS SPECIFIED IN THE LICENSEAGREEMENT FOR THIS PRODUCT, DELL SOFTWARE ASSUMES NO LIABILITY WHATSOEVER AND DISCLAIMS ANY EXPRESS, IMPLIEDOR STATUTORY WARRANTY RELATING TO ITS PRODUCTS INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTY OFMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL DELL BE LIABLE FORANY 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 INABILITYTO USE THIS DOCUMENT, EVEN IF DELL SOFTWARE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Dell Softwaremakes no representations or warranties with respect to the accuracy or completeness of the contents of this document andreserves the right to make changes to specifications and product descriptions at any time without notice. Dell Software doesnot make any commitment to update the information contained in this document.

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

Dell Software Inc.Attn: LEGAL Dept5 Polaris WayAliso Viejo, CA 92656

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

Trademarks

Dell, the Dell logo, and Dell Knowledge Xpert, Dell vWorkSpace, Dell Toad, T.O.A.D., Toad World, Toad for Oracle, SQLOptimizer for Oracle, Code Tester for Oracle, Spotlight on Oracle, Benchmark Factory, and Dell Backup Reporter for Oracleare trademarks of Dell Inc. and/or its affiliates. Other trademarks and trade names may be used in this document to refer toeither the entities claiming the marks and names or their products. Dell disclaims any proprietary interest in the marks andnames of others.

Legend

CAUTION: A CAUTION icon indicates potential damage to hardware or loss of data if instructions arenot followed.

WARNING: A WARNING icon indicates a potential for property damage, personal injury, or death.

IMPORTANT NOTE, NOTE, TIP,MOBILE, or VIDEO: An information icon indicates supporting information.

Toad for Oracle Installation GuideUpdated - June 2015Software Version - 12.7

Toad for Oracle 12.7Installation Guide

2

Contents

About Toad for Oracle 4

Overview of Toad for Oracle 4

Overview of Toad for Oracle Editions and Suites 4

System Requirements 6

About these requirements 6

System requirements 6

Database requirements 7

Additional requirements 8

Virtualization support 9

Windows Privileges 10

Install a Toad for Oracle Edition or Suite 12

Toad for Oracle installation options 12

Installation guidelines 13

Preinstallation instructions for Citrix or Remote Desktop Services 13

Install Toad from the Suites Installer 13

Uninstall products in an Edition or Suite 14

Post-installation tasks 16

Apply license keys to bundled products 16

Import user settings 16

About Dell Software 18

Contacting Dell Software 18

Technical support resources 18

Toad for Oracle 12.7Installation Guide

3

1

About Toad for Oracle

Overview of Toad for OracleToad for Oracle provides an intuitive and efficient way for database professionals of all skill and experiencelevels to perform their jobs with an overall improvement in workflow effectiveness and productivity. With Toadfor Oracle you can:

l Understand your database environment through visual representations

l Meet deadlines easily through automation and smooth workflows

l Perform essential development and administration tasks from a single tool

l Deploy high-quality applications that meet user requirements and perform predictably and reliablyin production

l Validate database code to ensure the best-possible performance and adherence to best-practice standards

l Manage and share projects, templates, scripts, and more with ease

The Toad for Oracle solutions are built for you, by you. Over 15 years of development and feedback from variouscommunities like Toad World have made it the most powerful and functional tool available. With an installedbase of over two million, Toad for Oracle continues to be the “de facto” standard tool for databasedevelopment and administration.

Overview of Toad for Oracle Editions andSuitesEach Toad Edition and Suite is packaged with additional products to expand your Oracle experience. Thefollowing editions and suites are available.

Toad for Oracle Base Edition

l Toad™ for Oracle®

l Toad™ Data Modeler (free use)

l Toad™ for MySQL Freeware

Toad for Oracle Professional Edition

l Toad for Oracle® Professional

l Toad™ Data Modeler (free use)

l Toad™ for MySQL Freeware

Toad for Oracle Xpert Edition

l Toad for Oracle® Xpert

Toad for Oracle Development Suite

l Toad for Oracle® Xpert

Toad for Oracle 12.7Installation Guide

4

Includes all features in Base and ProfessionalEditions

l SQL Optimizer for Oracle®

l Code Tester for Oracle®

l Benchmark Factory™ for Databases - Oracle®

Edition

Toad for Oracle DBA Suite

l Toad for Oracle® Xpert

l DB Admin Module Add-on

l Spotlight™ on Oracle®

Includes Spotlight on Unix/Linux, Spotlight onWindows, and Spotlight on Oracle Data Guard

l Benchmark Factory™ for Databases - Oracle®

Suite

l Toad Data Modeler

l Backup Reporter for Oracle®

Toad for Oracle DBA Suite - RAC Edition

l Toad for Oracle® Xpert

l DB Admin Module Add-on

l Spotlight™ on Oracle® with RAC OptionIncludes Spotlight on Unix/Linux, Spotlight onWindows, and Spotlight on Oracle Data Guard

l Benchmark Factory for Databases - Oracle®

Edition

l Toad Data Modeler

l Backup Reporter for Oracle®

Toad for Oracle DBA Suite - Exadata Edition

l Toad for Oracle® Xpert

l DB Admin Module Add-on

l Spotlight™ on Oracle® with RAC and ExadataOptionsIncludes Spotlight on Unix/Linux, Spotlight onWindows, and Spotlight on Oracle® Data Guard

l Benchmark Factory for Databases - Oracle®

Edition

l Toad Data Modeler

l Backup Reporter for Oracle®

NOTES:

l Knowledge Xpert has been moved to a free online wiki,http://www.toadworld.com/platforms/oracle/default.aspx. Toad components which use the desktopversion of Knowledge Xpert have been updated to reference the online content.

l The DB Admin Module can be added to any Toad Suite and Toad Edition.

Toad for Oracle 12.7Installation Guide

5

2

System Requirements

About these requirementsThese are the minimum system requirements to support the Toad for Oracle edition that you are installing.Also listed are any exceptions to those requirements that are needed to support individual products in youredition or suite. For example, a product may require more memory than Toad for Oracle, or a product may notsupport an operating system or may require a later database version than Toad for Oracle.

System requirementsRequirement Details

Processor 1 GHz processor (Spotlight requires 1.2 GHz processor)

Memory 32-bit: 1 GB RAM

64-bit: 2 GB RAM

Toad Data Modeler requires 512 MB but recommends 4 GB.

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 space By Toad Edition:

800 MB - Toad for Oracle Base Edition

530 MB - Toad for Oracle Professional Edition

625 MB - Toad for Oracle Xpert Edition

1 GB - Toad Development Suite for Oracle

2 GB - Toad DBA Suite for Oracle

2 GB - Toad DBA Suite for Oracle RAC & Exadata Suite

By product:

120 MB - Toad for Oracle 32 bit

Toad for Oracle 12.7Installation Guide

6

Requirement Details

150 MB - Toad for Oracle 64 bit

200 MB - Backup Reporter for Oracle®

120 MB - Benchmark Factory™ for Databases - Oracle Suite

100 MB - Code Tester for Oracle®

1GB - Spotlight™ on Oracle®

180 MB - SQL Optimizer for Oracle® (32-bit)

217 MB - SQL Optimizer for Oracle® (64-bit)

200 MB (400 recommended) - Toad™ Data Modeler

800 MB - Toad™ for MySQL Freeware

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

Windows XP (not supported by Spotlight on Oracle)

NOTE: Windows XP does not support the Oracle 12c client. Use an earlierclient version with this platform.

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 and 8.1 (32-bit and 64-bit)

Windows 2012 (32-bit and 64-bit)

Windows Server 2012 R1 and R2 (64-bit)

NOTE: Individual products may support earlier or later versions ofWindows operating systems. See the individual product release notes athttp://documents.software.dell.com/ProductsAZ.aspx.

Database requirementsRequirement Details

Database client Oracle Client 9.2.0.8

Oracle Client or Instant Client 10.2.0.5

Oracle Client or Instant Client 11.2.0.1/11.2.0.3

Oracle Client or Instant Client 12c (not supported on Windows XP)

NOTE: You must use the 32-bit version of Toad with the 32-bit Oracleclient, and the 64-bit version of Toad with the 64-bit Oracle client.

Database server Oracle versions:

8.0.6

Toad for Oracle 12.7Installation Guide

7

Requirement Details

8.1.7

9i, 9i R2

10g, 10g R2

11g, 11g R2

12c

Exadata

Toad has been tested on Oracle Exadata 2.0 running Oracledatabase 11g R2.

IMPORTANT: It is recommended that your client version be of thesame release (or later) as your database server. This is an Oraclerecommendation to prevent performance issues.

Exceptions by product:

Benchmark Factory requires 9i or later

Code Tester requires 9.2.0.6 or later.

Dell Backup Reporter for Oracle requires 9i or later.

Spotlight requires 9.2.0.4 or later and SQL*Net 3.5 or later.

SQL Optimizer requires 8.1.7 or later.

Toad Data Modeler requires 9i or later.

Toad for MySQL Freeware does not support Oracle. For supportedservers, see the Release Notes athttp://documents.software.dell.com/ProductsAZ.aspx.

Cloud database service Oracle databases running on Amazon EC2

Exception:

Benchmark Factory has not been tested.

IPv6 Internet Protocol Version 6 (IPv6) is being adopted by the US FederalGovernment and industries around the world. In its most basic format,the new protocol uses 128-bit addresses instead of 32-bit addresses,which are 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 that are IPv6 compliant, such as /nSoftware's IP*Works. Foraccess to Web sites by way of the Toad Online window, Toad simplyinvokes the user-defined or default Web browser.

Additional requirementsRequirement Details

Additional Software l Microsoft Internet Explorer 6.0 or later (to view video from theJump list within Toad, and to view the product documentation in

Toad for Oracle 12.7Installation Guide

8

Requirement Details

HTML format).

l Adobe Acrobat Reader 7.0 or later (to view the productdocumentation in PDF format).

l Microsoft .NET Framework 4.0 to support the Toad for Oracle®2015 Suites Installer.

l Microsoft .NET Framework required per product. See the followinglist.

Dell Backup Reporter for Oracle:

.NET Framework version 2.0 through version 3.5

Spotlight on Oracle:

.NET Framework 3.5 (Service Pack 1 or later)

SQL Optimizer:

.NET Framework 4.0 Full Profile

Toad Data Modeler:

NET Framework version 3.5 on first application start.

Toad for MySQL 7.5 Freeware:

l .NET Framework 4.5 required for: Windows Vista SP2, Windows 7,Windows 8, Windows Server 2008 (SP2 or earlier), Windows Server2008 R2, Windows Server 2012

l .NET Framework 4.0 required for: Windows XP, Windows Vista (SP1or earlier), Windows Server 2003

NOTE: This information is provided to aid installation. Toad forMySQL is not tested on Windows XP. Windows Vista (SP1 or earlier),and Windows Server 2003. The .NET Framework 4 Client Profile isnot supported.

Additional requirements Spotlight requires:

l Monitor capable of supporting a resolution of 1280x1024 or larger.You should also set the display to use the 64K color palette (65536colors).

l RAC Suite supports up to 16 instances in a cluster, with atheoretical limit of 36 instances.

Virtualization supportType Details

Application virtualization Citrix® XenApp 5.0 and 6.5 have been tested.

Exceptions by product:

Toad for Oracle 12.7Installation Guide

9

Type Details

l Benchmark Factory: tested with Citrix XenApp 6.5.

l SQL Optimizer: tested with Microsoft Application Virtualization(App-V) 5.0 on Windows 7 and Windows Server 2012.

l Toad™ Data Modeler: tested on the Citric XenApps 6.5 Server.

Desktop virtualization (VDI) Dell™ vWorkspace™ 7.0 has been tested.

Exceptions by product:

l Spotlight: tested on desktop VMware® workstations.

l Toad Data Modeler: To avoid printing problems, the virtual printermust be installed directly on vWorkspace.

l Toad for MySQL: not tested

Server virtualization Oracle VM 3.1 has been tested.

Exceptions by product:

l Benchmark Factory for Databases - Oracle Suite has notbeen tested.

l Spotlight has been tested on VMware ESX server™.

Spotlight supports Oracle Virtualization (OVM). Limitedtesting has been done using Oracle VM 3.0.

l Toad for MySQL has not been tested.

VMware ESX Server 3.5, 4.0, and 5.5 have been tested.

Exceptions by product:

l Benchmark Factory has not been tested.

l Code Tester has not been tested.

l Toad Data Modeler has been tested using VMware Server3.0.

l Toad for MySQL has not been tested.

NOTE: Toad Suites may work in virtualization environments other than the ones listed.

Windows PrivilegesIn order to install and run Toad for Oracle, make a connection, and do basic operations, you must have thefollowing privileges.

Operating System Requirements

Windows XP

Windows Server

l Read access to the Oracle client folder

l Read/write privileges on the Oracle Home directories that you usefor your connections

Toad for Oracle 12.7Installation Guide

10

Operating System Requirements

l Be a Power User or Administrator

Windows Vista

Windows 7

l Read access to the Oracle client folder

l Read/write privileges on the Oracle Home directories that you usefor your connections

Windows 8

Windows Server 2012

l Read access to the Oracle client folder

l Read/write privileges on the Oracle Home directories that you usefor your connections

NOTE: Other functionality in Toad may require additional privileges.

Toad for Oracle 12.7Installation Guide

11

3

Install a Toad for Oracle Edition orSuite

Toad for Oracle installation optionsYou can install Toad in the following ways:

Typical installation

Use the Toad for Oracle 2015 Suites Installer to install Toad for Oracle, along with any or all of the otherproducts of a Toad edition or suite. This installer is available in the following formats:

l Web-based installer: This installer is a web-based thin client that automatically detects and downloadsthe correct Toad installation files, based on your license key. At the same time, the installer detectsany other available Dell products in the edition or suite and allows you to select the ones to downloadand install.

l Full installer: This installer contains all of the installation files required to install Toad for Oracle andany other products of an edition or suite. It detects and shows the products in the edition or suite,based on your license key. This installer supports administrators who need to provide installationprograms from a central server to multiple users.

To install Toad and other products from this installer, see Install Toad from the Suites Installer in this guide.

Special installation

You can download an MSI zip file that contains all of the installer files for the individual products in the Toadedition or suite. You can run these MSI files to perform a silent installation or to satisfy other specialrequirements. See the individual product release notes for instructions.

l Toad for Oracle

l SQL Optimizer for Oracle

l Code Tester for Oracle

l Benchmark Factory for Database

l Spotlight on Oracle

l Toad Data Modeler

l Toad for MySQL

l Backup Reporter for Oracle

Toad for Oracle 12.7Installation Guide

12

Installation guidelinesl Install the 32-bit version of Toad if you are using a 32-bit Oracle client. Install the 64-bit version of Toad

if you are using a 64-bit Oracle client.

l If you also have the freeware version of Toad, do not install the commercial version over the freewareversion. This will adversely affect some functions. Install the commercial version in a different directoryfrom the freeware version.

l Toad automatically imports your settings files if the new version is within two releases of the previousversion. If your versions are more than two releases apart, install an intermediate version tosuccessfully import the files, and then upgrade to this version.

l If you need to import your Toad settings from another computer, you can manually import the settings.See Import user settings.

Preinstallation instructions for Citrix orRemote Desktop ServicesAll Toad user files are stored in a user_name directory. When a user opens Toad for the first time, Toad copiesthe contents of this folder to the user’s associated Application Data folder in the Toad installation folder.

NOTE:Write access is required to the Oracle directory if any of the users want to edit the tnsnames.ora file byusing the TNSNames Editor within Toad.

To install Toad on a Citrix/Remote Desktop Services system

1. Connect to the system as an administrator.

2. Copy the Toad installer to the Citrix/Remote Desktop Services server, if required.

3. Install Toad according to the instructions provided in this guide.

4. Right-click the Toad.exe file in the root installation folder, and then select Properties. Make sure theAllow non-administrators to run this program option is selected under Compatibility | User AccountPrivileges.

5. Repeat these steps 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.

Install Toad from the Suites InstallerUse the Toad for Oracle2015 Suites Installer to install Toad for Oracle, along with any or all of the otherproducts of a Toad edition or suite. This installer is available in the following formats:

l Web-based installer: This installer is a web-based thin client that automatically detects and downloadsthe correct Toad installation files, based on your license key. At the same time, the installer detectsany other available Dell products in the edition or suite and allows you to select the ones to downloadand install.

l Full installer: This installer contains all of the installation files required to install Toad for Oracle andany other products of an edition or suite. It detects and shows the products in the edition or suite,

Toad for Oracle 12.7Installation Guide

13

based on your license key. This installer supports administrators who need to provide installationprograms from a central server to multiple users.

NOTE: To perform a silent or other special installation, see the individual product release notes athttps://documents.software.dell.com.

To install from the Suites installer

1. Obtain your license key and site message text if you have not done so already.

2. Go to https://support.software.dell.com/toad-for-oracle/download-new-releases.

3. Select the appropriate installer for your processor type from either Web Installer or Full Installer(Administration).

l Individuals who want to install on their own computer should select the Web Installer. Thisinstaller downloads quickly and does not place a large file on your system.

l Administrators who must install for multiple users should select the Full Installer.

4. Run the installer.

5. Review the license terms, select I accept these terms, then click Next.

6. If your license key is not shown, click Add to enter your license key and site message, then click Next.

7. Select the products that you want to install.

8. Click Install.

NOTE: When you install Toad and other products as an edition or suite through this installer, the installercreates the following directory structure in Windows Explorer and the Programs menu (this example assumesthree products were installed):

Dell

Toad for Oracle 2015 Suites

Toad for Oracle version

Benchmark Factory version

Code Tester for Oracle version

...

Uninstall products in an Edition or SuiteIf you installed your edition or suite products from the Toad for Oracle 2015 Suites installer, you can uninstallany or all of them at the same time as follows:

1. Open the Programs and Features control panel.

2. Select the Toad for Oracle2015 Suites entry, then select Uninstall. The installer opens and presentsyou with options for removing selected products.

3. Select Toad for Oracle and any other bundled program that you want to remove from the system.

4. Click OK.

If you installed your edition or suite products individually by using the special MSI installers, see the individualproduct release notes for help with uninstalling them.

Toad for Oracle 12.7Installation Guide

14

l Toad for Oracle

l SQL Optimizer for Oracle

l Code Tester for Oracle

l Benchmark Factory for Database

l Spotlight on Oracle

l Toad Data Modeler

l Toad for MySQL

l Backup Reporter for Oracle

Toad for Oracle 12.7Installation Guide

15

4

Post-installation tasks

Apply license keys to bundled productsAll products within a Toad edition or suite share a licensing key. For best results, when you have completedinstallation of your products, run Toad for Oracle first and enter the license key when prompted. This ensuresthat all installed products reflect the appropriate license key.

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

To upgrade an existing license

1. Launch Toad for Oracle.

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

Import user settingsIf you are installing a new version of Toad on the same computer where a previous Toad version is installed,Toad automatically imports your settings if the new version is within two releases of the previous version. Ifyour versions are more than two releases apart, you need to install an intermediate version to successfullyimport the files, and then upgrade to this version.

If your old settings are not located on the same computer as the one where you are installing this version ofToad, use the following procedure to import them.

To import settings from another computer

You need your license key to complete these steps.

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

NOTE: To find the settings folder, select View | Toad Options | General. The folder location is listed inthe 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.

4. Select Utilities | Copy User Settings in the main Toad toolbar.

5. Click then navigate to the copied folder.

Toad for Oracle 12.7Installation Guide

16

NOTE: You can also select Utilities | Copy User Settings, then select Create a clean set of user filesfrom the base installation.

Toad for Oracle 12.7Installation Guide

17

About Dell Software

Dell listens to customers and delivers worldwide innovative technology, business solutions and services theytrust and value. For more information, visit www.software.dell.com.

Contacting Dell SoftwareTechnical Support:Online Support

Product Questions and Sales:(800) 306-9329

Email:info@software.dell.com

Technical support resourcesTechnical support is available to customers who have purchased Dell software with a valid maintenancecontract and to customers who have trial versions. To access the Support Portal, go tohttp://software.dell.com/support/.

The Support Portal provides self-help tools you can use to solve problems quickly and independently, 24 hoursa day, 365 days a year. In addition, the portal provides direct access to product support engineers through anonline Service Request system.

The site enables you to:

l Create, update, and manage Service Requests (cases)

l View Knowledge Base articles

l Obtain product notifications

l Download software. For trial software, go to Trial Downloads.

l View how-to videos

l Engage in community discussions

l Chat with a support engineer

Toad for Oracle 12.7Installation Guide

18