Each unique element like Ports, GigaStream, GTP forward list, and Tool Groups in the mobility_inventory file needs to have a file, with the same name as the element, inside host_vars directory.
For Example
- The element of name 'cpnUkLTE' under group 'CPN' has a file with name 'cpnUkLTE' inside host_vars directory. This file has the properties of the CPN.
- The element of name 'cluster-one' has a file with name 'cluster-one' inside host_vars directory. This has the properties of all the groups like Ports, IPInterface, ToolGroups, etc that the element is a member.
Below are a sample of a host_vars files.
Prerequisite:
Copy
---
validate_certs: false
Ports:
- port:
- 1/1/x1
- 1/1/x2
adminStatus: enable
type: network
GTPWhitelist:
- alias: gtp1
imsi: 310260564627811,310260564627812
state: present
- alias: gtp2
inputFile: './whitelistKeys/TenIMSIs_Valid.txt'
state: present
Gigastreams:
- alias: toolGS_C11
ports:
- 4/1/x1
- 4/1/x2
type: hybrid
state: present
- alias: toolGS_C12
ports:
- 4/1/x3..x4
type: hybrid
state: present
ToolGroups:
- alias: pgGrp_C11
ports:
- 2/1/x1
smartLb: false
type: tool
state: present
- alias: pgGrp_C12
ports:
- 2/1/x2
smartLb: false
type: tool
state: present
Site
Mobility Solutions are generally spread across multiple geographically dispersed data centers called sites.
A site is a collection of the following:
| ■
|
Network element functions. |
| ■
|
Traffic access points for interfaces of such network element functions. |
| ■
|
Visibility and Analytics Fabric (VAF) nodes. |
| ■
|
Traffic monitoring or analysis tool devices (called probes) that are locally connected without using any IP routed tunnels. |
Copy
---
Site:
# Name of the site
alias: UK
# 'skipDeployment' attribute is 'false' for the sites that are intended to be deployed in the incremental deployment process
skipDeployment: true
# Tag values assigned to the site
tags:
- tagKey: Location
tagValues:
- UK
# All the tools used in the site
toolBindings:
- alias: GeoProbe
toolResourceType: GIGASTREAM
toolClusterId: cluster-one
toolResourceId: toolGS_C11
- alias: EEA
toolResourceType: PORTGROUP
toolClusterId: cluster-one
toolResourceId: pgGrp_C11
# Network Ports. Fill as needed in the format 'clusterid:portId'
networkPorts: []
# Policies under 'siteOverrideOfPolicyArrangements' override global policies
siteOverrideOfPolicyArrangements:
forLTE:
_file: /home/ddaniel/automationInventoryDirectory/host_vars/lte_policy_1.yml
for5G: {}
# Leave upNodes and cpNodes as empty
upNodes: []
cpNodes: []
cpNode
Copy
--
ProcessingNode:
# Name of the control processing node
alias: cpnUkLTE
# Tags assigned to the processing node
tags:
- tagKey: Dept
tagValues:
- IT
- Engg
# Type of control node. Possible values for the nodeType are: 'PCPN_LTE', 'PUPN', 'PCPN_5G'
nodeType: PCPN_5G
# Location of the gigasmart engine port assigned to the processing node
location:
clusterId: cluster-one
enginePorts:
- 2/3/e1
# IP interface that needs to be used by the processing node
ipInterfaceAlias: dev3_IpIntUpn_1
gtpControlSample: false
gtpRandomSampling:
enabled: false
# min: 12, max: 48, multiples of 12hrs
interval: 12
numberOfLteSessions: 100000
numberOf5gSessions: 100000
# GS Group HTTP2 port list
app5gHTTP2Ports:
- 8080
- 9000
# Network Ports. Fill as needed in the format 'clusterid:portId'
nodeOverrideNetworkPorts: []
trafficSources:
- networkFunctionName: cpn_pod1_SGW-C
networkFunctionType: SGW-C
tags:
- tagKey: Dept
tagValues:
- IT
- Engg
networkFunctionInterfaces:
- tunnelIdentifiers:
- interfaceTunnelIdentifierType: IPADDRESS
value: 255.255.255.0
netMask: 198.51.100.42
- interfaceTunnelIdentifierType: PORT
value: 8805
interfaceType: Sxa
# Network Ports. Fill as needed in the format 'clusterid:portId'
sourceOverrideNetworkPorts:
- 192.168.65.8:8/1/x3
#TCP loadbalancing properties applicable only for nodeType PCPN_5G
appTcp:
# Possible values for application are : 'broadcast', 'enhanced', 'drop'
application: broadcast
# Possible values for tcpControl are : 'broadcast', 'enhanced', 'drop'
tcpControl: broadcast
# To enable loadbalancing set value as true
loadBalance: false
upNode
Copy
---
ProcessingNode:
# Name of the control processing node
alias: upnDallas
# Tags assigned to the processing node
tags:
- tagKey: Dept
tagValues:
- IT
- Engg
# Type of user node. Possible values for the nodeType are: 'PCPN_LTE', 'PUPN', 'PCPN_5G'
nodeType: PUPN
# To make user node as standalone
standAloneMode: true
# Location of the gigasmart engine port assigned to the processing node
location:
clusterId: cluster-two
enginePorts:
- 6/3/e1
- 6/3/e2
# IP interface that needs to be used by the processing node
ipInterfaceAlias: dev3_IpIntUpn_1
gtpControlSample: false
gtpRandomSampling:
enabled: false
# min: 12, max: 48, multiples of 12hrs
interval: 12
# Network Ports. Fill as needed in the format 'clusterid:portId'
nodeOverrideNetworkPorts: []
trafficSources:
- networkFunctionName: upn_pod1_SGW-U
networkFunctionType: SGW-U
tags:
- tagKey: Dept
tagValues:
- IT
- Engg
networkFunctionInterfaces:
- tunnelIdentifiers:
- interfaceTunnelIdentifierType: IPADDRESS
mask: 255.255.255.0
address: 198.58.100.45
- interfaceTunnelIdentifierType: PORT
value: 8805
interfaceType: Sxa
# Network Ports. Fill as needed in the format 'clusterid:portId'
sourceOverrideNetworkPorts:
- 192.168.65.9:9/1/x4
- 192.168.65.9:9/1/x5
- networkFunctionName: upn_pod2_UPF
networkFunctionType: UPF
tags:
- tagKey: Dept
tagValues:
- IT
- Engg
networkFunctionInterfaces:
- tunnelIdentifiers:
- interfaceTunnelIdentifierValue:
mask: 255.255.255.0
address: 198.58.100.46
interfaceTunnelIdentifierType: IPADDRESS
- interfaceTunnelIdentifierValue:
value: '2152'
interfaceTunnelIdentifierType: PORT
interfaceType: N11
sourceOverrideNetworkPorts:
- 192.168.65.9:9/1/x6
5GPolicy
Copy
---
5GPolicy:
# gtpFlowTimeout is multiplied by 10 minutes to arrive at a timeout interval. (gtpFlowTimeout: 48 = 8 hours). Set this interval to match customer network's GTP session timeout for optimal results
gtpFlowTimeout: 48
# gtpPersistence -- save state tables during reboot or box failure. Remove if not using persistence
gtpPersistence:
# interval in minutes to save state table (min value is 10)
interval: 10
restartAgeTime: 30
fileAgeTimeout: 30
sampling:
flowMaps:
- alias : samplingMap2
rules:
- interface:
dnn: internet.miracle
pei: '*'
supi: 46*
gpsi:
nas_5qi:
tac:
nci:
plmndId:
nsiid:
# -- "controlPlanePercentage: specifies percentage of sampling at CPN (set to 100 for no CPN sampling)
controlPlanePercentage: 100
# -- userPlanePercentage: specifies percentage of sampling at UPN (will be applied to all UPNs -- use site override to set different rates per site)
userPlanePercentage: 50
tool: EEA
whitelisting:
whiteListAlias: gtp1
flowMaps:
- alias : whitelistMap2
rules:
- dnn: internet.miracle
interface:
- supi:
ran:
tool: EEA
loadBalancing:
# one of { flow5g }
appType: flow5g
# metric is the load balancing method -- one of { leastBw, leastPktRate, leastConn, leastTotalTraffic, roundRobin, wtLeastBw, wtLeastPktRate, wtLeastConn, wtLeastTotalTraffic, wtRoundRobin, flow5gKeyHash}
metric: flow5gKeyHash
# hashingKey -- ignored if metric is not of type 'flow5gKeyHash' -- one of { supi | pei| gpsi }
hashingKey: supi
LTEPolicy
Copy
---
LTEPolicy:
# gtpFlowTimeout is multiplied by 10 minutes to arrive at a timeout interval. (gtpFlowTimeout: 48 = 8 hours). Set this interval to match customer network's GTP session timeout for optimal results
gtpFlowTimeout: 48
# gtpPersistence -- save state tables during reboot or box failure. Remove if not using persistence
gtpPersistence:
# interval in minutes to save state table (min value is 10)
interval: 10
restartAgeTime: 30
fileAgeTimeout: 30
sampling:
flowMaps:
- alias : samplingMap1
rules:
- interface:
version: any
apn: internet.miracle
imei: 123*
imsi:
msisdn:
qci:
# -- controlPlanePercentage: specifies percentage of sampling at CPN (set to 100 for no CPN sampling)
controlPlanePercentage: 100
# -- userPlanePercentage: specifies percentage of sampling at UPN (will be applied to all UPNs -- use site override to set different rates per site)
userPlanePercentage: 50
tool: GeoProbe
whitelisting:
whiteListAlias: gtp1
flowMaps:
- alias : whitelistMap1
rules:
- version: v1
interface:
apn:
tool: GeoProbe
loadBalancing:
# one of { gtp | aft | tunnel }
appType: gtp
# metric is the load balancing method -- one of # { leastBw, leastPktRate, leastConn, leastTotalTraffic, roundRobin, wtLeastBw, wtLeastPktRate, wtLeastConn, wtLeastTotalTraffic, wtRoundRobin, gtpKeyHash}
metric: gtpKeyHash
# hashingKey -- ignored if metric is not of type 'gtpKeyHash' -- one of { imsi | imei | msisdn }
hashingKey: imsi