2. Installing FrontBase
Table of Contents
Step 2 Download and Install (MacOS X Public Beta)
Following the instructions below, you should be able to install FrontBase in about 10 minutes. After installing FrontBase, you can read about your new FrontBase server. You may find it useful to print this web page before continuing.
Step Do this... 2a. Log into your MacOS X Public Beta computer as "root". FrontBase currently needs to be installed by root so that it can run like Apache and other root level services. It makes no use of special ports nor does other things that may cause security concerns. 2b. To download FrontBase, please visit the Download Section of the FrontBase website.
The archive weighs in at less than 3 MB and should require only a few minutes to download on a 56K modem.
2c. If you have a previous version of FrontBase running on your server, the install script (which you'll run in the next step) will ask whether you wish to stop FrontBase related processes. You should usually let the script stop these processes for you. Refer to Basic Administration if you wish to stop things manually.
If you are also running client software (such as WebObjects, PHP, etc.), you should disable it so it does not access FrontBase during the upgrade process. Some client software may detect that FrontBase is not running and attempt to restart it while you are upgrading! Your installation should only be offline for a few minutes while you upgrade.
2d. From the terminal, expand FrontBase and run the installation script as follows (note that the version number may be higher):
gnutar xvf FrontBase-MacOSX-2.18.pkg.tar
Use the Workspace Manager to navigate to and start the installer application:
Select the menu item Package and then select the sub-menu Open. Select the expanded file from above and click Open. Follow instructions provided by the installer application.
By default, the installer will install FrontBase into the
The installer will attempt to install FBWebManager files into appropriate directories for use by the Apache web server.
2e. Verify that FrontBase has been successfully installed and started by entering the following in a terminal window:
ps axc | grep FB
If the FBExec process (a key FrontBase component) and the FBWebEnabler process (web admintstration tool process) are running, the system should reply with something like:
374 ? S 0:00 FBExec
375 ? S 0:00 FBWebEnabler
If one or both are not running, try to launch them from the command-line:
cd /Local/Library/FrontBase(deafault install location for FrontBase)
If launching FBExec or FBWebEnabler results in an error, please send e-mail to install-support@FrontBase.com. We will be happy to help you.
2f. If you are upgrading from a previous version of FrontBase and had databases or client software (e.g. WebObjects, PHP, etc.) running prior to starting your upgrade, you should restart those now.
First, start your databases as described in Basic Administration. Then restart your client software.
2g. Adjusting the search path to include the
FrontBase/bindirectory will make your life on the command-line simpler.
2h. C6ngratulations, you have successfully downloaded and installed FrontBase! You do not need to restart your computer. You should now spend some time reading the documentation which accompanies your FrontBase server.
If you have feedback or questions on this document, please send e-mail to firstname.lastname@example.org. Please reference the section number and topic. Thanks!!
©2000 FrontBase, Inc. All rights reserved.