• No results found

Dynamic Data Services

Table 30: Dynamic Data Services (description)

Attribute ID Attribute Name Description

26-6527-164 Alc-Dyn-Serv-SAP-Id Identifies the dynamic data service SAP. Only Ethernet ports and LAGs are valid. The Dynamic Service SAP-ID uniquely identifies a Dynamic Data Service instance. It can be specified explicitly or relative to the control channel SAP-ID using wildcards. If explicitly specified, the Dynamic Data Service SAP-ID and Control Channel SAP-ID do not have to be on the same port.

The setup of the Dynamic Data Service fails if the SAP specified in Alc-Dyn- Serv-SAP-Id is not created. The Dynamic Data Service SAP becomes orphaned if the SAP is not deleted with a teardown action.

26-6527-165 Alc-Dyn-Serv-Script- Params

Parameters as input to the Dynamic Data Service Python script. The

parameters can cross an attribute boundary. The concatenation of all Alc-Dyn- Serv-Script-Params attributes with the same tag in a single message must be formatted as function-key <dictionary> where function-key specifies which Python functions will be called and <dictionary> contains the actual parameters in a Python dictionary structure format. In dynamic service RADIUS accounting messages, the attribute is sent untagged and contains the last received Alc-Dyn-Serv-Script-Params value in an Access-Accept or CoA message for this dynamic service. Multiple attributes may be present if the total length does not fit a single attribute.

26-6527-166 Alc-Dyn-Serv-Script- Action

The action specifies if a dynamic data service should be created (setup), changed (modify) or deleted (teardown). Together with the <function-key> in the Alc-Dyn-Serv-Script-Params, this attribute determines which Python function will be called.The attribute is mandatory in a CoA message. The attribute is optional in an Access-Accept message. If included in an Access- Accept and the specified action is different from setup, the dynamic data service action fails.

26-6527-167 Alc-Dyn-Serv-Policy Specifies the local configured Dynamic Data Service Policy to use for provisioning of this dynamic service. If the attribute is not present, the dynamic services policy with the name default is used. If the default policy does not exist, then the dynamic data service action fails.The Alc-Dyn-Serv- Policy attribute is optional in case of modify or teardown actions; the policy specified for the dynamic data service setup is automatically used. If the Alc- Dyn-Serv-Policy is specified for modify or teardown actions, it must point to the same dynamic services policy as used during the dynamic data service setup. If a different policy is specified, the action fails.

26-6527-168 Alc-Dyn-Serv-Acct- Interim-Ivl-1

The number of seconds between each dynamic data service accounting interim update for the primary accounting server. Overrides local configured value in the Dynamic Services policy. With value = 0, the interim accounting to the primary accounting server is switched off.The dynamic data service accounting interim interval cannot be changed for an active service. The attribute is rejected if the script action is different from setup

26-6527-169 Alc-Dyn-Serv-Acct- Interim-Ivl-2

The number of seconds between each dynamic data service accounting interim update for the duplicate accounting server. Overrides local configured value in the Dynamic Services policy. With value = 0, the interim accounting to the duplicate accounting server is switched off.The dynamic data service accounting interim interval cannot be changed for an active service. The attribute is rejected if the script action is different from setup

26-6527-170 Alc-Dyn-Serv-Acct- Stats-Type-1

Enable or disable dynamic data service accounting to the primary accounting server and specify the stats type: volume and time or time only. Overrides the local configured value in the Dynamic Services Policy.The dynamic data service accounting statistics type cannot be changed for an active service. The attribute is rejected if the script action is different from setup

26-6527-171 Alc-Dyn-Serv-Acct- Stats-Type-2

Enable or disable dynamic data service accounting to the secondary accounting server and specify the stats type: volume and time or time only. Overrides the local configured value in the Dynamic Services Policy.The dynamic data service accounting statistics type cannot be changed for an active service. The attribute is rejected if the script action is different from setup

Table 31: Dynamic Data Services (limits)

Attribute ID Attribute Name Type Limits SR-OS Format

26-6527-164 Alc-Dyn-Serv-SAP-Id string 1 VSA per tag per message

