Welcome to Embarcadero® AppWave™ 3.2.2

AppWave Web Site | Embarcadero Technologies Home | Technical Support

ReadMe Last Updated: July 20, 2012. Any updates to these ReadMe notes will be available at docs.embarcadero.com.



Thank you for using Embarcadero AppWave 3.2.2.

Based on Embarcadero ToolCloud technology, AppWave is a Private PC App Store that takes the friction out of traditional software applications, boosting user and organizational productivity by converting applications into AppWave Apps.

AppWave works with all types of PC apps, including software applications that you may have purchased, applications that you have developed in house, and of course Embarcadero's own award-winning portfolio of tools for the developer, architect, and database professional. You may also find certain free apps available to you through Embarcadero's own AppWave Store, that will help you explore AppWave, discover new apps, and experience the power of AppWave.

AppWave comprises three primary components:

And of course at the heart of the matter are the apps themselves. Apps are housed in one place--inside of your own AppWave--and can be broadcast to users on demand, according to their assigned rights and license availability.

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


What's New in AppWave

Release Notes

Additional Resources

What's New in AppWave

This section describes the new features of the latest releases of AppWave.


New Features of AppWave 3.2.2


New Features of AppWave Browser

New Features of AppWave

Additional Information

You can find detailed descriptions of these new features in the "New Features Guide" available at docs.embarcadero.com.


New Features of AppWave 3.2


New Features of AppWave Store

New Features of AppWave Browser


New Features of AppWave 3.1


Features of AppWave Store

New Features of AppWave Browser


New Features of AppWave 3.0


New Features of AppWave New Features of AppWave Browser New Features of AppWave Studio  

Release Notes

System Requirements


AppWave Store Requirements

The AppWave Store is supported on the following internet browsers:


AppWave Requirements

AppWave 32-bit Minimum Requirements

AppWave 64-bit Minimum Requirements

Requirements for the 64-bit version of AppWave are the same as for the 32-bit version, except for the following:

General AppWave Requirements


AppWave Browser Technical Requirements


AppWave Studio Technical Requirements


Limitations of Application Virtualization


Some apps in AppWave will perform automatic updates from vendor websites. Such in-app auto-updates will generally not work in a virtualized app. Should such an auto-update happen when running an app from AppWave, AppWave Browser users should cancel the update operation as it is likely to fail. Similarly, users should not select menu items within an app that aims to update from vendor website. The solution is to apply updates for existing apps once for all users via the mastering process using AppWave Studio. The most recent versions of Embarcadero XE apps are always available on the AppWave Store and are made available to Embarcadero users with maintenance contracts. Embarcadero also updates third party apps on the AppWave Store regularly.

Known AppWave Issues


Known AppWave issues are divided into the following categories:

AppWave Store

AppWave Server

AppWave Browser

AppWave Studio

App Specific

Upgrading AppWave

This section contains the following topics:


Upgrade Notes

AppWave is based on the Embarcadero ToolCloud technologies. If you are running ToolCloud and ToolBox, the following information will help you upgrade to the new system.


Upgrade Instructions

The wizard-based installer guides you through the upgrade process. This section describes installation prerequisites and the Installation Wizard. It also provides information about decisions you must make during installation. You must have administrative privileges to run the install. To complete the installation, you need to complete each panel of the Installation Wizard.

Installation Wizard - License Agreement

To start the installation process:

  1. Double-click setup.exe and the License Agreement appears.
  2. Click I accept the terms of the License Agreement.
  3. Click Next and the previous version detected panel appears.

Installation Wizard - Upgrade previous AppWave version

Installation Wizard - Remove previous Embarcadero License Center

In ToolCloud versions 1.x, Embarcadero License Center (ELC) was installed as a separate application. In AppWave, ELC is more tightly integrated into the product. This screen will only appear if you are upgrading from ToolCloud to AppWave. When upgrading AppWave, you will not see this screen.

Installation Wizard - Install Options

From this point onwards, the upgrade and install procedures are identical. For information on the options available, see "Installing AppWave" in the AppWave Administrator Guide.


AppWave Browser Upgrade Notes


Upgrading Using the Media Kit

Upgrade ToolCloud 1.x to AppWave 3.x using the Upgrade instructions described above in Upgrade Instructions. For information on updating the product catalog and applications, consult the AppWave Quick Start Guide.


Migrating ToolCloud Settings to AppWave

If you have ToolCloud installed on one system and want to upgrade to AppWave and install AppWave on a different system, you can migrate your ToolCloud ELC settings such as licenses, users, and groups to the new AppWave by following these steps.

  1. Install AppWave on the new system.
  2. Backup the license files on the AppWave installation, so that if something goes wrong you can go back to previous settings. These files are located in …\[AppWave_install_dir]\elc\conf and include:
  3. Backup the licenses zip files located in …\[ELC_install_dir]\conf (default: C:\Embarcadero\ELC4.2\LicenseCenter\conf).
  4. In the MANAGE LICENSES area, click License Inventory and then click Import License. Browse to the license .zip file and then click Import License or you can copy the licenses to …\[AppWave_install_dir]\elc\conf on the system running AppWave .
  5. Backup the licenses assignments files located in …\[ELC_install_dir]\conf. Copy them to …\[AppWave_install_dir]\elc\conf on the machine running AppWave .
  6. Reload the license files, In the MANAGE LICENSES area, click License Inventory > License Files and then click Reload License Files.


