1300NM
1354RM Rel.5.2B
ADMINISTRATION GUIDE
ORIGINALE INTERLEAF: FILE ARCHIVIAZIONE: cod ANV (PD1-PD2)
numerate
numbered
da from
a to
1/198
198/198
TARGHETTE - LABELS
957.130.882 U Ed.03
3AL 61260 AAAA Ed.03
frontespizio
front
manuale
manual
198
200
100
ED
03
RELEASED
957.130.882 TQZZA
1/ 4
Site
VIMERCATE
Originators
M.VARISCO
1354RM REL.5.2B
ADMINISTRATION GUIDE
Domain
Division
Rubric
Type
Distribution Codes
:
:
:
:
TND
Approvals
Name
App.
M.RAGNI
Name
App.
INFORMAZIONI EDITORIALI
sistemazione figlist
957.130.882 U
3AL 61260 AAAA
Ed.03
1300NM
1354RM Rel.5.2B
ED
03
RELEASED
957.130.882 TQZZA
2/ 4
1300NM
1354RM Rel.5.2B
Regional Network Manager for SDH and Optical Networks
ADMINISTRATION GUIDE
957.130.882 U Ed.03
VOL.1/1
1300NM
1354RM Rel.5.2B
Regional Network Manager for SDH and Optical Networks
ADMINISTRATION GUIDE
957.130.882 U Ed.03
VOL.1/1
1300NM
1354RM Rel.5.2B
Regional Network Manager for SDH and Optical Networks
957.130.882 U Ed.03
ADMINISTRATION GUIDE
VOL.1/1
VOL.1/1
1300NM
1354RM Rel.5.2B
Regional Network Manager for SDH and Optical Networks
957.130.882 U Ed.03
ED
03
ADMINISTRATION GUIDE
VOL.1/1
RELEASED
957.130.882 TQZZA
3/ 4
ED
03
RELEASED
957.130.882 TQZZA
4/ 4
All rights reserved. Passing on and copying of this
document, use and communication of its contents
not permitted without written authorization from Alcatel.
Administration Guide
Alcatel 1300NM
Network Management
1354RM Rel.5.2B
Regional Network Manager for SDH and Optical Networks
957.130.882 U Ed.03
957.130.882 U Ed.03
TABLE OF CONTENTS
LIST OF FIGURES AND TABLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
HISTORY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
REFERENCED DOCUMENTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1 INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.1 General information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.2 Handbook applicability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.3 Product-release handbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.3.1 Handbooks related to the specific software application . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.3.2 Handbooks related to the products hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.4 Purpose of the Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.5 Intended audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.6 Required skill . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.7 Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9
9
9
10
10
11
11
11
11
12
13
14
14
15
16
16
18
3 INSTALLATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.1 Installation and Customization of Complete delivery Packages . . . . . . . . . . . . . . . . . . . .
3.1.1 SMF installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.1.2 Reconfigure SMF installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.1.3 1354RM Installation Environment Variable Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.2 Installation of Patches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.2.1 RM DB resizing after installation patch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.3 MultiIM Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
19
20
21
21
22
25
25
26
4 HPOV DM CUSTOMIZATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.1 PMD Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
27
27
03
001206
SC00120501
M. Ragni ITAVE
M. Varisco ITAVE
02
000721
SC00072405
M. Ragni ITAVE
M. Varisco ITAVE
01
000414
M. Ragni ITAVE
M. Varisco ITAVE
ED
DATE
APPRAISAL AUTHORITY
ORIGINATOR
CHANGE NOTE
1354RM R5.2.x
System Administrator
Reference Guide
ED
03
957.130.882 U
1 / 198
28
28
28
29
6 USERS MANAGEMENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.1 1354RM Operators Managing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.2 User Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.2.1 HPOVw Users Profile for NetView application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.2.2 CDE Customization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.2.3 Unix Shell Profile (.profile) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.3 Network Access Domain Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.3.1 Adding an RM Operator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.3.2 Defining a new RM Initiator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.3.3 Access Rules description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.3.4 Delivered set of Initiators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.3.5 Default mapping between User Profiles and Initiators . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31
31
32
32
33
33
34
35
36
37
48
48
49
49
50
8 DATABASE MANAGEMENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.1 Database Creation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.2 Database disk usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.3 Database extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.4 Backup and Restore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.5 DB realignment via redo log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.6 Identifier Defragmentation Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.6.1 Procedure steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.6.2 idDefrag procedure structure of log file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.7 DB configuration for huge networks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.8 Managing indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
53
53
54
60
61
63
64
64
65
66
66
67
67
68
69
70
70
10 1354RM BEHAVIOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10.1 EMLs management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10.1.1 Procedures to define EMLs managing Q3 NEs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10.1.2 Procedures to create EMLs managing QB3* NEs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10.1.3 Procedures to delete EMLs managing QB3* NEs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10.2 Path / HOTrail allocation algorithm failures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10.3 Distributed Network Maps (DNM) application customization . . . . . . . . . . . . . . . . . . . . .
10.3.1 Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10.3.2 Registration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10.3.3 Resources Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10.4 Trace management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10.4.1 User Interface applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10.4.2 Information Manager Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
71
71
71
71
71
72
74
74
74
74
75
75
75
ED
03
957.130.882 U
2 / 198
76
77
78
11 1354RM CUSTOMIZATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.1 Environment variables changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.2 Users Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.2.1 Counters refresh rate on agent response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.2.2 Browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.3 EMLNML Alignment Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.4 Inventory Processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.5 Map Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.6 Path/HOTrail Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.6.1 Path/Trail allocation algorithm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.6.2 Reuse already allocated resources in Broadcast paths. . . . . . . . . . . . . . . . . . . . . . . . . .
11.6.3 Using Virtual Nodes during Path Allocation Phase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.6.4 Configurable switch in Drop&Continue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.6.5 Changing timeout for Cross Connection management actions . . . . . . . . . . . . . . . . . . . .
11.6.6 Configuring consistency flow control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.7 Alarm management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.7.1 Flooding protection mechanism . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.7.2 Alarm clearing hysteresis period . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.8 Nap uploading timer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.9 SNCP switch timer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.10 Printer Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.11 Unused Virtual PDH ports garbage collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.12 Setting Linked Get Replies Maximum Number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.13 NetView Symbols Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.14 Performance Monitoring Customization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.14.1 PM Data Collection Customization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.14.2 PM Data Archive Customization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.14.3 PM Scheduled Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.14.4 PM Automatic Start/Stop Measures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.15 How to change the default ASAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.16 Procedure to set Swedish language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
79
79
80
80
80
80
81
81
82
82
82
83
83
83
84
84
84
84
85
85
85
86
86
87
88
88
90
91
91
92
92
93
93
93
93
94
95
96
96
13 EML SIMULATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
13.1 Simulated EML data generation and EML registration . . . . . . . . . . . . . . . . . . . . . . . . . . .
13.1.1 Available Simulated data files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
13.1.2 Simulated data file syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
13.2 Real Network Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
97
97
98
99
100
101
101
101
102
ED
03
957.130.882 U
3 / 198
102
15 MIGRATION PROCEDURE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.1 1354RM R2.4 (NR3.1) to 1354RM R5.2.x Migration Procedure . . . . . . . . . . . . . . . . . . . . .
15.2 Virtual EML registration on Communication Infrastructure (CI) . . . . . . . . . . . . . . . . . . .
15.2.1 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.2.2 Procedure steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.3 Migration Procedure of NEs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.3.1 NE migration between QB3* and QB3 interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.3.2 neGroup modification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.4 OVW Map Conversion from 1354RM R2.4 to 1354RM R5.2.x . . . . . . . . . . . . . . . . . . . . . .
15.4.1 Recover Maps after migration when changing ntwDomld . . . . . . . . . . . . . . . . . . . . . . . .
15.5 Virtual EML registration on Communication Infrastructure (CI) . . . . . . . . . . . . . . . . . . .
15.5.1 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.5.2 Procedure steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
103
104
108
108
108
109
110
115
117
117
118
118
118
119
119
120
121
121
123
123
123
124
124
125
125
125
126
127
127
128
129
130
131
135
136
137
138
138
139
145
149
149
150
155
156
158
158
158
ED
03
957.130.882 U
4 / 198
ED
158
159
161
165
165
166
166
167
168
170
173
175
182
186
188
190
191
192
193
197
198
03
957.130.882 U
5 / 198
FIGURES
Figure 1. Example of directories allocation with at least two physical disks . . . . . . . . . . . . . . . . . . . .
Figure 2. Distribution of files in two application disks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Figure 3. Supported topology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Figure 4. Not supported topology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Figure 5. Reference Network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23
61
95
95
167
TABLES
Table 1. Handbooks related to the specific software application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2. NR 5.0B Related Handbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 3. Documentation on CDROM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 4. Access Rules Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 5. NAD / FAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10
10
10
40
45
ED
03
957.130.882 U
6 / 198
HISTORY
DATE
01
000414
01
02
000721
03
03
001206
05
REFERENCED DOCUMENTS
[2]
[3]
[4]
ED
03
957.130.882 U
7 / 198
ED
03
957.130.882 U
198
8 / 198
All rights reserved. Passing on and copying of this
document, use and communication of its contents
not permitted without written authorization from Alcatel.
1 INTRODUCTION
1.1 General information
WARNING
ALCATEL makes no warranty of any kind with regards to this manual, and specifically disclaims the
implied warranties of merchantability and fitness for a particular purpose. ALCATEL will not be liable
for errors contained herein or for damages, whether direct, indirect, consequential, incidental, or
special, in connection with the furnishing, performance, or use of this material.
NOTICE
The product specification and/or performance levels contained in this document are for information
purposes only and are subject to change without notice. They do not represent any obligation on the
part of ALCATEL.
COPYRIGHT NOTIFICATION
The technical information of this manual is the property of ALCATEL and must not be copied,
reproduced or disclosed to a third party without written consent.
ANV P/N
Factory P/N
1354RM
521.200.800
PRODUCT
RELEASE
VERSION (*)
ANV P/N
Factory P/N
1354RM
5.2B
521.560.420
N.B.
ED
PRODUCT
03
957.130.882 U
9 / 198
The list of handbooks given here below is valid on the issue date of this Handbook and
can be changed without any obligation for ALCATEL to update it in this Handbook.
Some of the handbooks listed here below may not be available on the issue date of this
Handbook.
The standard Customer Documentation in the English language for the equipment whose
product-release-version is stated in para.1.2 on page 9 consists of the following handbooks:
1.3.1 Handbooks related to the specific software application
Table 1. Handbooks related to the specific software application
REF
HANDBOOK
FACTORY
Part No.
[1]
1354RM Rel.5.2B
Installation Guide
957.130.892 W
[2]
1354RM Rel.5.2B
Operators Handbook
957.130.872 H
[3]
1354RM Rel.5.2B
Administration Guide
957.130.882 U
FACTORY
Part No.
957.130.722 A
THIS
HANDBOOK
REF
HANDBOOK
1330AS Rel.5.1
Operators Handbook
[4]
THIS
HANDBOOK
or note
417.100.028
[5]
NOTE
Envisaged after the release of all
Handbooks
ED
03
957.130.882 U
10 / 198
General rules
Risk of explosion
1353SH R5.2
1353WX R1.7.1
A good knowledge of HPUX 10.20, Oracle 7.x Database Management System and HPOV DM platform
is considered a mandatory prerequisite.
ED
03
957.130.882 U
11 / 198
In this document the installation procedure and maintenance operations are described with all the shell
commands needed by this procedure. Either Korn Shell (ksh) or Bourne Shell (sh) are supposed to be
used by the operator.
N.B.
Normally are described commands that can be used with a Korn Shell. If you are using a Bourne
Shell you have to pay attention to the symbol definition command. In Korn Shell you can define
a symbol in the following way:
export symbol_name=<symbol_value>
on the contrary, if you use Bourne shell, you have to split the command in the followings:
symbol_name=<symbol_value>
export symbol_name
The shell commands to be used are described using the following conventions:
Bold means that the string must be typed as it is described in the manual;
<Angle bracket> represent command parameter that must be specified by the operator;
To execute command as root user, it is recommended to change the username using the
command:
su root
instead of su root, because with the recommended command all the RM environment
variables are kept.
ED
03
957.130.882 U
12 / 198
1.7 Conventions
ED
03
957.130.882 U
13 / 198
2.1.1 IM configuration
At least 128 Mb RAM size are required; 256 Mb RAM are recommended.
At least two physical disks are required in order to provide good backup and restore facilities :
1)
the first disk contains the directories used to save backup, reference base, redo log and
mirrored database information.
the second disk contains the 1354RM product,
2)
N.B.
the bdf HPUX command, specifying the directory as a parameter, can be used to
verify in which filesystem a directory is stored.
Data Disk. 1354RM installation tree size depends on number of NEs and paths that must be
managed:
small: ~ 1 Gb
medium: ~ 1.5 Gb
large: ~ 1.9 Gb
If the RM help is installed the previous Disk size shall be increased of 200 Mb.
Backup and Mirror Disk. Backup and Mirror data size depends on number of NEs and paths that
must be managed by 1354RM. The following sizes are referred to snapshot backup area,
reference base for incremental backup and archive area for Oracle redo log files (in this sorting
criteria):
small:
50 Mb + 300 Mb + 300 Mb = 650 Mb
large:
50 Mb + 1100 Mb + 300 Mb = 1450 Mb
Please note that the previously specified snapshot backup area size do not take into account
the disk space required by SH backup and it depends on the number of SH managed by the
1354RM.
N.B.
In order to guarantee Oracle data consistency, Data Disk (1354RM installation) must be
local to the workstation on which 1354RM system will run, and can not be stored in a
filesystem reached via NFS.
The following data have to be also taken into account to evaluate a correct 1354RM disk occupation
:
Installation kit gzipped tar file (if no mass storage device is used): ~ 200 Mb
Swap File on Disk: ~ 512 Mb
N.B.
ED
The previous disk occupation data do not take into account the table space created in the
1354RM Oracle DB by other subsystems (e.g. 1330 AS Alarm Surveillance).
03
957.130.882 U
14 / 198
2.1.2 US configuration
At least 128 Mb RAM size are required; 256 Mb RAM are recommended.
ED
Installation kit gzipped tar file (if no mass storage device is used): ~ 200 Mb
Swap File on Disk: ~ 512 Mb
03
957.130.882 U
15 / 198
2.2.1 IM configuration
1354RM IM have to be installed on Almap HP4 platform updated with the HP4.2 patch level plus the
PHSS_15076 HP patch (for further details, please, refers to Almap Reference Platforms document [2]).
Anyway, at least, the following configuration should be used (note that the OSFMotif 1.2 must be installed
within HPUX 10.20 ):
Bundle(s):
B3560CBEng
B3691AA_APZ
B3782EA
DMPlatDKHP10man
DMPlatDKHPUX10x
DMPlatEngHP10man
DMPlatEngHPUX10x
HPUXEngCR700
J2160A_APZ
J2655AA_APZ
OVLicenseSvrHP10
SoftBenchRef
XSW700CR1020
XSW700GR1020
C.05.25
B.10.20.89
B.10.20
B.05.01
B.05.01
B.05.01
B.05.01
B.10.20
C.07.00
B.10.20.02
B.05.01.00
C.05.25
B.10.20.36
B.10.20.36
SQL*Plus
3.2.3.0.0
SQL*Net V2
2.2.3.0.0
PL/SQL V2
2.2.3.0.0
ED
03
957.130.882 U
16 / 198
The following system kernel parameters have to be set, at least, with these values:
maxusers = 64
maxuprc = 200
ncallout = 548
nproc = 532
shmmni = 200
shmseg = 120
msgmap = 258
msgseg = 7168
msgtql = 256
ED
$OV_BIN/ovdelobj
$OV_BIN/ovdelobj
$OV_BIN/ovdelobj
$OV_BIN/ovdelobj
$OV_BIN/ovdelobj
$OV_LRF/netmon.lrf
$OV_LRF/ovtopmd.lrf
$OV_LRF/ovtrapd.lrf
$OV_LRF/ovactiond.lrf
$OV_LRF/snmpCollect.lrf
03
957.130.882 U
17 / 198
1354RM US have to be installed on Almap HP4 platform updated with the HP4.2 patch level plus the
PHSS_15076 HP patch (for further details, please, refers to Almap Reference Platforms document [2]).
Anyway, at least, the following configuration should be used (note that the OSFMotif 1.2 must be installed
within HPUX 10.20 ):
Bundle(s):
B3560CBEng
B3691AA_APZ
B3782EA
DMPlatDKHP10man
DMPlatDKHPUX10x
DMPlatEngHP10man
DMPlatEngHPUX10x
HPUXEngCR700
J2160A_APZ
J2655AA_APZ
OVLicenseSvrHP10
SoftBenchRef
XSW700CR1020
XSW700GR1020
The following system kernel parameters have to be set, at least, with these values:
maxusers = 64
maxuprc = 200
shmmni = 200
shmseg = 120
msgmap = 258
msgseg = 7168
msgtql = 256
C.05.25
B.10.20.89
B.10.20
B.05.01
B.05.01
B.05.01
B.05.01
B.10.20
C.07.00
B.10.20.02
B.05.01.00
C.05.25
B.10.20.36
B.10.20.36
ED
$OV_BIN/ovdelobj
$OV_BIN/ovdelobj
$OV_BIN/ovdelobj
$OV_BIN/ovdelobj
$OV_BIN/ovdelobj
$OV_LRF/netmon.lrf
$OV_LRF/ovtopmd.lrf
$OV_LRF/ovtrapd.lrf
$OV_LRF/ovactiond.lrf
$OV_LRF/snmpCollect.lrf
03
957.130.882 U
18 / 198
2.2.2 US configuration
3 INSTALLATION
WARNING
The following is the Installation procedure that have to be used only internally
by Alcatel Units during Integration phase. Customers and Alcatel Installation
post DR4 must follow the Installation Procedure described in document NR3
Installation Guide.
In the following paragraph, the shell commands needed to perform installation, customization and
activation of 1354RM are given.
ED
03
957.130.882 U
19 / 198
a)
If there is an old version installed, shutdown the 1354RM system, the 1354RM Oracle instance and
all user service manager instances (ovw, browser and mngAgent).
Since the 1354RM installation performs a reset of OVwDB (even if the Old Mib option is
chosen) no maps will be present at the end of installation. Its mandatory to save the maps to be
kept using DNM application.
b)
Exit from normal user CDE space and login again as root user in CDE login form.
c)
The user snml with the default shell equal to /bin/ksh is created automatically; snml user must be
part of dba group; dba is the same group of the user oracle. This snml user will be the 1354RM
system administrator.
# sam ....
N.B.
d)
Please, do not use as snml user home directory the same directory that will be used as
installation directory of 1354RM product (see d ))
Create (if it does not exist) an empty directory for 1354RM installation tree root :
# mkdir <yoursnmlinstroot>
e)
Change current directory to the SNML installation root and extract restore_gz file from 1354RM
installation tar kit (1354RM installation tar kit is relative to the current directory).
N.B.
Please, do not use the command cd /usr/snml since it will generate some
inconsistencies during the etc/restore_gz procedure.
# cd <yoursnmlinstroot>
# gunzip d c <1354RM...yourmediadevice or tar file> | tar xvf ./etc/restore
N.B.
f)
Please, note that 1354RM... is the standard prefix of each RM complete delivery or
patches.
g)
ED
The installation procedure creates a link /usr/snml that is linked to 1354RM installation
root directory.
A graphical window with all the needed environment variables (etc/env_snml file) is presented to the
user. The variables, if possible, are initialized with the values assigned to them by the operator in
previous release. The user can change, if needed, their values and save them in the new
etc/env_snml file clicking on Apply button (please refer to 3.1.3 for variables description).
03
957.130.882 U
20 / 198
In the following you can find the procedure to install a complete 1354RM delivery.
h)
Execute customize script pressing the Customize button, a window will be opened containing the
traces of the Customize execution. If some errors occur during customize execution, it signals to
the operator the log file where he can find information on the occurred error. The customize procedure
will produce a trace file called etc/customize.trc containing all the messages printed out by the
customize script.
i)
At the end of the previous step, it is necessary to verify the contents of the im_host_conf file, since
it is is generated by the customize procedure (please refers to the paragraph 4.2.1)
j)
If the network to be managed is very big and managed using many EMLs, some system and DB
parameters should be changed, as suggested in the procedure described in the paragraph 8.7.
k)
To activate all the CDE configuration changes it is recommended to exit from the current CDE session
ED
03
957.130.882 U
21 / 198
In the following you can find an explanation of the meaning of variables contained in the file
${SNML_HOME}/etc/env_snml, that have to be initialized for a correct 1354RM installation.
N.B.
In order to verify in which filesystem a directory is stored the bdf <dir_name> HPUX command
can be used.
Root directory of 1354RM product installation tree. The directory must exist
before installation.
The directory must have snml as owner and dba as group and its group write
access enabled (i.e. rwxrwxrx)
HOST_TYPE
N.B.
MIB
SNML_MIRROR
ED
N.B.
N.B.
03
957.130.882 U
22 / 198
DIRECTORIES ALLOCATION
Configuration with two disks
SNML_HOME
SNML_MIRROR
/backup/snml
IM_SERVER
REMOTE_SERVER
AC_INFO_FLAG
CNM_FLAG
In the following the environment variables that have to be defined to allows the installation procedure to
configure in the proper way the Oracle database are listed.
ORACLE_HOME
DB_SIZE
ED
03
957.130.882 U
23 / 198
The following environment variables are used to configure properly HPOV during the 1354RM installation
procedure.
AGENT_REGISTRATION
Meaningful for IM configuration only.
It specifies if the agent LRF file static registration must be performed during the
1354RM installation phase. Its values can be yes (perform the static
registration default) or no (do not perform the static registration).
3.1.3.4 Operating System Variables
PRINTER
To enable the printer functionality in the RM help the Iview*printerConfig resource must be defined in
$XAPPLRESDIR/$LANG/Iview file. This resources is a semicolon separated list of comma separated
tuples giving printer network names.
a)
b)
c)
d)
TAPE_SERVER
X_CONSOLE
ED
snml
03
957.130.882 U
24 / 198
Shutdown the 1354RM system all user service manager instances (ovw, browser and mngAgent).
Since the 1354RM patch installation performs a reset of OVwDB, no maps will be present at
the end of installation. Its mandatory to save the maps to be kept using DNM application.
b)
Exit from normal user CDE space and login again as root user in CDE login form.
c)
Change current directory to the SNML installation root and extract install_patch file from 1354RM
patch package.
# cd <yoursnmlinstroot>
# gunzip d c <1354RM...your tar file gzipped> | tar xf ./etc/install_patch
d)
In case of more patches you must execute the install_patch script one time only at the end
(after the gunzip of all patches).
The procedure stops the control/system/database (IM only) and starts the install_patch on an
independent window, during this operation the files that have been corrected and that have been
included in the patch package will overwrite the old bugged ones.
e)
To activate all the CDE configuration changes it is recommended to exit from the current CDE session
execute a backup of the RM database and the AS database (only if you want to save the AS data)
execute the step of the chapter [8.1]
execute the following command
# mv /backup/snml/Ntwk/tablespaces.dat /tmp/tablespaces.dat
d)
ED
03
957.130.882 U
25 / 198
loc <n>
on RMIM workstation
on RMUS workstation
where <n> is the Network Domain Identifier and <hostname> is the name of the host where the
relevant RMIM is running.
N.B.
In order to enable the RM User Interface to connect to different Network Domain the user shall insert
manually in the ntwDomains file a file with the far format and execute the following commands:
# /usr/snml/etc/install_patch
and if AS is installed:
# /usr/snml/etc/us_config_A1330
The /etc/hosts file must contain the new added RMIM workstation address and the
AGENT_REGISTRATION environment variable, in /usr/snml/etc/env_snml file, must be set to yes.
When the MultiIM configuration is enabled, opening an empty map in NetView will present a dialog box
to the user in order to associate a Network Domain to the map (info taken into account when normal
operation are executed), on the other side opening the Browser application a MultiRM icon is presented
as root object and, with the Main related item operation, the user can view all the defined Network
Domains.
To have got access to the whole network domain, in a multimaster network configuration (i.e. 3 IM WSs
and 1 USM WS), it is necessary to do the following steps:
1)
2)
3)
ED
Add user1 on USM and IM_1 (assuming you are working on USM ws);
Add the USM ws console on all IM WSs by Add console function (working on each IM);
Add the user1 on IM_2 and IM_3 by Add Operator function (working on each IM).
03
957.130.882 U
26 / 198
4 HPOV DM CUSTOMIZATION
4.1 PMD Configuration
Meaningful for IM configuration only.
The adopted stack for the communication between RMUS and RMIM processes (RM F interface) is the
RFC 1006 (OTS light). With RM delivery is distributed a file pmd.lrf (in the directory /usr/snml/lrf/OV)
where HPOV CI configuration parameters are set by 1354RM. These parameters specify the size of
stacks or the timeout in seconds to wait for response to confirmed operations. This file is automatically
registered in place of the default pmd.lrf file by the customize and customize_patch procedures. If the
system administrator wants to change these values, he has to execute the following procedure with root
user privileges:
ED
03
957.130.882 U
27 / 198
WX host name must be removed manually from im_host_conf file, since no Event Forwarding
Discriminator shall be created on WX.
N.B.
In order to allow the interworking between HPUX 10.10 / HPOV 4.2 workstations and
HPUX 9.5 / HPOV 4.01 ones, the user have to modify manually the im_host_conf file
adding after the name of HPUX 9.5 workstations the tag DM40 (please, note that as
separator between hostnames and tag must be used one or more spaces, the <TAB>
character is not managed).
Please note that each time the user executes a customize, customize_patch, install_A1330 and
deinstall_A1330 procedures the im_host_conf file is automatically rebuilt, so the DM40 tags
are lost.
In directory /usr/snml/etc are present two procedures: addobj and delobj. These procedures have to be
executed with root user privileges and register (addobj) and deregister (delobj) all the 1354RM local
registration files.
ED
03
957.130.882 U
28 / 198
ED
1)
Queues : Five queues are used and their identification numbers are specified by
TOPMNGQUE (62), TRSMNGQUE (63), ALRMGRQUE (64), PMCONSISTQUE (65) and
QNNERQUE (90) symbols.
2)
03
957.130.882 U
29 / 198
ED
03
957.130.882 U
198
30 / 198
All rights reserved. Passing on and copying of this
document, use and communication of its contents
not permitted without written authorization from Alcatel.
6 USERS MANAGEMENT
6.1 1354RM Operators Managing
In the 1354RM customized CDE environment, a 1354RM subpanel is defined in the CDE panel from which
is possible to start 1354RM application (see 6.2.2).
To handle 1354RM operators data on US or IM node the system administrator must:
a)
b)
This procedure handle the users on all the workstation belonging to the 1354RM distributed architecture.
ED
03
957.130.882 U
31 / 198
Five user profiles are defined: OS Administrator, Administrator, Constructor, Path Builder & Look Only
Users. This profiles specify the operations that an operator can execute. In order to define the correct FADs
five environments have been defined specifying five versions for:
/usr/snml/conf/users/admin/OVwRegDir
/usr/snml/conf/users/Constructor/OVwRegDir
/usr/snml/conf/users/PathBuilder/OVwRegDir
/usr/snml/conf/users/LookOnly/OVwRegDir
The registration files for OS administrator, administrator and constructor enable the user to perform all
NetView operations (Network Construction, Save Map in DNM database, Create Virtual Entity, etc.).
The registration files for Path Builder enable the user to perform a limited subset of the NetView operations,
that is to synchronize map with existing data, to get distributed map from DNM database, starting event
logger or browser application.
The Look Only user registration files enable the user to perform get operations only.
In order to support NAD functionality in NetView application some constraints to its synchronization
process should be defined. The constraints are specified by means of a synchronization level that is given
as an input parameter to the NetView application. It is specified in the file nxnlOus of the relevant user in
the command line (by default all the profiles have no constraints defined):
Command Initial Restart Shared $NXNL_PRD/bin/nxnlOus syncroLevel 0
The system administrator can specify, if it is necessary, the synchronization level for a whole users profile
modifying the syncroLevel option value in the command line.
The synchronization levels that can be specified are:
0 : no restrictions applied;
ED
03
957.130.882 U
32 / 198
/usr/snml/conf/users/admin/dt/C/dtwmrc
/usr/snml/conf/users/Constructor/dt/C/dtwmrc
/usr/snml/conf/users/PathBuilder/dt/C/dtwmrc
/usr/snml/conf/users/LookOnly/dt/C/dtwmrc
From the vertical subpanel these users can start the TMNOSs, System Management Features, Alarm
List, Browser and NetView (ovw) applications. It is also available a customized popup menu (associated
to the right mouse button) that contains functions to start the same applications.
From the horizontal panel the OS administrator & administrator can get the UNIX access, open a File
Manager, start the Mailer and functions to print terminal hardcopy.
From the horizontal panel the Constructor & Look Only users can start the Mailer and functions to print
terminal hardcopy.
From the horizontal panel the Path Builder user can open a File Manager, start the Mailer and functions
to print terminal hardcopy.
The print terminal hardcopy functions use the standard PRINTER variable (that can be defined for all users
in .nxnlenv file) to determine the printer device to use, that must be able to print ASCII text and Hardcopy
postscript.
6.2.3 Unix Shell Profile (.profile)
Meaningful for IM configuration only
Five .profile template files are defined in the 1354RM installation that are used by the OperatorAdmin
procedure to customize the .profile for 1354RM users. These files are:
ED
/usr/snml/conf/users/OSadmin/profile
/usr/snml/conf/users/admin/profile
/usr/snml/conf/users/Constructor/profile
/usr/snml/conf/users/PathBuilder/profile
/usr/snml/conf/users/LookOnly/profile
03
957.130.882 U
33 / 198
The combination between a UNIX user and the workstation on which he is loggedin is identified in RM
by the initiators concept (see also X.741).
RM allows to define and modify the rights of each initiator to execute the functionality foreseen by his User
Profile (see 6.2) on group of network objects like group of paths, NAPs etc.
This definition implies that a UNIX operator can have different rights depending on the
workstation used.
A command allowed by the User Profile can be denied by the Access Rules either completely or
only on specific objects. The Users FAD is identified by the combination of the Users Profile
(see 6.2) and the access rule associated to his initiator (see 6.3.3.1).
The Access Rules are taken into account only by the Network Managemnent functions. SMFs
depends only by Users Profile.
UNIX USER
List of WS
RM INITIATOR
The Access Rules used to check the rigth of a given Initiator on Network Resources (e.g. paths, NAPs,
topologies...) are based on an attribute related to each single resource.
This attribute is called NAD. NAD may assume only single values (not set of values !).
1AA 00014 0004 (9007) A4 ALICE 04.10
The currently defined Access Rules allow to define initiators beloging to the following categories :
ED
administrators able to work on all the resources independently from their NAD
03
957.130.882 U
34 / 198
non VPN initiators able to see all the resources and to operate only on resources not related
to VPN operators. In this category is possible to define Network Constructor and / or Path
Builder Initiators.
VPN initiators able to operate on and to visualize only assigned resources (with possible
exceptions on free resources see 6.3.3.1). These initiators can normaly perform only path
configuration operations.
Look only initiators able only to see Network Resources and not to operate on them
ED
03
957.130.882 U
35 / 198
embedded rules;
customer rules (they are a redefinition of the embedded rules in terms of scheduling).
: Rules
: AC_R_PADMIN
: AC_R_PATHRO
In the example, the Initiator 50 is called Path Administrator and is mapped to the rule AC_R_PADMIN.
This access rule allows all the operations on paths (see 6.3.3.1).
In the Rules field more than one rule can be specified.
The rules are evaluated sequentially and in case of duplication or inconsistency only the first is
taken into account.
ED
03
957.130.882 U
36 / 198
RM INITIATOR
Id
Name
Customer Rules
List of Rules
Embedded Rules
AC_R_SNML: RM Administrator.
Its able to perform all the operations without any limit.
It must be assigned very carefully because an Initiator with this capability can modify
operations performed by 1354NN.
It is not usefull to compose this rule with any other one.
N.B.
ED
03
957.130.882 U
37 / 198
No check is performed to avoid the assignment of a VPN rule to non VPN Initiators and
viceversa.
AC_R_NN: NN Operator.
As VPN except that you can assign free objects too (path,trail,lc and NAP).
ED
03
957.130.882 U
38 / 198
Daily Scheduling: its the validity start & end time of the Rule. Starting and Ending Time has the
format hh.mmhh.mm (hh = hour, mm = minute) and shall be expressed in UTC (Greenwich Time).
An empty value enables the rule in the whole day.
Weekly Scheduling: it contains the days of the week for which the daily scheduling applies. Possible
values are in the range from 0 (Sunday) to 6 (Saturday). An empty value enables the rule in all the
days.
Embedded Rule: it is the name of the embedded rule referred in term of functionalities
: Embedded Rule
: AC_R_PADMIN
Customer rules can be inserted in the Initiator definition file (see 6.3.2).
6.3.3.3 Default mapping between Access Rules and Object Class
O:
OF :
N:
A:
All objects
Gray :
ED
03
957.130.882 U
39 / 198
P
A
T
H
allocate, deallocate,
ED
Notes
RULE
R
V
P
N
V
P
N
E
V
P
N
P
T
H
A
D
M
P
T
H
A
L
L
implement, deimple- O
ment, commission,
decommission, add/
remove protection.....
get
S
N
M
L
N
N
O
P
Create
Change Owner
O
F
Delete
P
T
H
R
/
O
T
O
P
P
A
Y
L
O
A
D
C
L
A
S
S
03
957.130.882 U
40 / 198
L
C
remove nap
O
F
get
O
F
change owner
O
F
O
F
Change owner
O
F
Use in path
O
F
O
F
O
F
get
Configure Payload
ED
03
957.130.882 U
41 / 198
T
R
A
I
L
Change owner
Configure Payload
Create
Remove
T
R
A
I
L
T
O
P
O
L.
/
P
H
C
O
N
N
Create
Implement
Deimplement
Remove
Get
Upload NAPs
Configure Payload
Get
M
S
S
P
R
I
N
G
O
F
ED
Operate on protection
blocks
Get
A
Operation are : modify the
WTR,
force,
manual,...synchronize
03
957.130.882 U
42 / 198
P
D
H
P
O
R
T
Configuration Download
Start Audit
Get
O
T
H
E
R
S
Get
Get
Operations
R
V
P
N
ED
Loop Back
Get
E
M
L
V
P
N
E
V
P
N
P
T
H
A
D
M
P
T
H
A
L
L
P
T
H
R
/
O
T
O
P
P
A
Y
L
O
A
D
S
N
M
L
Eventually restricted by
FAD at the user Interface
Restricted by FAD implemented at the user interface
N
N
O
P
03
957.130.882 U
43 / 198
New rules have been added to manage Performance Monitoring activities. They are described in the
following paragraphs.
PMSNML is the rule allowing full capability of managing PM domain objects. This rule allows to operate
on all the PM Domain data regardless from the ownership (NAD) of PM data, paths and trails
PMVPN is, in the PM domain, the equivalent of the VPN rule in the path management domain. This rule
allows to operate / visualize PM data, put under monitoring path or trail only related to a given NAD.
N.B.
If an operator is the owner of a measure then he is the owner of the pmTp and the pmTransport
of the measure.
AC_R_PMADMIN: Performance Monitoring Administrator
PMADMIN is, in the PM domain, the equivalent of the PADMIN rule in the path domain. This rule allows
to fully operate on PM domain related to non VPN measures, PM transport etc. and visualize all
the PM data even if belonging to VPN domains.
Non VPN domain is the set of all RM objects with nad<300.
PMREAD is the read only rule on PM domain. This rule allows to visualize all the PM related
information regardless to the ownership.
PMREAD is the read only rule on a given NAD. This rule allows to visualize the PM related information
related to a given NAD.
6.3.3.5 Default mapping between Access Rules for PM and Object Class
: All objects
Gray
ED
03
957.130.882 U
44 / 198
Operation
M
E
A
S
U
R
E
Notes
RULE
P
M
V
P
N
P
M
A
D
M
I
N
Create
Delete
Set
Correlate Tp to Measure
C
O
U
N
T
E
R
Create
Delete
Set
R
E
P
O
R
T
Get
ED
P
M
V
P
N
R
O
Get
P
M
R
O
P
M
S
N
M
L
03
957.130.882 U
45 / 198
T
C
A
Create
Delete
P
r
o
f
i
l
e
Set
T
C
R
Create
Delete
Set
Create
Delete
Create
Delete
P
A
T
H
N
A
P
Correlate Tp to Measure
Get
Get
P
M
T
R
A
N
S
P
M
T
P
Get
Get
ED
A
The check is performed on the
pmTp too.
A
This command is not present at the
user interface. It is a consequence
of the Correlation of a Tp to a Measure
A
See the note about this action in the
TCA class context.
03
957.130.882 U
46 / 198
T
R
A
I
L
Correlate Transport to Measure
O
N
A
C
T
P
/
T
T
P
Correlate Tp to Measure
OF
N
A
ED
03
957.130.882 U
198
47 / 198
A set of Initiators is provided with 1354RM delivery. They represent the most typical operator profiles for
the network management.
Initiator Name
Rules
Description
Free Pool
No Rules
RM Administrator
SNML
Advanced Operator
PAYLOAD
PTHADM
Network Constructor
TOP
PTHADM
PAYLOAD
Path Watcher
PTHR/O
Path Administrator
PTHADM
Path Allocator
PTHALL
1354 NN
VPN
Qnn Agent.
RVPN Operator
RVPN
VPN Operator
VPN
EVPN Operators
EVPN
Payload Manager
PAYLOAD
cnm_pathbuilder
VPN
PMVPN
cnm_lookonly
PMVPNR/O
The correspondence between User Profiles and Default Initiators is described in the following table.
User Interface Profile
Default Initiators
OS Administrator
RM Administrator
Administrator
Constructor
Network Constructor
Path builder
Path allocator
Path Allocator
Look Only
cnm_pb
cnm_pathbuilder
cnm_lo
cnm_lookonly
ED
03
957.130.882 U
48 / 198
b)
N.B.
The startup operation starts only the agents belonging to the currently set run level.
c)
d)
e)
f)
g)
ED
03
957.130.882 U
49 / 198
Other Alcatel network applications can enable 1354RM PMC to start and to control their own Agents. To
do this a file named mng_agent_conf must be placed on the installation home directories of the involved
applications in which they have to specify the characteristics of their agents. In particular in this file must
be specified the agent parameters, if the process has child processes (and if it has, their names), where
is placed the Agent trace file, etc..
When a mng_agent_conf is modified or a new one is delivered, in order to notify to PMC the modifications
the script procedure:
# /usr/snml/etc/update_network
have to be executed (as root user) to regenerate the PMC configuration file (see also 9.1).
For each process the following parameters have to be defined:
ED
03
957.130.882 U
50 / 198
The relation between Action and command to be executed is done by means of the ordering
number.
Inside Action command scripts the following environment variables can be used:
$AGENT_PID
to indicate the actual agent process PID;
$AGENT_NAME
to specify the agent name.
N.B.
ED
03
957.130.882 U
51 / 198
ED
03
957.130.882 U
198
52 / 198
All rights reserved. Passing on and copying of this
document, use and communication of its contents
not permitted without written authorization from Alcatel.
8 DATABASE MANAGEMENT
8.1 Database Creation
Meaningful for IM configuration only
In order to create a new database the following procedure shall be executed:
$ $DB_ROOT/etc/create_db
After the database recreation you can perform a restore of network configuration, alarms and PM data
from a backup (if any).
ED
03
957.130.882 U
53 / 198
The script must be run as snml administrator by running from a shell the command:
$ db_report
The script sends a mail containing the report to the snml administrator. The same report is also saved in
file /tmp/mailfile.out. Here follows an excerpt of such a report:
To: snml
FILESYSTEM PARTITIONING on tlvhfs
==============================================
Filesystem
kbytes
used
/dev/dsk/c0t6d0
1851289
935444
730716
/dev/dsk/c0t5d0
2049173 1451593
392662
79% /tmp_mnt/dktmn_21
used:
free:
file_name
tablespace_name
bytes
used
free
%free
data01.dbf
DATA
73400320
49414144
23986176 32.6785714
index01.dbf
INDEX_T
41943040
5183488
36759552 87.6416016
index02.dbf
INDEX_T
41943040
1114112
40828928
rbs01.dbf
RBS
8388608
7948288
system01.dbf
SYSTEM
15728640
8220672
temp01.dbf
TEMP
10485760
2048
97.34375
440320 5.24902344
7507968
47.734375
10483712 99.9804688
owner
table_segment
size
extents
SNML
AG
532480
SNML
CAP
266240
1054720
...
1AA 00014 0004 (9007) A4 ALICE 04.10
SNML
ED
TRANS
03
957.130.882 U
54 / 198
It is advisable to run periodically the script db_report, to check the use of disk space made by Oracle.
tables_tot_size (bytes)
27447296
STORAGE ALLOCATED FOR INDEX SEGMENTS STORED WITH DATA
LEGENDA
size:
owner
index_segment
size
extents
SNML
COUNT_INDEX
15308800
SNML
PMLDST_INDEX
266240
UNIQUE_TRAIL_USERLABEL
266240
...
SNML
21964800
STORAGE ALLOCATED FOR INDEX SEGMENTS STORED SEPARATELY
LEGENDA
size:
owner
index_segment
size
extents
SNML
CAP_IDX1_INDEX
1054720
SNML
CTP_IDX2_INDEX
1054720
51200
...
SNML
PK_TRANPK_TRANCONNID
6293504
STATISTICS FOR SCHEMA OBJECTS/1
LEGENDA
num_rows:
avg_row_len:
blocks:
table
num_rows avg_row_len
blocks empty_blocks
avg_space
AG
CAP
259
52
56
127
442
843
14
10
504
632
...
TRANS
ED
03
957.130.882 U
55 / 198
values:
size:
blocks:
values
size
values
size
blocks
CAP_IDX1_INDEX
COUNT_INDEX
52
1271
515
366968
7115386
7475
205
5571
...
UNIQUE_TRAIL_USERLABEL
130
It is also advisable to run periodically the script db_memory, to check the use of RAM memory made by
Oracle.
The script must be run as snml administrator by running from a shell the command:
$ db_memory
The script sends a mail containing the report to the snml administrator. The same report is also saved in
file /tmp/db_memory.out. Here follows an excerpt of such a report:
From snmlr50 Fri Nov
To: snml
Analysis of database memory bound to Oracle instance dbhhk started from tlvhhk
1 SYSTEM GLOBAL AREA
Total System Global Area
12785888 bytes
Fixed Size
47936 bytes
Variable Size
10157472 bytes
Database Buffers
2252800 bytes
Redo Buffers
327680 bytes
1.1 SHARED POOL AREA
%Reparses
698191
ED
7678 1.09968648
03
957.130.882 U
56 / 198
LEGENDA
352576 bytes
51926
1.67527004
273088
3116137
227425
redo allocation
redo copy
535426
11
ED
03
957.130.882 U
57 / 198
osuser
PID
machine
program
user
SYS
oracle72 9418
tlvhhk
oracle@tlvhhk (PMON)
SYS
oracle72 9419
tlvhhk
oracle@tlvhhk (DBWR)
SYS
oracle72 9420
tlvhhk
oracle@tlvhhk (LGWR)
SYS
oracle72 9421
tlvhhk
oracle@tlvhhk (SMON)
oracle@tlvhhk (RECO)
SYS
oracle72 9422
tlvhhk
SNML5
SNML5
snmlr50
6292
tlvhhk
SNML5
SNML5
snmlr50
6974
tlvhhk
SNML5
SNML5
snmlr50
7201
tlvhiu
SNML5
SNML5
snmlr50
6440
tlvhhk
SYSTEM
SYSTEM
snmlr50
7526
tlvhhk
SNML5
SNML5
snmlr50
6928
tlvhhk
SNML5
SNML5
snmlr50
6449
tlvhhk
SNML5
SNML5
snmlr50
6282
tlvhhk
SNML5
SNML5
snmlr50
6443
tlvhhk
SNML5
SNML5
snmlr50
6446
tlvhhk
SNML5
SNML5
snmlr50
6397
tlvhhk
SNML5
SNML5
snmlr50
6439
tlvhhk
SNML5
SNML5
snmlr50
6441
tlvhhk
SNML5
SNML5
snmlr50
6243
tlvhhk
SNML5
SNML5
snmlr50
6605
tlvhhk
SNML5
SNML5
snmlr50
6613
tlvhhk
2589040 bytes
Max stacks for all sessions
2589040 bytes
2.2 USER SESSIONS AREA INTO SGA
LEGENDA
Total user memory: memory currently allocated to all user sessions
Max user mem: max memory allocated (not at the same time!) to all sessions
Total user memory
351284 bytes
Max user memory
696004 bytes
ED
03
957.130.882 U
58 / 198
GETS
WAITS
hits
SYSTEM
4101
LARGE_RBS
7832
100
100
R01
7824
100
R02
7932
100
R03
7794
100
R04
7780
100
The administrator must check that for each tablespace there is at least a data file with over than 30% free
space. If not so, the administrator must consider for that tablespace the database extension procedure
described in the next paraghraph.
The administrator must also check that for each table or index segment, the associated number of extents
doesnt exceed 10 otherwise he must consider the full backup and restore procedure described in
paragraph [8.4].
ED
03
957.130.882 U
59 / 198
Oracle uses preallocated and not extendible tablespaces, so it could happen some RM functions fails
and in trace files could be found messages as the following:
Message: ORA01653: unable to extend table SNML. TP by 512 in tablespace DATA
N.B.
TP is the name of table where the error arises, messages with different table name
can be found.
To solve this problem the tablespace must be extended using the following procedure (its no necessary
to shutdown RM system and databases):
$ export ORACLE_SID=dbsnml
$ $ORACLE_HOME/bin/sqlplus system/manager
SQL> select * from dba_data_files;
FILE_NAME
FILE_ID TABLESPACE_NAME
BYTES
BLOCKS STATUS
/usr/snml/databases/dbsnml/data/system01.dbf
1 SYSTEM
15728640
7680 AVAILABLE
/usr/snml/databases/dbsnml/data/rbs01.dbf
2 RBS
15728640
7680 AVAILABLE
/usr/snml/databases/dbsnml/data/temp01.dbf
3 TEMP
10485760
5120 AVAILABLE
FILE_NAME
FILE_ID TABLESPACE_NAME
BYTES
BLOCKS STATUS
/usr/snml/databases/dbsnml/data/data01.dbf
4 DATA
31457280
15360 AVAILABLE
/usr/snml/databases/dbsnml/data/index01.dbf
5 INDEX_T
10485760
5120 AVAILABLE
Finally it is necessary to enable the write right for the group of the new file (the command shall be execute
as root Unix user):
# chmod g+w /usr/snml/databases/dbsnml/data/data02.dbf
N.B.
In the previous sqlplus session a new datafile for the tablespace data is created
(/usr/snml/databases/dbsnml/data/data02.dbf). It is recommended to create new datafile
with the same size of the previous ones.
ED
03
957.130.882 U
60 / 198
Network configuration data (and HPOV maps saved into DNM repository);
Alarm data;
PM data;
OS data: Operating System configuration data (i.e. /etc/hosts) Third party software (HPOV ORS
DB) Application configuration data (i.e. us_nodes, im_host_conf);
Operator data.
N.B.
The previous data types could be saved all together or in separate way selecting the relevant
data on user interface.
The first three subsystems backup/restore procedure are based on the Oracle import/export features, so
only table data are saved and not the table structure. This imply to recreate the Oracle DB (see 8.1) before
restoring them.
The Figure 2. illustrates the information distributed in the two disks.
EXTERNAL DISK
APPLICATION / OP. SYS.
INTERNAL DISK
BACKUP / MIRROR
Operating System
/backup
Base Software
archives files
( /mirror/arch )
Application SW ( RM )
Oracle DB
redologs & control
reference base
( /mirror/db_ref_base )
redologs & control
( /mirror/mirror )
ED
03
957.130.882 U
61 / 198
a)
For each installed EML the relevant NR3 directory should be created:
$ mkdir p /backup/1353<sys>_<nn>
where <sys> is SH or WX according to the managed EML and <nn> is the logical
number of the EML (EML Domain Id). The EML name (1353<sys>_<nn>) could
be found in the file /usr/snml/conf/conf_network.
b)
c)
During the backup the RM system is switched in read only run level, so its guaranteed the saved data
integrity.
The network backup function is available both as a periodical action and on user request via user interface.
The files originated by a backup are stored onto a disk (other than the one in which resides the Oracle
database) and optionally on a tape (see Figure 2. ).
Different backups are stored on an unique tape.
ED
03
957.130.882 U
62 / 198
Prior to execute the backup / restore feature for NR2 EMLs (SH and WX) it is necessary to
execute the following manual workaround procedure:
b)
c)
d)
To realign the DB, copy the redo log file in the users home directory (i.e. /users/snml) creating a new
file with .rmCmd extension and empty the current redo log file, using the following commands :
$ cp $NLredolog <user_home_dir>/<filename>.rmCmd
$ >$NLredolog
Perform the Upload NAPs operation. The uploaded NAP are not traced in the redo log file, but path
operations executed by the rmBatchUtil procedure refer them by means of their userlabel. This is the
reason why the Upload NAPs can be executed manually after the restore.
Set to False the global configuration of the ETs involved in payload configuration operations.
Payload configuration is rebuilt by creating and configuring / reconfiguring HOtrails. HOTrails
in a ring can only be created if the global configuration is set to False.
Start the batch procedure opening the CDE file manager from the CDE panel and selecting from
popup menu of the saved file the Executebatch command. Please note that the output of the
batch procedure will be redirected to a file (which name is <filename>.rmCmd.log) in order to be able
to analyze the results at the end of the execution.
During the execution, the performed operations print on the terminal their results. The results of
the batch execution may depend from external conditions (timeouts, concurrences...) so, may
happen that a small number of operations in a large batch file can fail when repeated. This can
be recovered taking into account that the output file of rmBatchUtil reports either the commands
and the results. Failed commands may be saved in an other file and executed later. Pay
attention in case of failure on allocation, add protection or remove protection, that also previous
constraints definition must be rerun together with the failed commands.
e)
Set to True the global configuration of the ETs at point c ). The correct values for the configuration
of the ET will be automatically recalculated.
Please note that the previous procedure should be used in case of global Network data restore
(RM plus all the EMLs). In case of partial RM restore the results of the execution of redo log file,
could be unpredictable.
ED
03
957.130.882 U
63 / 198
In the following its described the procedure needed to defrag the primary keys identifiers of RM database
tables.
After the procedure execution, the primary key column value of every table will be in the range 1..n, where
n equals the number of rows of the table. All foreign keys will be updated accordingly.
Note: only sensitive tables (TP and TRANPK among the others) will be updated.
8.6.1 Procedure steps
f)
g)
Stop 1354RM system if necessary (but not the database, which has to be on) using Process Control
facility.
h)
i)
j)
k)
l)
Then, the procedure asks the operator for confirmation (message Do you want to continue ?).
If the variable $NXNL_DATABASE is correctly set, the operator must enter y, otherwise the operator
can enter n (feel free to press <CtrlC> if you like) , (re)set the uncorrect environment variable, and
restarts ./idDefrag. No operation on database is performed until you enter y.
If any errors occur the procedure stops.
Check the logfile idDefrag.log (which is created in the current directory) to diagnose the error.
ED
03
957.130.882 U
64 / 198
N.B.
If any error occurs during execution of ./idDefrag (after your y confirmation) the
database is left in an unconsistent state.
After fixing the problem, you have to perform a RM database full restore and then
repeat this whole sequence of operations (i.e. starting from point b)).
*** Its not enough to restart the shell script ./idDefrag ***.
The same situation arises if ./idDefrag is interrupted (after your y confirmation),
whatever the reason (included user <ctrlc> request).
Every time the procedure is executed, the previous log file is automatically saved as idDefrag.log.old.
m ) Drop large_rbs rollback segment.
To drop, perform:
$ORACLE_HOME/sqlplus system/manager @drop_large_rbs.sql
n)
o)
Perform a Network Discovery operation on NN system, for the Network(s) managed by the RM
whose database you have modified.
This is necessary to align NN database with the modified RM one.
Alternatively, you may shut down and restart the whole NN system, since NN system automatically
realign itself with RM at restart.
b)
c)
d)
N.B. Only a subset of all primary keys (that is, the ones which may overflow above 2,000,000,000) are
defragmented by this procedure. Currently (19 December 1997) they are:
TP.tpId
TRANPK.tranconnId
PMTROP.pmTranOpId
PMREOP.pmReportOpid
Other primary keys will be added if necessary.
ED
03
957.130.882 U
65 / 198
The Oracle startup parameter shared_pool_size must be set to 64 M. The procedure is as follows:
a)
b)
c)
d)
e)
f)
Every time that the customize procedure has been done this procedure must be reexecuted.
As workaround, indexes have to be dropped and created again. The SQL script
/usr/snml/databases/utility/manageIndexes.sql
is done to do that. It is possible to run it by executing the following command (by snml):
$manageIndexes
It is suggested to execute this script periodically after the backup.
ED
03
957.130.882 U
66 / 198
c)
d)
e)
f)
g)
h)
ED
it should be an absolute path name of a file executable and readable by each user;
if not differently specified (see paragraph 9.1.1), the procedure returns:
03
957.130.882 U
67 / 198
SYSTEM parameters
sys_name : <name>
mandatory.
it is the product system name that is used by the system features; ex. 1354NN, 1354RM,
1353SH1, ..., 1353SHn. It must be unique among systems which are part of the same TMN
network.
sys_stop_comm : <stopprocname>
mandatory.
this is the procedure that stops the system.
sys_check_control : <checkprocessesautostartprocname>
mandatory.
this procedure allows to check the processes autostart status: the procedure returns 0
(autostart ON), or 1 (autostart OFF).
sys_print_control : <printprocname>.
this is a customized procedure to execute print actions requested by an operator using SMF
application functions. If the command is given, it is the same for all the functions which provide
the possibility to print.
SUBSYSTEM parameters
subsys_name : <name>
mandatory.
It is the subsystem name (e.g. 1354RM, 1354NN, node name of 1353SH workstation ...). It must
be unique among subsystems which are part of the same TMN network.
subsys_start_comm : <startprocname>
mandatory.
this is the procedure that starts the subsystem.
subsys_stop_comm : <stopprocname>
mandatory.
this is the procedure that stops the subsystem.
ED
03
957.130.882 U
68 / 198
In the following the needed smf_conf labels and related commands are described:
SUBSYSTEM backup/restore
Five different backup/restore data types are supported:
network configuration data (identified by Ntwk acronym)
performance monitoring data (identified by PM acronym)
operator data (identified by Op acronym)
alarm data (identified by Al acronym)
TMN OS configuration data (identified by OS acronym)
For each data type subsystem backup, rollback and restore procedure are identified according to the
following:
end_subsys
to generate new system management features configuration according to the smf_conf file description.
The same script must be used even to generate new configuration file for PMC application (see also 7.2).
The update_network procedure must be executed both from IM and US hosts in the given order.
ED
03
957.130.882 U
69 / 198
Using the Periodic Action function defined inside the SMF application in 1354RM subpanel, is possible
to book specific action to be executed periodically.
1)
2)
Network Backup: it allows to start periodically the backup function in order to save the network
configuration data.
Save and Clean Log&Trace files: it enables a periodical cleaning of the agents trace files to
avoid that they can grow until they fill the file system. The current trace file is saved into a backup
(.bak) copy and than it is emptied. It is recommended to enable this periodic function.
In the file $NXNL_PRD/conf/traceFileSize.par must be specified the maximum size (disk blocks
number) that the trace file can reach (default MAXTRACESIZE=1000 disk blocks).
Clean DB archives: it enables a periodical cleaning of the oracle archived redo log files. It would
be mandatory to enable this function if the Incremental DB archive backup is not used.
Incremental DB Archive Backup: it allows to specify the execution frequency of the incremental
backup.
Save and Clean Events Log: it enables a periodical archive of the Events Log.
Archive System Messages: it defines the frequency of the check on the size of the Archive
System Message files. If the current size is greater than 3000 lines the current files is saved in
a backup copy and a new empty one is created. The function mantains a pool of the last 10
archived files.
2)
3)
4)
5)
6)
N.B.
During the installation phase the Save and Clean Log&Trace files and the Clean DB
archives (this one only when the installation is done with the parameter MIB different
by REC) functions are enabled with a frequency of 15 minutes.
Show scheduled time : it displays, if it is defined, the current booking time of the related
operation.
Set scheduled time : it allows to the administrator to insert, or to change, the scheduling time
of the related operation.
Cancel scheduled time : it removes the previous inserted booking time for the related operation.
2)
3)
N.B.
ED
03
957.130.882 U
70 / 198
10 1354RM BEHAVIOR
10.1 EMLs management
10.1.1 Procedures to define EMLs managing Q3 NEs
Meaningful for IM configuration only
EMLs that are managed by 1354RM can be created/deleted online in RM database using the following
commands:
# /usr/snml/bin/AddEML <EML_id>
# /usr/snml/bin/RemEML <EML_id>
These procedures register/deregister the EMLs into HP/OV and add/remove the management records to
the PMC.
10.1.2 Procedures to create EMLs managing QB3* NEs
Meaningful for IM configuration only
EMLs that are managed by 1354RM can be created in RM database using the following command:
N.B.
Identifier parameter will be requested explicitly by the procedure if it is not indicated. The EML
identifier must not be reserved by 1354RM (see next paragraph). The creation of a virtual EML
doesnt require the f option.
EMLs are created with dummy userlabel with the format EML_<id>, that will be replaced by the real
EMLs userlabel during the EMLNML alignment process (see 11.3).
Using the h option, as indicated below, the command prints on the screen its syntax:
N.B.
$ nlCreateInDb h
You can find the fdn for the eml you want to delete by going into the network view, upload available EMLs
and select the EML which should be deleted. After that execute View>Object Attributes>Long Report.
For the selection Name attribute you find the string you have to give as fdn parameter.
ED
03
957.130.882 U
71 / 198
When a path allocation is asked from the User Interface, a first consistency analysis is performed and the
result is reported to the user. If the allocation activity does not succeed, the path working state attribute
is set to Failed to Allocate and using the event logger (from the event log file) the error code (and the
related message) can be retrieved.
The possible error codes are :
a)
5)
if the allocation of unprotected path/trail fails, check if one or more of the previously described
cases occur;
if nothing is discovered after this check, put constraints on the path/trail, in order to force the
desired route;
b)
Not found east and west CTPs with same payload position in protected connections (NE
constraint);
In a protected path/trail, the routing algorithm has found both main and spare routes, but there are
no main and spare idle CTPs in a protected connections with the same payload position and this is
not compliant with some NEs (all ADMs);
Suggestion for analyzing the problem:
unprotect the path/trail and allocate in order to have more information on the main route, then
put constraints on the path/trail, in order to force a route different from the minimum cost one;
c)
unprotect the path/trail and allocate in order to have more information on the main route, then
put constraints on the path/trail, in order to force another route
d)
The spare route completely overlaps the main route (only path/trail allocation);
The routing algorithm has found only 1 possible route (main) between origin and destination; the
reasons why the spare route has not been found can be that one or more of conditions described
in a ) occur;
Suggestion for analyzing the problem:
unprotect the path/trail and allocate in order to have more information on the main route, then
check if one or more of conditions described in a ) occur;
ED
03
957.130.882 U
72 / 198
e)
Protecting this route wouldnt improve the protection level (only path/trail add protection);
The routing algorithm has not found the spare route between origin and destination; the reasons can
be that one or more of conditions described in a ) occur;
f)
Not enough resources in the network only a subset of sink NAPs is reachable;
In a broadcast path, the routing algorithm has found the route for some legs but not for all; the reasons
why the routes for the other legs have not been found can be one or more of conditions described
in a ) occur;
g)
remove or change the constraint, or check the state of the link connection;
h)
Incompatible constraints;
More constraints on the path/trail have been inserted, but some of them are incompatible.
Suggestion for analyzing the problem:
i)
Incompatible CTPs;
It happens during an HO trail allocation defined starting from two CTPs if the user adds a constraint
on a link connection not compatible with one of two CTPs.
Suggestion for analyzing the problem:
j)
....
ED
03
957.130.882 U
73 / 198
To improve the customization flexibility of the mail message text, can be used four environment variables
that are initialized with the proper values each time :
map_action :
map_name :
map_comment :
map_subject :
ED
03
957.130.882 U
74 / 198
This feature is not supported to the customer: it has been introduced for debug purpose only.
The trace levels and trace group numbers that must be indicated to analyze SNML applications are listed
in the README.trace file, presents in the $NXNL_PRD/bin directory.
10.4.1 User Interface applications
To enable the trace utility for User Interface applications, the user has to define two environment variables
in a normal Unix window, and then start manually the User Interface application. The two environment
variables are :
2)
3)
The trace outputs are on a file named <agent_name>.trc placed in the directory
$NXNL_PRD/trace/<agent_name>.trcDir/
N.B.
ED
Trace for children agents (i.e. pathImp) are placed in the directory of the parent
process (in this case trsMngAgent).
03
957.130.882 U
75 / 198
Hereafter are listed two alignment procedure between 1354RM and 1353WX to recover from transmux
ports configuration misalignment that can be produced after either a 1353WX or 1354RM restore (e.g.
restoring on WX a backup where a port is configured at 64 x 2Mb, but on RM it is configured as a single
140Mb port).
ED
03
957.130.882 U
76 / 198
perform a restore of the network (if WX MIB is corrupted, delete the WX persistency, if not and
it seems that RM and WX have the same content, keep the WX persistency);
2)
perform the synchronization of the WX EML domain (synchronize the physical ports);
3)
b)
if the synchronization result of the EML is misaligned means that WX and RM have
different physical ports configuration, so it is necessary to check if in WX MIB the
misaligned ports have some connections (this case cannot be handeled by RM):
1)
start the Consistency Procedure (either global or on connections only). At the end
RM should have deleted all not foreseen connections (also the ones supported by
140Mb or 34 Mb not aligned ports);
2)
start (again) the Consistency Procedure (either global or on ports only). At the end
RM should have deassigned all the not aligned ports. It is so possible to jump to next
point without deleting the WX persistency;
3)
then the synchronisation of the EML will be misaligned (and the operator can be sure
that WX has no connection on that unkown port from RM);
4)
find the just created 140Mb port (it should be in the observed Assignment State);
5)
perform the Configure PDH port action on such 140Mb port, so on WX side:
the 64 * 2Mb ports are created (NMLobserved, with same FDNs as RM ones);
if the synchronization of the EML is aligned (WX and RM has any different physical ports),
the normal Consistency Procedure can be performed by the operator (see next bullet 4);
4)
5)
6)
7)
8)
make on the WX node a Configure StartAudit (it checks that WX content and 1641SX content
are aligned);
9)
ED
03
957.130.882 U
77 / 198
This is a special case, because RM has the 140Mb (34Mb) port which is assigned and the WX not. The
1641SX has a structured 140Mb (34Mb) port and it could have also connections on it. The RM cannot
remove the NAP related to this 140Mb (34Mb) port because WX has not this NAP and RM cannot manage
a crossconnection on a TTP which is only seen by the WX. To align this situation it shoul be made
manually by RM:
1)
2)
perform the synchronization of the EML domain (synchronize the physical ports);
3)
if the synchronization result of the EML is misaligned, recognize which 140Mb (34Mb) ports
are misaligned. It means that WX and RM have different physical ports configuration, so it is
necessary to check if in WX MIB the misaligned ports have some connections (this case cannot
be handeled by RM). In this case delete WX persistency, start WX again (on AU) and perform
a synchronisation of the EML;
4)
5)
6)
7)
8)
9)
make on the WX node a Configure StartAudit (it checks that WX content and 1641SX content
are aligned);
ED
03
957.130.882 U
78 / 198
11 1354RM CUSTOMIZATION
11.1 Environment variables changes
In the following paragraphs are described some customizations possible in RM. Hereafter is described
the standard way to change and to take effect them, and it should be applied if some variables are
changed. For nonstandard variables the change procedure is described directly in the relevant
paragraph.
In the following paragraphs for the standard managed variables the following data are listed:
Relevant Process
(Father Process, if necessary)
Variable Name (with default value)
The relevant process is the one to be restarted to activate the variable value. If it is followed by another
name in brackets, it means that it is a child process and its father shall be restarted to activate the variable
value.
Standard way of changing variables is:
a)
b)
c)
After this you need to shutdown and startup the Relevant Agent (or its father).
ED
03
957.130.882 U
79 / 198
Relevant Process:
Variable Name:
browser
NXNL_COUNTERTIME (unset)
This variable defines the rate on which the browser has to refresh its item counters when the operator has
performed a get or an inventory and the agents are sending the related replies. The possible values are:
11.2.2 Browser
Meaningful for US configuration only.
Relevant Process:
Variable Name:
browser
NXNL_MAX_NUM_ITEMS (unset)
NXNL_MAX_NUM_ITEMS_INWIN (unset)
NXNL_MAX_WINS (unset)
These three variables are related to the maximum number of objects displayable in the browser
(NXNL_MAX_NUM_ITEMS), the maximum number of objects displayable into a single window of browser
(NXNL_MAX_NUM_ITEMS_INWIN) and the maximum number of windows opened at the same time
(NXNL_MAX_WINS). When these thresholds are exceeded a warning box is displayed.
N.B.
If the environment variables are not set (or set with value 0) no checks are done about number
of objects displayed in the browser.
Relevant Process:
Variable Name:
emlObjAgent
NLhbp (180)
This variable enables the polling mechanism toward EMLs. Its value indicates the timeout (in seconds
between two different polling activity.
N.B.
ED
If the environment variable is not set (or set with value 0) the EML data alignment polling activity
is disabled.
03
957.130.882 U
80 / 198
Relevant Process:
Variable Name:
topBrwAgent
NXNL_INVPROCESS (1,2,100,2)
This variable configures the number of processes dedicated to inventory actions (e.g. path list, physical
connection structure, ...) and must be set in nxnlenv_make file before to start the customize_patch
procedure.
By default the heavy inventory starts on instance NXNL_NTWBRRDA=1 or 2 (in random way) and the
light inventory starts on instance NXNL_NTWBRRDA=100 or 101 (in random way) and there are two
processes dedicated to heavy inventory and two processes dedicated to light one.
E.g. NXNL_INVPROCESS=1,4,100,4 means that the heavy inventory can start on object instance
$NXNL_NTWBRRDA=1 or 2 or 3 or 4 (random) and the light inventory can start on
$NXNL_NTWBRRDA=100 or 101 or 102 or 103.,
Its clear that by default four lrf files are created in lrf directory; in the example eight lrf files are created in
lrf directory.
Variable Name:
NXNL_MAPNAMERULE (unset)
The users having the Look Only ot he Path Builder profiles have now the capability to perform the highlight
of a path on the Map. This is possible also if they do not have the right to write on a map, because a
temporary map is atomatically created (and deleted) by the system.
To enable this feature you must set the variable, before executing the customize_patch procedure,
specifying the naming rule (if exist, otherwise this feature can not work) used to identify the default map,
e.g. NXNL_MAPNAMERULE = *_PTTNAME then execute the customize_patch and the command by
snml user: echo enable > /usr/snml/conf/CopyMap.
ED
03
957.130.882 U
81 / 198
Relevant Process:
Variable Name:
N.B.
pathAll (trsMngAgent)
K2 (2)
K34 (1)
K140 (1)
K2, K34 & K140 variables can assume integer values only.
During the allocation phase, the cost of a given routing link is dynamically evaluated with the following
formula :
Cost = C ( 1 + K / F )
Where :
C:
F:
K:
cost of the routing link without taking into account any usage factor
number of free linkconnections in the routing link
Parameter allowing the tuning of the sensibility of the cost to the loading of the
routing link
The three variables are taken into account by the allocation of different path types: K2 (2Mbits paths), K34
(34Mbits & 45Mbits paths), K140 (140Mbits paths).
11.6.2 Reuse already allocated resources in Broadcast paths.
Meaningful for IM configuration only.
Relevant Process:
Variable Name:
pathAll (trsMngAgent)
SAME_RES_TYPE (20)
DIFF_RES_TYPE (40)
By means of these variables is reduced the cost of routing link already allocated by the relevant broadcast
path, in order to force the allocation algorithm to reuse as much as possible the resources. The cost
calculated in the previous paragraph is multiplied by SAME_RES_TYPE/100 (default 20%) if the path
already use the routing link in the same route type as the allocating one (both main or both spare),
otherwise it is multiplied by DIFF_RES_TYPE/100 (default 40%).
ED
03
957.130.882 U
82 / 198
Relevant Process:
Variable Name:
pathAll (trsMngAgent)
DISABLEVIRTUALCTPTOCTP (not defined by default)
By means of this variable it is possible to enable or disable the crossing of Virtual Nodes during the Path
Allocation phase. If the environment variable DISABLEVIRTUALCTPTOCTP is defined and has a value
different by 0 the Virtual Nodes are taken into account during the Implementation phase only if the path
terminates on them (no passtrough can be defined on virtual nodes). If the variable is not defined or
defined with value equal to 0 all virtual nodes are taken into account as normal nodes during the allocation
phase.
N.B.
Relevant Process:
Variable Name:
pathAll (trsMngAgent)
DROPCONTSWITCHCONF (0)
By means of this variable it is possible to set the nominal position of the switches in Drop&Continue
connections in a spare route of the path or trail.
If the variable is set to 0 (or not defined) the main side of the switches is turned to the main route of the
path, if it is set to 1 the main side of the switches is turned to the spare route of the path.
11.6.5 Changing timeout for Cross Connection management actions
Meaningful for IM configuration only.
Relevant Process:
Variable Name:
pathImp (trsMngAgent)
NLtimeoutBase (300)
NLtimeoutReq (30)
By means of this variable it is possible to change the timeout for cross connection management actions
(create, delete, update squelching and so on), with the exception of HO CTPHO CAP creation/deletion
which are handled differently and by a different process.
The timeout for every request is set via this formula:
timeout = NLtimeoutBase + n * NLtimeoutReq
where n is the number of requests sent to NEs but not answered yet.
N.B.
ED
03
957.130.882 U
83 / 198
Relevant Process:
Variable Name:
consChkAge
IMP_FLOWCONTROL_MAX_OUTSTANDING (15)
By means of this variable you can set the maximum number of create/delete/update_squelching
messages concurrently sent to NEs during consistency download. If the number of sent messages equals
the threshold specified by this variable, the consistency process will wait until a message is answered
before sending another one.
N.B.
This simple mechanism of flow control overcomes internal message queues overflow in OSes
(like WX) which dont use HO OpenView CI builtin flow control feature.
Relevant Process:
Variable Name:
emlAlrMng
HP_TOthreshold (60)
HP_almthreshold (150)
LP_TOthreshold (60)
LP_almthreshold (100)
These variables are related to high priority (HP_TOthreshold, HP_almthreshold) and low priority
(LP_TOthreshold, LP_almthreshold) alarms, they are used to implement a flooding protection
mechanism.
When RM receives more than HP_almthreshold high priority alarms in HP_TOthreshold time (sec) it stops
to analyze them (no propagation is done) and emits a High Priority Alarm Flooding alarm for the relevant
EML. It doesnt analyze alarms until a HP_TOthreshold period terminates with an alarm rate lower than
HP_almthreshold. The same mechanism is implemented for low priority alarms with the Low Priority
Alarm Flooding issuing.
The alarm synchronization isnt automatically performed but its up to the operator to require it.
11.7.2 Alarm clearing hysteresis period
Meaningful for IM configuration only.
Relevant Process:
Variable Name:
pathAlrMng (emlAlrMng)
NLdeltatime (5)
This variable set a hysteresis period on clearemission time of an alarm. It means that when an alarm is
cleared the RM process wait NLdeltatime seconds before starting the propagation phase, if the same
alarm raise up again (same object with same probable cause) in this period the RM doesnt propagate
neither the clear nor the new raise of the alarm, leaving the previous alarms as they are.
ED
03
957.130.882 U
84 / 198
Relevant Process:
Variable Name:
objImpCnf
(topMngAgent_csa)
NLnaptim (1200)
This variable defines the default timeout value (in seconds) for the NAP upload of a single node. If a node
contains a large number of PDH ports (e.g. more than 300) it is suggested to set a bigger timeout value.
Relevant Process:
Variable Name:
pathImp
(trsMngAgent)
tsdFepCfg
NL_TIMER_WATCHSW (600)
NL_TIMER_MNGSW (60)
The NL_TIMER_WATCHSW variable defines the watching period lenght (in seconds) of switch state, the
watching period begin from synchronize switch command. During this period all switch events are
managed.
The NL_TIMER_MNGSW variable defines the timeout value (in seconds) for the execution of a manage
SNCP command. The value of this variable has to be minor than the NL_TIMER_WATCHSW.
Variable Name:
The RM printer functions (started from report windows or by CDE desktop popup menu) use the
environment variables NXNL_PRINT to execute the printing command.
If the variable is set to null the printer functions use the lp Unix command, otherwise they execute the
command described in the variable.
Using the default command the printouts have landscape orientation and each row contains up to 180
characters.
When this variable is changed, to take it effective it is required to exit from CDE workspace and then login
again.
N.B.
ED
This commands is used only for ASCII printout, not for Hardcopy popup menu commands.
03
957.130.882 U
85 / 198
Relevant Process:
Variable Name:
trsMngAgent
NLCheckVirtual (not defined by default)
PDH ports and related NAPs, defined in a virtual NE, and not involved in any path, can be removed at the
trsMngAgent startup. This feature can be enabled or disabled by means of this environment variable. If
the variable is defined the check is performed, if it is not defined the check is skipped.
Relevant Process:
topMngAgent_g
(nlMon_g)
In the 1354RM product, it does not exist the possibility to stop a get operation that produces a big amount
of linked replies (e.g. not filtered full scope get operation). In any case is provided the possibility to define
a maximum number of linked get reply that can be produced by a single operation.
The maximum number must be defined as a parameter to the topMngAgent_g process specifying it in
the configuration file $NXNL_PRD/conf/conf_nlMon_g.
The syntax is:
The parameter <n_ans> indicates the maximum number of linked replies allowed (default 1000). If it is
indicated the number 0 no limit is set. If during a get operation the reply limit is reached a warning message
is displayed to the operator.
N.B.
ED
The string described in this paragraph as <xxx> is the suffix of the agents instances and must
not be changed.
03
957.130.882 U
86 / 198
The fonts used in the Netview applications are specified in the file:
/usr/snml/conf/users/admin/xapplresdir/C/OVw
They are automatically referenced by HPOVw depending on the number of symbols to be displayed in
a submap.
If the symbol labels are too small the System Administrator could change the size of this fonts (i.e. the small
font could be changed from *helveticamediumr*80* into *helveticamediumr*120*
and then restart NetView application (close all the HPOVw windows and start again the application).
In the following an alternative font set with respect to the delivered one is listed:
*size30Font:
*size20Font:
*size10Font:
*smallFont:
*helveticamediumr*140*
*helveticamediumr*120*
*helveticamediumr*100*
*helveticamediumr*80*
ED
*helveticamediumr*140*
*helveticamediumr*120*
*helveticamediumr*120*
*helveticamediumr*120*
03
957.130.882 U
87 / 198
Relevant Process:
pmCollMng
(pmMng)
It is on User responsibility to specify in a configuration file eml_PM_nodes the host machines where the
EMLIM applications communicating to RM the PM Data are.
The file eml_PM_nodes is present in the /usr/snml/conf directory and must be manually filled by the
operator.
In the file a row has to be specified for each managed EML. Each row has the following syntax:
<EML_ID> <host1> <host2> <remote_user> <home dir remote user> <dir 15M> <dir 24H>
where:
<EML_ID>:
<host1>:
<host2>:
Relevant Process:
pmCollMng
(pmMng)
To customize the timeout between two different file collection operations the following options can be
inserted in the process starting command in the file /usr/snml/bin/pmCollMng :
timeout15m <n>: it allows to customize the timeout value representing the collection frequency of
the 15 minutes transfer files from the EMLs to RM. The value <n> must be expressed in minutes and
it must be included between 15 (i.e. a quarter) and 225 (i.e. 3 hours and 45 minutes). If the option
is not specified the default value is 15 minutes;
timeoutday <n>: it allows to customize the timeout value representing the collection frequency of
the 24 hours transfer files from the EMLs to RM. The collection activity has anyway a builtin timeout
of 4 hours after midnight to collect data file relevant for the last elapsed day. The value <n> must be
expressed in minutes and it must be included between 1440 (i.e. one day) and 8640 (i.e. six days).
If the option is not specified the default value is 1440 (i.e. one day);
ED
03
957.130.882 U
88 / 198
Relevant Process:
tsdFepColl.exe
TFEP/COLL acts on a periodic basis: the collection frequency could be provisioned from a user by means
of a configuration file COLL_CFG . In COLL_CFG file the user can specify:
a granularity list indicating the day partition and the collection frequency (e.g. 12 60, a copy from
EML is done every 60 minutes for the period starting from the previous period end till 12 A.M)
The configuration file COLL_CFG should be present in the directory specified by the enviornment
variable PM_DATA_WORK; at the moment a COLL_CFG.make file is present as templete. Its in charge
of the user to provide the COLL_CFG file.
When the file COLL_CFG is not present a default value is adopted from the tsdFepColl agent:
Relevant Process:
lpmCollMng
To define the maximum number of parallel collection activity that can be executed the following option can
be inserted in the process starting command in the file /usr/snml/bin/pmCollMng
maxscript <n>: the value <n> represents the maximum number of scripts that can be execute in
parallel to collect the PM transfer files from the EMLs. If it is not specified the default value is 3.
Relevant Process:
tsdFepColl.exe
To define the maximum number of parallel collection activity that can be executed the following variable
could be used NLcollMaxScript. If it is not specified the default value is 3
ED
03
957.130.882 U
89 / 198
To allow the PM data archive function a new ORACLE user environment is required. The following
procedure shall be executed after the RM installation:
a)
b)
Create required tables and views (dropping the old ones if any):
$ /usr/snml/bin/pmCreateRMPArchive.com
c)
Initialize the PM Book Period table in RM User DB (snml/snml) in order to customize the starting
& ending time of Archive activity that will be taken into account by the next user archive request (it
must not be executed in case of DB import):
$ /usr/snml/bin/pmInitRMP.com
N.B.
The starting date is by default the beginning of the current month and the ending date is
calculated using the variables described in 11.14.2.2 paragraph.
Variable Name:
DETAILEDARCHIVEPERIODDURATION (7)
NORMALARCHIVEPERIODDURATION (1)
When the archive request is issued by the operator, if more than one archive periods are
elapsed (difference between current time and end archive period is bigger that the duration
indicated by these variables), all data relevant for these elapsed archive periods will be archived
in one shot.
When these variables are changed, to take them effective, it is required to exit from CDE workspace and
then login again.
ED
03
957.130.882 U
90 / 198
Variable Name:
DETAILEDARCHIVEPERIODOVERLAP (7)
NORMALARCHIVEPERIODOVERLAP (1)
These variables are related to the prevention of archive purging of PM data of 15 min
(DETAILEDARCHIVEPERIODOVERLAP) and 24h (NORMALARCHIVEPERIODOVERLAP). The first
one indicates the number of days (by default a week) in which is granted that archived data relevant for
15 min will not be removed from RM DB. The latter variable indicates the number of months (by default
a month) in which is granted that archived data relevant for 24h will not be removed from RM DB.
When these variables are changed, to take them effective, it is required to exit from CDE workspace and
then login again.
11.14.3 PM Scheduled Report
Meaningful for IM configuration only.
Relevant Process:
Variable Name:
pmMng
PM_DELAY_MIN (135) value in minutes
PM_DELAY_DAY (8)
value in hours
PM_DELAY_MIN (relevant for 15 min data) / PM_DELAY_DAY (relevant for 24h data) an useful value
used in order to grant that when a report has to be generated, the meaningful counters have been already
collected and analyzed (i.e. stored in the DB). They allow to synchronize the collect & analysis and the
report generation activities.
e.g. PM_DELAY_MIN= 30 the fifteen minutes report of the period 25/08/200023.00 to 23.15 will be
generated at 23.45 of 25/08/2000.
e.g. PM_DELAY_DAY= 8 the daily report of 25/08/2000 will be generated at 8.00 AM of 26/08/2000.
11.14.4 PM Automatic Start/Stop Measures
Meaningful for IM configuration only.
Relevant Process:
Variable Name:
pmMng
NLschedule15 (600)
NLschedule24 (600)
These variables allow to set the timeout value for the automatic Start and Stop of 15 min / 24h Measures.
Their value has to be expressed in seconds (e.g. NLschedule15=60 means that the timeout for 15 min
measures elapses each minute).
ED
03
957.130.882 U
91 / 198
In 1354RM a default ASAP for paths,trails and physical connections is created at the installation time and
it is identified by the value default ASAP as userLabel (its asapId is always equal to 0).
An offline procedure permits to substitute the default ASAP with an ASAP previously defined by the user.
The steps to execute this procedure are:
a)
b)
c)
This procedure asks the userLabel of the new default ASAP to the operator.
The procedure checks if the ASAP specified by the operator is already defined. If it is not defined, the error
message
Asap <userLabel specified by the operator> not Found
will appear.
$ cd XAPPLRESDIR/C/include
$ cp NLguiCommon NLguiCommon_english
$ cp NLguiCommon_latin1 NLguiCommon
$ cp NLfont NLfont_english
$ cp NLfont_latin1 NLfont
$ cp NLmatrix NLmatrix_english
$ cp NLmatrix_latin1 NLmatrix
ED
03
957.130.882 U
92 / 198
The command will change the configuration file of the PMC application, but in order to make effective the
new configuration it is necessary to exit from PMC and than restart it again.
N.B.
Exiting and restarting the PMC does not have any impact on the RM system status.
Before to remove the Qnn Agent by the PMC handling the user has to shutdown it.
After a patch installation the operator should perform the enabling of the QnnAgent
Management.
NN administrator;
NN user;
NN viewer.
The first profile is mapped on the RM user qnnmng, the second one is mapped on the RM user qnnagent
and the latter one with the RM user qnnview.
If the following users are not defined, the zoomin from NN cannot work and it is not
displayed any additional message.
# cd /usr/snml/etc
# ./AddQnnUser
The command will define the users with the following characteristics:
RM user
qnnmng
qnnagent
qnnviewer
qnnpmop
ED
: Profile
: OSadmin
: PathBuilder
: LookOnly
: PathBuilder
: NAD
: 1
: 301
: 40
: 301
03
957.130.882 U
93 / 198
The 1354RM zoomin execute from 1354NN is usually performed running the required application on
1354RM Master system. If there are many 1354NN operators, this activity can overload the 1354RM
Master system.
In order to reduce the amount of activities on RM Master it is possible to specify which 1354RM USM of
the same 1354RM cluster have to execute the zoomin application instead of the 1354RM Master.
The /usr/snml/conf/qnnDispMapping file contains the relationship between the 1354NN X Display
require the zoomin and the 1354RM USM that have to execute the application. To request this feature
add one line for each display that have to be served by 1354RM USM in the qnnDispMapping with the
following syntax:.
<nn display> <RM USM hostnamer> where nn display is the 1354NN display identifier, using
the X11 standard notation (eg.NNDISPLAY:0.0) and RM USM hostname is the hostname of the
RM USM of the same 1354RM cluster of the 1354RM Master.
N.B.
In case of 1354RM USM failure, the 1354RM zoomin will fail also.
N.B.
If the 1354RM USM is removed from the network also the related line(s) have to be
removed from /usr/snml/conf/qnnDispMapping.
Example of /usr/snml/conf/qnnDispMapping:
nnmst1:0.0
rmusm1
nnxt01:0.0
rmusm2
nnmst1:1.0
rmusm3
ED
03
957.130.882 U
94 / 198
1354RM
Network Domain n
CTPA
CTPB
CTPA
CTPB
Physical Connection
Subnetwork Connection
Virtual NE
1354RM
Network Domain n
CTPA
CTPB
CTPA
CTPB
Physical Connection
Subnetwork Connection
Virtual NE
A Virtual NE can represent more than one RM domain. It can represent a whole RM domain independently
from its position into the topological hierarchy (contained in a subnetwork).
As workaround it is suggested:
to represent remote RM domains belonging to the same protection route with a single Virtual NE.
To avoid problem in the NN path allocation phase it is necessary also to disable passtrough on virtual
node ( see Use of Virtual Nodes during Path Allocation Phase ).
ED
03
957.130.882 U
95 / 198
In the case of a SNCP protection (QosProtection=full or partial protection on the 1354NN ) asked by
QnnAgent to the RM , if the RM is not able even to perform a partial protection the allocation fails (while
the Qnn foresee a successful allocation with a degraded protection ).
It is possible change manually the protection (no protection) of that path on the RM and try to perform the
redo operation from the 1354NN (only in the case of a path not corresponding ,on the Qnn, to a switchable
subnetwork connection).
in order to assign an MSTrail it is necessary to have already assigned at least one HOLC;
in order to assign an HOTrail it is necessary to have already assigned at least one LOLC;
in order to assign a path, its NAPs shall be assigned.
So the suggested order to assign Network resources to 1354NN is the following (if the following
order is not respected by the operator the result could be unpredictable):
a)
b)
c)
d)
e)
f)
HOLCs;
MSTrail;
LOLCs;
HOTrail;
NAPs;
Path.
a)
b)
ED
03
957.130.882 U
96 / 198
13 EML SIMULATION
The 1354RM can handle simulated EML domains and mixed networks with real and simulated EMLs.
In particular 1354RM can work in a standalone configuration either populating RM DB with EML data only
or recovering a backup performed on a real RM plant.
where file name identifies the file that contains the data to load in the database.
N.B.
N.B.
The RM doesnt execute any congruency checks about ports contained in specific NE.
After the DB population with the gen_load command all the EMLs must be registered as Simulated.
for TSDIM Network: execute in a root UNIX user window the command AddEML <EML domain>
(present in the /usr/snml/bin directory), then exit from PMC (Process Monitor) application and start
it again. At the end execute the manual startup of the FEP agents.
for SENIM Network: execute in a root UNIX user window the command RegisterAllEmlSim
(present in the /usr/snml/bin directory).
ED
03
957.130.882 U
97 / 198
The directory /usr/snml/databases/dbsnml/init contains a set of TSDIM Simulated data files and a set
of SENIM data files which can be used for the generation. In addition, an offline tool can be used to create
the desired network file. The procedure to create a simulated data file is described in the following:
a)
b)
c)
The system asks: Is filename a new file? . If you answer Yes you will have to enter all values,
otherwise the system wiil present you the actual file values, in order to modify them.
d)
EML userLabel
SHversion
e)
f)
Enter the number correspondent to the desired equipment type and press
NEuserlabel
sitename
Board name 1
Board name 2
Board name n
To select the board, enter the number correspondent to the desired board and press Return.
g)
h)
i)
j)
ED
03
957.130.882 U
98 / 198
ED
03
957.130.882 U
99 / 198
It is possible to transfer data of a real live network on a standalone RM configuration in order to work
with 1354RM product on this data.
To reach this goal it is necessary to perform a RM backup of the real network and than restore it on the
RM standalone. Finally on the RM standalone workstation the EMLs are to be registered as Simulated:
for TSDIM Network: execute in a root UNIX user window the command AddEML <EML domain>
(present in the /usr/snml/bin directory), then exit from PMC (Process Monitor) application and start
it again. At the end execute the manual startup of the FEP agents.
for SENIM Network: execute in a root UNIX user window the command RegisterAllEmlSim
(present in the /usr/snml/bin directory).
ED
03
957.130.882 U
100 / 198
b)
c)
d)
By using the same shell, launch the process control with the command
mngAgent&
e)
Start emlObjAgent
f)
Execute the EMLsynchronize for each EML which contain NEs with userLabels which are modified.
With NLnochecks environment variable set to TRUE, every change on the attributes of NEs and Ports
is admitted. So, it is preferable to check all the attribute value changes sent during this alignment
phase. Be sure all the EMLs are aligned (the attribute emlDomainAlignement has to be equal to normal).
g)
h)
i)
j)
Eventually align the userLabel of pmNes and pmTps objects (see below).
Execute the EMLsynchronize for each EML which contain NEs with userLabels which are modified.
b)
Eventually align the userLabel of pmNes and pmTps objects (see below).
ED
03
957.130.882 U
101 / 198
a)
b)
$ORACLE_HOME/bin/sqlplus $NXNL_DATABASE
SQL> @/usr/snml/databases/dbsnml/admin/conv/alignPmUserLabel
The procedure requires the userLabel of the migrated NE (with TSDIM interface).
b)
ED
03
957.130.882 U
102 / 198
15 MIGRATION PROCEDURE
In this section the migration procedures between RM 2.4 and RM5.2.x are described.
Every procedure requires the following environment variables:
a)
NXNL_DATABASE: it points to the current RM database. This variable is usually set by the profile
of the user snml;
b)
MIG_TAR: it represent a temporary directory where the tar files are stored. This directory must be
created with the permission set to readable and writable from everyone. If you choose the directory
/mig as mig_tar directory, you have to execute the following UNIX commands (by snml user):
mkdir /mig
chmod 777
c)
login as root user (by command <su root> not <su root> otherwise your environment are modified)
and execute:
MIG_TAR=/mig
#export MIG_TAR
d)
MIG_PAR: it points to a directory where the parameter files are present. The following UNIX command must be executed to set the proper value for this variable:
MIG_PAR=$DB_ROOT/admin/conv
#export MIG_PAR
e)
MIG_BACKUP: it represents the directory where the data files produced/used during the export/import phase are stored. This directory has to be created before the execution of the migration procedure. For example, if you choose the directory /mig_backup as mig_backup directory, you must execute the following UNIX commands (by root):
#mkdir /tmp/mig_backup
MIG_BACKUP=/tmp/mig_backup
#export MIG_BACKUP
Every migration procedure checks if these variables are correctly set. If a check fails, an error message
is displayed and the executions stops.
ED
03
957.130.882 U
103 / 198
a)
Be sure RM and EMLs are aligned (execute EMLsynchronize for each EML and the global consistency audit/download).
b)
If you want to export also OVWMAPs, save by DNM the maps to be converted by DNM (select menu
File>Distribute maps>Store map images).
c)
d)
Stop 1354RM system if necessary (the database must be on instead), log in as root users and change your current directory to the old delivery home directory:
$ mngAgent shutdown control
$ mngAgent shutdown system
$ su root
# cd /usr/snml
e)
Extract the export database procedures from the 1354RM R5.2.x installation kit:
# uncompress c <1354RM_inst_kit> | tar xvf ./databases/dbsnml/admin/conv
Particularly, the following files are used during the export phase:
./databases/dbsnml/admin/conv/expDbRmRel
./databases/dbsnml/admin/conv/expDbRm.par
and a couple of file with extension sql and ctl for each table of the RM database with a
schema incompatible between RM2.4 and RM5.2.x (node table).
# cd $DB_ROOT/admin/conv
# chmod +x expDRmRel
f)
(if necessary), create the directories (named migbackup and mig_tar directories) where the data
migration files will be copied.
For example, if you want to create the directory /tmp/mig_backup to collect the data migration files,
and the directory /mig where tar files are saved, the following command have to be executed:
# mkdir /tmp/mig_backup
# mkdir /mig
g)
Assign the name of the migbackup directory to the MIG_BACKUP environment variable, and the
name of the mig_tar directory to the MIG_TAR environment variable.
For example, if the migbackup directory is /tmp/mig_backup and /mig is the migtar directory, the
following command have to be executed:
# MIG_BACKUP=/tmp/mig_backup
# export MIG_BACKUP
#MIG_TAR=/mig
#export MIG_TAR
Then, you have to assign the value of the MIG_PAR directory as below:
#MIG_PAR=$DB_ROOT/admin/conv
export MIG_PAR
ED
03
957.130.882 U
104 / 198
Preconditions:
h)
# cd $DB_ROOT/admin/conv
i)
ED
03
957.130.882 U
105 / 198
Install 1354RM R5.2.x delivery (see 3.1), creating a new database (variable NEW_DBSNML must
be set to yes value in /usr/snml/env_snml file (see 3.1.3)).
k)
l)
Change your current directory to the conversion directory (after the 1354RM R2.4 installation
DB_ROOT is the directory name of the new database):
# cd $DB_ROOT/admin/conv
m ) Be sure the system is off, otherwise shutdown it using the Process control
n)
Be sure the database is running, otherwise startup it using the Process control
o)
Every time the procedure is executed, the previous log file is automatically saved as impDbRm.log.save.
ED
03
957.130.882 U
106 / 198
j)
N.B.
p)
ED
The import procedure creates a big ORACLE tablespace named large_rbs_tbs. This
tablespace is dropped at the end of the procedure. However, if the import procedure fails
because of an ORACLE error on large_rbs_tbs tablespace (or large_rbs rollback segment), the following commands must be executed:
# rm $DB_ROOT/data/large_rbs_tbs.dbf
$DB_ROOT/etc/create_db (to be executed by snml)
The last command resets the entire ORACLE database.
Moreover, PDL files produced in RM2.4 couldnt be properly executed with RM2.3
(because of the portuserLabel change between SH1.2 and SH3).
03
957.130.882 U
107 / 198
This procedure has to be executed after the migration steps described in (15.1).
It registers the EML simulator agent of 1354RM (emlSimulAgent.exe) as the process which answers to
CMISE services requests forwarded to virtual Eml domains.
Without this registration, you will get Object Manager Not Found error messages for actions/gets/etc.
involving virtual Nes.
15.2.1 Prerequisites
Prerequisite 1: you have to know the list of emlDomainIds of virtual eml.
This can be done using Browser user interface manager, making a get on 1354RM (yellow) object (the
child of MULTI SNMLIM, labeled SNMLIM). Ask for Eml Domain, press the Filter button, select
Virtual equal to Virtual on the filtering mask. You will find all virtual eml(s). For each of them, make a
show/set attribute (select one of them, then press the lens icon); the requested Id is EML Domain Id attribute.
Note: very often, the only virtual EML is the one with emlDomainId = 0.
Prerequisite 2: you have to know UNIX root (superuser) password.
Login as snml user, then change current directory to $NXNL_PRD/bin with the command
cd $NXNL_PRD/bin
b)
Get superuser (i.e. root) privileges issuing the following command (you will need root password):
su root
(Note: this is not the same as su root)
c)
start the registration of virtual eml domain with emlDomainId = <n> issuing
./RegisterSim n
Answer y if you are prompted for creation of VEML<n>simul.vlrf file.
ovaddobj utility will be invoked in order to registrate emlDomain <n> objects.
d)
ED
03
957.130.882 U
108 / 198
b)
a QB3* NE is migrated in a new NE one (tipically when an NE chages its EML domain)
c)
ED
03
957.130.882 U
109 / 198
In the following, a brief description of the procedure to migrate one NE between QB3* and QB3 interface
is done.
Two different cases are foreseen, ADms and DXCs.
a)
in case of ADMs, stop the supervision (all the alarms are cleared). In case of DXC, a procedure to
clear alarm is available on RM (see below)
b)
Prepare a file with the association between the old and the new portId (NE migration file). In case
of DXC, this file is computed by RM. Instead, for ADMs, a procedure on SH will be available to do
this. The file name is equal to the userLabel of the NE to be migrated. The format of the file is:
BEGIN FDN_MAPPING_FILE
<neUserLabel>
<oldSdhPortIdId> <newSdhPortIdId>
END FDN_MAPPING_FILE
c)
Stop the FEPPN process corresponding to the neGroup of the NE (when migrated in QB3)
d)
e)
f)
Execute the neMigration procedure in order to change all the fdnMapper of Ports (and NE too). This
procedure changes the userLabel of the NE (if required) and all the Ports accordingly to the TSD naming rules.(See 1.3.2.2).
g)
h)
Execute on RM a synchronizeEml on neGroup at the end of the neMigration. If this operation is sucessfully terminated (emlDomainAlignment=normal), the equipment is well converted in TSDIM,
otherwise the error messages have to be carefully analyzed and a restore of RM DB is required.
i)
j)
1)
MSCtps, HOCTPs and NAPs have to be aligned to the fdnMapper of the physical port;
2)
3)
At the end, the equipment configuration of NE is well known by RM (the consistency status of all the object
is equal to normal). During the execution of the procedure, the NE to be migrated is in download disable
mode. The procedure changes the status for you. Alarm activity is suspended (this is due to the fact all
the network objects belonging to the NE are not aligned inside the RM database).
ED
03
957.130.882 U
110 / 198
15.3.1.1 Overview
The tool neMigration performs the migration of NE in a new version QB3 (SH5).
The tool is executed by starting the shell script neMigration as snml user.
It is located in /usr/snml/databases/dbsnml/admin/conv directory.
You must set the following environment variables:
a)
MIG_LOG: it contains the directorys name where you want to save the migration.log file.
b)
MIG_BACKUP: it contains the directorys name where are located the migration data file.
For example, the following UNIX commands can be used in order to set these environment variables:
c)
$ export MIG_LOG=/users/snml/log
d)
$ export MIG_BACKUP=/users/snml/backup
MIG_LOG variable is assumed to be equal to MIG_BACKUP value. The tool also saves its log file into
MIG_BACKUP directory.
The utility creates a new windows containing the following functions:
1)
Prepare DXC Ports : this function prepares a input data file with old portid and new portid to
migrate the DXC. For ADM, the data file is provoded by the SH system.
2)
Check Data : this function checks all data involved in migration, (Ne data, Eml, ports, negroup
versions). It is also checked all the connection are supported by the target version of TSDIM..
3)
TSD Convert : this function performs the migration of Ne in new neGroup. During this phase
checks previously described are executed again..
The new neGroup Before (supporting the TSDIM interface) must also be created in RM database before
executing the last two steps..
When you start the Prepare DXC Ports option, two options can be selected
1)
2)
In case of DXC, this option creates a data file for DXC and saves it in MIG_BACKUP directory that you
have set previously. The file have following format:
BEGIN FDN_MAPPING_FILE
<neUserLabel>
<oldSdhPortIdId> <newSdhPortIdId>
END FDN_MAPPING_FILE
ED
03
957.130.882 U
111 / 198
1)
Check Ne data : this option alows to verify the data file (if it is correct and complete)
2)
Check connectivity of Ne : it checks if the protected multi point cross connections on SH have
been implemented. in this case, the path userLabel and the nodenames when these crossconnections are present are reported to the operator. Th
The operator must remove all th protected legs (except for one)
3)
4)
When you start the TSD convert option , the following option can be choosen by the operator:
1)
Clear alarm : this function clears the elemntary alarms correlated to networks objects belonging
to the NE to be migrated . The userLabel of the NE is requested by the operator.
2)
3)
4)
a)
b)
c)
d)
TSD user label : new user label of Ne (optional)., If not specified by the operator, it is assumed the NE doesnt change its userLabel.
At the end of the procedure, two choices can be selected by the operator, regarding the log file procedure:
ED
1)
Read log file: the operator want to read the log file
2)
Skip log file: the operator is not interested in analyzing the log file. However, it will be possible
to read it by using a text editor. Remember that the log file is $MIG_LOG/migration.log.
03
957.130.882 U
112 / 198
2)
Error in parameters number or parameters type ! : the list of input parameters is not correct
3)
4)
Memory allocation error ,check your free memory ! : an internal error on heap has been found
5)
6)
Error in number of Ne retrieved ! : this error is generated when two or more Nes with the same
userlabe was found
7)
Error in number of Node retrieved ! : this error is generated when two or more Node with the
same Id was found
8)
9)
Generic error ! : this error is generated when a procedural error was found, tipically during the
Ex: prepareDXCPorts phase.
10 ) Error in number of Tp retrieved ! : a protected multipoint connection was found but its TP list
is corrupted
11 ) Found switch connections in topology ! : a protected multipoint connection was found.
12 ) Ne not found in the database ! : The Ne with the specified userlabel is not retrieved in RM database
13 ) Migration file not found ! : the data file has not been retrieved in $MIG_BACKUP directory.
14 ) neGroup not found in the database ! : the new neGroup (TSDIM) is not retrieved in RM DB (it
is to be created offline)
15 ) neGroup is not TSDIM ! : the new neGroup involved in migration supports SENIM interface
16 ) New userLabel duplicate ! : the new userlabel of Ne is not unique.
17 ) Error in IM version ! : the Ne involved in migration is already equipped by TSDIM interface
18 ) Database write fault ! : a DB write is failed
19 ) Database delete fault ! : this error is generated when a DB delete on observed port is failed
20 ) Migration file doesn not exist ! : the data file is not present in $MIG_BACKUP directory.
ED
03
957.130.882 U
113 / 198
The neMigration procedure changes all the informations in the RMdatabase in order to allow the execution of the download activity. During this phase, the network element is set how all the object were directly
created with the TSDIM interface. So, the disabledAlarms attributes of NAPs, CAPs, CTPs boundary and
PDH physical ports are modified if the connections are implemented on them. In other words, it is necessary that the proper alarms are enabled on the physical end points of the paths/trails wich are implemented
on them This task is executed by the RM when the TSDIM interface is used.
However, the neMigration procedure is not able to compute the proper Q3disabledAlarms on the entire
paths/trails; in fact, the procedure only works on objects belonging to the migrated Ne.
Then, it is possible that the Q3DisabledAlarms attributes of the transport Servers are not correct after a
migration of one NE. These attributes can be computed by the following steps:
a)
check if the PL/SQL packages are already load on your Oracle instance by using the command (as
snml)
$ORACLE_HOME/bin/sqlplus $NXNL_DATABASE
SQL> SELECT COUNT(*) FROM user_source where name=ALIGNENABALARMS;
b)
if the select statement of the previous step returns 1 row, please execute the following step, else the
package has to be loaded with the SQL COMMANDS:
SQL> @/usr/snml/databases/dbsnml/admin/conv/alignQ3AlarmsPck_spec
SQL> @/usr/snml/databases/dbsnml/admin/conv/alignQ3AlarmsPck_body
Pratically, the PL/SQL package must be loaded just either the first time this procedure is executed
or when the database is created again.
c)
The procedure requires the userLabel of the migrated NE (with TSDIM interface).
ED
03
957.130.882 U
114 / 198
b)
MIG_LOG: it contains the directorys name where you want to save the migration.log file.
b)
MIG_BACKUP: it contains the directorys name where are located the migration data file.
For example, the following UNIX commands can be used in order to set these environment variables:
c)
$ export MIG_LOG=/users/snml/log
d)
$ export MIG_BACKUP=/users/snml/backup
If the MIG_LOG variable is not defined, all the log files are saved in the $MIG_BACKUP directory.
The utility creates a new windows containing the following functions:
1)
Check Data : this function checks all data involved in migration, (Ne data, Eml, ports, negroup
versions).
2)
neTranslation : this function performs the translation of Ne in new neGroup, during this phase
(all the checks of point a) are executed again).
Before starting the checkData you also must create a new neGroup before.
When you choose the checkData option, two options can be selected
1)
Continue: to checks all the data which are used in the next phase;
2)
2)
If you choose the option 1), you must enter the name of the file containing the data of the NEs to be translated (complete pathname, if the directory of the file is not the directory when the utility is executed).
ED
03
957.130.882 U
115 / 198
The format of the neFdnMapper is dependent on the interface (SENIM or TSDIM) of the NE itself.
At the end of the procedure, two choices can be selected by the operator, regarding the log file procedure:
1)
Read log file: the operator want to read the log file
2)
Skip log file: the operator is not interested in analyzing the log file. However, it will be possible
to read it by using a text editor.
2)
3)
Memory allocation error ,check your free memory ! : an internal error on heap has been found
4)
5)
Generic error ! : this error is generated when a procedural error was found
6)
Translation file error ! : the input data file is not correctly formatted.
7)
Error in IM version ! : this error is generated when the Ne involved in migration have different
interfaces (TSDIM versus SENIM and viceversa).
8)
9)
Error in parameters number or parameters type ! : this error is generated in case of wrong number or type program parameter.
10 ) Translation file not exist ! :the data file is not present in $MIG_BACKUP directory.
11 ) Ne not found in the database ! : the Ne to be moved ins not present in RMDB
12 ) neGroup not found in the database ! : the neGroup involved in the migration is not present in
DB
ED
03
957.130.882 U
116 / 198
b)
Start RM5.2.x
c)
d)
e)
f)
Save the map selecting the DNM command File>Distribute Maps>Store Map Image
g)
b)
Now yo have the map again as an distrubuted map. To recover it, proceed as usual.
N.B.
ED
NOTE: The old map is copied as $NXNL_MAPDBAREA/<mapname>.db.OLD. You can recover it, in case of errors, or delete it otherwise, to save disk space.
03
957.130.882 U
117 / 198
This procedure has to be executed after the migration steps described in (15.1).
It registers the EML simulator agent of 1354RM (emlSimulAgent.exe) as the process which answers to
CMISE services requests forwarded to virtual Eml domains.
Without this registration, you will get Object Manager Not Found error messages for actions/gets/etc.
involving virtual Nes.
15.5.1 Prerequisites
Prerequisite 1: you have to know the list of emlDomainIds of virtual eml.
This can be done using Browser user interface manager, making a get on 1354RM (yellow) object (the
child of MULTI SNMLIM, labeled SNMLIM). Ask for Eml Domain, press the Filter button, select
Virtual equal to Virtual on the filtering mask. You will find all virtual eml(s). For each of them, make a
show/set attribute (select one of them, then press the lens icon); the requested Id is EML Domain Id attribute.
Note: very often, the only virtual EML is the one with emlDomainId = 0.
Prerequisite 2: you have to know UNIX root (superuser) password.
Login as snml user, then change current directory to $NXNL_PRD/bin with the command
cd $NXNL_PRD/bin
b)
Get superuser (i.e. root) privileges issuing the following command (you will need root password):
su root
(Note: this is not the same as su root)
c)
start the registration of virtual eml domain with emlDomainId = <n> issuing
./RegisterSim n
Answer y if you are prompted for creation of VEML<n>simul.vlrf file.
ovaddobj utility will be invoked in order to registrate emlDomain <n> objects.
d)
ED
03
957.130.882 U
118 / 198
16.1 Prerequisites
a)
b)
You have to know the NODE.NODEINET and NODE.SEQNUMINET actually stored in NEs. If you
dont know them, a way to obtain them using Craft Terminal equipment is suggested in the following.
Nodes in a MSSPRING are numbered clockwise starting from zero and ending in <number of nodes in
MSSPRING> 1). This is the SEQNUMINET of NODE table information in RM terminology, and the
nodePosition field of ringMapInfo attribute of mSSPRingProtection MOC in SENIM terminology.
Every node has a labeling number whose value is between 0 and 15. The only requisite is that no node
has this number equal to another one. This is called the NODEINET of NODE table in RM terminology,
and both the nodeId attribute of mSSPRingProtection MOC and the nodeId field of ringMapInfo attribute
of mSSPRingProtection MOC in SENIM terminology.
This labeling number is mainly used to identify nodes in squelching tables. If the values dont match, the
whole MSSPRING protection mechanism is compromised.
Every Network Elements knows this informations for all nodes, i.e. it has hardware registers containing
all the (SEQNUMINET, NODEINET) mapping for every node.
To retrieve this information from an existing network a possible way is to use a Craft Terminal connected
to Network Elements.
Please refer to document 1664 SMECT V2.0 : SYNCHRONOUS MULTIPLEXER 1664 SM RELEASE
2.0 EQUIPMENT CRAFT TERMINAL (and subsequent versions).
See MSSPRING CONFIGURATION chapter, MSSPRING CONFIGURATION table, Ring Map
sequence. In this table:
a)
b)
ED
03
957.130.882 U
119 / 198
a)
b)
Stop 1354RM system if necessary (but not the database, which has to be on) using Process Control
facility.
c)
d)
f)
Reenter the procedure, then select the option Dump all nodes of all rings ....
Now you will have another file with all MSSPRING related informations of the nodes of the rings you
specified in the previous step.
This files (whose actual name you can find on the screen) will be called nodedata file in the following.
g)
h)
Reenter the procedure, then select the option Load nodes data ... into database.
The nodedata file will be compiled in sql format then submitted to sqlplus Oracle(TM) utility.
If there is any error regarding the format of nodedata file, simply correct it, then repeat this step.
If all your efforts eventually fail, perform a full database restore.
ED
03
957.130.882 U
120 / 198
i)
Now the datas are inserted in RM database. When you will implement the modified MSSPRING
rings(=ets), the datas you have just inserted will be used by RM system. Mainly, they will be forwarded
to lower OS layers (currently to SH system).
You have to execute all procedure steps until step f ) (included), set the environment variable
NXNL_EXTERNAL_NODEDATA to the name of the prebuilt nodedata file, then perform the same actions
as step h ) but selecting option Load nodes data from external source into database instead of option
Load nodes data ... into database. The procedure will ask you for data file name confirmation.
If something goes wrong, first of all compare your file with the one generated in step f ), to check if you
have made some syntax error. Note that the order of rows doesnt matter, as far as all NODE ... rows
regarding nodes of the same ring are grouped together under the ET .. row of the ring that they belong
to. Also note that white spaces (blanks) of userlabels are meaningful, i.e. ringNumber1 is not the same
as ringNumber1 (note the ending blank).
ED
03
957.130.882 U
121 / 198
ED
03
957.130.882 U
198
122 / 198
All rights reserved. Passing on and copying of this
document, use and communication of its contents
not permitted without written authorization from Alcatel.
The procedure, in order to grant a proper installation, check that the $ALARM_DIR
directory is empty, otherwise it gives an error.
If the install_A1330 procedure is started with the etc/trace script, it will produce a trace file of the procedure
install_A1330 called /usr/snml/etc/install_A1330.trc.
The IM or US parameter is not related to RM, but to A1330AS product. IM means that IM 1330AS
processes will be installed on RM workstation, US means that on RM workstation only AS user interface
is installed and configured.
N.B.
It is necessary to verify the content of the im_host_conf file, since it is generated by the
install_A1330 procedure.
a)
b)
c)
d)
After the running of the procedure 1354RM PMC do not handle any more the AS agents.
N.B.
ED
It is necessary to verify the contents of the im_host_conf file, since it is generated by the
deinstall_A1330 procedure.
03
957.130.882 U
123 / 198
1330AS is provided with a default US customization in order to see only alarms relevant in 1354RM
environment and to distinguish them by their typology. All the AS1330 users have the possibility to change
the default customizations (HMI Layout, Counter Customizations, Colors, etc.) and so to work in a own
customized AS environment. These customizations are not saved at the end of the work session in order
to not propagate them to all the AS users, even if at USM exit AS requests for customizations saving.
The only user that can make persistent changes to 1330AS customizations is snml and these changes
are effective for all the users.
When e new configuration is made effective by running us_config_A1330 all the changes made by snml
are lost and is restored the initial default customizations.
A.3.1 Swedish language
In order to let ASUSM Components manage alarms containing swedish chars in the right way do the
following operations as nnml user:
$ cp /usr/snml/conf/AS_graphicResources /usr/snml/conf/AS_graphicResources_english
$ cp /usr/snml/conf/AS_graphicResources_sv_SE /usr/snml/conf/AS_graphicResources
Now all the following start of ASUSM Components will be able to manage swedish chars using roman8
fonts.
In order to roll back the configuration to the default one (ASUSM displaying alarms in english) perform
the following commands as nnml user:
$ cp /usr/snml/conf/AS_graphicResources_english /usr/snml/conf/AS_graphicResources
ED
03
957.130.882 U
124 / 198
With the GENOS installation are provided also graphical tools (dependingly on Protocol type) that simulate
external OS communicating with Generic OSOS processes to export alarm informations. To execute
these tools launch the scripts /usr/1353sh/tools/genos/snmp_eos.tcl for SNMP protocol and
/usr/1353sh/tools/genos/eos.tcl for TCP/IP protocol.
N.B.
GENOS product cannot be installed everywhere in 1354RM File System. The installation is
made under the area /usr/1353sh/genos, this limitation is due to specific conditions of GENOS
product. After the installation procedure the link /usr/genos is created and points to
/usr/1353sh/genos.
N.B.
ED
03
957.130.882 U
125 / 198
# su root
# /usr/snml/etc/deinstall_genos <full_pathname_tar_file_deinstallation_kit>
The procedure, without using any configuration file, determines the installed product version and removes
the installation area, and the registrations inside the 1354RM PMC.
ED
03
957.130.882 U
126 / 198
secim process which is the agent of the Security Subsystem and keep all the informations related
to the users and the system;
secim process have to be running only on 1354RMIM.
lss process which is a kind of gate for applications who are interested on user Security profile. There
is one lss process for each workstation/server belonging to the 1354RM system (1 for each
presentation and each IM).
These permanent processes are configured to automatically run everytime just after the installation.
The SEC integration on 1354RM, as a first step, is intended only for the integration of Security
Management within AS (Alarm Survelliance). This means that each 1354RM operator using AS is able
to view/manage only alarms coming from Network resources that it can manage as in RM Browser
In order to have inside SEC Subsystem all the informations concerning Security, SEC is also integrated
in SMF, in order to get informations related to new users, user removal, and initiator mgt. Moreover the
integration of SEC in SMF is also related to the Operator Backup. Each time a new Operator backup is
performed also SEC database is backuped.
If on top of 1354RM is installed also 1353SH software (Master or Presentation) for cohosted or
presentation installations you have to install SEC for SH using the axinstallGui.ptk procedure and SEC
for RM as described below
Keep into account that the SEC installations for RM and SH are different, the integration schemas and the
configuration steps are different.
ED
03
957.130.882 U
127 / 198
After the execution of the following procedure the SEC processes will be integrated in the 1354RM System.
In order to integrate SEC with the 1354RM you have to execute the script /usr/snml/etc/install_SEC.
This procedure works only if no old SEC installations for RM are present (e.g. /usr/sec link is present).
SEC 5.0 is supported on 1354RM.
Execute the following commands :
# su root
#
[/usr/snml/etc/trace]
/usr/snml/etc/install_SEC
<Target_installation_full_pathname>
<full_pathname_SEC_inst_kit>
If the install_SEC procedure is started with the etc/trace script, it will produce a trace file of the procedure
install_SEC called /usr/snml/etc/install_SEC.trc.
N.B. The procedure, in order to grant a proper installation, check that the choosen target installation
directory is empty, otherwise it returns an error.
N.B. Due to SH installation procedure limitation, if SEC for RM has to cohexist with SEC installation for
1353SH (cohosted or SHPresentation) installation, install first SEC for SH using the axinstallGui.ptk tool.
N.B. If a different SEC instance is alredy installed (after cohosted or 1353SH presentation installation) on
the target 1354RM host STOP all the running SEC processes with the script
/usr/1353sh/install/script/stop_security.sh
After the SEC installation on top of RM restart the SEC processes installed on top of SH with the script
/usr/1353sh/install/script/start_security.sh . After the installation the link /usr/sec is created in order to point
to the target installation directory choosen.
N.B. In the case in which SEC is alredy installed on RM please do a Backup of Operator datatype, deinstall
old SEC, install the new version of SEC and perform a Restore of the Operator datatypes. If you want to
install a new version of SEC it is possible that the DB have to be migrated.
ED
03
957.130.882 U
128 / 198
This procedure must be executed each time a new delivery of SEC and 1354RM has to be installed.
it stops all the SEC processes running on the host (only related to RM installation);
b)
c)
d)
N.B.: Due to SEC installation limitation during this procedure all the installed SEC subsystems have to be
stopped.
If
SEC
on
top
of
SH
installation
is
installed
run
the
script
/usr/1353sh/install/script/stop_security.sh.
N.B.: After the deinstallation all the other SEC subsystems installed have to be restarted at hand.
(/usr/1353sh/install/script/start_security.sh)
ED
03
957.130.882 U
129 / 198
SEC Subsystem is provided with a default customization for which on an RM is automatically configured
to run secim process if RMIM and lss process for each kind of RM (IM/US).
The default configurations are put in the directory /usr/sec/1354RM_<NTWDOMAIN>.
In order to distinguish 1354RM SEC processes from the 1353SH ones the RM processes are called
<process_name>_1354RM_<NTWDOMAIN>.
The SEC configuration is also related to the automatic start of SEC process: in the /etc/inittab file is inserted
1
line
for
each
permanent
SEC
process.
This
line
invokes
the
script
run_SECIM|LSS_1354RM_<NTWDOMAIN> that checks for SEC abilitation to run and launch the
secim|lss_1354RM_<NTWDOMAIN> process. The automatic start of SEC processes is set on runlevel
4 that is the 1354RM runlevel default. No checks are performed on the 1354RM effective runlevel (it
is supposed to be 4).
During Operator Backup and Restore the SEC subsystem is stopped in order to add to the Operator
Informations also Informations related to SEC. The actions related to SEC start and stop are automatically
launched by SMF.
If some problem occurs during SMF>Operator Administration and SEC DB is not updated on changes
executed on RM, it is possible to launch the script as snml user through the SMF:
/usr/sec/integration/script/alignsecdb
This procedure starts from the last well finished SEC commands and alignes the SEC DB to the actual
RM Security definitions.
If at login time the user receives a Message Box saying:
Security for 1354RM_<NTWDOMAIN> is not activated.
the problem is that the user is not defined in the SEC DB, or the SEC Subsystem has been stopped
(Restore proc.) or internal error.
N.B.: If the Message does not include the string 1354RM, this means that it belongs to the SEC installed
for SH.
Restrictions:
SEC 5.0 doesnt manage the scheduling time. This means that if an user has a scheduled rule this rule
is applied everytime. This limitation is not due to the integration level but to the fact that SEC 5.0 doesnt
support it.
ED
03
957.130.882 U
130 / 198
True
have to be changed in
SEC_ENABLED
False
Depending on 1354RM user definitions the following AS Access Rights are granted:
System Profile
AS Access Rights
OSAdministrator
ADMIN
MGT
Administrator
ADMIN
MGT
Constructor
VIEW
MGT
PathBuilder
VIEW
MGT
LookOnly
VIEW
Where:
AS Access Rights means the AS accessability, by users, in terms of AS Administration:
ADMIN: Users can invoke AS Administration and Synchronization
VIEW: Users can invoke AS Synchronization but cannot interact with AS Administration functionalities
Alarm Access Rights shows the Alarm accessability rules that are allowed to user:
MGT: Users that have this capability, if allowed by the NAD Rule (see below), can manage accessible
alarms ( acknowledgement).
ED
03
957.130.882 U
131 / 198
MSTrail HoTrail
Alarms
Alarms
Path
ProcessAlarms
ing Alarms
AC_R_SNML
MGT
AC_R_PAYMAN
MGT
AC_R_PADMIN
MGT
AC_R_TOPMAN
MGT
AC_R_PATHRO
RO
AC_R_VPN
RO
X*
AC_R_EVPN
RO
X*
AC_R_RVPN
RO
X*
AC_R_PMSNML
RO
AC_R_PMADMIN
RO
AC_R_PMRO
RO
AC_R_PMVPN
MGT
AC_R_PMVPNRO
MGT
AC_R_NN
MGT
X*
AC_R_PATHALL
MGT
RM Rule
X
X
X
X
Where:
Alarm AccessType shows the alarm accessability
MGT means that user have the possibility to Acknowledge alarms (ManaGemenT)
RO means that user can only access alarms in a view mode (ReadOnly)
The MGT Alarm Accessability is granted if allowed by the System Profile (previous table) otherwise (for
LookOnly users) is set to RO.
X show which alarm types that can be accessed by user with the corresponding NAD Rule associated
X* show alarm types (only marked with user NAD) that can be accessed by user with the corresponding
NAD Rule associated
In order to provide a flexible way to configure AS Access on Alarm the configuration file
/usr/snml/conf/sec/1354RM_Ruler is provided.
This file drives the user Access Rights definition in the SECDB must be modified before the SEC
installation in order to keep coherent user creations.
ED
03
957.130.882 U
132 / 198
In particular in order to give to LookOnly users the possibility to manage all the Alarms without keeping
into account the RM Rule change the line:
System_Profile
:
LookOnly
ASHISTUSM_FAD@AsHistoricalUsm :
ASCURUSM_ALARM_VIEW_FAD@AsCurrentUsm,
as follows:
System_Profile
:
LookOnly
:ASCURUSM_ALARM_MANAGER_FAD@AsCurrentUsm,
ASCURUSM_ALARM_VIEW_FAD@AsCurrentUsm, ASHISTUSM_FAD@AsHistoricalUsm
On the other side, if the LookOnly users Accessability have to be extended to manage alarms depending
on 1354RM Access Rules (second table), change the line:
System_Profile
:
LookOnly
ASHISTUSM_FAD@AsHistoricalUsm :
ASCURUSM_ALARM_VIEW_FAD@AsCurrentUsm,
as follows:
System_Profile
:
LookOnly
:
ASCURUSM_ALARM_VIEW_FAD@AsCurrentUsm,
ASHISTUSM_FAD@AsHistoricalUsm : ASCURUSM_ALARM_MANAGER_FAD@AsCurrentUsm
ED
03
957.130.882 U
133 / 198
ED
03
957.130.882 U
198
134 / 198
All rights reserved. Passing on and copying of this
document, use and communication of its contents
not permitted without written authorization from Alcatel.
ED
03
957.130.882 U
135 / 198
a)
b)
c)
d)
e)
f)
g)
h)
i)
j)
k)
command to set the network where commands will be executed (called working network);
commands to define, delete, update, deallocate, (de)implement and protect/unprotect paths (with or
without constraints);
commands to define, delete, update, (de)allocate, (de)implement, protect/unprotect and configure
trail (with or without constraints);
commands to change NAD to paths, nap, trails and link connections;
commands to treat PM features ( e.g. creating and removing measures, relating a tp to some
measures);
commands to deal with objects of class aSAProfile;
commands to manage objects of class restRule;
command to manage connection in topology.
commands to create, remove, (de)implement topology and physical connection;
commands to upload, remove Nap;
commands to configure et and physical connection;
Comment lines can also be introduced in the command file (for example to document a particular
command).
A command file may contain all types of commands. However, it is important to set the work network before
executing the commands on paths and trails. It is possible to set the work network specifying an input
parameter.
ED
03
957.130.882 U
136 / 198
(pipe)
\\
(backslash)
(tilde)
(backquote)
(double quotes)
N.B.
ED
In the previous text special characters are in bold to highlight them. In the following syntax
descriptions no bold fonts are use.
03
957.130.882 U
137 / 198
The SET command can be used to choose a time reference for dates. If the local time reference is chosen
then all dates are converted to GMT0 time (GMT0 and UTC are functionally equivalent). This is the typical
behavior of a US application. If the GMT0 time reference is set then no conversion is applied to dates. This
is the right behavior for executing a redolog operation.
The default behavior is to apply date conversion to GMT0 time.
D.1.2.2Syntax
SET local END
SET gmt0 END
D.1.3 Setting network
D.1.3.1Description
The SET command defines the number of the network where the commands will have effect.
D.1.3.2Syntax
ED
03
957.130.882 U
138 / 198
D.1.2.1Description
D.1.4.1Description
SETpath:
it permits to set default values for attributes o to be specified at the path creation
(definition) time.
CREATEpath:
it defines a path.
CONSTRpath:
it defines constraints on path for routing purposes. if the constraint list is void,
it deletes all constraints previously defined on the path.
ALLOCpath:
DEALLOCpath:
IMPLpath:
DEIMPLpath:
DELETEpath:
UPDATEpath:
PROTECTpath:
ADDLEGpath:
REMOVELEGpath:
COMMISSIONpath:
UNCOMMISSIONpath:
UPDALRpath:
CONNECTpath:
DISCONNECTpath:
ELEMALARMNGpath:
SPLITpath:
JOINpath:
ED
03
957.130.882 U
139 / 198
<string>}
[<upd_path_attributes> | <not_upd_path_attributes> ]
SETpath
<path_attributes>
END
user_label := <string>
port_name := <string>
node_name := <string>
tp_path_list :=
ED
03
957.130.882 U
140 / 198
upd_path_attributes :=
CREATEpath
userLabel <user_label>
<path_attributes>
endTpList
<tp_path_list>
<tp_path_list>
[... <tp_path_list>]
END
END
ctp_list :=
N.B. the values useMainAZ, useSpareAZ, useMainSpareAZ are meaningful just for unidirectional
paths. Related to connections at node level, A is referred to the input CTP (sink for the Link Connection)
and Z to the output CTP (source for the Link Connection).
CONSTRpath
userLabel <user_label>
[... <ctp_list>]
END
ALLOCpath
userLabel <user_label>
END
DEALLOCpath
userLabel <user_label>
END
IMPLpath
userLabel <user_label>
END
DEIMPLpath
userLabel <user_label>
END
DELETEpath
userLabel <user_label>
END
UPDATEpath
userLabel <user_label>
ED
03
957.130.882 U
141 / 198
changeOpRes :=
{ keepingMain | keepingSpare}
changeOpType :=
{ immediate | deferred }
ttp_to_prot :=
protCmd :=
{protect | addEnhancedProt }
remCmd :=
{removeEnhancedProt | removeEnhancedProtWithCheck }
unprCmd :=
{unprotect | unprotectWitchCheck}
topLev :=
{ ntw | sbn | et }
topLevProt :=
N.B.
updList
[userLabel <user_label>]
[<upd_path_attributes>]
END
END
Node topology is valid only for Drop & Continue One Node and Drop & Continue 2 Switch
connection.
connProtType :=
{ legProtected | legNotProtected }
endLegType :=
opNapType :=
{keepNap | releaseNap }
PROTECTpath
userLabel <user_label>
<protCmd> <changeOpType>
endTpList
[[<ttp_to_prot>
<ttp_to_prot>]
[topologyLevel <topLevProt>]]
END
END
PROTECTpath
userLabel <user_label>
{ <unprCmd> <changeOpRes> <changeOpType> |
<remCmd> <changeOpType> }
endTpList
[[<ttp_to_prot>
<ttp_to_prot>]
[topologyLevel <topLevProt>]]
END
END
ADDLEGpath
userLabel <user_label>
ED
03
957.130.882 U
142 / 198
[[allocRule automaticallyAllocated
[<changeOpType>]
[protRequired <connProtType>]] |
[allocRule onUserRequest ]]
<endLegType>
END
REMOVELEGpath
userLabel <userLabel>
[<changeOpType>]
[<opNapType>]
nap <port_name>
END
COMMISSIONpath
userLabel <user_label>
END
UNCOMMISSIONpath
userLabel <user_label>
END
UPDALRpath
userLabel <user_label>
{<alrPropRule> |
pdhAlrEnabRule manual | pdhAlrEnabRule onImplementation | pdhAlrEnabRule onCommissioning |
sdhAlrEnabRule manual | sdhAlrEnabRule onImplementation | sdhAlrEnabRule onCommissioning }
END
N.B. The ttp_to_prot in PROTECTpath and UNPROTECTpath command have to be on the boundary of
a topology. If the topology level is not specified, the trail is protected into the upper topology level.
Regarding enhancedProtected paths, it is preferable to make these paths starting from SNCP protected
paths (protType=sh1Plus1EToEProt) and then to add the service connection with the proper
PROTECTpath command (see examples).
CONNECTpath
userLabel <user_label>
<changeOpType>
endTpList
ctp <port_name> payloadPos <string>
ctp <port_name> payloadPos <string>
END
END
DISCONNECTpath
userLabel <user_label>
endTpList
ctp <port_name> payloadPos <string>
ctp <port_name> payloadPos <string>
END
END
ED
03
957.130.882 U
143 / 198
ELEMALRMNGpath
userLabel <user_label>
{pdhElemAlr enable | pdhElemAlr disable |
sdhElemAlr enable | sdhElemAlr disable }
END
SPLITpath
userLabel <user_label>
operationalRule <opRule>
node <user_label>
END
JOINpath
userLabel <user_label1>
userLabel <user_label2>
operationalRule <opRule>
node <user_label>
END
ED
03
957.130.882 U
144 / 198
D.1.5.1Description
SETtrail:
it permits to set default values for attributes to be specified at the trail creation
(definition) time.
CREATEtrail:
CONSTRtrail:
ALLOCtrail:
DEALLOCtrail:
IMPLtrail:
DEIMPLtrail:
CONFIGtrail:
UPDATEtrail:
DELETEtrail:
PROTECTtrail:
SPLITtrail:
JOINtrail:
UPDALRtrail:
ELEMALRMNGtrail:
CONFIGUREMsTrail:
ED
03
957.130.882 U
145 / 198
D.1.5.2Syntax
{ trailType pointToPoint }
[ payloadStructure tu12Tu12Tu12 | payloadStructure tu12Tu12Tu3 |
payloadStructure tu12Tu3Tu12 | payloadStructure tu3Tu12Tu12 |
payloadStructure tu12Tu3Tu3
| payloadStructure tu3Tu12Tu3 |
payloadStructure tu3Tu3Tu12
| payloadStructure tu3Tu3Tu3
|
payloadStructure notTerminatedAu4 | payloadStructure notTerminatedAu3
payloadStructure tu12 | payloadStructure notMeaningful ]
|
protType sh1Plus1EToEProt | protType
[ protType notProtected
enhancedProtected]
[ msProtProfile normal | msProtProfile protPref]
{ flow bidirectional }
not_upd_trail_attributes:=[ sdhAlrEnabRule onImplementation | sdhAlrEnabRule onCommissioning |
sdhAlrEnabRule manual ]
trail_attributes:=
[ upd_trail_attributes | not_upd_trail_attributes ]
SETtrail
<trail_attributes>
END
ctp_list :=
node_list :=
node <node_name>
end_tp_list :=
{ <ctp_list> <ctp_list> |
<node_list> <node_list>}
CREATEtrail
userLabel <string>
[<trail_attributes>]
endTpList
<end_tp_list>
<end_tp_list>
END
END
ctp_constr_list :=
CONSTRtrail
userLabel <user_label>
[... <ctp_constr_list>]
END
ED
03
957.130.882 U
146 / 198
upd_trail_attributes :=
ALLOCtrail
userLabel <user_label>
END
DEALLOCtrail
userLabel <user_label>
END
IMPLtrail
userLabel <user_label>
END
DEIMPLtrail
userLabel <user_label>
END
CONFIGtrail
userLabel <user_label>
[ payloadStructure tu12Tu12Tu12 | payloadStructure tu12Tu12Tu3 |
payloadStructure tu12Tu3Tu12 | payloadStructure tu3Tu12Tu12 |
payloadStructure tu12Tu3Tu3
| payloadStructure tu3Tu12Tu3 |
payloadStructure tu3Tu3Tu12
| payloadStructure tu3Tu3Tu3
|
payloadStructure notTerminatedAu4 | payloadStructure terminatedAu4 |
payloadStructure notMeaningful payloadStructure notTerminatedAu3 | payloadStructure tu12]
END
DELETEtrail
userLabel <user_label>
END
UPDATEtrail
userLabel <user_label>
updList
[userLabel <user_label>]
[<upd_trail_attributes>]
END
END
changeOpRes :=
{ keepingMain | keepingSpare }
changeOpType :=
{ immediate | deferred }
ttp_to_prot :=
protCmd :=
{ protect | addEnhancedProt }
remCmd :=
{ removeEnhancedProt | removeEnhancedProtWithCheck }
unprCmd :=
{ unprotect | unprotectWithCheck }
PROTECTtrail
userLabel <user_label>
<protCmd> <changeOpType>
endTpList
[[<ttp_to_prot>
<ttp_to_prot>]
ED
03
957.130.882 U
147 / 198
PROTECTtrail
userLabel <user_label>
{ <unprCmd> <changeOpRes> <changeOpType> |
<remCmd> <changeOpType> }
endTpList
[[<ttp_to_prot>
<ttp_to_prot>]
[topologyLevel <topLev>]]
END
END
N.B. The ttp_to_prot in a PROTECTtrail command have to be on the boundary of a topology.
If the topology level is not specified, the trail is protected into the upper topology level.
Regarding enhancedProtected trails, it is preferable to make these trails starting from SNCP trails
(protType=sh1Plus1EToEProt) and then to add the service protection with the proper command.
opRule :=
{ user | automatic }
SPLITtrail
userLabel <user_label>
operationalRule <opRule>
node <user_label>
END
JOINtrail
userLabel <user_label1>
userLabel <user_label2>
operationalRule <opRule>
node <user_label>
END
UPDALRtrail
userLabel <user_label>
sdhAlrEnabRule manual | sdhAlrEnabRule onImplementation
END
ELEMALRMNGtrail
userLabel <user_label>
sdhElemAlr enable | sdhElemAlr disable
END
CONFIGUREmsTrail
userLabel <user_label>
Au4List
[ hoAu4 | hoAu4Conc4 | hoAu4Conc16 | hoAu4Conc64 ]
END
END
ED
03
957.130.882 U
148 / 198
[topologyLevel <topLev>]]
END
END
where:
xx = rack number,
y = subrack number,
zz = board number,
kk = port number,
jj = channel number (optional this component will be used only for transmux ports).
All the previous information can be retrieved by the identifier (FDN) of TSDIM objects.
For the other cases the port userlabel is done by SHWX systems.
D.1.7 CHOWN commands
These commands update the securityLabel of path, trail, nap and link connections.
D.1.7.1Syntax
objClass :=
CHOWNonObj <objClass>
userLabel
<user_label>
securityLabel <number>
END
CHOWNonObj lc
userLabel
<user_label> payloadPos <string>
securityLabel <number>
END
ED
03
957.130.882 U
149 / 198
D.1.8 PM commands
SET:
CREATE:
UPDATE:
It sets attribute values for one object of the same classes specified for CREATE.
DELETE:
CONSmeas:
CORRtransToMeas:
It correlates a termnation point object (nap, cap, ctp) to one or more measures.
CORRrepToMeas:
UNCORRrepToMeas:
CORRpmTpToTca:
UNCORRpmTpToTca:
ED
03
957.130.882 U
150 / 198
D.1.8.1Description
D.1.8.2Syntax
SET pmDomId <number>
END
pmLay :=
{ lo | ho | bothLoHo }
pmGran :=
{ pm24Hours | pm15Min }
pmCount :=
{ false | true }
defEnd :=
{ false | true }
<user_label>
<pmGran>
<pmCount>
<date> ]
<date> ]
<pmLay> ]
<boolean> ]
<user_label> ]
<pmGran> ]
<pmLay> ]
<pmCount> ]
<defEnd> ]
<date> ]
<date> ]
pmRepWin :=
ED
03
957.130.882 U
151 / 198
<user_label>
<pmGran>
<string>
<pmRepWin>
<pmRepDesType> ]
<number> ]
<number> ]
<number> ]
<number> ]
<number> ]
<number> ]
N.B. When one of the attributes which are not mandatory is not present in the above create request, its
value remains unspecified.
UPDATE CLASS tCRProfile
userLabel
<user_label>
updList
[ userLabel
<user_label> ]
[ pmReportDestType
<pmRepDesType>]
[ pmReportDestName
<string> ]
[ pmReportWindow
<pmRepWin> ]
[ pmThreBBE
<number> ]
[ pmThreES
<number> ]
[ pmThreSES
<number> ]
[ pmThreFEBBE
<number> ]
[ pmThreFEES
<number> ]
[ pmThreFESES
<number> ]
END
END
DELETE CLASS tCRProfile
userLabel
<user_label>
END
<user_label>
<string>
<pmRepWin>
<pmRepDesType>
ED
03
957.130.882 U
152 / 198
<user_label>
STOPmeas
userLabel
END
<user_label>
CONSmeas
userLabel
END
<user_label>
pathTrail :=
CORRtransToMeas
measureUserLabel
{ <pathTrail> } ...
END
UNCORRtransToMeas
{ measureUserLabel
<pathTrail>
END
Tp :=
ED
<user_label>
<user_label> } ...
03
957.130.882 U
153 / 198
CORRTpToMeas | UNCORRTpToMeas
{ measureUserLabel
<user_label> } ...
<Tp>
END
N.B. In the correlation case only measures with the same state can be specified.
Report :=
CORRrepToMeas | UNCORRrepToMeas
measureUserLabel
<user_label>
{ <Report> } ...
END
CORRpmTpToTca
measureUserLabel
<Tp>
{ tca <user_label> } ...
END
<user_label>
N.B. The pmTp involved in the correlation is identified by the measure it belongs to and by the Tp related
to it.
UNCORRpmTpToTca
measureUserLabel
<Tp>
END
DELETEpmTp
measureUserLabel
<Tp>
END
<user_label>
<user_label>
N.B. The pmTp to delete is identified by the measure it belongs to and by the Tp related to it.
DELETEpmTransp
measureUserLabel
<pathTrail>
END
<user_label>
N.B. In DELETEpmTransp <pathTrail> specifies the userLabel of the pmTransport object. If the
pmTransport is a pathimage the pathUserLabel token is used while if it is a trailimage the trailUserLabel
is used instead. Note that a pmTransport is created with the same userLabel of the corresponding
path/trail.
ED
03
957.130.882 U
154 / 198
D.1.9.1 Description
Objects of class aSAProfile can be handled with the following commands:
CREATE:
UPDATE:
DELETE:
CORRtoaSAProfile
one object of class aSAProfile is bound with objects of class path, trail and
physical connection.
D.1.9.2 Syntax
AlarmSevCode:=
<user_label>
<AlarmSevCode> ]
<AlarmSevCode> ]
<AlarmSevCode> ]
<AlarmSevCode> ]
<AlarmSevCode> ]
<AlarmSevCode> ]
<AlarmSevCode> ]
<AlarmSevCode> ]
<AlarmSevCode> ]
<AlarmSevCode> ]
In making the just above specified create request the optional attributes have default values as follows:
mediaEqFail major, underProtDegr warning, rSFailure major, exBer major, confMismatch major,
sdhFailure major, pdhFailure warning, qualityTC15 and qualityTC24 minor.
DELETE CLASS aSAProfile
userLabel
END
asapClasses:=
objectUserLabel:= userLabel
toBindObject:=
<user_label>
CLASS asapClasses
{ objectUserLabel }.....
END
CORRtoaSAProfile
userLabel
{ toBindObject }.....
END
ED
<user_label>
<user_label>
03
957.130.882 U
155 / 198
Objects of class restoration Rule can be handled with the following commands:
SET:
set the working restoration domain that is the restoration domain which all the
subsequent commands related to object of class restoration Rule will be sent
to;
CREATE:
UPDATE:
DELETE:
ACT_UPDATE:
change the attribute restState for one object of class path or trail.
ED
03
957.130.882 U
156 / 198
D.1.10.1Description
D.1.10.2Syntax
SET restDomId <number>
END
ObjRestClass:=
{ path | trail }
RestorationStrategy:=
{ optimizedAddProt | eToEAddProt }
AllocationConstraint:=
{ notAlarmedResourcesOnly | noRestriction }
ConstrRule:=
{ dontUseConstraints | useDefConstraints }
<user_label>
<ObjRestClass>
<RestorationStrategy> ]
<number> ]
<AllocationConstraint> ]
<ConstrRule> ]
<user_label>
<ObjRestClass>
<RestorationStrategy> ]
<number> ]
<AllocationConstraint> ]
<ConstrRule> ]
<user_label>
<ObjRestClass>
N.B. In the above CREATE, UPDATE and DELETE the object of class restoration rule is identified via the
user label and the the class of the object related.
ED
03
957.130.882 U
157 / 198
Comments can be specified in a line of the command file beginning with the symbol !. Comments are
delimited with a new line character.
D.1.12 Sleep command
D.1.12.1Description
The execution of the SLEEP command permits the program to wait for a specified number of seconds
between two commands.
D.1.12.2Syntax
SLEEP <number>
D.1.13 Setting timeout
D.1.13.1Description
This commands sets the timeout (number of seconds) of CI messages (get and actions).
D.1.13.2Syntax
SETtimeout <number> END
D.1.14 Exit command
D.1.14.1Description
This command stops the utility and shows final statistics (useful when the utility is running with f option).
D.1.14.2Syntax
EXIT
ED
03
957.130.882 U
158 / 198
D.1.11 Comments
D.1.15.1Description
IMPLconn:
conn_tp_list:= { <tp>
<tp>
[tp]
[tp] }
topolevel:=
N.B.
ctpctp
napctp
ctpnap
capctp
ctpcap
capcap
napnap
ctpctpctp
napctpctp
ctpctpnap
capcapcap
capctpctp
ctpctpctpctp
capctpctpctp
ctpcapctpctp
ctpctpcapctp
ctpctpctpcap
napctpctpctp
ctpnapctpctp
ctpctpnapctp
ctpctpctpnap
IMPLconn
topologyLevel <topolevel>
endTpList
<conn_tp_list>
END
END
ED
03
957.130.882 U
159 / 198
N.B.
ED
Now those function can be used only at node level.
957.130.882 U
All rights reserved. Passing on and copying of this
document, use and communication of its contents
not permitted without written authorization from Alcatel.
DEIMPLconn
topologyLevel <topolevel>
endTpList
<conn_tp_list>
END
END
03
198
160 / 198
D.1.16.1Description
CREATEntw:
CREATEsbn:
CREATEet:
CREATEnode:
REMOVE sbn:
REMOVE et:
it implement a network.
IMPL sbn:
it implement a subnetwork.
IMPL et:
it deimplement a network.
DEIMPL sbn:
it deimplement a subnetwork.
DEIMPL et:
OBJECTconnection:
ED
03
957.130.882 U
161 / 198
etType_set:=
stmType_set:=
CREATEntw
userLabel
mapId
userId
[comment1
[comment2
END
<user_label>
<integer>
<string>
<string> ]
<string> ]
CREATEsbn
userLabel
includedIn
userId
[comment1
[comment2
END
<user_label>
ntw <user_label>
<string>
<string> ]
<string> ]
CREATEet
userLabel
includedIn
userId
etType
stmType
fiberNum
globalCfg
[comment1
[comment2
END
<user_label>
sbn <user_label>
<string>
<etType_set>
<stmType_set>
<integer>
<True | False>
<string> ]
<string> ]
CREATEnode
userLabel
includedIn
userId
neUserLabel
[seqNumInEt
[nodeInEt
[comment1
[comment2
END
ED
D.1.16.2Syntax
<user_label>
<sbn | et> <user_label>
<string>
<user_label>
<integer>]
<integer>]
<string> ]
<string> ]
03
957.130.882 U
162 / 198
CREATE physicalConnection
userLabel
userId
aSDHPort
zSDHPort
END
<user_label>
<string>
<user_label>
<user_label>
REMOVE ntw
userLabel
END
<user_label>
REMOVE sbn
userLabel
END
<user_label>
REMOVE et
userLabel
END
<user_label>
REMOVE physicalConnection
userLabel
<user_label>
END
Update et
userLabel<label>
globalCfg <True |False>
END
SPLITphysicalConnection
reqType
userLabelPhyConnToSplit
userLabelFirstPhyConn
userLabelOldFirstPort
userLabelNewFirstPort
userLabelSecondPhyConn
userLabelOldSecondPort
userLabelNewSecondPort
<split_phyConn_attr>
END
ED
<splitType>
<user_label>
<user_label>
<user_label>
<user_label>
<user_label>
<user_label>
<user_label>
03
957.130.882 U
163 / 198
OBJECTconnection
actionType
connectMode
{ physicalConnection
END
ED
<joinType>
<user_label>
<user_label>
<user_label>
JOINphysicalConnection
reqType
userLabelFirstPhyConn
userLabelSecondPhyConn
userLabelNewPhyConn
<join_phyConn_attr>
END
<actionConnection>
<modeConnection>
<user_label> }........
03
957.130.882 U
164 / 198
D.1.17.1Description
UPLOADnap: it perform the naps upload in topology level defined.
REMOVEnap: it remove all naps in topology level defined or remove a single nap defined with portname.
D.1.17.2Syntax
UPLOADnap <ntw | sbn | et | node>
userLabel
<user_label>
END
REMOVEnap <nap>
portName
END
<string>
ED
03
957.130.882 U
165 / 198
In this case, the tool only stops the execution of the commands if the wrong attribute value is specified in
SET, SETpath, SETtrail commands, otherwise the command is skipped and the tool execution goes on,
unless the utility is running with stop option on.
ED
03
957.130.882 U
166 / 198
The tool for executing command files accepts some input parameters:
D.3 Examples
VADM_16
VADM_38
VADM_15
Adm2
RING STM1
Adm5
X_27
VADM_18
NE_V1
VADM_37
VADM_17
X_26
VADM_34
RING STM16
VADM_4
VADM_2
VADM_3
ADM_1
VADM_5
VADM_11
Adm8
VADM_19
RING STM4
VADM_33
Adm7
In the following three examples it is supposed to have the Network showed at figure 5. NE_V1 is a virtual
NE, while all the others ADM are real NE.
ED
03
957.130.882 U
167 / 198
In this example a simple bidirectional 2Mb path between ADM_1 and VADM_2 is created, allocated (by
using constraints) and imlemented.
! ## DATE ## 14/12/98 15:05:16
SETpath
allocRule user
implRule user
allocationConstraint noRestriction
END
SET ntwId 1 END
CREATEpath
userLabel ADM001VADM_32M9
pathType bidirectionalPtoPto
pathRate lo2Mb
protType notProtected
allAlgType automatic
userId snmlr21
pmAutomatic false
alarmPropRule whenImplemented
endTpList
nap ADM_1/2M/109 usedDir bidirectional
nap VADM_3/2M06 usedDir bidirectional
END
END
!
!It is not necessary to define all the constraints.
!If the constaints are not defined, the routing algorithm
!will choose a route for you.
!However, the routing algorithm will use all the constraints
!related to the path when an allocation/addremove leg/
!addremove protection is executed
!
ED
03
957.130.882 U
168 / 198
CONSTRpath
userLabel ADM001VADM_32M9
ctp ADM_1/West payloadPos 01/1/5.2 constrainType useMain
ctp VADM_3/STM12 payloadPos 01/1/5.2 constrainType useMain
END
ALLOCpath
userLabel ADM001VADM_32M9
END
!
! It is not necessary to remove all the constraints
! related to the path.
! If you dont delete them, the constraints will be used for the
! next allocation phase
!
!
CONSTRpath
userLabel ADM001VADM_32M9
END
IMPLpath
userLabel ADM001VADM_32M9
END
CONNECTpath
userLabel ADM001VADM_32M9
immediate
endTpList
ctp ADM_1/2M/109 payloadPos 03/1.1/1
ctp VADM_3/2M06 payloadPos 03/1.1/1
END
END
DISCONNECTpath
userLabel ADM001VADM_32M9
endTpList
ctp ADM_1/2M/109 payloadPos 03/1.1/1
ctp VADM_3/2M06 payloadPos 03/1.1/1
END
END
ED
03
957.130.882 U
169 / 198
1) the unprotected path is implemented between Adm7 and Adm2. The path route is forced by using TP
constraints; the route is Adm2Adm5VADM_2VADM_3Adm8Adm7;
2) the path is SNCP protected. The spare path route is forced by using TP constraints; the spare route
is Adm2VADM_16VADM_15VADM_38VADM_34VADM_4VADM_5VADM_33Adm7; SNCP
connections are created on Adm2 and Adm7;
3) the path is enhanced protected in RING STM1 and RING STM4. The service path routes are forced
by using TP constraints. The first service route is Adm5VADM_17VADM_18VADM_15. Drop &
continue connections are created on Adm5 and VADM_15. The second service route is
Adm8VADM_11VADM_19VADM_33. Drop & continue connections are created on Adm8 and
VADM_33.
! ## DATE ## 30/09/97 09:04:19
!
! path enhanced protected
!
SETpath
allocRule user
implRule user
allocationConstraint noRestriction
END
ED
03
957.130.882 U
170 / 198
ED
03
957.130.882 U
171 / 198
! the allocation of second spare route is executed with the following command
!
PROTECTpath
userLabel Adm7Adm22M15
addEnhancedProt deferred
endTpList
ctp Adm5/stm1 payloadPos 01/1/1.2
ctp VADM_15/STM11 payloadPos 01/1/1.2
topologyLevel et
END
END
CONSTRpath
userLabel Adm7Adm22M15
ctp Adm8/West payloadPos 01/1/2.2 constrainType useService
! ctp VADM_11/East payloadPos 01/1/2.2
ctp VADM_11/West payloadPos 01/1/3.3 constrainType useService
! ctp VADM_19/East payloadPos 01/1/3.3
ctp VADM_19/West payloadPos 01/1/3.3 constrainType useService
! ctp VADM_33/East payloadPos 01/1/3.3
END
PROTECTpath
userLabel Adm7Adm22M15
addEnhancedProt deferred
endTpList
ctp Adm8/stm1 payloadPos 01/1/7.2
ctp VADM_33/STM13 payloadPos 01/1/1.3
topologyLevel et
END
END
CONSTRpath
userLabel Adm7Adm22M15
END
ED
03
957.130.882 U
172 / 198
ED
03
957.130.882 U
173 / 198
ED
03
957.130.882 U
174 / 198
VADM_15
Adm2
RING STM1
Adm5
VADM_18
VADM_17
ED
03
957.130.882 U
175 / 198
CONSTRpath
userLabel circular1
ctp VADM_17/West payloadPos 01/1/1.1 constrainType useMain
ctp VADM_18/East payloadPos 01/1/1.1 constrainType useMain
ctp VADM_18/West payloadPos 01/1/1.1 constrainType useMain
ctp VADM_15/East payloadPos 01/1/1.1 constrainType useMain
ctp VADM_15/West payloadPos 01/1/1.1 constrainType useMain
ctp VADM_16/East payloadPos 01/1/1.1 constrainType useMain
ctp VADM_16/West payloadPos 01/1/1.1 constrainType useMain
ctp Adm2/East payloadPos 01/1/1.1 constrainType useMain
ctp Adm2/West payloadPos 01/1/1.1 constrainType useMain
ctp Adm5/East payloadPos 01/1/1.1 constrainType useMain
ctp Adm5/West payloadPos 01/1/1.1 constrainType useMain
ctp VADM_17/East payloadPos 01/1/1.1 constrainType useMain
END
ALLOCpath
userLabel circular1
END
!
! Leg2
! nap Adm2/port2M101 is added to the path
!
ADDLEGpath
userLabel circular1
allocRule onUserRequest
nap Adm2/port2M101
END
CONSTRpath
userLabel circular1
ctp VADM_17/East payloadPos 01/1/1.1 constrainType useMain
ctp Adm5/West payloadPos 01/1/1.1 constrainType useMain
ctp Adm5/East payloadPos 01/1/1.1 constrainType useMain
ctp Adm2/West payloadPos 01/1/1.1 constrainType useMain
END
!
! Leg2 is allocated after the following command. A broadcast connection is created on node VADM_17
!
ED
03
957.130.882 U
176 / 198
! Leg1
!
CREATEpath
userLabel circular1
pathType unidirectionalPtoPto
pathRate lo2Mb
protType notProtected
alarmPropRule whenCommissioned
allAlgType automatic
userId lts4182/snmlr23
pmAutomatic false
endTpList
nap VADM_17/2M101 usedDir source
nap VADM_17/2M102 usedDir sink
END
END
ADDLEGpath
userLabel circular1
allocRule automaticallyAllocated
deferred
nap Adm2/port2M101
END
CONSTRpath
userLabel circular1
ctp VADM_17/West payloadPos 01/1/1.1 constrainType useSpare
ctp VADM_18/East payloadPos 01/1/1.1 constrainType useSpare
ctp VADM_18/West payloadPos 01/1/1.1 constrainType useSpare
ctp VADM_15/East payloadPos 01/1/1.1 constrainType useSpare
ctp VADM_15/West payloadPos 01/1/1.1 constrainType useSpare
ctp VADM_16/East payloadPos 01/1/1.1 constrainType useSpare
ctp VADM_16/West payloadPos 01/1/1.1 constrainType useSpare
ctp Adm2/East payloadPos 01/1/1.1 constrainType useSpare
END
!
! Leg2 is protected
!
PROTECTpath
userLabel circular1
protect deferred
endTpList
nap VADM_17/2M101
nap Adm2/port2M101
topologyLevel ntw
END
END
!
! Leg3
! nap Adm5/port2M101 is added to the path
!
ADDLEGpath
userLabel circular1
allocRule onUserRequest
nap Adm5/port2M101
END
CONSTRpath
userLabel circular1
ctp VADM_17/East payloadPos 01/1/1.1 constrainType useMain
ctp Adm5/West payloadPos 01/1/1.1 constrainType useMain
END
!
! Leg3 is allocated after the following command. A leg is added on the broadcast connection on node
VADM_17
!
ADDLEGpath
userLabel circular1
allocRule automaticallyAllocated
deferred
nap Adm5/port2M101
END
CONSTRpath
ED
03
957.130.882 U
177 / 198
ED
03
957.130.882 U
178 / 198
userLabel circular1
ctp VADM_17/West payloadPos 01/1/1.1 constrainType useSpare
ctp VADM_18/East payloadPos 01/1/1.1 constrainType useSpare
ctp VADM_18/West payloadPos 01/1/1.1 constrainType useSpare
ctp VADM_15/East payloadPos 01/1/1.1 constrainType useSpare
ctp VADM_15/West payloadPos 01/1/1.1 constrainType useSpare
ctp VADM_16/East payloadPos 01/1/1.1 constrainType useSpare
ctp VADM_16/West payloadPos 01/1/1.1 constrainType useSpare
ctp Adm2/East payloadPos 01/1/1.1 constrainType useSpare
ctp Adm2/West payloadPos 01/1/1.1 constrainType useSpare
ctp Adm5/East payloadPos 01/1/1.1 constrainType useSpare
END
!
! Leg3 is protected
!
PROTECTpath
userLabel circular1
protect deferred
endTpList
nap VADM_17/2M101
nap Adm5/port2M101
topologyLevel ntw
END
END
!
! Leg4
! nap VADM_15/2M101 is added to the path
!
ADDLEGpath
userLabel circular1
allocRule onUserRequest
nap VADM_15/2M101
END
CONSTRpath
userLabel circular1
ctp VADM_17/West payloadPos 01/1/1.1 constrainType useMain
ctp VADM_18/East payloadPos 01/1/1.1 constrainType useMain
ctp VADM_18/West payloadPos 01/1/1.1 constrainType useMain
ctp VADM_15/East payloadPos 01/1/1.1 constrainType useMain
END
!
! Leg4 is allocated after the following command. A leg is added on the broadcast connection on node
VADM_17
!
ADDLEGpath
userLabel circular1
allocRule automaticallyAllocated
deferred
nap VADM_15/2M101
END
CONSTRpath
userLabel circular1
ctp VADM_17/East payloadPos 01/1/1.1 constrainType useSpare
ctp Adm5/West payloadPos 01/1/1.1 constrainType useSpare
ED
03
957.130.882 U
179 / 198
ED
03
957.130.882 U
180 / 198
PROTECTpath
userLabel circular1
protect deferred
endTpList
nap VADM_17/2M101
nap VADM_18/2M101
topologyLevel ntw
END
END
CONSTRpath
userLabel circular1
END
SPLITpath
userLabel ADM001VADM_32M9
operationalRule automatic
node ADM0001
END
JOINpath
userLabel ADM001VADM_32M9
userLabel ADM0004
operationalRule automatic
node ADM0001
END
ED
03
957.130.882 U
181 / 198
VADM_40
VADM_41
VADM_42
RING STM16
VADM_39
E VADM_11
VADM_19
W
RING STM4
Adm8
Adm7
VADM_33
VADM_29
ED
03
957.130.882 U
182 / 198
END
CONSTRtrail
userLabel trail829/1
ctp VADM_29/West payloadPos 02 constrainType useMain
ctp Adm7/East payloadPos 02 constrainType useMain
ctp Adm7/West payloadPos 02 constrainType useMain
ctp Adm8/East payloadPos 02 constrainType useMain
END
ALLOCtrail
userLabel trail829/1
END
CONSTRtrail
userLabel trail829/1
END
IMPLtrail
userLabel trail829/1
END
!
!Trail 1 is LO configured
!
CONFIGtrail
userLabel trail829/1
payloadStructure tu12Tu12Tu3
END
!
!Trail 2
!
CREATEtrail
userLabel trail829/2
trailType pointToPoint
flow bidirectional
protType notProtected
endTpList
ctp Adm8/West payloadPos 02
ctp VADM_29/East payloadPos 02
END
END
CONSTRtrail
userLabel trail829/2
ctp Adm8/West payloadPos 02 constrainType useMain
ctp VADM_11/East payloadPos 02 constrainType useMain
ctp VADM_11/West payloadPos 02 constrainType useMain
ctp VADM_19/East payloadPos 02 constrainType useMain
ctp VADM_19/West payloadPos 02 constrainType useMain
ctp VADM_33/East payloadPos 02 constrainType useMain
ctp VADM_33/West payloadPos 02 constrainType useMain
ctp VADM_29/East payloadPos 02 constrainType useMain
END
ALLOCtrail
userLabel trail829/2
END
CONSTRtrail
userLabel trail829/2
END
ED
03
957.130.882 U
183 / 198
ED
IMPLtrail
userLabel trail829/2
END
!
!Trail 2 is LO configured
!
CONFIGtrail
userLabel trail829/2
payloadStructure tu12Tu12Tu3
END
!
!Trail 3
!
CREATEtrail
userLabel trailprot
trailType pointToPoint
flow bidirectional
protType notProtected
endTpList
ctp VADM_41/East payloadPos 01
ctp VADM_42/West payloadPos 01
END
END
CONSTRtrail
userLabel trailprot
ctp VADM_41/East payloadPos 01
ctp VADM_40/West payloadPos 01
ctp VADM_40/East payloadPos 01
ctp VADM_42/West payloadPos 01
END
ALLOCtrail
userLabel trailprot
END
!
!Trail 3 is SNCP protected
!
CONSTRtrail
userLabel trailprot
ctp VADM_41/West payloadPos 01
ctp VADM_39/East payloadPos 01
ctp VADM_39/West payloadPos 01
ctp VADM_42/East payloadPos 01
END
PROTECTtrail
userLabel trailprot
protect deferred
endTpList
cap VADM_41/East payloadPos 01
cap VADM_42/West payloadPos 01
topologyLevel ntw
END
END
CONSTRtrail
userLabel trailprot
constrainType useMain
constrainType useMain
constrainType useMain
constrainType useMain
constrainType useSpare
constrainType useSpare
constrainType useSpare
constrainType useSpare
03
957.130.882 U
184 / 198
END
IMPLtrail
userLabel trailprot
END
!
!Trail 3 is LO configured
!
CONFIGtrail
userLabel trailprot
payloadStructure tu12Tu12Tu3
END
SPLITtrail
userLabel ADM001VADM_32M9
operationalRule automatic
node ADM0001
END
JOINtrail
userLabel ADM001VADM_32M9
userLabel ADM0004
operationalRule automatic
node ADM0001
END
CONFIGUREmsTrail
userLabel MSTRAILTOTEST
Au4List
hoAu4Conc4 4
END
END
ED
03
957.130.882 U
185 / 198
In this example it is supposed to have the three trails created in the previous example.An SNCP path is
implemented by using the trails.
The end points of the path are located on VADM_29 and VADM42.
SETpath
allocRule user
implRule user
allocationConstraint noRestriction
END
SET ntwId 3 END
!
!First unprotected path is created
!
CREATEpath
userLabel testmig
pathType bidirectionalPtoPto
pathRate lo2Mb
protType notProtected
alarmPropRule whenImplemented
allAlgType automatic
userId lts4182/snmlr23
pmAutomatic false
endTpList
nap VADM_29/2M01 usedDir bidirectional
nap VADM42/2M1 usedDir bidirectional
END
END
!
!The path uses the trail trail829/1.
!Please note that is not necessary to define the TP on node Adm7, because this TP belongs to the trail.
!
CONSTRpath
userLabel testmig
ctp VADM_29/West payloadPos 02/1/1.1 constrainType useMain
ctp Adm8/East payloadPos 02/1/1.1 constrainType useMain
ctp Adm8/stm1 payloadPos 01/1/1.1 constrainType useMain
ctp VADM_41/STM11 payloadPos 01/1/1.1 constrainType useMain
ctp VADM_41/East payloadPos 01/1/1.1 constrainType useMain
ctp VADM_42/West payloadPos 01/1/1.1 constrainType useMain
END
ALLOCpath
userLabel testmig
END
!
!The path is SNCP protected.
!The spare route uses the other two trails of the previous example.
!
CONSTRpath
userLabel testmig
ctp VADM_29/East payloadPos 02/1/1.1 constrainType useSpare
ctp Adm8/West payloadPos 02/1/1.1 constrainType useSpare
ED
03
957.130.882 U
186 / 198
ED
03
957.130.882 U
187 / 198
Measure_1
Measure_1
A performance measure aim is to describe the quality of service offered by a path or a trail, so therefore
once created, to reach its goal a measure must be correlated to a path or a trail. A correlation request can
be submitted as follows:
CORRtransToMeas
measureUserLabel
pathUserLabel
END
Measure_1
ADM_1ADM_39
Note that the end termination points of the object correlated will result automatically under measure if
attribute defaultEnd was set to true when creating the measure.
In order to have a more detailed monitoring of a path (trail) performances it is possible to correlate
some other path or trail termination points to the measure. This can be done with:
CORRTpToMeas
measureUserLabel
nap
END
Measure_1
ADM_104
As a measure has been bound to path, trail and their termination points so that relation can be broken using
commands UNCORR transToMeas and UNCORRTpToMeas.
Performance counters values can be reported via mail, printer or file. Doing that is achieved first creating
a new object of class pmCountRep and then correlating it to one measure. Next commands show how get
trough this job.
ED
03
957.130.882 U
188 / 198
CountRep_1
file
/tmp/rep_1.tmp
day
CORRrepToMeas
measureUserLabel Measure_1
countRep
CountRep_1
END
Performance counters values can be checked against their overflowing a userselected edge and results
of this test can be sent by means of mail, printer or file as with showed just above.
Steps to take creating an object of class tCRProfile and, after that, establishing a liaison between this
object and a measure.
CREATE CLASS tCRProfile
userLabel
Tcr_1
pmGranularity
pm15Min
pmReportDestType mail
pmRepDestName /tmp/tcr_1.tmp
pmReportWindow hour
pmThreBBE
10
pmThreES
10
END
CORRrepToMeas
userLabel
tcr
END
Measure_1
Tcr_1
CORRpmTpToTca
measureUserLabel Measure_1
nap
ADM_104
tca
Tca_1
END
ED
03
957.130.882 U
189 / 198
Object of class aSAProfile can be created and associated to some other objects of class path, trail and
physicalConn to stress, in some way, the importance of the alarms these objects show up.
Here after a simple example give some hints.
ED
03
957.130.882 U
190 / 198
500
Related to objects of class restoration rule there may be the need to change the attribute restState value
for object of class path or trail.
ED
03
957.130.882 U
191 / 198
IMPLconn
topologyLevel node
endTpList
cap ADM5/West payloadPos 01 tpRole XMIT RCV
cap VADM_17/East payloadPos 01 tpRole XMIT RCV
END
END
DEIMPLconn
topologyLevel node
endTpList
cap ADM5/West payloadPos 01 tpRole XMIT RCV
cap VADM_17/East payloadPos 01 tpRole XMIT RCV
END
END
ED
03
957.130.882 U
192 / 198
CREATEsbn
includedIn ntw ntw1
userLabel sbn1
userId snml1
comment1 Test to create a subnetwork
comment2 Test passed
END
CREATEet
includedIn sbn sbn1
userLabel et1
userId snml1
etType genericRing
stmType stm1
fiberNum 2
globalCfg True
comment1 Test to create a network
comment2 Test passed
END
CREATEnode
includedIn sbn sbn1
neUserLabel ne1
userLabel node1
userId snml1
comment1 Test to create a network
comment2 Test passed
seqNumInEt 2
nodeInEt 3
END
CREATE physicalConnection
userLabel phyConn1
userId snml1
aSDHPort portWest1
zSDHPort portEast1
END
N.B.
ED
03
957.130.882 U
193 / 198
REMOVE ntw
userLabel ntw1
END
REMOVE sbn
userLabel sbn1
END
REMOVE et
userLabel et1
END
REMOVE physicalConnection
userLabel physicalConnection1
END
IMPL ntw
userLabel ntw1
END
IMPL sbn
userLabel sbn1
END
IMPL et
userLabel et1
END
IMPL physicalConnection
userLabel physicalConnection1
END
DEIMPL ntw
userLabel ntw1
END
DEIMPL sbn
userLabel sbn1
END
DEIMPL et
userLabel et1
END
ED
03
957.130.882 U
194 / 198
DEIMPL physicalConnection
userLabel physicalConnection1
END
Update et
userLabel STM1
globalCfg True
END
SPLITphysicalConnection
reqType undoSplit
userLabelPhyConnToSplit Phy_Conn_Split
userLabelFirstPhyConn Phy_Conn_1
userLabelOldFirstPort Old_Port_1
userLabelNewFirstPort New_Port_1
userLabelSecondPhyConn Phy_Conn_2
userLabelOldSecondPort Old_Port_2
userLabelNewSecondPort New_Port_2
END
SPLITphysicalConnection
reqType split
userLabelPhyConnToSplit Phy_Conn_Split
userLabelFirstPhyConn Phy_Conn_1
userLabelOldFirstPort Old_Port_1
userLabelNewFirstPort New_Port_1
userLabelSecondPhyConn Phy_Conn_2
userLabelOldSecondPort Old_Port_2
userLabelNewSecondPort New_Port_2
userLabelPhyConnToSplit4f Phy_Conn_Split_4f
userLabelFirstPhyConn4f Phy_Conn_1_4f
userLabelOldFirstPort4f Old_Port_1_4f
userLabelNewFirstPort4f New_Port_1_4f
userLabelSecondPhyConn4f Phy_Conn_2_4f
userLabelOldSecondPort4f Old_Port_2_4f
userLabelNewSecondPort4f New_Port_2_4f
END
N.B.
JOINphysicalConnection
reqType undoJoin
userLabelFirstPhyConn Phy_Conn_1
userLabelSecondPhyConn Phy_Conn_2
userLabelNewPhyConn New_Phy_Conn
END
ED
03
957.130.882 U
195 / 198
N.B.
JOINphysicalConnection
reqType join
userLabelFirstPhyConn Phy_Conn_1
userLabelSecondPhyConn Phy_Conn_2
userLabelNewPhyConn New_Phy_Conn
userLabelFirstPhyConn4f Phy_Conn_14f
userLabelSecondPhyConn4f Phy_Conn_24f
userLabelNewPhyConn4f New_Phy_Conn4f
END
This syntax is used only in 4 fiber physical connection.
OBJECTconnection
actionType connect
connectMode immediate
physicalConnection Phy_Conn_To_Connect
END
ED
03
957.130.882 U
196 / 198
UPLOADnap sbn
userLabel sbn1
END
UPLOADnap et
userLabel et1
END
UPLOADnap node
userLabel ntw1
END
REMOVEnap ntw
userLabel ntw1
END
REMOVEnap sbn
userLabel sbn1
END
REMOVEnap et
userLabel et1
END
REMOVEnap node
userLabel node1
END
REMOVEnap nap
portName port_name_1
END
ED
03
957.130.882 U
197 / 198
CONFIGURE et
userLabel et1
payloadStructureList
vc3Num 0
vc4Num 4
vc12Num 0
payloadStructureListEND
END
CONFIGURE physicalConnection
userLabel physicalConnection1
payloadStructureList
vc3Num 0
vc4Num 4
vc12Num 0
payloadStructureListEND
END
END OF DOCUMENT
ED
03
957.130.882 U
198 / 198