Installation Notes for XE2


These notes provide important information about installing the product, and Embarcadero Technologies recommends that you read this entire document before any uninstall or install procedure. You can find the most recent version of these notes at http://docwiki.embarcadero.com/RADStudio/en/Installation_Notes_for_XE2.

This document uses the term "the product" or "your product" to describe Delphi XE2, C++Builder XE2, or RAD Studio XE2.

For additional information about installing the product, see the Release Notes (Readme.htm), available at the following locations:

Please Install XE2 Update 1 as Soon as Possible

Update 1 for Delphi and C++Builder XE2 is now available, and you are urged to install this update as soon as possible. This update addresses an important licensing issue and includes more than 120 bug fixes.

We strongly encourage you to install this product update, because all future patches will be based on the Update 1 build. Thus, the only way to acquire new product updates is to have the XE2 Update 1 release installed.

Licensing Issue Resolved in Update 1

Some code in the 3D support in FireMonkey was reportedly similar to code in GLScene, an MPL open source project. We worked with Eric Grange, a key contributor to the GLScene project, to remedy the issue, and this update replaces the code in question. Therefore, it is highly recommended that you install this update and then rebuild any applications that were compiled with the original FireMonkey units.

Important: If you have created any FireMonkey 3D applications: You need to rebuild your FireMonkey 3D applications using Update 1 of either Delphi XE2 or C++Builder XE2. Installing Update 1 and rebuilding your source ensures that your applications have a valid redistributable license.

Contents of Update 1

Update 1 includes over 120 bug fixes:

Download Locations for Update 1

You can download Update 1 from the following locations (the pages include more detailed instructions for installing the update):

Installing Update 1

To install Update 1: Uninstall and then reinstall the product.

Reinstalling iOS Tools Is Required with Update 1

As part of this update, you also need to reinstall the FireMonkey-iOS-XE2.pkg on the Mac:

  1. The FireMonkey-iOS.dmg disk image file is typically installed with RAD Studio XE2 under the FireMonkey-iOS directory; transfer the FireMonkey-iOS.dmg file to the Mac.
  2. Open the FireMonkey-iOS.dmg file on the Mac and run the FireMonkey-iOS-XE2.pkg installer. Doing this will overwrite your current installation if you had previously installed the fpc-2.4.4.intel-macosx.pkg).

For related information, see FireMonkey Development Setup for iOS.

Minimum System Requirements for XE2

Windows Platforms

The following Windows platforms are supported as development platforms:

Prerequisites

The product requires a number of prerequisites that are automatically installed on your system during the install process if they are not already present. In particular, if you do not have the Microsoft .NET Framework on your system, it will be installed with the product. Prerequisites include:

Optionally:

System Requirements

Requirements for Cross-Platform Application Development

Install the Platform Assistant server (paserver) on the remote platform. The PAServer folder is located inside the product installation folder, and instructions are at Installing and Running the Platform Assistant on the Target Platform.

Requirements for Developing 64-bit Windows Applications

Either a PC running a 64-bit version of Windows or a 32-bit PC connected to a PC running a 64-bit version of Windows

Requirements for Developing OS X Applications

PC running Windows connected to an Intel-based Mac, with 2 GB RAM or more, running OS X 10.6 (Snow Leopard) or OS X 10.7 (Lion) over a local area network using a SSH, VNC or Windows file sharing solution

FireMonkey Requirements

FireMonkey development requires Delphi XE2, C++Builder XE2, or RAD Studio XE2 running on Windows.

FireMonkey applications run on multiple platforms with these requirements:

FireMonkey iOS Requirements

iOS development requires:

Embarcadero provides most of the iOS FireMonkey tools, which you install separately from the product install.

Installing the FireMonkey-iOS tools

  1. Locate the C:\Program Files\Embarcadero\RAD Studio\9.0\FireMonkey-iOS folder.
  2. Copy the folder to the Mac.
  3. Open the two files inside the FireMonkey-iOS.dmg file. This installs the FireMonkey-iOS tools.
For further instructions, see the Readme.htm file that is delivered with the FireMonkey-iOS tools on the Mac.

Also see FireMonkey Development Setup for iOS.

General Installation Notes

Software that You Can Install Using the Product Installer

The installer program installs the product and optionally the product Help system.

Beyond Compare, Dinkumware, IntraWeb, Internet Direct (Indy), and TeeChart are installed as part of the main product.

The installer can also optionally install the following third party software:

