Cisco SCMS SM LEGs User Guide, Release 3.6.x

Installing the Cisco Network Registrar Login Event Generator

Introduction

This chapter describes the Cisco Network Registrar (CNR) Login Event Generator (LEG) installation procedures for both Windows and Solaris platforms. It also describes the uninstall procedure.

•Prerequisites

•Package Contents

•Installing the CNR LEG on Windows

•Installing the CNR LEG on Solaris

•Uninstalling the CNR LEG

Prerequisites

CNR LEG is operable with any CNR version 5.0 or later.

The platform requirements (OS/CPU/RAM/disk) are the same as the CNR requirements for both Windows and Solaris. See Cisco Network Registrar (CNR) Installation Guide for platform requirement details.

Package Contents

The CNR LEG distribution part of the SCMS-SM LEG distribution file and is located in the CNR_LEG directory. Table 3-1 describes the contents of the CNR LEG distribution package supplied by Cisco.

Installing the CNR LEG on Windows

Note The directory in which the CNR is installed is referred to as cnr-inst-dir.

Step 1 Extract the SM LEG distribution file.

Step 2 Locate the CNR LEG distribution tar file under the CNR LEG directory.

Step 3 Extract the CNR LEG distribution and copy the files.

•Unzip the CNR Package to pkg-ext-dir.

•Copy all files under pkg-ext-dir\winnt to <cnr-inst-dir>\Extensions\DHCP\Dex\.

If the \Extensions\DHCP\Dex\ folder does not exist, it must be created.

•Copy the sample configuration file from pkg-ext-dir\doc to a directory of your choice, hereafter referred to as cfg-dir.

Step 4 Configure the CNR LEG using the sample configuration file.

See Information About Configuring the CNR LEG.

Step 5 Configure the SM.

See Information About Configuring the Subscriber Manager.

Step 6 Register the CNR LEG with the CNR.

•Run the CNR <cnr-inst-dir>/bin/nrcmd command-line utility.

•Log in to the CNR nrcmd CLU.

To log in, type the following command:

nrcmd [-C  cluster] [-N  user] [-P  password]

•Configure the following:

nrcmd>extension smleg create dex cnrleg.dll cnrLegPostSendPacket 

nrcmd>extension smleg set init-entry=cnrLegInitEntry 

nrcmd>extension smleg set init-args=cfg-dir/cnrleg.cfg 

nrcmd>dhcp attachExtension post-send-packet smleg 11  

nrcmd>extension smlegext create dex cnrleg.dll cnrLegPostPacketDecode 

nrcmd>dhcp attachExtension post-packet-decode smlegext 12  

nrcmd>save 

nrcmd>server DHCP reload 

Note You must use the cfg-dir full path in the init-args argument.

Note You must use a slash ("/") and not a back-slash ("\") as the path separator.

Installing the CNR LEG on Solaris

Step 1 Extract the SM LEG distribution file.

Step 2 Locate the CNR LEG distribution tar file under the CNR LEG directory.

Step 3 Extract the CNR LEG distribution and copy the files.

•Extract the CNR Package to pkg-ext-dir. For example:

#>tar xvf cnr-leg-dist.tar

•Copy libcnrleg.so under pkg-ext-dir/solaris to <cnr-inst-dir>/extensions/dhcp/dex.

•Copy the sample configuration file from pkg-ext-dir/doc to a directory of your choice, hereafter referred to as cfg-dir.

Step 4 Configure the CNR LEG using the sample configuration file.

See Information About Configuring the CNR LEG.

Step 5 Configure the SM.

See Information About Configuring the Subscriber Manager.

Step 6 Register the CNR LEG with CNR.

•Run the CNR <cnr-inst-dir>/bin/nrcmd command-line utility.

•Log in to the CNR nrcmd CLU.

To log in, type the following command:

nrcmd [-C  cluster] [-N  user] [-P  password]

•Configure the following:

nrcmd>extension smleg create dex libcnrleg.so cnrLegPostSendPacket 

nrcmd>extension smleg set init-entry=cnrLegInitEntry 

nrcmd>extension smleg set init-args=cfg-dir/cnrleg.cfg 

nrcmd>dhcp attachExtension post-send-packet smleg 13  

nrcmd>extension smlegext create dex libcnrleg.so cnrLegPostPacketDecode 

nrcmd>dhcp attachExtension post-packet-decode smlegext 14  

nrcmd>save 

nrcmd>server DHCP reload 

Note You must use the cfg-dir full path in the init-args argument.

Note You must use a slash ("/") and not a back-slash ("\") as the path separator.

Uninstalling the CNR LEG

This section explains how to uninstall the CNR LEG. The uninstall procedure is applicable for both Windows and Solaris platforms.

Step 1 Unregister CNR LEG from CNR.

•Run the CNR <cnr-inst-dir>/bin/nrcmd command-line utility.

•Log in to the CNR nrcmd CLU.

To log in, type the following command:

nrcmd [-C  cluster] [-N  user] [-P  password]

•Configure the following:

nrcmd>dhcp detachExtension post-send-packet 1 

nrcmd>extension smleg delete 

nrcmd>dhcp detachExtension post-packet-decode 1 

nrcmd>extension smlegext delete 

nrcmd>save 

nrcmd>server DHCP reload 

Step 2 Delete the LEG distribution files.

•Delete all files copied to <cnr-inst-dir>/extensions/dhcp/dex.

•Delete the configuration file (cfg-dir/cnrleg.cfg).