Cisco Prime Access Registrar 9.1 Administrator Guide

Using the REX Accounting Script

---

This chapter describes how to use the REX Accounting Script (RAS). The RAS writes RADIUS Accounting requests to a local, flat file and is included as an option for Cisco Prime Access Registrar (Prime Access Registrar). It is designed to be attached to a Prime Access Registrar IncomingScript or OutgoingScript point. When used in conjunction with the Prime 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.

Note Unless you require log rotation at an exact time or when the accounting log reaches a specific file size, we recommend that you use service grouping to log and proxy accounting packets.

RAS can be attached to more than one Prime Access Registrar extension point. For example, in a dial-up resale scenario, you might configure Prime Access Registrar to proxy Accounting requests to many different Remote Servers (by realm). For some subset of those, you might 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.

Note Also included is the DropAcctOnOff Script. This script causes Prime Access Registrar to drop all Accounting-Requests with an Acct-Status-Type of Accounting-On or Accounting-Off.

This chapter contains the following sections:

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

Building and Installing the REX Accounting Script

The RAS writes RADIUS Accounting requests to a local, flat file and is included as an option for Prime Access Registrar. It is designed to be attached to a Prime Access Registrar IncomingScript or OutgoingScript point.

Building and Installing the REX Accounting Script

To build and install RAS:

Step 1 Change directory to $INSTALL/examples/rexacctscript.

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

Step 3 From the command line prompt, enter:

host% make

Step 4 Log in as user root.

Step 5 From the command line prompt, enter:

host# make install

Configuring the Rex Accounting Script

RAS can be attached to more than one Prime Access Registrar extension point. For example, in a dial-up resale scenario, you might configure Prime Access Registrar to proxy Accounting requests to many different Remote Servers (by realm).

Configuring the Rex Accounting Script

To configure RAS:

Step 1 Start the Prime Access Registrar aregcmd configuration utility and login:

> $INSTALL/usrbin/aregcmd -C localhost -N admin -P aicuser
Access Registrar Configuration Utility

Copyright (C) 1995-2016 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 Prime Access Registrar Script object:

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

<... other output deleted...>

--> add LocalAccounting
Added LocalAccounting

Step 3 Using aregcmd, fill in the details of the new Prime Access Registrar Script object. See “Configuring and Monitoring the RADIUS Server,” 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 Prime Access Registrar Script object to the appropriate Prime Access Registrar Scripting point. See “Configuring and Monitoring the RADIUS Server,” 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 10-1 .