Welcome to the PrimeBase 4.5 Replication Server

Copyright © 2008, PrimeBase Systems GmbH. All rights reserved.


1. Overview
2. Documentation and Support
3. Installing and Running the Server

3.1 Windows Installation
3.2 UNIX Installation
3.4 Developer and Demo Versions

4. Getting Started

4.1 Starting and Stopping Servers
4.5 Server Default Setup
4.5 Note for Programmers



1. Overview

Welcome to PrimeBase 4.5

PrimeBase is a development platform for the production of client/server and web applications. It consists
of 3 main products: the PrimeBase Database Server, the PrimeBase Application Server, and the PrimeBase Open Server, all of which are based on open standards.

The PrimeBase Database Server is a relational Database Management System (DBMS) for Mac, UNIX
and Windows platforms. The PrimeBase Database Server supports all common database access
standards (PBT, SQL, ODBC, JDBC, PHP, Perl, RealBasic, EOF and DAL) and protocols (TCP/IP,
Shared Memory and Appletalk).

The PrimeBase Application Server allows rapid development and deployment of Web applications. The PrimeBase Application Server has many features that make implementing a Web application simple and efficient, including: an object-oriented programming environment and framework and multi-processor capabilities to ensure unlimited scalability.

The PrimeBase Open Server allows the PrimeBase Application Server or other applications using the PrimeBase Virtual Machine to connect to alternate data sources via PrimeBase Open Server plug-ins loaded by the PrimeBase Open Server. For example the Oracle plug-in enables you to access an Oracle database, or by loading the ODBC plug-in you will be able to access data servers via their ODBC drivers.

2. Documentation and Support

Some of the PrimeBase documentation including reference manuals and user guides is provided in PDF (Portable Document Format) and may be read and printed using Adobe Acrobat available, free of charge, from http://www.adobe.com. Other documentation is provided in HTML format and can be viewed with any browser.

Should you still have problems with the installation of this software, or you have any other questions then you are free to contact us by telephone at ++49 3890440 or via e-mail: support@PrimeBase.net. If you have general support questions that may be interesting to the entire PrimeBase community, then we suggest you visit our Web-site, www.PrimeBase.net, and join our mailing list.

3. Installing and Running the Server

Before starting the PrimeBase Replication Server please read the license agreement at the end of this document. Only proceed to use the PrimeBase Replication Server if you are in agreement with the terms of this license.

The replication server must be installed in the same directory as the PrimeBase Database Server. The database server must be version 4.5 or later.

3.1 Windows Installation

After unpacking the archive, locate the database server installation directory. This is the directory containing the 'databases' and 'setup' folders of the server.

Copy the contents of the 'setup' folder from the archive to the database server 'setup' folder.

Then copy the binaries (PBRS.EXE, etc.) and the 'pbrs.key' file in the archive folder to the database server installation folder.

To start the replication server run PBRS.EXE. To stop the replication use STOP_PBRS.EXE. 

3.2 UNIX Installation

Under UNIX a shell script called "Install_PrimeBase" is provided to install the server.

You must run this script as user "root".

You will be asked where you want to install the server. You must select a folder that already contains a database server installation.


In addition to the actual server installation, the installer places global resources in the location called $PRIMEBASEHOME. This is by default '/usr/local/primebase'.

After running the installer we recommend that you add the following path to your system PATH:


This is the default location of all the PrimeBase executables.

3.3 Developer and Demo Versions

The software in this directory will run for a limited period only. The activation information, including the expiry date is stored in the file 'pbrs.key' in this directory.

When the demo period has expired the server will still start but will not run for longer than 5 minutes.

You may request an extension to this demonstration period for development purposes by sending an e-mail to support@PrimeBase.net. Please state the nature and duration of you project.

We will send you a new 'pbrs.key' file. To activate the server, replace the file in this directory and restart the server. 

4. Getting Started

4.1 Starting and Stopping Servers

Under UNIX you may use 'pbctl' to start, and stop any server installed on your machine, and to make changes to the installation. Enter 'pbct -h' for more information on 'pbctl'.

Alternatively you can use the shell scripts 'start_replication_server' and 'stop_replication_server'.

Under Windows start the replication server by double-clicking on the PBRS.EXE executable.

To attach a console to a replication server running in the background, start the console (pbcon) program. The console executable may be started from any directory on the server machine.

At the console you can enter '#halt' to stop the replication server.

Enter '#help' for help on the console commands.

You may enter CTRL-R to detach the console, leaving the server running in the background.

4.5 Server Default Setup

As soon as you start the replication server it will try to create a process as specified in the configuration file 'setup/replication/processes.xml'. By default, no processes are defined.

The Replication Server User's Guide explains in detail how to define replication processes.

4.3 Note for Programmers:

The file 'setup/replication/load.sys' is provided for users that wish to extend or replace the replication server default functionality. Modify this file in order to add your functionality.

Add a line of the form:

execute file "<my_pbt_source_file>";

for each of your PBT source code files.