User Guide
Toad™ for Oracle® 12.7
Installation Guide
©
2015 Dell 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 Dell Software Inc.
The information in this document is provided in connection with Dell Software 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 Dell
Software products. EXCEPT AS SET FORTH IN DELL SOFTWARE’S TERMS AND CONDITIONS AS SPECIFIED IN THE LICENSE
AGREEMENT FOR THIS PRODUCT, DELL SOFTWARE 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 DELL 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 DELL SOFTWARE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Dell Software
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. Dell Software 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:
Dell Software Inc.
Attn: LEGAL Dept
5 Polaris Way
Aliso 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, SQL
Optimizer for Oracle, Code Tester for Oracle, Spotlight on Oracle, Benchmark Factory, and Dell Backup Reporter for Oracle
are trademarks of Dell Inc. and/or its affiliates. Other trademarks and trade names may be used in this document to refer to
either the entities claiming the marks and names or their products. Dell disclaims any proprietary interest in the marks and
names of others.
Legend
CAUTION: A CAUTION icon indicates potential damage to hardware or loss of data if instructions are
not 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 Guide
Updated - June 2015
Software Version - 12.7
Toad for Oracle 12.7
Installation Guide
2
Contents
Overview of Toad for Oracle
4
System Requirements
5
About these requirements
5
System requirements
5
Database requirements
6
Additional requirements
7
Virtualization support
7
Windows Privileges
7
Install Toad for Oracle
9
Toad for Oracle installation options
9
Installation guidelines
9
Preinstallation instructions for Citrix or Remote Desktop Services
10
Install Toad silently from the command line
10
Run the silent installation
10
Install licenses
11
Command-line options
12
Install Toad as read-only
14
Post-installation tasks
15
Apply license keys to bundled products
15
Import user settings
15
Uninstall Toad for Oracle
17
Uninstall through Windows
17
Uninstall Toad silently
17
About Dell Software
18
Contacting Dell Software
18
Technical support resources
18
Toad for Oracle 12.7
Installation Guide
3
1
Overview of Toad for Oracle
Toad for Oracle provides an intuitive and efficient way for database professionals of all skill and experience
levels to perform their jobs with an overall improvement in workflow effectiveness and productivity. With Toad
for 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
l
l
Deploy high-quality applications that meet user requirements and perform predictably and reliably
in production
Validate database code to ensure the best-possible performance and adherence to bestpractice standards
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 various
communities like Toad World have made it the most powerful and functional tool available. With an installed
base of over two million, Toad for Oracle continues to be the “de facto” standard tool for database
development and administration.
Toad for Oracle 12.7
Installation Guide
4
2
System Requirements
About these requirements
These are the system requirements for Toad for Oracle. Additional system requirements for the products that
are bundled in the Toad Editions and Toad Suites are in the Toad for Oracle Suites Release Notes on
http://documents.software.dell.com/toad-for-oracle/.
System requirements
Requirement
Details
Memory
32-bit: 1 GB RAM
64-bit: 2 GB RAM
NOTE: The memory required may vary based on the following: Hard disk space
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
120 MB - Toad for Oracle 32 bit
150 MB - Toad for Oracle 64 bit
Operating system
Windows Server 2003 (32-bit and 64-bit)
Windows XP
NOTE: Windows XP does not support the Oracle 12c client. Use an earlier
client 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)
Toad for Oracle 12.7
Installation Guide
5
Requirement
Details
Windows Server 2012 R1 and R2 (64-bit)
Database requirements
Requirement
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 Oracle
client, and the 64-bit version of Toad with the 64-bit Oracle client.
Database server
Oracle versions:
8.0.6
8.1.7
9i, 9i R2
10g, 10g R2
11g, 11g R2
12c
Exadata
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 database service
Oracle databases running on Amazon EC2
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,
which are used by the current IPv4 to route packets over the Internet.
Toad for Oracle features, such as FTP, access the Internet through thirdparty vendors that are IPv6 compliant, such as /nSoftware's IP*Works. For
access to Web sites by way of the Toad Online window, Toad simply
invokes the user-defined or default Web browser.
Toad for Oracle 12.7
Installation Guide
6
Additional requirements
Requirement
Details
Additional Software
l
l
l
Microsoft Internet Explorer 6.0 or later (to view video from the
Jump list within Toad, and to view the product documentation in
HTML format).
Adobe Acrobat Reader 7.0 or later (to view the product
documentation in PDF format).
Microsoft .NET Framework 4.0 to support the Toad for Oracle®
2015 Suites Installer.
Virtualization support
Type
Details
Application virtualization
Citrix® XenApp 5.0 and 6.5 have been tested.
Desktop virtualization (VDI)
Dell™ vWorkspace™ 7.0 has been tested.
Server virtualization
Oracle VM 3.1 has been tested.
VMware ESX Server 3.5, 4.0, and 5.5 have been tested.
NOTE: Toad may work in virtualization environments other than the ones listed.
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
Windows Server
l
Read access to the Oracle client folder
Read/write privileges on the Oracle Home 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
Windows 8
l
Read/write privileges on the Oracle Home directories that you use
for your connections
Read access to the Oracle client folder
Toad for Oracle 12.7
Installation Guide
7
Operating System
Windows Server 2012
Requirements
l
Read/write privileges on the Oracle Home directories that you use
for your connections
NOTE: Other functionality in Toad may require additional privileges.
Toad for Oracle 12.7
Installation Guide
8
3
Install Toad for Oracle
Toad for Oracle installation options
You 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 other
products of a Toad edition or suite. This installer is available in the following formats:
l
l
Web-based installer: This installer is a web-based thin client that automatically detects and downloads
the correct Toad installation files, based on your license key. At the same time, the installer detects
any other available Dell products in the edition or suite and allows you to select the ones to download
and install.
Full installer: This installer contains all of the installation files required to install Toad for Oracle and
any 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 installation
programs from a central server to multiple users.
To install Toad from this installer, see the Toad for Oracle2015 Suites Installation Guide at
http://documents.software.dell.com/toad-for-oracle/.
Silent installation
You can perform a silent installation of Toad by running a standalone MSI installer. See Install Toad silently
from the command line in this guide.
Read-only installation
You can install a read-only version of Toad by running the special read-only installer. See Install Toad as readonly in this guide.
Installation guidelines
l
l
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.
If you also have the freeware version of Toad, do 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.
Toad for Oracle 12.7
Installation Guide
9
l
l
Toad automatically imports your settings files if the new version is within two releases of the previous
version. If your versions are more than two releases apart, install an intermediate version to
successfully import the files, and then upgrade to this version.
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 or
Remote Desktop Services
All Toad 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 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 by
using 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 the
Allow non-administrators to run this program option is selected under Compatibility | User Account
Privileges.
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 silently from the command line
A silent installation enables you to deploy Toad and other suite products to multiple machines. To install
silently, you download an MSI file and then execute command-line parameters to install one product at a time.
You can change the parameters to fit your environment or standards, such as installing to a different directory.
These instructions are for performing a silent installation of Toad for Oracle and, optionally, installing licenses
on the target computers. To perform a silent installation of other products that are provided with your Toad
edition or suite, see the installation guide for that product on https://documents.software.dell.com.
Run the silent installation
1. Go to https://support.software.dell.com/toad-for-oracle/download-new-releases.
2. From the list of installers under MSI Installers (Special Installations Only), download the Toad for
Oracle 2015 Suites zip file that is appropriate for the processor type of the computer.
3. Extract the file to a folder of your choosing.
Toad for Oracle 12.7
Installation Guide
10
4. From the Windows command prompt, run the Toad for Oracle MSI file. The basic command to run a silent
installation is the following:
msiexec /i "full path to MSI file"
Example
msiexec /i " C:\Users\jdoe\Downloads\ToadForOracle_12.7.0.111_x86_En.msi"
See Command-line options for additional options.
Install licenses
To install licenses on the target computers, you do the following:
l
Create a Questkey.reg text file to specify each license key.
l
Send the file to the target PC and import it to the Registry there.
To create the Questkey.reg file
Create the Questkey.reg file in a text editor. The following is a template:
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"
Follow these steps to configure the file:
1. Do not change the first two HKEY_CURRENT_USER lines. They are the key entries.
2. Replace the “REPLACE_WITH_(KEY | SITEMESSAGE | PRODUCTNAME | PRODUCTVERSION)" text with the
relevant information supplied with your license.
3. Add any additional licenses as required in the same file by replicating the last four lines and then
applying the correct information.
4. Save the file.
To apply the file on the target computer
1. Transfer the Questkey.reg file to the target PC.
2. Import the file to the Registry on the target PC with the following command in the Windows
command prompt:
C:\> reg import Questkey.reg
When the user runs Toad and any product installed with Toad, the software validates the license and removes
the entries from the Registry.
Toad (and any other product) is ready for use when the license is validated.
Toad for Oracle 12.7
Installation Guide
11
Command-line options
You can use the following command-line parameters when you silently install Toad for Oracle:
Option
Parameter
Description
/l
Package|ProductCode
Installs or configures the product.
/f
[p|o|e|d|c|a|u|m|s|v]
Repairs the product. This option ignores any property
values entered in the command-line. The default
argument list for this option is 'omus.' The following
options are available:
Package|ProductCode
l
l
l
l
l
l
l
l
l
l
p—Reinstalls only if a file is missing.
o—Reinstalls if a file is missing or an older version
is installed.
e—Reinstalls if a file is missing or an equal or
older version is installed.
d—Reinstalls if a file is missing or a different
version is installed.
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.
a—Forces all files to be reinstalled.
u—Rewrites all required, user-specific registry
entries.
m—Rewrites all required, computer-specific
registry entries.
s—Overwrites all existing shortcuts.
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 in the specified
path. The path to the logfile location must already exist.
Logfile
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.
Toad for Oracle 12.7
Installation Guide
12
Option
Parameter
Description
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
l
+—Append to existing file.
l
!—Flush each line to the log.
l
/q
n|b|r|f
x—Extra debugging information. Only available on
Windows Server 2003.
"*"—Log all information except for the v and x
options. To include the v and x options, enter
"/l*vx".
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
l
l
l
l
qr—Reduced UI with no modal dialog box
displayed at the end of the installation.
qf—Full UI and any authored FatalError, UserExit,
or Exit modal dialog boxes at the end.
qn+—No UI except for a modal dialog box
displayed at the end.
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.
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 12.7
Installation Guide
13
Option
Parameter
Description
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 Toad as read-only
A Read-only version of Toad for Oracle prevents the user from making any changes to the database, regardless
of his or her Oracle privileges. Dell provides a read-only installer in 32-bit and 64-bit versions. You must have
the appropriate license for a read-only version of Toad.
To install Toad for Oracle Read-Only
1. Obtain the license key and site message text for your installation.
2. Go to https://support.software.dell.com/toad-for-oracle/download-new-releases.
3. From the Read-only Edition list, download the executable file that is appropriate for the processor
type of the computer.
4. If you want to install other products that are bundled with your Toad Edition or Suite:
a. Download the appropriate Toad for Oracle 2015 Suites installer from the Web Installer or Full
Installer list.
b. Run the suites installer to install all of the desired products except Toad for Oracle. For help,
see the Toad for Oracle 2015 Suites Installation Guide at
http://documents.software.dell.com/toad-for-oracle/.
5. Run the Toad for Oracle Read-only installer.
6. Select Toad for Oracle processor-type Read Only. (This is the only option in that installer.)
7. Click Install.
Toad for Oracle 12.7
Installation Guide
14
4
Post-installation tasks
Apply license keys to bundled products
All products within a Toad edition or suite 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.
If you have previously licensed versions of Toad for Oracle or the other products in this edition or suite, your old
license keys will continue to work. If you are upgrading to a different edition or suite and have been issued a
new 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 settings
If 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. If
your versions are more than two releases apart, you need to install an intermediate version to successfully
import 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 of
Toad, 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 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.
4. Select Utilities | Copy User Settings in the main Toad toolbar.
5. Click
then navigate to the copied folder.
Toad for Oracle 12.7
Installation Guide
15
NOTE: You can also select Utilities | Copy User Settings, then select Create a clean set of user files
from the base installation.
Toad for Oracle 12.7
Installation Guide
16
5
Uninstall Toad for Oracle
Uninstall through Windows
1. Open the Programs and Features control panel in Windows.
2. Select the Toad for Oracle entry, then select Uninstall.
3. Click OK.
Uninstall Toad silently
The following is the basic command to uninstall Toad silently:
msiexec /x "path_to_msi_file\ToadForOracle_version_x86_En.msi" /q
See Command-line options for additional command options.
Toad for Oracle 12.7
Installation Guide
17
About Dell Software
Dell listens to customers and delivers worldwide innovative technology, business solutions and services they
trust and value. For more information, visit www.software.dell.com.
Contacting Dell Software
Technical Support:
Online Support
Product Questions and Sales:
(800) 306-9329
Email:
info@software.dell.com
Technical support resources
Technical support is available to customers who have purchased Dell software with a valid maintenance
contract and to customers who have trial versions. To access the Support Portal, go to
http://software.dell.com/support/.
The Support Portal provides self-help tools you can use to solve problems quickly and independently, 24 hours
a day, 365 days a year. In addition, the portal provides direct access to product support engineers through an
online 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.7
Installation Guide
18
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertising