ToadforOracle 115 DBA Suite Installation Guide
ToadforOracle 115 DBA Suite Installation Guide
5
Installation Guide
2012 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 NONINFRINGEMENT. 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 Softwares trademarks, please see http://www.quest.com/legal/trademark-information.aspx. Other trademarks and registered trademarks are property of their respective owners. Toad DBA Suite for Oracle 11.5 Installation Guide April 19, 2012
Table of Contents
Requirements About Toad Editions System Requirements
Virtualization Support
5 5 6
9
Required Windows Privileges Install Toad Editions Install Toad Editions License Toad Editions Silently Install Toad Editions About Installing Silently Extract MSI Files Install through Command Line
Install Toad for Oracle through Command Line Command-Line Parameters (Toad for Oracle) Install Knowledge Xpert through Command Line Install SQL Optimizer through Command Line Install Benchmark Factory through Command Line Install Toad Data Modeler through Command Line Install Toad for Data Analysts through Command Line Install Toad for MySQL through Command Line Install Spotlight through Command Line
10 11 11 12 13 13 13 14
14 15 18 18 19 19 20 21 22
Install Patches Silently Uninstall Toad for Oracle through Command Line Install Product Licenses during Silent Installation
22 22 23
iv
Appendix: Contact Quest Contact Quest Support Contact Quest Software About Quest Software, Inc Index
24 24 24 24 26
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 DBA 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 l l l l l l l l l
Toad for Oracle Xpert DBAdmin Module Add-on Quest SQL Optimizer for Oracle Knowledge Xpert for PL/SQL Knowledge Xpert for Oracle Administration Benchmark Factory for Databases - Oracle Edition Spotlight on Oracle Toad Data Modeler Toad for Data Analysts Base Edition Toad for MySQL Freeware
Important: Knowledge Xpert has been moved to a free online wiki, http://oradbpedia.com. Toad components which use the desktop version of Knowledge Xpert are being changed to reference the online content. Quest recommends using the web version as the desktop version will be desupported on July 31, 2012. 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.
System Requirements
Before installing your Toad Edition, ensure your system meets the following minimum hardware and software requirements: Platform Memory 1 GHz processor (Spotlight requires 1.2 GHz processor) 1 GB RAM required Note: The memory required may vary based on the following:
l l l l
Applications that are running on your system Size and complexity of the database Amount of database activity Number of concurrent users accessing the database
By Toad Edition: 2.08 GB By Product: 88 MB 90 MB 78 MB 78 MB 1 GB 120 MB 160 MB 1.33 GB 133 MB Toad for Oracle Quest SQL Optimizer for Oracle Knowledge Xpert for PL/SQL Knowledge Xpert for Oracle Admin Spotlight on Oracle Benchmark Factory for Databases - Oracle Edition Toad Data Modeler Toad for Data Analysts Base Edition Toad for MySQL Freeware Toad DBA Suite for Oracle and Toad DBA Suite for Oracle RAC Edition
Operating System
Windows Server 2003 (32-bit and 64-bit) Windows XP (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 32bit Oracle Client. Exception: Spotlight: Windows XP and Windows Vista require Service Pack 1 or later
Database 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 Server
Oracle 8.0.6; 8.1.7; 9i; 9i R2; 10g R1; 10g R2; 11g R1, 11g R2 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 l l l l
SQLOptimizerRequires 8.1.7 or later SpotlightRequires 9.2.0.4 or later and SQL*Net 2.3.4 or later Toad for Data AnalystsRequires 9i or later Toad Data ModelerRequires 9i or later Toad for MySQL FreewareDoes not support Oracle. See its Release Notes for supported servers.
Knowledge XpertHas not been tested 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 userdefined or default Web browser. Microsoft Internet Explorer 6.0 or later (to view the Release Notes) Adobe Acrobat Reader 7.0 or later (to view the Installation Guide) SQL Optimizer: For Windows 2003 or XP, Microsofts .NET Framework 2.0 (Service Pack 1 or 2), or 3.5 is required. Note: If you have only the .NET Framework 3.0 installed, you must also install .NET Framework 2.0 and the service pack or you must install .NET Framework 3.5 (which includes .NET 2.0 with Service Pack 1). For Windows Vista, Windows 2008, and Windows 7, the necessary .NET
Additional Software
Framework 2.0 files come preinstalled with the operating system. Spolight on Oracle: Microsoft .NET Framework 3.5 (Service Pack 1 or later) Toad for Data Analysts and Toad for MySQL Freeware: Microsoft .NET Framework 3.5 (Service Pack 1) Note: The following conditions apply:
l
If you have the .NET Framework 4.0 installed, you must still install the .NET Framework 3.5 (Service Pack 1). The .NET Framework Client Profile is not supported. To run Toad for Data Analysts, the .NET security policy must be set to unrestricted.
l l
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 [65536 colors].) RAC edition supports up to 16 instances in a cluster, with a theoretical limit of 36 instances.
Virtualization Support
Before installing your Toad Edition, review the following for virtualization support: Application Virtualization Citrix XenApp 5.0 has been tested. Exceptions:
l l l
Knowledge XpertHas not been tested Benchmark FactoryHas not been tested SpotlightSpotlight has been tested for Citrix support on Windows Server 2003 Enterprise Server (Service Pack 2) using the MetaFrame Presentation Server 5.0 and Citrix Presentation Server Clients 10.2
Knowledge XpertHas not been tested Toad for MySQLHas not been tested Benchmark FactoryHas not been tested SpotlightHas been tested on VMware Workstation
Server Virtualization
Knowledge XpertHas not been tested Toad Data Modeler has been tested using VMware Server 2.0 Toad for Data AnalystsHas not been tested Toad for MySQLHas not been tested SQLOptimizer has been tested using VMware ESX Server 2.0.2 and Oracle VM 2.0 Benchmark FactoryHas not been tested
Note: Toad Editions may work in virtualization environments other than the ones listed.
10
Read access to the Oracle client folder Read/write privileges on the Oracle homes directories that you use for your connections Be a Power User or Administrator Read access to the Oracle client folder Read/write privileges on the Oracle homes directories that you use for your connections If UAC (user account control) is enabled, you must have administrator privileges
l l
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. 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" (page 13) for more information.
To install a Toad Edition 1. Run the Toad Edition installation program. 2. Complete the wizard.Review the following for additional information: Destination directory Select a directory to install the applications in your Toad edition. The default directory is C:\Program Files\Quest Software. Note: This directory sets the base directory for the installation of all Quest products. Individual Products Expand a product in the product list to select additional installation features such as install type, installation directory, and so on. Note: For additional information about other products, see the appropriate product Installation Guide.
Toad DBA Suite for Oracle Installation Guide Install Toad Editions
12
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. See "Extract MSI Files" (page 13) for more information. 2. Silently install the products. Select one of the following options: Run silent install batch file Run SilentInstall.bat to install all of the selected products. This 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 command line Execute command-line parameters to install one product at a time. This option allows you to change the parameters to fit your environment or standards, such as installing to a different directory. See "Install Toad for Oracle through Command Line" (page 14) for more information.
Toad DBA Suite for Oracle Installation Guide Silently Install Toad Editions
14
2. Complete the wizard.Review the following for additional information: Product Selection Page Select the product you want to extract Finish Page "specified location" link Description
Verify that all the products you want to extract display in this list. If a product does not display, you should start over and select an edition that contains all the files. Description Click this link to open the directory where your files have 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" link
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. This option allows you to change the parameters to fit your environment or standards, such as installing to a different directory. See "Install Toad for Oracle through Command Line" (page 14) for more information.
Toad DBA Suite for Oracle Installation Guide Silently Install Toad Editions
15
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.5.exe"INSTALLDIR="C:\Programs\Quest Software\Toad for Oracle" ADDLOCAL=Client,Server/q /l*v "C:\install.log"
pReinstalls only if a file is missing. oReinstalls if a file is missing or an older version is installed. eReinstalls if a file is missing or an equal or older version is installed. dReinstalls if a file is missing or a different version is installed. 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. aForces all files to be reinstalled. uRewrites all required, userspecific registry entries.
Toad DBA Suite for Oracle Installation Guide Silently Install Toad Editions
16
Option
Parameter
Description
l
mRewrites all required, computer-specific registry entries. sOverwrites all existing shortcuts. vRuns from source and recaches the local package. Do not use this option for the initial installation of the product or feature.
/a /x /l
Installs the product on the network. Uninstalls the product. Writes logging information to a 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 l l l l l l l
iStatus messages. wNonfatal warnings. eAll error messages. aStart up of actions. rAction-specific records. uUser requests. cInitial UI parameters. mOut-of-memory or fatal exit information. oOut-of-disk-space messages. pTerminal properties. vVerbose output. xExtra debugging information. Only available on Windows Server 2003. +Append to existing file. !Flush each line to the log.
l l l l
l l
Toad DBA Suite for Oracle Installation Guide Silently Install Toad Editions
17
Option
Parameter
Description
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
q, qnNo UI qbBasic UI. Use qb! to hide the Cancel button. qrReduced UI with no modal dialog box displayed at the end of the installation. qfFull 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 DBA Suite for Oracle Installation Guide Silently Install Toad Editions
18
Toad DBA Suite for Oracle Installation Guide Silently Install Toad Editions
19
where /i = install /qn = quiet, no UI To silently install SQL Optimizer through the command line (custom directory) 1. Extract the MSI from the Quest Installer. See "Extract MSI Files" (page 13) for more information. 2. Enter the following command:
msiexec /i "<path to msi file\QuestSQLOptimzer_Oracle_version.msi>" /qn
INSTALLDIR="InstallDir" Note: Use the INSTALLDIR parameter if you are upgrading and would like to have both the current version and the new version installed. Otherwise, the upgrade overwrites the current version.
Where version is the full version, including the build number (for example, 6.0.0.147).
The argument for the silent installation from a command-line is /q. To specify a directory where Toad Data Modeler should be installed, use INSTALLDIR=PATH. (Otherwise, the default path is used.)
Toad DBA Suite for Oracle Installation Guide Silently Install Toad Editions
20
To specify the database platform where you want to install Toad Data Modeler or which shortcuts should be created and where, use the ADDLOCAL parameter. If this parameter is not used, a default installation is performed. Example:
setup.msi /q INSTALLDIR="C:\Program Files\Quest Software\Toad Data Modeler version \ADDLOCAL=Complete,XPMANIFEST,SUPPORTDATABASES,SHORTCUTUNINSTALL, SHORTCUTDESKTOP,SHORTCUTSTARTMENU,SHORTCUTQUICKLAUNCH,SHORTCUTHELP, POSTGRESQL,POSTGRESQL81,POSTGRESQL82
If you use the ADDLOCAL parameter, always select the Complete, XPMANIFEST, and SUPPORTDATABASES options. These options are required for the correct installation. When installing support for a particular database platform, you must install basic support for the selected database platform. For example, to support the Oracle 10g database, Oracle must also be selected. Shortcuts You can use the following to create shortcuts when installing silently: Command SHORTCUTUNINSTALL SHORTCUTDESKTOP Description Creates a shortcut for uninstall in the Start menu. Creates a shortcut for Toad Data Modeler on the desktop. Creates a shortcut for Toad Data Modeler in the Start menu. Creates a shortcut for Toad Data Modeler in the Quick Launch bar. Creates a shortcut for the Help file, User Manual, and Reference Guide in the Start menu.
SHORTCUTSTARTMENU
SHORTCUTQUICKLAUNCH
SHORTCUTHELP
Tip:Other parameters for silent installs can be found if you enter the setup.msi ? command.
Microsoft .NET Framework 3.5 (Service Pack 1) (Existing DB2client on system) Toad for Data Analysts installs a DB2 9.7 client as part of the installation process. The DB2 9.7 client can co-exist with an existing DB2 8 client;
Toad DBA Suite for Oracle Installation Guide Silently Install Toad Editions
21
however, it is incompatible with a DB2 7 client. If a DB2 7 client is already installed on the system, the installation stops and cannot complete. You must first upgrade to the DB2 8 client. Then restart the installation to avoid losing functionality in some DB2 native tools. To silently install Toad for Data Analysts through the command line 1. Extract the MSI from the Quest Installer. See "Extract MSI Files" (page 13) for more information. 2. Enter the following command:
msiexec /i <path to msi file\ToadforDataAnalysts_version.msi> /q
You can use an msi logging switch to include an install log by entering the following:
msiexec /i <path to msi file\ToadforDataAnalysts_version.msi> /q /L*v path_to_verboseLog.txt
You can override the following optional properties: INSTALLDIR READONLY ApplicationUsers Specify a folder other than default installation folder Enter TRUE if you want to install as read-only Enter "AllUsers" to install the product for all users, Enter "OnlyCurrentUser" to install the product only for the user that performs the installation.
The following is an example command to install as read-only for all users to a user selected folder:
msiexec /i path_to_installer.msi INSTALLDIR= Your_install_path READONLY=TRUE ApplicationUsers=AllUsers /q
Toad DBA Suite for Oracle Installation Guide Silently Install Toad Editions
22
Specify a folder other than default installation folder Enter TRUE if you want to install as read-only Enter "AllUsers" to install the product for all users, Enter "OnlyCurrentUser" to install the product only for the user that performs the installation.
The following is an example command to install as read-only for all users to a user selected folder:
msiexec /i path_to_installer.msi INSTALLDIR= Your_install_path READONLY=TRUE ApplicationUsers=AllUsers /q
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 DBA Suite for Oracle Installation Guide Silently Install Toad Editions
23
Do not change the first two lines as they are the key entries to add a license. In the template, replace REPLACE_WITH_???? with the relevant information supplied with your license. 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. 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. Your product(s) are ready for use when the license is validated.
Retrieve thousands of solutions from our Knowledge Base Download the latest releases and service packs 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.
See our web site for regional and international office information.
Toad DBA Suite for Oracle Installation Guide Appendix: Contact Quest
25
from database management, data protection, identity and access management, monitoring, user workspace management to Windows management. For more information, visit www.quest.com.
Index
B Benchmark Factory, command line parameters19
21
Toad for Oracle through command line 14 K Knowledge Xpert, command line parameters18 C L Citrix licenses support E Toad Editions editions M about installing licensing F P files, extract MSI I privileges, for installation install Q Benchmark Factory through command 19 line command-line parameters, Toad for Oracle Knowledge Xpert through command line silently 15 requirements 18 privileges system S silent installation command-line parameters (Toad for Oracle) extract MSI files overview product licenses SilentInstall.bat 11 15 10 6 Quest Installer, extract MSI files R 13 10 13 parameters, command line 15 5 MSI files, extracting 11 N 12 network, silent nstallation 14 13 12 9 install during silent installation 23
11
Spotlight on Oracle through command 22 line SQL Optimizer through command line 18 Toad Data Modeler through command 19 line Toad for Data Analysts through command line 20
13 13 23 13
27
Spotlight on Oracle, command line parameters22 SQL Optimizer, command line parameters18 system requirements T Toad Data Modeler, command line parameters19 Toad for Data Analysts, command line parameters20 Toad for MySQL, command line parameters21 Toad for Oracle, install through command line14 U uninstall silently V VDI virtualization support VMWare vWorkspace 9 9 9 9 22 6