Replacing Embarcadero License Center with AppWave

The Embarcadero License Center software has been integrated into AppWave. If you are upgrading your Embarcadero License Center (ELC) installation, you will set up licenses, users and groups. You do not have to cache products on AppWave if AppWave will only be managing your site licenses and you do not have an All-Access license.

Bug Fixes

Use your browser Find feature to locate a particular bug number or click a link below to see the issues addressed in a specific build.



Bugs Fixed in AppWave 3.2.2
AW-5762 Apps from Altova Suite can now open pxf files from examples.
AW-5884 Printing problems with DB Artisan have been resolved.
AW-3981 AppWave Studio now successfully masters Internet Explorer 8.
AW-5045 Installing AppWave 32-bit on a Windows 64-bit operating system no longer creates unexpected files at C:\.
AW-5627 MadException error no longer occurs when trying to launch the InterBase® XE (Update4) installer.
AW-5721 AppWave no longer captures the printer spool folder, which previously resulted in print jobs being lost.
AW-5856 AppWave License Denial reports now include information about denials for custom AppWave apps.
AW-5866 Third party installers can now be launched from the Embarcadero public AppWave Store.

Bugs Fixed in AppWave 3.2
AW-3958 Apps now launch as expected from the AppWave Store when Kaspersky and Bitdefender anti-virus programs are installed on the machine running AppWave Browser.
AQ-4197 Apps now launch as expected from the AppWave Store and a private AppWave when Bitdefender Total Security 2012 anti-virus software is installed on the machine running AppWave Browser.
AW-4378 Apps now launch as expected from the AppWave Store and a private AppWave when McAfee VirusScan Enterprise 8.8 is installed on the machine running AppWave Browser.
AW-4200 Apps now launch as expected from the AppWave Store when Avast! Internet Security 7 anti-virus software is installed on the machine running AppWave Browser.
AW-4253 Apps now launch as expected from the AppWave Store when AVG Anti-Virus 2012 is installed on the machine running AppWave Browser.


Bugs Fixed in AppWave 3.1
AW-504 Channel view now correctly displays Application details when Internet Explorer 6 is installed on the computer.
AW-1295 Newly broadcasted apps no longer fail to launch sometimes due to a trial owner error.
AW-1297 License has expired message no longer appears when trying to open a previously run app with an on demand trial license after reinstalling AppWave Browser.
AW-1980 After an app fails to run with an "Error opening application ..." message, the AppWave Browser cache can be cleared within a minute of receiving the error.
AW-2311 The machine no longer hangs after launching a large number of apps (>30).
AW-2380 AppWave Browser no longer returns an error if you use the Cancel Download option while downloading an app from the public AppWave to your private AppWave.
AW-2400 AppWave Browser installer has been improved so that the streaming core is installed properly and the "Streaming player not installed on this machine" error no longer appears when trying to run an app.
AW-2401 The error message, "TEndeavorPlayer : Invalid application state in AddApplication method for product with the path: ; " no longer improperly appears sometimes when launching an app.
AW-2428 After launching several applications, the following error no longer appears: "Error updating license for application X while running."
AW-2459 AppWave Browse no longer connects to the internet through a proxy server if "Use a proxy server" is not selected in Windows Internet Options > Connections > LAN Settings.
AW-2601 The dynamic cache files and repository are now preserved at when AppWave Browser is upgraded for non-admin users.
AW-2620 Feedback is now displayed continuously to the user during the launch of large application such as DB Artisan or ER/Studio DA after prefetch is loaded.
AW-2749 License information is no longer repeated multiple times on the View Channel | View All page.
AW-2860 Time limited licenses on an AppWave with backup license server support are no longer incorrectly displayed as being invalid on the License Files page.
AW-2849 Launching multiple apps in close succession no longer produces a "Connection to Streaming Server failed" error.
AW-2964 "Unknown error occurred" error is no longer reported if the connection to Appwave is lost when launching a free vendor app that was already run at least once.
AW-3541 The left panel in AppWave Browser no longer displays text vertically.
AW-2751 AppWave Browser no longer crashes on Windows XP SP3 when the user also has CheckPoint Software installed.
AW-3444 AppWave Browser now shuts down gracefully when Windows is shutdown.


Bugs Fixed in AppWave 3.0
AW-1975 Unicode passwords are now correctly saved.
AW-1832 LDAP users/groups are now correctly imported when they contain entities with long values.
AW-1808 EInvalidOperation message no longer appears in AppWave Browser when trying to use a proxy.
AW-1179 Reviews for LDAP users now display when searching reviews for User on the Moderate Reviews page.
AW-1164 Unicode users/groups are now correctly displayed on exported reports.
AW-982 ER/Studio DA 9.1 installer no longer freezes when installing on Win7 x86.
AW-871 AppWave no longer encounters OutOfMemory errors when importing a large number of LDAP users. System tests verified with an import of over 150,000 users.
AW-842 LDAP synchronization no longer fails for an LDAP server which has more than 153305 users.

Embarcadero Technologies Technical Support

If you have a valid maintenance contract with Embarcadero Technologies, our Support team will 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. To download evaluations of Embarcadero Technologies products go to the www.embarcadero.com.

To contact Support, go to Support.