Cisco Prime Access Registrar 9.2 Release Notes
Co-Existence With Other Network Management Applications
New and Enhanced Features in Cisco Prime Access Registrar 9.2
Configuring LDAP Remote Server over SSL
Qualification with Latest Oracle Servers
Qualification with Latest MySQL Servers
Support for Secure ODBC Connection
Support for LDAP Multi-Value Attributes Mapping
Support for Session Query, POD, CoA over XML Interface
Cisco Prime Access Registrar 9.2 Bugs
Cisco Prime Access Registrar (Prime Access Registrar) is a high performance, carrier class, 3GPP-compliant, 64-bit RADIUS/Diameter solution that provides scalable, flexible, intelligent authentication, authorization, and accounting (AAA) services.
Prime Access Registrar comprises a RADIUS/Diameter server designed from the ground up for performance, scalability, and extensibility for deployment in complex service provider environments including integration with external data stores and systems. Session and resource management tools track user sessions and allocate dynamic resources to support new subscriber service introductions.
Note Prime Access Registrar can be used with Red Hat Enterprise Linux (RHEL) 7.x and 8.2 or CentOS 7.x operating system. Also, Prime Access Registrar is qualified with VMware ESXi 7.0 Update 1c.
Note Support for EAP-FAST has been deprecated from Prime Access Registrar release 9.2.
This section describes the system requirements to install and use the Prime Access Registrar software.
Table 1 lists the system requirements for Prime Access Registrar 9.2.
Note Prime Access Registrar supports OpenStack Stein and Victoria versions. You must have the 64-bit rpm files for the relevant RHEL versions while installing Prime Access Registrar. For the list of required rpms for the relevant OS versions, see Required 64-bit rpms for Relevant RHEL OS Versions. |
|
Prime Access Registrar supports JDK versions 1.8.x and 11.x. Also, Prime Access Registrar is qualified with VMware ESXi 7.0 Update 1c.
Note These are the minimum system requirements to have Prime Access Registrar up and running. This may vary based on the deployments. Please contact your BU team to know the specific system requirements for your deployment.
Required 64-bit rpms for Relevant RHEL OS Versions
To achieve optimal performance, Prime Access Registrar should be the only application running on a given server. In certain cases, when you choose to run collaborative applications such as a SNMP agent, you must configure Prime Access Registrar to avoid UDP port conflicts. The most common conflicts occur when other applications also use ports 2785 and 2786. For more information on SNMP configuration, see the “Configuring SNMP” section in the “Configuring Cisco Prime Access Registrar” chapter of the Cisco Prime Access Registrar 9.2 Administrator Guide.
Cisco Prime Access Registrar 9.2 provides the following features:
Prime Access Registrar allows you to configure Lightweight Directory Access Protocol (LDAP) remote server over Secure Sockets Layer (SSL) protocol. For this, you must do the following under /Radius/RemoteServers/LDAP:
Till release 9.1.x, Prime Access Registrar supports LDAP configuration with Transport Layer Security (TLS) protocol up to TLSv1.0. From release 9.2 onwards, Prime Access Registrar supports TLSv1.1, TLSv1.2, and TLSv1.3 (Support for SSL3 and TLSv1.0 versions is deprecated).
The following parameters are added under /Radius/Advanced/ to support this feature:
The following is a sample CLI of the LDAP remote server configuration over SSL:
Prime Access Registrar is qualified with the latest oracle servers 18c and 19c. This requires a compatible client to be installed or placed as per oracle recommendations. All oracle client library files must be placed under $ORACLE_HOME/lib.
Prime Access Registrar is qualified with the latest MySQL versions 8.0.19, 8.0.23, and 8.0.24. This requires compatible mysql-connector-odbc and mysql-community-client-plugins to be installed or placed as per MySQL recommendations. Supported mysql-connector-odbc versions are 8.0.19, 8.0.22, and 8.0.23.
Prime Access Registrar is enhanced to support the secure Open Database Connectivity (ODBC) connections with MySQL server using SSL. The following new attributes are added under /Radius/Advanced/ODBCDataSources in aregcmd to support this feature:
Following is a sample CLI configuration with the new parameters added for ODBC data sources:
Following example shows a sample CLI configuration of the secure ODBC remote server:
LDAP attributes mapping support has been enhanced to accommodate multiple values to get mapped with the information fetched from LDAP. The LDAP query returns multi-value attributes in LDAP Authentication services. These will get mapped to corresponding attributes based on the LDAPToEnvironmentMappings. E.g. the parameter Data under LDAPToEnvironmentMappings is mapped to two values NAS-Identifier and Reply-Message using a supported delimiter configured using the LDAPMultiValDelimiter parameter under /Radius/Advanced. The default delimiter is comma (,).
Following example shows a sample CLI of the LDAP configuration:
The LDAP data is mapped to environment dictionary variables and we need to put them in the response dictionary if they are required to be sent in the response packet.
A sample script is shown below:
Following is a sample CLI with the LDAPMultiValDelimiter parameter configuration:
With this feature, the existing XML interface on UDP port (8080) is enhanced to handle session query, Change Of Authorization (CoA), and Packet of Disconnect (PoD) requests over REST/CLI.
A new XML tag attribute Action is introduced to handle the three types of requests. The Action tag value can be Query, CoA, or PoD. If a request does not contain the Action XML tag, Prime Access Registrar treats it as a session cache request and sends the response accordingly.
Based on the incoming request, Prime Access Registrar returns attributes which are configured in the session cache resource manager along with the attributes that are cached by default e.g. User-Name, Nas-Identifier, and so on.
If the Action XML tag in the request contains a value other than Query, CoA, or PoD, Prime Access Registrar drops the request.
For XML Client, you need to configure the port in /Radius/Advanced/Ports/. This is the port that the client uses to send the XML Packet.
Configure the default port as 1812 for RADIUS client.
Configure the xmlclient in /localhost/Radius/Client.
You need to configure the attributes which Prime Access Registrar needs to cache and return in response for each of the query requests as shown below:
Following examples show the request and response samples for Query, CoA, and PoD:
1. If Input Attribute is User-Name:
2. If Input Attribute is Framed-IP-Address:
3. If Input Attribute is Framed-IPv6-Address:
1. If Input Attribute is User-Name:
2. If Input Attribute is Framed-IP-Address:
3. If Input Attribute is Framed-IPv6-Address:
1. If Input Attribute is User-Name:
2. If Input Attribute is Framed-IP-Address:
This section contains the following information:
Use the Bug Search tool (BST) to get the latest information about Cisco Prime Access Registrar bugs. BST allows partners and customers to search for software bugs based on product, release, and keyword, and it aggregates key data such as bug details, product, and version.
When you open the Bug Search page, check the interactive tour to familiarize yourself with these and other Bug Search features.
Step 1 Log into the Bug Search Tool.
a. Go to https://tools.cisco.com/bugsearch.
b. At the Log In screen, enter your registered Cisco.com username and password; then, click Log In. The Bug Search page opens.
Note If you do not have a Cisco.com username and password, you can register for them at http://tools.cisco.com/RPF/register/register.do.
Step 2 To search for a specific bug, enter the bug ID in the Search For field and press Return.
Step 3 To search for bugs in a particular release:
a. In the Search For field, enter the product name and the release version, e.g. Cisco Prime Access Registrar 9.2, and press Return. (Leave the other fields empty.)
b. When the search results are displayed, use the filter and sort tools to find the types of bugs you are looking for. You can search for bugs by severity, by status, how recently they were modified, according to the number of support cases associated with them, and so forth.
For a complete list of Cisco Prime Access Registrar documentation, see the Cisco Prime Access Registrar 9.2 Documentation Overview.
Note We sometimes update the documentation after original publication. Therefore, you should also review the documentation on Cisco.com for any updates.