Clinic Booking System

Installation Guides

Installing Instant CBS

InstantCBS is the Windows version of the Clinic Booking System. It is extremely simple to set up. The only prerequisite of using InstantCBS is the user must have administrator rights to the pc.

Starting CBS Manually

  1. Download the zip file
  2. Unzip to somewhere on your pc where there are no spaces in the path (e.g. c:\instantCBS)
  3. Run instantrails.exe and confirm the directory change when asked to.
  4. Click the I symbol and select Manage Rails Applications...
  5. Tick the check box next to CBS and press Start With Mongrel.
  6. The system should now be accessible at http://localhost:3000/

Running CBS every time the computer boots (run as service)

  1. Complete steps (1) to (3) above, then close and exit InstantRails
  2. Run the file setup.bat from the InstantCBS directory.
  3. The system should now be accessible at http://localhost/

You can uninstall the services by running uninstall.bat.

Note: This will not work if you have a MySQL service already running on your pc.

Installing from the source code

You will need:

The default settings in config/database.yml require a database called cbs_production (assuming you run CBS in production mode, which you should except during development) with root@localhost access with no password. If you meet these requirements, all you need to do is migrate the database tables and start the server.

Upgrading from a previous version of CBS

If you have a version of CBS running already, it is possible to update to the most recent version.

  1. Download the CBS source code from the download page
  2. Stop the clinic_booking_system service (how to start/stop services)
  3. Unzip the files that you have downloaded

If you are runnning InstantCBS:

  1. Copy the new cbs folder and all it's contents to -PATH_TO_YOUR_INSTANTCBS\rails_apps\. Overwrite the exisiting files

If you are not running Instant CBS:

  1. Copy the new cbs over the existing one.

Everybody now...

  1. Open a console window (on windows go to Start » Run... and type cmd)
  2. Navigate to the cbs folder (in Instant CBS it is under rails_apps)
  3. For Windows type: set RAILS_ENV=production
    For Linux/OSX type: export RAILS_ENV=production
  4. Type: rake db:migrate
    If ruby is not in your path variable, this will fail. In this case you will need to specify the path to ruby. For InstantCBS this would look like:
    ..\..\ruby\bin\rake db:migrate
  5. Now start the server again (or the service for Instant CBS)