1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
|
# Heat template which intstantiates a Perimeta SSC and up to 10 Perimeta
# RTP MSCs and up to 10 Perimeta MSRP MSCs. Currently all instances are
# HA although standalone MSCs may be supported in future.
#
# This Heat template commissions, partners and configures the Perimeta SSC and
# MSCs with basic configuration defined by ssc_a_template.json,
# msc_a_template.json and mmc_a_template.json. These can be modified
# as required to obtain the required Perimeta configuration.
#
# This template puts the Perimeta configuration in place using userdata
# injected via OpenStack's ConfigDrive mechanism.
#
# This template sets up anti-affinity using server group anti-affinity and
# optionally availability zone anti-affinity.
#
# This template will work with any version of Perimeta software from 3.9.20.
#
# Pre-requisites are:
# - existing networks as follows
# - network for management traffic
# - network for HA traffic
# - network for core/trusted service traffic
# - network for access/untrusted service traffic
# - pre-loaded Perimeta image
# - suitable flavor to use for Perimeta SSC
# - suitable flavor to use for Perimeta RTP MSCs
# - suitable flavor to use for Perimeta MSRP MSCs
# - suitable keypair to use for Perimeta
#
# Virtual IP address and fixed IP addresses to use for the Perimeta instances
# must be provided as parameters.
#
# Template requires Juno or above and has been tested on Kilo. Note that in
# some deployments, Heat template validation will fail but actually creating
# a stack using the template will succeed. This is due to problems with
# Heat validating nested templates.
#
heat_template_version: 2014-10-16
description: >
HOT template to instantiate a Perimeta SSC plus MxRTP MSCs plus NxMSRP MSCs
parameters:
# General VNF parameters
vnf_id:
type: string
description: ID of VNF
vf_module_id:
type: string
description: Unique ID for this VF Module instance
availability_zone_0:
type: string
description: Availability zone for A instances.
availability_zone_1:
type: string
description: Availability zone for B instances.
perimeta_keypair:
type: string
description: Keypair to use for accessing these Perimeta instances
constraints:
- custom_constraint: nova.keypair
ntp_server_ip_addrs:
type: string
description: NTP server IPv4 addresses, separated by commas. These must be accessible from the management network
constraints:
- allowed_pattern: "((?:\\d{1,3}\\.){3}\\d{1,3},)*((?:\\d{1,3}\\.){3}\\d{1,3})"
description: ntp_server_ip_addrs must be a comma separated list of IPv4 addresses (with no spaces)
perimeta_param_server_group:
type: string
description: UUID of server group to set anti-affinity policy for Perimeta instance. Only used when doing healing.
# Management network parameters
mgmt_net_id:
type: string
description: Management network ID
constraints:
- custom_constraint: neutron.network
mgmt_net_plen:
type: number
description: Management network prefix length
constraints:
- range: { min: 0, max: 32 }
description: mgmt_net_plen must be between 0 and 32
mgmt_net_default_gateway:
type: string
description: Default gateway for management network
mgmt_net_sec_groups:
type: comma_delimited_list
description: Management network security groups
# Internal high availability network parameters
int_ha_net_id:
type: string
description: Internal HA network ID
constraints:
- custom_constraint: neutron.network
int_ha_net_plen:
type: number
description: Intermal HA network prefix length.
constraints:
- range: { min: 0, max: 32 }
description: int_ha_net_plen must be between 0 and 32
int_ha_net_sec_groups:
type: comma_delimited_list
description: Security groups associated with internal HA network
# Trusted/core network parameters
trusted_net_id:
type: string
description: Network ID of trusted/core network.
constraints:
- custom_constraint: neutron.network
trusted_net_sec_groups:
type: comma_delimited_list
description: Security groups associated with trusted/core network
# Untrusted/access network parameters
untrusted_net_id:
type: string
description: Network ID of untrusted/access network.
constraints:
- custom_constraint: neutron.network
untrusted_net_sec_groups:
type: comma_delimited_list
description: Security groups associated with untrusted/access network
untrusted_num_vlans:
type: number
description: Number of VLANs to connect to on the untrusted/access network
untrusted_vlan_ids:
type: comma_delimited_list
description: List of VLAN IDs to use on the untrusted/access network
untrusted_vlan_networks:
type: comma_delimited_list
description: List of Contrail VLAN networks to use on the untrusted/access network. The order and number of these must match the VLAN ID list
# Unused network parameters
#
# This is used for connecting the unused 4th SSC service interface.
unused_port_net_id:
type: string
description: Unused network ID
constraints:
- custom_constraint: neutron.network
# SSC parameters
ssc_flavor_name:
type: string
description: Flavor to use for creating SSC VM instance
constraints:
- custom_constraint: nova.flavor
ssc_image_name:
type: string
description: Glance image to use for launching SSC Perimeta instances.
constraints:
- custom_constraint: glance.image
ssc_a_name_0:
type: string
description: Name of VM A of SSC
constraints:
- allowed_pattern: '[a-zA-Z0-9][a-zA-Z0-9-]{0,31}$'
description: VM A name must be 32 characters or less and a valid hostname. Only alphanumeric characters plus hyphen are allowed.
ssc_b_name_0:
type: string
description: Name of VM B of SSC
constraints:
- allowed_pattern: '[a-zA-Z0-9][a-zA-Z0-9-]{0,31}$'
description: VM B name must be 32 characters or less and a valid hostname. Only alphanumeric characters plus hyphen are allowed.
ssc_system_name_0:
type: string
description: System name of SSC
constraints:
- allowed_pattern: '[a-zA-Z0-9][a-zA-Z0-9-]{0,31}$'
description: System name must be 32 characters or less and a valid hostname. Only alphanumeric characters plus hyphen are allowed.
# SSC IP addresses on management network
ssc_mgmt_vip_0:
type: string
description: Management virtual IP address to use for SSC. Only required when predefining VIPs.
ssc_a_mgmt_ip_0:
type: string
description: Management fixed IP address to use for SSC A. Only required when predefining fixed IPs.
ssc_b_mgmt_ip_0:
type: string
description: Management fixed IP address to use for SSC B. Only required when predefining fixed IPs.
# SSC IP addresses on internal HA network
ssc_a_int_ha_ip_0:
type: string
description: HA fixed IP address to use for SSC A. Only required when predefining fixed IPs.
ssc_b_int_ha_ip_0:
type: string
description: HA fixed IP address to use for SSC B. Only required when predefining fixed IPs.
# SSC IP addresses on trusted/core network
ssc_trusted_vip_0:
type: string
description: Virtual IPv4 address on trusted/core network for SSC.
ssc_a_trusted_ip_0:
type: string
description: Fixed IPv4 address on trusted/core network for SSC A. Only required when predefining fixed IPs.
ssc_b_trusted_ip_0:
type: string
description: Fixed IPv4 address on trusted/core network for SSC B. Only required when predefining fixed IPs.
# SSC IP addresses on untrusted/access network
ssc_untrusted_vip_0:
type: string
description: Virtual IPv4 address on untrusted/access network for SSC. Only required when predefining virtual IPs.
ssc_untrusted_v6_vip_0:
type: string
description: Virtual IPv6 address on untrusted/access network for SSC. Only required when predefining virtual IPs.
ssc_a_untrusted_ip_0:
type: string
description: Fixed IPv4 address on untrusted/access network for SSC A. Only required when predefining fixed IPs.
ssc_a_untrusted_v6_ip_0:
type: string
description: Fixed IPv6 address on untrusted/access network for SSC A. Only required when predefining fixed IPs.
ssc_b_untrusted_ip_0:
type: string
description: Fixed IPv4 address on untrusted/access network for SSC B. Only required when predefining fixed IPs.
ssc_b_untrusted_v6_ip_0:
type: string
description: Fixed IPv6 address on untrusted/access network for SSC B. Only required when predefining fixed IPs.
# SSC IP addresses on management/Rf network
ssc_rf_vip_0:
type: string
description: Virtual IPv4 address on management/Rf network for SSC. Only required when predefining virtual IPs.
ssc_a_rf_ip_0:
type: string
description: Fixed IPv4 address on management/Rf network for SSC A. Only required when predefining fixed IPs.
ssc_b_rf_ip_0:
type: string
description: Fixed IPv4 address on management/Rf network for SSC B. Only required when predefining fixed IPs.
# RTP MSC parameters
rtp_msc_count:
type: number
description: Count of required RTP MSCs
rtp_msc_flavor_name:
type: string
description: Flavor to use for creating RTP MSC VM instances
constraints:
- custom_constraint: nova.flavor
rtp_msc_image_name:
type: string
description: Glance image to use for launching RTP MSC Perimeta instances.
constraints:
- custom_constraint: glance.image
rtp_msc_a_names:
type: comma_delimited_list
description: List of names of RTP MSC VM A instances
rtp_msc_b_names:
type: comma_delimited_list
description: List of names of RTP MSC VM B instances
rtp_msc_system_names:
type: comma_delimited_list
description: List of system names of RTP MSC instances
# RTP MSC IP addresses on management network
rtp_msc_mgmt_vips:
type: comma_delimited_list
description: Management virtual IP addresses to use for RTP MSC instances. There must be at least as many as the number of RTP MSCs.
rtp_msc_a_mgmt_ips:
type: comma_delimited_list
description: Management fixed IP addresses to use for RTP MSC A instances. There must be at least as many as the number of RTP MSCs.
rtp_msc_b_mgmt_ips:
type: comma_delimited_list
description: Management fixed IP addresses to use for RTP MSC B instances. There must be at least as many as the number of RTP MSCs.
# RTP MSC IP addresses on internal HA network
rtp_msc_a_int_ha_ips:
type: comma_delimited_list
description: HA fixed IP addresses to use for RTP MSC A instances. There must be at least as many as the number of RTP MSCs.
rtp_msc_b_int_ha_ips:
type: comma_delimited_list
description: HA fixed IP addresses to use for RTP MSC B instances. There must be at least as many as the number of RTP MSCs.
# RTP MSC IP addresses on trusted/core network
rtp_msc_trusted_vips:
type: comma_delimited_list
description: Virtual IPv4 addresses on trusted/core network for RTP MSC instances. There must be at least as many as the number of RTP MSCs.
rtp_msc_a_trusted_ips:
type: comma_delimited_list
description: Fixed IPv4 addresses on trusted/core network for RTP MSC A instances. There must be at least as many as the number of RTP MSCs.
rtp_msc_b_trusted_ips:
type: comma_delimited_list
description: Fixed IPv4 address on trusted/core network for RTP MSC B instances. There must be at least as many as the number of RTP MSCs.
# RTP MSC IP addresses on untrusted/access network
rtp_msc_untrusted_vips:
type: comma_delimited_list
description: Virtual IPv4 address on untrusted/access network for RTP MSC instances. There must be at least as many as the number of RTP MSCs.
rtp_msc_untrusted_v6_vips:
type: comma_delimited_list
description: Virtual IPv6 address on untrusted/access network for RTP MSC instances. There must be at least as many as the number of RTP MSCs.
rtp_msc_a_untrusted_ips:
type: comma_delimited_list
description: Fixed IPv4 address on untrusted/access network for RTP MSC A instances. There must be at least as many as the number of RTP MSCs.
rtp_msc_a_untrusted_v6_ips:
type: comma_delimited_list
description: Fixed IPv6 address on untrusted/access network for RTP MSC A instances. There must be at least as many as the number of RTP MSCs.
rtp_msc_b_untrusted_ips:
type: comma_delimited_list
description: Fixed IPv4 address on untrusted/access network for RTP MSC B instances. There must be at least as many as the number of RTP MSCs.
rtp_msc_b_untrusted_v6_ips:
type: comma_delimited_list
description: Fixed IPv6 address on untrusted/access network for RTP MSC B instances. There must be at least as many as the number of RTP MSCs.
resources:
# Perimeta SSC
perimeta_ssc:
type: perimeta_ha_swmu_a.yaml
properties:
vnf_id: { get_param: vnf_id }
vm_role: 'ssc'
vf_module_id: { get_param: vf_module_id }
system_names: [{ get_param: ssc_system_name_0 }]
vm_a_names: [{ get_param: ssc_a_name_0 }]
vm_b_names: [{ get_param: ssc_b_name_0 }]
perimeta_instance_index: 0
perimeta_image_name: { get_param: ssc_image_name }
perimeta_flavor_name: { get_param: ssc_flavor_name }
perimeta_keypair: { get_param: perimeta_keypair }
availability_zone_0: { get_param: availability_zone_0 }
availability_zone_1: { get_param: availability_zone_1 }
mgmt_net_id: { get_param: mgmt_net_id }
mgmt_net_plen: { get_param: mgmt_net_plen }
mgmt_net_default_gateway: { get_param: mgmt_net_default_gateway }
mgmt_vips: [{ get_param: ssc_mgmt_vip_0 }]
mgmt_a_ips: [{ get_param: ssc_a_mgmt_ip_0 }]
mgmt_b_ips: [{ get_param: ssc_b_mgmt_ip_0 }]
mgmt_sec_groups: { get_param: mgmt_net_sec_groups }
ha_net_id: { get_param: int_ha_net_id }
ha_network_plen: { get_param: int_ha_net_plen }
ha_a_ips: [{ get_param: ssc_a_int_ha_ip_0 }]
ha_b_ips: [{ get_param: ssc_b_int_ha_ip_0 }]
ha_sec_groups: { get_param: int_ha_net_sec_groups }
trusted_net_id: { get_param: trusted_net_id }
trusted_vips: [{ get_param: ssc_trusted_vip_0 }]
trusted_a_ips: [{ get_param: ssc_a_trusted_ip_0 }]
trusted_b_ips: [{ get_param: ssc_b_trusted_ip_0 }]
trusted_sec_groups: { get_param: trusted_net_sec_groups }
untrusted_net_id: { get_param: untrusted_net_id }
untrusted_vips: [{ get_param: ssc_untrusted_vip_0 }]
untrusted_v6_vips: [{ get_param: ssc_untrusted_v6_vip_0 }]
untrusted_a_ips: [{ get_param: ssc_a_untrusted_ip_0 }]
untrusted_a_v6_ips: [{ get_param: ssc_a_untrusted_v6_ip_0 }]
untrusted_b_ips: [{ get_param: ssc_b_untrusted_ip_0 }]
untrusted_b_v6_ips: [{ get_param: ssc_b_untrusted_v6_ip_0 }]
untrusted_sec_groups: { get_param: untrusted_net_sec_groups }
untrusted_num_vlans: { get_param: untrusted_num_vlans }
untrusted_vlan_ids: { get_param: untrusted_vlan_ids }
untrusted_vlan_networks: { get_param: untrusted_vlan_networks }
serv3_net_id: { get_param: mgmt_net_id }
serv3_vips: [{ get_param: ssc_rf_vip_0 }]
serv3_a_ips: [{ get_param: ssc_a_rf_ip_0 }]
serv3_b_ips: [{ get_param: ssc_b_rf_ip_0 }]
serv3_sec_groups: { get_param: mgmt_net_sec_groups }
unused_net_id: { get_param: unused_port_net_id }
perimeta_param_server_group: { get_param: perimeta_param_server_group }
perimeta_config:
str_replace:
template: {get_file: ssc_a_template.json}
params:
$NTP_SERVER_IP_ADDRS: { get_param: ntp_server_ip_addrs }
$COMPLETION_PARAMS: ''
outputs:
ssc_server_group:
description: Server group for SSC pair
value: { get_attr: [ perimeta_ssc, server_group_used ] }
msw_template_version:
description: Version of the heat templates used to instantiate the VMs
value: "4.0.1 - 2016-10-28"
|