To install the Wheel 'O Yum, simply extract the file to the desired location
on your hard disk.
Before extracting, you should confirm the MD5 sums provided on the download
page match that of the file on your system.
Windows
Unzip the file. A graphical program like
WinRAR or
WinZip may help.
Currently, the installation does not add shortcuts to the Start menu or desktop.
Unix/Linux
Decompress the file and extract the archive. Recent versions of tar can
perform this in one step:
tar xzvf WheelOYum_x.y.z.tar.gz for the gzip version
tar xjvf WheelOYum_x.y.z.tar.bz2 for the bzip2 version
Extracting the file will produce a new directory called,
WheelOYum_x.y.z where
x,
y and
z are the version numbers.
To start the client, simply execute the
runClient
script.
Windows
Open Windows Explorer and navigate to the directory where you extracted
the file.
Open the WheelOYum_x.y.z directory.
Double-click the file, runClient.bat
Currently, the installation does not add shortcuts to the Start menu or
desktop.
Unix/Linux
Execute the file, runClient.sh from within the
WheelOYum_x.y.z directory.
Important: You must be in the
WheelOYum_x.y.z directory when executing the
start script. Relative environment variables are set and won't work from other
directories.
The runClient script assumes there is a shell interpreter
at /bin/sh. If not, you must change the first line of the
script accordingly.
The client will automatically display a connection dialog. Enter the
connection parameters for the server and your login information and
click Ok. If you are unsure about the connection parameters, contact
your system administrator or the person running the Wheel O Yum server.
There are two variants of the server: graphical and headless. If these terms
seem foreign to you, proceed with the
Graphical Server.
Graphical Server
The graphical (GUI) server allows full administration of the Wheel 'O Yum server.
Unless you're running on a headless server, the graphical server is recommended.
The script to start the graphical server is named,
runServerGui.
Use this script as directed below for your platform.
Headless Server
The headless server is available for those who are running on a headless server.
It does not provide any administration capabilities. As such, use the
Graphical Server to setup the server, then run the
headless server (which will use the settings as setup by the graphical server).
The script to start the headless server is named,
runServer.
Use this script as directed below for your platform.
To start the server, simply execute the
runServer or
runServerGui script.
Windows
Open Windows Explorer and navigate to the directory where you extracted
the file.
Open the WheelOYum_x.y.z directory.
Double-click the file, runServerGui.bat (for the graphical server)
or runServer.bat (for the headless server)
Currently, the installation does not add shortcuts to the Start menu or
desktop.
Unix/Linux
From within the WheelOYum_x.y.z directory execute
the file:
runServerGui.sh (for the graphical server)
runServer.sh (for the headless server).
Important: You must be in the WheelOYum_x.y.z
directory when executing the script. Relative environment variables are set
and won't work from other directories.
The runServer script assumes there is a shell
interpreter at /bin/sh. If not, you must change
the first line of the script accordingly.
By default, the server will automatically start listening for incoming client
connections.
If this is the first time running the server, you will be prompted to add users
and restaurants to the system.
To add users, use the User Manager by selecting the
Server->User Manager... menu item.
To add restaurants, use the Restaurant Manager by selecting the
Server->Restaurant Manager... menu item.
The server automatically saves the restaurants and users as changes are being
made in the respective manager.
