Installing ToGo

From InterBase

Go Up to ToGo Quick Start

Integrated Licensing for InterBase 2020

InterBase 2020 Developer Edition and InterBase 2020 ToGo are installed with RAD Studio (does not apply for Starter edition) and are included in the RAD Studio integrated license. This feature makes it easier for developers to create C++Builder and Delphi InterBase applications using RAD Studio. See IBLite and IBToGo Test Deployment Licensing for more information.

ToGo Supported Platforms

InterBase ToGo can run on the following platforms: Windows, macOS, Linux, Android, and iOS. For a detailed list of supported platforms refer to System Requirements.

ToGo Test Deployment License

The ToGo Test Deployment license allows users to test InterBase applications on deployment machines. For example, a user who is developing a Windows 32-bit InterBase application can use a ToGo Test Deployment license to test the application on other machines running 32-bit or 64-bit Windows, macOS, Linux, Android or iOS . For more information, see IBLite and IBToGo Test Deployment Licensing, or the complete InterBase ToGo Quick Start Guide.

Developing with InterBase ToGo

To see examples of development with ToGo refer to Developing InterBase ToGo Applications

Windows Platforms

The instructions here for developers not using RAD Studio.

  1. Download the InterBase_2020_ToGo.zip file https://www.embarcadero.com/products/interbase/togo/start-for-free, which includes the full file set for InterBase ToGo. From the downloaded zip file, unzip and extract winxx_full.zip file (where xx=32 or 64) into a directory such as C:\InterBase\ToGo_full, so that you can copy them later.
  2. Copy the required InterBase config and interbase.msg file for the full file set to an Interbase sub-directory under your application directory. For example:
  3. If you are using any database connectivity solution, like IBX, FireDAC or DBExpress, to run your IBToGo application, please make sure your system PATH includes the location of the ibtogo.dll/ibtogo64.dll libraries. Or, your application executable file should be present in the same folder as these DLLs.
  1. In order to develop your application to work with the ToGo edition, replace the "gds32.lib/ibclient64.lib" on your link path with the following files:
  • For Embarcadero-based users, the file is located in the <app_dir>\interbase\sdk\lib\ibtogo.lib (ibtogo64.a for 64bit).
  • For Microsoft-based users, the file is located in the <app_dir>\interbase\sdk\lib_ms\ibtogo_ms.lib (ibtogo64_ms.lib for 64bit).

macOS Platform

  1. Open the Application bundle (show Package Contents) where the Application is located.
  2. Navigate to Contents/MacOS and extract the InterBase ToGo zip file contents.

InterBase ToGo for macOS supports both 32bit and 64bit architectures. Inside of RAD Studio, both 32bit and 64bit versions of InterBase ToGo for macOS are supported.

  • The macos_togo_min.zip (32bit) file is the minimum file set required to deploy InterBase ToGo for 32bit applications.
  • The macos_togo_full.zip file includes the full file set for InterBase ToGo, and can be used for development with the 32bit ToGo edition.
  • The macos64_togo_min.zip (64bit) file is the minimum file set required to deploy InterBase ToGo for 64bit applications.
  • The macos64_togo_full.zip file includes the full file set for InterBase ToGo, and can be used for development with the 64bit ToGo edition.
  1. The MacOS folder looks like the following with <interbase> as the location of the extracted files:
    yourapplication
    <interbase>
    libibtogo.dylib
    libcgunwind.1.0.dylib
    libib_util.dylib
    libibxml.dylib
    

Linux Platform

InterBase ToGo for Linux supports both 32bit and 64bit architectures. Inside RAD Studio, Inside of RAD Studio, only the 64bit version of InterBase ToGo for Linux is supported.

  • The linux_togo_min.zip (32bit) file is the minimum file set required to deploy InterBase ToGo for 32bit applications.
  • The linux_togo_full.zip file includes the full file set for InterBase ToGo, and can be used for development with the 32bit ToGo edition.
  • The linux64_togo_min.zip (64bit) file is the minimum file set required to deploy InterBase ToGo for 64bit applications.
  • The linux64_togo_full.zip file includes the full file set for InterBase ToGo, and can be used for development with the 64bit ToGo edition.
  1. Once you unzip any of the above kits, the folder looks like the following with <interbase> as the location of the extracted files. You can add "yourapplication" in the same level as libibtogo.so so it can be dynamically loaded when your application needs it.
yourapplication
<interbase>
libibtogo.so
libib_util.so
libibxml.so

Advance To: