Embarcadero® ToolBox and ToolCloud Read Me

Welcome to Embarcadero® ToolBox 1.8.1, for ToolCloud 1.8

All-Access Web Site | Embarcadero Technologies Home | Technical Support

ReadMe Last Updated: November 17, 2010. Any updates to these notes will be available at docs.embarcadero.com.

Thank you for using Embarcadero ToolCloud and ToolBox. The ToolBox lets you access a wide range of applications from a single launch point. You can launch, install, update, and select product versions, all from a single user interface.

The ToolBox provides a primary entry point for the various products configured with the ToolCloud. The ToolCloud lets you centrally provision, manage and update software and licenses inside your own firewall. You control what applications and software versions are available to end users via their ToolBox. With network licensing, you can use the ToolCloud to centrally control the list of authorized users and their product licenses.

For more information, see the documentation at docs.embarcadero.com.

What's New in ToolBox 1.8.1

Note: This release updates the ToolBox only.

Product List Changes
Resolved Issues

What's New in ToolBox and ToolCloud 1.8

Product List Changes
Upgrade Notes
Windows Server 2008 Support Note

What Was New in ToolBox 1.7.3

Configurable Sandbox Directory
Resolved Issues

What's New in ToolBox 1.7.2

Product List Changes
Resolved Issues

What Was New in ToolBox 1.7.1

Disabling Automatic Proxies

What Was New in ToolBox 1.7

Product List Changes
Automatically Detecting Proxies
Resuming Interrupted Downloads

What Was New in ToolBox 1.6

Product List Changes
Provision A La Carte Products (All-Access Pass Not Required)
Automatically Update Licenses When Updating the Product Catalog
Product Name Changes

Release Notes

System Requirements
Known Issues

Additional Resources

Licensing Your Embarcadero Product
Embarcadero Technologies on the Web
Embarcadero Technologies Technical Support

What's New in ToolBox and ToolCloud 1.8.1

Product List Changes

The following products are updated in 1.8.1:

C++Builder XE Update 1
DBArtisan 8.7.6
Delphi XE Update 1
ER/Studio Business Architect 1.7
ER/Studio Data Architect 9.0
ER/Studio Viewer 9.0
RAD Studio XE Update 1
Rapid SQL 7.7.2

What's New in ToolBox and ToolCloud 1.8

Product List Changes

The following products are updated in 1.8:

C++Builder XE
DB Change Manager 5.5.2
DB Optimizer 2.5.1
Delphi XE
Delphi Prism XE
RAD Studio XE
RadPHP XE (formerly Delphi for PHP)
Rapid SQL 7.7.1

Upgrade Notes

While 1.8 is an update to both ToolBox and ToolCloud, it is not required that you upgrade both. Here are the upgrade guidelines:

Upgrading DB Change Manager, DB Optimizer, and Rapid SQL

If you are interested in DB Change Manager, DB Optimizer, or Rapid SQL, please update your product catalog metadata file, either wsproducts.xml or all_products.xml. Updating your ToolCloud is optional; if you wish to do a full upgrade, see the instructions for upgrading C++Builder, etc. below.

To update the product catalog when you are using ToolBox in workstation mode (standalone):

Back up the wsproducts.xml file at C:\Documents and Settings\username\Local Settings\Application Data\Embarcadero\All-Access Client\.
Copy the new wsproducts.xml file to that location.

To update the product catalog when you are using ToolBox in server mode (with ToolCloud):

Back up the all_products.xml file at C:\Program Files\Embarcadero\ToolCloud\utilities\.
Copy the new all_products.xml file to that location.

Upgrading C++Builder, Delphi, Delphi Prism, RAD Studio, and RadPHP

If you are interested in C++Builder, Delphi, Delphi Prism, RAD Studio, or RadPHP, you must update your ToolBox, ToolCloud, and either wsproducts.xml or all_products.xml.

To update the product catalog when you are using ToolBox in server mode (with ToolCloud):

Stop the previous versions of the ToolCloud and ToolBox.
Run the ToolCloud 1.8 installer. It will uninstall the previous version of ToolCloud, but will not uninstall the Embarcadero License Center (ELC).
Run the ToolCloud 1.8 installer again. It will install the new ToolCloud, while retaining the existing licenses, users, and cached tools. It will replace the product catalog metadata file, all_products.xml. While creating the products folders, the installer may require some additional time. Do not stop the process; it should complete in about 5 minutes.
Connect to the new ToolCloud and download the new ToolBox.

To update the product catalog metadata when you are using ToolBox in workstation mode (standalone):

Copy the new wsproducts.xml file to C:\Documents and Settings\username\Local Settings\Application Data\Embarcadero\All-Access Client\.
Copy the new ToolBox executable to your system.

Windows Server 2008 Support Note

