Welcome to Embarcadero® ToolBox and ToolCloud 1.8

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

ReadMe Last Updated: September 2, 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 and ToolCloud 1.8

What Was New in ToolBox 1.7.3

What's New in ToolBox 1.7.2

What Was New in ToolBox 1.7.1

What Was New in ToolBox 1.7

What Was New in ToolBox 1.6

Release Notes

Additional Resources

What's New in ToolBox and ToolCloud 1.8

Product List Changes

The following products are updated in 1.8:

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):

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

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

  1. Back up the all_products.xml file at C:\Program Files\Embarcadero\ToolCloud\utilities\.
  2. 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):

  1. Stop the previous versions of the ToolCloud and ToolBox.
  2. Run the ToolCloud 1.8 installer. It will uninstall the previous version of ToolCloud, but will not uninstall the Embarcadero License Center (ELC).
  3. 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.
  4. 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):

  1. Copy the new wsproducts.xml file to C:\Documents and Settings\username\Local Settings\Application Data\Embarcadero\All-Access Client\.
  2. 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:

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:

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

Resolved Issues

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:

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.