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:

• 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 2.0

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

• 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 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

New Features of AppWave 2.0.1

• User Interface: In AppWave Studio, file, folder and registry visibility options have been updated for a more user friendly interface.

New Features of AppWave 2.0

• Managing Users: You can manage users in your organization by adding them manually or automatically when they first connect to AppWave. AppWave users can be created by synchronizing your AppWave with an LDAP server. When synchronized, all users and groups created on the LDAP server will also appear on the AppWave. Once enabled, you can set a periodic interval that will synchronize users and groups in AppWave with your LDAP server. You can create mixed groups on AppWave that contain one or more LDAP and non-LDAP users and/or groups. You can also import a comma separated values (CSV) file containing all your users or create users one at a time.
• Managing Groups: AppWave allows you to create groups that can contain one or more users and/or groups. This provides an easy way of logically organizing all your users, based on teams for example. Also, you can assign licenses to groups to restrict the contained users to specific licenses. AppWave provides the following pre-defined groups:
  • Administrators: Users in this group are administrators of AppWave. They have no restrictions on AppWave.
  • All Users: Default users group. This group encompasses all users. By default the All Users group has access to all applications, but you can edit this group to restrict application use.
  • Authors: Authors can create and add Apps to AppWave through AppWave Studio, which can then be broadcasted by AppWave.
• Application Broadcasting: You can set up servers to broadcast applications to AppWave Browser users. Broadcasting applications enables the user to start using the App right away without first receiving the entire application. A streaming server can be configured to offload disk intensive product caching from AppWave, freeing it to more efficiently service AppWave Browser requests such as licenses and to perform other AppWave specific functions such as catablog updates and downloading products from the Embarcadero AppWave Store.
• Folders: Folders provide a way to assign applications to users and groups in your organization. Users and groups in a folder can see all applications added to the folder. The following list provides an overview of some of the more notable features surrounding folders:
  • Warnings: Folders show warnings when users have access to a tool but don't have an appropriate license for the tool.
  • Pushed Applications: Folders can be used to push applications to a user's Folder when the user connects to AppWave via AppWave Browser.
  • Read Only: Folders can be designated read only to keep them intact for future projects.
• Support for no-Embarcadero Products: You can manage all your licenses from AppWave, including Embarcadero products and 3rd Party commercial applications mastered with AppWave Studio. The Manage Licenses menu options allow you to host your network licenses, manage your 3rd party licenses through License Automation, import licenses from a zip file, restrict concurrent and named licenses, and if required, restrict use to a specified list of IP addresses.
• Graphical Reporting: You can view several charts and reports showing how your licenses and products are used by AppWave Browser users. For example, you can monitor your license denials using the High Watermark report and configure AppWave System Properties so you receive a notification whenever you're running low on available application licenses.
• Improved Catalog Management: You can view all the applications available to your AppWave and download only those that are important for your organization. You can also maintain your application catalog by removing those applications that are no longer needed.
• Ratings and Reviews: AppWave Browser users can now write and rate application reviews to share their experience with other AppWave users.
• AppWave Browser: A major upgrade to the ToolBox provided with ToolCloud, the AppWave Browser includes loads of new features, allowing end users to discover, run, and socialize their apps in your AppWave Private Store.
• AppWave Brower Admin tab: AppWave administrative functionality is now available through the AppWave Browser's Admin tab.

New Features of AppWave Browser

• Applications: Applications that run from the Browser are called Apps. You can view all Apps available to you using two views: Details View, and Grid View. The Details View shows you at a glance the product rating (number of stars), whether the App is available on the Internet or on the AppWave host, licensing information, and a brief description of the App. It is also the launch point to the product channel where you can discover more about the App, and read and write product reviews. Grid View enables you to quickly browse through the Apps to see which ones are licensed and available on your host or on the Internet (Embarcadero AppWave Store).
• Finding an Application: You can find the application you're looking for by entering a URL or keywords into the search bar, which supports standard search strings. The search bar behaves like a standard address bar found in a browser. You can type keywords to filter the list of products based on relevant matches. The address bar can also be used to launch specific builds using a pre-defined notation. For example, you can type in app://<product> to filter the product list to the desired product only.
• App Channels: App channels provide more details about the Apps and show the reviews and the average rating of the Apps on your AppWave Cloud. You can read all reviews for a given App on the App channel and vote for your favorite one by giving it a "thumbs up". You can also write a new review from this page describing your overall experience with that App or a specific version/profile of that App.
• Personal Repository: To easily access a specific product version, you can download it to your library on the Apps tab of the AppWave Browser. This library is specific to every user and can be named as you choose. It stores shortcuts to specific builds or to installed applications on your machine. You can also create folders in this library to better organize your applications.
• Turbo Mode: If the Browser user's Windows account has administrative privileges, AppWave Browser automatically runs in Turbo Mode, where a small piece of software is added to the operating system enabling AppWave Browser to run faster. When Turbo is not enabled, AppWave Browser does not require Administrative privileges. This is a zero-install mode for locked-down desktops where the user's operating system permissions do not allow them to install drivers. Performance is only slightly less than that provided in Turbo mode.
• Application Extension: The extension of the InstantOn applications has changed from .ion in ToolCloud to .app in AppWave.

