Welcome to Embarcadero® AppWave™ 3.0

AppWave Web Site | Embarcadero Technologies Home | Technical Support

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

Thank you for using Embarcadero AppWave 3.0.

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:

• AppWave - your Private AppWave Store (sometimes also referred to as the AppWave Host) runs inside your firewall, and provides a wide range of features around app and license management and assignment, app broadcasting (transmitting apps to end user desktops, where they launch and run immediately with no hassle), app discovery (including search, rating & reviews, and more), and a variety of administrative options
• AppWave Browser - an easy-to-use desktop-based client that lets end users discover, run, and socialize apps in your AppWave Private Store. Users see only the apps that they are allowed to see, and can run only the apps that they are authorized to run. The AppWave Browser includes certain administrative features available only to authorized users, as detailed in the product documentation.

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 3.0

• New Features

Release Notes

• System Requirements
• Known Issues
• Upgrade Notes
• Bug Fixes

Additional Resources

• Embarcadero Technologies on the Web
• Embarcadero Technologies Technical Support

What's New in AppWave

New Features

This section describes the new features of the latest release of AppWave. New Features of AppWave Host 3.0

• App Inventory
  • The app inventory on the Embarcadero AppWave now includes more than 300 free apps, more than 50 commercial templates, and all Embarcadero products.
• Offline License Usage
  • You can now assign network named licenses for commercial products to your users for their use offline, when not connected to AppWave. For more information, see "Assigning Licenses to Network Named Users" in the AppWave Administrator Guide.
  • Installation feedback and options
    • The AppWave installation has been improved to provide more visual feedback during the installation process and at completion offers you the option to either launch the admin console or install AppWave Browser.
  • ELC Querying
    • You can now use a read only user account to access the Embarcadero License Center database. For more information, see the "Querying the ELC Database" in the AppWave Administrator Guide.
  • Offline License Usage
    • You can now assign network named licenses for commercial products to your users for their use offline, when not connected to AppWave. For more information, see "Assigning Licenses to Network Named Users" in the AppWave Administrator Guide.
  New Features of AppWave Browser 3.0
  • Install from the command line
    • AppWave Browser can now be installed from the command line without user intervention. For additional details, see "Administrator Installing AppWave Browser" in the AppWave Administrator Guide.
  • Install for all users
    • AppWave Browser can be installed once for all users on a machine, such that only one instance of AppWave Browser is installed, but multiple users on that machine can use AppWave and it will track their personal settings, preferences, and Apps. For more information, see "Administrator Installing AppWave Browser" in the Administrator Guide.
  • Microsoft SCCM compatible
    • AppWave Browser can now be pushed out to your user's desktops via Microsoft SCCM. For additional details, see "Distributing AppWave Browser Using Microsoft SCCM" in the AppWave Administrator Guide.
  • Cache/local repository improvements
    • You can now maximize the cache size so Apps can be streamed in their entirety to your local repository.
    • You can set the cache to automatically grow as you download and run apps.
    • The minimum cache size has been decreased to 512K.
    • You can now designate your local repository to be located in a network shared directory.
    For more information see "Configuring AppWave Browser Options" in the AppWave Browser Apps User Guide.
  • Free apps
    • With an internet connection you can access more than 300 free apps on the Embarcadero AppWave Store.
  • Windows integration
    • Apps are now more tightly integrated with Windows and for example, can now be associated with shortcuts in the Start menu, right-click menu, task bar, and File Explorer. For more information, see "Running Apps from the Windows Desktop" in the AppWave Browser User Guide.
  • Offline usage
    • If permitted, you can now run licensed commercial apps offline, when not connected to AppWave.
  • Complex app suites
    • Support for complex apps such as Microsoft Office and Adobe Create Suite can be seen as individual apps in AppWabe Browser, and are integrated so you can insert an object from one app in the suite into another app in the suite. For example, you can insert an Excel spreadsheet into a Word document.
  • Individual trial licenses
    • An individual user can now request a trial license for Embarcadero products using their own Embarcadero Developer Network credentials.
  New Features of AppWave Studio 3.0
  • More commercial templates
    • There are now more than 50 commercial templates available and templates are available for all Embarcadero products.
  • Tighter Windows integration
    • In the mastering process, you can more tightly integrate your apps with Windows by for example, configuring shortcuts for the app so that the user can access the app using the right-click from the Windows Explorer.
  • Scripting
    • You can now add scripts to perform such actions as connecting to a database that will be run before or after an app starts.
  • Multiple recordings
    • You can now add multiple recordings to an .app file to for example add a patch to a previous installation or add a database client installation to the main software product.
  • Complex suite apps
    • Mastering suite applications, such as Microsoft Office and Adobe Creative suite, are now supported. Studio allows you to create one package that contains all the suite apps which when deployed appear as separate apps to the user.The AppWave administrator can also permit or deny the use of licenses for each individual app in a suite.
  • General improvements
    • In the AppWave Studio 3.0 release, the graphical user interface has been improved, the AppWave Templates run more efficiently, and improvements in the seamless mastering of Apps have been implemented.

