Embarcadero(R) InterBase(R) 2017 Installation, Registration, and Licensing

Installation, Registration, and Licensing Information for
Embarcadero&reg InterBase&reg 2017

Published March, 2017

Contents

Before Installation...
  All Platforms General Information System Requirements/Prerequisites Server/Client Compatibility  
Installation Process...
  Installation and Registration Downloading and Installing Using the Installer Install Drivers Using the Wise Installer to Embed InterBase Installing on Japanese Versions Command Line Installation
Registration Process...
  Registration  
Post Install...
  Licensing Users, Processors, and Strong Encryption  
Platform Specifics...
  Linux  

All platforms

General Information

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://edn.embarcadero.com/help/forums.

Return to top of page

System Requirements/Prerequisites

The following table lists the system requirements for installing and running InterBase.

System AreaRequirements
Windows - InterBase 2017

InterBase 2017 32-bit 64-bit supported on:

  • Windows 10
  • Windows 8.1
  • Windows 8
  • Windows 7
  • Windows Vista
  • Windows Server 2016
  • Windows Server 2012 R2
  • Windows Server 2012
  • Windows Server 2008
  • Windows Server 2008 R2
Linux - InterBase 2017

InterBase 2017 supported on:

  • RHEL 6
  • RHEL 7
  • SuSE 11.3
  • Ubuntu 14
  • Ubuntu 16
OS X Platforms InterBase ToGo and IBLite editions.
  • Sierra (10.12)
  • El Capitan (10.11)
  • Yosemite (10.10)
iOS Platforms InterBase ToGo and IBLite editions.
  • iOS 10
  • iOS 9
  • iOS 8
  • iOS 7
Android Platforms InterBase ToGo and IBLite editions.
  • Nougat (7.x)
  • Marshmallow (6.x)
  • Lollipop (5.x)
  • Android (4.x)
Product - InterBase XE
  • Windows 7 Enterprise (32-bit)
  • Windows Vista (32-bit and 64-bit)
  • Windows Server 2009
  • Windows Server 2008 R2
  • SUSE Linux 10 and 11
  • Amazon EC2
Product - InterBase SMP 2009
  • Microsoft Windows Server 2003 (32-bit)
  • Microsoft Windows 2000 (SP4)
  • Red Hat Enterprise Linux 4 and 5
  • SUSE Linux 10

Processor

Microsoft Windows

JDK Compatibility - InterBase XE7

All platforms: JDK 6 and 7

JDK Compatibility - InterBase XE

All platforms: JDK 6

JDK Compatibility - SMP 2009

All platforms: JDK 1, 4, 5, and 6

Hard disk space

44 MB for compact installation 56 MB for full installation (includes PDF help files)


Return to top of page

Server/Client Compatibility

InterBase 2017 server is certified to work with a compatible InterBase 2017 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.

Return to top of page

Installation and Registration

You can install InterBase after downloading it from the web, or by using the InterBase 2017 installer (installing from a Media Kit).

The InterBase 2017 installer installs InterBase on Windows and Linux. As part of this installation, you have the opportunity to register the product. InterBase 2017 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. This registration code along with your serial number may then be used to register your software on any computer by going to http://reg.embarcadero.com.

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. It is important to note that the Desktop edition is only available for the Windows operating systems.

Note: InterBase ToGo and IBLite are available through XE3 editions.

To add more users, more processors, or strong encryption, you need to purchase additional appropriate licenses from the Embarcadero shop site http://shop.embarcadero.com 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, processors, and strong encryption below for more details.

Note: For older InterBase version users - InterBase 2017 licenses are not compatible with earlier InterBase version licenses. InterBase 2017 requires a new license purchase.

Return to top of page

Downloading and Installing

The following instructions guide you through the process of downloading, installing, and registering InterBase XE7.

  1. Download InterBase 2017 to your local computer or server.
  2. Extract the .zip file to a new directory.
  3. Run the install_windows.exe, or install_linux_x86.sh or install_linux_x86_64.sh, depending upon the platform you are installing on,
  4. Follow the instructions below for Registration.
  5. Start InterBase and your product is activated.
