Installing Athena

What is it?

At the time of writing, RO Control Panel, written by Azndragon, is probably the best tool you can get to help you manage user registration and maintenance. You also get a list of other useful features.

Requirements:

  • web server, Apache2 recommended
  • PHP server technology, PHP4 recommended
  • MySQL server, MySQL 4.0.xx recommended

Download:

Download the archive, which is usually in rar format, from links posted on eAthena Home or the project site. If you have Winrar, unpack the archive on Windows machine and send it over local net to your system. As a policy, the author will not provide links to commercial or shareware products. There is nothing to stop you from searching for a Linux shareware version. (Note: unrar is available as rpm for some distros. If you have it, the command is unrar x archive.rar.)

Assumptions:

  • CP_4.3.x folder is in /home/user directory.
  • You will host a forum or something else on web root. Read the Q&A if you want ROCP to be the main site.

Installation:

  • ROCP will be installed to a web directory called rocp. This name must be used in the URL. If you would rather have a URL like http://myhost.mydomain.tld/mycp, create the directory with the name mycp.
  • To install ROCP as the main site, stop now. You should follow the installation guide for phpBB with appropriate adjustments.
  • Let us do it:
    The first command creates a directory, rather a sub-web directory.
    The second copies ROCP files and sub-directories to that sub-web directory.
    # mkdir /usr/local/apache2/htdocs/rocp
    # cp -rf /home/user/CP_4.3.x/* /usr/local/apache2/htdocs/rocp
  • Done. That is about all to it.

Your ROCP is now available at http://localhost/rocp/, http://myhost/rocp/ or http://myhost.mydomain.tld/rocp/. If you do that now, you will see errors because the databases have not been created and configuration is not done.

Configure:

After the database has been created, configure ROCP:

  • Launch Konqueror as root, follow by a click on your favourite editor:
    # konqueror&

  • Edit /usr/local/apache2/htdocs/rocp/config.php and as a minimum, complete (use the default value in single quotes where available, with care):
    • $CONFIG['db_host'] = 'localhost';
    • $CONFIG['db_username'] = 'ragnarok';
    • $CONFIG['db_password'] = 'ragnarok';
    • $CONFIG['cp_db_name'] = 'cp';
    • $CONFIG['db_name'] = 'ragnarok';
    • $CONFIG['db_logs'] = 'log';
    • $CONFIG['passphrase'] = 'myverystrongpassword';
    • $CONFIG['server_type'] = '2';
    • $CONFIG['check_server'] = '1';
  • Save and exit.

Log in to ROCP as admin user (created with ROCP database) and do the rest of the configuration (e.g. setting server status check) if you like or create some data (e.g. login accounts) to play with.





Q&A

Why is Apache2 recommended?

Apache2 has features which are not found in Apache1, such as SSL support. Secure Socket Layer (SSL) is often found on Linux systems.

Why is MySQL 4.0.xx recommended?

ROCP is incompatible with MySQL 4.1 and AdoDB driver which comes with PHP4. Although it is possible to force MySQL 4.1 to use MySQL 4.0 passwords by editing my.ini, it is better to avoid it altogether. The alternative is MySQL 4.1.xx and PHP5 (tested on 64-bit Linux).

But I want ROCP to be the main site...

You can install ROCP in /usr/local/apache2/htdocs instead of /usr/local/apache2/htdocs/rocp. If you are worried about existing web pages already in the directory, follow the relevant installation steps for phpBB to delete those files.

ROCP doesn't show my server status!

Edit config.php and change the line $CONFIG['check_server'] = '0'; to $CONFIG['check_server'] = '1';. Refresh your browser and you should see the on-line status.