Release Notes

System Requirements

AppWave Minimum Requirements

• Intel Pentium III 1.2 GHz processor or higher
• 2 GB of RAM
• Basic install of 650 MB with an additional 100 GB for the repository of initial and future product downloads. (Current app inventory of all apps requires 53 GB of disk space.)
• High resolution monitor (1024 x 768), 16-bit display or greater
• AppWave is supported on the following operating systems:
  • Windows XP SP3, 32-bit
  • Windows 2003, 32-bit
  • Vista SP2, 32-bit
  • Windows 2008 R2
  • Windows 7, 32-bit and 64-bit
• AppWave is supported on Mozilla Firefox, or Internet Explorer 7 or later
• AppWave uses the following ports by default, and can be modified by the administrator at the time of installation:
  • Tomcat and other internal processes: 8009
  • AppWave server port: 80
  • Shutdown port: 8082
  • Database port: 3052
  • Licenses port: 5567

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

  Note: You may choose to allow your AppWave Private Store to communicate with Embarcadero, in order to automatically receive product and license updates. Following is a list of Embarcadero servers that are accessed, which may need to be added to your trusted list within your firewall: 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.

• You require Embarcadero license certificates for the Embarcadero products you purchase.
• All products that you share through AppWave reside in the repository. Ensure that you have enough hard disk space to accommodate all of the products prior to defining the location of the repository directory. Individual space requirements can be found in the individual product documentation at http://docs.embarcadero.com.
• AppWave ships with JVM 1.6 embedded.

AppWave Browser Technical Requirements

• AppWave Browser is a Windows application that supports 32-bit applications on the following operating systems:
  • Windows XP SP3, 32-bit
  • Vista SP2, 32-bit
  • Windows 7, 32-bit and 64-bit
• AppWave is supported on Mozilla Firefox, or Internet Explorer 7 or later.
• AppWave Browser is 86 MB in size and requires a minimum of 512 MB of memory to start. More memory will be consumed based on usage.
• Default cache size for AppWave Browser is dependant on the amount of RAM available and the operating system used.
• Products available in the AppWave Browser have the same approximate memory and disk size requirements as they do independent of AppWave. For the requirements of individual Embarcadero products, consult the product documentation at http://docs.embarcadero.com.
• The current version requires that the AppWave Browser be installed (or run for the first time) by the same Windows user that will be using AppWave. For assistance working around this limitation, please contact Embarcadero Support.
• Turbo mode improves overall AppWave Browser performance, and is the recommended default. Running in Turbo mode requires local administrator rights the first time the AppWave Browser is launched.

AppWave Studio Technical Requirements

• Mastering is supported currently only on 32-bit operating systems.
• Mastering of 64-bit applications is not supported.

Known AppWave Issues

AppWave Server

• In its default configuration, anyone can access your AppWave and run the applications broadcasted by it. To secure your AppWave, set Restricted Mode to On and Allow client to register user to off. You should also edit the All Users group and the folders this group has access to, and the user to limit the licenses available for that user. For more information, see "System Management", "Folder Management", "Group Management", and "User Management" in the AppWave Administrator Guide.
• AppWave does not work properly on Windows configurations using non-English characters in machine and file-system path names.

AppWave Browser

• If you are using a Proxy server to connect to the internet you must specify the proxy settings specified in
  • Internet Explorer [Tools\Internet Options\Connections\LAN settings] or in the
  • Internet Options applet of the Windows Control Panel
    • Windows XP: Start > Settings > Control Panel > Internet Options > Connections > LAN settings
    • Windows 7:Start > Control Panel > Internet Options > Connections > LAN settings
  Once proxy settings have been defined in the LAN settings dialog, you need to update AppWave Browser's Connect\Proxy Settings dialog to enable "Use Internet Explorer Proxy Settings".