NOTE: ToGo and IBLite Editions are currently supported on the XE3 Edition. For information on how to install the ToGo or IBLite Editions, click here to open the InterBase ToGo and IBLite Quick Start.

Return to top of page

Using the Installer

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 Unix users who have environments that are not compatible with a GUI installer. However, to use the command-line installer on a Unix OS, 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.

Preparing to install:

  1. If you are installing InterBase 2017 on a machine for the first time, you need to register the product as part of the installation. This applies to upgrades from previous versions, as well as completely new installations. To prepare for the registration phase of the install, be sure you have the following available:
  2. If you are upgrading from a previous version, you should also perform the following actions:
    Before un-installing a previous InterBase version, back up any existing databases using your existing version of InterBase.
    • InterBase 2017 uses a new major on-disk structure version, ODS 17.0. This is required to accommodate new system tables, and changes to existing system tables. Databases created with earlier versions of InterBase are not automatically upgraded to ODS 17.0 when an InterBase 2017 server attaches to these databases.
    • To migrate these databases to the new ODS, backup these databases with the older version of InterBase and restore them using InterBase 2017 IBConsole or gbak. This database restore operation automatically creates a database with the latest ODS version (as supported by the engine).
    • It is highly recommended that you upgrade to the latest ODS. Support for ODS Versions 12 and lower is disabled. Versions 13 to 17 are supported.
    • InterBase XE7 introduced scaled integer (64-bit) support for Performance Monitoring counters that could benefit from them. This depends on the ODS version of your database as follows.
    • ODS 15 remains the same as before and only supports 32-bit Integer counters.
    • ODS < = 15 will continue to have 32-bit INTEGER counters as before (for both dialect 1 and dialect 3 databases).
    • ODS > = 16 will have the counters defined as "double precision" data type for dialect 1 databases.
    • ODS > = 16 will have the counters defined as "NUMERIC(18,0)" data type for dialect 3 databases. By default, a new database is created as ODS 16, dialect 3. It will benefit from the scaled counter support.
    • Make a backup copy of your security database (admin.ib by default).
    • Make a backup copy of your ibconfig file.
    • Stop the InterBase server and un-install InterBase.
    • As with any installation, Embarcadero strongly recommends that you stop all running applications, including your virus checker.
    • Linux users must log in as root to install. Windows users must be logged in as a user with Administrative privileges.
  3. Run the install program:
    • On Windows platforms, run install_windows.exe.
    • On Linux platforms, run install_linux_x86.sh or install_linux_x86_64.sh
  4. When you first run the install program, the opening panel displays the following options:
ButtonWhat it Does
Install InterBase 2017 Installs the main InterBase 2017 product.

 

InterBase 2017 on the Web Connects you to http://www.embarcadero.com/interbase.

 

InterBase Setup Information Displays this setup document. InterBase strongly recommends that you review this information before proceeding with the installation.

 

Exit Exits Installation.

Take the following steps to complete the process:

  1. Select InterBase 2017, click Install, and follow the prompts to accept the license agreement.
  2. In the next panel, choose Architecture 32 or 64. Also select if you want to uniquely identify the instance. The default setting is "No".
    NOTE: The architecture option only applies to the English installer on Windows.
  3. In the Select Components panel, choose "Server and Client," "Client Only," or "Register."
    The next panel, Destination Location, shows the default location. You can change the location if desired.
  4. In the Start Installation panel, click Next and the installation starts.
  5. Once the installer completes the product installation, the Product Registration dialog displays.
    • If you have your Serial Number and Embarcadero Developer Network membership information available, you should perform the registration at this time.
    • If you do not have an EDN membership, you will have the opportunity to create one during the registration. If you cannot register at this time, choose Cancel. When you are ready to register, run the InterBase installer again and choose Register from the Install Set panel, or invoke the License Manager tool upon start-up.
    • Please note that if you are unable to register at this time, at least make sure that you Add the Serial Number you have received using the License Manager tool; this allows InterBase to function with default licensing parameters, for a grace period of 14 days before registration becomes mandatory.
    • On Linux , if you wish to register from a shell command line, please execute the command:
  <;interbase_home>;/bin/LicenseManagerLauncher -i Console
