Quick Start Guide - Sambar Server

This documentation is out of date and is being maintained for historical reference only. A new version of this documentation should be written in the future.

This is a guide on how to go from a computer running the Windows Operating System and no webserver software, to a computer which has a working openFIRST system.

Software to Download

Before you begin, you should download the following software, downloading all of these setup programs will require about 20 MB of disk space:
openFIRST system (at the bare minimum you require the base system)
Sambar Server (get the latest production version, at the time of writing this was 6.0.1, this is listed on the main page under the heading 'Latest...')
PHP - Get the latest version under the Windows Binaries package. Sambar requires the zip package, rather than the installer version.

Sambar Setup

Open the Sambar Setup program, and confirm Yes that you would like to continue
Read and accept the license agreement I Agree.
Install the full system (default option) and choose Next >
Select the directory to install Sambar in. This example will use: C:\sambar60-1
Click Install
The Sambar setup program will install the server, once it is complete, click the Close button.
If you wish, you may view the readme file.
Do not load the Sambar server yet, if you do so, you will have to restart it after the next steps by right clicking on the icon and selecting restart

PHP Setup

Create a directory called C:\tmp (PHP requires this to store temporary files).
Open and extract the PHP software to a temporary folder.
Copy the folder which PHP has extracted to C:\ and rename it to php.
Copy from the sapi directory php4isapi.dll to C:\php.
Go to the Sambar Installation Directory (C:\Sambar60-1) and open the config folder.
Open config.ini in Notepad
Under the [http] heading, change the line that reads: Default Page = index.htm index.html index.stm index.asp to read: Default Page = index.php index.htm index.html index.stm index.asp
Close Notepad and select Yes to save the changes
Open mappings.ini (located in the same place as config.ini) in Notepad
Change the line under [isapi] that reads:
# *.php = c:\php\php4isapi.dll
to read:
*.php = C:\php\php4isapi.dll
by removing the # and space.
Close Notepad and select Yes to save the changes

openFIRST Base Setup

Open and extract the openFIRST base module to a temporary location
From the base module, open the openfirst directory and copy all of the files to the docs folder in the C:\sambar60-1
Start the sambar server using the icon Sambar Server 6.0-1 (the version number may be different)
Proceed through the openFIRST base configuration, following the instructions. When it comes time to login, use the username admin and the password openfirst. (You may have to login several times initially after install).

openFIRST Module Setup

To install a module, extract the compressed archive to a temporary folder and copy it to the docs folder.
In the openFIRST Configuration Utility select Install Modules click the checkbox(es) beside the module(s) you wish to install, and click on Create Tables
Click on Module Administrator and click the checkboxes for Activate and Show on Menu.

Congratulations, you now have a complete openFIRST system.