SuperWebAdmin v0.97 - "What did I say last time ?"
Author: [es]Rush

**** IMPORTANT INFO ****
If you're upgrading from 0.95 first uninstall the old version and follow the new installation instructions
However you can leave SWAConfig.ini and modify it according too "UPGRADE FROM 0.95 NOTES" section
************************

This documents happens to have the following sections:
-WHAT'S THIS ?!
-FEATURES
-INSTALLATION AND SETTINGS
-UPGRADE FROM 0.96 NOTES
-UPGRADE FROM 0.95 NOTES
-PRIVILEGES
-UTGL - UT Global Login System
-EasyMute
-MvReporter2
-IpToCountry
-FIX FOR THE WEBADMIN ON LINUX 436
-KNOWN ISSUES
-CHANGELOG
-THX TO
-CONTACT & FEEDBACK


WHAT'S THIS ?!
---------
SuperWebAdmin is an advanced administration tool for UnrealTournament'99 servers, it allows you to manage your server
via a web http interface. Basing on the original webadmin built in UT, SWA provides you with a very similiar interface,
but much simpler, it gets rid of the slow loading images in order to speed the things up. It adds a lot of additional
features and security measures which I will describe in the next parts of this document. Please stay tuned.


FEATURES
---------
 - Multi user - there can be up to 50 users each one with a different privilege level(see section PRIVILEGES)
 - QuickSet - allows to set a game using a preset configuration. Setup is done on the SuperAdmin page
 - Improved PlayerList with full compatibility with the latest UTGLA or if UTGLMode is off, with EasyMute.
   -Adds a kick/ban reason field, notifies users about the kick and about the admin who they should thank for
   *UTGL is a bit depracated, still waiting for a new version, but I didn't want to remove the old code
 - Extended Mutator page - allows to add custom mutators.
 - Current Rules - for instant changing max players/spectators and password
 - Logging - most of the user actions and IP are being logged
 - Extended IP Policy - OPBan v.07 integrated for easy ban limit extension and managment
 - SuperAdmin Page - includes the most important server settings. Useful when you don't want others to play with it. :)
 - Extended Console. Allows sending mutate commands. Users with low privileges will be able to do only "say". No more "admin get" spying. :P
 - Improved CurrentGame page - shows all maps from now. No more useless maplists.
 - MvReporter2 compatibility - Included panels for control and configuration.
 - UTDC Screenshots - Allows to do shots from player's screen and view them in webadmin, requires UTDCv17 or higher
 - IpToCountry support - SWA uses IpToCountry package and shows a small country flag near player's nick on the PlayerList page
 - Simple, yet nice graphicless interface
 - More things I forgot to include here :)


INSTALLATION AND SETTINGS
---------
 1. Copy System and Web directories with all files to the main ut-server path.

 2. Open your server's ini and add the following line to the Engine.GameEngine section ...
ServerActors=SuperWebAdmin.SWAServer

 3. Edit SWAConfig.ini to your needs ...

# The port the webadmin will run on, it needs to be opened on the firewall
# *Warning: Needs to be different than the port set in UWeb!!!
ListenPort=5000

# Don't touch this unless you're sure what you're doing
MaxConnections=50

# Set only main user for now, 5 means SUPERADMIN . Caution: Case-sensitive !!
# default: UserList[0]=admin:admin:5
# * password will be hashed to MD5 after the first run
UserList[0]=<user>:<password>:<privileges>

# Name which will be displayed in the logging window and in the top of the webadmin page
# For example: AdminRealm=[es]ClanServer #1 - WebAdmin
AdminRealm=My great webadmin

# Check it to true if you use UTGL but don't want its features in WebAdmin.
bForceUTGLModeOff=false

# When set to true SuperWebAdmin will automatically spawn OPBan and enable its features in the menu.
bOPBanEnabled=False

# It should be set according to the LogPath in UTDC.ini, of course if you run UTDC :) 
UTDCLogDir=../Logs

# As it says, tickrate settings will be showed in the Settings page
bTickrateInSettings=False

Now start the server and enjoy the use of SWA :P

MORE ABOUT OPBAN IN opban.txt !!!

UPGRADE FROM 0.96 NOTES
---------
Update the Web directory and SuperWebAdmin.u file.


UPGRADE FROM 0.95 NOTES
---------
I assume you've followed the installation section and also removeed SuperWebAdmin.SuperServerAdmin from UWeb as I adviced
on the beginning, now we have an old SWAConfig.ini that needs some changes, so ...

1) Move all Privileges[x] to the end of Userlist[x] basing on the below example
SWA0.95
Userlist[0]=admin:admin
Privileges[0]=5

SWA.096
Userlist[0]=admin:admin:5

2) Remove the depracated config values: ServerURL, UserCount, Privileges[0-49]
3) Add the new values from "INSTALLATION AND SETTINGS" section


