summaryrefslogtreecommitdiff
path: root/MIBS/siae/SIAE-PMFTP-MIB
blob: 6d0297528fd65ce4f40de1a171a8bc105a95d585 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
-- ----------------------------------------------------------------------------
--
--  SIAE MICROELETTRONICA s.p.a.
--                 
--  Via Michelangelo Buonarroti, 21
--  20093 - Cologno Monzese
--  Milano 
--  ITALY
--
-- ----------------------------------------------------------------------------
-- ----------------------------------------------------------------------------

SIAE-PMFTP-MIB
        DEFINITIONS ::= BEGIN

        IMPORTS
             MODULE-IDENTITY, NOTIFICATION-TYPE, OBJECT-TYPE,
             Integer32
        FROM SNMPv2-SMI
             DisplayString
        FROM SNMPv2-TC
             OwnerString
        FROM RMON-MIB
             siaeMib
        FROM SIAE-TREE-MIB
             equipIpSnmpAgentAddress
        FROM SIAE-EQUIP-MIB
             alarmTrap
        FROM SIAE-ALARM-MIB
             accessControlLoginIpAddress
        FROM SIAE-USER-MIB;

    pmFTP MODULE-IDENTITY
        LAST-UPDATED "201503230000Z"
        ORGANIZATION "SIAE MICROELETTRONICA spa"
        CONTACT-INFO
            "SIAE MICROELETTONICA s.p.a.
             Via Michelangelo Buonarroti, 21
             20093 - Cologno Monzese
             Milano - ITALY
             Phone :  +39-02-27325-1
             E-mail: help@siaemic.com
            "
        DESCRIPTION
            "Transfer of data gathered by Performance Monitoring and RMON 
             to managers through the FTP protocol.
             "
        REVISION "201503230000Z"
        DESCRIPTION
            "Removed alarmTrapNumber from pmFTPStatusTrap and IMPORTS.
            "
        REVISION "201409290000Z"
        DESCRIPTION
            "MIB 01.00.01
             - Added enumerator readInterval(7) to pmFTPActionRequest
             - Added pmFTPBeginInterval and pmFTPEndInterval
             - changed SYNTAX of pmFTPTpRmonOwner from INTEGER to OwnerString.
            "
        REVISION "201402030000Z"
        DESCRIPTION
            "Improved description of pmFTPMibVersion
            "
        REVISION "201304160000Z"
        DESCRIPTION 
            "Initial version 01.00.00
            "
    ::= { siaeMib 31 }

--------------------------------------------------------------------------------
--  object identifier inside the module
--------------------------------------------------------------------------------


--------------------------------------------------------------------------------
--  pmFTP (File PM Data Read) Group
--------------------------------------------------------------------------------
--
--  This group is used to read P.M. data through a file transfer (FTP)
--  It is common to all Performance Monitoring group and RMON.
--  For each Performance Monitoring group (and RMON) and for each Termination
--  point (TP class) two file are generated: one concerning the day before and
--  one concerning the current day.
--
--  Through the objects of this group it is possible to read each file.
--  After transfering, local files are deleted.
--
--  To avoid concurrency, values set are internally collected per user and IP
--  address. So, to ensure a successful transfer, manager needs to set 
--  pmFTPfileName, pmFTPObject and pmFTPActionRequest (optionally also
--  pmFTPBeginInterval, pmFTPEndInterval and pmFTPTpRmonOwner). These object
--  can be  set sending more SNMP SET packets.
--------------------------------------------------------------------------------

------ Beginning --------------------------------------------------------------

    pmFTPMibVersion  OBJECT-TYPE
        SYNTAX      INTEGER
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "Numerical version of this module.
             The string version of this MIB have the following format:
                XX.YY.ZZ
             so, for example, the value 1 should be interpreted as 00.00.01
             and the value 10001 should be interpreted as 01.00.01."
        DEFVAL {1}
    ::= {pmFTP 1}

    pmFTPfileName OBJECT-TYPE
        SYNTAX      DisplayString   (SIZE(0..255))
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "Path and file name used when the PM data file is transferred
             using Ftp (action = read).
             The Agent software concatenates the following fields to the display
             string set in this object:
              1) groupName: it identifies the name of the P.M. mib group
              2) tpClassName: it identifies the termination point
              3) index: only for RMON data
              4) date: YYMMDD
             As example: when the string set is equal to /pub/pm/G828/alcplus
             The name of the file transfered to the defined directory is:
             alcplus_pmRxPwr_Radio1_081015.csv."
    ::= {pmFTP 2}

    pmFTPTpClass   OBJECT-TYPE
        SYNTAX      OBJECT IDENTIFIER
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "Object identifier of the first leaf of the record selected 
             to transfer. To read all rows of a table, this object should be
             set with the object identifier of the table entry.
             The SET of the value {0 0} is accepted and means that no record
             is selected.
            "
