Home

MG-SOFT MIB Compiler - MG

1. 35 Beer pring registering all MIB modules ENNEN 32 Info message See resolving compilation problems C Compiled MIB Modules dialog bon 25 D compiling all MIB definition files ouv 23 E ETOT dean See resolving compilation problems ee ee Og ee gi group Of MIB definition es 18 To ede hk ed hg 5 mng C ampie command SE A about product description 6 using Modules Batch Compile command 21 desktop using Tools Batch Compile command 22 Custgmteing 13 performance sses See improving compilation GE EEN 12 performance Help documentation 12 29 35 single MIB definition fe 16 18 i Outpt winden RAG tne GE Starting the software D on Linux operating system 9 on Windows operating System sees 8 debugging See resolving compilation problems MIB Editor windon EE 28 30 Delete MIB Module dialog bon 42 MIB files modules deleting COMPING rein ceenuvinanivacanankanens See compiling compiled MIB HES sesccieciaccsstacsbesdasiadeaSekesbectssee 42 compiled MIB le 16 MIB eene 42 delete seen EE See deleting registry Information 4 edit MIB definition files eseesesesessesseeseeseens 29 31 docking WIDOWS ssstscisnesaistienisitetaniseeduae ania 14 MIB database fe See compiled MIB file MIB definition fie 6 16 MIB Ru E 16 E MIB Source le See MIB definition file POQiSter eters See scanning and registerin Edit Module Properties dialog box 24 33 Sek Cp aa ae WW G me Error message See reso
2. A d Found import module SNMPv2SMI 26 Col E es Figure 6 An example of a customized MIB Compiler desktop 3 1 1 Docking and Regular Windows Generally there are two types of application windows in MIB Compiler the docking windows and the regular windows A docking window is a special window type that is always when opened on top of the regular windows and has two display modes floating and docked In the floating mode a docking window can be placed to any position on the screen also outside the borders of the main window while in the docking mode it is bound docked to the inner borders of the main window The Modules and the Output windows are docking windows while the MIB Editor and MIB Group are regular windows Only one instance of each docking window can be opened in MIB Compiler i e one Modules and one Output window In contrast to that you can open numerous instances 14 MG SOFT MIB Compiler User Manual MIB Compiler Desktop of MIB Editor and MIB Group windows To do this select a MIB module in the Modules window and select the Edit or the Add Module New MIB Group pop up command To move a docked window to a new position do the following 1 Double click the gray title bar of a docked window to change its mode to floating 2 The window undocks and the title bar changes its color 3 Drag the floating docking window to the desired position on the screen While dragging it MIB Compiler will
3. for example 5 1 ap i Faste 51 SENTAS Integer Commert Du TenthdB TEXTUAL CONVE ler Markers DISPLAY HINT d i mn a eres TEE w SMI Syntax Coloring Figure 19 Commenting out selected lines of SMI code Note When you 3 To save changes made in the MIB definition file select the save the modified File Save Source command To save the file under MIE detiniianttie another name use the File Save Source As command the asterisk mark and specify the file name and save destination into the Save E eni as dialog box itor window title Tip In the MIB Editor tab of the Preferences dialog box you can check the Auto save before compile checkbox to let MIB Compiler automatically execute the File Save Source command before it recompiles a changed MIB definition file LU 30 MG SOFT MIB Compiler User Manual Resolve Compilation Problems 4 Rescan recompile the changed MIB definition file using the Compile lt name of the MIB file gt pop up command or the F7 key 5 Check the MIB Compiler log for Error or Warning messages using the F12 and F11 on Mac OS F12 and F11 keys as described in the Examining MIB Compiler Log Messages section o Ifyou still find any Error or Warning messages repeat the procedure described in the steps 1 5 o If no more Error or Warning messages are present in the log you should save the compiled MIB file s as specified in the Saving Compiled MIB Files section 31 MG SOF
4. X Folder D MIBC NewSMIDB DOCS smidb ll V Register files V Include subfolders M Overwrite registered entries Cancel Figure 22 Scan For Database Files dialog box 2 The Scan For Database Files dialog box appears Figure 22 where you can specify the following O Into the Folder drop down list specify the full path of the EE folder containing compiled MIB files You can change the Bie rext to the default file mask smidb to narrow down the Scan Folder drop down operation to files with specific file names and extensions list to browse to the e g smidb desired folder To register found compiled MIB files check the Register files checkbox To search for compiled MIB files in all subfolders of the specified folder check the Include subfolders checkbox u H some of the found compiled MIB files are already registered and you want to reregister them check the Overwrite registered entries checkbox After specifying above details select the OK button MIB Compiler scans and registers found compiled MIB files This operation writes the names and file paths of the found smidb files to the corresponding application data files thus making them known to MIB Compiler and to other WinMIB based applications UI 36 MG SOFT MIB Compiler User Manual Re register Compiled MIB Files After successfully registering compiled MIB files they are listed in the Modules window If the corresponding
5. command Tip There are several alternative ways of starting MIB Compiler on Windows You can do this by double clicking any of the following files in Windows Explorer WinMibC exe the MIB Compiler GUI executable file AMIB module definition source file An SMIDB file a compiled MIB module In addition to starting MIB Compiler option 2 also opens the double clicked MIB module definition file in a new MIB Editor window while option 3 opens the double clicked SMIDB database in a new MIB Group window 2 2 Linux Operating System 1 Under Linux operating systems a With KDE desktop installed display the K menu from the taskbar and select the MIB Compiler entry from the application submenu containing it e g if MIB Browser is installed select the MG SOFT MIB Browser command a With GNOME desktop installed display the Gnome menu procedure as explained in the previous paragraph MIB Compiler and use the same 2 As the program starts the MIB Compiler splash screen appears followed by the Tip Of The Day dialog box Figure 2 9 MG SOFT MIB Compiler User Manual Start MIB Compiler 3 After reading the recommendations in the Tip Of The Day dialog box click the Close button 4 The MIB Compiler desktop appears and you can start using the software Tip You can also start MG SOF xterm or compatible T MIB Compiler by typing mibcgui in a terminal window e g 2 3 Mac OS X Operating Sy
6. from the this menu On some Mac OS systems you need to press and hold down the Ctrl key and left click the relevant item to display the pop up menu Q Keyboard shortcuts eg Ctrl C press and hold down the Ctrl key and press the C key on Mac OS replace the Ctrl key with the Command key 3 on the Apple Macintosh keyboard i e press and hold down the Command key and press the C key The majority of the procedures in this manual are described by using the main menu commands However you can use any of the above mentioned shortcuts when available C7 MG SOFT MIB Compiler User Manual Start MIB Compiler 2 START MIB COMPILER MG SOFT MIB Compiler application ships and installs with several MG SOFT products like MIB Browser Professional Trap Ringer Professional Net Inspector etc MIB Compiler can be started either from the main application e g MIB Browser or separately as a stand alone application Starting MIB Compiler from other MG SOFT applications is subject to their respective manuals and or help documentation This manual explains only the options of launching MIB Compiler as a stand alone application 2 1 Windows Operating System Under Windows operating systems start MIB Compiler by selecting the MIB Compiler icon from the Windows Start menu 1 Select the Start All Programs command and point to the submenu of the application that includes MIB Compiler e g MG SOFT MIB Browser 2 Select the MIB Com
7. in the Compiled Q PerfHist TC MIB C All compiled MIB modules list Not saved IV Close this window after save I Display this window after successful compilation Figure 15 Compiled MIB Modules dialog box 25 MG SOFT MIB Compiler User Manual Compile MIB Definition Files 2 Inthe Compiled MIB Modules dialog box you can set the following a To view all MIB modules compiled in the current MIB Compiler session irrespective of whether they have already been saved or not select the All compiled radio button The default setting Not saved radio button selected displays only compiled MIB modules which have not been saved yet a To close Compiled MIB modules dialog box after saving MIB modules check the Close this window after save checkbox a If you want the Compiled MIB modules dialog box to appear automatically after every successful compilation check the corresponding checkbox 3 To save compiled MIB files select them in the Compiled MIB modules list and select the Save button This prompts you with the Save As dialog box Save As KM x Save nfa SMIDE D cr ES Filename ERENT Save as type WinMib Database Files smidb D Cancel Figure 16 Save As dialog box Z 4 In the Save as dialog box Figure 16 specify the save destination path and the file name of the first module to be saved Then select the Save button to actually write the SMIDB file s to disk Note If you sele
8. menus such as File Edit View By clicking or activating a menu name via keyboard a list of commands used to access various functions is displayed 12 MG SOFT MIB Compiler User Manual MIB Compiler Desktop Toolbar The toolbar contains a group of buttons that provide quick access to the most common commands You can get a brief description of a command behind each toolbar button either in a tooltip or in the status bar by positioning the mouse cursor above the toolbar button without clicking Working area The working area placed between the toolbar and the status bar is the area where all application windows are displayed Modules Output MIB Editor and MIB Group windows The Modules window shows all registered MIB modules and offers many features for managing them like selecting scanning and compiling MIB modules Additionally it provides an overview of MIB Groups in the MIB Groups tab The Output window contains a log generated by the MIB Compiler engine during a MIB compilation or scanning You can step through log messages to determine if the operation was successful and if not locate the possible problems MIB Group windows are used for displaying MIB trees consisting of various MIB modules In addition to that they display MIB module and MIB node properties Modules from MIB Group windows can be saved to MIB groups logical MIB units that can be used by other applications MIB Editor windows are used
9. option of compiling all registered MIB modules using the Batch Compile command is described This section also points out how to scan and register MIB module definition files before compiling them The section ends with a short description of how to save compiled SMIDB files in case they are not saved immediately after the compilation Note It is important to note the difference between a MIB module which is a general term that stands for a definition of related managed objects and the corresponding MIB files a MIB module definition Source file and a MIB module database compiled file A MIB module definition file is a plain ASCII text file written in MIB module definition language as specified by the SMI specification It contains a definition of MIB objects their attributes and hierarchy In order to use such a MIB module in an SNMP application it must be compiled to a data format which this application understands In our case this is the SMIDB binary format This means that there will be typically two physical files for every MIB module a source and a compiled MIB file All bundled MIB modules come in both file versions as compiled and as source MIB files These MIB modules are listed in MIB Compiler Modules window because their compiled and source MIB files were registered at the time of installing MIB Compiler 4 1 Compiling MIB File To compile a single MIB definition file e g a MIB definition file provided by a vendor
10. 4 architecture RedHat Mandriva SuSE for Mac OS X operating systems Intel x86 and x86_64 as well as for Solaris for Intel x86 and SPARC platforms 6 MG SOFT MIB Compiler User Manual Introduction 1 2 About This Manual This manual will guide you step by step through the typical procedures of using MG SOFT MIB Compiler It is assumed that you are familiar with basic actions in a graphical desktop environment such as handling windows choosing menu commands dragging and dropping items etc Using MIB Compiler generally does not require any knowledge about the MIB module definition language in which MIB definition files are written However for resolving potential compilation problems related to inconsistent MIB definitions it is an advantage if you are familiar with the MIB module definition language that is specified by the Structure of Management Information SMI specification Almost all MG SOFT MIB Compiler operations can be accessed in several possible ways You can either use a Main menu commands e g Edit Copy the expression Edit Copy means expand the Edit menu in the menu bar and choose the Copy command from the menu a Toolbar buttons e g to copy selected text in a MIB Editor window click the Copy toolbar button Q Pop up menu commands e g Copy to use this command right click the selected text in a MIB Editor window to display the pop up menu and select the Copy command
11. CS IF MIB my 113 Error 20 Expected lt string gt but found TenthdBmiy D MIBC DOCSISSDOCS IF MIB my 113 Error 20 Expected but found TEXTUAL CONVENTION 113 source lines 7 errors 1 warnina s Compilation failed Done Finished EOE MIB Compiler Log Figure 17 Viewing a compilation log O If no errors and no warnings are indicated in this line the compilation has succeeded without any problems and you can skip the following steps o If no errors but one or more warnings are indicated in this line the compilation has succeeded however MIB Compiler has found some inconsistencies which should be eliminated To do this refer to the step 5 27 MG SOFT MIB Compiler User Manual Resolve Compilation Problems a If one or more errors are indicated in this line the compilation has failed You should proceed with the following steps to locate and examine the logged Error Warning messages 2 To view and highlight the first Error message in the compilation log press the F12 key on Mac OS 6 F12 tip Use the F11 Shift F11 By pressing the F12 or Shift F12 keys on Mac OS Mac OS 38 F11 Shifts 98 F11 F12 and Shift 3 F12 you can jump to the next or previous Error message in the Output window keys to step through Warning and Error messages or the 3 When an Error message is highlighted MIB Compiler F4 Shift F4 keys to step opens the corresponding MIB definition file
12. Compile MIB Definition Files Using Batch Compile To compile multiple MIB modules at once you should use the Batch Compile command which is optimized for large compilation tasks Note Compile vs Batch Compile The Modules Compile command invokes the MIB Compiler engine twice for every selected MIB module once for the Scan operation and if this completes successfully again for the Compile operation In every invocation MIB Compiler engine also reads and updates the application data files Unlike the Modules Compile command the Modules Batch Compile command compiles all selected MIB modules in one pass i e the MIB Compiler engine is invoked only once This significantly speeds up the compilation process when compiling a large number of MIB modules Note also that the Batch Compile process does not include the Scan operation There are two versions of the Batch Compile command in MIB Compiler a The Modules Batch Compile command a The Tools Batch Compile command Both versions are designed for compiling larger groups of MIB definition files However the Modules Batch Compile command can compile only registered MIB modules that are displayed within the Modules window whereas the Tools Batch Compile command can compile non registered MIB modules as well The latter also incorporates the Batch Compile dialog box where you can set several compilation options as described below Modules Batch Compile To us
13. IB definition by yourself you should contact the organization responsible for this MIB module and request the updated properly coded version of the MIB definition file To view and examine the potential Warning messages use the same procedure as described in steps 1 4 However instead of using the F12 key on Mac OS Z F 12 in step 2 and referring to the Error Messages topic in MIB Compiler help in step 3 you should use the F11 key on Mac OS F11 and refer to the description of the Warning message codes 5 2 Fixing Inconsistent MIB Definitions in MIB Editor This section illustrates how to fix errors in a MIB definition file To fix inconsistent parts of SMI code within a MIB definition file follow these steps 1 To open the inconsistent MIB definition file in the MIB Editor window if not already opened press the F12 or F11 key on Mac OS F12 or F11 or double click an Error or a Warning message in the Output window Note that MIB Compiler automatically locates the problematic SMI line within the opened MIB file and marks it with a red arrow marker Edit the inconsistent part of SMI code in the MIB Editor window so that it will comply with the SMlv1 or SMIv2 specification rules When you modify a MIB definition file an asterisk appears in the MIB Editor window title bar indicating that the file has been changed Figure 19 29 MG SOFT MIB Compiler User Manual Resolve Compilation Problems Note MIB C
14. MG MG SOFT Corporation SOFT MIB Compiler 2014 USER MANUAL Document Version 2 2 Document published by MG SOFT on 19 March 2014 Copyright 1995 2014 MG SOFT Corporation MG SOFT MIB Compiler User Manual Introduction In order to improve the design or performance characteristics MG SOFT reserves the right to make changes in this document or in the software without notice No part of this document may be reproduced or transmitted in any form or by any means electronic or mechanical for any purpose without the express written permission of MG SOFT Corporation Permission to print one copy is hereby granted if your only means of access is electronic Depending on your license certain functions described in this document may not be available in the version of the software that you are currently using Screenshots used in this document may slightly differ from those on your display MG SOFT may have patents patent applications trademarks copyrights or other intellectual property rights covering subject matter in this document The furnishing of this document does not give you any license to these patents trademarks copyrights or other intellectual property Copyright 1995 2014 MG SOFT Corporation All rights reserved C2 MG SOFT MIB Compiler User Manual Introduction TABLE OF CONTENTS 1 PENRO CCT Foc taed tat hord retncasd Satie et a aaaea bees Eeer 5 1 1 Product Description aeeecek Ed
15. MIB definition files are not registered such compiled MIB modules are displayed with icons with question mark Figure 23 indicating that no corresponding MIB definition files are available Jl Root OID P QI DNS SERVER MIB 1 3 6 1 2 1 32 New MIB Group Note MIB modules represented by icons Add Module Delete MIB Group with question mark DOCS CABLE Fj Edi Bie ee ee Sei DOCS IF EXT ee 10 127 21 compiled 10 127 10 127 7 3 10 45 Ee S 2 gt Eompie B ateh Eompie I D0T12 F MIE Select Compiled Unselect Not Compiled Invert Selection Figure 23 Newly registered MIB modules in the Modules window 37 MG SOFT MIB Compiler User Manual Organize Compiled MIB Modules in MIB Groups ORGANIZE COMPILED MIB MODULES IN MIB GROUPS MIB compiler lets you organize MIB modules in MIB groups enabling more efficient MIB database management in applications supporting this feature MIB Group windows display a graphical representation of MIB module definitions MIB tree and show properties of MIB module and MIB nodes You can build a MIB tree consisting of nodes defined in different MIB modules by opening these modules in a MIB Group window MIB modules listed in a MIB Group window can be saved to a MIB group representing a logical MIB unit eg you can group all MIBs supported by the RouterX to RouterX MIB group etc WinMIB based applications utilizing this f
16. OCSISSDOCS IF MIB my 112 Error 20 Expected but found TEXTUAL CONVENTION 112 source lines Lele 7 error s 1 warning s Compilation failed Done Finished MIB Compiler Log Expected DESCRIPTION but found Lo Ca Figure 18 Debugging in MIB Compiler i 28 MG SOFT MIB Compiler User Manual Resolve Compilation Problems Tip For the meaning of the Error message codes generated by MIB Compiler please refer to the MIB Compiler help documentation To do this use the Help Help Topics command to open the Help dialog box and switch to the Command Line MIB Compiler MIB Compiler Messages Error Messages topic This topic explains the meaning of all MIB Compiler Error codes Example Error 20 The Error Messages help topic states the following Error 20 Expected s but found s M IB Compiler expected a different token than was found The Error message highlighted in the Figure 18 therefore means that the expression in the line 106 of the DOCS IF MIB definition file is incorrect according to the SMI rules this line should contain a DESCRIPTION clause instead of the token 4 If the encountered error is a consequence of improperly written MIB definition as in the example above you can fix this definition in the MIB Editor window as illustrated in the Fixing Inconsistent MIB Definitions section Tip If you do not know how to fix the M
17. Path a RFC1O65 SMI Aliased to RFC1155 SMl DEE Aras TOR km kao bam Edit Module Properties EN Module identity IV Aliased JRFCI 493 BRIDGE MIB Module source path CHARACTER MIB CISCO SMI Figure 20 Defining a MIB module alias 33 MG SOFT MIB Compiler User Manual Improve Compilation Performance 6 2 2 Setting Other MIB Compiler Preferences In the Compiler tab of the Preferences dialog box you can set various compilation options before compiling MIB definition files To display this dialog box use the View Preferences command Compiler MIB Editor MIB Group MIB Modules and Aliases Options Compiler path C Program Files MG SOFT Trap Ringer Pro Bin MibC exe H m Compiler engine options IT Scan before compile MV Skip compiled MIB modules Tip For a IT Compie imported MIB modules IV Gier long file names description of the Display command line M Display save dialog Preferences dialog IV Reuse additional parameters Use strict ASN 1 for comments box options not IT Suppress warning messages Suppress info messages covered in this section please refer to MIB Compiler help documentation Additional command line parameters Max errors J om0 od fi 00 Cancel Apply Figure 21 Setting MIB Compiler preferences The following options can be set separately or in combination to speed up the compilation process Deactivating Scan Before Compile Op
18. SAPPL MIB DEFINITIONS BEGIN LJ PENTIFIER org 6 ENTIFIER dod 1 IMPORTS ENTIFIER inter mib 2 BITS ENTIFIER inter MODULE IDENTITY OBJECT TYPE ENTIFIER mgmt Unsigned32 TimeTicks Counter32 Gauge32 ENTIFIER mib 2 FROM SNMPv2 SMI ENTIFIER inter DateAndTime TEXTUAL CONVENTION ENTIFIER inter FROM SNMPv2 TC ENTIFIER priva MODULE COMPLIANCE OBJECT GROUP ENTIFIER inter FROM SNMPv2 CONF ENTIFIER inter System Application MIB ENTIFIER snmpV sysApp1MIB MODULE IDENTITY LAST UPDATED 97102000002 ORGANIZATION IETF Applications MIB Working Group EHTIFIER snmpV CONTACT INFO Cheryl Krupezak Editor WG Advisor CS zi MG SOFT MIB Compiler Version 4 0 Build 469 Copyright C 1997 2002 MG SOFT Corporation Al rights reserved Reading module s information from registry Read OK Done Scanning files File C Program Files MG SOFT Trap Ringer Pro MIB SMI SYSAPPL MIB my G Program Files MG SOFT Trap Ringer Pro MIB SMIAS APPL MIB my 20 Info 1 Found module Ps MIB Program Files MG SOFT Trap Ringer ProSMIB APPL MIB my 26 Info 2 Found import module SN 2 5M e Program Files MG SOFT Trap Ringer Pro MIBSSMISSNMP 2 SMI my 6 Info 1 Found module SNMP y2 SMI C Program Files MG SOFT Trap Ringer Pro MIBSSMISSYSAPPL MIB my 28 Info 2 Found import module SNMPyv2 TC VALUE Mr Display MIB Compiler Log
19. T MIB Compiler User Manual Improve Compilation Performance 6 IMPROVE COMPILATION PERFORMANCE To eliminate or reduce the need for user intervention while compiling you should scan and register all third party MIB definition files before compiling any of them In addition there are also several MIB Compiler preference settings which can improve the compilation performance as explained in the following sections 6 1 Registering All MIB Definition Files During the scanning phase of a compilation process or while only scanning MIB Compiler may prompt you with the Edit Module Tip For a Properties dialog box to enter a MIB definition file path or an et UL alias This occurs if the path to the MIB module listed in the EE IMPORTS clause is not known e the required MIB definition box please refer to file is not registered and no alias is defined for it the Specifying MIB eo Definition File Path Therefore before compiling any MIB module it is recommended or Alias If Prompted to register all available MIB definition files using the Tools While Scanning section Scan For Source Files command as described in the Registering MIB Definition Files section This operation scans for MIB definition files in a specified folder or drive and stores the information about MIB definition files it finds to the application data files More specifically it writes the names and full paths of found MIB definition files to the corresponding
20. application data files in order for MIB Compiler and other MG SOFT applications to be able to find and use them thereafter Registering all MIB definition files can significantly reduce the occurrence of prompting with the Edit Module Properties dialog box while compiling or scanning It also diminishes the possibility that Batch Compile operations will fail 6 2 Adjusting MIB Compiler Preferences 6 2 1 Defining Aliases MIB module aliases enable you to compile MIB modules with non standard or incorrect MIB module names specified in their IMPORTS clauses without having to modify their SMI code An alias is another name for a MIB module To define an alias means to specify another MIB module which will be used instead of the original whenever MIB Compiler comes across an IMPORTS clause requesting to import a definition from the original module MIB Compiler comes with several pre defined aliases which let you bypass the most frequently found inconsistencies in MIB IMPORTS clauses BER MG SOFT MIB Compiler User Manual Improve Compilation Performance You can also define new aliases or modify or remove the existing ones to enable a smooth compilation in any specific case To define a new alias do the following 1 Select the View Preferences command to open the Preferences dialog box and switch to the MIB Modules and Aliases tab Figure 20 To activate the list of aliases check the Use additional MIB mo
21. ce cccccceeeseseseeeeeeeeeeeeseeeeeeeeeeeeeeeeeeeeeeees 32 6 1 Registering All MIB Definition Files iccniuicsschiide nos kel tensa aeons 32 6 2 Adjusting MIB Compiler Preferences uk 32 6 2 1 Defining EE 32 6 2 2 Setting Other MIB Compiler Preferences cccccccccsscseseceneeesnseceeneeceneeeceeesseneeceentersnnetenes 34 7 Re register Compiled MIB FileS ccccssccsseeeeeeeeeeeeeeeeeeeeeeneeeeeeeeeeeeeeeeeneeeeeeeeees 36 8 Organize Compiled MIB Modules in MIB Groups eecceceeeeeseeeeeeeeeeeeeeees 38 8 1 Create New MIB Groups scxcscsdesosetecestsensnencesonst peed snevediedes adaas see onpeseetcadteny sti eavemceetteade 38 8 2 Manage Existing MIB Groups wisccccsccszessevedursccdeezadseecdarsiossaceasdgdecieaderenniacecet deene 40 9 Delete MIB Modules ccccccsssseseeeeeeeeeeeeeeeeeeseeeeeeeeeeeeeseseeseeneeeeeeeeeseeeeeeeeeeeeeeeeeees 42 MO DOK E 43 3 MG SOFT MIB Compiler User Manual Introduction TABLE OF FIGURES Figure 1 Figure 2 Figure 3 Figure 4 Figure 5 Figure 6 Figure 7 Launching MIB Compiler from MIB Browser s submenu On Windows 8 Tip of the Day dialog DOX iaaa aai n a aaa aa aeo dati 9 Launching MIB Compiler from the Finder on Mac OS XA 10 Starting MIB Browser on Solaris JDS enmironment 11 MIB Compiler desktop and the Modules window pop up men 12 An example of a customized MIB Compiler desktop c ccceeeeeeeeeeceeeeeeeaeeeeeeeseeeeesteeet
22. ct more than one MIB file for saving you will be prompted to specify the save destination path and file name for each of them To save them to the same location as the first file and to accept the file names offered by MIB Compiler simply use the Save button each time you are prompted 5 When saving compiled MIB files MIB Compiler also stores their file names and paths to the application data files When saved you can open these MIB modules in a new MIB Group window to view their MIB trees and properties or load and utilize them in other WinMIB based applications Note The light colored MIB module icons within the Modules window change to normal when the corresponding compiled MIB files are saved Normal icons indicate MIB modules that have both source and compiled MIB files properly registered 6 If you have been automatically prompted to save MIB files after compilation you should check the MIB Compiler Log in the Output window after saving compiled MIB files When doing this you can use the F11 and F12 keys to check if MIB Compiler generated any Warning or Error messages during the compilation process as described in the Examining MIB Compiler Log Messages section BEI MG SOFT MIB Compiler User Manual Resolve Compilation Problems 5 RESOLVE COMPILATION PROBLEMS Generally MG SOFT MIB Compiler will successfully compile all MIB definition files that are written according to the SMlv1 or SMlv2 specification rules If a MIB de
23. definition files 4 2 1 Registering MIB Definition Files 1 To register a group of MIB definition source files select the Tools Scan For Source Files command 18 MG SOFT MIB Compiler User Manual Compile MIB Definition Files Scan For Source Files X Folder D MIBC ADSL my ES E V Register files V Include subfolders M Overwrite registered entries Cancel Figure 9 Scan For Source Files dialog box 2 Within the Scan For Source Files dialog box specify the following O Into the Folder drop down list specify the full path of the Se S 8 Tip Use the folder containing MIB definition files To narrow down b tton next to the the Scan operation to files with specific file names and Folder drop down extensions change the default file mask to a box to browse to the desired one e g my m etc desired folder Q To register found MIB definition files i e write the information regarding the MIB module names and associated file paths to corresponding application data files check the Register files checkbox a To search for MIB definition files in all subfolders of the specified folder check the Include subfolders checkbox a If MIB Compiler finds any MIB definition files that are already registered it will overwrite the relevant information in application data files if you check the Overwrite registered entries checkbox 3 After specifying the necessary details s
24. dule source file paths and aliases checkbox Use the Add button to open the Edit Module Properties dialog box where you can define a new alias Figure 20 Into the Module identity input line enter the name of the MIB module for which you want to define an alias Check the Aliased checkbox to activate the drop down list Tip The option of 7 l In this list specify the name of the MIB module that will be en EE used instead of the module specified in the previous step source path is You can select among already registered MIB module described in the names recommended or enter a new name Specifying MIB Definition File Path or Alias If Prompted While Scanning section Note If you enter a name of not registered MIB module you should register it before starting the compilation After specifying above details click the OK button twice This closes both dialog boxes and applies new settings From this point on MIB Compiler will use the aliased MIB definition file instead of the one specified in the Module identity input line e g Figure 20 whenever MIB Compiler finds an IMPORTS XY from RFC1493 clause it will import the xy definition from the BRIDGE MIB definition file x Compiler MIB Editor MIB Group MIB Modules and Aliases Options MV Use MIB module source file paths as stored in registry wv Use additional MIB module source file paths and aliases Module Identit Module Source
25. e Modules Scan command before batch compiling them 3 By default the Compiled MIB Modules dialog box appears after finished compilation i e if at least one MIB definition file has been compiled successfully To save compiled MIB module files listed in this dialog box follow the instructions specified in the Saving Compiled MIB Files section Tools Batch Compile To use the Tools Batch Compile command which is the fastest method of compiling and registering a group of MIB definition files do the following 1 To compile a large group of MIB definition files stored in the same folder or its subfolders select the Tools Batch Compile command This prompts you with the Batch Compile dialog box Batch Compile X Folder D MIBC DL T Display all compiled MIB modules IV Include subfolders MV Use compiler mode batch compile IV Stop batch compilation after first error Cancel Figure 13 Batch Compile dialog box 2 Into the Folder drop down list enter the full path to the folder containing MIB definition files To narrow down the Batch Ge Compile operation to files with specific file names and Folder drop down extensions change the default file mask to a desired list to browse to the one ed mib MIB m etc desired folder 3 Within the Batch Compile dialog box you can check the following checkboxes to control the compilation process a To display all compiled MIB modu
26. e checkbox to delete any of the MIB files they will To delete MIB definition source files of selected MIB be permanently modules from the disk select the Source file checkbox not erased from the hard recommended drive It is recommended that To delete all information about selected MIB modules from you leave at least the application data files check the Registry information the Source file checkbox This removes all information about MIB modules checkbox unchecked from the registry i e application data files therefore no other application will be able to find and use them thereafter If you choose to delete both files the corresponding registration information will be deleted as well Select the Yes button to apply above settings i e to delete MIB files and or to delete the MIB module registration information from the application data files Note If you select to delete the registry information for selected MIB modules these modules disappear from the Modules window when you click the Yes button 42 MG SOFT MIB Compiler User Manual Index 10 INDEX A I about this manual sssesssesrsirrssirsi 7 improving compilation performance 32 GNSS cis tae esata cin a eee e a re aha 24 32 adjusting preferences Additional Command Line Parameters 35 B Compile Imported MIB Modules checkbox 34 defining aliases ANEN 32 EN Scan before compile checkbos 34 SCH Ee ee Ee Skip compiled MIB Modules checkbox
27. e the Modules Batch Compile command follow these steps 1 To batch compile a group of registered MIB definition files select them within the Modules window and choose the Modules Batch Compile command or the Batch Compile pop up command Jl QI DOT12 IF M QI DOT12 RPTR QI DSA MIB Q DVMAP MIB CeITITY MI Module Root OID P 1 3 6 1 2 1 32 Le wanne Add Module gt Delete 69 Select Compiled Unselect Not Compiled 29 Invert Selection fay Properties Figure 12 Batch compiling a group of MIB modules 21 MG SOFT MIB Compiler User Manual Compile MIB Definition Files 2 The Batch Compile operation starts This operation reads the information about selected MIB modules from the application data files and starts compiling them in a single pass While compiling MIB Compiler engine logs its activity in the Output window Note The Batch Compile command starts compiling MIB definition files without scanning them first If MIB Compiler encounters a MIB definition file requesting to import a definition from an unregistered MIB module MIB Compiler generates an Error message and aborts compiling such MIB definition file However this does not terminate the entire batch compilation process unless the number of compilation errors exceeds the maximal number set in the Preferences dialog box default value 100 To avoid such errors select the desired set of MIB modules and run th
28. eaeeeeaes 14 Select a MIB definition file to compile sssseeeseeseeeeesresinsssinssinssirssinssrnsstnsstnsstnssnnnnsnnnsnnnnnn nenene 17 Figure 8 A compiled MIB module displayed in the Modules and MIB Group windows 18 Figure 9 Scan For Source Files dialog box 19 Figure 10 Example of a scan log in the Output window after using the Scan For Source Files command 19 Figure 11 Compiling several MIB modules 20 Figure 12 Batch compiling a group of MIB modules 21 Figure 13 Batch Compile dialog Dos 22 Figure 14 Specifying a path to MIB definition le 24 Figure 15 Compiled MIB Modules dialog box 25 Figure 16 Save As dialog DOK sic sti feele eege ed thee EAD ceed tha tea ee 26 Figure 17 Viewing a COMPpIIAtION og 27 Figure 18 Debugging in MIB Compiler c ccccccceceeeceeseeeeeeeeeaeeeeeaaeseeeeesaeeesaaeeseaaeseeeeeseaaeeeeaaeseeeeeeeeees 28 Figure 19 Commenting out selected lines Of SMI code 30 Figure 20 Defining a MIB module alias 200 2 cece cecececeeeeeeeeeeeeee cece aeeeeaee scenes seaeeeeaaeeseaeeseceeeesaeeseaesnaeeseeeees 33 Figure 21 Setting MIB Compiler preferences 0 cccccecececeeeeeeeneeeeeeaeeeeeeeseaeeeeaaeeeeaeeseeeeeseaeeesaeseeeeseeeees 34 Figure 22 Scan For Database Files dialog box 36 Figure 23 Newly registered MIB modules in the Modules Window ccsscceeeeeeeeeeeeeeeeeeeeeeetaeeneneeees 37 Figure 24 The Modules tab of the MIB Group window senses taeeeseaeeeeee
29. eature e g MG SOFT MIB Browser can load unload all modules of a MIB group at once This simplifies MIB module management and makes it more effective 8 1 Create New MIB Group 1 To open one or more compiled MIB modules in a new MIB Ee Group window select them in the Modules window and use EE the Modules Add Module New MIB Group command pop up command MIB Group1 x Module QI DOCS BPI2 MIB QI DOCS BPI MIB Module DOCS CABLE DEVICE MIB hosed g ame DOCS CABLE DEVICE MIB DOCS CABLE DEVICE MIB Root OID 1 3 6 1 2 1 69 iPDOCS CABLE DEVICE TRAP MIB Ju conforms to SMI specification information not available Loaded Yes Description info In database Global sequences Suppressed from database Nodes 120 Database version 3 Path DAMIBCIDOCS SidocsiDOCS CABLE DEVICE MIB smidb Size 104k 918 bytes 107414 bytes Figure 24 The Modules tab of the MIB Group window 2 The Modules tab of the MIB Group window displays a list of all added MIB modules while the right panel displays general information about the selected module Figure 24 Tip To view MIB tree consisting of nodes defined in MIB modules listed on the Modules tab switch to the MIB Tree tab of the MIB Group window Select a MIB tree node SNMPv1 Trap Textual Convention or Type Assignment in the left panel to view its properties in the right panel Figure 25 38 MG SOFT MIB Compiler User Manual Organize Compiled MIB M
30. elect the OK button 4 While scanning and registering MIB definition files MIB Compiler engine writes a scanning log to the Output window Scanning files File D MIBCS4DSLYADSL DMT LINE MIB my D MIBC ADSLNADSL DMT LINE MIB my 13 Info 1 Found module ADSL DMT LINE MIB File D MIBC 4DSLYADSL LINE MIB my D MIBCS4DSLYADSL LINE MIB my 13 Info 1 Found module ADSL LINE MIB File D MIBC ADSLYADSL TC MIB my D MIBCS4DSLYADSL TC MIB my 13 Info 1 Found module ADSL TC MIB File D MIBCS4DSL PerfHist TC MIB my D MIBC ADSL PerfHist TC MIB my 13 Info 1 Found module PerfHist TC MIB Scanned OK Done Registering modulefs information Registered OK Done Finished MIB Compiler Log Figure 10 Example of a scan log in the Output window after using the Scan For Source Files command 19 MG SOFT MIB Compiler User Manual Compile MIB Definition Files After successfully registering MIB definition files they appear in the Modules window represented by light colored MIB module icons note that they have Unknown Root OID until compiled 4 2 2 Compiling Group of MIB Definition Files in Modules Window 1 To compile a group of MIB definition files select them within the Modules window and choose the Modules Compile command or the Compile pop up command EE Module Root ID IR ADSL DMT LINE MIB Unknown Unknown Add Module D Delete T
31. ent of this input line is added to the command that invokes MIB Compiler engine For information about the available command line switches and parameters refer to MIB Compiler help documentation topic Command Line MIB Compiler Command Line Switches and Parameters Tip To view the actual command line used to invoke MIB Compiler engine check the Display command line checkbox in the Preferences dialog box Note The Save parameters that are automatically passed to the MIB Compiler engine cannot be overridden in MIB Compiler GUI Tip To store additional parameters to the system registry check the Reuse additional parameters checkbox This way specified parameters apply permanently for every compilation i e also after restarting MIB Compiler 35 MG SOFT MIB Compiler User Manual Re register Compiled MIB Files 7 RE REGISTER COMPILED MIB FILES In the following cases it is necessary to manually register or reregister compiled MIB smidb files to be able to open and organize them in the MIB Group windows or to load and utilize them in any other WinMIB based application a If you obtain smidb files from other parties e g copy additional smidb files to your computer a Ifyou move your existing registered smidb files to other folder or drive To register or reregister compiled MIB files follow these steps 1 Select the Tools Scan For Database Files command Scan For Database Files
32. ert adef glise foul tate 6 L bo This eege ee eege eege eo 7 2 Start MIB COMPUCK E 8 2 1 Windows Operating SYStOM EE 8 2 2 LINUX Operating SYSLSM EE 9 23 Mac OS X Operating System TEE 10 2 4 Solaris Operating System RE 11 3 MIB Compiler DESKtO pi vvcsscncesnsdncavesctvicucnei ciansaateidis acecandsncevasteasevacinastsicbuadtestuedivini 12 NW SUSTOMIZING DESKIOD TEE 13 3 1 1 Docking and Regular Windows s sseasenssnnnnneeeennnnnnnneneenrnnnnnneneeerrrnrnnnnneenernnnnneneenernnnnneneeeee 14 4 Compile MIB Definition Files cccccccsessseseeeeeeeeeeeeeeeeeeeeeeeeeeeeeeseeseeeeeneeeeeeeees 16 A SCOnmipiling MIB TEE 16 4 2 Compiling Group of MIB Files vcs eststancsccucesdaneeeeeetanetenteeecaie thine ahnkeb stander 18 4 2 1 Registering MIB Definition Files cccccccsccccsceceecetsnseceeneeceeeeessaesseneeceeneecseetsnaeeseneeeteneetenes 18 4 2 2 Compiling Group of MIB Definition Files in Modules Windou sssssesssneeineenenerenseeneeeene 20 4 2 3 Compiling Multiple MIB Definition Files Using Batch Compile Commande 21 4 3 Compiling All Ee TEE 23 4 4 Specifying MIB Definition File Path or Alias If Prompted While Grcannimg 24 4 5 saving Compiled MIB EE eegene Eege 25 5 Resolve Compilation Problems cccccccsscesseeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeseeeeeeeneeeeeeeeees 27 5 1 Examining MIB Compiler Log Messages EEN 27 5 2 Fixing Inconsistent MIB Definitions in MIB Editor AAA 29 6 Improve Compilation Performan
33. essfully the Compile n operation starts While compiling MIB Compiler logs the section compilation activities in the Output window Tip In case the compilation process terminates due to an error MIB Compiler log displays one or more Error messages please refer to the Resolve Compilation Problems section for the guidelines on how to eliminate errors 5 After a successful compilation the compiled MIB module is displayed in a new MIB Group window This operation also registers the MIB definition source file and displays it in the Modules window with a light colored icon Figure 8 Note Light colored icons in the Modules window indicate the MIB modules which are partly registered i e having only the MIB module definition file registered When the corresponding compiled MIB module file is saved it is also automatically registered and the MIB module s icon turns from light colored to normal 17 MG SOFT MIB Compiler User Manual Compile MIB Definition Files za Module SES odule SI a I DOCS CABLE DEVICE MIB DNS RESOLVER MIB 1 3 6 1 2 1 32 2 i DNS SERVER MIB 1 3 6 1 2 1 32 2 DOCS CABLE DEVICE MIB 1 3 6 1 2 1 69 QI DOT121F MIB 1 3 6 1 2 1 10 45 DOT12 APTR MIB 1 3 6 1 2 1 53 1 3 6 1 2 1 29 1 3 6 1 2 1 47 Q EtherLike MIB 1 3 6 1 2 1 10 7 QI FDDI SMT73 MIB 1 3 6 1 2 1 10 15 aFRAME RELAY DTE MIB 1 3 6 1 2 1 10 32 QI FRNETSERV MIB 1 3 6 1 2 1 1044 e b Figure 8 A com
34. finition file cannot be successfully compiled it most probably means that it is not consistent i e not properly written and that it must be fixed This section describes the basic steps of resolving typical compilation problems related to inconsistent MIB definition files The first step in this debugging process is to check the MIB Compiler log messages to detect problems and examine them If compilation problems occur due to improperly written MIB definitions these MIB definitions can be fixed in the built in MIB Editor as illustrated in the Fixing Inconsistent MIB Definitions section 5 1 Examining MIB Compiler Log Messages While compiling or scanning MIB files MIB Compiler logs its activity in the Output window The log may contain any number of Info Warning or Error messages as well as other information related to the compilation process You should always check the output log for Error or Warning messages and if present examine them to determine their causes BEE logged if you use the Batch Compile 1 In the Output window locate the line which indicates the number of Error and Warning messages generated during Barina in sudi the compilation process as highlighted in Figure 17 case proceed with step 2 D MIBC DOCSIS DOCS IF MIB my 107 Error 20 Expected lt string gt but found 127 D MIBC DOCSIS DOCS IF MIB my 107 Error 20 Expected DESCRIPTION but found D MIBC DOCSIS DO
35. for editing MIB module definition Source files directly in the MIB Compiler environment They provide SMI syntax coloring bookmarking compiling MIB definition files directly from the MIB Editor window and other features that are helpful when editing inconsistent MIBs The working area can be fully customized to meet the user s specific needs as described in the Customizing Desktop section Status bar A status bar is a bar at the bottom of the main window that primarily shows the status of the currently performed operation It is context sensitive meaning that it displays different information according to the object selected or operation performed in the main window Depending on this it also contains one or more status bar fields For example if a MIB module in the Modules window is selected the status bar shows the following information in the status bar fields from left to the right the number of all the number of compiled and the number of selected MIB modules in the Modules window 3 1 Customizing Desktop All MIB Compiler windows can be re arranged re sized or hidden in order to produce a desktop layout that meets your requirements best 13 MG SOFT MIB Compiler User Manual MIB Compiler Desktop MG SOFT MIB Compiler SYSAPPL MIB_my a i loj x File Edit View Modules Tools Window Help E EE JSNMPv21C my SYSAPPL MIB_my BEGIN ENTIFIER iso 3 SY
36. h states the requested MIB module name as found in the IMPORTS clause Tip Use the button to browse to the desired file o Into the Module source path input line enter a full path of the MIB definition file defining this module or a Define an alias That is select another MIB module which will be used instead of the original whenever MIB An alias is another Compiler comes across an IMPORTS clause requesting er to import a definition from the original file To define an substitutes the alias check the Aliased checkbox to activate the drop original down list and select proper MIB module from it Edit Module Properties X Module identity I Aliased INET ADDRESS MIB SI Module source path D MIBC INE T ADDRESS MIB my l Skip OK Cancel Figure 14 Specifying a path to MIB definition file Q 24 MG SOFT MIB Compiler User Manual Compile MIB Definition Files 2 After specifying a proper file path or alias click the OK button 3 The Scan operation will be automatically restarted taking the newly specified information into account Note In case you do not enter a proper alias or a file path or you select the Cancel or the Skip button in the Edit Module Properties dialog box the scanning process fails If the scanning process was a part of a compilation process the compilation is terminated as well 4 5 Saving Compiled MIB Files In order to use MIB modules in WinMIB based applica
37. hange the path accord usr local mg soft mgmibbrowser bin mibcgui sh ingly C11 MG SOFT MIB Compiler User Manual MIB Compiler Desktop 3 MIB COMPILER DESKTOP The MIB Compiler main window has a title bar menu bar toolbar status bar minimize maximize and close buttons and some areas specific only to MIB Compiler o x File Edit View Modules Tools Window Help BROGMMIGR SO A EMA SID Re Slel Bsesxlod x Module Root OID ADSL LINE EXT MIB 1 3 6 1 2 1 10 _ avs absL Tc mig Add Module AGENTX MIB Delete GP ALARM MIB_ f_ apm mig 2 Edit appc mip LZ Scan Gp apPLeraLk Mit SS I APPLICATION Batch Compile I APPN DLUR I APPN MIB Select Compiled I APPN TRAP Unselect Not Compiled ap S MIB Invert Selection ARC MIB J ATM ACCOUN Properties 1ATM MIB H r a rt MIB Modules MIB Groups lr MIB Compiler Log Compile selected MIB modules Modules 224 Compiled 224 Selected 1 7 Figure 5 MIB Compiler desktop and the Modules window pop up menu After launching MIB Compiler from it displays the Modules window and the Output compiler engine window Additionally you can open any number of MIB Editor or the MIB Group windows For a detailed description of these windows please see the MIB Compiler documentation Help Help Topics MIB Compiler Main Windows Menu bar A menu bar is a bar near the top of the main window that contains names of the program
38. iew all defined MIB groups click the MIB Groups tab in the Modules window z xi SNMP 1 SNMPyv2 el H Gdd Group New MIB Group el Remove bel Rename F2 AE Si Refresh F5 Se SNMP TARGET MIB S SNMP USER BASED SM MIB QI SNMP VIEW BASED ACM MIB o E RMON DOCSIS e DOCS BPI2 MIB eil DOCS BPI MIB e DOCS CABLE DEVICE MIB e DOCS CABLE DEVICE TRAP MIB e DOCS IF EXT MIB e DOCS IF MIB e DCS OO ME SI DOCS SUBMGT MIB MIB Modules A MIB Groups Figure 27 MIB Groups tab of the Modules window You have the following options of managing existing MIB groups n Rename a MIB group using the Rename pop up command and specifying a new name for the MIB group Delete a MIB group using the Remove pop up command and confirming the deletion Open a MIB group in a new MIB Group window using the Add Group New MIB Group pop up command Add a MIB group to an opened MIB Group window using the Add Group MIB GroupX pop up commana Refresh the display of MIB groups using the Refresh pop up command or the F5 key 2 40 MG SOFT MIB Compiler User Manual Organize Compiled MIB Modules in MIB Groups To add one or more modules to an existing MIB group or to remove modules from the group do the following 1 Select a MIB group and open it in a new MIB Group window using the Add Group New MIB Group pop up command To add a module to this MIB gro
39. in the MIB U9 al log messages ae Editor window and points out the problematic SMI line j eae of that file see the red arrow marker in Figure 18 This enables you to examine and fix the problem Note The highlighted Error message is also displayed in the red colored MIB Compiler status bar field Figure 18 The status bar also displays the best guess of line and column number of the MIB definition file where the error occurred DOCS IF MIB my Iof x REVISION 01022300002 DESCRIPTION Modified by Rich Woundy to use IPv6 friendly zl address objects to accommodate EuroDOcCSIS and to correct the SYNTAX of various objects REVISION 99081900002 p transmission 127 Textual Conventions TenthdBm TEXTUAL CONVENTION DISPLAY HINT d i INET ADDRESS MIB imported OK Done D MIBCSDOCSIS DOCS IF MIB my 46 Warning 6 Item DocslfMib must start with lowercase letter D MIBCSDOCSIS DOCS IF MIB my 106 Error 20 Expected DESCRIPTION but found D MIBCSDOCSISSDOCS IF MIB my 106 Error 20 Expected lt string gt but found D MIBC DOCSIS DOCS IF MIB my 106 Error 20 Expected REVISION but found transmission D MIBCSDOCSIS DOCS IF MIB my 106 Error 20 Expected lt string gt but found 127 D MIBC DOCSISSDOCS IF MIB my 106 Error 20 Expected DESCRIPTION but found H D MIBC SDOCSIS DOCS IF MIB my 112 Error 20 Expected lt string gt but found T enthdB m D MIBC D
40. include the Diffie Hellman key exchange model for management of DOCSIS based SNMPv3 agents For additional information about MG SOFT Corporation please contact the following address MG SOFT Corporation Phone 386 2 2506565 Strma ulica 8 Fax 386 2 2506566 2000 Maribor E mail info mg soft com Slovenia URL http www mg soft com US MG SOFT MIB Compiler User Manual Introduction 1 1 Product Description MG SOFT MIB Compiler is a tool that lets you compile any MIB definition file that conforms to the SMlv1 or SMlv2 specification MIB definition files are typically provided by vendors of SNMP manageable devices in form of ASCII files and written in MIB module definition language A MIB definition file contains a description of MIB objects their attributes and hierarchy in the SNMP manageable device i e serving as a roadmap for managing that device Before such a MIB file can be used it must be converted to the format an SNMP application can understand and utilize In case of MG SOFT applications this is the SMIDB binary file format While compiling MIB Compiler engine checks the syntax of SMI code in MIB definition files and if the code is error free compiles those files into the SMIDB binary format Compiled MIB files can then be utilized by all MG SOFT network management applications or by any other application using the industry standard WinMIB API These applications use compiled MIB files to graphically represe
41. ip To quickly select all MIB modules which are not compiled first choose the Modules e 7 INT SERV MIE IPV6 ICMP MIl Edit QJ IPVEMIB e Scan i Select Compiled and then the Modules Invert Selection command OO ee TTT ez NETWORKAF E PerfHist T C Ml Batch Compile a SCSI MIB Select Compiled o AFC1155 SMI Unselect Not Compiled Invert Selection Figure 11 Compiling several MIB modules 2 MIB Compiler engine starts scanning selected modules and logs its scanning activity in the Output window This type of Scan operation scans the definition files of selected MIB modules for the modules listed in their IMPORTS clauses and in the IMPORTS clauses of all imported modules Tip If MIB Compiler prompts you with the Edit Module Properties dialog box follow the steps described in the Specifying MIB Definition File Path or Alias If Prompted While Scanning section 3 If the Scan operation finishes successfully the Compile operation starts While compiling MIB Compiler engine logs the compilation activities and results in the Output window 4 By default MIB Compiler prompts you with the Compiled MIB Modules dialog box after a successful compilation This enables you to save compiled MIB files as described in the Saving Compiled MIB Files section of this document LU 20 MG SOFT MIB Compiler User Manual 4 2 3 Compiling Multiple MIB Definition Files Command
42. k the OK button to close the Preferences dialog box BER MG SOFT MIB Compiler User Manual Compile MIB Definition Files 4 Select the Modules Compile All command or the Compile All pop up command within the Modules window 5 MIB Compiler starts batch compiling all registered MIB definition files While compiling MIB Compiler engine logs the compilation activity and results in the Output window Note While compiling MIB Compiler may encounter some errors However this will not terminate the compilation process unless the number of compilation errors exceeds the maximal number set within the Preferences dialog box default value 100 6 By default the Compiled MIB Modules dialog box appears after a compilation is finished To save compiled MIB module files listed in this dialog box follow the instructions specified in the Saving Compiled MIB Files section 4 4 Specifying MIB Definition File Path or Alias If Prompted While Scanning During the scanning phase of a compilation process or while only scanning MIB compiler may encounter an IMPORTS clause requesting to import a definition from a MIB module which is not registered In such a case MIB compiler prompts you with the Edit Module Properties dialog box to enter a MIB definition file path or to specify an alias for this module If prompted with the Edit Module Properties dialog box Figure 14 proceed as follows 1 Carefully read the Module identity line whic
43. les in a new MIB Group window after compilation check the Display all compiled MIB modules checkbox BEI MG SOFT MIB Compiler User Manual Compile MIB Definition Files a To compile the files that match the given file mask in the specified folder and all its subfolders select the Include subfolders checkbox a Check the Use compiler mode batch compile to compile all MIB module definition files in one pass same as the Modules Batch Compile command If this checkbox is not checked MIB Compiler engine is invoked for every MIB module it compiles a To stop the batch compilation process after the first NoiooThie checkbox error is encountered check the Stop batch can only be used in compilation after first error checkbox combination with the a S i Use compiler mode 4 After specifying all information click the OK button batch omne checkbox 5 The Batch Compile operation starts While compiling MIB Compiler engine logs its activities in the Output window Note The Batch Compile command starts compiling selected MIB definition files without scanning them first While compiling MIB Compiler may encounter a MIB definition file demanding to import a definition from a MIB module which is not registered In this case the attempt to compile such a MIB definition file will fail and an error message will be generated However if the Stop batch compilation after first error checkbox is not checked this will not terminate the Ba
44. lving compilation problems ANo See compiled MIB file MIB group G le 38 add MIB module t0 cds cuscsdintantaninn ane 41 Group Name dialog bon 39 EE EE 38 ODEN ee e inne mame 40 lu EE 40 43 MG SOFT MIB Compiler User Manual remove MIB module from EE 41 W ll EE 40 VE 39 MIB Group window MIB Tree E 39 Mod les ta E 38 Modules window GETT LE 40 MIB Modules tab e ee 37 O Open dialog eegent ege eden 17 Output MIB Complier Log window sses 19 27 P Preferences dialog box EEN 34 R register MIB fie See scanning and registering resolving compilation problems editing MIB Definition Dies 29 31 EXAMINING og messages 27 29 error MESSAGES E 27 28 29 INFO messages EEN 27 WAINING messages rrr 27 28 29 Index S Save As dialog Dale E 26 saving compiled MIB files csser 25 26 edited MIB definition le 30 lee e 39 41 Scan For Database Files dialog box 36 Scan For Source Files dialog bon 19 Scanning and registering compiled MIB flES cvasscisiiminsedanwdahediias 36 MIB definition Dies 18 32 SMI code editng ssisssssirsrssssirirsirrrrrnn 29 31 Ee rte 7 16 syntax CHECKING avictevssncen need See compiling SYNTAX COIMNING saci eg ere Eer 30 SMIDB sssrinin 16 25 T Tip of the Day dialog bon NENNEN 9 WwW Warning message See resolving compilation problems A 44
45. nt the MIB objects defined in those files to meaningfully interpret the results of SNMP operations related to managing these objects to display properties of MIB objects defined in those MIB files etc Besides several methods of compiling MIBs MIB Compiler lets you scan MIB definition files to determine if all required MIB definition files are available register new or moved MIB files define aliases for MIB modules etc MIB Compiler also incorporates the built in MIB Editor which can be used to fix inconsistent MIB definitions in case they cause compilation errors or warnings MIB Editor window supports SMI syntax coloring Find Replace Bookmarking and many other features that are helpful while editing or writing a MIB module Furthermore MIB Compiler lets you open compiled MIB modules in MIB Group windows to view MIB trees symbols and traps defined in these modules In the tree view you can see the MIB node properties search the tree for particular MIB object and print parts or the entire MIB tree along with various node information You can also organize related MIB modules in MIB groups to enable more efficient MIB module management in other applications supporting this feature e g MG SOFT MIB Browser Professional Edition can load or unload all MIB modules in a MIB group at once MG SOFT MIB Compiler is available for 32 bit and 64 bit Microsoft Windows operating systems for Linux operating systems running on Intel x86 and x86_6
46. odules in MIB Groups E mib 2 interfaces transmission Module DOCS CABLE DEVICE TRAP MIB S SEA Name docsifDocsisBaseCapability E E docsliMibObjects Wa ECKE TEE ST en Full path isa 1 org 2 dad 6 internet 1 mgmt 2 mib 2 1 transmission 1 0 gocs JOCSISBD aseLapabity fod e ZS sl 2 1 docslfCmObjects ae PRH docs fCmMacT able Parent docsifBaseOhbjects 2 docs fCmStatusT able docslfCmStatusE nty Numerical syntax Integer 32 bit docslfCmStatusDocsisOe INTEGER i Sr docslfCmStatusModulatic ta DocsisVersion docslfCmServiceT able al current docslfCmtsObjects read only Sei docsBpiMIB Se docsBpi2MIB Se docslfExtMib Description Indication of the DOCSIS capability of the device csDev This object mirrors docsIfDocsisCapability from the J docsDevMIBObjects DocsIfExt mib Reference Document 25 from References Annex G e Fa 3 Figure 25 MIB Tree and MIB Node Properties panels Tip 1 In the MIB Tree panel you can use the Find and Find Next commands to locate desired MIB objects in the MIB tree Tip 2 To view its SMI definition select a MIB object node in the MIB tree and use the Go To Source pop up command MIB Compiler will open the corresponding MIB definition file if available and jump to the line defining selected MIB object Tip 3 You can also print parts of or the entire MIB tree together with
47. of an SNMP manageable device do the Tip Alternatively following you can compile a MIB definition file by 1 Select the File Compile command which prompts you right clicking it in with the standard Open dialog box Windows Explorer and selecting the 2 Use the Open dialog box Figure 7 to browse to the MIB Compile pop up definition file you want to compile Select the desired file and command use the Open button Tip Choose the All Files entry from the Files of type drop down list if the extension of the MIB file you want to compile differs from the extensions indicated in this list by default 16 MG SOFT MIB Compiler User Manual Compile MIB Definition Files Open zl Look in amp DOCSIS e ee EB docs DOCS CABLE DEVICE MIB my Filename DOCS CABLE DEVICE MIB my Files of type MIB Source Files mib smi mi2 sm2 my Cancel 4 Figure 7 Select a MIB definition file to compile 3 By default MIB Compiler first scans the selected MIB file This operation scans the selected MIB module definition file MMe Renee for the modules referenced in its IMPORTS clause and dialog box appears recursively in the IMPORTS clauses of all imported modules while scanning While scanning MIB Compiler writes the scanning log to the follow the Ha Output window and stores the relevant information to the SE application data files Definition File Path 4 If the Scan operation finishes succ
48. ompiler e g MG SOFT Figure 4 MIB Browser and select the MIB Compiler entry from it a Email and Calendar SS Firefox Web Browser MG SOFT MIB Browser w Mozilla Web Browser A StarOffice 7 ee Thunderbird Mail and News vr J Applications X Run Application Accessibility Accessories gt D P Open Recent gt CG Games gt g This Computer 2 Graphics gt gp Find Files a Sete k MG MG SOFT MIB Browser BZ Preferences gt Multimedia Hel amp Sp Le Office gt z2 Lock Screen S z Programming Sun Java Desktop System for Solaris 2 Log Out root 2 Utilities gt Fri Feb 24 11 37 AM amp Command Line Utilities gt KN Document Files Li MIB Browser MIB Browser Help B MIB Browser User Manual 2 MIB Compiler Help B MIB Compiler User Manual Ei Quick Start Guide Figure 4 Starting MIB Browser on Solaris JDS environment 3 As the program starts the MIB Compiler splash screen Of The Day dialog box Figure 2 After reading the tips in the Tip Of The Day dialog box cl appears followed by the Tip ick the Close button 5 The MIB Compiler desktop appears and you can start using the software Tip You can also start MIB Compiler from a terminal window The following command illustrates how to start MIB Compiler if MG SOFT MIB Browser package is installed if a different MG SOFT software package is installed on your computer please c
49. ompiler has a built in database of all SMlv1 and SMlv2 keywords While writing or editing MIB definitions MIB Compiler automatically recognizes parts of the SMI code and applies pre defined colors and styles to them syntax coloring You can customize the syntax coloring preferences in the MIB Editor tab of the Preferences dialog box or turn this option on and off SMI Syntax Coloring pop up command If you notice that a part of SMI code is not formatted according to the syntax coloring settings when this option is turned on it means that this particular part of code does not comply with the SMI rules and that you should fix it check the usage of lowercase and uppercase letters spelling etc Tip 1 Use Bookmarks for example to mark the problematic lines of a MIB definition file so you can quickly find them thereafter Tip 2 To comment out a line in the MIB definition file insert two adjacent hyphens in front of it or select it and use the Comment Out pop up command as illustrated in the figure below DOCS IF MIB my Il x selected objects REVISION 01112000002 This line has been commented out because of a missing description clause transmission 1 Compile DOCS IF MIB my F7 End ga Find Next Textual Conventions Replace KH TenthdBmy TEXTUAL CON Undo DISPLAY HINT a 1 Se Redo STATUS current Select All DESCRIPTION M Cut This data type repr Ea c are normally expressed in Om 5 km OB
50. piled MIB module displayed in the Modules and MIB Group windows 6 By default after a successful compilation MIB Compiler also displays the Compiled MIB Modules dialog box allowing you to save the compiled MIB file To save it follow the instructions specified in the Saving Compiled MIB Files section 4 2 Compiling Group of MIB Files To be able to compile a group of MIB definition files from the Modules window you must scan and register them first if not registered already This operation associates MIB definition file names and paths with the names of MIB modules as specified in those definition files This information is stored in the application data files for future use After this the partly registered MIB modules appear in the Modules window and you can compile them using the Compile or the advanced Batch Compile command as described in the following sections By default the Compile operation includes the Scan operation maerez which scans all selected MIB definition files for their IMPORTS command can also clauses and checks if all MIB modules referenced by these be run IMPORTS clauses are available This is done recursively i e independently i e also for all imported MIB modules If the Scan operation finishes ee successfully the MIB definition files are compiled Compile operation This section ends with a description of using both versions of the Batch Compile command to compile a larger group of MIB
51. piler entry from the respective submenu as shown in the picture below A Accessories A Dames A Maintenance 1 MG SOFT MIB Browser Gi MIB Browser Help sal MIB Browser User Manual amp MIB Browser SI MIB Builder Help 2 MIB Builder User Manual S MIB Builder Gi MIB Compiler Help MIB Compiler User Manual a MIB Compiler Si MIB Explorer Help 2 MIB Explorer User Manual i MIB Explorer 4 MIB Update Quick Start Guide Ei Unlnstall MIB Browser di Command Line Utilities di Document Files d Back Search programs and files Figure 1 Launching MIB Compiler from MIB Browser s submenu on Windows 3 As the program starts the MIB Compiler splash screen appears followed by the Tip Of The Day dialog box 8 MG SOFT MIB Compiler User Manual Start MIB Compiler Tip of the Day Did you know Use the Tools Scan For Source Files to scan and register MIB source files before you compile them In this way MIB Compiler will remember which MIB definition is stored in which MIB source file You need to perform this operation only once Figure 2 Tip of the Day dialog box 4 To view additional tips click the Next Tip button After reading the recommendations click the Close button to start using MIB Compiler 5 The MIB Compiler desktop appears and you can start using the software Tip To view MIB Compiler tips after closing this dialog box select the Help Tip of the Day
52. seeeees 38 Figure 25 MIB Tree and MIB Node Properties panels ssseesseesseeeseeeseesseesentesnnstnnntnntttnnetnnnnnnnnennnnennnnn 39 Figure 26 Specifying a desired name for the MIB Group 39 Figure 27 MIB Groups tab of the Modules window esseesseesseesseeesesssstsestsettnnsttuttnnttnntttnntnnntnnnnnnnnnnenn 40 Figure 28 Delete MIB Module dialog Dos 42 WEE MG SOFT MIB Compiler User Manual Introduction 1 INTRODUCTION Thank you for using MG SOFT MIB Compiler MG SOFT Corporation established in March 1990 is the world s leading supplier of SNMP SMI and general network management applications toolkits and solutions for Windows and Linux platforms MG SOFT provides major IT companies worldwide with network management applications as well as with toolkits implementing core network management technologies Furthermore MG SOFT provides customers with consulting services custom software development services and network management integration solutions based on our vast experience in SNMP SMI and network management fields MG SOFT has developed one of the first SNMPv3 implementations for Win32 platforms and took the initiative by designing extensions to the WinSNMP specification in order to accommodate the SNMPvs protocol features With that MG SOFT has gained the leading WinSNMP implementation supplier position in the industry Today all MG SOFT s SNMP products fully support the SNMPv3 protocol Some products also
53. stem Under Mac OS X operating systems 1 2 Open the Finder and select the Applications entry in the panel on the left Expand the submenu of the application that includes MIB Compiler e g MG SOFT SNMP Lab in the Finder and double click the MIB Compiler app entry to launch MIB Compiler _ Applications e al 4 Network 2 Macintosh HD gt iWork 06 Pi B untitled ZS Mail app j Vine Server a y 7 MG SOFT SNMP Lab f cocothumbx 2 gt API Specifications i WW Desktop 3 E Micro MIB Browser app 1 i D A e gt SNMP Lab Terminal app 1 nr Genen CS Uninstall SNMP Lab app I2 DECUMERNS gt Office 2004 for Mac Test Drive J ew Movies OmniOutliner app f amp Music Sa e E Pictures Eet ar 1 of 42 selected 91 1 GB available Figure 3 Launching MIB Compiler from the Finder on Mac OS X As the program starts the MIB Compiler splash screen appears followed by the Tip Of The Day dialog box Figure 2 After reading the recommendations in the Tip Of The Day dialog box click the Close button The MIB Compiler desktop appears and you can start using the software 10 MG SOFT MIB Compiler User Manual 2 4 Solaris Operating System Start MIB Compiler Under Sun Solaris operating systems 1 In Sun JDS environment display the Launch menu and expand the Applications submenu 2 Expand the submenu of the application that includes MIB C
54. tch Compile operation altogether unless the maximum number of permitted errors is reached To minimize the chance of experiencing batch compile errors you should run the Tools Scan for Source Files command before compiling MIB files as described in the Registering MIB Definition Files section 6 By default the Compiled MIB Modules dialog box appears after finished compilation i e if at least one MIB definition file has been compiled successfully To save compiled MIB module files listed in this dialog box follow the instructions specified in the Saving Compiled MIB Files section 4 3 Compiling All MIB Modules Sometimes it may be necessary to recompile all registered MIB modules e g if compiled MIB files become somehow corrupted etc 1 Select the View Preferences command to open the Preferences dialog box where you can verify or set the compilation preferences for this operation 2 Within the Compiler tab of the Preferences dialog box set the following a To force MIB Compiler to compile already compiled modules uncheck the Skip compiled MIB modules checkbox Q To compile also all imported MIB modules check the Compile imported MIB modules checkbox a To modify the maximal number of errors that MIB Compiler tolerates before terminating the compilation process enter a new value into the Max errors input line It may be useful to increase this value if compiling a large number of MIB definition files 3 Clic
55. tion Unchecking the Scan before compile checkbox will speed up the compilation process if not using the Batch Compile command which does not include the Scan operation However this should be done only if all MIB module source files to be imported are properly registered otherwise MIB compilation can fail Tip Use this option if you have already executed the Scan command on the selected module s without any errors Deactivating Compile Imported MIB Modules Option Uncheck the Compile imported MIB modules checkbox if you do not need or want to compile all MIB modules which are to be imported listed in the IMPORTS clauses This can significantly speed up the compilation 34 MG SOFT MIB Compiler User Manual Improve Compilation Performance Activating Skip Compiled Option Checking the Skip compiled MIB modules checkbox can also accelerate the compilation process If this option is activated MIB Compiler will not compile those selected MIB modules which are already compiled and whose source files have not been changed since the last compilation In other words MIB modules which have older source than compiled files will not be compiled Specifying Additional Command Line Parameters Many advanced compilation options can be set via the Additional command line parameters input line You can enter any number of additional switches and parameters prefixed by and separated by space Figure 21 The cont
56. tions you must save compiled SMIDB MIB files While saving SMIDB files MIB Compiler also registers them i e it stores their file names and paths to the application data files in order for WinMIB based applications e g MG SOFT MIB Browser to be able to find and use them If not automatically prompted after a successful compilation see the tip below you should save compiled MIB files manually Tip By default MIB Compiler prompts you with the Compiled MIB Modules dialog box after every successful compilation in order to immediately save compiled MIB files However you can turn this feature on and off in MIB Compiler To do this select the View Preferences command to display the Preferences dialog box On the Compiler tab of this dialog box check or uncheck the Display save dialog checkbox to enable or disable the automatic appearance of Compiled MIB Modules dialog box after compilation 1 By default MIB Compiler prompts you with the Compiled MIB Modules dialog box after a successful compilation in order to save compiled MIB files If not prompted you can manually open the Compiled MIB Modules dialog box by selecting the File Save MIBs command Compiled MIB Modules X Compiled MIB modules QI ADSL DMT LINE MIB Save All QI ADSL LINE MIB IADSL TC MIB Tip Use the Save Close All button to save all DOCS CABLE DEVICE MIB jx MIB modules Si DOCS IF MIB currently displayed a INET ADDRESS MIB m Show modules
57. try to dock it to the currently nearest border of the main window If you want to prevent the docking hold down the Ctrl key while dragging it To close a docking window click the Close x button in its title bar You can re display it by selecting the View Modules or View Output command Note MIB Compiler automatically stores the properties of the main window and the docking windows opened close status position size Therefore they will reappear the same after restarting the application 415 MG SOFT MIB Compiler User Manual Compile MIB Definition Files 4 COMPILE MIB DEFINITION FILES With MG SOFT MIB Compiler you can compile any MIB definition source file compliant with the SMlv1 or SMlv2 language specifications Such MIB definition files are typically supplied by the vendors of SNMP manageable devices MIB Compiler lets you compile MIB definition files and save them to MG SOFT proprietary format SMIDB which can be utilized by MG SOFT applications or any other applications utilizing the industry standard WinMIB interface MIB Compiler offers several ways of compiling MIB module definition files This section explains these compiling options First a procedure of compiling a single MIB definition file is described Then two methods of compiling a group of MIB definition files are explained using the regular Compile command and using the Batch Compile command specially optimized for large compilation tasks Next the
58. up drag and drop the module from the MIB Modules tab of the Modules window to the opened MIB Group window To remove one or more modules from the group select them in the opened MIB Group window and use the Remove Module pop up command Tip You can also remove a module from a group directly in the MIB Groups tab of the Modules window To do this select a module in this window and choose the Remove pop up command Save the changed MIB group by using the Store All To Group pop up command in the MIB Group window and selecting the group s existing name from the Group drop down list Figure 26 Select OK button to confirm the overwriting 41 MG SOFT MIB Compiler User Manual Delete MIB Modules 9 DELETE MIB MODULES MIB Compiler lets you physically delete registered MIB files from disk and or delete the MIB module information from the relevant application data files registry To do any of these follow these guidelines 1 Select the MIB module s in the Modules window and use the Modules Delete command The Delete MIB Module dialog box appears where you can specify what will be deleted Delete MIB Module X For selected MIB modules the following will be deleted IV Database file I Source file MV Registry information Are you sure Yes No Figure 28 Delete MIB Module dialog box To delete compiled SMIDB MIB files of selected MIB Note lt you choose modules from the disk select the Database fil
59. various node attributes Please refer to the MIB Compiler help documentation for more information about these features 3 To add additional MIB modules to an opened MIB Group EE window select them in the Modules window and choose the way to add a module Add Module MIB GroupX pop up command where X is to a MIB Group the number of the target MIB Group window window is to drag and drop it from the 4 To remove a MIB module from the MIB Group window Modules window to select it and use the Remove Module pop up command the opened MIB Group window 5 To save MIB modules opened in the MIB Group window select them from the list and choose the Store Selected To Group pop up command To save all listed MIB modules to the same group use the Store All To Group pop up command 6 The Group Name dialog box appears Enter a name for this MIB group into the Group drop down list and select the OK button Group pocs s DI Cancel Figure 26 Specifying a desired name for the MIB Group UI 39 MG SOFT MIB Compiler User Manual Organize Compiled MIB Modules in MIB Groups MIB Compiler writes information about the new MIB group to the application data files Thereafter this MIB group can be utilized by other WinMIB based applications supporting this feature You can view and change some properties of this and other existing groups in the MIB Groups tab of the Modules window Figure 27 8 2 Manage Existing MIB Groups To v

MG-SOFT MIB Compiler - MG

Contents

Download Pdf Manuals

Related Search

Related Contents