Welcome to Embarcadero® AppWave™ 2.0.1

AppWave Web Site | Embarcadero Technologies Home | Technical Support

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

Thank you for using Embarcadero AppWave 2.0.1.

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 two 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.

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

What's New in AppWave 2.0

Note: This release marks the transition from ToolCloud to AppWave.

Release Notes

Additional Resources

What's New in AppWave 2.0

New Features

This section describes the new features of the latest release of AppWave. It is comprised of the following topics:

New Features of AppWave 2.0.1

New Features of AppWave 2.0

New Features of AppWave Browser

AppWave Studio Features

AppWave Studio, an application within in the AppWave Browser, is where you master existing or new applications. Mastering is when you can take a product, record the install, select the executable, and then build it as an App. This process takes the entire structure of an installed application with all the settings (registry, and default settings of the application) and combines them into a final standalone App.

That App is then broadcast to the AppWave, with no additional steps required. This App runs on the desktop locally, but does not change the operating system or registry. It also does not share DLLs or other system-wide settings. The application data, including settings, are stored locally on the hard drive separate from the executable.


Release Notes

System Requirements

AppWave Minimum Requirements

AppWave Browser Technical Requirements

AppWave Studio Technical Requirements

Known AppWave Issues

AppWave Server

AppWave Browser

AppWave Studio

Product specific

Upgrading AppWave

This section contains the following topics:

Upgrade Notes

AppWave is the new name for the 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 - Introduction

To start the installation process:

  1. Double-click setup.exe and the Introduction dialog is displayed.
  2. Click Next and the License Agreement appears.

Installation Wizard - License Agreement

  1. Click I accept the terms of the License Agreement.
  2. Click Next and the Choose Install Folder panel appears.

Installation Wizard - Remove 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 - Choose Install Folder
  1. Enter the location where you want to install AppWave.
  2. Click Next and the Application Repository panel appears.

Installation Wizard - Application Repository

AppWave distributes Embarcadero products through a shared repository created during installation. When you specify the repository location, the installer grants read-only access rights to all for that directory. This allows AppWave Browser to access the products.

  1. Choose the shared location where you want AppWave to store the products cached for AppWave Browser users.
  2. Click Next and the AppWave Ports panel appears.

Installation Wizard - AppWave Ports

  1. In the Communication Port field, enter the port number AppWave will use to communicate with AppWave Browser and AppWave Studio users. The default port number is 80.

    AppWave uses the following ports by default, which are set by the installer

    So do not use these ports as the communication port or for other applications.

    Note: During normal operations, AppWave contacts and interacts with the following Embarcadero hosts: appwave.embarcadero.com, AppWave Store; license.codegear.com, All-Access license hosting; reg.codegear.com, AppWave registration; cc.codegear.com, auto update; and altd.embarcadero.com, product binaries and pades. In a restricted environment, add these URLs to your trusted list.

  2. In the Shutdown Port field, enter the port number Windows will use to shutdown the service when the Administrator commands the AppWave service to stop. The default port number is 8082.

    AppWave is automatically registered as a Windows service, therefore it will start when your machine starts. By default, the service is named Embarcadero AppWave.

  3. In the InterBase Port field, enter the port number AppWave uses to communicate with the InterBase database. The default port number is 3052. AppWave uses an InterBase database to store all its information.
  4. Click Next and the Pre-Installation Summary panel appears.

Installation Wizard - Pre-Installation Summary

  1. Review the installation details.
  2. Click Install.

Installation Wizard - Installing Embarcadero AppWave

The installation proceeds. The AppWave services are automatically started when the installation is complete.

Installation Wizard - Install Complete

  1. Click Done.

    The AppWave console opens in your default browser.

  2. The host name and port number of AppWave display on the main page. Record this information for future reference because you will need it in order to host your All-Access license.

Upgrading Using the Media Kit

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

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

Bugs Fixed in AppWave 2.0.1
ALACS-11001 AppWave Browser can now be installed on the same machine by two different users.
ALACS-11761 Changes to the My AppWave Name value in the AppWave Browser options are now immediate.
ALACS-11850 The Release Date specified on the Brand page after AppWave Studio records an application installation is now correctly retained.
ALACS-12949 Adobe Indesign mastered on Windows 7 or Window XP now launches correctly from AppWave Browser running in Turbo mode.
ALACS-13036 Adobe PhotoShop mastered on Windows 7 or Window XP and launched from AppWave Browser can now successfully use the PhotoShop "browse in Bridge" functionality.
ALACS-13136 When viewing an Application Channel, the default App version is now the most recent version, as determined by the product release date.
ALACS-13266 Trial licenses can now be successfully granted to AppWave Browser users connected to an AppWave using a proxy server to access the Internet.
ALACS-13761 Once a retail license for an App is purchased and the trial license has expired, the trial license no longer appears on the application channel.
ALACS-13799 AppWave Browser now supported on the Polish versions of Windows.
ALACS-13833 Republishing an App from AppWave with the same GUID no longer requires a restart before the updated App is available.
ALACS-13841 ER/Studio Viewer installer can now be downloaded from AppWave Browser and ER/Studio Viewer can be successfully installed.
ALACS-13843 After installation, the status of ER/Studio Software Architect on its App Channel correctly displays as installed.
ALACS-13851 For mastered Apps, files marked as permanently visible in AppWave Studio are now visible when the App is broadcasted and launched by an AppWave user.
ALACS-13863 Users without administrative privileges are no longer able to cancel the administrator-initiated caching of an App.
ALACS-13865 Technical Requirements documentation for AppWave incorrectly stated that on Windows 7, AppWave Browser was supported in Turbo mode only. This has been corrected.
ALACS-13920 AppWave Browser login now supports Unicode characters in the user name. This was implemented to support AppWave Browser running on the Polish language versions of Windows.
ALACS-13949 Empty registry keys are now correctly captured by AppWave Studio while mastering an App.
ALACS-13976 Workstation Reservations assigned for 3rd party Apps are now retained when AppWave is restarted.
ALACS-14084 Once installed ER/Studio Viewer 9.0 can now be correctly launched from the AppWave Browser, ER/Studio DA Channel on Windows XP system.
ALACS-14104 Downloading PADE plugins no longer causes AppWave Studio to time out if the plugin was not already cached on AppWave.
ALACS-14205 Applications that are not integrated within a suite are now reported correctly in all reports.

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.