For details about the third party software, see Third party add-ins.

Additional Available Software Downloads

After the main product install, a list of additional downloads is displayed. The additional downloads include software from Embarcadero and Embarcadero partners that are included as part of your purchase. You can download the software using the links provided in that file. If you need to access the additional downloads later, use the available_downloads.htm file in the root RAD Studio install directory. For English, the file is located at: C:\Program Files\Embarcadero\RAD Studio\9.0\available_downloads_en.htm.

If you have a Media Kit or ISO, most of the additional products are included in a folder at the root of the DVD. You can browse the DVD and navigate to the folder for the product you are interested in and launch the setup from there.

The additional available software includes:

An online version of the Partner DVD (where you can download individual tools rather than the complete DVD ISO) is also available at http://edn.embarcadero.com/article/29797.

Installing the Platform Assistant for Cross-Platform Applications

In order to use the IDE to develop cross-platform applications, you need to install and run the Platform Assistant on the target platform. The Platform Assistant is provided in the product \PAServer directory. The Platform Assistant installer also provides the Remote Debugger. For more information see Installing and Running the Platform Assistant on the Target Platform.

FireMonkey Platform Requirements

Applications developed using FireMonkey have specific platform requirements, such as for the Graphics Processing Unit (GPU). For details see FireMonkey Platform Prerequisites.

Serial Number (License Key)

The serial number, also called the license key, you enter determines what product will be installed, the product edition (Starter, Professional, Enterprise Ultimate or Architect), and the type of license (commercial, academic or trial).

Windows Vista and Windows 7 Require Administrator Privileges

You must run as Administrator or be on the Administrator privileges list to install the product on Vista or Windows 7.

Installer Requires Additional Temporary Space

If the drive containing the folder specified in your TEMP environment variable is low on space, the installer might halt with an error message noting the shortage. If this occurs, assign your TEMP variable to a folder on a drive with more disk space, then rerun the installation.

Register Your Product within Grace Period

The registration dialog box appears when you start a product that is not registered. You must register your product with Embarcadero Technologies; after a 14-day grace period, an unregistered product will shut down and stop running. To register your product, you need the following:

Assemblies Installed in the Global Assembly Cache (GAC)

Duplicate copies of assemblies installed in the GAC are provided in the <CommonFilesFolder>\Embarcadero\RAD Studio\Shared Assemblies\x.x directory. If C:\ is your Windows drive, the default <CommonFilesFolder> is C:\Program Files\Common Files\.

Do Not Use Multi-byte Characters in Install Paths

Do not use double-byte characters in the path or directory for installation. Delphi and C++Builder XE are Unicode-enabled, but the installer has not been enabled for Unicode.

Product is Available to All Licensed Users on the Same Machine

After installation, the product is available to all licensed users on the same machine.

Samples and Samples Source Code

Project samples (previously called Demos) are installed by default. The samples are also checked into Subversion at SourceForge. You can check SourceForge for additions or updates to the samples.

Online Help

In this release, the Help installer is reintegrated with the main product installer.

Microsoft Document Explorer 2008 (dexplore.exe) is required to install product documentation locally on your machine and for use with F1 lookups. If Microsoft Document Explorer 2008 is not installed, it will be installed as part of the Help system installation.

The Help is generated from the online docwiki. The docwiki is updated continuously, so please refer to it for more recent information.

Installing from an ESD

If the product is purchased using Electronic Software Delivery (ESD), you receive a .zip file for RAD Studio or a .exe file for Delphi or C++Builder.

To install using an ESD download

  1. Make sure you have an active Internet connection.
  2. If you are installing RAD Studio:
    1. Extract the .zip file into an empty directory on your hard drive. Note: Do not attempt to run the installer directly from the .zip file without first extracting all files to a local directory.
    2. Double-click the install launcher. The install launcher will appear with buttons to install multiple items that are part of the product.
    3. Select Delphi and/or C++Builder to begin product installation
  3. If you are installing Delphi or C++Builder: Double-click the setup.exe to begin product installation.
  4. When prompted, enter the serial number for the product. You can find the serial number in the order confirmation email.
  5. The installer downloads the required .zip files and uncompresses them.
  6. The installer asks you to supply an archive location for the .zip files. Note: Backing up the downloaded ZIP files is strongly encouraged so that in the future you can do a reinstall without downloading all the ZIP files again.
  7. The installer proceeds automatically. Follow the prompts.

Note: You can optionally install any of the following additional elements:

