[Rawh]

Behold, the almighty and all knowing FAQ!

• What is SourceBans?
  
• Which ports does the SourceBans webpanel require to be open?
  
• My Banlist doesn't show up, but all other pages do. What can I do?
  
• Why is the "Ban player" option missing in SourceMod's admin menu?
  
• I get the following error: Database failure: [1045]
  
• Why does the game plugin error log tell me "Database failure: Could not find database conf "sourcebans""?
  
• Why is the webpanel showing "Error Connecting (ip:port)" for my server, when it's actually online?
  
• Why is the webpanel showing me a blank white page?
  
• Can't connect to mysql on XXX.XXX.XXX.XXX
  [sourcebans.smx] Database failure: [2003]: Can't connect to MySQL server on '<ip / host>' (10061)

If any of the above sollutions did not fix your issue, please post the issue on this forum. Be sure to include a copy of your sourcebans.log file!

[Rawh]

What is SourceBans?

SourceBans is a global administration system for multiple Source based game servers where admins and bans can be added across more than one server.

[Rawh]

Which ports does the SourceBans webpanel require to be open?

If your web panel shows Error Connecting for your game server when it is actually online,
ask your web host to open UDP incoming from your game server port (usually 27015).

If either the RCON console, Admin Rehashing or Kick-It does not work on your web panel,
ask your web host to open TCP outgoing to your game server port (usually 27015).

[Rawh]

My Banlist doesn't show up, but all other pages do. What can I do?

Your PHP configuration restricts SourceBans to a certain amount of memory.
When viewing the Banlist it tries to lookup the according country for the IP. This is done by loading a ~7MB database file into the memory.

There are several ways to solve this.

• Remove the '//' in front of this line in your config.php: define('SB_MEM', '128M');
  
• Ask your webhost to increase the PHP 'memory_limit' setting.
  
• If it still doesn't show up, check the box for 'No Country Research' in your webpanel settings page.

[Rawh]

Why is the "Ban player" option missing in SourceMod's admin menu?

Most likely SourceMod's basebans.smx was still loaded when you installed SourceBans' game plugin. The game plugin automatically disables basebans.smx, but your server needs to be restarted for the "Ban player" option to come available.

[Rawh]

I get the following error: Database failure: [1045]

Your MySQL server does not allow incoming connections from your gameserver. To fix this, you can do either of the following:

* Go into your webserver's control panel and check if there's a section called MySQL Access Hosts or something named similar. There you can add the IP address mentioned in the error. This is usually the IP of your gameserver, but it can also be slightly different, so make sure you copy and paste it exactly from the error.

* The other option is to run the following query on your SourceBans database (for example using phpMyAdmin):
GRANT ALL ON database.* TO 'username'@'ip';

You will have to replace "database" with your SourceBans database name, and "username" and "ip" with those mentioned in the error.

[Rawh]

Why does the game plugin error log tell me "Database failure: Could not find database conf "sourcebans""?

You forgot to add the "sourcebans" section to SourceMod's databases.cfg, as instructed in the installation. Please go to http://your.sourceba...rvers&o=dbsetup (replace your.sourcebans.install with your own URL) and add the "sourcebans" section to your databases.cfg.

[Rawh]

Why is the webpanel showing "Error Connecting (ip:port)" for my server, when it's actually online?

See Which ports does the SourceBans webpanel require to be open?.

[Rawh]

Why is the webpanel showing me a blank white page?

This is because PHP has encountered a fatal error and cannot show any more of the page.

To show the error message that PHP produced, you need to add the debug parameter to your URL. For example, if your current URL is http://www.sourcebans.net/index.php then you can add the debug parameter by changing the URL to http://www.sourceban...dex.php?debug=1

If your URL already has parameters, then add debug on the end, like this: http://www.sourceban...?p=home&debug=1

In most cases, the error message will be self explanatory, but if you need help, then post on our forums.

[Rawh]

Can't connect to mysql on XXX.XXX.XXX.XXX
[sourcebans.smx] Database failure: [2003]: Can't connect to MySQL server on '<ip / host>' (10061)

This can be because of a few reasons:

• Your server is blocking the UDP port of 3306
  Edit your firewall to allow UDP port 3306
  
• Your server isn't listening for internet addresses with it's mysql config.
  You can check this by going to the install dir of your mysql (/etc/mysql on linux) and look inside the config file (my.cnf). It should have a "bind-address = XXX.XXX.XXX.XXX". If it's set to 127.0.0.1 then edit it with your outside (internet) address) and restart mysql!
  
• The ip address you entered inside your databases.cfg is invalid. Please do not use hostnames.