
Delphi 8.0 for the Microsoft .NET Framework
Installation Notes

=======================================================
CONTENTS

* NOTES TO C#BUILDER 1.0 USERS
* MINIMUM SYSTEM REQUIREMENTS
* DETECTING PRE-REQUISITES WITH THE BOOTSTRAP UTILITY
* GENERAL INSTALLATION NOTES
* ADDITIONAL, OPTIONALLY INSTALLED PRODUCTS
* KNOWN INSTALLATION ISSUES
* UNINSTALLING THIS PRODUCT

========================================================
NOTES TO C#BUILDER 1.0 USERS

* Borland recommends that you install the C#Builder
  1.0 Update Pack 2 before installing Delphi 8 for
  .NET on the same machine.  Otherwise, uninstalling
  C#Builder will delete the registry entries for both
  C#Builder 1.0 and Delphi 8 for .NET.
  
  C#Builder 1.0 Personal Edition has no Update Pack #2,
  therefore, Borland recommends that you either save
  your HKEY_CURRENT_USER\Software\Borland\BDS\2.0
  registry settings before uninstalling C#Builder 1.0
  (or) repair the Delphi 8 for .NET installation from
  Control Panel | Add/Remove Programs | Repair option
  after uninstalling C#Builder 1.0.

* If setup detects that C#Builder 1.0 is installed on
  the machine, it will copy bds.exe.config to the bin
  directory of C#Builder 1.0 to allow co-existence
  with Delphi 8 for .NET. If setup fails to copy this
  file for some reason, you can find bds.exe.config in
  Extras\C#Builder directory in Delphi 8 Disk2.
  
  If you have C#Builder 1.0 Architect Edition, copy
  bds.arch.exe.config from Extras\C#Builder in Disk2
  to your C#Builder 1.0 Bin directory and rename
  bds.arch.exe.config to bds.exe.config.

  If you have C#Builder 1.0 Enterprise, Professional
  or Personal Editions, copy bds.exe.config from
  Extras\C#Builder in Disk2 to your C#Builder 1.0 Bin
  directory.
  
  By default, the C#Builder Bin directory is located at 
  C:\Program Files\Borland\BDS\1.0\Bin.
  
========================================================
MINIMUM SYSTEM REQUIREMENTS

* The following Windows platforms are supported:

  -Microsoft Windows 2000 (SP2 or higher and security
   updates are recommended)
  -Microsoft Windows XP Professional
  -Microsoft Windows Server 2003

* Microsoft Internet Explorer 6.0 SP1 or later

  NOTE: The English version of Delphi 8 for .NET updates
  Internet Explorer with the English version of Internet
  Explorer 6.0 SP1. If you are running a localized
  operating system, run Windows Update to ensure that
  you get the proper localized version of Internet
  Explorer.

* Delphi 8 for .NET requires approximately 225 MB of
  disk space for the complete install setup option.

* The .NET Framework version 1.1 requires approximately
  150 MB of disk space.

* The .NET Framework SDK version 1.1 requires
  approximately 850 MB of disk space.

* Intel Pentium 233 MHz or higher (450 MHz
  recommended)

* 128 MB RAM

* CD-ROM drive

* VGA or higher resolution monitor

* Mouse or other pointing device

=======================================================
DETECTING PRE-REQUISITES WITH THE BOOTSTRAP UTILITY

The bootstrap utility detects whether the following
Delphi 8 for .NET pre-requisites are installed on your
system:

* Microsoft Internet Explorer 6.0 SP1
* Microsoft .NET Framework v1.1
* Microsoft .NET Framework SDK v1.1
* Microsoft Visual J# .NET v1.1 Redistributable

If you install Delphi 8 for .NET using the installation
launcher (install.exe in the root directory on Disk
1), the bootstrap utility runs automatically.

However, if you install Delphi 8 for .NET using
setup.exe in the "Install" directory on Disk 1, the
bootstrap utility is bypassed. Borland recommends that
you run the bootstrap utility before running
setup.exe. Run prereqs.exe in the "Install" directory
on Disk 1.

If the utility does not find the pre-requisite
software on your system, it prompts you to install the
software. Reply yes to the prompts to install the
software required for Delphi 8 for .NET to function
properly. If you reply no, the Delphi 8 for .NET
installation will not continue if any of the pre-
requisites are not found.

=======================================================
GENERAL INSTALLATION NOTES

------------------------------------------------------
Multiple users on one machine 

The product is installed only once, 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 new licensed users you may
add later.

------------------------------------------------------
Installer may require a reboot

You will be prompted to reboot your system at the end
of the Delphi 8 for .NET installation if you have chosen
to install Internet Explorer 6.0 SP1 from the
bootstrap utility (prereqs.exe).

------------------------------------------------------
Installer may require additional temporary space

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

------------------------------------------------------
Assemblies installed in the Global Assembly Cache

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

The assemblies in the GAC can be used to test
deployment. The duplicate copy of the assemblies
in the above mentioned directory can be used for
development purposes.

------------------------------------------------------
Installing another edition of Delphi 8 for .NET

Delphi 8 for .NET stores assembly and Tool Palette
configuration information in the file
ApplicationSettings.xml, located in the user's home
directory at "Documents and Settings\<username>\Local
Settings\Application Data\Borland\BDS\2.0."

This file is not deleted during an uninstall and might
cause assembly version errors in the IDE if you
install another edition of Delphi 8 for .NET (for
example, Enterprise or Architect) on the same machine.
To avoid this problem, delete ApplicationSettings.xml
BEFORE installing another product edition.

------------------------------------------------------
Note to BDP .NET users

