RAQdevil: The FreeBSD Port of the Sun Cobalt RaQ550 Software

Introduction

While installing the RAQdevil is a fairly straightforward process, it is important to take heed of the installation notes. Also note that the RAQdevil software is not meant to be installed on a machine which is already serving data for multiple virtual sites. While it may be possible for one to change one's setup to make use of the RAQdevil software, this is not supported. This installation guide assumes a machine with no current web / mail / DNS configuration, and preferably as few other packages installed as possible.

We are currently looking for people to test the RAQdevil software, submit bug reports (and patches!), and to help contribute functional modules, enhancing the effectiveness and usability of RAQdevil.

Requirements

• FreeBSD 6.1-RELEASE or later
• i386 PC (other architectures have not been tested; these instructions are written assuming RAQdevil is running on i386)
• 4GB+ of disk space
• 128MB+ RAM
• Internet Connection

Warnings

• RAQdevil is not designed to be installed on a system that has been previously configured. RAQdevil will mercilessly destroy pre-existing configuration files for software it controls, and may malfunction if installed along with incompatible software. If there is any valuable data on the system, back it up before installing.

Procedure

1. Install FreeBSD 6.1-RELEASE or later using a convenient method.
   • Select to install the standard install option.
   • Select to install the developer distribution.
   • Say YES when asked about installing Ports collection.
   • Configure the system with a fixed IP address. Do NOT use DHCP.
2. Log into the system and become root.
3. Execute the following commands:
   (you can examine the script here. Roughly, it will: (a) prepare config files, (b) build and install a new kernel with quota support, (c) install prerequisite packages, (d) build and install RAQdevil, (e) initialize RAQdevil database.)

   fetch 'http://www.raqdevil.com/ports/raqdevil-1.1.2devel-install.sh'
   sh ./raqdevil-1.1.2devel-install.sh

4. If you encounter any errors or warnings, please report them on the mailing list.
5. When "Congratulations" appears.

   reboot

6. After rebooting, access the Web administration UI using a Web browser.
• URL: http://yourmachine:81/
• Replace yourmachine with the system's IP address, or name if it is listed in DNS.
7. Login with username admin, password admin.
8. Perform initial setup of RAQdevil.
   1. Generate a new SSL certificate for the administration Web server.
      • RAQdevil ships with a default SSL certificate to allow for the initial login to the admin server over an SSL connection. However, since the same keys are distributed with each RAQdevil installation, the link is not immune from attack. Generating a new certificate regenerates this key, protecting future admin sessions.
      • To generate the new certificate:
        1. In the left-hand pane, click on Security to expand the menu, then click SSL.
        2. In the right-hand pane, click on Generate Self-Signed Certificate. Fill in the fields that appear and click Save.
   2. Change the admin account password.
      1. Click on the green Personal Profile tab at the top of the page, then click Account in the left-hand pane.
      2. Select your language in the Language Preference drop-down menu.
      3. In the New Password box, enter a new password, the same in each box, then click Save.
   3. Set the initial network parameters.
      1. In the left-hand pane, click System Settings to expand the menu, then click TCP/IP.
      2. The form will be pre-populated with the existing network interface configuration. Enter the system hostname and domain name, DNS servers, and double-check that the network configuration is correct, then click Save.
9. Comprehensive admin and user documentation for the product RAQdevil is based on can be found here. Developer docs are also available here.

The installation is now complete. From here, you may wish to create a new Virtual Site to house a Web site, or configure email or FTP settings using the appropriate panels. Simple item Help displays in the bottom pane when hovering over an item.