Installing for Network Licenses

If you purchased a Network License (managed by AppWave™ or the Embarcadero License Server), follow these instructions to set up the install image. Note: Follow these instructions precisely or your users will be prompted for a serial number and will be unable to install.

Installing from a Media Kit

If you have a media kit:

  1. Copy all of the DVD files to a writable directory on your network.
  2. Copy the network license .slip file (received in your order confirmation email) to the product's main installation directory, where Setup.exe is located (typically, <Disc Drive:>\DelphiCBuilder\Install).
  3. Instruct your users to run Setup.exe. When a user runs Setup.exe, the product detects the .slip file and installs the software. During installation, the .slip file is moved to the license folder in the installation directory.
  4. The installer proceeds automatically. Follow the prompts.
  5. Optionally, you can install the Microsoft SDK Help. By default, it is not installed.
  6. Optionally, you can install any or all of the third party products. Installed unless you de-select them.

Installing from a Download

If you have a download URL:

  1. Copy just the Setup.exe and .slip file into the same directory on your machine.
  2. Run Setup.exe and the installer will read the slip to determine which SKU (product version) you have purchased.
  3. The installer will copy the .slip file to the correct directory.
  4. The installer proceeds automatically. Follow the prompts.
  5. Optionally, you can install the Microsoft SDK Help. By default, it is not installed.
  6. Optionally, you can install any or all of the third party products. Installed unless you de-select them.

Modifying the Installed Product

After the product is installed, you can add optional products, and add or remove features. Choose either of the following methods to modify the installed product:

Installing Another Product or Update

If you have installed the product, and you want to install another product or update, use the following steps:

  1. Run Setup.exe.
  2. In the Maintenance dialog, choose to Upgrade your current installation.
  3. Enter the new serial number (license key) for the additional product.

Installing Previous Product Versions

Licenses are included with the product that enable you to download and use previous versions of the product, such as:

If you purchase an individual named user license or 5-pack or 10-pack of named user licenses:

After installing and registering your XE2 product, go to Earlier Versions to obtain serial numbers and software downloads for the older versions. You must request your older version licenses from this page within 180 days of purchase of the XE2 product.

If you purchase Network or AppWave named or concurrent licenses for an XE2 product:

Your network license certificate includes suite licenses that can be used to license any of the included 2007-XE versions plus individual serial numbers for Delphi 7 and/or C++Builder 6. The Delphi 7 and C++Builder 6 serial numbers are single named user serial numbers and are not transferable between users and not available for concurrent user access via the license server.

Note: Academic products do not include licenses for previous versions of the product.

Installing the MS SDK Help if it Was Not Previously Installed

If you have installed the help without the MS SDK help, you can install the MS SDK help by following these steps:

  1. Uninstall the RAD Studio XE2 help by using Add or Remove Programs on the Control Panel.
  2. Do either of the following:
  3. Reinstall the Help and during the installation:

Known Installation Issues

Uninstalling the Product

The user with Administrator privileges who initially installed the product can uninstall the product:

  1. Open the Windows Control Panel.
  2. Select Add or Remove Programs or Uninstall a program.
  3. Select the product name.
  4. Click Remove.

Uninstalling Instances that Use Network Licenses

After uninstalling, each user who is not the Administrator must remove user-specific data from the Windows registry:

  1. Log in to the user account.
  2. Make a backup of the registry.
  3. Launch Regedit or another registry editing tool.
  4. Delete the following registry key:
    HKEY_CURRENT_USER\Software\Embarcadero\BDS\9.0

WARNING: Edit the Registry at your own risk. This document and other product documentation describes editing your Windows registry. In most cases, Embarcadero recommends that you use the Microsoft Regedit tool to perform editing. Whatever tool you use, before you make any changes, you should make backups of your registry and thoroughly familiarize yourself with the editing tool and the registry editing process. The registry is a critical component of your operating system, and any mistakes you make while editing it can potentially cause your machine to stop functioning.

Removing Configuration Files

After uninstalling, user-specific data such as default project settings might remain in configuration files. You should manually remove these folders:

Uninstalling Third Party Products

Although the product installer installs the third party products, the product installer does not uninstall most third party products; you can uninstall these individually, using Windows Add or Remove Programs or Uninstall a program.

If the Boost libraries are installed, they will be uninstalled when you choose to uninstall the product.

If You Have an Installation Problem

Please open a support case on the http://support.embarcadero.com web site if you encounter any problems during installation.

See Also