Installation
System Requirements
Review the following client and database server requirements for Toad®
Client Requirements
Before installing Toad, ensure that your client system meets the following minimum hardware and software requirements:
| Requirement | Details |
|---|---|
|
Platform |
2 GHz processor (recommended minimum) |
|
Memory |
8 GB of RAM minimum, 16 GB recommended Additional RAM Requirements: Using Local Storage, Cross-Connection Query, Business Intelligence connections, or NoSQL connections can require an additional 500 MB of RAM. These features start processes (mysqld.exe, hubproxy.exe) which persist for the Toad session. Note: The memory required may vary based on the following:
|
|
Hard Disk Space |
800 MB to install Toad Additional Recommendations: For retrieving large queries, allow 10 GB free disk space (or more, depending on the size of the data being retrieved). After retrieving 2500 rows, Toad saves data in a TMP (.tmp) file in the user's Temp directory. These TMP files are deleted when Toad closes. |
|
Operating System |
Windows Server® 2012 Windows Server® 2012 R2 Windows Server® 2016 Windows Server® 2019 Windows® 8.1 Windows® 10 |
| .NET Framework | Microsoft® .NET Framework 4.7.2 Teradata® .NET Data Provider You must install the Teradata .NET Data Provider (13.10 or later) to use a Teradata native connection in Toad. Note: To use a Teradata connection in a cross-connection query, you must also install a Teradata (13.10 or later) ODBC driver. |
| Additional Software |
Visual C++ Redistributable for Visual Studio 2019. This software is required. It is included in installation using the .exe installer. If using the .msi installer, ensure that this software is installed prior to installation. See Visual C++ Redistributable for VS 2019. For 64-bit Toad Data Studio, both 32-bit and 64-bit Visual C++ packages are required. |
| Database Client |
DB2® Client Toad no longer installs a DB2 Client along with the Toad application. When connecting to a DB2 database, ensure that you have a DB2 Client or IBM Data Server Driver installed. Toad supports DB2 Client versions 9.7.6 through 11.1. Oracle® Client Toad can connect to Oracle using Direct Connect (no Oracle Client required) or using an Oracle Client or Oracle Instant Client. However, if you want to use LDAP, you must install an Oracle Client. Toad supports 9i or later Oracle Clients and Oracle Instant Clients. Notes:
|
| ODBC Driver |
In order to create a native Snowflake connection, you must install the ODBC Driver 2.24.2 (or later) provided by Snowflake. Upon installing and configuring the driver, Toad Data Studio will be set for this type of connection. Note: New versions of the Snowflake ODBC Driver are backward-compatible, but there is no guarantee that earlier versions are forward-compatible. Active monitoring and maintaining of installed versions is advised. For more information regarding the process of creating Snowflake connections, please refer to the Installation Guide and User Guide.
To create a connection to an Amazon Redshift database you must install the Amazon Redshift ODBC driver 1.3.1.1000 (or later version) on client computers accessing an Amazon Redshift data warehouse. For each computer where you install the driver, there are the following minimum requirements that you can find on the Amazon Redshift Web site. For more information regarding the process of creating Amazon Redshift connections, please refer to the Installation Guide and User Guide. |
|
Additional Requirements |
Web Browser Microsoft® Internet Explorer® 11 or later Screen Recommended maximum DPI settings for Toad are 125%. It is possible to use Toad up to 200% but some dialog windows will not be completely usable anymore. Maximum tested resolution for Toad is 3800 x 2160 px. |
Server Requirements
Before installing Toad, ensure that your server meets the following minimum hardware and software requirements:
| Requirement | Details | ||||||
|---|---|---|---|---|---|---|---|
|
|
Toad supports the following databases: Oracle 10g R2, 11g, 11g R2, 12c, 12c R2, 18c, Toad has been tested on Oracle Exadata 2.0 running Oracle database 11g R2. SQL Server 2012 and SQL Server 2012 Express SQL Server 2014 Enterprise and SQL Server 2014 Express SQL Server 2016 SQL Server 2017 SQL Server 2019 Notes:
IBM DB2 for LUW 9.7, 10.1, 10.5, 10.5.0.5, 11.1, 11.5
IBM DB2 for z/OS 11, 12 Note: Toad may support IBM DB2 Express and SWE in addition to listed above servers but note that no testing was performed on it. Note: Windows 8, 10 and Windows Server 2012 require the following Fix Pack in order to ensure registration of DLLs in Global Assembly Cache:
MySQL 5.0, 5.1, 5.5, 5.6, 5.7 MariaDB 5.5.5, 10.2.8, 10.3.2 SAP ASE 15.5, 15.7, 16 SP03 SAP IQ 15, 16 SAP SQL Anywhere 16 SAP HANA SPS 08, SPS 09, SPS 10, SPS 11, SPS 12, SAP HANA 2.0, SAP HANA 2.0 SPS 02 Teradata 12.0, 13.0, 13.10, 14, 15, 16 Access® 2007, 2010, 2013, 2016 Note: To use Access 2016 64-bit to connect to an Access database in Toad, the Microsoft Access Database Engine is required and might not be included in the Access installation. The engine must match the architecture (bitness) of Toad. Excel® 2003, 2007, 2010, 2013, 2016 Note: To use Excel 2016 64-bit to connect to an Excel or .csv file in Toad, the Microsoft Access Database Engine is required and might not be included in the Excel installation. The engine must match the architecture (bitness) of Toad. | ||||||
|
ODBC Database Server |
Toad Data Studio allows you to create a connection to a database that supports an ODBC 3.0 or later driver. ODBC connectivity provides basic querying capability, but may not be as full-featured as a native connection in Toad. Toad has been tested on the following databases, using an ODBC connection:
| ||||||
| Cloud Database Service |
Oracle databases running on Amazon EC2 SQL Azure and Azure SQL Data Warehouse Note: To be able to utilize a majority of Toad functionality, please grant VIEW DEFINITION on the SQL Azure databases you want to work with. SQL Server databases running on Amazon EC2 Toad can manage Amazon RDS and any other cloud or service offering compatible with MySQL. | ||||||
|
Business Intelligence Connections |
Toad has been tested with, and supports, the following Business Intelligence platforms: SAP Business Objects XI 3.1, 4.1 Oracle Business Intelligence Enterprise Edition 12.2 Salesforce.com® Microsoft SQL Server Analysis Services 2016 Google Analytics™ OData version 4 SharePoint® Server 2013 | ||||||
| NoSQL Connections |
Toad has been tested with, and supports, the following NoSQL platforms: Azure Table Services Apache Cassandra™ 3.11.0 Amazon DynamoDB Apache HBASE™ 1.2.6 Apache Hive™ 2.1.0 Cloudera Impala 2.9.0, 3.2.0 with CDH 6.3.2. Toad Data Studio has been certified by Cloudera. MongoDB™ 3.4.6, 3.4.9, 4.0 | ||||||
| VM and Cloud Platform Environments | In general, the databases and data sources listed in this table are also supported when installed on a virtual machine (VM) or cloud platform. See the database or data source documentation for more specific information. | ||||||
| Additional Testing |
Data Set Size The following Toad Data Studio functionality has been tested with data sets of up to 5 million rows: SQL Editor, Data Compare, Import Wizard, Export Wizard. For the following Toad Data Studio modules, working with very large data sets can impact performance. For best results in these areas, work with data sets of less than 1 million rows: Pivot Grid, manually sorting a result grid, performing more than one Data Compare at a time (such as running multiple Data Compare Automation scripts simultaneously). Notes:
| ||||||
| Security |
|
Virtualization Support
| Requirement | Details |
|---|---|
| Application Virtualization |
When deploying Toad in a virtualization environment, for best results ensure the system accurately reflects the applicable client hardware and software requirements listed in this document. Toad has been developed using Microsoft guidelines (see Remote Desktop Services programming guidelines) and can be deployed and operated in virtualization environments such as Citrix XenApp, Microsoft App-V, and VirtualBox. |
| Server Virtualization |
Toad has been tested with the following:
|
User Requirements
User Requirements to Install Toad
Only Windows Administrators and Power Users can install Toad.
Note: The following exceptions exist for Power Users:
If an Administrator installs Toad, the Administrator can share the Toad shortcut icon on the desktop and menu items with any user—a Power User, Restricted User—on the computer.
If a Power User installs Toad, a Restricted User cannot do the following:
- Associate file extensions.
- View the Toad shortcut icon on the desktop or the Toad menu options in the Windows Start menu. As a workaround, Restricted Users can create a shortcut to Toad from the install directory and place the shortcut on their desktop.
User Requirements and Restrictions for Running Toad
The following describes the requirements and restrictions for users who launch and run Toad:
-
-
- To create or modify the QuestSoftware.ToadSecurity table to enable Toad Security, the user who maintains this table must have privileges to create, insert, update, and delete it. All other users need only the ability to read the QuestSoftware.ToadSecurity table to use Toad Security features.
Install Toad
To install Toad
-
Run the ToadInstaller.exe.
For individual installation, the .exe file is recommended. The Microsoft Visual C++ 2015 Redistributable is required by Toad. This software is included in the installation when using the .exe file, but not when using the .msi file. Please ensure Visual C++ Redistributable for VS 2015 is installed prior to installation using the .msi file. See MSI Prerequisites for more information.
For help with installation errors, see Troubleshoot Installation Errors.
-
Select a destination folder and other options.
Install Wizard Page Description Destination Folder Select a destination folder or use the default.
Additional Properties Allow saving passwords—(default) Select to allow Toad to save passwords for data source connections.
Prohibit saving passwords—Select to prohibit Toad from saving connection passwords.
Note: If this option is selected, the Automation module will be disabled in this installation of Toad.
Troubleshoot Installation Errors
Error Message: The Microsoft Visual C++ 2015 Redistributable is not installed correctly
You might encounter this error if the prerequisites for the Microsoft Visual C++ 2015 Redistributable are not installed prior to installing Toad. If you encounter this error, do the following:
- Uninstall the Microsoft Visual C++ 2015 Redistributable using the Control Panel.
- Install the missing software. See Universal C Runtime Update Prerequisites or use one of the following links:
- For Windows 7 or Windows Server 2008 R2, install Service Pack 1: https://support.microsoft.com/en-us/kb/976932.
-
For Windows RT 8.1, Windows 8.1, or Windows Server 2012 R2, install the April 2014 update: https://support.microsoft.com/en-us/kb/2919355.
- For Windows Server 2008, install Service Pack 2: https://support.microsoft.com/en-us/kb/948465.
- Run the ToadInstaller.exe again.
Specify App Data Directory Location
Toad Data Studio 1.0 stores settings files in the user's Application Data directory. The default location cannot be modified from within the application. Toad provides two methods to change the default location: by using a Registry setting or by using a command switch in a Toad shortcut.
Use the Registry setting method to change the application data directory from Roaming to Local. Use the command switch method to change the location to any new path.
To change Toad Application Data directory location from Roaming to Local
In the Registry under Toad Data Studio (Computer\HKEY_CURRENT_USER\Software\Quest Software\Toad Data Studio\1.0), add LOCALSETTINGS with a value of 1.
See the following table for default (Roaming) and resulting (Local) directory path.
Caution: All current Toad settings will be lost after applying this Registry setting unless you manually copy the settings files from the default location (Roaming directory) to the new location (Local directory). Copy the settings files BEFORE you add the Registry setting and BEFORE opening Toad.
|
Operating System |
Default Location | New Location when LOCALSETTINGS = 1 |
|---|---|---|
|
Windows Server 2008 Windows 7 Windows 8 Windows 10 |
C:\Users\username\ AppData\Roaming\Quest Software\Toad Data Studio 1.0 |
C:\Users\username\ AppData\Local\Quest Software\ Toad Data Studio 1.0 |
To change Toad Application Data directory location using a command-line switch
You can override the default Application Data directory by running Toad with the command switch:
Toad.exe --datadir="YourNewDirPath"
To instruct Toad to always use the new directory path, add the command switch and the new directory path to a Toad desktop shortcut. Then use the desktop shortcut when opening Toad.
- To add the command switch, right-click the Toad shortcut and select Properties.
- Enter the command switch and add the directory path in quotes (replace "YourNewDirPath" with your directory path).
