TCCRadius Setup Instructions

Getting Started

1. Extract the TCCRadius files onto your system.

2. Gather the following information together:

3. Follow instructions below for getting started in Debug mode. After successful operation in Debug mode, follow the instructions for setting up as a service. Windows 95 & 98 can only run in Debug/Console mode.

Setting Up TCCRadius To Run In A Console Window/Debug Mode

1. Setup an icon for the TCCRadius.exe file with the following command line:
C:\TCCRadius\TCCRadius.exe -debug
(substitute C:\TCCRadius for the complete path to TCCRadius.exe)

2. Open the config\Clients.cfg file in notepad or your favorite raw text editor
Do Not use Microsoft Word or Wordpad.
Add your NAS IP Addresses and Secrets to this file like the example below:

192.168.0.1 mysecret
192.168.0.2 mysecret2

3. Open the config\NAS.cfg file in notepad or your favorite raw text editor
Do Not use Microsoft Word or Wordpad.
Configure each section with default Radius attributes for each NAS.
This section allows setup for default parameters for each NAS, see example below.

Ascend Sample:

client=192.168.0.1
user-service-type=framed-user
framed-protocol=ppp
framed-ip-netmask=255.255.255.255
ascend-idle-limit=1800
framed-mtu=1500
session-timeout=0
termination-action=0

Lucent/General Sample:

client=192.168.0.2
user-service-type=framed-user
framed-protocol=ppp
framed-ip-netmask=255.255.255.255
idle-timeout=1800
framed-mtu=1500
session-timeout=0
termination-action=0

4. Open the config\TCCRadius.cfg file in notepad or your favorite raw text editor
Do Not use Microsoft Word or Wordpad.
Configure the TCCRadius.cfg with the appropriate IP Address and Radius Auth/Acct Ports.
If you do not specify an IP Address, Auth Port, or Acct Port, TCCRadius defaults to the following:

IP Address: First available IP Address bound to the NIC
Auth Port: 1645
Acct Port: 1646

5. Create accounts or set TCCRadius to update mode (see the Update Mode section for more information). We recommend operating in Text mode to get started and then moving to ODBC after the server has been tested and configured to work with your NAS.

6. Launch program by double clicking icon created in Step 1. Both Authentication and Accounting packets will be logged the screen. This makes troubleshooting easy.

Testing TCCRadius Using RadTest.exe

1. Add the IP Address for the test workstation to the config/Clients.cfg file and assign it a common secret. Example: 192.168.0.3 mywrksecret
Remember, you must restart TCCRadius after adding new Clients.

2. Create an account for testing. If in TEXT MODE, create a new text file in the .\users directory and name it TEST. Then, enter the following information into that file.
username=test
password=testpass

TCCRadius does NOT need to be restarted after adding users, only configuration changes.

3. Now, start the Radtest utility with the following command:
Radtest test testpass

4. Since this is the first time RadTest has been run, it will prompt you for information. Here is a sample with our test information inserted.

TCCRadTest Version 1.25
Copyright 1998-99, Talon Computer Consulting, Inc.
http://www.tccsoftware.com, http://www.maxstat.com, ts@taloncc.com

RadTest.cfg file does not exist. One must be created.

What is the fqdn or IP Address of the Radius Server?
192.168.0.254

What is port number for the Radius Daemon? (e.g. 1645)
1645

What is the common secret?
mywrksecret

RadTest sending Radius Request to server 192.168.0.254 on port 1645.

Access Accepted.

Setting Up TCCRadius To Run As A Service (Windows NT 4.0 SP3 and greater)

Once you have tested and configured TCCRadius to run in Debug Mode, you can now set it to run as a service. This allows the service to be booted as soon as the server comes online.

1. Install TCCRadius into the Services Control Panel by running the following command in a console window:
TCCRadius -install

Your output will look like this:

Auth Created
Acct Created
Admin Created

This indicates that installation was successful.

2. Open the Control Panel and double click the Services Icon.
Installation as a service loads three distinct services:

TCCRadius - Performs Authentication
TCCRadius Accounting - Handles Accounting
TCCRadius Administration - Interfaces with the TCCAdmin tool.

This gives the administrator greater flexibility in controlling TCCRadius by allowing him to choose which services he wishes to enable or disable.

3. If you want each service to startup automatically when the server boots, don't forget to change each service's startup type to Automatic. Highlight the service name and click the Startup button. Then change the startup type from Manual to Automatic.

4. You can now start each service and use the RadTest tool to test for functionality.

5. To remove the services, stop all services and enter the following command at the console:
TCCRadius -remove