ToolCloud does not support Windows Server 2008. If you require Windows Server 2008, there is a licensing solution using Embarcadero License Server. Please contact Technical Support for details.

What's New in ToolBox 1.7.3

Configure Sandbox Directory

You can now configure the sandbox directory used to launch an InstantOn executable by setting an environment variable in Windows. Set the variable AA_SANDBOX to a valid directory (such as C:\Temp\) and product sandboxes will use that directory, organized by product name and version. For example, using C:\Temp\, the DBArtisan 8.7.4 sandbox would be at C:\Temp\DBArtisan\8.7.4\ instead of the default location.

Note:Only the sandboxes for launched InstantOn executable will be redirected. The sandbox for ToolBox will not be redirected.

What's New in ToolBox 1.7.2

Product List Changes

The following products are updated in 1.7.2:

Change Manager 5.5.1
DBArtisan 8.7.4
DB Optimizer 2.5
ER/Studio Business Architect 1.6.1 (includes support for Windows 7)
Rapid SQL 7.7
Rapid SQL Developer 2.1.3

What Was New in ToolBox 1.7.1

Disabling Automatic Proxies

Starting with release 1.7, the ToolBox detects internet proxies on your system and creates an aaclient.properties file that includes the proxy information. With 1.7.1, you can disable the proxy feature by using an empty aaclient.properties file in the installation directory.

What Was New in ToolBox 1.7

Product List Changes

The following products are updated in 1.7:

3rd Rail 2.0.1
Change Manager 5.1.2
DBArtisan 8.7.1
ER/Studio Data Architect 8.5.1
ERViewer 8.5
Rapid SQL 7.6.4

Automatically Detecting Proxies

When it starts, the ToolCloud now detects internet proxies on your system. If it finds a proxy configuration, it updates the catalina.properties file with the proxy information, and restarts the ToolCloud.

The standalone ToolBox handles this in a different way than the ToolCloud. At startup, it detects internet proxies on your system and creates an aaclient.properties file in the installation directory that includes the proxy information. If an aaclient.properties file already exists from a previous configuration, then the ToolBox will use that file.

Resuming Interrupted Downloads

New Pause and Resume options help you manage interrupted product downloads. If the connection drops, use the Pause button. Restore the connection and then use the Resume button to continue.

What's New in ToolBox 1.6

Product List Changes

DB Optimizer 2.0 has been updated.

Provision A La Carte Products (All-Access Pass Not Required)

You can now license individual products (outside of All-Access) to run from the ToolCloud, with InstantOn. Please contact Sales for more information.

An a la carte license is listed in the Current Licenses page. Using the ToolCloud web console, an administrator can assign licenses to users. When a user connects to the ToolCloud, the ToolBox displays products assigned to the user. When a user launches a product, the appropriate license is copied to the license directory on the user's machine.

Automatically Update Licenses When Updating the Product Catalog

Prior to 1.6, you had to manually update the with new .slip files when new products and versions were added. Now the licenses automatically update, instead of requiring the administrator to import new .slip files.

Product Name Changes

The name "All-Access Client" is now "ToolBox" and "All-Access Server" is now "ToolCloud". The All-Access ToolCloud and All-Access ToolBox support the products and licensing model as provided with the All-Access Pass. The Embarcadero ToolCloud and ToolBox also support the a la carte licensing model.

Release Notes

ELC

System Requirements

The ToolBox is a Windows application with no significant requirements.

Products available in the ToolCloud have the same approximate memory and disk size requirements as they do independent of the ToolCloud. For the requirements of individual Embarcadero products, consult the product documentation at: http://docs.embarcadero.com.

Known Issues

If you have already installed an older version of ToolBox, in order to access new product versions, after installing and before launching ToolBox, you must delete wsproducts.xml in the folder C:\Documents and Settings\username\Local Settings\Application Data\Embarcadero\All-Access Client\.
If you are connecting to a ToolCloud, please use the version of the ToolBox bundled with the ToolCloud. Some standalone versions of the ToolBox will not allow you to connect to a ToolCloud.
Some product Help and Check update buttons are disabled. (ALACS-824)
You can copy only one version of the product installer for each product to a machine. A "file already exists" message will occur. (ALACS-347)
After installing JBuilder 2008 R2 using the Copy to Local option, Copy to Local is not disabled. The button should become disabled because the product version was already copied. (ALACS-676)
After upgrading to a new version of a product, the Launch button for the previous version appears active, even though the product is no longer available. Restart the ToolBox to update the state of the button. (ALACS-1966, 1968)
On XP, a 'Could not create the Java virtual machine' error sometimes occurs when launching an InstantOn product. Increasing the JVM memory allocation may fix the problem. See "To configure the JRE" in the ToolCloud Administration Guide. (ALACS-1971)
Sometimes, the ToolCloud does not successfully install as a Windows service. Uninstall the ToolCloud, restart the computer, and install the ToolCloud again. (ALACS-1909)
When a new version of a product is downloaded using the notification and automatic update feature, that product is saved and assigned only for the access levels of the Current License. The product won't be available in the ToolBox for any other new access level that may be imported. To work around this issue, import licenses for all levels to the ToolCloud before turning on or triggering an automatic update. Alternatively, do not use automatic update at all; manually update the product catalog. (ALACS-2168)
Some virus-checking software will incorrectly flag InstantOn executables; you may see an "Embarcadero Launcher: the handle is invalid" message. To work around this situation, add the Embarcadero directory path (by default, C:\Program Files\Embarcadero\) and the Sandbox directory path (by default, C:\Documents and Settings\username\Application Data\Embarcadero\Sandbox) to the list of paths ignored by the anti-virus software.
Backward compatibility with older versions of the ToolBox or ToolCloud is not supported. If you try to use 1.5 with 1.6, you will see an error message. (ALACS-2313)

