Manual Chapter : Provisioning Static Subscribers

Applies To:

Show Versions Show Versions

BIG-IP PEM

  • 14.1.5, 14.1.4, 14.1.3, 14.1.2, 14.1.0
Manual Chapter

Provisioning Static Subscribers

Overview: Provisioning static subscribers

If you have subscribers that are not managed on a separate policy charging and rules function (PCRF), you can create static subscribers.
Static subscribers
are individual subscribers of services that are not managed by a separate policy server. You can add static subscribers directly to the Policy Enforcement Manager, and assign enforcement policies to them. Each subscriber can have one or more enforcement policies associated with them.
You can use static subscribers alone or in combination with those managed by a PCRF.

Provisioning multiple subscribers

Before you create a subscriber, you need to create the enforcement policy that you want to associate with the subscriber.
You can provision multiple subscribers to BIG-IP Policy Enforcement Manager and associate policies with them. This is useful, for example, if you are not using a separate policy charging and rules function (PCRF) for subscribers, or if you need to add a subscriber with a unique enforcement policy.
  1. On the Main tab, click
    Policy Enforcement
    Subscribers
    .
    The Subscribers screen opens.
  2. Click
    Create
    .
    The New Subscriber screen opens.
  3. From the
    Subscriber ID Type
    list, select the format of the subscriber ID.
    Option
    Description
    E.164
    A numbering plan that defines the format of an MSISDN international phone number (up to 15 digits). The number typically consists of three fields: country code, national destination code, and subscriber number.
    IMSI
    International Mobile Subscriber Identity. A globally unique code number that identifies a GSM, UMTS, or LTE mobile phone user.
    NAI
    Network Access Identifier. A fully qualified network name (FQDN) in the form
    <user>@<realm>;
    identifies a subscriber and the home network to which the subscriber belongs.
    Private
    The subscriber ID type is private for the given deployment.
  4. In the
    Subscriber ID
    field, type a unique identifier (up to 64 characters) for the subscriber, such as a phone number. The subscriber ID type determines the format.
  5. In the
    Subscriber IP Address
    area, type the
    IP address
    of the subscriber in IPv4 or IPv6-Prefix format. Click
    Add
    to add multiple IP addresses. This field is optional but recommended.
    Assigning the subscriber IP addresses ensures that the subscriber gets the entitled service faster.
  6. In the
    Policies
    setting, select at least one enforcement policy from the
    Available
    list and move it to the
    Selected
    list.
    The selected policy is the one that the system enforces for the subscriber you are adding.
    You can assign a transactional policy to an active subscriber if you have created a transactional policy with the transactional reporting rule action.
  7. Click
    Finished
    .
    Policy Enforcement Manager creates a static subscriber.
When the subscriber accesses the network through the BIG-IP system, Policy Enforcement Manager applies the policy you assigned to the subscriber traffic.

Subscriber CSV file format

You can upload a list of static subscribers for policy enforcement on the BIG-IP® system. A CSV file is a text file in a comma-separated-values format. Microsoft Excel® can be used to view and create such files. The list of subscribers must be in a text file in comma separated value (CSV) format.
Each line of the CSV file represents one subscriber in the format:
SubscriberId,SubscriberIdType,NumOfIPs[,IP_i]*[,Policy_i]+
subscriber ID
A unique identifier for the subscriber that depends on the subscriber ID type.
subscriber ID type
The format of the subscriber ID. This field is optional, but the comma is required. If you omit subscriber ID type, the system assigns the default value of IMSI (International Mobile Subscriber Identity).
subscriber IP
The IP address of the subscriber. This field is optional, but the comma is required.
subscriber IP list
The list of subscribers. This field is optional, but the comma is required.
policy_1,policy_2,policy_n
One policy or more policies assigned to the subscriber. Multiple policies must be separated by commas.
To allow multiple IPs you need to change the DB variable (
tmm.pem.session.ip.addr.max
).
For example:
2083003251,private,2,40.0.1.0,40.0.1.1,policy1,policy2
You must include Subscriber ID and at least one policy enforcement policy for each subscriber. You need to include the comma for missing fields. Do not include spaces between values. The policies listed must be included on the policies list in
Policy Enforcement
Policies
, and be provisioned using a listener or a policy enforcement profile.
For example, to specify subscriber 2083003252 in IMSI format with a gold policy, you can leave out the subscriber IP address and include one policy:
2083003252,imsi,0,policy1

Provisioning a file of static subscribers

You can upload a CSV file containing a list of static subscribers. The file must be in a specific CSV file format.
  1. On the Main tab, click
    Policy Enforcement
    Subscribers
    .
    The Subscribers screen opens.
  2. Click
    Upload
    .
  3. In the
    File Name
    setting, click the button to browse to the text file.
    The system opens a screen where you can select the text file
  4. Click
    Upload
    .
The Policy Enforcement Manager uploads the static subscriber file in chunks of 1000 subscribers. The system performs a validation on each chunk. If a validation fails, the subscribers in the current chunk and subsequent chunks are not imported. However, the subscribers loaded in previous chunks are imported onto the system. The Policy Enforcement Manager applies the appropriate policy to traffic from the subscribers in the list.