--        DEFVAL {0 0}
    ::= {pmFTP 3}

    pmFTPTpRmonOwner  OBJECT-TYPE
        SYNTAX      OwnerString
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "For PM is meaningless.
             For RMON it corresponds to historyControlOwner of
             historyControlTable and it cannot be null.
             If pmFTPTpClass is set in order to read all rows of RMON history,
             this object is used to select rows belonging to selected owner.
            "
        DEFVAL {""}
    ::= {pmFTP 4}

    pmFTPActionRequest  OBJECT-TYPE
        SYNTAX      INTEGER {
                             none                (0),
                             dayBeforeRead       (1),
                             currentDayRead      (3),
                             readAll             (5),
                             readAbort           (6),
                             readInterval        (7)
                            }
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "Action requested to the equipment:
              - none          : no action required;
              - dayBeforeRead : for the selected PM or RMON group according to
                                the selected TpClass a file with record of 
                                previous day is sent to the manager;
              - currentDayRead: for the selected PM or RMON group according to
                                the selected TpClass a file with records of
                                the current day is sent to the manager;
              - readAll       : for the selected PM or RMON group a file with
                                records of current and previous day are
                                sent to the manager;
              - readAbort     : the action in progress will be interrupted.
              - readInterval  : for the selected PM or RMON group according
                                to the selected TpClass a file with records in
                                the selected interval (see pmFTPBeginInterval
                                and pmFTPEndInterval) is sent to the manager
             The value of this object is self cleared (reset to the value none)
             after its use.
             The source IP address of the SNMP packet setting this object
             is used as target Ip address, it identifies the server where the 
             files are transferred."
        DEFVAL {none}
    ::= {pmFTP 5}

    pmFTPStatus OBJECT-TYPE
        SYNTAX      INTEGER {
                             transferring  (1),
                             completed     (2),
                             interrupted   (3),
                             empty         (4),
                             deleting      (5)
                            }
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "Status of pm Ftp transfer/delete operation."
        DEFVAL {completed}
    ::= {pmFTP 6}

    pmFTPStatusTrapNotification OBJECT-TYPE
        SYNTAX      INTEGER {
                             trapDisable  (1),
                             trapEnable   (2)
                            }
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "Enable/disable the trap generation on FTP tranfer operation."
        DEFVAL {trapEnable}
    ::= {pmFTP 7}

    pmFTPCompressedFile OBJECT-TYPE
        SYNTAX      INTEGER {
                             disable  (1),
                             enable   (2)
                            }
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "Enable/disable the compression (zip) of the transferred files.
             For RMON only."
        DEFVAL {disable}
    ::= {pmFTP 8}

    pmFTPBeginInterval OBJECT-TYPE
        SYNTAX      Integer32
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "Defines the begin of the selected interval for the action 
             readInterval(7) (see pmFTPActionRequest). It is the number of
             seconds since midnight of January 1, 1970."
        DEFVAL {0}
    ::= {pmFTP 9}

    pmFTPEndInterval OBJECT-TYPE
        SYNTAX      Integer32
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "Defines the begin of the selected interval for the action 
             readInterval(7) (see pmFTPActionRequest). It is the number of
             seconds since midnight of January 1, 1970. The value of this object
             can not be less than pmFTPBeginInterval."
        DEFVAL {0}
    ::= {pmFTP 10}

-----------------------
--
--  The pmFTP Group generates the following TRAP:
--
-----------------------

    pmFTPStatusTrap  NOTIFICATION-TYPE
        OBJECTS  {equipIpSnmpAgentAddress, pmFTPStatus, accessControlLoginIpAddress}
        STATUS current
        DESCRIPTION
            "This event is generated by NE when the status of FTP transfer is changed.
             The data passed with the event are:
                1) equipIpSnmpAgentAddress
                2) pmFTPStatus
                3) accessControlLoginIpAddress"
    ::= {alarmTrap 3101}

------ End group -----------------------------------------------------------------

END