Copyright © 1996-2003, SNAP Innovation Softwareentwicklungsgesellschaft mbH. All rights reserved.
1. Overview
2. Documentation and Support
3. Installing and Running the Server3.1 Windows Installation
3.2 UNIX Installation
3.4 Developer and Demo Versions4.1 Starting and Stopping Servers
4.2 Server Default Setup
4.3 Note for Programmers
Welcome to PrimeBase 4.2PrimeBase 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.
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.com. 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.com, and join our mailing list.
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.2 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.
/usr/local/primebase
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:
/usr/local/primebase/bin
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.com. 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.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.2 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.
This is a legal agreement between you, the end-user, and SNAP Innovation Software GmbH("SNAP"). By installing a SNAP software program (the "Software") with an installer, or by copying the software to your computer, you are agreeing to be bound by the terms of this agreement. If you do not agree to these terms, promptly return the disk package and the accompanying items to the place you obtained them for a full refund.SNAP grants you the right to use one instance of the PrimeBase Database or Application Server for each unique serial number issued. The total number of simultaneous connections may not exceed the number encoded in the activation key. You may run the server on any one of the platforms encoded in the activation key. If a temporary license has been granted the Software may not be used beyond the indicated expire date.
You may use any number of instances of the client software on any platform on which it is available.
The Software is owned by SNAP and is protected by the German copyright law and all other applicable law. You may not decompile, reverse engineer, disassemble, patch or modify the Software. You may not rent or lease the Software, but you may transfer your rights under this SNAP License Agreement on a permanent basis provided you transfer all copies of the Software and all written materials, and the recipient writes to SNAP accepting all the terms of this Agreement. Any transfer must include the most recent update and all prior versions.
SNAP shall not be liable for any damages whatsoever (such as damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use of or inability to use this software.
This license is governed by the laws of the Federal Republic of Germany.
PrimeBase, the PrimeBase logo and the SNAP logo are trademarks of SNAP Innovation Softwareentwicklungsgesellschaft mbH. Copyright © 1997 SNAP Innovation Softwareentwicklungsgesellschaft mbH. All rights reserved.