Configuring and running the Account Management System

...

If you want information about the design, take a look at the page AMS Design Info

Prerequisites

It is assumed you have already setup the shard server by following Configure Linux Server

Preparing packages

The following packages are required to enjoy the entire functionality of the AMS.

...

You can install and configure dovecot by following the instructions at https://help.ubuntu.com/community/Dovecot

Configuring Apache

For current Ubuntu versions you can just edit the file default in /etc/apache2/sites-available/. Add below the settings that you had to enter to setup the server's login site en main website the following:

Listen 40917
<VirtualHost *:40917>
    <Directory "/home/username/ryzomcore/code/ryzom/tools/server/ryzom_ams/www/html">
    Options -Indexes FollowSymLinks MultiViews
    IndexOptions FancyIndexing FoldersFirst NameWidth=*
    AllowOverride All
    Order allow,deny
    Allow from all
    </Directory> 
    ServerAdmin admin@localhost
    DocumentRoot /home/home/ryzom/code/ryzom/tools/server/ryzom_ams/www/html
    ServerName localhost
</VirtualHost>

Change the configuration settings

...

The $cfg['mail'] array holds information about the default email address, people with non-specific questions should email to this adress (most likely its something like support@ryzomcore.org). In case you don't plan to support mailing you can ignore this setting, else fill in the email addres, username, password and connection string for the mailserver, if you use a gmail account it will probably be {imap.gmail.com:993/imap/ssl}INBOX. If you have dovecot up and running, you might use {localhost:995/imap/ssl/novalidate-cert}INBOX

$MAIL_DIR refers to the location where email backups should be placed, this way you always have a local backup of the received email. $MAIL_LOG_PATH refers to a file path where the log of the mail cron job should be stored. The default setting is the following:

...

The $BASE_WEBPATH and $IMAGELOC_WEBPATH have to be changed and should point to the url that brings you to the website, this could be http://shard.ryzomcore.org/ams/ for the base webpath and  http://shard.ryzomcore.org/ams/img/ for the imageloc.

Run the install.php script

in your terminal, go to the ryzom_ams/www/html/sql directory and write the following:

php install.php

This will install the databases according to the settings you just changed in the config.php file. It will also create a default admin account with ID 1, you should be able to login with the username 'admin' and password 'admin'. 

Import the users of the shard

...