Installation Notes for Delphi and C++Builder XE

By: Kris Houser

Abstract: This is the updated version of the Install.html file that ships with the product.

    Installation Notes for Embarcadero Delphi XE and C++Builder XE

  • These notes provide important information about installing the product, and it is recommended that you read this file in its entirety before starting either an uninstall or an install procedure. This document uses the term "the product" or "your product" to describe Delphi XE, C++Builder XE, or RAD Studio XE.

  • For an updated version of these Installation Notes, see the Embarcadero Developer Network (http://edn.embarcadero.com/article/40774).

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

    Contents

    Minimum System Requirements

  • The following Windows platforms are supported:
    • Microsoft® Windows 7
    • Microsoft Windows XP Home or Professional (SP3)
    • Microsoft Windows VistaTM (SP1)
    • Microsoft Windows Server 2003 (SP1) or 2008
    • The latest service packs and security updates are recommended for all platforms
    • Microsoft Internet Explorer 6.0 SP1 or later
  • 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. Also, if you do not have the Microsoft .NET Framework on your system, Microsoft .NET Framework 3.5 will be installed with the product.  

    Prerequisites include the Microsoft .NET Framework 2.0 SP1 Redistributable Package, Microsoft Visual J# version 2.0 Redistributable Package, Microsoft Data Access Components (MDAC) 2.8, Microsoft Core XML Services (MSXML) 6.0, and the Language Pack for MS .NET Framework 2.0.

  • Free space requirement: Approximately 3.5 GB of disk space is required for full product installation, and the installer requires 0.5 GB additional temporary space
  • Intel Pentium or compatible, 1.4GHz minimum (2GHz+ recommended)
  • 1GB RAM (2 GB recommended)
  • 1024x768 or higher resolution monitor
  • Mouse or other pointing device
  • Color quality above 256 colors (32-bit or 16-bit is sufficient)
  • The modeling functionality in the product requires the Java Runtime Environment (JRE). You can download the JRE from http://www.java.com.

Top

    General Installation Notes

    Contents

The Delphi and C+Builder XE  installer can be used to install Delphi XE and/or C+Builder XE as well as additional software.

See Installing Optional, Add-on Products for information on the additional software.

The serial number you enter determines the product that will be installed (Delphi XE, C++Builder XE, or a bundle of the two), the product edition (Professional, Enterprise or Architect), and the type of license (commercial, academic or trial).

    On Windows Vista, must install as Administrator

For Windows Vista, you must run as Administrator or be on the Administrator list to install the product.

    Multiple users on one machine

The product can be installed by any licensed user with administrator privileges, and is immediately available to all licensed users of the same machine. It is also available to any licensed users you might add later.

    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, you need to assign your TEMP variable to a folder on a drive with more disk space, then rerun the installation. See Minimum System Requirements for exact specification.

    Assemblies installed in the Global Assembly Cache (GAC)

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

    Do Not Use Multibyte 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.

    Source Code for Samples is Available on SourceForge

Project samples (previously called Demos) are installed by both the Delphi XE and the C++Builder XE installer. The samples are also checked into Subversion at SourceForge: https://radstudiodemos.svn.sourceforge.net/svnroot/radstudiodemos/branches/RadStudio_XE. You can check this location for additions or updates to the samples.

Top

    Installing by Using Electronic Software Delivery

If the product is purchased using Electronic Software Delivery, you receive a .zip file.

    To install using Electronic Software Delivery:

  1. Extract the .zip file into an empty directory on your hard drive. 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.

  3. The install launcher will appear with buttons to install multiple items that are part of the product. (To install the online help, you need to return to the install launcher and select the online help button in a separate operation from the product install.)

  4. When prompted, enter the serial number for the product. The serial number can be found in the order confirmation email for electronic orders.

  5. All the required ZIP files are downloaded from the Internet and uncompressed.

  6. You are asked to supply an archive location for the install 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 install proceeds automatically.

Top

    Installing by Using Purchased Network Licenses

If you purchased a Network License (managed by the Embarcadero License Server or FLEX) for Delphi XE or C++Builder XE, you must follow these instructions to set up the install image, or your users will be prompted for a serial number and will be unable to install.

If you have a media kit:

  1. Copy all of the DVD files to a writeable directory on your network.

  2. Copy the networked license .slip file (received in your order confirmation email) to the directory where Setup.exe is located.

  3. When your users run 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.

If you have an electronic software download:

  1. Copy over just the setup.exe and slip file into the same directory.

  2. Run setup and the install will read the slip to determine which sku (product version) you have purchased.

  3. Follow the install program instructions.

  4. The install will copy the slip file to the correct directory.

Top

    Installing the Online Help

The online help is now installed in a separate operation from the main product: 

  • If you are using the product launcher, you need to install the product in one operation, and then return to the launcher page and select the help in a second operation. 
  • If you are using Setup.exe to install the product, you also need to run Help_Setup.exe to install the online help.

    DExplore.exe Required for Online Help

Microsoft Document Explorer 2008 (dexplore.exe) is required to view Delphi and C++Builder XE online documentation.  If you do not have Microsoft Document Explorer 2008 installed, it will be installed as part of the Help System Install.  There is a known issue that a pre-release version of the license for Microsoft Document Explorer XE is displayed.

    Installing the MS Windows Platform SDK Help

The MS Windows Platform SDK help is not installed by default with the RAD Studio XE help. You can, however, choose to install the MS Windows Platform SDK help by changing the default feature selections during the help installation:
  • Click the X that appears next to MS SDK Help on the Select Features page of the help installer.
  • Select Will be installed on local hard drive from the popup menu.

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 XE help by using Add or Remove Programs on the Control Panel.
  2. Do either of the following:
    • Restart your system.
    • Verify that DExplore.exe is not running by opening the Task Manager (Ctrl+Alt+Delete), clicking the Processes tab, and stopping DExplore.exe if it is listed there.
  3. Reinstall the RAD Studio XE help and during the installation:
    • Click the X that appears next to MS SDK Help on the Select Features page of the help installer.
    • Select Will be installed on local hard drive from the popup menu.

Top

    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:
    • Use the Control Panel | Add or Remove Programs command, select the product, select the Modify button, and then choose the features that you want to add or remove.
    • Choose Start menu | Programs | Embarcadero RAD Studio | Modify, Repair, Uninstall, select Modify, and then choose features to add or remove.
  • See also Known Installation Issues.

    To install another product:

If you have installed C++Builder XE or Delphi XE, 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.

Top

    Installing Previous Product Versions Licensed with Delphi and C++Builder XE

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

  • Delphi XE includes licenses for Delphi 2010, 2009, 2007 and 7. 
  • C++Builder XE includes licenses for C++Builder 2010, 2009, 2007 and 6.
  • RAD Studio XE includes all the earlier version licenses for both Delphi and C++Builder.

If you purchase an individual named user license or 5-pack or 10-pack of named user licenses: After installing and registering your XE product, you can go to http://www.embarcadero.com/xe-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 XE product.

If you purchase Network/ToolCloud named or concurrent licenses for an XE 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 transferrable 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.

Top

    Installing Optional, Add-On Products

Beyond Compare is installed as part of the main product.  

    Optional Tools You Can Install During Product Installation

At the end of the Delphi XE or C++Builder XE installation, you have the option to install a number of third-party products. These products will be installed unless you de-select them in the custom install page of the installer.  The RAD Studio XE installer will not uninstall these; you will need to uninstall these individually from Add or Remove Programs. The following third parties can be installed during product installation:

FinalBuilder Embarcadero Edition (Ent/Arch only)

FinalBuilder is a powerful Automated Build & Release Management tool that simplifies software build automation.

SVN Client (CollabNet)

Subversion is the new standard for version control and Software Configuration Management (SCM) for globally distributed organizations.

CodeSite Express

The CodeSite Logging System gives developers deeper insight into how their code is executing, which enables them to locate problems more quickly and ensure their application is running correctly.

AQTime Standard

SmartBear’s AutomatedQA AQtime is an award-winning performance profiling and memory and resource debugging toolset for Microsoft, Embarcadero, Intel, Compaq and GNU compilers.

Rave Reports Bundled Edition (BE)

Rave Reports offers a powerful suite of components that simplify the task of creating professional reports. The Select Features dialog of the installer includes an entry where you can select or deselect the option to run the Rave Reports installer. If you want to install Rave later, Rave is available for download from the Registered Users page at http://cc.embarcadero.com/reg/rad_studio.

    Additional Third-Party Products to Install Later

The following third parties can be downloaded or installed from the partner DVD.  The program launcher provides information on how to install these or download them.

/n software IP*Works!

IP*Works! eliminates the complexity of Internet development providing easy-to-use, programmable components that facilitate tasks such as sending email, transferring files, managing networks, browsing the web, consuming web services, and so forth.

Note: IP*Works! can be downloaded from the registered users site. There are separate installers for Delphi and C++ support. At this time, only one of these installers can be installed at a time.

ER/Studio Data Architect Developer Edition

ER/Studio Data Architect Developer Edition (ER/Studio DA) is a database modeling and design tool that helps developers visualize and work with database structures. Install ER/Studio DA by clicking the Download ER/Studio and InterBase 2009 button on the install launcher. If you have the electronic download version of the product, you will be prompted to download the ER/Studio DA setup program.

ER/Studio DA is registered when you register your Delphi XE or C++Builder XE product. The Architect editions of RAD Studio XE, Delphi XE, and C++Builder XE include a full, non-expiring license for ER/Studio DA. The  Professional or Enterprise editions include a trial license for ER/Studio DA so that you can experience the functionality of the Architect edition for a limited time.

Embarcadero InterBase 2009 Developer Edition 

InterBase 2009 Developer Edition lets you build fast, resilient applications well suited for embedding in devices and small enterprise, desktop, and workgroup solutions. You can choose the standard connectivity you want, and make use of a SQL compliant,  multi-version DBMS with simple installation,  near-zero administration, automatic crash recovery, and a self-tuning engine. Database Performance monitoring allows you to streamline applications for optimal deployment.

Install InterBase by clicking the InterBase button on the install launcher, or download it from http://downloads.embarcadero.com/free/interbase.

Register InterBase 2009 Developer Edition using serial number: FBCB-8TAAEA-BJAZAD-34GC.

InstallAware Express

Your CodeGear Express Edition of InstallAware provides the industry-unique benefits of partial web deployment, 67% better compression, interactive Flash/HTML billboards, one-click runtime deployment, unlimited web updates, and one-click patching. Install InstallAware Express by either clicking the InstallAware Express button on the launcher or downloading from your Registered Users page at http://cc.embarcadero.com/reg/rad_studio, http://cc.embarcadero.com/reg/delphi or http://cc.embarcadero.com/reg/c_builder.

Remote Debugger

The Remote Debugger installer is available by clicking the Remote Debugger button on the install launcher or as a download from your Registered Users page at http://cc.embarcadero.com/reg/rad_studio, http://cc.embarcadero.com/reg/delphi or http://cc.embarcadero.com/reg/c_builder.

Embarcadero Partner Software

The partner disk image download is provided free of charge to all RAD Studio, Delphi, C++Builder, and Delphi Prism users. The disk contains additional resources that developers will find valuable when writing software. Embarcadero Technologies thanks the fine Technology Partners who support our products. You can download an ISO of the Partner DVD either by using the button in the install launcher or by downloading  from the  Registered Users page at http://cc.embarcadero.com/reg/rad_studio. A Web-based version of the Partner DVD is available online at http://edn.embarcadero.com/article/29797.

Top

    Known Installation Issues

  • You cannot have a licensed product installed and then install a Trial version. The personality associated with the trial will not have the files installed.

  • During the installation of prerequisites, the Installer does not notify you if you have less than the required free space. If you try to install with too little space, the install hangs. See Minimum System Requirements for exact specification.

  • C++ Boost Libraries will not install on Vista if you do not accept the escalation request during the install process. After an install, you should have the following entries under Add or Remove Programs: Embarcadero RAD Studio XE, and Boost Libraries for C++Builder XE (if C++Builder was installed). If either of these is missing, open a command-line window, go to where your install files are located, and run:

    boost_setup.exe (for C++Builder XE users only)

  • There is a known issue that will affect a small number of users, including those with Hungarian regional options, where the installer fails to start after preparation of the InstallAware Wizard. To remedy this issue, open the Regional and Language Options in the Control Panel and temporarily switch your Regional Options setting to English. After install, you can safely restore your regional setting.

  • Installation of the third-party product AQTime might halt with the following error message:

    MS Help 2.x runtime files are not installed on this PC.
    Installation/registration of Help files cannot proceed.

  • The AQTime product is installed at this point, but the AQTime online help was not installed. In order to install the AQTime online help, you need to obtain and install the AQTime online help using the following steps:

    1. Complete the RAD Studio product installation.

    2. Install the Delphi and C++Builder online help. This step installs the necessary Help 2.x runtime files (DExplore.exe).
    3. Uninstall AQTime.

    4. Download AQTime installer from the Registered Users Download page (http://cc.embarcadero.com/reg/rad_studio).

    5. Reinstall AQTime.

Top

    Uninstalling This Product

  • To uninstall the product, the Administrator who initially installed the product must open the Control Panel, select Add or Remove Programs, select Embarcadero RAD Studio XE and click the Remove button.
    After uninstalling, in order to remove user-specific data from the Windows registry, all non-Administrator users of the product must log in and delete the following registry key:
    HKEY_CURRENT_USER\Software\Embarcadero\BDS\8.0
    WARNING: Registry editing is performed at your own risk. This document and other documentation that accompanies this product describe 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.

  • In Add or Remove Programs, there will be entries for the following (the list depends upon the third-party products that you chose to install):

    • Embarcadero RAD Studio XE

    • Embarcadero Delphi and C++Builder XE Help System (if you installed the help system)

    • Boost Libraries for C++Builder XE (if installed)

    • CodeSite Express 4.6.1

    • CollabNet Automatic Update 1.2

    • CollabNet Subversion Client 1.6.12

    • FinalBuilder 7.0.0.582 Embarcadero Edition

    • Rave Reports 9.0.0 BE

    You will need to uninstall the Help and the third-party products separately using Add or Remove Programs. If the Boost libraries are installed, they will be uninstalled when you choose to uninstall the RAD Studio XE entry.

  • After uninstalling, user-specific data such as default project settings might remain in configuration files found in these directories:

    • Documents and Settings\<username> or All Users\Application Data\Embarcadero\BDS\8.0


    • Documents and Settings\<username> or All Users\Shared Documents\Embarcadero\BDS\8.0

    You should manually remove these folders.

Top

    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.

Valid HTML 4.01 Transitional

Copyright (c) 2010 Embarcadero Technologies, Inc. All rights reserved.




Server Response from: ETNASC03