115 lines
4.3 KiB
Plaintext
115 lines
4.3 KiB
Plaintext
|
Rel -- An implementation of Date and Darwen's Tutorial D.
|
||
|
|
|
||
|
|
Rel is a self-contained, complete, desktop database management system
|
||
|
|
with a user-friendly graphical user interface, ideal for creating and
|
||
|
|
maintaining personal, workgroup, and classroom databases.
|
||
|
|
|
||
|
|
*** GETTING STARTED ***
|
||
|
|
|
||
|
|
1. Download the file appropriate for your platform:
|
||
|
|
|
||
|
|
Rel3.xxx.windows.zip Windows 64 bit
|
||
|
|
Rel3.xxx.dmg MacOS 64 bit
|
||
|
|
Rel3.xxx.linux.tar.gz Linux 64 bit
|
||
|
|
|
||
|
|
Note: xxx represents the current version number.
|
||
|
|
|
||
|
|
2. Open the downloaded archive to extract the Rel folder.
|
||
|
|
Move the Rel folder to a convenient location.
|
||
|
|
|
||
|
|
On MacOS, running the .dmg will start a minimal installer
|
||
|
|
to help you copy the Rel application to your Applications folder.
|
||
|
|
|
||
|
|
3. Download and unzip the Rel / Tutorial D source code examples to a
|
||
|
|
convenient location:
|
||
|
|
|
||
|
|
RelExamplesAndUtilities_3.xxx.zip
|
||
|
|
|
||
|
|
== If you are upgrading from a previous version of Rel, please ==
|
||
|
|
== see IMPORTANT INSTRUCTIONS FOR UPGRADING, below. ==
|
||
|
|
|
||
|
|
4. To run Rel, open the Rel folder or directory and run the Rel
|
||
|
|
executable. It's normally shown with a Rel icon.
|
||
|
|
|
||
|
|
*** USING THE STAND-ALONE REL DBMS ***
|
||
|
|
|
||
|
|
Whilst Rel is a self-contained, complete, desktop database management
|
||
|
|
system with a user-friendly graphical user interface that is ideal for
|
||
|
|
creating and maintaining personal databases, you can optionally also
|
||
|
|
run a standalone, "headless" Rel DBMS server that can be accessed from
|
||
|
|
multiple Rel desktop database management systems and/or from software
|
||
|
|
you write. This is ideal for providing access to shared databases for
|
||
|
|
workgroups and classrooms.
|
||
|
|
|
||
|
|
If you wish to use the standalone Rel DBMS -- which is not needed to
|
||
|
|
use Rel -- download the following and extract it to a suitable
|
||
|
|
directory on your host machine:
|
||
|
|
|
||
|
|
Rel3.xxx.windowsDBMS.zip Windows 64 bit
|
||
|
|
Rel3.xxx.macosDBMS.tar.gz MacOS 64 bit
|
||
|
|
Rel3.xxx.linuxDBMS.tar.gz Linux 64 bit
|
||
|
|
|
||
|
|
** To run just the stand-alone Rel DBMS server from the command line:
|
||
|
|
|
||
|
|
RelDBMSServer
|
||
|
|
|
||
|
|
Note: The script file will have a .sh extension on Linux and
|
||
|
|
MacOS, .cmd on Windows.
|
||
|
|
|
||
|
|
** To run the stand-alone command-line Rel language interpreter or
|
||
|
|
server from your operating system command-line, go to the Rel
|
||
|
|
folder or directory and run:
|
||
|
|
|
||
|
|
RelDBMS
|
||
|
|
|
||
|
|
Note: The script file will have a .sh extension on Linux and
|
||
|
|
MacOS, .cmd on Windows.
|
||
|
|
|
||
|
|
** The stand-alone command-line Rel language interpreter provides
|
||
|
|
various options, including the option to run the server.
|
||
|
|
To see these options, type:
|
||
|
|
|
||
|
|
RelDBMS -?
|
||
|
|
|
||
|
|
*** IMPORTANT INSTRUCTIONS FOR UPGRADING: ***
|
||
|
|
|
||
|
|
== If you are upgrading from a previous version of Rel, please ==
|
||
|
|
== pay attention to the following! ==
|
||
|
|
|
||
|
|
1. You *MUST* back up your database *BEFORE* you install an upgrade!
|
||
|
|
|
||
|
|
If you are using Rel version 0.3.8 or higher, you can make a backup
|
||
|
|
via the graphical user interface's (aka DBrowser) "Backup" button.
|
||
|
|
|
||
|
|
If you are using Rel version 0.3.0 to 0.3.7, run the
|
||
|
|
DatabaseToScript.d script in the Scripts directory. This script will
|
||
|
|
emit your database as a new Tutorial D script. To back up your
|
||
|
|
database, save the generated script. To restore your database, run
|
||
|
|
the saved script.
|
||
|
|
|
||
|
|
If you are upgrading from a version of Rel prior to 0.3.0 (aka Rel2),
|
||
|
|
under the old version of Rel run the DatabaseToScript.d found in the
|
||
|
|
old version's Samples directory. The script will emit your database
|
||
|
|
in a format that can be read by later versions of Rel, though it may
|
||
|
|
require some modifications.
|
||
|
|
|
||
|
|
Rel user interface (aka DBrowser) version 3.001 or above (which
|
||
|
|
includes the Rel DBMS version 1.0.13 or above) will automatically
|
||
|
|
attempt to upgrade any database created using Rel user interface
|
||
|
|
version 3.000 or above, or with the standalone Rel DBMS version 1.0.13
|
||
|
|
or above. Normally, the database upgrade is completely
|
||
|
|
automatic. However, in some cases the upgrade may not be able to
|
||
|
|
complete automatically. If this happens, it will tell you, and you may
|
||
|
|
need to edit the database backup script before you can successfully
|
||
|
|
restore the database.
|
||
|
|
|
||
|
|
However, Rel user interface version 3.000 and above cannot
|
||
|
|
automatically upgrade databases made with older Rel versions. You must
|
||
|
|
go to the command-line, load the backup script created in Step 1
|
||
|
|
above, and execute it.
|
||
|
|
|
||
|
|
For more information, please see https://reldb.org
|
||
|
|
|
||
|
|
Copyright © 2004-2022 Dave Voorhis
|
||
|
|
All Rights Reserved
|