Radiator Installation

• First, order and pay for Radiator.
• Wait for a user name and password to be sent to you by email.
• Fetch radiator (user name and password required) and install it a work directory.
• Now go to Unix installation or Win95 and NT installation

1. Make sure you are (or have access to) a system administrator and someone who understands your Radius authentication and accounting requirements. Assistance with installing or configuring Radiator is not included in the price of Radiator.
2. Obtain and install Perl 5 version 5.004 or better.
3. Obtain and install Perl MD5 version 1.7 or better from your nearest CPAN archive.
4. If you plan to use SQL for authentication and/or accounting, obtain and install DBI (version 0.90 or better) and the DBD module for your selected database. DBD modules are available for many commercial, free and shareware RDBMSs. See your nearest CPAN archive.
5. If you plan to use LDAP for authentication and/or accounting, obtain and install Net-LDAPapi (version 1.40a or better) See your nearest CPAN archive.
6. If you plan to use the GUI interface to radpwtst obtain and install Perl Tk (version Tk402.004 or better) See your nearest CPAN archive.
7. Unpack the distribution with cat Radiator-x.x.tgz|gunzip -c|tar xvf -. You will need the Gnu Unix tool gunzip(1) to do this.
8. Check the latest patches and bug alerts for patches that might be relevant to your installation.
9. Change to the distribution directory: cd Radiator-2.x
10. perl Makefile.PL
11. make test This is the regression test. You should see lots of lines saying "ok" and none saying "not ok".
12. As a final test, run Radiator with a simple configuration file:
    • Run radiator with perl radiusd -config_file goodies/simple.cfg. This runs Radiator with logging turned on (so you can see whats happening), and authenticates all requests from the file users. You will see some messages, followed by INFO: Server started. Radiator is now waiting for requests to arrive.
    • In another window, change to your Radiator directory, and run the test application with:
      perl radpwtst -user fred -password fred
      You should see "OK".
    • Rerun radpwtst, this time with the wrong password from fred:
      perl radpwtst -user fred -password wrong
      You should see "Rejected".
    • If you configure a test NAS to use this server, you will able to log in as the user "fred" with password "fred".
13. If all goes well, make install. This will install the Radius perl modules in your site-perl directory, and radiusd, radpwtst, builddbm and buildsql in your local executable directory.
14. Now got to Configuration

1. Make sure you are (or have access to) a system administrator and someone who understands your Radius authentication and accounting requirements. Assistance with installing or configuring Radiator is not included in the price of Radiator.
2. Download and install ActivePerl. During installation, accept all the defaults. Allow it to change Autoexec.bat. Allow setup to reboot your computer.
3. Connect your computer to the Internet so you will be able download the required Perl modules from ActiveState using PPM in the next section.
4. Double click on c:\perl\5.00502\bin\ppm (the Perl package manager). You will get a command line screen running ppm with a PPM> prompt.
5. Type "install MD5". The Perl MD5 package will be downloaded and installed.
6. If you plan to use SQL authentication, type install DBI to install the main DBI package. Then find the database specific module(s) you want by typing search DBD, then install the one(s) you need for your database. For example, if you want to use ODBC to connect to your database, type install DBD-ODBC
7. If you plan to use LDAP authentication, type install PerLDAP.
8. Close the PPM window. Perl is now installed.
9. Unpack your Radiator distribution to a suitable location, such as c:radiator (we will call this location the distribution directory. Recent versions of WinZip (6.5 ot later) can be used to decompress and unpack the distribution file.
10. Start an MSDOS command window, change directories to the distribution directory.
11. Type perl Makefile.PL. This will check that your distribution is complete.
12. Run the regression tests with perl test.pl. You should see lots of lines like "ok xx", and none saying "not ok xx".
13. As a final test, run Radiator with a simple configuration file:
    • Run radiator with
      perl radiusd -config_file goodies/simple.cfg
      This runs Radiator with logging turned on (so you can see whats happening), and authenticates all requests from the file users. You will see some messages, followed by INFO: Server started. Radiator is now waiting for requests to arrive.
    • In another window, change to your distribution directory, and run the test application with:
      perl radpwtst -user fred -password fred
      You should see "OK".
    • Rerun radpwtst, this time with the wrong password from fred:
      perl radpwtst -user fred -password wrong
      You should see "Rejected".
    • If you configure a test NAS to use this server, you will able to log in as the user "fred" with password "fred".
14. Now got to Configuration

1. Read the configuration reference manual
2. Check the example configuration files in the goodies directory. You might find one that suits your needs very closely.
3. Create and edit a configuration file. We suggest you start with a very simple config file such as the the one in goodies/radius.cfg. Add extra features as you go.
4. Run radiusd by hand, and test it with radpwtst until you are sure it is configured the way you need for your site. You may want to specify your config file with -config_file filename.
5. When you are sure Radiator is configured the way you want, arrange for radiusd to start automatically at boot time (see the reference manual for details of different ways to do this for different platforms)
6. Join the radiator mailing list. This will allow you to exchange help and information with other Radiator owners. Send email with the single word "subscribe" in the body (not in the subject line) to radiator-request@open.com.au

Additional Resources

• If you want to use Simultaneous-Use checking with USR Total Control, you can get a copy of the pmwho program from here.

If you have trouble

1. Consult the Reference Manual.
2. Consult the FAQ for extra hints.
3. Check that you are using the latest version of Radiator. See http://www.open.com.au/radiator/downloads, use the username and password we have issued to you. Upgrade if you need to.
4. Check whether there are any patches that address your problem. See the README in the patches directory for your revision. Apply any patches that you think you might need.
5. If you still have the problem post to the mailing list by mailing to radiator@open.com.au (you will need to subscribe before first posting to that list) Be sure to include at least the following information:
   • A detailed description of the problem.
   • Your Radiator configuration file (remove any secrets and passwords first).
   • An extract from your Radiator log file (with Trace level of 4) illustrating the problem, or at least what is happening at the time of the problem.
   • Details of the computer type, operating system etc.
   This information helps people to understand your problem and help find a solution more quickly.