Table of Contents

Building and Installing the REX Accounting Script
Configuring the Rex Accounting Script
Specifying REX Accounting Script Options

Example Script Object

Using the REX Accounting Script

This appendix describes how to use the REX Accounting script.

The REX Accounting Script (RAS) writes RADIUS Accounting requests to a local, flat file and is included as an option for Cisco Access Registrar. Is is designed to be attached to a Cisco Access Registrar IncomingScript or OutgoingScript point. When used in conjunction with the Cisco Access Registrar built-in proxy support, the server will concurrently store a local copy of an Accounting request and proxy another copy to another RADIUS server.

RAS can be attached to more than one Cisco Access Registrar extension point.

For example, in a dial-up resale scenario, you might configure Cisco Access Registrar to proxy Accounting requests to many different Remote Servers (by realm). For some subset of those, you may want to keep a local copy of the Accounting requests. In this case, RAS could be installed as the IncomingScript on just the Services for which a local copy is desired.

Building and Installing the REX Accounting Script

To build and install RAS you must do the following:

Step 1 Obtain access to the Cisco Access Registrar software files from either the product CD or from the archive tar file you received electronically.

Step 1 Unpack the source files (AcctAsScript.cpp) and Makefile.

Step 2 Modify the Makefile to ensure the AR_INSTALL_DIR variable points to the directory where the Cisco Access Registrar software was installed, and then choose a compiler (gcc or SUNPro CC).

Step 3 From the command line prompt, type:

host% make

Step 4 Login as user root.

Step 5 From the command line prompt, type:

host# make install

Configuring the Rex Accounting Script

To configure RAS, do the following:

Step 1 Start the Cisco Access Registrar argecmd configuration utility and login:

> /opt/AICar1/usrbin/aregcmd -C localhost -N admin -P aicuser
Access Registrar Configuration Utility Version 1.3

Copyright (C) 1995-1998 by American Internet Corporation, and 1998-1999 by Cisco Systems, Inc. All rights reserved.

Logging in to localhost

[ //localhost ]

      LicenseKey = xxxx-xxxx-xxxx-xxxx
      Radius/
      Administrators/

Server `Radius' is Running, its health is 10 out of 10

-->

Step 2 Using aregcmd, create a new Cisco Access Registrar Script object:

--> cd /radius/scripts
[ //localhost/Radius/Scripts ]
      Entries 1 to 20 from 39 total entries
      Current filter: <all>
      ACMEOutgoingScript/
      AscendIncomingScript/

<... other output deleted...>

--> add LocalAccounting
Added LocalAccounting

Step 3 Using aregcmd, fill in the details of the new Cisco Access Registrar Script object. See "Server Objects," for more details.

--> cd LocalAccounting
[ //localhost/Radius/Scripts/LocalAccounting ]
      Name = LocalAccounting
      Description =
      Language =
      Filename =
      EntryPoint =
      InitEntryPoint =
      InitEntryPointArgs =


--> set Desc "Log Accounting requests to local file"
Set Description "Log Accounting requests to local file"

--> set lang REX
Set Language REX

--> set filename libRexAcctScript.so
Set Filename libRexAcctScript.so

--> set entry RexAccountingScript
Set EntryPoint RexAccountingScript

--> set initentrypoint InitRexAccountingScript
Set InitEntryPoint InitRexAccountingScript

--> set initentrypointargs "-f Accounting -t 1:15"
Set InitEntryPointArgs "-f Accounting -t 1:15"

--> ls
[ //localhost/Radius/Scripts/LocalAccounting ]
      Name = LocalAccounting
      Description = "Log Accounting requests to local file"
      Language = REX
      Filename = libRexAcctScript.so
      EntryPoint = RexAccountingScript
      InitEntryPoint = InitRexAccountingScript
      InitEntryPointArgs = "-f Accounting -t 1:15"


-->

Step 4 Using aregcmd, attach the new Cisco Access Registrar Script object to the appropriate Cisco Access Registrar Scripting point. See "Server Objects," for more details.

--> set /radius/IncomingScript LocalAccounting
Set /Radius/IncomingScript LocalAccounting

Step 5 Using aregcmd, save the configuration modifications:

--> save
Validating //localhost...
Saving //localhost...

Step 6 Using aregcmd, reload the server:

--> reload
Reloading Server 'Radius'...
Server 'Radius' is Running, its health is 10 out of 10

Specifying REX Accounting Script Options

The REX Accounting Script supports the options shown in Table E-1.

Example Script Object

This is an example of what a Cisco Access Registrar Script object using RAS might look like when viewed in the Cisco Access Registrar configuration utility, aregcmd:

[ //localhost/Radius/Scripts/REX-Accounting-Script ]
      Name = REX-Accounting-Script
      Description =
      Language = REX
      Filename = librexacctscript.so
      EntryPoint = RexAccountingScript
      InitEntryPoint = InitRexAccountingScript
      InitEntryPointArgs = "-f Accounting -t 16:20 -s 100k -o
         libRexAcctScript.so:DropAcctOnOff"

This example causes RAS to write to a file called Accounting.log (in the logs directory of the installation tree). The file rolls every day at 4:20pm (local time), as well as whenever it grows larger than 100k in size. RAS also runs the DropAcctOnOff script against every packet, after it has processed the packet.

Posted: Thu Aug 19 08:16:35 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.