6. In the Registration panel, enter the Serial Number and Key from the email you received from Embarcadero.
7. InterBase 2017 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.

Registration

  1. Enter your Embarcadero Developer Network account credentials in the Login or Email and Password fields. If you have not previously created an EDN account, or have forgotten your password, click I need to create... or I've lost my password.
  2. Click Register and your activation file should be downloaded and installed automatically. If this does not happen, click the Trouble Connecting? link in the Product Registration dialog.
  3. Click Registration FAQ to view frequently asked questions about registering your InterBase 2017 product.

Return to top of page

Install Drivers

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: 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
InterBase ODBC Driver

Return to top of page

Using the Wise Installer to Embed InterBase

InterBase 2017 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 Media Kit 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):

 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.
   ARCH - Choose InterBase architecture (32 OR 64)

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.

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.

Return to top of page

Installing on Japanese Versions

Using the Java Installer for Japanese Windows installations.

Property Files

The installer is named ib_install.exe on Windows 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.

Calling the Installer with a Property File

Windows example (Japanese installation only):

  ib_install.exe -f ib_install.properties

Installer_UI

The mode that InstallAnywhere-based installer should run in:

Example:

 INSTALLER_UI=silent

CHOSEN_INSTALL_SET

The Install set that wish to use:

Example: The location of the slip file that you will be using for InterBase.

  SLIP_FILENAME=C:\\slipdir\\myslipfile.slip

USER_INSTALL_DIR

This is the install location for InterBase. The default installation folder is under the Windows "Program Files" location for 32bit or 64bit.

MULTI_INSTANCE

Set to No by Default. If you want to take advantage of the InterBase XE7 Multi-Instance feature, set MULTI_INSTANCE=Yes. It is important to set the INSTANCE_NAME and SERVER_TCP_PORT variables to something other than the default to not interfere with other version of InterBase running on the system.

SERVER_TCP_PORT

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.

INSTANCE_NAME

Default is gds_db. This only needs to be set if MULTI_INSTANCE is set to Yes.

Return to top of page

Finishing Up

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, Processors, and Strong Encryption for information on licensing.

Command-Line Installation

If your Linux environment does not support the GUI installer, you can use the following steps to perform a console installation.

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 2017 has a 14-day grace period for registration, but this feature requires a GUI and is not available to Linux installations that do not have a GUI.

Return to top of page

Installing InterBase

  1. If an InterBase server is running, shut it down and uninstall any previous versions of InterBase.
  2. On your InterBase Media Kit, go to the directory for your platform (Linux, under Disk1/InstData/Linux/VM) and run ib_install_x86.bin or ib_install_x86_64.bin with the -i flag
  3. ib_install_x86.bin or ib_install_x86_64.bin with the -i flag
    • Follow the prompts.
  4. When installation is complete, you must register InterBase in order to start the server.
    • On Linux, 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 Linux section below:

Return to top of page

Licensing Users, Processors, and Strong Encryption

For more information about InterBase options, please visit the Embarcadero InterBase Portal. The Licensing chapter in the Operations Guide PDF manual covers this topic in more detail. You can purchase licenses to enable additional simultaneous users and additional processors through the Embarcadero web site or through your sales representative.

You will have the following basic functionality after you register:

Note: InterBase ToGo and IBLite are currently supported in the XE3 edition.

Return to top of page

Linux

InterBase 2017 Multi-Instance Install Setup

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.

Return to top of page

Saving Customization Files

If you are planning to install the InterBase 2017 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.ibk
 cp /usr/interbase/ib_license.dat /tmp   
 cp /usr/interbase/ibconfig /tmp

You can skip this step if you haven't customized these files in a previous installation.

Return to top of page

Running InterBase as a Service

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.

Return to top of page


Copyright © 1986-2017 Embarcadero Technologies, Inc. All Embarcadero brand and product names are trademarks or registered trademarks of Embarcadero Technologies in the United States and other countries. All other marks are the property of their respective owners.