Difference between revisions of "How To Create a BOARD18 WEB Site"

From BOARD18 Project WIKI
Jump to navigation Jump to search
(Updated to current practice)
(Rewrote the instructions to simplify the procedure)
Line 1: Line 1:
==How to create a BOARD18 web site using Linux==
==How to create a BOARD18 web site using Linux==


These instructions assume that you already have shell access to a
These instructions assume that you already have '''shell''' access to a
server environment that is running Apache with PHP version  
server environment that is running Apache with PHP version  
5.3 or later and MySQL version 5.5 or later.
5.3 or later and MySQL version 5.5 or later.  
You first have to decide whether to create a new domain for the application
or to put it on a sub directory of an existing domain.  In the following
instructions, the directory that you choose to use will be referred to as
the "web root directory" regardless of whether it is "really" a root or not.
 
'''The work of setting up a domain is well documented and quite beyond the scope of this how to.  So it will be assumed that this work has been done.'''


===Perform these steps on your local Linux PC===
===Perform these steps on your local Linux PC===
* Browse to the [https://gitorious.org/board18 BOARD18 project page].
* Browse to the [[Download 0.1.0 Alpha 1|Download]] page and download the two zip files: board18.zip and utility.zip.
* Extract board18/board18 repository for the current board18 release from Gitorious to your PC.
* Using FTP, move these 2 zip files to your web server.
* Extract board18/gamebox repository for the current gamebox release from Gitorious to your PC.
* Edit the board18/php/config.php file.
*# Change DB_HOST only if your DB server is different from your web server.
*# Change DB_DATABASE to the name you will give to your BOARD18 database.
*# You can also change the database user ID and password if you want.
*# Save the edit session.
*# Make note of the above values for use when creating the database.
* Start command line.
* cd to BOARD18 directory.
* Enter on command line:  
<pre>
rm ~/board18.zip
rm ~/utility.zip
zip ~/board18.zip *.html *.php
zip -r ~/board18.zip php scripts style
zip ~/board18.zip images/*.*
cd php
zip ~/utility.zip config.php
cd ../utility
zip ~/utility.zip *.*
</pre>
* cd to GAMEBOX directory.
* Enter on command line:
<pre>
cd boxes
zip -r ~/board18.zip images
zip -r ~/utility.zip control
</pre>
* Using FTP, move the 2 zip files to your web server.


===Perform these steps on your Linux web server===
===Perform these steps on your Linux web server===
* Create a new Apache web site for BOARD18. '''Explaining this step is beyond the scope of this how to'''.
* Extract board18.zip into your web root directory.  
* Extract board18.zip into your web root directory.  
* Create a utility directory in your user directory (~).
* Create a utility directory in your user directory (~).
* Extract utility.zip into this new directory.
* Extract utility.zip into this new directory.
* Edit the BOARD18/php/config.php file.
*# Change DB_HOST only if your DB server is different from your web server.
*# Change DB_DATABASE to the name you will give to your BOARD18 database.
*# You can also change the database user ID and password if you want.
*# Save the edited file.
*# Make note of the above values for use when creating the database (see below).


===Create the BOARD18 DataBase===
===Create the BOARD18 DataBase===

Revision as of 16:44, 2 September 2013

How to create a BOARD18 web site using Linux

These instructions assume that you already have shell access to a server environment that is running Apache with PHP version 5.3 or later and MySQL version 5.5 or later. You first have to decide whether to create a new domain for the application or to put it on a sub directory of an existing domain. In the following instructions, the directory that you choose to use will be referred to as the "web root directory" regardless of whether it is "really" a root or not.

The work of setting up a domain is well documented and quite beyond the scope of this how to. So it will be assumed that this work has been done.

Perform these steps on your local Linux PC

  • Browse to the Download page and download the two zip files: board18.zip and utility.zip.
  • Using FTP, move these 2 zip files to your web server.

Perform these steps on your Linux web server

  • Extract board18.zip into your web root directory.
  • Create a utility directory in your user directory (~).
  • Extract utility.zip into this new directory.
  • Edit the BOARD18/php/config.php file.
    1. Change DB_HOST only if your DB server is different from your web server.
    2. Change DB_DATABASE to the name you will give to your BOARD18 database.
    3. You can also change the database user ID and password if you want.
    4. Save the edited file.
    5. Make note of the above values for use when creating the database (see below).

Create the BOARD18 DataBase

The BOARD18 database must be created and loaded with game boxes before this web sit can be used.
See the How To Create a BOARD18 Database page for advice on performing this function.

How to create a BOARD18 web site using Windows

If you have a Windows environment please modify the above Linux instructions, test them and then enter them here.

How to create a BOARD18 web site using a MAC

If you have a MAC environment please modify the above Linux instructions, test them and then enter them here.