AppWave Studio Features

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.

• Creating an App from an AppWave Template: AppWave Templates, developed by Embarcadero and made available with the AppWave Browser, automate the mastering process. These templates contain all the information needed to complete the App such as branding, product descriptions, product names, licensing information, etc. This allows you to master a product without the need to understand all the steps and details necessary to complete the mastering process. Once mastered, the App can be streamed from the AppWave and run locally on a desktop without installation.
• Creating a Custom App from Scratch: For an application without an AppWave Template, you can build an App from an executable which captures file and registry changes during the installation An easy-to-use multi-step process then walks you through completing all the information required to master an App. Once mastered, the App can be broadcast to the AppWave and run locally on a desktop without installation.
• Create an App with Multiple Versions: When you master an App using an AppWave Template, that template may contain multiple versions of the application. If that is the case, you have the option to select one of the versions listed, and then either open the app that is already installed or record the version listed.
• Open an Existing Project: When you created an App, all the project information is stored in a .tca file. You can revisit this project file and modify the project as needed. Each step in the project is available for viewing and editing. This option is only available through the AppWave Studio and a user must be granted authoring permission by an Administrator.

Release Notes

System Requirements

AppWave Minimum Requirements

• Intel Pentium III 1.2 GHz processor or higher
• 2 GB of RAM
• Basic install of 100 MB with an additional 8GB for the repository of initial and future product downloads
• High resolution monitor (1024 x 768), 16-bit display or greater
• AppWave is supported on the following operating systems:
  • Windows XP SP3, 32 and 64-bit
  • Windows 2003, 32 and 64-bit
  • Vista SP2, 32-bit
  • Windows 2008 R2, 64-bit
  • Windows 7, 32 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 is supported on the following operating systems:
  • Windows XP SP3 (32-bit)
  • Vista SP2 (32-bit)
  • Windows 7 (32-bit and 64-bit)
  • Windows 2008 R2
• AppWave is supported on Mozilla Firefox, or Internet Explorer 7 or later.
• AppWave is not supported on Polish Windows operating systems.
• AppWave Browser is 41 MB in size and requires a minimum of 70 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.
• AppWave Browser supports 32-bit applications on 32-bit and 64-bit operating systems.
• 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.
• AppWave Browser must run on an uncompressed disk. Disk compression is not supported at this time.
• 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 Browser

• 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

AppWave Studio

• Record and install is not supported on 64-bit systems. However, you can capture data from an existing installation using a template.
• When mastering an application, the recommended location for installing the application is C:\application_name_version. If you install the application to C:\Program Files during the mastering process, then your App users may have problems when they try to launch the App on a 64-bit system. Also, while capturing in the mastering process, do not capture folders that point to a network location. For example, on some user configurations My Documents is not on the local disk but is rather on a network location. To avoid problems, you can either have the network folder point to a local folder or move the recorded files from the network location to a local folder while mastering.
• 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".
• 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.
• When mastering applications with a user whose user name contains non-ASCII characters, the output directory should be outside the user directory, such as ...\Documents and Settings\username on Windows XP and ...\users\username on Windows 7.

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.

Upgrading AppWave

• Upgrade Notes
• Upgrading When You Have Internet Connection
• Upgrading Using the Media Kit
• 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 ToolCloud to AppWave, make backups of your existing system. The install and upgrade process does not include undo functionality.
• Importing Licenses: 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 2.0 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 on page 21.

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

• 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 2.x to 2.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 version will be imported into 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 on page 25.
• 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.

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

   • 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: 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.
   • If the details are not correct, click Previous to return to previous panels and make the necessary changes.
   • If the details are correct, click Print Summary and store the installation details in a safe location for future reference.
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

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]