PRIVILEGES:
---------
 There are currently 5 levels of privileges.
 1 - PublicModerator(Switch Map, ServerConsole-say, PlayerList, Bans Managment) - cannot change anything while Tournament
 2 - PublicAdmin(Public Moderator+ SwitchGameType, Mutators, GameOptions, RestartLevel) - cannot change anything while Tournament
 3 - ServerModerator(Switch Map, QuickSet, ServerConsole-say, PlayerList, RestartLevel, GameOptions, Mutators, Bans Managment, MvrControl)
 4 - ServerAdmin(ServerModerator+ SwitchGameType, ALL Defaults, ServerConsole-mutate)
 5 - SuperAdmin(ServerAdmin+SuperAdmin Menu+ServerConsole Commands)


UTGL - UT Global Login System
---------
If you don't know what is it just visit http://unrealadmin.org > Forums > UTGL and download the latest version. 

If already installed, you have to set this:
[UTGLAv<version>.GLMutator]
webLogin=<login>     <- It must be the _UTGL_ login with Admin rights for your server.
webPass=<password>


EasyMute
---------
This small mutator allows a server administrator to mute naughty players from sending messages.
If you don't use UTGL see EasyMuteV16.zip(which should be included) for more details.


MvReporter2
---------
It's an Unreal Tournament Server Actor, which connects to the IRC network, and posts messagees from the game into IRC.
This lets people follow any game without being on the server themeselves. This version is a modification of the original
MvReporter(www.mvreporter.de). It adds a secondary Link and fixes some bugs(it adds some bugs too :P)

SuperWebAdmin should detect this tool and enable additional pages automatically.

See MvReporter2beta2.zip for more details.

IpToCountry
---------
IpToCountry package can be found here -> http://www.unrealadmin.org/forums/showthread.php?t=13122
If you make it running, SWA should detect it.


FIX FOR THE WEBADMIN ON LINUX 436
---------
The idea of fixing the bug is to rewrite the http connection to through another port, it can be done in several ways like:
* Let's say that 5000 is the ListenPort in SWA and 5001 is the port we will use to connect to the server

 1. With stunnel
    This is the BEST way imho, it not only fixes the bug but also extremely secures the webadmin, and it's the simplest
    way, just add the following stuff to the stunnel.conf
    [https]
    accept  = 5001
    connect = 5000
    TIMEOUTclose = 0

    Now you connect using https://serverip:5001/

 2. With xinetd:
    To /etc/services add:
	
    UTAdmin 5001/tcp

    To /etc/xinetd.conf add:

    service UTAdmin
    {
    port = 5001
    socket_type = stream
    protocol = tcp
    wait = no
    user = root
    log_on_failure += USERID
    disable = no
    redirect = x.x.x.x 5000
    }

    Now restart xinetd with command "killall xinetd -HUP".
    You connect using http://serverip:5001/

 3. With Redir:
    Download it and compile: http://www.netsw.org/net/ip/socket/redir/redir-2.2.1.tar.gz

    Run with:

    /usr/sbin/redir --lport=5001 --cport=5000 --caddr=<IP> &
    You connect using http://serverip:5001/


KNOWN ISSUES
--------
 -UTDC's version is not being detected thus the UTDC Shot button will appear even in UTDCv16
 -SWA won't check if there is more than 1 player when running UTDCv17

CHANGELOG
---------
 0.97
 -IpToCountry support - small flags on the PlayerList page
 0.96 
 -Separated WebServer from UWeb
 -Added UTDC shots in player list
 -Improved HTML part and added some css
 -Reorganized SWAConfig
 -Improved security with MD5 hashing passwords in SWAConfig
 -Added a better way to fix Webadmin on 436 Linux
 -Fixed some bugs
 0.95:
 -Fixed a bug with Custom Mutators in Mutators page.
 -Fixed a bug with Spectators setting for Public in QuickSetConfig page.
 -Improved QuickSet speed by few times.
 0.94:
 -Added Custom Mutators into Mutator page.
 -As usual, fixed few bugs. :P
 0.93:
 -Added MvReporter2 support.
 -Fixed few html bugs. (thx to Gspot)
 -Added option to force maxplayers and spectators values in QuickSet. 
 0.92:
 -Added Bots section. ({ROW}Mase's request)
 -Fixed bad diplaying Friendly Fire value in QuickSetConfig. (reported by BlackWolf)
 0.91:
 -Fixed Settings page not updating the values. (reported by BlackWolf)
 -Fixed EasyMute compatibility.
 0.9:
 -First release

 
THX TO
---------
-TheFury, author of AdvWebAdmin. Thx for a a very nice idea.

-AnthraX for helping me with some issues, and input in the community and overall help

-PurplePants for sending me the OPBan's v0.7 code and allowing me to use it. Really, it's a powerful tool. Great work.

-kawaii for testing and helping me work out some things

-GSpot for help in some things which weren't released yet :P

-All ppl giving me support. Thx. :)

CONTACT & FEEDBACK
---------
If you find any bugs or just have some ideas please let me know. ;)
Rush on unrealadmin.org forums
Email & MSN: rush@u.one.pl
ICQ: 257547545
GG: 1930553
AIM: RushESpl
JID: rush@chrome.pl

Enough ? :> Hope so.