Thursday, 18 March 2004
Installing My Handy Restaurant is easy. Just follow this howto, and you'll be ready to work in 5 minutes!
Conventions used
This Howto is only suitable for releases up to version 0.8.2, later versions have an installer that make things easier. To have more info see docs/INSTALL text in your release files.
Although My Handy Restaurant perfectly works under Microsoft Windows, in this page it is supposed you are using a linux or unix operating system.
If you're not using such a system, you will probably have to modify a bit some instructions (for instance you cannot use the 'vi' command to edit files), but this howto should work for you, too.
The system used to test this howto is GNU/Linux Debian. Directories taken as examples are:
* /var/www as webserver root directory
* your.ip.or.hostname as localhost address
* /var/www/myhandyrestaurant as My Handy Restaurant root directory
* /var/www/myhandyrestaurant/* all other dirs
Requirements
* Webserver (eg. apache, IIS, etc)
* Database (MySQL)
* PHP module installed (PHP 4)
* A browser supports CSS stylesheet (konqueror, opera, netscape, mozilla, etc)
It is required that you have write permission on a web server directory. Maybe you will need root account to work on your webserver directories.
If you're not root ask him to give you write permission to those directories.
Download
First of all, of course, you need to download My handy Restaurant from the download page or from the CVS development server.
Then you have to uncompress the file you donwloaded to your web server directory.
Configure Dirs and passwords
Open with an editor file conf/config.inc.php
eg.
vi /var/www/myhandyrestaurant/conf/config.inc.php
then configure your ROOTDIRs with proper values:
define('CONF_ROOT_DIR','/var/www/myhandyrestaurant/');
define('CONF_HTTP_ROOT_DIR','http://your.ip.or.hostname/myhandyrestaurant/');
Now you have to tell My Handy Restaurant which user and password to pass to mySql when connecting; to do this edit the following lines in the same file with the correct values for your mysql server:
$cfgserver = 'your_mysql_server_dns_name_or_ip_address';
$cfguser = 'your_mysql_server_user_name';
$cfgpassword = 'your_mysql_server_user_password';
You can leave the other lines as they already are.
Configure the options
Open with an editor file conf/config.constants.inc.php
vi /var/www/myhandyrestaurant/conf/config.constants.inc.php
then edit the options as you wish.
We think the default values will be good for most cases, but if you want to tweak your system, this is the right place to do it.
Almost every option is commented, so it should be easy to decide what to do.
If you have any doubt, ask on the forum.
You can leave the other lines as they already are.
Install the databases
Point your browser to http://webserver/myhandyrestaurant/install.php page.
Then select the Make a fresh installation link.
Confirm by clicking on the Yes button when prompted.
Conclusion
Your My Handy Restaurant system should now be up and running.
To reach it type http://webserver/myhandyrestaurant/ in your browser.
If you want you can now configure some thermal printers to print orders and bills, or configure some handheld to connect to the server, and use them to take orders.
Please feel free to ask on the forum if you have any question.
Have fun!
Kilyerd