summaryrefslogtreecommitdiff
path: root/MIBS/aviat-wtm/AVIAT-SWMANAGEMENT-MIB
blob: 24369c4c4c555e95667524570a16795f9192d157 (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
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
-- ****************************************************************************
-- aviatSwManagement.mib: Aviat Networks Software Management MIB
--
-- Copyright © 2014 Aviat U.S, Inc. All rights reserved.
-- Certain information and content may be provided by third parties to AVIAT,
-- and in each case, such copyrighted work remains the property of that third
-- party creator/licensor.
-- All rights not expressly granted herein are reserved. Except as otherwise
-- required by applicable law, any reproduction, distribution, modification,
-- retransmission, or publication of any copyrighted material is strictly
-- prohibited without the express written consent of the copyright owner.
-- "AVIAT", "AVIAT NETWORKS" and the AVIAT logo are trademarks of Aviat
-- Networks, Inc. All other trademarks or brand names may be trademarks or
-- registered trademarks of AVIAT's affiliated companies in the United States
-- and/or other countries.
--
-- ****************************************************************************

AVIAT-SWMANAGEMENT-MIB DEFINITIONS ::= BEGIN
    IMPORTS
        DisplayString, DateAndTime
            FROM SNMPv2-TC
        Integer32, MODULE-IDENTITY, OBJECT-TYPE
            FROM SNMPv2-SMI
        MODULE-COMPLIANCE, OBJECT-GROUP
            FROM SNMPv2-CONF
        aviatModules
            FROM STXN-GLOBALREGISTER-MIB;

    aviatSwManagementModule MODULE-IDENTITY
        LAST-UPDATED    "201401210157Z"
        ORGANIZATION    "Aviat Networks"
        CONTACT-INFO    "Aviat Networks
                         Customer Service

                         Postal: 5200 Great America Parkway
                                 Santa Clara
                                 California 95054
                                 United States of America

                         Tel: 408 567 7000

                         E-mail: mibsupport@aviatnet.com"
        DESCRIPTION
                "This MIB defines the interface for software loading, soft
                 reset and software details retrieval."
        REVISION        "201401210157Z"
        DESCRIPTION
                "Initial Version."
            ::= { aviatModules 11 }


-- ****************************************************************************
-- Conformance area, containing groups and compliance specifications
-- ****************************************************************************
    aviatSwManagementConf       OBJECT IDENTIFIER ::= { aviatSwManagementModule 1 }

    aviatSwManagementGroups     OBJECT IDENTIFIER ::= { aviatSwManagementConf 1 }

    aviatSwManagementCompliance OBJECT IDENTIFIER ::= { aviatSwManagementConf 2 }


-- ****************************************************************************
-- Sub-tree for Software Management MIB objects
-- ****************************************************************************
    aviatSwManagementMIBObjects OBJECT IDENTIFIER ::= { aviatSwManagementModule 2 }

    aviatSwResetObjects         OBJECT IDENTIFIER ::= { aviatSwManagementMIBObjects 1 }

    aviatSwLoadObjects          OBJECT IDENTIFIER ::= { aviatSwManagementMIBObjects 2 }

    aviatSwDetailsObjects       OBJECT IDENTIFIER ::= { aviatSwManagementMIBObjects 3 }


-- ****************************************************************************
-- Software Reset MIB objects
-- ****************************************************************************
    aviatSmSoftReset            OBJECT-TYPE
        SYNTAX          INTEGER {
                                    resetNone (0),
                                    resetSoft (1),
                                    resetHard (2)
                                }
        MAX-ACCESS      read-write
        STATUS          current
        DESCRIPTION     "This is the control to perform a software reset on the
                         product.

                         When set to resetSoft(1) a soft reset will be
                         performed. When set to resetHard(2) a full system
                         reset will be performed, with all reinitialisation
                         carried out. Setting to resetNone(0) has no effect."
            ::= { aviatSwResetObjects 1 }


-- ****************************************************************************
-- Software Loading MIB objects
-- ****************************************************************************
    aviatSmLoadControl          OBJECT-TYPE
        SYNTAX          INTEGER {
                                    abort (0),
                                    load (1),
                                    activate (2),
                                    loadAndActivate (3),
                                    rollback (4),
                                    forceLoad (5)
                                }
        MAX-ACCESS      read-write
        STATUS          current
        DESCRIPTION     "The software loading process may be controlled using
                         this object.

                         Setting the value load(1) will begin transfer of the
                         specified file from the external URI to the unit. If
                         the file is a manifest, this will initiate transfer of
                         all referenced files. When this procedure has
                         completed, aviatSmLoadStatus will indicate loadOk(6)
                         for success, or loadError(10) for failure.

                         An unresolvable incompatibility error is indicated by
                         compatibilityError(13) and should be followed by an
                         abort(0).

                         A successful software (loadOk) load may be activated
                         by setting the value to activate(2). If the
                         delayed/timed activation objects are disabled this
                         will have an immediate effect, otherwise the
                         activation will take place as scheduled. A successful
                         activation will result in an aviatSmLoadStatus value
                         of activateOk(7). An error will be indicated by the
                         value activateError(11).

                         If the value is idle(7) and no software load process
                         has been initiated since the last successful
                         activation, the inactive software can be re-activated
                         by setting the value to rollback(4). Success is
                         indicated in aviatSmLoadStatus by rollbackOk(8) and
                         failure by rollbackError(12).

                         Setting the value to loadAndActivate(3) will begin
                         software transfer. A successful transfer will be
                         followed by software activation which is controlled by
                         the delayed/timed activation objects. Success will be
                         indicated in aviatSmLoadStatus by activateOk(7). A
                         pending scheduled activation is indicated by
                         waitingToActivate(13)."
            ::= { aviatSwLoadObjects 1 }

    aviatSmLoadStatus           OBJECT-TYPE
        SYNTAX          INTEGER {
                                    abort (0),
                                    load (1),
                                    commit (2),
                                    activate (3),
                                    rollback (4),
                                    idle (5),
                                    loadOk (6),
                                    activateOk (7),
                                    rollbackOk (8),
                                    compatibilityError (9),
                                    loadError (10),
                                    activateError (11),
                                    rollbackError (12),
                                    waitingToActivate (13),
                                    sameVersion (14)
                                }
        MAX-ACCESS      read-only
        STATUS          current
        DESCRIPTION     "The software loading process may be monitored using
                         this object. See the aviatSmLoadControl object
                         description for more details."
            ::= { aviatSwLoadObjects 2 }

    aviatSmLoadRollbackDuration OBJECT-TYPE
        SYNTAX          Integer32 ( 0..2147483647 )
        MAX-ACCESS      read-write
        STATUS          current
        DESCRIPTION     "This specifies the duration, in seconds, from which
                         the 'sw load rollback timer' will count down when it
                         is started."
            ::= { aviatSwLoadObjects 3 }

    aviatSmLoadRollbackTimer    OBJECT-TYPE
        SYNTAX          Integer32 ( -1..2147483647 )
        MAX-ACCESS      read-write
        STATUS          current
        DESCRIPTION     "This is the control and counter of the 'sw load
                         rollback timer'. When set to -1, the timer is stopped
                         and disabled. When set to 0, the timer assumes an
                         'instant timeout'. Otherwise, this object will
                         indicate the time left on the timer.

                         The timer is automatically started whenever the
                         software starts up following a software load
                         activation.

                         When this timer reaches zero, the 'sw load manager' of
                         the system will roll back the software to its previous
                         version."
            ::= { aviatSwLoadObjects 4 }

    aviatSmLoadActivateWaitDuration OBJECT-TYPE
        SYNTAX          Integer32 ( 0..2147483647 )
        MAX-ACCESS      read-write
        STATUS          current
        DESCRIPTION     "This specifies the duration, in seconds, from which
                         the 'sw load activate wait timer' will count down when
                         it is started."
            ::= { aviatSwLoadObjects 5 }

    aviatSmLoadActivateWaitTimer    OBJECT-TYPE
        SYNTAX          Integer32 ( -1..2147483647 )
        MAX-ACCESS      read-write
        STATUS          current
        DESCRIPTION     "This is the control and counter of the 'sw load
                         activate wait timer'. When set to -1, the timer is
                         stopped and disabled. When set to 0, the timer assumes
                         an 'instant timeout'. Otherwise, this object will
                         indicate the time left on the timer.

                         This timer is loaded with the lesser of
                         aviatSmLoadActivateWaitDuration (if non-zero), or the
                         time in seconds until aviatSmLoadActivateTime occurs
                         (if set) when the activate(2) state is entered.

                         When this timer reaches zero, the 'sw load manager' of
                         the system will activate the loaded software."
            ::= { aviatSwLoadObjects 6 }

    aviatSmLoadActivateTime     OBJECT-TYPE
        SYNTAX          DateAndTime
        MAX-ACCESS      read-write
        STATUS          current
        DESCRIPTION     "This determines the date and time at which to activate
                         the loaded software.

                         The 'sw load manager' of the system shall activate the
                         loaded software when the current system time reaches
                         or is past this setting."
            ::= { aviatSwLoadObjects 7 }

    aviatSmLoadUri              OBJECT-TYPE
        SYNTAX          DisplayString ( SIZE ( 0..1024 ) )
        MAX-ACCESS      read-write
        STATUS          current
        DESCRIPTION     "The URI of the manifest for software loading."
            ::= { aviatSwLoadObjects 8 }

    aviatSmLoadProgress         OBJECT-TYPE
        SYNTAX          Integer32 ( 0..100 )
        MAX-ACCESS      read-only
        STATUS          current
        DESCRIPTION     "The percentage progress of the current sofware load.
                         It is only meaningful during load and commit, and will
                         return zero otherwise."
            ::= { aviatSwLoadObjects 9 }


-- ****************************************************************************
-- Software Details MIB objects
-- ****************************************************************************
    aviatSmDetailsVersion       OBJECT-TYPE
        SYNTAX          DisplayString ( SIZE ( 0..32 ) )
        MAX-ACCESS      read-only
        STATUS          current
        DESCRIPTION     "The software version of currently running software."
            ::= { aviatSwDetailsObjects 1 }

    aviatSmDetailsInactiveVersion   OBJECT-TYPE
        SYNTAX          DisplayString ( SIZE ( 0..32 ) )
        MAX-ACCESS      read-only
        STATUS          current
        DESCRIPTION     "The software version of the inactive software."
            ::= { aviatSwDetailsObjects 2 }


-- ****************************************************************************
-- The Object and Event Groups
-- ****************************************************************************
    aviatSwResetGroup           OBJECT-GROUP
        OBJECTS {
            aviatSmSoftReset
        }
        STATUS          current
        DESCRIPTION     "These are the software reset objects."
            ::= { aviatSwManagementGroups 1 }

    aviatSwLoadGroup            OBJECT-GROUP
        OBJECTS {
            aviatSmLoadControl,
            aviatSmLoadStatus,
            aviatSmLoadRollbackDuration,
            aviatSmLoadRollbackTimer,
            aviatSmLoadActivateWaitDuration,
            aviatSmLoadActivateWaitTimer,
            aviatSmLoadActivateTime,
            aviatSmLoadUri,
            aviatSmLoadProgress
        }
        STATUS          current
        DESCRIPTION     "These are the objects for software loading."
            ::= { aviatSwManagementGroups 2 }

    aviatSwDetailsGroup         OBJECT-GROUP
        OBJECTS {
            aviatSmDetailsVersion,
            aviatSmDetailsInactiveVersion
        }
        STATUS          current
        DESCRIPTION     "These are the software details objects."
            ::= { aviatSwManagementGroups 3 }


-- ****************************************************************************
-- The Compliance Specifications
-- ****************************************************************************
    aviatSwManagementComplV1    MODULE-COMPLIANCE
        STATUS          current
        DESCRIPTION     "The implementation requirements for this MIB."
        MODULE          -- This module
            MANDATORY-GROUPS    {
                                    aviatSwResetGroup,
                                    aviatSwLoadGroup,
                                    aviatSwDetailsGroup
                                }
            ::= { aviatSwManagementCompliance 1 }

END