• :~$ sudo conf-mkahawa-client

A: Installation in Windows XP:

Use the windows package found here . You can download free time-limited sample, but you'll need to pay a small token for the unlimited version.

Q: Why does mkahawa (client) take over my ubuntu session?

Q: How do I stop mkahawa from taking over my Ubuntu session?)

Q: Is there a way of switching the program on/off so that I use it when it's necessary?

A:

That is how it is designed. It will take over the account that is designated during installation.

For example, if you have an account named "cyber1", (where "cyber1" is a linux account in ubuntu). And you want the client to be called "Comp1", and the server's IP address is 192.168.100.150

• # sudo adduser cyber1
• # sudo dpkg -i mkahawa-client_0.0.3-1_i386.deb

• Managed Username: [eg. user1 - mkahawa will be active only when logged in as this user] cyber1
• Client Name [eg. S1]: Comp1
• Server IP Address of Hostname [eg. 192.168.1.1]: 192.168.100.150

Mkahawa will be active only when you log in as "cyber1". Normally, you should set up Karmic (or other ubuntu version) to auto log-on to "cyber1". When you do not want mkahawa's control, simply log out and log in through other ubuntu accounts.

Q: How do I change the default blocking image on the client?

A: Yes, you can customize the the client blocker image. The easiest way to do this from the server is as below.

• Prepare your own picture - a GIF or JPEG.
• go to membership page
• Register as a user, then login.
• Upload the picture.gif in the available form.
• Click "Sample" link on the table that appears. Click"Desktop Blocker" if you don't see any table.
• The free update file and installation instructions will be sent to your email address
• You will be able to update all the client machines from the server at once.

The other option (requires moving from one client to the other):

• Prepare your own image/picture in .gif format
• Find the .mkahawa directory in the client. Most likely /home/user/.mkahawa
• Copy your .gif image into a file called lockpix.gif inside the .mkahawa directory
• Restart mkahawa machine.

Q: How do I manage members? - (Contributed by Warlock)

A:

• Click the Members / Tickets pane on the right
• Press "New" button and type in member's name
• To assign a special tariff to a member, select the member and click "tariff" button
• Set login name in the "Login ID" and press the "Save" button
• The default member password is the "Login ID". Member can change password from the client
• If the member forgets their password, highlight the member's name on the list and press "Reset Password" button. It will be reset to "Login ID"
• You can add and refund credit to a member by selecting the member on the list and pressing the "add"/"refund" buttons

Q: How do I set up mkahawa to count print-outs?

A: Use mkahawa-printer. Although functional, mkahawa-printer is still in beta. The description below is sketchy, but should improve in the coming version. The current implementation (0.0.1) was built from mkahawa-client, thus it is dependent on libcclc. Mkahawa printer should be installed on the Linux print server (running cups).

• Set up the Linux (Ubuntu) print server, and ensure that the clients print through the print server
• Install libcclc (see above) on the print server
• Download mkahawa-printer, and install (./configure, make, make install )
• Start up mkahawa-printer by: mkahawa-printer -nossl -name PrintServer -host . Ensure teh name is "PrintServer". If you have several print servers, you can name them: PrintServer1, PrintServer2 etc
• Add a product on the mkahawa-server interface with exactly the same name as in the print-server's cups interface. (On the print server, preview http://localhost:631 for the cups interface) It is important that the printer has exactly the same name as the cups printer name.
• Remember to put the value of on print-out as the price of the printer product.

Q: Can I upgrade CCL server to Mkahawa - without losing my data? How?

A: Yes, you can. Mkahawa server will not interfere with your CCL installation. However, you cannot run both simultaneously because they bind and listen on the same TCP port. Use the following procedure to import your CCL data into mkahawa server.

• Ensure that both CCL and mkahawa servers are not running. The procedure will work ideally if no client has connected to the new mkahawa server.
• Download the update file from here. The commands below assume that it is saved on the Desktop
• Open a terminal and change directory to .mkahawa directory in your home directory( # cd ~/.mkahawa )
• Copy cclfox db to .mkahawa directofy ( # cp ~/.cclfox/cclfox.db . )
• Execute this command: # sqlite3 mkahawa.db < ~/Desktop/update-cmds.sql
• You can now restart mkahawa server

Q: How do I set tariff?

A: Check out this splendid video by Warlock!

Q: How do I sell products?

A: Check out this

• On the "Products" pane, click "Sell"
• Double-click on the product. You'll be asked for the "quantity sold". You enter the number, and press "OK". You'll see the product and number in the lower part of the "Products" pane
• If you make a mistake, just double-click on the lower product to subtract some from the quantity
• You can select a number of products as explained in 2 & 3 above
• When you're through, press the "Complete Sale" button at the top. The Cashing frame/pane will open for you to cash

Q: How do override mkahawa on the client for computer administration?

A: You need to set up an administrator and login as member: "administrator", password: [the password you set]. The administrator password is set up as below:

• On the Mkahawa server GUI, right click on white space in "Client Icons" area
• Select "Admin Password"
• Input the password in the dialog box. NOTE: the password is set for ALL the connected clients