• When launching an app you have not used before, you may notice a few seconds of inactivity between the load of the initial data to launch and the launch of the app.
• File associations do not work when Turbo mode is disabled. You will not be able to right-click a file in Windows Explorer and choose to open it with an app and double-clicking an app-associated file will not launch the app.
• Some apps may not run if mastered in a Virtual Machine environment due to dependencies of DirectX or Video Card drivers.
• Some applications will not run with Turbo mode disabled. If this is the case, the app will display an error such as "This application will not run on this operating system in Non-Turbo Mode." or "This application will not run on [operating system]. Please try another application." Administrative privileges are required to change the Turbo Option settings in the AppWave Browser. If the AppWave Browser user does not have administrative privileges, the administrator should reinstall AppWave Browser for all users on the machine. For more information, see "Configuring AppWave Browser Options > Turbo Option" in the AppWave Browser Apps User Guide and "Administrator Installing AppWave Browser" in the AppWave Administrator Guide.
• Existing ToolBox users should not run AppWave Browser and ToolBox at the same time.
• For some applications, if the application is already running, launching the AppWave equivalent or another version may just bring the currently running application into focus.
• Restarting the system is required when uninstalling or upgrading AppWave Browser.
• AppWave Browser must be restarted in order for changes to user privileges to take effect.
• AppWave Browser does not support Internet Protocol Version 6 (IPV6).
• If you are a user with administrator rights and you want to launch applications in Turbo off mode, you might experience problems with applications that require administrator rights to function properly. In order to avoid this, all you have to do is launch the Browser once as an administrator, by right clicking the icon and selecting "Run as administrator".
• Switching connection to multiple servers is not supported (user is allowed to change connection settings, but this may cause problems with license and apps management).
• Licensing and folder settings may not be all updated at refresh on AppWave Browser, sometimes reconnecting to AppWave is required.
• In some cases, AppWave Browser may become sluggish due to poor network performance. If this happens, changing the network connectivity option from wininet to HttpIndy may resolve the issue. This change to may also remedy the "MS XML DOM parse error" and is required in order to configure AppWave Browser to use a proxy server to connect to AppWave. Since AppWave Browser requires authentication and Internet Explorer does not, AppWave Browser will not be able to connect to AppWave unless the proxy server settings in Internet Explorer are overridden. Add the following lines

  [InternetConnection]

  HttpTransportType=HttpIndy

  to the AppWave Browser configuration file, which is located at:

  • Windows Vista and Windows 7: C:\Users\\Local Settings\Embarcadero\AppWaveBrowser\Toolbox.ini
  • Windows XP: C:\Documents and Settings\\Local Settings\Application Data\Embarcadero\AppWaveBrowser\Toolbox.ini
• When uninstalling AppWave Browser, all data may not be removed. You will need to manually delete the dynamic cache folder, located at
  • Windows 7: C:\Program Data\Embarcadero\Product Repository\StreamingCore\Profiles\[user]\Applications.
  • Windows XP: C:\Documents and Settings\All Users\Application Data\Embarcadero\StreamingCore
• The AppWave Browser uninstaller may become unstable if a non-admin user attempts to remove an instance of AppWave Browser that was installed by an admin user. In this case, the admin user should uninstall AppWave Browser.

AppWave Studio

• Some applications that appear on the Embarcadero AppWave take advantage of new Studio features in AppWave Browser 3.0, such as multi-entry and complex scripting. To master this type of complex application, such as Microsoft Office, you need to update your AppWave (the host installation) and AppWave Browser to version 3.0 or later.
• Record and install is not supported on 64-bit systems. However, you can capture data from an existing installation using a template.
• In order to master an application in Windows 7 or Vista, you must launch the AppWave Browser as an Administrator. Close the AppWave Browser, and open it again by right-clicking the AppWave Browser shortcut, and selecting "Run as Administrator".
• When mastering large applications on Win 7 32-bit systems, Appwave Browser might enter into a non-responding state for a limited period of time. When this happens, the Mastering window will go to the background, behind the Studio window and it needs to be explicitly brought to the front.
• Sub-processes created during testing of an App will block AppWave Studio from overwriting the .app file if they are still running when you attempt to master.

Product specific

• Change Manager: Command line invocation is supported with the App. Right-click the App icon and select Open Terminal. Command line terminal can be used only for the last App launched. Scheduler is not currently supported, so you will not be able to plan a script.
• .Net reliant Apps:
  • On Vista and Windows XP systems, to master applications that require .Net, make sure that captured application had the .Net runtime included during mastering. For the Apps mastered using templates, the correct runtimes are selected automatically.
  • When using Turbo Off mode, some conflict might occur depending on the version of .Net already available on the system and the OS version.
