ARSC Really Simple Chat

Frequently Asked Questions


Copyright Notice

Copyright 2001-2005 Manuel Kiessling

This manual is free software; you may 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, or (at your option) any later version.

This 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.

A copy of the GNU General Public License is available at the GNU website. You can also obtain it by writing to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.


Q: Help, I can't login to the Admin panel!
A: You have to use the account Administrator which was created upon install. Yes, with a capital A! The password was presented to you on the install page. If you forgot to write it down, simply delete all ARSC tables from your MySQL database and re-start the install script.

Q: The installation was successful, but the chat message frame remains white, and I can not see what I write!
A: There are a lot of reasons why this might happen. Many mass webhosters do not like chat systems on their servers and therefore disable certain functionality in PHP or Apache that ARSC needs for its streaming version (browser_push). If the webserver is under your control, then you might want to check if ARSC is installed into a directory for which mod_gzip or mod_ssl is enabled. Because with browser_push ARSC streams the content to the browser of the user, these Apache modules have to be disabled for ARSC. If you are not able to disable this modules, then go to the admin interface, section Parameters, and change the parameter disable_browser_push from no to yes.

Q: I get Warning: set_time_limit() has been disabled... upon login!
A: This means that your PHP installation has Safe Mode enabled, and the function set_time_limit, which is required to use the browser_push mode of ARSC, has been disabled. Please ask your system administrator to enable set_time_limit for you. If this is not possible, then go to the admin interface, section Parameters, and change the parameter disable_browser_push from no to yes.

Q: How about the performance of ARSC, how many users is it able to handle?
A: This is a difficult one. The main problem is that I don't have 200+ friends I can call in order to do some ARSC load testing. There have been some sessions with ARSC I was able to attend with around 50 people, and I had mixed experiences. Sometimes it worked smooth, sometimes users got kicked randomly, although this was probably not related to server load. If you had ARSC running with 50+ users, I'm eager to know about it! Anyway, I recently found some interesting piece of software that should help keeping the load low on your server if you want to do chat sessions with many people: Lighttpd. It's a minimalistic HTTP server, with PHP support via the FastCGI interface. See the homepage of Lighttpd, and especially the section about preparing PHP as a FastCGI program.

Q: What I want to be able to do is have a chat room that only users I have created can log into and/or see.
A: Currently, the only thing which you can enforce is that only registered users may log in (Admin -> Parameters -> register_force) - but everybody is free to register. You can, however, delete the file that handles registration:

yourarscdirectory/base/register.php

You should also remove the link to this file, go to Admin -> Layouts -> Default and have a look at " template_home", delete the line:

<a href="register.php?arsc_language=<%current_language%>"><%lang_clicktoregister%></a>

Q: I want to set up ARSC to use the socket server, how do I do that?
A: Just go to:

http://www.yourserver.com/chat/base/admin/

Go to Parameters and set socketserver_use to yes.
Then start the socket server. To do this, logon into your server and go to yourarscdirectory/server/, then type:

php arsc_chatd.php &

and press enter. Now the server is up and running! Login to the chat as always.

Q: What is the PHP code for displaying who is logged on?
A: If you would like to show the visitors of your site which users are currently logged into the chat, this code might be what you are looking for:

<?php

$myc = mysql_connect("TheMySQLServer", "TheMySQLUser", "TheMySQLPassword");
mysql_select_db("TheDatabaseOfARSC", $myc);

$query = mysql_query("SELECT user FROM arsc_users", $myc);
while($result = mysql_fetch_array($myc))
{
 echo $result["user"]."<br />\n";
}

mysql_close($myc);

?>


Where TheMySQLServer, TheMySQLUser and TheMySQLPassword are the same values you used for ARSC, in the file config.inc.php.