Show: Delphi C++
Display Preferences

Installation Notes for XE3

From RAD Studio XE3
Jump to: navigation, search

Go Up to What's New in Delphi and C++Builder XE3


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/XE3/en/Installation_Notes_for_XE3.

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

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

Contents

Minimum System Requirements for XE3

Windows Platforms

The following Windows platforms are supported as development platforms:

  • Microsoft® Windows 8 (32-bit and 64-bit)
  • Microsoft Windows 7 SP1 (32-bit and 64-bit)
  • Microsoft Windows VistaTM SP2 (32-bit and 64-bit) requires administrator rights
  • Microsoft Windows Server 2008 (32-bit and 64-bit)
  • 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 typically installed automatically on your system during the install process if they are not already present. In particular, unless you are installing on Windows 8, the Microsoft .NET Framework is installed on your system if it is not already present.

Prerequisites include:

  • Microsoft .NET Framework 3.5
  • Microsoft Visual J# version 2.0 Redistributable Package
  • Microsoft Document Explorer

Optionally:

  • The .NET Framework should be automatically installed for you during installation. However, if you are installing on Windows 8, .NET is not automatically installed. Instead, you can choose to install the .NET framework from MS Windows Update Server.
  • The modeling functionality in RAD Studio requires the Java Run-time Environment (JRE). You can download the JRE from www.java.com.
  • For developing 64-bit Windows applications (using Delphi or RAD Studio only):
    Either a PC running a 64-bit version of Windows or a 32-bit development PC connected to a PC running a 64-bit version of Windows.
  • For developing OS X applications (using Delphi, C++Builder, or RAD Studio):
    A PC running Windows connected to an Intel-based Mac with 2 GB RAM or more, running any one of OS X 10.6 (Snow Leopard), OS X 10.7 (Lion), or OS X 10.8 (Mountain Lion), over a local area network using an SSH, VNC or Windows file-sharing solution

Windows 8 Platform Requires the .NET Framework

The RAD Studio installer does not install Microsoft .NET Framework 3.5 on Windows 8. Before starting the RAD Studio install, you should perform the following steps:

  1. Open the Control Panel.
  2. Choose 'Programs and Features'.
  3. Choose 'Turn Windows features on or off'.
  4. Select Microsoft .NET Framework 3.5, and its two subnodes (for HTTP Activation and non-HTTP activation).

If your machine is not connected to the internet, Microsoft provides instructions on how to install .NET Framework 3.5 from ISO. These instructions are at: http://msdn.microsoft.com/en-us/library/hh506443%28v=vs.110%29.aspx


System Requirements

  • Intel Pentium or compatible, 1.6GHz minimum (2GHz+ recommended)
  • Mouse or other pointing device
  • DVD-ROM drive (if installing from a Media Kit DVD)
  • 1024x768 or higher resolution monitor
  • Color quality above 256 colors (32-bit or 16-bit is sufficient)
  • 1GB RAM (2 GB+ recommended)
  • Between 3 and 18 GB (or more) of free disk space *
  • 0.5-1.5 GB additional temporary free space for use by the installer

*Installing Boost Libraries (C++Builder 32-bit Windows and 64-bit Windows)

Note: For a 64-bit Windows C++Builder installation, you might need 18 Gigabytes of free space (for the product installation) in order to ensure that the Boost Libraries are correctly installed.
  • On a 64-bit Windows system, both Boost 1.50.0 and Boost 1.39 are installed.
  • When installing Boost 1.39, two separate versions are installed (32-bit Windows and OS X).

For more information, see Boost Libraries or What's New in C++Builder 64-Bit Windows.


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), OS X 10.7 (Lion) or OS X 10.8 (Mountain Lion) over a local area network using a SSH, VNC or Windows file sharing solution

FireMonkey Requirements

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

