TOAD Install Guide
TOAD Install Guide
5
Install Guide
iii
United States of America and other countries. Other trademarks and registered trademarks are property of their
respective owners.
Toad for Oracle 10.5
Install Guide
March 22, 2010
iv
Table of Contents
Table of Contents
Table of Contents.................................................................................................................................................1
Installation ............................................................................................................................................................3
Installation Requirements..................................................................................................................................................4
Privileges Required for Installation...........................................................................................................................4
System Requirements ..............................................................................................................................................5
Virtualization.............................................................................................................................................................6
Install or Upgrade Toad for Oracle ...................................................................................................................................7
Installation Types .............................................................................................................................................................7
Full Local ..................................................................................................................................................................7
Network - Server and Client options.........................................................................................................................7
Network Install - Server ...................................................................................................................................8
Network Install - Client (must install server side first)......................................................................................8
Citrix/Terminal Server...............................................................................................................................................9
Silent Installation of Toad for Oracle ................................................................................................................................9
Extract the MSI Installer ...........................................................................................................................................9
Perform the Installation ..........................................................................................................................................10
Full Installation...............................................................................................................................................10
Network Installation .......................................................................................................................................11
Parameters for Silent Installs .................................................................................................................................12
Uninstall Toad for Oracle ...............................................................................................................................................15
How Uninstalling works for the install types ..................................................................................................16
Silent Uninstall........................................................................................................................................................16
Toad Group Policy Manager ..........................................................................................................................................17
Installation options.........................................................................................................................................17
Upgrading Group Policy Manager .................................................................................................................18
Configuration .....................................................................................................................................................19
Configure Toad for Oracle...............................................................................................................................................20
Troubleshoot Toad for Oracle ........................................................................................................................................20
Cannot connect to Personal Oracle .......................................................................................................................20
Index ................................................................................................................................................................... 25
1
Installation
Contents
Installation Requirements
Install or Upgrade Toad for Oracle
Uninstall Toad for Oracle
Silent Installation of Toad for Oracle
Toad Group Policy Manager
Installation Requirements
Before beginning installation, review this section to ensure required privileges are set
and system requirements are met.
You can install Toad from a CD-ROM or installation files you have downloaded from
the Quest Software, Inc. web site, www.quest.com.
Before installing Toad, make sure that your system meets the minimum hardware and
software requirements. Also check your SQL*Net or Net8 setup with another
application, such as Oracles tnsping utility, to verify your connection with the database.
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.
Chapter 1
Installation
System Requirements
Component
Requirement
Memory
Operating
System
Windows 2000
Windows XP
Windows 2003
Windows Vista
Windows 2008
Windows 7
Note
Database Client
Component
Requirement
Database Server
Note
Cloud Database
Service
Additional
Software
Web Browser
Microsoft Internet Explorer 6.0 or later
PDF Viewer
Adobe Acrobat Reader 7.0 or later (for viewing the Install
Guide)
Virtualization
Review the following information about using Toad in virtual environments:
Application
Desktop (VDI)
Server
Toad has been tested with VMWare ESX Server 3.5 and
VMWare Server Console 1.0.10 on Windows Server 2003
(Server Pack 2).
Note
Toad may work in virtualization environments other than the ones in which it was tested.
Chapter 1
Installation
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.
Installation Types
Full Local
This is the default choice. This installation is a full client and server install. This installs
all Toad files to your local hard drive. In addition to the standard installation folder,
personal configuration files are placed in the Documents and Settings/username/Toad
for Oracle/User Files directory.
If you are installing Toad as a network installation, the Toad license key is written to the
server. On the client side, Toad will prompt you for a license key the first time it runs. The
server should not be read-only when Toad is run for the first time.
The format of licensing keys changed with Toad 10. If you are upgrading and using an old
Quest key, the Server will still require a key, which the Client then reads and compares to
the local key.
If this is the first time you are installing Toad, all licensing will be done from the client side:
you will not require a key to install Toad on the server, however, client machines will prompt
for a key the first time Toad is launched.
If you are upgrading Toad and using a license key issued with a previous versions, license
keys for the Client install and the Server installation must be the same. If users have
Chapter 1
Installation
independent license keys, they should install the full version of Toad on their individual
machine.
If you are creating a completely new server/client installation, then all licensing will be done
from the client side, and you will be prompted for a key the first time you launch Toad.
Citrix/Terminal Server
You can configure a silent install in the same manner you would any MSI command line
installation. Extract the installers as described in Extract the MSI Installer.
Review the following for additional information about installing Citrix:
Under Toad.exe Properties | Compatibility tab | User Account Privileges, make
sure the Allow non-administrators to run this program box is checked.
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.
All user files are stored in a user_name directory. When a Citrix user opens Toad
for the first time, Toad will copy the contents of this folder to the users associated
Application Data folder for Toad.
10
The Quest installer launches in extract mode, and all references to installing will
be replaced with extracting.
2 Change the path for the extracted files if desired. The default path is the current
selected.
4 Review your selections on the Summary and Confirmation screen. If you want to
change a selection, click the Back button and make your changes. Then click
Extract.
5 Select one of the two hyperlinks to continue:
Specified Location - opens the directory where your files have been extracted.
Readme.txt - opens the extraction log in Notepad.
Note
The extraction log contains verification of the files that have been extracted, along
with the command line parameters needed to perform default installations of the
products.
Full Installation
In general, the Windows internal command msiexec.exe launches the MSI and passes
command line parameters set by the user. A typical command line might look like this:
msiexec /i "<path to msi file, including file name>"
INSTALLDIR="<installation folder, including final \>" ADDLOCAL=Client,Server
/q /l*v <path to install log, including file name>
Chapter 1
Installation
11
For example:
msiexec /i "C:\Documents and Settings\johndoe\desktop\ToadforOracle97.exe
"INSTALLDIR="C:\Programs\Quest Software\Toad for Oracle"
ADDLOCAL=Client,Server /q /l*v "C:\install.log"
Note
INSTALLDIR must include the final \ in order for a silent installation to be performed, and
correct spacing between parameters is required for proper installation.
Network Installation
For a silent network install, you would first extract the MSI from the Quest Installer
then install the server side with a command similar to:
msiexec /i "<path to msi file, including file name>"
INSTALLDIR="<installation folder, including final \>" ADDLOCAL=Server /q
/l*v <path to install log, including file name>
For example:
msiexec /i "C:\Documents and Settings\johndoe\desktop\ToadforOracle97.exe"
INSTALLDIR="Z:\Programs\Quest Software\Toad for Oracle" ADDLOCAL=Server /q
/l*v "C:\install.log"
Then install the client side by running a command line that looks like the following:
msiexec /i "<path to msi file, including file name>"
INSTALLDIR="<installation folder, including final \>" ADDLOCAL=Client
SERVERDIR="<path to server folder, including final \>" /q /l*v <path to
install log, including file name>
Where SERVERDIR is the same as INSTALLDIR from the previous command that
silently installed the server side.
For example:
msiexec /i "C:\Documents and Settings\johndoe\desktop\ToadforOracle97.exe"
INSTALLDIR="C:\Programs\Quest Software\Toad for Oracle" ADDLOCAL=Client
SERVERDIR="Z:\Programs\Quest Software\Toad for Oracle" /q /l*v
"C:\install.log"
Note
Both INSTALLDIR and SERVERDIR must include the final \ in order for a silent installation
to be performed, and correct spacing between parameters is required for proper installation.
12
Value
Client, Server
Meaning
Determines the type of install. Parameters
denote:
/i
Package|ProductCode
/f
[p|o|e|d|c|a|u|m|s|v]
Package|ProductCode
Chapter 1
Installation
Parameter
Value
Meaning
s - Overwrites all existing shortcuts.
v - Runs from source and re-caches the
local package. Do not use the v reinstall
option for the first installation of an
application or feature.
/a
Package
/x
Package/ProductCode
Uninstalls a product.
/j
[u|m]Package
or
[u|m]Package/
tTransform List
or
[u|m]Package/
gLanguageID
g - Language identifier.
t - Applies transform to advertised package.
13
14
Parameter
/L
Value
Meaning
Chapter 1
Installation
Parameter
/q
Value
n|b|r|f
15
Meaning
Sets user interface level.
q , qn - No UI
qb - Basic UI. Use qb! to hide the Cancel
button.
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 is not
displayed if the user cancels the
installation. Use qb+! or qb!+ to hide the
Cancel button.
qb- - Basic UI with no modal dialog boxes.
Please note that /qb+- is not a supported UI
level. Use qb-! or qb!- to hide the Cancel
button.
Note
RESTRICTIONS
16
To uninstall Toad:
From Start | Programs | Quest Software | Quest Installer, select the Quest
Installer, and then follow the instructions for uninstalling the appropriate
program.
-OR Go to Add/Remove Programs in Windows and remove Toad.
Note
If a network administrator maintains server components, they will not be uninstalled. The
network Toad components will have to be manually deleted.
Silent Uninstall
Silently uninstalling the MSI is similar to a Silent Install. Use an "x" in place of the "i"
and do not include the INSTALLDIR property, i.e.:
msiexec /x "C:\Documents and Settings\
johndoe\Desktop\ToadforOracle91SetupFull.msi" /q
Chapter 1
Installation
17
Installation options
You can install the Group Policy Manager in one of three ways:
Full Install - Installs the Group Policy Server and the Group Policy Editor to the
same location.
Group Policy Server - Installs only the Group Policy Server.
18
If you want to use the server and the editor from the same machine, you must select the Full
install option. Otherwise the installed parts will not be able to communicate.
2
Configuration
Contents
Configure Toad for Oracle
Troubleshoot Toad for Oracle
20
detailed help.
PATH Environment
The most frequent cause of problems is the resetting of the PATH environment variable.
To set your default Oracle home, you can use the Oracle Home selector (provided with
Oracle) to set it accurately. Refer to your Oracle documentation for more information.
Chapter 2
Configuration
21
Support
If you have questions about using Toad, and you cant find the answers in this guide or
Toad Help, please contact the customer support staff. The Help|Support Bundle
provides updated support information and tools for contacting support.
The information it contains will be useful for support when resolving issues and you
should include this support information with emails to Quest Support. The Support
Bundle window is discussed in detail in the Toad Help.
22
A
Appendix: Contact Quest
Contact Quest Support
Quest Support is available to customers who have purchased a commercial or trial
version of Quest software and have a valid maintenance contract. Quest Support
provides around the clock coverage with SupportLink, our web self-service. Visit
SupportLink at: http://support.quest.com.
With SupportLink, you can do the following:
Quickly find thousands of solutions (Knowledgebase articles/documents).
Download patches and upgrades.
Seek help from a Support engineer.
Log and update your case, and check its status.
View the Global Support Guide for a detailed explanation of support programs, online
services, contact information, and policy and procedures. The guide is available at:
http://support.quest.com/pdfs/Global Support Guide.pdf.
Note
24
Web site
www.quest.com
Refer to our web site for regional and international office information.
About Quest
Now more than ever, organizations need to work smart and improve efficiency. Quest
Software creates and supports smart systems management productshelping our
customers solve everyday IT challenges faster and easier. Visit www.quest.com for
more information.
Index
A
configuration 12
requirements
hardware 9
installation 8
software 9
roles
for installation 8
hardware requirements 9
software requirements 9
support (technical)
contact 13
system requirements 8
hardware 9
privileges 8
software 9
access 12
I
installation 10
hardware requirements 9
requirements 8
software requirements 9
installlation
roles and privileges required 8
launch 12
technical support
contact 13
troubleshoot 12
privileges
for installlation 8
product registration 10
R
registration 10
uninstall 10
upgrade 10