Installation Notes for XE2

From RAD Studio XE2
Jump to: navigation, search

Go Up to What's New in Delphi and C++Builder 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:

Contents

Minimum System Requirements for XE2

Windows Platforms

The following Windows platforms are supported as development platforms:

  • Microsoft® Windows 7 (32-bit and 64-bit)
  • Microsoft Windows VistaTM SP2 (32-bit and 64-bit) requires administrator rights
  • Microsoft Windows XP Home or Professional (32-bit and 64-bit) SP2 or SP3
  • Microsoft Windows Server 2003 (SP1) or 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 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:

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

Optionally:

  • The modeling functionality in the product 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 OS X 10.6 (Snow Leopard) or OS X 10.7 (Lion) over a local area network using an SSH, VNC or Windows file-sharing solution
  • For developing iOS applications (using Delphi or RAD Studio only), any of the following:
    • iOS SDK 4.2 and Xcode 3.2.5
    • iOS SDK 4.3 and Xcode 3.2.6
    • iOS SDK 5.0 and Xcode 4.2 (NOTE: Not all features of iOS SDK 5.0 are supported)


System Requirements

  • Intel Pentium or compatible, 1.6GHz minimum (2GHz+ recommended)
  • 1GB RAM (2 GB+ recommended)
  • 3-9 GB (or more) of free disk space
  • 0.5-1.5 GB additional temporary free space for use by the installer
  • 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)

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:

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

FireMonkey iOS Requirements

iOS development requires:

  • Delphi XE2 or RAD Studio XE2 on the PC
  • Free Pascal version 2.4.4 on the Mac (installed by Embarcadero or by user; will be built in the product as 2.5.x)
  • On a Mac running Snow Leopard OS:
    • iOS SDK version 4.2 or 4.3
    • Xcode 3.2.5 (paired with 4.2), 3.2.6 (paired with 4.3), 4.0.2 (paired with 4.3)
  • On a Mac running Lion OS:
    • iOS SDK version 4.3
    • Xcode 4.1
  • All iOS devices have a qualified GPU.

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:

  • Boost Libraries (if the product is C++Builder XE)
  • CodeSite Express 5
  • CollabNet Subversion Client 1.6.17
  • Documentation Insight Express 2
  • FinalBuilder 7 Embarcadero Edition
  • FastReport 4 Embarcadero edition
  • Microsoft SDK Help
  • Rave Reports 9.1.0 BE

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:

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

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:

  • 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), 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.

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 XE2 | Modify, Repair, Uninstall, select Modify, and then choose features to add or remove.
  • Use either:
    • Control Panel | Add or Remove Programs (Windows XP)
    • Control Panel | Uninstall a program (Windows Vista and Windows 7) Then select the product, select the Modify button, and 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 XE2 includes licenses for Delphi XE, 2010, 2009, 2007 and 7.
  • C++Builder XE2 includes licenses for C++Builder XE, 2010, 2009, 2007 and 6.
  • RAD Studio XE2 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 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:
    • 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.
      On Windows XP and Windows 2000: In Windows Explorer, right-click My Computer and select Properties. On the Advanced tab, click 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\9.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 XE2, and Boost Libraries for C++Builder XE2 (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\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:

  • Documents and Settings\<username> or All Users\Application Data\Embarcadero\BDS\9.0
  • Documents and Settings\<username> or All Users\Shared Documents\Embarcadero\BDS\9.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