NEW  SITES ONLY

This section applies only to new Reciprocal Net sites, not to existing sites.  It does not apply to upgrades.  Any attempt to initialize a Reciprocal Net site more than once would disrupt the entire Site Network and risk data loss.

Go to a command prompt and type:

.  A window will appear with some explanatory text about the installation procedure.  Read carefully through the message and answer y when it asks if you’d like to continue.

You will be prompted for the username and password of a user account that will be created for you.  This user account will exist within your site’s Reciprocal Net installation and will have site administrator privileges.  (Reciprocal Net user accounts are unrelated to MySQL database user accounts, GNU/Linux user accounts, Tomcat user accounts, or Apache user accounts.)  Many users choose to use their personal username (8 characters maximum) and password, although it’s recommended that you choose a Reciprocal Net password that’s different from your GNU/Linux account password.  You can use this user account later to create additional Reciprocal Net user accounts so that your colleagues can access the system.

Next you’ll be prompted to enter the database root password that you set earlier in this chapter.  The program will trundle for a few seconds and generate many lines of output.  If it doesn’t end with the word Done then you have problems – read carefully through the output and try to find the error message.  If no error is readily apparent on your console, then it’s possible the error message was written to syslog instead, in which case the message could be found at the bottom of the /var/log/messages file (in a default Red Hat Enterprise Linux installation).

Notice that while the init mode was running, it created three database user accounts for you and wrote the passwords to /etc/recipnet/recipnetd.conf for safekeeping.