Read Me

    Murmur WebAdministrator - Administration of Murmur Server on web for end users.
    Copyright (C) 2007,2008  Thibault Cohen

    This document is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This work is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this work; see the file COPYING. If not, write to the
    Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.


Pre-requisites
==============

 - Works only on Unix systems !
 - Web server with PHP
 - MySQL server or SQLite
 - Murmur installed ( 1.1.0 or 1.1.1, 1.1.2 not tested )
 - murmur.ini configured:
    - if you are using MySQL, there must be set: dbDriver=QMYSQL
    - if you are using SQLite, there must be set: dbDriver=SQLite
     murmurwebadmin does not care about comments, so it tries to connect to SQLite if you have set #dbDriver=SQLite


Installation
============

See INSTALL file


First connection
================

     -  After install launch a first time murmur.x86 :
       cd <murmurpath>
       ./murmur.x86 -ini murmurwebadmin/murmur.ini

     - Then kill him :
       killall murmur.x86

     - Then connect you with "superuser"  user :
         user : superuser
         NO PASSWORD


===========
Readme
===========

  * The config file used by the server is in murmurwebadmin folder.

  * If you want to have a useful web interface, you have to follow advices.


===========
Advises
===========

  * Don't forget to change superuser password.

  * If you want to be able to stop and start murmur server with Web interface :
       chgrp <web-user> <murmurpath>/murmur.x86
       chmod 754 <murmurpath>/murmur.x86

  * It's better to let "mumur.log" in log file option (not tested in other folder...).
 
  * It's better to let empty "Murmur IP" field.

  * WARNING : Don't delete all users. If you do this, you have to add user with mysql or phpmyadmin.
              Use that command :
	      INSERT INTO murmur_players (server_id, name, pw) VALUES (SERVER_ID, "USERNAME",SHA1("PASSWORD"));


Any questions
=============

http://sourceforge.net/projects/murmurwebadmin/
http://sourceforge.net/forum/?group_id=211952