• To use Toad for DB2, you must install the DB2 client from the operating system and connect to it outside of AppWave Browser.
• Microsoft Office: To use the Microsoft Office app with AppWave Browser running on Windows XP, you must have Windows Search installed. For more information and to download Windows Search, see the following, http://support.microsoft.com/kb/940157.

Upgrading AppWave

• AppWave Host Upgrade Notes
• AppWave Browser Upgrade Notes
• Upgrading When You Have Internet Connection
• Upgrading Using the Media Kit
• Migrating ToolCloud Settings to AppWave
• Replacing Embarcadero License Center with AppWave

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.

• AppWave Installer: The AppWave installer includes upgrade functionality.
• Backing Up: Before you upgrade to AppWave, make backups of your existing system. The install and upgrade process does not include undo functionality.
• Importing Licenses: When upgrading from ToolCloud to AppWave, the AppWave installer will attempt to import licenses from an existing 1.x system. It will shut down the existing Embarcadero License Center (ELC) and remove the 1.x ToolCloud.
• InterBase Port: Upgrading from ToolCloud 1.x to AppWave will fail if the InterBase port number is changed during the upgrade process.
• Users and Licenses: Users and license assignments are automatically migrated to AppWave if you use the upgrade option in the installer.
• Running in Parallel: You cannot run ToolCloud and AppWave in parallel on the same machine.
• Migration Folders: If, for example, on ToolCloud 1.x you had a assigned a Silver license to a user then when you upgrade, there will be a folder called Migration_Silver, which will contain the user and all the applications corresponding to the Silver license level.
• All Apps Folder: When installation is complete, the All Apps folder will not contain the All Users group. AppWave Browser users will have access only to applications corresponding to the license level assigned on 1.x through the migration folder.
• Restricted Mode: In its default configuration, anyone inside your firewall can access your AppWave and run the applications broadcasted by it. Also, Apps broadcast from AppWave Studio will immediately be added to the All Apps folder and will be available to the All Users group. To secure your AppWave, set Allow client to register user to off. You should also edit the All Users group, the All Apps folder, and the user to limit the licenses available for that user. For more information, see Managing AppWave, Managing Folders, Managing Groups, Managing Users and Publish Applications.
• Embarcadero License Center: Embarcadero License Center (ELC) is integrated with AppWave and installs automatically when you install All-Access. ELC requires the Java Runtime Environment (JRE) on the same machine, which is also installed automatically by the AppWave installer. License Hosting: You use the Embarcadero License Hosting web site at members.embarcadero.com/login.aspx to create configuration files that let Embarcadero License Center track and control license distribution on AppWave. The site requires login and host server information. During AppWave installation, record the AppWave host name and IP address for later use on the License Hosting Website.
• Windows Services Registration: AppWave is automatically registered as a Windows service, therefore it will start when your machine starts. By default, the service is named Embarcadero AppWave. If you do not want AppWave to start as a Windows service, you can reset or otherwise change the service by selecting Start > Embarcadero AppWave X.X > Configure AppWave. In the Embarcadero AppWave Properties dialog, select the General tab and change the service parameters. For instructions on providing AppWave Browser to users, see "Providing Users with AppWave Browser" in the AppWave Administrator Guide.

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

• Remove and install: If chosen, the ToolCloud or previous version of AppWave software will be uninstalled without backing up the previous version. All license files and binary files are not deleted when upgrading from AppWave 2.x to 3.x.
• Upgrade: If chosen, the data for the ToolCloud or previous version of AppWave will be backed up, the previous software will be uninstalled and AppWave will be installed. Data, such as users and groups from the previous ToolCloud or AppWave version will be imported into the new installation of AppWave.

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.

• Remove without import: If chosen, the previous version of ELC will be removed. License information is not retained. You will have to complete the License setup option on the AppWave Dashboard. For more information, see Set Up Licenses in the AppWave Administrator Guide.
• Remove and import: If chosen, licenses previously setup in ToolCloud are backed up, ELC is removed and then the licensing information is imported into AppWave. The licenses will be setup by the installer and there will be no need to set them up again.

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

Download AppWave Browser from the upgraded AppWave Host and then run it. AppWave Browser will prompt you to upgrade the first time it runs. Your bookmarks, folders, and local app repository will be retained.

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.

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:
   • Licenses.zip
   • userlist_concurrent.txt
   • userlist.txt
   • iplist.txt
   • groups.xml
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

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.

Comments: [email protected]