Published August 14, 2009
Before Installation... Installation Process... Registration Process... Post Install... Platform Specifics... For a list of recent bug fixes and updated contact information, please
refer to the Readme.html. For a list of add-ons and licenses you can obtain for
InterBase products, see Chapter 2, Licensing, in the InterBase Operations
Guide. You receive all six InterBase user guides in PDF format at the time
of purchase. Check http://edn.embarcadero.com/interbase
for a variety of information and resources of interest to those who develop and
maintain InterBase databases and applications. Embarcadero maintains several active newsgroups for
InterBase users. To access them, go to http://forums.embarcadero.com/.
The following table lists
the system requirements for installing and running InterBase 2009 Update 3. System Area Requirement Platform Microsoft Windows Vista Processor Microsoft Windows and Linux: Intel x86 JDK Compatibility All platforms: JDK 1.4, 5, and 6 Hard disk space 20 MB for compact installation InterClient 2009 server is certified
to work with a compatible InterBase 2009 client. Since there are no breaking
API changes, earlier versions of InterBase clients may work with the current
version of the server also. IMPORTANT! Mixing InterBase client and server
versions is not supported. It is strongly recommended that compatible client
and server versions are used for local connections on Windows. You can install InterBase
after downloading it from the web, or by using the InterBase 2009 installer
(installing from a CD or DVD). The InterBase 2009
installer installs InterBase on Windows, Linux, Solaris, and Mac OSX. As part of
this installation, you have the opportunity to register the product. InterBase
2009 must be registered before you can start the server; though there is a way
to use it without registering during the grace period (read below). If
the server is started without entering any licensing information an error
message with the registration key is logged in interbase.log; use this
to register with the Serial Number if you execute any mode other than Direct
Registration detailed below.
Contents
All platforms
General Information
System Requirements/Prerequisites
Microsoft Windows Server 2003, 2008
Microsoft Windows XP (SP2)
Microsoft Windows 2000 (SP4)
Sun Solaris 10
Red Hat Enterprise Linux 4 and 5
SUSE Linux 10
Mac OS X 10.5
Sun Solaris: SPARC
Mac OS X: Intel x86
35 MB for full installationServer/Client
Compatibility
Installation and
Registration
No new registration
is required for InterBase Update 3. However, you need
to register InterBase 2009 if you are upgrading from a previous major release of InterBase
such as 2007 or 7.x versions.
Installing and registering
the product provides a base level of functionality; the exact level of
functionality depends on whether you are installing the Desktop Edition or the
Server Edition.
To add more users, more
processors, or to license the product for Internet use, you need to purchase
more licenses from the CodeGear shop site
or from your sales representative. The license key and registration are
explained in the "Licensing" chapter of the Operations Guide. You
will find this and the other InterBase books in the <interbase_home>/doc
directory. See Licensing users and processors below for
more details.
There is a registration
limit imposed on every Serial Number. For any unforeseen circumstance, if you encounter
this limit while registering your Serial Number, please visit http://reg.codegear.com/bump to get a
temporary increment and register once again. It is not common for one to hit this
limit.
Note: For older
InterBase version users - InterBase 2009 licenses are not compatible with earlier
InterBase version licenses. InterBase 2009 requires new license purchase.
The following instructions
guide you through the process of downloading, installing, and registering
InterBase 2009.
Note
about the InterBase ToGo Edition: The
InterBase ToGo edition includes two (2) zip files: ibtogo.zip and ibtogo_min.zip. The
ibtogo.zip file
includes all the files you need for development using the InterBase ToGo
edition. The ibtogo_min.zip file includes the minimal set of files required to
deploy the InterBase ToGo edition. To install the InterBase ToGo edition,
extract the appropriate zip file to a location as specified in the
"Client/Server Concepts" chapter of the InterBase Developer's
Guide.
The following instructions guide
you through the process of installing and registering InterBase using the
cross-platform installer. You are encouraged to use this installer when
possible. A console (command-line) installer is available for Linux and Solaris
users who have environments that are not compatible with a GUI installer.
However, to use the command-line installer on a Solaris or Linux computer, you
must also have a copy of X-Windows installed. See Command-line
installation for instructions on how to run the installation from a console
window.
root to install. Windows and Mac OSX users must be logged
in as a user with Administrative privileges. |
Button |
What it does |
|
Install Embarcadero InterBase 2009 Server |
Installs the main InterBase 2009 product. |
|
InterBase 2009 on the web |
Connects you to http://www.codegear.com/interbase. |
|
Browse CD |
Lets you browse the InterBase CD-ROM. |
|
Setup Information |
Displays this file. InterBase strongly recommends that you look
this over before proceeding with the installation. |
|
Exit |
Exits Installation. |
<interbase_home>/bin/LicenseManagerLauncher -i Console7.
In the first panel of the Registration Wizard, choose Have Serial
Number and click Next. In the next panel, enter the Serial Number and Key from
the back of the InterBase CD-ROM jacket. The Next button becomes available only
when you have entered a valid Serial Number and Key.
8.
Select a registration method: your choices are Direct, Email, Web
page, or Telephone. If the machine you are installing on has an active internet
connection, Direct is the easiest and fastest method and you are encouraged to
use it. If you choose the Web, Email, or Telephone option, you receive an
activation file by email that you must place manually following the directions
below. Choose the Telephone option if you have no internet connection or
experience difficulties with the other registration methods.
9.
InterBase 2009 includes a registration grace period of 14 days, if
you add a valid serial number after installing the product, but do not choose
to register at that time. If you use the License Manager utility to add your
serial number, be sure to choose the File > Save command afterward or the grace
period will not be in effect.
If you use a dial-up connection to
the Internet, be sure that you are connected to the internet before proceeding.
1.
The next panel requests your Embarcadero Developer Network account
information. If you have registered an Embarcadero product before or have joined the
Network on the Embarcadero web site, you should choose "I have an
account."
o
If you do not have an account, choose "I do not have an
account" and you will be guided through the steps for creating an Embarcadero
Developer Network account. You cannot create a new account using an email or
login that is already in use for an existing account.
o
If you choose "I have an account," the following panel
requests your DN account information. You can enter either the email that you
used to create your original account, or the login name. You do not need both.
You do need to enter the password.
2.
If you connect to the Internet through a proxy server, you should
check the "Use proxy server" box when it appears. You are then asked
for a URL and port. If you do not have this information, you can get it from
Internet Explorer: Choose Tools > Internet Options > Connection > Lan Settings.
3.
Look over the Information Summary and click Next.
Please go to Finishing
up to continue with these instructions.
1.
The next panel requests your Embarcadero Developer Network account
information. If you have registered an Embarcadero product before or have joined the
Network on the Embarcadero web site, you should choose "I have an
account."
o
If you do not have an account, choose "I do not have an
account" and you will be guided through the steps for creating an Embarcadero
Developer Network account. You cannot create a new account using an email or
login that is already in use for an existing account.
o
If you choose "I have an account," the following panel
requests your DN account information. You can enter either the email that you
used to create you original account, or the login name. You do not need both.
You do need to enter the password.
2.
Look over the Information Summary and click Next.
3.
The Email Registration panel displays, with text highlighted.
Click the Clipboard Copy button.
4.
Click OK on the window that notifies you of a successful copy and
click Next.
5.
Click Finish in the next panel and Done in the final panel.
6.
Launch your email client and compose an email message to reg@codegear.com. Paste the contents of the
clipboard into the body of the email and send it.
7.
Check your email and look for one with "CodeGear Product
Registration" in the subject line. Save the attached text file to the
<interbase_home>/license directory.
Please go to Finishing
up to continue with these instructions.
1.
The next panel displays the URL of the registration site and also
gives you a Registration Key. Copy this number down or print the page. Click
Finish.
2.
Open a browser and go to the URL provided: http://reg.codegear.com/.
3.
Log in to your Embarcadero Developer Network account. If you do not
have an account, click Create account.
4.
After you have logged in, enter the Serial Number from the
InterBase CD-ROM jacket (the same one you used in the installation) in the top
field. In the bottom field, enter the Registration key that you copied from the
installation screen. Click Continue.
5.
Check the email address to be sure it is correct, and click
Register.
6.
Check your email and look for one with "Embarcadero Product
Registration" in the subject line. Save the attached text file to the
<interbase_home>/license directory.
Please go to Finishing
up to continue with these instructions.
Phone registration is an option if
you have no email connection. It also provides someone who can assist you if
you have difficulties with the installation and registration process. The
contact information is available at: http://www.codegear.com/about/contact
If you have an email address, you
will receive an email with "Embarcadero Product Registration" in the
subject line. Your activation file is attached to this email. If you do not
have email, Embarcadero will send you the activation file on a floppy disk.
Save the activation file in
<interbase_home>/license directory.
Please go to Finishing
up to continue with these instructions.
Return to the opening panel if it is
still displayed and choose the connectivity drivers that you want to install.
Otherwise, run the InterBase installer again and choose the "Install
InterBase Connectivity Drivers" button. Choose a driver to install and
follow the prompts. Note that the JDBC driver is automatically installed, so it
is not displayed as a driver choice.
The InterBase installer provides the
following drivers:
|
ADO.NET driver for InterBase |
|
DataDirect ODBC Driver |
InterBase 2009 includes a Windows/English-only installer to
help make embedding InterBase easy. The installer is located in the: Disk1\InstData\Windows\VM directory
of the CD and is named, "ib_install.exe".
Command line options for
ib_install.exe:
/S (run installer in
silent mode)
/M=<filename>
(this file contains custom settings for your installation)
You can define custom parameter
values (say values.txt) as follows. The default values are:
MAINDIR=C:\CodeGear\InterBase TCP_PORT=3050 INSTANCE=gds_db COMPONENTS=A,C,D
where the variables are defined as:
MAINDIR - The location of the InterBase
Root Directory
TCP_PORT - default is 3050
INSTANCE - default is gds_db
COMPONENTS - This is a comma separated list of
the Components that will be installed.
The options for COMPONENTS are:
A = Server and ClientB = Client onlyC = DocumentationD = Registration (will not work in silent install mode)
For example, if the following values
are saved in a file named values.txt, and you execute the command: ib_install.exe /s /m=values.txt, you will launch the silent
installer with the settings from this file. If the values file is not found,
the Silent Install will assume the default values as detailed above.
MAINDIR=C:\CodeGear\InterBase TCP_PORT=3080 INSTANCE=myib_inst COMPONENTS=A,C
You can also provide custom values
via such files to the GUI installer by executing ib_install.exe without the /s flag.
Note: To include a license activation
file (*.slip) with your installation, save the activation file into the
directory where the ib_install.exe file is located.
For UNIX installations, as well as
Japanese Windows installations.
The installer is named ib_install.exe on Windows platforms
and ib_install.bin on
UNIX Platforms. Using a property file that contains the variables for a specific
install can customize the installer. Property files should be placed in the
same directory as the installer. Sample property files are available under the
extras directory of the InterBase CD.
Windows example (Japanese
installation only):
ib_install.exe -f ib_install.properties
UNIX example:
ib_install.bin -f ib_install.properties Variables
The mode that InstallAnywhere-based
installer should run in
GUI
Silent
Console (UNIX platforms only)
Example:
INSTALLER_UI=silent
The Install set that wish to use:
Server (Server and
Client)
Client (Client Only)
Register (can only used
in GUI mode)
Example:
CHOSEN_INSTALL_SET=Server SLIP_FILENAME (Value Added resellers only)
The location of the slip file that
you will be using for InterBase.
Example:
SLIP_FILENAME=C:\\slipdir\\myslipfile.slip
This is the install location for
InterBase.
The default is C:\\CodeGear\\InterBase
Set to No by Default. If you want to
take advantage of the InterBase 2009 Multi-Instance feature, set
MULTI_INSTANCE=Yes. It is important to set the LABEL and PORT variables to
something other than the default to not interfere with other version of
InterBase running on the system
Default is 3050. This only needs to
be set if MULTI_INSTANCE is set to Yes. Please choose a Port number that will
not interfere with other programs on the server machine
Default is gds_db. This only needs
to be set if MULTI_INSTANCE is set to Yes.
All Features are installed as
Default and can only be disabled by setting the Feature to False.
Server: This includes
the server, the guardian, the license file, the message file, the configuration
file, and database information tools
Client: This includes
the client library, the license file, and the message file
Graphical tools:
Graphical tools for InterBase and the associated help files. Short name is GT. To
disable set GT=FALSE
Development support:
Development tools for InterBase, including gpre. Short name is DS. To disable
set DS=FALSE
Documentation: InterBase
Documentation. Short name is DOCS. To disable set DOCS=FALSE
Command line tools: This
includes database management tools, database query tools, and user management
tools. Short name is CLT. To disable set CLT=FALSE
Examples: Example
databases and example programs that use embedded SQL, dynamic SQL, and the
InterBase API. Short name is EXAMPLES. To disable set EXAMPLES=FALSE
InterClient JDBC: The
type 4 driver allows access to all features of InterBase through JDBC. Also
includes samples and docs. Short name is JDBC. To disable set JDBC=FALSE
Register: Used to
register InterBase (GUI only) short name is REG. To disable set REG=FALSE. You
must set REG to FALSE even if you are doing a silent or console installation
Here is an example of a silent install
without DOCS, JDBC, and Registration. You will notice that it specifies a slip
file location, uses Label of gds_db1 and Port number of 3060
INSTALLER_UI=silent CHOSEN_INSTALL_SET=Server DOCS=FALSE JDBC=FALSE REG=FALSE SLIP_FILENAME=c:\\myslip.slip MULTI_INSTANCE=Yes SERVER_TCP_PORT=3060 INSTANCE_NAME=gds_db1
Client: This includes
the client library, the license file, and the message file.
Graphical tools: Graphical
tools for InterBase and their associated help files. Short name is GT. To
disable set GT=FALSE
Command line tools: This
includes database management tools, database query tools, and user management
tools. Short name is CLT. To disable set CLT=FALSE
InterClient JDBC: The
type 4 driver allows access to all features of InterBase through JDBC. Also
includes samples and docs. Short name is JDBC. To disable set JDBC=FALSE
Silent Client install without JDBC to
non-default location
INSTALLER_UI=silent CHOSEN_INSTALL_SET=Client JDBC=FALSE USER_INSTALL_DIR=/opt/interbase
This completes your InterBase installation
and registration. You now need to install any licenses that you have purchased
for users, processors, and Internet use. Please see Licensing
Users and Processors for information on licensing.
If your Linux or Solaris environment
does not support the GUI installer, you can use the following steps to perform
a console installation.
Use the TAR package to install
InterBase (see .tar install instructions for Linux and Solaris) or use the InstallAnywhere-based installer. The
InstallAnywhere-based installer requires X Window System libraries to be
available. If they are not available, you will get the error "Installer
User Interface Mode not Supported".
In addition, InterBase 2009 has a
14-day grace period for registration, but this feature requires a GUI and is
not available to Linux and Solaris installations that do not have a GUI.
Installing InterBase
1.
If an InterBase server is running, shut it down and uninstall any
previous versions of InterBase.
2.
On your InterBase CD-ROM, go to the directory for your platform
(Linux or Solaris) and run ib_install.bin
with the -i flag.
ib_install.bin -i Console
Follow the prompts.
3.
When installation is complete, you must register InterBase in
order to start the server. You have the following choices:
o
On Linux and Solaris, if you wish to register from a shell command
line, please execute the command
<interbase_home>/bin/LicenseManagerLauncher -i Console
For some platform-specific issues
related to installation, please see the sections below:
For more information about InterBase
options, please visit the CodeGear
InterBase Portal. The Licensing chapter in Operations Guide PDF
manual covers this topic in more detail.
You will have the following basic
functionality after you register:
Desktop and ToGo
Edition(s): Permits local connections only (same machine), enables eight
cores/processors and eight simultaneous connections.
Server Edition: Enables
eight CPU cores/processors and one user (4 connections).
You can purchase licenses to enable
additional simultaneous users, additional processors, and Internet use through
the Embarcadero web site or through your sales representative.
Please read the document InterBase on Microsoft Vista to
get an understanding of what changes were made since the InterBase 2007 SP1 release in order for it
to function well on that platform.
IMPORTANT! You cannot install InterBase onto a
network drive.
If you have InterBase installed on
your computer, you will need to follow these steps before you install a new
version:
Go to Services and shut
down InterBase Guardian and Server.
CLOSE THE SERVICES
APPLICATION. If you do not close this, the install fails until you reboot.
Go to Control Panel and
launch "Add or Remove Programs."
Remove InterBase.
Delete the full
InterBase directory.
Delete gds32.dll from
c:\winnt\system32.
Install InterBase.
Use the following files to install
InterBase 2009 on Linux:
InterBaseC_LI-V2009.tar
InterBaseSS_LI-V2009.tar
setup
License.txt
Execute the setup script.
Choose to install Server and Client
or Install Client only.
Follow the prompts to configure:
Installation directory
Multi-instance option
Instance name and port
Run InterBase as a
service
The script installs InterBase to the chosen location, sets the correct variables to allow InterBase to run remotely, and links to InterBase libraries.
Note: The installer must be run with “root” privileges.
Note: Command line registration is not available.
In a Multi-Instance install the
/usr/interbase symbolic link is not automatically created. Set the INTERBASE
and LD_LIBRARY_PATH environment variables to use that particular instance of
InterBase. This does not apply to "single" instance installations.
If you are planning to install the
InterBase 2009 software over an older version installed on the server machine,
and you want to preserve the customization files, copy them to a safe place,
for example:
gbak -b /usr/interbase/admin.ib /tmp/admin.ibkcp /usr/interbase/ib_license.dat /tmpcp /usr/interbase/ibconfig /tmp
You can skip this step if you
haven't customized these files in a previous installation.
To run InterBase as a service, run:
/usr/interbase/examples/ibservice.sh -s[tart]
When you choose to run InterBase as
a service, the InterBase server starts automatically whenever the machine is
running in a multi-user mode.
To remove InterBase as a service,
run:
/usr/interbase/examples/ibservice.sh -r[emove]
You must then start the InterBase
server manually whenever you need it.
Use the following files to install
InterBase 2009 on Solaris:
• InterBaseC_SO-V2009.tar
• InterBaseSS_SO-V2009.tar
• setup
Execute the setup script.
Choose to install Server and Client
or Install Client only.
Follow the prompts to configure:
Installation directory
Multi-instance option
Instance name and port
Run InterBase as a
service
The script installs InterBase to the
chosen location, sets the correct variables to allow InterBase to run remotely,
and links to InterBase libraries.
Note: The installer must be run with
“root” privileges.
Note: Command line registration is not
available
In a Multi-Instance install the
/usr/interbase symbolic link is not automatically created. Set the INTERBASE
and LD_LIBRARY_PATH environment variables to use that particular instance of
InterBase. This does not apply to "single" instance installations.
If you are planning to install the
InterBase 2009 software over an older version installed on the server machine,
and you want to preserve the customization files, copy them to a safe place,
for example:
gbak -b /usr/interbase/admin.ib /tmp/admin.ibkcp /usr/interbase/ib_license.dat /tmpcp /usr/interbase/ibconfig /tmp
You can skip this step if you
haven't customized these files in a previous installation.
If InterBase is running on your
server, shut it down. To save the current version, rename the directory, for
example:
mv /usr/interbase /usr/interbase.save
To run InterBase as a service, run:
/usr/interbase/examples/ibservice.sh -s[tart]
When you choose to run InterBase as
a service, the InterBase server starts automatically whenever the machine is
running in a multi-user mode.
To remove InterBase as a service,
run:
/usr/interbase/examples/ibservice.sh -r[emove]
You must then start the InterBase
server manually whenever you need it.
In a multi-instance install the
/usr/interbase symbolic link is not automatically created to your install
location. Set the INTERBASE and DYLD_LIBRARY_PATH environment variables to use
that particular instance of InterBase. This does not apply to
"single" instance installations.
When you install the product,
InterBase is setup automatically to run as a service. You will notice that the
/Library/StartupItems/ folder on your machine has an entry to run the InterBase
server whenever the system boots up.
The following issues are still in
the process of being resolved.
The 16-bit UNICODE character sets
UNICODE_LE and UNICODE_BE only work for Server character sets. These character sets
cannot be used as a client character set. If your client needs full UNICODE
character support, please use UTF8 instead of UNICODE_LE and UNICODE_BE for the
client character set (aka LC_CSET). A client can use the UTF8 (or other native)
client character set to connect with a UNICODE database.
InterBase 2009 supports no defined
UNICODE collations in this release. The default collation is binary sort order
for UNICODE.
Copyright © 1986-2009
Embarcadero Technologies, Inc. All Embarcadero brand and product names are
trademarks or registered trademarks of Embarcadero Technologies in the