Resolved Issues

Resolved in 1.8.1: A typo in the download URL for DBArtisan 8.7.4 is now corrected. (ALACS-8102)
Resolved in 1.7.3: Some problems retrieving trial licenses on a toolpod or workstation are resolved. (ALACS-5999)
Resolved in 1.7.2: Some problems with duplicated .slip files for trial licenses are resolved. (ALACS-5487)
Resolved in 1.7.2: A problem with launching ER/Studio Business Architect from the ToolBox is resolved.(ALACS-4191, 4192)
Resolved in 1.6: After installing Delphi, Delphi Prism, or C++Builder, the Install tab is not enabled. Restart the Client to re-enable the Install tab. (ALACS-674)
Resolved in 1.6: In 1.5, displaying the product list took too much time. This performance issue has been corrected. (ALACS-2080)

The following table lists outstanding known issues related to products. For additional product issues, see their respective Read Me files at: http://docs.embarcadero.com.

Change Manager	Change Manager has the following known issue: To use its command line API, you must install Change Manager. Command line invocation is not supported with InstantOn.
DBArtisan	DBArtisan has the following known issues: When opening the Details window for the Bottleneck Analysis in Performance Analyst for Oracle data sources, if Rapid SQL was previously installed, the installer might start. Cancel it and reopen the Details page. To use the Backup Analyst, you must install DB Artisan.
ER/Studio	ER/Studio has the following known issues: You can access ER/Studio Portal from a browser, from outside the ToolBox. This ability requires a separate server install, which you can get from the All-Access page on EDN. Certain Help files (for example, SAX Basic Help) cannot be launched from the InstantOn version of ER/Studio. ER/Studio Viewer is available in the Client workstation mode, for all levels, but is licensed only for Bronze and Silver levels. ER/Studio Viewer is not available in the Client in server mode for Silver level.
InterBase SMP	The InterBase SMP application has the following known issues: When InterBase is in a multi-installation environment where the instance is uniquely identified, the Installed tab in the ToolBox does not become enabled. However, you can launch InterBase outside of ToolCloud. Licensing for InterBase installed from within the ToolCloud is driven by the ToolCloud. You must not use the InterBase License Manager to expand on these licenses.
JBuilder	The JBuilder InstantOn application has the following known issues: There is a performance degradation due to pending memory issues. A virtualization error dialog is thrown on exit. Functionality is not affected. The J Optimizer Agent Controller fails to register the process to be profiled and prompts for a restart of the controller. Answering Yes to the prompt, successfully restarts the Agent Controller and fixes the issue.
RAD Studio	RAD Studio has the following known issue: RAD Studio 2007 prompts for a serial number during installation. (ALACS-813)
Rapid SQL Developer	Rapid SQL Developer has the following known issues: An error may occur when opening another application instance while the first instance is still open. On Vista, a "Java heap space" situation can arise in the InstantOn application when querying a table with a large number of records.

Additional Resources

Licensing Your Embarcadero Technologies Product

All Embarcadero Technologies products include a trial period. To continue using the product without interruption, license it as soon as possible. To license your product, use the License Request Wizard found in the Help menu of the product. If you have not yet purchased your Embarcadero Technologies product, contact:

[email protected] for Americas
[email protected] for EMEA
[email protected] for APAC

Embarcadero Technologies on the Web

Visit www.embarcadero.com or click any of the links below to find:

Embarcadero Technologies Technical Support

If you have a valid maintenance contract with Embarcadero Technologies, the Embarcadero Technical Support team is available to assist you with any problems you have with our applications. Our maintenance contract also entitles registered users of Embarcadero Technologies products to download free software upgrades during the active contract period. Evaluators receive free technical support for the term of their evaluation.

Open technical support cases using the Technical Support request form. For additional information visit Embarcadero Technologies Technical Support.