Setup will generate BdpDataSources.xml and
bdpConnections.xml depending upon the providers you
choose during installation. If you choose the
"Complete" setup type, all providers will be
installed. At the end of the installation, setup will
prompt you to overwrite the bdpConnections.xml file if
it exists in the destination directory. If you choose
"No" for this prompt, you may have to manually edit
the bdpConnections.xml file to resolve errors that
occur during IDE startup. By default, the file is
located at C:\Program Files\Borland\BDS\2.0\Bin.

=======================================================
ADDITIONAL, OPTIONALLY INSTALLED PRODUCTS

* Borland InterBase 7.1 Developer Edition
  
  Provides a complete developer version of the
  InterBase high-performance, cross-platform
  embeddable database that is simple and inexpensive
  to deploy and economical to maintain.

* ComponentOne Studio Enterprise for Borland Delphi 8.0
  
  Provides over one hundred grid, reporting, charting,
  data, user-interface, and e-Commerce components for
  .NET and ASP.NET.

* Wise Owl Demeanor for .NET, Personal Edition
  
  A .NET obfuscation tool that assists in protecting
  intellectual property by making it difficult to
  reverse engineer managed code applications and
  assemblies.

=======================================================
KNOWN INSTALLATION ISSUES

* The Microsoft .NET Framework v1.1 must be installed
  prior to using the Control Panel "Add or Remove
  Programs" tool to Remove, Repair, or Modify Delphi 8
  for .NET. If the .NET Framework is not installed,
  the Remove/Repair/Modify operation will display
  error messages when attempting to register or
  unregister assemblies, and will roll back the
  operation performed.
  
* If you modify the Delphi 8 for .NET installation by
  clicking the "Change" button in Add/Remove
  Programs and choosing the "Modify" option to
  add/remove features, setup will make the appropriate
  changes in the registry only in HKEY_LOCAL_MACHINE.
  Follow the guidelines below to make these changes in
  HKEY_CURRENT_USER.
  
  NOTE: Read the WARNING at the end of this file
        before editing your system registry.

  For features that are added through this option,
  either:

  i)  manually edit the
      HKEY_CURRENT_USER\Software\Borland\BDS\2.0\Known
      Assemblies, Known IDE Packages and Known IDE
      Assemblies registry keys to include the new
      assemblies or packages that were registered by
      the setup in
      HKEY_LOCAL_MACHINE\Software\Borland\BDS\2.0.

  ii) delete the
      HKEY_CURRENT_USER\Software\Borland\BDS\2.0
      registry key and re-start the IDE to get the
      updated registry settings. But by doing so, you
      will lose your customized IDE Editor settings.

  For features that are removed through this option,
  either:

  i)  manually edit the
      HKEY_CURRENT_USER\Software\Borland\BDS\2.0\Known
      Assemblies, Known IDE Packages and Known IDE
      Assemblies registry keys to delete the
      assemblies or packages that were removed by the
      setup in
      HKEY_LOCAL_MACHINE\Software\Borland\BDS\2.0.

  ii) Delete the
      HKEY_CURRENT_USER\Software\Borland\BDS\2.0
      registry key and re-start the IDE to get the
      updated registry settings. But by doing so, you
      will lose your customized IDE Editor settings.

  iii) Without making any changes in the registry,
       just re-start the IDE and click on "No" for all
       the "Package not found" errors and "Assemblies
       not found" errors. This will automatically
       remove the correct assembly entries from the
       registry and should prevent these errors when
       starting Delphi 8 for .NET.
       
* When modifying the Delphi 8 for .NET installation
  by clicking the "Change" button in Add/Remove
  Programs to install additional products, such as
  Component One, Wise Owl Demeanor, InterBase 7.1
  Client, you have to put the Disk 1 in the drive for
  the Delphi 8 install to launch these setups
  automatically.
  
* Installing InterBase 7.1

  When installing InterBase 7.1, use the launcher
  (install.exe at the root of Delphi8 Disk1).  If you
  install InterBase by running IB71\win32\setup.exe on
  Disk1, you will either have to choose the "Evaluate
  the Product" checkbox or enter the Certificate ID
  and key to continue with the installation. If you
  choose to evaluate the product, you will encounter
  an error, "CertCanNotConvert," at the end of the
  installation. This will be fixed in the next version
  of InterBase.
  
* Uninstalling Delphi 8 when an earlier version of
  Delphi or C++Builder product installed:

  If you have BDE installed from any earlier version
  of Delphi or C++Builder Enterprise Edition that co-
  exists with Delphi 8 Architect or Enterprise
  Editions, Borland strongly recommends that you
  perform a back up of the idapi32.cfg file in your
  BDE directory (by default C:\Program Files\Common
  Files\Borland Shared\BDE) before uninstalling Delphi
  8. The Delphi 8 uninstallation removes some BDE
  files including idapi32.cfg and this causes all pre-
  configured BDE aliases to be removed after
  uninstallation. If you have performed a back up of
  idapi32.cfg, then you can restore the BDE aliases by
  renaming the back up copy to idapi32.cfg after
  Delphi 8 uninstallation. You may also have to repair
  the earlier version of the Delphi or C++Builder
  product by using Add/Remove Programs to restore the
  other missing BDE files.
        
=======================================================
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
Borland Delphi 8.0 product 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\Borland\BDS\2.0

WARNING: Registry edits are performed at your own
         risk. This document and other documentation
         that accompanies this product describe how to
         edit your Windows registry. In most cases,
         Borland recommends that you use the Microsoft
         Regedit tool to perform editing. Whatever
         tool you use, however, you should, before
         making any edits, 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 made while editing it can cause your
         machine to stop functioning.

=======================================================
Copyright (c) 2003 Borland Software Corporation.
All rights reserved.