FireMonkey applications run on multiple platforms with these requirements:

  • Basic Graphics Processing Unit (GPU):
    • For Windows development, any vendor DirectX 9.0 class or better (Pixel Shader Level 2)
    • For OSX development, OpenGL
      Note: Qualified Macs all have a qualified GPU.
  • 2 GB RAM or more

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:

  • Boost Libraries (if the product is C++Builder XE3)
  • CodeSite Express 5.1.1
  • CollabNet Subversion Client 1.7.5
  • Documentation Insight Express 2.1.8.19
  • FastReport 4 Embarcadero edition
  • Microsoft SDK Help

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\10.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:

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, Windows 7, and Windows 8 Require Administrator Privileges

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

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:

  • Serial Number: If you used a serial number to install the product, the serial number should be prepopulated in the registration dialog box. If the serial number is not present, please enter it in the registration dialog box.
  • Embarcadero Developer Network ID: You need to provide your EDN user name and password in the registration dialog box. To obtain an EDN account, go to http://edn.embarcadero.com.

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

Upgrading from Trial Edition Can Leave Files

After you upgrade a Trial edition to the Starter SKU or to the Professional SKU, there might be files left behind, such as command-line utilities and packages. The InterBase XE3 installation might not be uninstalled; InterBase XE3 is delivered with and can be used with RAD Studio XE3 Pro SKU.

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 integrated 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. On the compiled H2 help, just click the Current Wiki Page link at the bottom of a page of help.

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:
  • Microsoft SDK Help. By default, it is not installed.
  • Third party products will be installed unless you de-select them.

Installing for Network Licenses

If you purchased a Network License (managed by AppWave™ or the Embarcadero License Server or FLexlm), 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 deselect 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 deselect them.

Installing a Trial Edition

If you are going to use the trial edition, you can find the Delphi, C++Builder and RAD Studio trial downloads at:

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:

  • Choose Start menu | Programs | Embarcadero RAD Studio XE3 | Modify, Repair, Uninstall
    1. Select Modify.
    2. Choose the features that you want to add or remove.
  • Use Control Panel | Uninstall a program (Windows Vista and Windows 7).
    1. Select the product and click the Modify button.
    2. Choose the features that you want to add or remove.

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:

  • Delphi XE3 includes licenses for Delphi XE2, XE, 2010, 2009, 2007 and 7.
  • C++Builder XE3 includes licenses for C++Builder XE2, XE, 2010, 2009, 2007 and 6.
  • RAD Studio XE3 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 XE3 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 XE3 product.

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

Your network license certificate includes suite licenses that can be used to license any of the included 2007-XE2 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 XE3 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 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.

Known Installation Issues

  • Using an ESD install on Windows 7 or Windows Vista (especially with UAC enabled), if you choose a mapped network drive to download the 7zips to, the 7zips are instead downloaded to Temporary Internet Files (where they are subsequently deleted after install). The workaround for this issue is to use UNC (Universal Naming Convention). For example, you might use \\<servername> instead of the mapped network drive name Z:.
  • 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.
  • When installing dexplore.exe, a message says that it is a pre-release version of the license for Microsoft Document Explorer XE. You can ignore this message.
  • The uninstaller sometimes does not clean up the system path correctly. If you uninstall the product and reinstall a number of times, problems can occur. For example, your system path variable might become too long or the /bin64 directory might precede the /bin directory. Remove any duplicated paths.
    To edit the system path variable:
    1. On Windows 7 and Windows Vista: Select Start | Computer | System Properties | Advanced system settings | Environment Variables.
    2. In System Variables, select Path and click Edit.
  • 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.
  • Before you upgrade from a Trial to either the Pro SKU or the Starter SKU, you need to delete any Registry entries in HKEY_CURRENT_USER\Software\Embarcadero\10.0.
  • On Windows XP systems, during the DirectX portion of install, the following error might occur: "The application has failed to start because framedyn.dll was not found." The workaround is to add C:\Windows\system32\wbem to your PATH and then reinstall the product.
  • C++ Boost Libraries will not install on Vista or Windows 7 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 XE3, and Boost Libraries for C++Builder XE3 (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 .
  • AQtime installation might halt with the following error message: MS Help 2.x run-time 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. To install the AQtime online help, follow these steps:
    1. Complete the RAD Studio product installation.
    2. Install the product Help. This step installs the necessary run-time files, including dexplore.exe.
    3. Uninstall AQtime.
    4. Download AQtime installer from the Registered Users Download page at http://cc.embarcadero.com/reg/rad_studio.
    5. Reinstall AQtime.

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\10.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:

  • All Users\Application Data\Embarcadero\BDS\10.0
  • All Users\Shared Documents\Embarcadero\BDS\10.0

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

Personal tools
Previous Versions
In other languages