3
Silently Install Toad Editions
Extract MSI Files
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 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 extract MSI files from the Quest Installer
1. Run your Toad bundle from the command prompt, including the correct path to the directory where it resides and the
/extract parameter. Since the executable contains spaces, remember to include quotation marks. For example:
2. Complete the wizard. Review the following for additional information:
Product Selection
Page
Select the product you want to extract
Finish Page
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
Toad for Oracle Xpert Edition Installation Guide
Silently Install Toad Editions
12
"specified location" link
"Readme.txt" link
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.
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.
You may want to change parameters to fit your environment or
standards, such as installing to a different directory. See
"Parameters for Silent Installations" (page 18) for more information.
Install Through Command Line
Install Toad for Oracle Silently
To install Toad silently
1. Extract the MSI from the Quest Installer. See "Extract MSI Files" (page 11) for more information.
2. Enter an install command similar to the following: msiexec /i "<path
to msi
file\ToadforOracle_
version.msi>"INSTALLDIR="<installation folder>"
ADDLOCAL=Client,Server/q /l*v <path to install log, including file name>
For example: msiexec /i "C:\Documents and
Settings\Johndoe\desktop\ToadforOracle11.0.exe"INSTALLDIR="C:\Programs\Quest
Software\Toad for Oracle" ADDLOCAL=Client,Server/q /l*v
"C:\install.log"
Install Patches Silently
If you already have Toad installed and want to upgrade silently, you must include
REINSTALLMODE=vo REINSTALL=ALL in the command. If these parameters are not included, the
MSI registers that Toad is already installed and does not upgrade it.
Toad for Oracle Xpert Edition Installation Guide
Silently Install Toad Editions
13
For example, if you are currently in the directory where the MSI resides, entering the following command installs to the standard location: msiexec.exe /i <path to msi file\ToadforOracle<version>SetupFull.msi>
REINSTALLMODE=vo REINSTALL=ALL
You can also set additional parameters or run the MSI from a location other than the active directory. For example: msiexec /i "C:\Documents and Settings\johndoe\desktop\
ToadforOracleSetupFull.msi REINSTALLMODE=vo REINSTALL=ALL
INSTALLDIR="C:\Programs\Quest Software\Toad for Oracle\" /q /l*v
"C:\install.log"
Uninstall Toad Silently
To uninstall Toad silently
» Enter a command similar to the following: msiexec /x "<path to msi file\ToadforOracle_version.SetupFull.msi>" /q
Install Knowledge Xpert Silently
When silently installing Knowledge Xpert (Oracle Admin and PL/SQL), you must also install the Knowledge Xpert Engine and the Knowledge Xpert Oracle Common components.
To install Knowledge Xpert silently
1. Extract the MSI from the Quest Installer. See "Extract MSI Files" (page 11) for more information.
2. Enter the following command: msiexec.exe /i “<path to msi file\KXEngineSetup.msi>" /q /l*v ”path_to_
install_log\KXEngineSetup.msi.log" /qn TARGETDIR=”install_dir\Knowledge
Xpert" ARPSYSTEMCOMPONENT=1 DISABLEADVTSHORTCUTS=1
3. Enter the following command: msiexec.exe /i “<path to msi file\KXOraCommon.msi>" /q /l*v ”<path to
install log\KXOraCommon.msi.log>" /qn TARGETDIR=”install_dir\Knowledge
Xpert" ARPSYSTEMCOMPONENT=1
4. Enter the following command: msiexec.exe /i “<path to msi file\KXOraAdmSetup.msi>" /q /l*v ”<path to
install log\KXOraAdmSetup.msi.log>" /qn TARGETDIR=”install_
dir\Knowledge Xpert" ARPSYSTEMCOMPONENT=1
5. Enter the following command:
Toad for Oracle Xpert Edition Installation Guide
Silently Install Toad Editions
14 msiexec.exe /i “<path to msi file\KXPLSQLSetup.msi>" /q /l*v ”<path_to_
install_log\KXPLSQLSetup.msi.log>" /qn TARGETDIR=”install_dir\Knowledge
Xpert" ARPSYSTEMCOMPONENT=1
Install SQL Optimizer Silently
To silently install SQL Optimizer in the default directory
1. Extract the MSI from the Quest Installer. See "Extract MSI Files" (page 11) for more information.
2. Enter the following command: msiexec /i "<path to msi file\QuestSQLOptimizer_Oracle_Common.msi>” /qn
3. Enter the following command: msiexec /i "<path to msi file\QuestSQLOptimzer_Oracle_version.msi>" /qn
Toad for Oracle Xpert Edition Installation Guide
Silently Install Toad Editions
15 where
/i = install
/qn = quiet, no UI
To silently install SQL Optimizer in a custom directory
1. Extract the MSI from the Quest Installer. See "Extract MSI Files" (page 11) 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.
Install Toad Data Modeler Silently
To install Toad Data Modeler silently
1. Extract the MSI from the Quest Installer. See "Extract MSI Files" (page 11) for more information.
2. Enter the following command: setup.msi /q INSTALLDIR="C:\Program Files\Quest Software\Toad Data
Modeler version\"
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.)
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.
Toad for Oracle Xpert Edition Installation Guide
Silently Install Toad Editions
16
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
SHORTCUTSTARTMENU
SHORTCUTQUICKLAUNCH
SHORTCUTHELP
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.
Tip: Other parameters for silent installs can be found if you enter the “setup.msi ?” command.
Install Toad for Data Analysts Silently
Before you perform a silent installation, you must install the following software on every computer where you are installing Toad for Data Analysts Base Edition: l
Microsoft .NET Framework 3.5 (Service Pack 1) l
(Existing DB2 client 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; 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 install Toad for Data Analysts silently
1. Extract the MSI from the Quest Installer. See "Extract MSI Files" (page 11) 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:
Toad for Oracle Xpert Edition Installation Guide
Silently Install Toad Editions
17 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
Install Toad for MySQL Silently
Before you perform a silent installation, you must install Microsoft .NET Framework 3.5 (Service
Pack 1) on every computer where you are installing Toad for MySQL.
To install Toad for MySQL Silently
1. Extract the MSI from the Quest Installer. See "Extract MSI Files" (page 11) for more information.
2. Enter the following command: msiexec /i “<path to msi file\ToadforMySQL_version.msi>” /q
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 for Oracle Xpert Edition Installation Guide
Silently Install Toad Editions
Parameters for Silent Installations
The following parameters are available for a silent installation:
Option
/l
Parameter
Package|ProductCode
Description
Installs or configures the product.
18
Toad for Oracle Xpert Edition Installation Guide
Silently Install Toad Editions
19
/a
/x
/l
Option
/f
Parameter
[p|o|e|d|c|a|u|m|s|v]
Package|ProductCode
Package
Package/ProductCode
[i|w|e|a|r|u|c|m|o|p|v|x|+|!|*]
Logfile
Description
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: l p—Reinstalls only if a file is missing.
l o—Reinstalls if a file is missing or an older version is installed.
l e—Reinstalls if a file is missing or an equal or older version is installed.
l d—Reinstalls if a file is missing or a different version is installed.
l 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.
l a—Forces all files to be reinstalled.
l u—Rewrites all required, userspecific registry entries.
l m—Rewrites all required, computer-specific registry entries.
l s—Overwrites all existing shortcuts.
l v—Runs from source and recaches the local package. Do not use this option for the initial installation of the product or feature.
Installs the product on the network.
Uninstalls the product.
Writes logging information to a logfile in the specified path. The path to the
Toad for Oracle Xpert Edition Installation Guide
Silently Install Toad Editions
Option Parameter
/q n|b|r|f
20
Description
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 i—Status messages.
l w—Nonfatal warnings.
l e—All error messages.
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 x—Extra debugging information.
Only available on Windows
Server 2003.
l
+—Append to existing file.
l
!—Flush each line to the log.
l
"*"—Log all information except for the v and x options. To include the v and x options, enter
"/l*vx".
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 qr—Reduced UI with no modal dialog box displayed at the end of the installation.
Toad for Oracle Xpert Edition Installation Guide
Silently Install Toad Editions
21
Option Parameter
RESTRICTIONS p
Description
l qf—Full UI and any authored
FatalError, UserExit, or Exit modal dialog boxes at the end.
l qn+—No UI except for a modal dialog box displayed at the end.
l qb+—Basic UI with a modal dialog box displayed at the end.
The modal box does not display if you cancel the installation. Use qb+! or qb!+ to hide the Cancel button.
l qb- —Basic UI with no modal dialog boxes. Note that /qb+- is not a supported UI level. Use qb-
! or qb!- to hide the Cancel button.
Note: The ! option is available with
Windows Installer 2.0 and works only with basic UI. It is not valid with the full UI.
Prevents users from saving their connection password by disabling the
Save password field in the Database
Login window. For example:
RESTRICTIONS=p
Product Licenses
You can install a license as part of the silent install process by pushing a windows registry file to the target machine and importing it to the registry.
Configure the License File
When a silent install is performed, a License Key template (Questkey.reg) is extracted into the selected directory. You can use this template to enter the key(s) that you would like to use on the target PC.
The following represents the contents of the sample registry key:
Windows Registry Editor Version 5.00
[HKEY_CURRENT_USER\Software\{08439167-4CA5-48E9-A810-A3A7C0B80B06}]
[HKEY_CURRENT_USER\Software\{08439167-4CA5-48E9-A810-A3A7C0B80B06}\Local]
Toad for Oracle Xpert Edition Installation Guide
Silently Install Toad Editions
22
[HKEY_CURRENT_USER\Software\{08439167-4CA5-48E9-A810-
A3A7C0B80B06}\Local\REPLACE_WITH_KEY]
"SiteMessage"="REPLACE_WITH_SITEMESSAGE"
"ProductName"="REPLACE_WITH_PRODUCTNAME"
"ProductVersion"="REPLACE_WITH_PRODUCTVERSION"
Review the following to configure the license file: l
Do not change the first two lines as they are the key entries to add a license.
l
In the template, replace “REPLACE_WITH_????” with the relevant information supplied with your license.
l
Since the license key is used to create a folder in the registry, you can add additional licenses in the same file by replicating the last four lines.
l
The license(s) are ready for use once the Questkey.reg file has been pushed and imported to the registry and the entries are available on the remote machine.Any
product that is run in the Toad bundle reads and validates the license and removes the entries from the registry.
l
Your product(s) are ready for use when the license is validated.
