Welcome to Embarcadero® AppWave™ 4.2

AppWave Web Site | Embarcadero Technologies Home | Technical Support

ReadMe Last Updated: August, 2013. Any updates to these ReadMe notes will be available at docs.embarcadero.com.

Thank you for using Embarcadero AppWave 4.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 4.2

This section describes the new features of the various AppWave components in this release.

AppWave Public Store

AppWave Enterprise Store

AppWave Studio

AppWave Browser

What's New in AppWave 4.1

This section describes the new features of the various AppWave components in this release.

AppWave Public Store

AppWave Enterprise Store

AppWave Browser

AppWave Studio

What's New in AppWave 4.0

This section describes the new features of the various AppWave components in this release.

AppWave Public Store

AppWave Enterprise Store

AppWave Browser

AppWave Studio


Release Notes

System Requirements

AppWave Public and Enterprise Store Requirements

The AppWave Store is supported on the following internet browsers:

AppWave Enterprise 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, with the following additions:

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 Enterprise

AppWave Browser

AppWave Admin

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.

Bugs Fixed in AppWave 4.2
AW-7689 Access violation when closing AwppWave Browser while streaming.
AW-7663 Exception appears when there's no connection to the public host.
AW-7473 Cannot remove shell notification icon.  When AWB (AppWave Browser)  is running in tray mode, clicking on AWB shortcut on desktop or start menu appears to do nothing.
AW-7322 BSOD (Blue Screen of Death) :
Because of kernel statck overflow during a failed app mount
- Win8 - after upgrading AWH (AppWave Host) from 4.1. to 4.1.1.
- When building cpp samples from RAD Studio XE4
- W7x64 -BSOD with Qihoo 360 anti-virus
- After  launching 177 Apps.
AW-7169 AppWave streaming crashes Symantec anti-virus.
AW-6187 Improve notification to the user when they have exceeded the number of allocated licenses.
AW-6162 Avast real-time file scanner causes machine to freeze when caching ER/Studio.

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.