Any valid Ethernet SAP format (null, dot1q or qinq encaps), including LAGs. A wildcard (#) can be specified for the port field and optionally for one of the tag fields of a qinq encap. To find the dynamic data service SAP-ID, the wildcard fields are replaced with the corresponding field from the Control Channel SAP-ID.

For example: Alc-Dyn-Serv-SAP-Id:1 = 1/2/7:10.201

Alc-Dyn-Serv-SAP-Id:2 = #:#.100 26-6527-165 Alc-Dyn-Serv-Script-

Params

string multiple VSA's per tag per message. Max length of concatenated strings per tag = 1000 bytes

The script parameters may be continued across attribute boundaries. The

concatenated string must have following format: function-key <dictionary> where function-key specifies which Python functions will be used and <dictionary> contains the actual parameters in a Python dictionary structure format.

For example: Alc-Dyn-Serv-Script- Params:1 = data_svc_1 = { 'as_id' : '100', 'comm_id' : '200', 'if_name' : 'itf1', 'ipv4_address': '1.1.1.1', 'egr_ip_filter' : '100' , 'routes' : [{'to' : '200.1.1.0/24', 'next-hop' : '20.1.1.1'}, {'to' : '200.1.2.0/ 24', 'next-hop' : '20.1.1.1'}]} 26-6527-166 Alc-Dyn-Serv-Script- Action

integer 1 VSA per tag per message

1=setup, 2=modify, 3=teardown For example: Alc-Dyn-Serv-Script- Action:1 = 2

26-6527-167 Alc-Dyn-Serv-Policy string 1 VSA per tag per message; max. length: 32 chars.

The name of the local configured Dynamic Service Policy

For example: Alc-Dyn-Serv-Policy:1 = dynsvc-policy-1

26-6527-168 Alc-Dyn-Serv-Acct- Interim-Ivl-1

integer 1 VSA per tag per message

[300.. 15552000]

A value of 0 (zero) corresponds with no interim update messages.

A value [1..299] seconds is rounded to 300s (min. CLI value) and a value > 15552000 seconds (max. CLI value) is rounded to the max. CLI value. Range = 0 | [300.. 15552000] For example: Alc-Dyn-Serv-Acct- Interim-Ivl-1:1 = 3600

26-6527-169 Alc-Dyn-Serv-Acct- Interim-Ivl-2

integer 1 VSA per tag per message

[300.. 15552000]

A value of 0 (zero) corresponds with no interim update messages.

A value [1..299] seconds is rounded to 300s (min. CLI value) and a value > 15552000 seconds

(max. CLI value) is rounded to the max. CLI value.

Range = 0 | [300.. 15552000] For example: Alc-Dyn-Serv-Acct- Interim-Ivl-2:1 = 86400

26-6527-170 Alc-Dyn-Serv-Acct- Stats-Type-1

integer 1 VSA per tag per message

1=off, 2=volume-time, 3=time

For example: Alc-Dyn-Serv-Acct-Stats- Type-1:1 = 1

26-6527-171 Alc-Dyn-Serv-Acct- Stats-Type-2

integer 1 VSA per tag per message

1=off, 2=volume-time, 3=time

For example: Alc-Dyn-Serv-Acct-Stats- Type-2:1 = 2

Table 32: Dynamic Data Services (applicability)

Attribute ID Attribute Name

Ac ces s Re q u e s t Ac ces s Acc e p t CoA Re q u e s t Ta g M ax. T a g . 26-6527-164 Alc-Dyn-Serv-SAP-Id 0 0+ 0+ Y 0-31 26-6527-165 Alc-Dyn-Serv-Script-Params 0 0+ 0+ Y 0-31 (untagged) 26-6527-166 Alc-Dyn-Serv-Script-Action 0 0+ 0+ Y 0-31 26-6527-167 Alc-Dyn-Serv-Policy 0 0+ 0+ Y 0-31 26-6527-168 Alc-Dyn-Serv-Acct-Interim-Ivl-1 0 0+ 0+ Y 0-31 26-6527-169 Alc-Dyn-Serv-Acct-Interim-Ivl-2 0 0+ 0+ Y 0-31 26-6527-170 Alc-Dyn-Serv-Acct-Stats-Type-1 0 0+ 0+ Y 0-31 26-6527-171 Alc-Dyn-Serv-Acct-Stats-Type-2 0 0+ 0+ Y 0-31

Table 33: Dynamic Data Services — Control Channel CoA Attributes

Attribute name Setup Modify Tear Down

Comment

Acct-Session-Id M M M Acct-Session-Id of the Control Channel (or any other valid CoA key for ESM hosts/sessions)

Alc-Dyn-Serv-SAP-Id M(*) M(*) M(*) Identifies the dynamic data service Alc-Dyn-Serv-Script-

Params

M(*) M(*) N/A For a Modify, the Script Parameters represent the new parameters required for the change.

Alc-Dyn-Serv-Script- Action

M(*) M(*) M(*)

Alc-Dyn-Serv-Policy O O O Default policy used when not specified for create Must be same as used for setup if specified for Modify or Teardown. Alc-Dyn-Serv-Acct- Interim-Ivl-1 O X (**) X (**) Ignored in Modify Alc-Dyn-Serv-Acct- Interim-Ivl-2 O X (**) X (**) Ignored in Modify Alc-Dyn-Serv-Acct- Stats-Type-1 O X (**) X (**) Ignored in Modify Alc-Dyn-Serv-Acct- Stats-Type-2 O X (**) X (**) Ignored in Modify

M = Mandatory, O = Optional, X = May Not, N/A = Not Applicable (ignored) (*) = CoA Nackd if not specified (Error Cause: 402 — Missing Attribute) (**) = CoA Nackd if specified (Error Cause: 405 — Unsupported Service)