Home

YANG Explorer - MG

1. 9 Zl elc T HIC 9 2 1 1 Windows Operating SYStCIN ccccccsccsseesceeccccecssseesseeeccssesseseeeeeessssauausueecesssssauaeseeeeessssaaaesseeeesseaas 9 2 2 IMU Opera Nge le eue taedet dre e eme e papi et aduer a ees 9 2 1 8 Mac OS X Operating SYStCM ccccccccscsseecsseccccssseesseeccceessauceseeeccessssaaaeeeceesessssaeseeeesssssuaaeeseeeensas 10 2 2 Iastalling YANG EXDIOISE uii rii Nan Das eae 10 22 1 Windows Operating System a a a anna no RR raa asa maan anna aman 10 222 LINK Operating System rsin eiaa tote o Eee ERE b en aeo ERE e ESI undo BN e adnata 11 22 8 Mac OS X Operating System se e aada a nana anna aae DAR ERA Ra saa alan Naa 12 3 Starting YANG Explorer Professional Edition 13 o Star Ng Y ANGEXDIOEIOE sitit Be te nce ame asu 13 o1 WINDOWS Operating oVStBlm sud Ma T ue edidit E 13 ol LnuUCcODeralng SVSIONmius ond aan Nan 13 ST Mac OS X Operating SV SEN o ac etti oe a ea vla ita fo dese cespite o ese Oe AN Ead 13 9 2 YANG Explorer DeSKIOD assueti na nun Ona 14 4 Applying License Key aa 16 5 Navigating and Exploring YANG Tree oom 17 5 I Viewing Node PIO DCMI CS iusso ea oo t ente a bus 17 5 1 1 To View the Properties of a Module or a Submodule Node 17 5 1 2 To Expand the YANG Tree and Select a Node moon 18 5 1 8 To View the Property Sub Nodes ooooo W XXX 20 5 1 4 Different Types of YANG Tree No
2. in actete yang counted4 in unicast pkz yang countera4 in broadcast pktz yang counted4 in multicast pkts yang counted4 in discards yang counter32 in ermors yang counteriz in unknown protes yang counter312 out octets yang counted4 out unicast pks yang counter34 out broadcast pkte yang counter34 out multicast pks yang counter84 out discardz yang counteri2 out errors yang counteri2 Figure 53 Viewing annotations and descriptions UML comments shown in dark yellow notes LL 60 MG SOFT YANG Explorer User Manual Using NETCONF Content Editor 8 USING NETCONF CONTENT EDITOR MG SOFT YANG Explorer includes an XML editor and validator for NETCONF content that complies with the RFC 6110 specification This feature allows you to edit or validate new and existing content according to Document Schema Definition Languages DSDL which are automatically generated from selected YANG modules in the background Edited and validated NETCONF documents can be saved to XML files which can be loaded into MG SOFT NetConf Browser for example to send documents to the connected NETCONF server 1 To start editing load the desired YANG or YIN modules into YANG Explorer and select the Edit Edit NETCONF Content command This will open the NETCONF Content Editor window Figure 54 which contains the following components 1 Menu bar 2 Toolbar 3 NETCONF content XML editor panel XML document editor with syntax coloring and autocomplete fea
3. MG MG SOFT Corporation YANG Explorer 2015 Professional Edition USER MANUAL Document Version 3 3 2 Document published on Friday 16 January 2015 Copyright 2011 2015 MG SOFT Corporation MG SOFT YANG Explorer 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 2011 2015 MG SOFT Corporation All rights reserved L2 MG SOFT YANG Explorer User Manual Introduction TABLE OF CONTENTS 1 oce lenior 7 Tel Product esp ON m 7 2 Installing YANG Explorer Professional Edition
4. uses statement right click it and choose the Go to Grouping Definition command from the pop up menu Figure 19 PS MG SOFT YANG Explorer Professional Edition File Edit View Module Window Help a f 0 m 2 si ar me Node Properties Textual Data Tree Source File r2 description Configuration parameters f r GPM routing instance bn key ame B D description Canfguratian of a routing gt E name Hf type HB e ey M PS Expand Entire Subtree E P default r a4 B interface E P routing View Property Modes B E ribs 5 JH route filters F Find Nodes Ctrl F Ca ici co Lo ie Lo ca co e 098 Cy oe OW R3 p Collapse Entire Subtree na A active route Find Usages Ctrl Shift E E m route count i i gam ietf system 2014 0 e Previous Mode Selection Alt Left 3 namespace Lr 42 Next Node Selection ai prefix ys H a import Jeffyand Hail import Terfihe MA Go To Typedef Definition Go To Grouping Definition H import Teffneto organization TE Unload Module contact VAS en oo C Te E E T E Kala SH LC cra A Lm LIIUCI LL Li LLL uses router id eae leaf description type string description Textual description of th container default ribs 1 it feature multiple ribs description Configuration oj Figure 19 Selecting the Go to Grouping Definition command on an expanded uses node 2 YANG Tree displays the node that represents the respective source node e
5. Figure 9 Viewing the properties of a property sub node 3 To view the properties of a sub node select it in the YANG Tree panel and view its properties in the Node Properties panel in the right section of the main window Sub node properties are displayed in pink colored table Figure 9 4 To hide the properties sub nodes of the selected node only right click the node and choose the View Property Nodes Toggle for Selected Node pop up command 5 To hide the properties sub nodes for all nodes in the selected subtree right click the subtree node and choose the View Property Nodes Hide for Subtree pop up command 5 1 4 Different Types of YANG Tree Nodes and Sub Nodes Node icons representing different types of YANG statements MG SOFT YANG Explorer uses the following node icons to present different types of YANG statements in the YANG Tree panel LL 21 MG SOFT YANG Explorer User Manual Navigating and Exploring YANG Tree f deviate F deviation EX extended statement 3 other property sub nodes Figure 10 Node icons in the YANG Tree panel representing different types of YANG statements For a description of YANG statements please refer to the YANG specification RFC 6020 In addition the following overlay symbols are displayed on some of the node icons listed above to depict special expanded nodes in the YANG tree that represent either a usage of a reusable statement e g uses of a grouping or nodes that origina
6. boolean true forwarding boolean false mtu uint16 68 max units octets m lt slist gt gt selister neighbor address ip inetipvd address na zone key ip inetipvd address no zone ke Jis ikey link layer address yang phys address mandatory Figure 48 Example of a composition is part of relationship between UML classes In the example above Figure 48 the lower address and neighbor list classes have a composition relationship with the ipv4 container class e g address class s a part of ipv4 class neighbor class Is a part of ipv4 class A dependency represents relationship between two classes which means that one class requires another for its complete definition It is read as depends on in the direction of the arrow An example of this would be a relationship between a list class and a typedef class if the list has a child that uses the typedef as its type an typeder ip address origin fenumeration other static dhcp link layer random A address ip inetipv4 address no zone key origin ip address origin Figure 49 Example of a dependency depends on relationship between UML classes LL 57 MG SOFT YANG Explorer User Manual Viewing UML Class Diagram of YANG Modules Generalization is read as inherits from in the direction of the arrow and is only used to represent inheritance between classes that represent identities Or typedefs Gn lt lt fypeder
7. routing nstance ref e irt routing i next hop A next hop Figure 23 sean the Find Referencing Leafrefs command on a eaf node LU 33 MG SOFT YANG Explorer User Manual Navigating and Exploring YANG Tree 2 YANG Explorer searches through all currently loaded YANG modules or submodules for nodes with the leafref path property that points to the leaf or leaf list node selected in step 1 and displays the results in a new Referencing Leafrefs tab that appears in the Output panel at the bottom of the main window Figure 24 P5 MG SOFT YANG Explorer Professional Edition File Edit View est Module Window Help wu BI P pecia easi ode Froperues Textual Data Tree FA E G routing instance state ref E fl rib ref E 4l rib state ref i G9 route filter ref outgoing interface E m route filter state ref B 75 amp address family Leaf HAE state entry id a pula Name of the outgoing interface Ea outgoing interface 3 description s grouping defines H 3 leafref l E 3 type Teafref 3 description Name of the outgoi rt routing state rt routing instance rt interfaces rt intel E a E special next hop nS an next hop dassifiers E 2 E next hop content B 2 route metadata ai a rt outgoing interface rt outgoing interface bn B SS eae ietf routing aiiis perational state of
8. typedef leafref if interfaces state if interface if name name string key description string type identityref finterface ty pe mandatern enabled boolean true link up down trap enable enumeration tena bled disabled fif faature if mib Sepeda m i iter face r ef leafref iftinterfaces if interface if name Figure 45 Example of UML class diagram ietf interfaces without the state data classes LO 54 MG SOFT YANG Explorer User Manual Viewing UML Class Diagram of YANG Modules 2 To limit the elements of the YANG module s that will be displayed in the UML class diagram click the toolbar button to open the UML Class Diagram Settings dialog box switch to the Display Options tab Example The ietf interfaces YANG module contains certain typedef statements and an identity statement Figure 45 If we want to view only the configuration data tree we can disable displaying the typedef and identity classes To do that uncheck the Display typedefs and Display identities checkboxes in the Display Options tab of the UML Class Diagram Settings dialog box Figure 46 PS UML Class Diagram Bia 3 ietf yang typesin2013 07 13 ietf interfacesid2014 05 04 UML Class Diagram Settings Display Options Display typedefs Display uses C Display identities Display leafrefs Display RPCs as methods Display notifications as methods Display UML packages for modules Display dass annotations prese
9. ALT keyboard keys 5 3 5 Finding all Leafref References of a Leaf or Leaf List Node YANG Explorer lets you select a leaf or a leaf list node in the YANG tree and quickly find all nodes that reference it via the 7eafref statement as described in this section 1 In the YANG Tree panel select a leaf or a leaf list node e g a node that you have previously found with the Find Leafrefs Go to Target function right click it and choose the Find Referencing Leafrefs command from the pop up menu Figure 23 PS MG SOFT YANG Explorer Professional Edition File Edit View Module Window Help es EE E D interfaces Node Properties Textual Data Tree Source File P description Meteor yer G interface E pe D description ist of etw name TS Expand Entire Subtree H si Collapse Entire Subtree E ipv o BK Tefal View Property Nodes A reference to the name of a config EIL ribs interface Ls description amp Find Nodes Ctrl F Find Leatrets Find Referencing Leafrefs This is a state data node Previous Node Selection Alt Left SE address Next Node Selection Alt Right S routes YM Goto Typedef Definition Leaf ietf routing rt routing state rt routing instanc Reload Module rt routing state rt routing instanc Unload Module E aid aa next hop options Po P b mandatory Fue 3 description Uoi Gys special next hor Beat simple next hop Leafref Target a p outgoing nt iett routing Uff
10. As le button in the Textual Data Iree tab toolbar and specify the location and name of the file to be saved in the standard Save As dialog box To send the contents of the Textual Data Tree tab to a printer click the Print 5 button in the Textual Data Tree tab toolbar and select the desired printer or PDF writer driver for example from the standard Print dialog box LL 39 MG SOFT YANG Explorer User Manual Loading YANG and YIN Modules in YANG Explorer 6 LOADING YANG AND YIN MODULES IN YANG EXPLORER YANG Explorer supports loading NETCONF modules in YANG and YIN format When YANG Explorer is started for the first time it automatically loads all standard YANG modules that are included in the distribution and graphically displays loaded modules in the YANG Tree panel in the left portion of the main window Additional vendor specific YANG or YIN modules can be loaded by the user and existing modules can be unloaded The loading of private modules in YANG Explorer is an important step that will provide you with a clear overview of the node hierarchy and node attributes representing the configuration and state data implemented in the managed NETCONF device 6 1 Loading YANG and YIN Modules To load a YANG or YIN module and all dependent modules it imports and includes 1 Copy the YANG or YIN module s you received from the vendor of the NETCONF device to a local folder of your choice In YANG Explorer select the Module Load M
11. Figure 16 Inspecting the usage of the selected reusable element ooooooWo Woo 27 Figure 17 Selecting the Go to Target Node command on a leafref typedef node 28 Figure 18 Viewing the resulting node of the Go to Target Node command oooooooooooW 29 Figure 19 Selecting the Go to Grouping Definition command on an expanded uses node 30 Figure 20 The Go to Grouping Definition command has found the relevant grouping node and its definition T X NE 31 Figure 21 The Find Leafrefs command lets you find all nodes with the eafref type 32 Figure 22 The list of found eafrefs displayed in the Module Leafrefs tab in the Output window 32 Figure 23 Selecting the Find Referencing Leafrefs command on a leaf node ooo 33 Figure 24 Exploring the referencing leafrefs oo mna 34 Figure 25 Viewing the definition of a selected module node in the Source File tab 35 Figure 26 Viewing the definition of a selected leaf node oooooWooWo W WWW WWW Wanna 36 Figure 27 The Find toolbar at the bottom of the Source File view oooo Wo oom oo 36 Figure 28 Viewing the textual data tree diagram of a YANG module oooW WWW XXX 38 Figure 29 Viewing the textual data tree diagram of a contain
12. Wsers Administrator Documents MGSOFTY angExplorer nodules yang etf outing amp 20 14 05 24 yang grouping outgoing interftace description This grouping defines next hops leaf outgoing interface type leafref path rt r y description Name of the outgoing interface y y 262 grouping special next hop description This grouping provi Find outgoing interface Match case Whole words Highlight results Regular expression Wrap around Figure 27 The Find toolbar at the bottom of the Source File view LL 36 MG SOFT YANG Explorer User Manual Navigating and Exploring YANG Tree 2 Into the Find input line enter one or more characters or words you are searching for In addition you can select the following search options in the Find toolbar a Check the Match case checkbox to make the search case sensitive meaning that search operation distinguishes between uppercase and lowercase letters If this option is enabled the search will find only those strings in which the capitalization matches the one used in the search query e g Current will find Current but not current a Check the Whole words checkbox to find only those strings that are whole words and not part of a larger word e g Link will find link Down but not linkDown a Check the Highlight results checkbox to highlight found text in orange color This option is enabled by default a Check the Regular expressions checkbox to
13. and description are displayed in the Node Properties tab in the right side of the main window In addition the YANG Source File view and the Textual Data Tree view are also available and let you quickly view the section of the YANG code that defines the selected node subtree or the textual tree representation commonly used in IETF NETMOD publications of the selected data tree branch respectively YANG Explorer implements a wealth of features that let you effectively explore references between YANG statements within one or more YANG YIN modules While exploring YANG modules it is vital to be able to quickly navigate between a reference of a definition and the definition itself for example to be able to go from an if feature statement to the definition of a matching feature statement YANG Explorer now offers such navigation whenever a reference exists The software also provides a reverse functionality that lets you quickly find all usages of a definition in the loaded YANG YIN modules for example to find all if features that reference a specific feature definition This is supported for typedef grouping Identity feature and extension statements Leafrefs YANG statements with a leafref type are also an important concept in YANG and the software now offers a quick way to find all leafrefs and their LL 7 MG SOFT YANG Explorer User Manual Introduction target schema nodes in a modul
14. can locate the source of most errors by clicking links in the messages that appear in the notification area The editor will also indicate error sources by underlining erroneous elements and by showing error icons in front of the relevant lines in the content editor panel If you hover your mouse over an underlined element a tooltip with the error message appears The editor automatically validates the document as you edit it The validation includes several steps a Ensures that the document is well formed XML syntax compliant a Checks if the document is valid according to the current RelaxNG schema element attribute structure must be as defined by input YANG modules a Creates a copy of the current document in the background and fills in the missing default values using DSRL prerequisite for the final step a Ensures that the copy of the document satisfies all semantic constraints specified by the input modules such as XPath expressions from the YANG when statements ISO Schematron You can disable the validation at any time by clicking the Validation Enabled lf toggle button in the toolbar 7 Depending on the currently selected content type you may use additional features of the editor for example a When the config or edit config content type is selected you can use the corresponding toolbar buttons 4 to convert the document between the two types i e between an edit config operation with a config elem
15. enable searching by using the advanced search capabilities offered by the Java regular expressions for more information about using the regular expressions please visit the following site http www regular expressions info java html a Check the Wrap around checkbox to enable wrap around search i e the program will search for the text you specify beginning at the current cursor position and will continue past the end to the beginning of the document back to the current cursor position If this option is disabled the search begins at the current cursor position and ends at the end of the document This option is enabled by default 3 The software searches the document for the text string that matches the search pattern By default the matches all occurrences of the found text are highlighted in orange color Figure 27 4 Click the Next or the Previous button in the Find toolbar to jump to the next or preceding occurrence of the found text respectively 5 To stop the find operation delete the search string from the Find input line or click the Close button in the right section of the Find toolbar this also hides the toolbar 5 5 Viewing Textual Data Tree Diagram The Textual Data Tree tab in the Node Details panel displays a simplified text based data tree diagram of the node subtree selected in the YANG Tree panel If a module node or submodule C node is selected in the YANG Tree panel the complete c
16. g a grouping node that is used by the given expanded uses node Figure 20 3 To quickly go back to the previous location node in the YANG Tree panel right click the current node and choose the Previous Node Selection or press the ALT keyboard keys LO 30 MG SOFT YANG Explorer User Manual Navigating and Exploring YANG Tree E 8 id 4 Made Properties Textual Data Tree Source File C Users Administrator Documents MGSOFT Y angExplorer modules yang jetf routing 20 14 05 24 yang i b type Tante Le gi description ique numerical identifie i A 36 grouping router id Po i description Ths grouping provides the de ER Lj router id 3228 This grouping provide bo al type Yvang dotted guad p nO ee des i i description Router ID 32 bit number DERE PERE HA putgoing nterface o u special next hop 241 description 3 description rs grouping provides the lec 242 Router ID Se special next hop 243 protoco ne D type enumeration 244 mide description type yang dotted guad 1 i il description pecie next hop aptians next hop dassifiers 3 description he grouping provides ivo ne Ef priority ne 3 type enumeration t description simple priority for distingu 249 description Figure 20 The Go to Grouping Definition command has found the relevant grouping node and its definition grouping outgoing interface 1 5 3 4 Finding all Leafref Nodes in a YANG Module YANG Explorer lets you e
17. gt counter64 uint64 typeder gt 2 zero based counter64 yang counter amp 4 0 Figure 50 Example of a generalization inherits from relationship between UML classes Classes representing choice statements are connected to their child case classes using a navigable association relationship i e has alternative since composition does not express the relationship properly It means that the class instances are linked in some semantic sense prefix length netmask lt lt Cgse gt gt 2 x case P prefix length netmask prefix length uint 0 32 netmask yang doited guad fif feature ipv4 non contiguous netmasks Figure 51 Example of a navigable association relationship between UML classes Some composition relationships express cardinality of the classes in the relationship using text values such as 0 N zero or many or by a single text value such as 1 exactly one An example of displayed cardinalities 0 N can be seen in Figure 48 some dependency relationships may be labeled for example leafrefs will have the target node name at the end of the directed connection and the name of the leafref at the center of it LL 58 MG SOFT YANG Explorer User Manual Viewing UML Class Diagram of YANG Modules 7 2 3 Packages Classes may be grouped into a package which represents a single namespace Therefore a package is always named after the module submodule it was generated from Two
18. in the UML Class Diagram Settings dialog box and load the required module file directly from disk 5 he UML class diagram of the selected module is displayed in the UML Class Diagram window Figure 41 For more information on UML classes their connections relationships packages annotations etc please refer to the section PS UML Class Diagram Bid o mtu uint32 1280 max units octets dup addr detect transmits uint32 1 Figure 41 Viewing a portion of the UML class diagram of the ietf ip YANG module 6 Use the mouse wheel to zoom in and out of the UML class diagram LL 50 MG SOFT YANG Explorer User Manual Viewing UML Class Diagram of YANG Modules 7 Hover the mouse pointer over a class box to view the description of the class if it has one in a tooltip 8 Right click and drag the diagram to pan it inside the UML Class Diagram window while exploring the connections relationships between classes and packages 9 You can select and reposition individual elements classes connections notes packages etc however note that the diagram will be redrawn to match the original appearance if you make and apply any changes in the UML Class Diagram Settings dialog box 10 To explore the connections between classes of two or more associated YANG modules open the UML Class Diagram Settings dialog box Figure 40 and include the associated e g imported module s into UML diagram Figure 42 PS UML Class
19. module contains a collection of VAN G d revision 2014 05 08 Leaf r name B GH interface ref EB type afer The name of the interface description TAS type is used by data models the en a A device MAY restrict the allowed valu Er ta interface type J P ausu Nod c M LE nisa depending on the type of the GI arbitrary names or system controlled interfaces this ui Les device specific name of the interface iy if mib list interfaces state interface contain MJ interfaces existing interfaces on the device eal description Interface configuration parameters E FH interface If a client tries to create configuration p key hame system controlled interface that is no i B en ee ee ia interfaces state interface list the se o the request if the implementation doe ef eae pre provisioning of interfaces or if the a enabled an interface that can never exist in th e h link up down trap enable NETCONF server MUST reply with an w ipv4 error tag invalid value in this case f ipv6 Hj interfaces state If the device supports pre provisionin Fe passis i Er configuration the pre provisioning fe r namespace Le A T ATS IL pa i E foU advertised TE rire i Figure 18 Viewing the resulting node of the Go to Target Node command 3 To quickly go back to the previous location node in the YANG Tree panel right click the current node and choose the Previous Node Selection or press the AL
20. packages may also be in a relationship which is either a package import represented with a dashed line with normal arrow head and an lt lt import gt gt stereotype or package composition line with a circle containing a plus sign head The former is mapped from import statements and the latter from include statements ietf yang types 22013 07 15 import e ref Figure 52 Example of a package containing all classes of a module 7 2 4 Annotations Besides classes the diagram may also contain annotations in form of a note an UML comment An annotation is associated with a class via a dashed line without arrows An LL 59 MG SOFT YANG Explorer User Manual Viewing UML Class Diagram of YANG Modules annotation may contain a description of the class or a YANG property such as if features presence config and when must constraints F3 lt lt iconfainer gt inte rfaces state xis interface name string Tey type identityref interface type mandatory admin statuz enumeration fup down testing mandatory if f amp ature if mit oper status enumeration up down testing mandatory last change yang date and time iFindex int32 1 2147483847 mandatory i feature if mib physaddress yang physaddress higher layer if interface state re f lowerlayerif interface state re speed yang gaugeG4 unitgbitse second H eeconitalnars statistics discontinuity time yang date and time mandatory
21. t rpm ivh moYangExplorer 2015 XXX 306 romi a Ona 64 bit x86 64 Linux distribution with the RPM package manager install the 64 bit RPM package as follows T cpm ivn mgYangExplorer A2015 X X X x06 64 f 0m b Linux distributions with the DPKG package manager Debian Ubuntu etc a Ona 32 bit i386 Linux distribution with the DPKG package manager install the 32 bit DEB package dpkg i mgYangExplorer 2015 X X X i386 deb a On a 64 bit x86 64 amd64 Linux distribution with the DPKG package manager install the 64 bit DEB package as follows dpkg i mgYangExplorer 2015 X X X x86 6064 deb c Linux distributions with the installpkg package manager e g Slackware a On a 32 bit i386 Linux distribution with the installokg package manager install the 32 bit TGZ package t installpkg mgYangExplorer 2015 X X 25396 X tgz a On a 64 bit x86 64 Linux distribution with the installokg package manager install the 64 bit TGZ package installpkg mgYangExplorer 2015 X X x80 64 X tgz LL 11 MG SOFT YANG Explorer User Manual Installing YANG Explorer Professional Edition If you have KDE or GNOME Environment installed on your machine the installation will add an entry to the K Menu or Gnome Menu respectively Once the installation is complete you can start MG SOFT YANG Explorer program 2 2 3 Mac OS X Operating System 1 Double click the MG SOFT YANG Explorer disk image file dmg that you have downloaded from MG S
22. that is not known to YANG Explorer the Module Load Request dialog box appears Figure 31 prompting you to specify the location of the file that defines the referenced sub module Note Known modules are those modules for which information in the program cache already exists i e the standard modules that ship with YANG Explorer and those private modules that have already been loaded in YANG Explorer Fs Loading Modules nC directories to search for modules Done Se arching directories for modules Searching directory C Private Yang Modules for modules Dane Module Lead Request Done scanning Preparing module load list Failed to find a required file among known files Please provide a file that contains module tailf meta extensionst 2010 08 19 Figure 31 YANG Explorer prompts you to provide the location of the required module a Click the OK button in the Module Load Request dialog box to close it and display the Load Module dialog box In the Load Module dialog box navigate to the file containing the definition of the required module select it and click the Open button Figure 32 PG Load Module tailf meta extensions 2 2010 08 19 e rema Figure 32 Loading a YANG module LL 41 MG SOFT YANG Explorer User Manual Loading YANG and YIN Modules in YANG Explorer a Again the specified folder is first scanned for files that contain valid YANG and YIN modules to build a list of known modules the
23. that lets you select a certain type of node that references or amends other target node and quickly locate the target node in the currently loaded YANG modules and submodules Unlike the Find Usages function which is used for finding and exploring 1 N references in YANG sub modules the Go to Target Node function is used for examining the 1 1 source target references LL 27 MG SOFT YANG Explorer User Manual Navigating and Exploring YANG Tree The Go to Target Node function can be used on the following types of nodes O augment a leaf or leaf list whose type is leafref a typedef whose type is leafref a deviation 1 In YANG Tree panel select the appropriate node e g a typedef node whose type IS leafref right click it and choose the Go to Target Node command from the pop up menu Figure 15 PS MG SOFT YANG Explorer Professional Edition File Edit View Module Window Help BL Ps wife m Sd f zi E root Node Properties Textual Data Tree Source File H 4 iana crypt hash 20 14 04 04 9 485 iana if type 2014 05 08 e H 4 ietfinet types 2013 07 15 1 485 iethinterfaces 2014 05 08 pa 3 namespace Lepas an uns yang etFnterf P prefix W E 3 import e f yang fypes pn 3 organization TE 7 NETMOD NETCONF Data Modei IL Jb contact WG Web hiip tools ietf org wg hetmoc This type is used by data models that need to re al description This module contains a collection of VAN configured interface
24. tree panel in the main window unless modules with the same names and revisions are already loaded in such case you need to unload the currently loaded modules first and then repeat the loading procedure LL 48 MG SOFT YANG Explorer User Manual Viewing UML Class Diagram of YANG Modules 7 VIEWING UML CLASS DIAGRAM OF YANG MODULES MG SOFT YANG Explorer can present selected YANG module s in form of a UML Unified Modeling Language class diagram UML class diagram displays different types of YANG nodes as different types of classes with their attributes methods and relationships between the objects e g dependence composition inheritance etc UML class diagram can be seen as a standard way of visualizing the YANG data model defined in one or more YANG modules This section describes how to view the UML class diagram of one or more YANG modules in the UML Class Diagram window Furthermore the procedure of printing and saving the UML class diagram to a bitmap image file is described 1 In YANG Explorer select the View UML Class Diagram command from the main menu or click the UML Class Diagram toolbar button Ta h 2 The UML Class Diagram window appears Figure 41 When you open the UML Class Diagram window for the first time it displays no content Otherwise it displays the UML class diagram of the YANG module s selected in the previous session 3 Click the UML Class Diagram Settings toolbar button A to op
25. yang Scanning Folders for YANG and YIN Modules YANG Explorer incorporates a convenient functionality that lets you scan selected folders and optionally also subfolders for files that contain YANG or YIN modules and automatically register them for use with YANG Explorer Registered files are added to the known modules cache and appear in the Known Modules dialog box from where they can be loaded into YANG Explorer To scan a folder for YANG or YIN module files In YANG Explorer select the Module Scan for Modules command from the main menu The Scan for Modules dialog box appears Figure 34 Scan For Modules Figure 34 The Scan for Modules dialog box In the Scan for Modules dialog box specify the following a In the Directory drop down list enter the full path of the folder containing private YANG or YIN modules a Check the Include subdirectories checkbox if you want to scan also all the subfolders of the specified folder directory LO 43 MG SOFT YANG Explorer User Manual Loading YANG and YIN Modules in YANG Explorer a Inthe Extension drop down list select the file mask e g yang yin all to be used for finding the YANG and YIN modules Only files with the selected extension s will be taken into account when scanning for modules a Check the Open Known Modules dialog checkbox if you want to view the results of the scan operation in the Known Modules dialog box a Click the Defaults button to reve
26. Collecting Process As lt config gt 33 ipfix templateLifeTime gt lt ipfix templateLifeTime gt k x edit config T lt ipfix optionsTemplateLifeTime gt lt ipfix optionsTemplateLifeTime atleast three times higher than the 3 qm qp LE co specified in RFC5101 the Template lifetime MUST be J lt rpc gt T lt ipfix templateLifePacket gt lt ipfix templateLifePacket gt d To O parameter value poate M iii M Hon he corresponding Exporting Processes Note that j ipfix optionsTemplateLifePacket lt ipfix optionsTemplateLifePa T Nee aee ipfixTransportSessionTemplateRefreshTimeout in the IPFIX MIB module See RFC5101 Section 10 3 7 RFC5815 Section 8 ipfixTransportSessionTemplateRefreshTimeout Figure 55 Using the autocomplete feature in the NETCONF Content Editor window LUI 63 MG SOFT YANG Explorer User Manual Using NETCONF Content Editor 5 As you edit the XML document its tree representation in the NETCONF content tree panel on the right side changes accordingly The NETCONF content tree panel represents your document s structure and may be used to quickly navigate large documents by double clicking the tree nodes It also gives you some information on individual nodes node type in YANG terms and its YANG description if available 6 As you edit the document the validation error warning messages appear in the notification area at the bottom of the window Figure 54 You
27. Diagram Bia so Dana mail mmur PEL EET ys PI SY SPER L EEE I Ka PRA 1 R2 ey Ss SIR MESE EN LLENE Pe ey Memang p pem m Sa Se ar Ss QENT a Pe ee Figure 42 Viewing the relationships between classes of two modules in the UML class diagram LLI 51 MG SOFT YANG Explorer User Manual Viewing UML Class Diagram of YANG Modules 11 To print the UML class diagram to a printer click the Print button 5 in the UML Class Diagram window toolbar 12 The Print Diagram window appears displaying a print preview If you would like to print the diagram as a poster spread across two or more sheets of paper or include a custom title or tooter into print click the Options button in the Print Diagram window and set the desired print options Figure 43 B Print Diagram Page Print Zoomin zeemout 30 5 E Print Options Poster Rows Poster Columns Add Poster Coords Print What Entire Graph Show Tite Footer On Every Page T Ok Reset Cancel Figure 43 Setting the print options for printing UML class diagram as a 2x2 poster 13 To save the UML class diagram to a bitmap image file i e jog png or gif format click the Save As button kl in the UML Class Diagram window toolbar and in the standard Save As dialog box that appears select the location specify the name and the extension i e jpg png or gif of the image file to be created and click the Save Graph to Image but
28. E f rib state ref urn ietf params xml ns y rt ietf yang types ietf interfaces 4 n ietf netconf monitoring ieti netconf 2011 06 0 ietf netconf notificat Figure 21 The Find Leafrefs command lets you find all nodes with the eafref type in the given module 3 he Module Leafrefs tab displays a list of all nodes with the type of leafref in the given YANG module or submodule Figure 22 The target of each listed leafref node is also displayed in the Module Leafrefs tab Target is the leaf or leaf list node which the leafref path property points to Position ietfrouting 2014 05 24 148 routing instance ref E Tt routing rt routing nstance rt name ietf routing 2014 05 24 157 W routing instance state re Go to Leafref jrt routing state rt irouting dnstance rt iname jetFrouting 2014 05 24 166 AM rbref bie as Wek ietf routing 20 14 05 24 175 rtrouting state rt ribs rt rib rt name ietf routing 2014 05 24184 GD eee jetFrouting 2014 05 24 193 ietf routing 20 1405 24252 RU outmoing nter facer outgoing interface e ee RIDE M I EI EET ietf routing 2014 05 24 350 3 rt next hop content rt next hop options rt simpl 184 rt routing state rt routing instance rt interfaces rt inter ietf routing 20 1405 24362 rt next hop content rt next hop options rt next V rt routing state rt routing nstance rt interfaces rt inter ietf routing2014 05 24 984 4 f rt active route r
29. IC Users Administrator Documents MGSOFTNetconfBrowser modules yang Vetf yang types 20 10 09 24 yang F ft coffee machine 20 11 05 14 Z Home SasoR NETCONF mgsoft coffee machine 20 11 05 14 yang F ft coffee machine 20 11 05 14 Z Home SasoR WETCONF masoft coffee machine ydd notifications 22008 07 14 IC Users Administrator Documents MGSOFTNetconfBrowser noduleslyang nc notifications 2008 07 14 yang lok tifications 2008 07 14 IC Users Administrator Documents MGSOFTNetconfBrowser modules yang notifications 2008 07 14 yang C taif aaaG2010 06 17 C Private Yang Modules tailf aaa yang x Module name ietf netconf base notifications Module revision 2011 06 13 File path Z Home SasoR INETCONF etf netconf base notifications draft 20 11 06 13 yang Lastchanged 24 Jun 2011 10 37 10 Status OK Imports Module Name Module Revision File Path Override iietf inet types C Users Wdministrator Documents MGSOFTNetconfBrowser modules lang Vetf inet types 20 10 09 24 yang ax iietf netconf C Users V dministrator Documents MGSOFTNetconfBrowser modules yang ietf netconf 20 11 01 16 yang Indudes Module Name Module Revision File Path Override Load ade Figure 36 The Known Modules dialog box viewing details of selected module To load a YANG or YIN module and all dependent modules it imports and includes from the Known Modules dialog box 1 In YANG Explorer sel
30. OFT s Website or obtained on a removable medium Tip Use Finder to navigate to the DMG file if it is not located on your desktop 2 he contents of the double clicked disk image displays in a Finder window MG SOFT YANG Explorer virtual drive appears on the desktop Drag amp drop the MG SOFT YANG Explorer app to the Applications folder within the MG SOFT YANG Explorer virtual drive Once the installation is complete you can start MG SOFT YANG Explorer for Mac OS X from the Finder LL 12 MG SOFT YANG Explorer User Manual Starting YANG Explorer Professional Edition 3 STARTING YANG EXPLORER PROFESSIONAL EDITION 3 1 Starting YANG Explorer 3 1 1 Windows Operating System 1 2 In Windows operating systems select the Start Programs MG SOFT YANG Explorer YANG Explorer command from the Windows taskbar The YANG Explorer desktop appears and you can start using the software Please refer to the Applying License Key section for instructions on how to apply your license 3 1 2 Linux Operating System The easiest way to start YANG Explorer under Linux operating system is to use the start menu The start menu can be displayed from the desktop taskbar 1 If you have the KDE or GNOME desktop environment installed display the K anome start menu by clicking the button in the left corner of your taskbar To start YANG Explorer search for and use the MG SOFT YANG Explorer YANG Explorer command The YANG Explorer de
31. T keyboard keys 5 3 3 Using the Go to Definition Feature YANG Explorer incorporates the Go to X Definition function that lets you select a node that represents a reused definition Y and quickly find the node in the YANG Tree that represents the definition of the respective reusable code X For example one can select the node representing the expanded uses xyz statement and use the Go to Grouping Definition command to find the node representing the grouping xyz statement The nodes types Y on which the Go to X Definition command can be used are the following a expanded uses Go to Grouping Definition leaf or leaf list whose type is typedef Go to Typedef Definition typedef whose type is typedef Go to Typedef Definition leaf or leaf list with a base property Go to Identity Definition typedef with a base property Go to Identity Definition if feature Go to Feature Definition used extension Go to Extension Definition expanded augment Go to Augment Definition 0D D D D D DU OU LL 29 MG SOFT YANG Explorer User Manual Navigating and Exploring YANG Tree The Go to Definition can be seen as a reverse function of the Find Usages function and the Go to Target Node function for augments This section describes the basic principle of using the Go to Definition functionality in YANG Explorer 1 In YANG Tree panel select a reused node e g a node that represents an expanded
32. Web lt http took ietf org A Lus This type is used by data models that need to reference i description This module contains a collect configured interfaces B d revision 2014 05 08 E G interface state ref 11124 leafref E interface type EIE arbitrary names DH if interfaces if interface if name El pre provisioning EIN ifamib interface ref ietf interfaces GN description ie type m enabled m link up down trap enable g E ipva BHETipv6 H interfaces state B ietfipg2014 06 16 Be 3 namespace Uurnuetfzparams xm ins yang 3 prefix p B d import Teffinterfaces E D import effnef ypes E D import feffyang froes i organization TETF NETMOD NETCONF Ds L d contact WG Web htfp tools ietF ora A i description This module contains a collect E JP revision 2074 06 16 E E ipv4 non contiguous netmasks r1 mum Il Il I E lod n Figure 2 YANG Explorer desktop The following window panels form the working area a YANG Tree left panel Displays the hierarchical tree structure of the loaded YANG or YIN modules and submodules where module elements statements substaments are graphically represented as nodes in a hierarchical tree that can be expanded and collapsed LH 14 MG SOFT YANG Explorer User Manual Starting YANG Explorer Professional Edition a Node Details right panel The Node Details panel contains 3 tabs that display different views of the node subt
33. a exec default denied rpcs 4 denied data writes 2 By a rules al T common ule parms ZEE rule name z E allowed rights M isole Tm F Figure 6 Expanded subtree of a YANG module 4 Select any node in the YANG tree hierarchy to view its properties in the Node Properties panel on the right side of the main window Figure 7 LL 19 MG SOFT YANG Explorer User Manual E 4ffh ietf netconf acm 2011 03 11 bek secure be jk very secure e d nacm user name type e d nacm matchall string type d nacm ights type 2 d nacm group name type e 3 nacm action type e 3 schema instance identifier nam M gx nacm very secure ES 2 E read default B write default lB exec default denied rpcs lenied data writes Z F 1 groups Navigating and Exploring YANG Tree enable nacm Leaf Enable or disable all NETCOMF access control enforcement If true then enforcement is enabled If false then enforcement is disabled boolean true letf netconf acm nacm nacm nacm enable nacm Figure 7 Viewing the properties of a selected leaf node 5 1 3 To View the Property Sub Nodes The properties of any node can be displayed as sub nodes in the YANG Tree window panel These property sub nodes are not displayed by default 1 Right click a node and select the View Property Nodes Show for Subtree pop up command Figure 8 to display the property sub nodes for all nodes in the s
34. ance ref 12 prefix if ps 4f routing instance state ref Y PM rib ref Gm rib state ref t ew f route filter ref f route filter state ref 16 IETF NETMOD NETCONF Data Modeling Li Gl SY address family H A state entry id 18 contact a 3 router id 19 WG Web A putgoing interface 20 WG Li a 3 special next hop 3j 3 next hop dassifiers W next hop content EHAE route metadata E 4 routing state ig ss These modules were loaded E BB active route 1 ietf routing82014 05 24 ED B route count ietf ipv amp unicast routing 2014 05 25 H ietf system 2014 05 14 jetf ipv4 unicast routingf2014 05 24 4 Tm prefix rt Figure 25 Viewing the definition of a selected module node in the Source File tab 3 Click any node or sub node in the YANG Tree panel to view the corresponding section of the YANG source file that defines it Figure 26 4 Use the scrollbar to view other sections of the given YANG source file or click other sub nodes in the YANG Tree panel LL 35 MG SOFT YANG Explorer User Manual Navigating and Exploring YANG Tree H 4 routing state Node Properties Textual Data Tree Source File EF Cal routing E routing instance tod m name 672 type identityref 671 leaf type t H type 673 base routing instance type E deser 74 Z router id 675 default rt standard routing instance A description 676
35. asily find all leafref nodes in the given YANG module or submodule A leafref node is a leaf leaf list Or a typedef node with the leafref type property 1 In YANG Tree panel select a module node or submodule C node right click it and choose the Find Leafrefs command from the pop up menu Figure 21 2 YANG Explorer searches the entire YANG module or submodule for nodes with the leafref type property and displays results in a new Module Leafrefs tab that appears in the Output panel at the bottom of the main window Figure 22 LL 31 MG SOFT YANG Explorer User Manual Navigating and Exploring YANG Tree PS MG SOFT YANG Explorer Professional Edition Fi le Edit View Module Window Help aro 3 4 ietf netconf with defaults 2011 06 01 E a ietf r outing Da namespace Expand Entire Subtree Node Properties Textual Data Tree prefix Ff 99 Collapse Entire Subtree import efl dun 5 on View Property Nodes ietf routing Find Nodes Ctrl F Module Find Usages Ctrl Shift B ETE C Users Administrator De a j multiple rib a multipath r E Previous Node Selection Alt Left oy address fal 8 Net Node Selection Alt Right fet ipv4 H i Reload Module ee eee Unload Module B Uu routing protocol H 3 direct fy static E route filter a e deny all route filter Eg allow all route filter E GH routing instance ref E G routing instance state ref H GP rib ref
36. bute element for example this is possible if the element is specified by a YANG leaf statement of type enumeration bits or similar The autocomplete feature is XML namespace aware fs NETCONF Content Editor edit config xml File Edit Configure waite sditconfig i a xml verzion 1 0 encoding urf 8 7 rpc xmins urn ierf params zxml ns netconft base 1 0 a edit config ka target zxmlns ipfix urn ierf paramzs xml ns yang ietf ipfix psamp nlna nr 5 xmlns nc urn ietf paramz xml nz netconft base 1 0 LO candide E config xedit config a ipfix ipfix lt target ipfix collectingProcess nc ameration t zcandidate a Es ipfix name cp01 gt BEES e ln 4 lt target gt Inessage id co C n Bs E d j lt config gt a ipfix iprix j gt H ipfix collectingProacess nc operation create 1 cipfix name cp01c ipfix name gt xipfix udpCollector Input Modules lt ipfix name gt udp01 lt ipfix name gt kb kh si KA Uu e C Kb c io 4 ipfix localPort fipfix localPort U Sets the lifetime of Templates for all UDP Transport ipfix transportLayerSecurity gt fipfix transportLayerSecurity gt i Sessions terminating at this UDP socket Templates Ie lt ipfix locallPAddress gt lt ipfix locallPAddress gt il which are not received again within the configured z lifetime become invalid at the
37. c operations in MG SOFT YANG Explorer Professional Edition application Majority of instructions are provided on a step by step basis which should help the reader start using the software effectively It is supposed that you are familiar with using a graphical computer environment such as choosing a main menu command or a pop up command selecting items closing windows and dialog boxes etc All program commands in this manual are written in bold and italic letters Individual commands in combinations of commands are separated by the character For example Edit Preferences which means click the Edit entry in the menu bar and select the Preferences command from the Edit menu All hyperlinks in text are marked with blue colored letters e g Starting YANG Explorer Clicking a hyperlink opens the page which the hyperlink points to The content of this guide is listed in the Table of Contents Product Description MG SOFT YANG Explorer Professional Edition is special application that lets you load NETCONF YANG or YIN modules and explore their structure and properties in the intuitive graphical user interface The software can load any standard or vendor specific YANG or YIN module and display its contents in a visual manner where module elements are represented as nodes of different types in a hierarchical tree structure By expanding the YANG tree and selecting a node in the YANG Tree panel on the left side its properties
38. chically organized and represented in the tree structure containing nodes of different types You can expand and view the tree structure in the YANG Tree panel Figure 7 in the main window as well as view the YANG properties of any selected node as described in this section 5 1 Viewing Node Properties YANG Explorer lets you view the properties of any YANG Tree node as it is defined in YANG or YIN definition module Node properties are displayed in the Node Properties window panel 5 1 1 To View the Properties of a Module or a Submodule Node 1 In the YANG Tree panel select a module node f or submodule F node whose properties you want to view 2 Te Node Properties window panel on the right side of the main window displays all the properties of the selected module or submodule as defined in the corresponding YANG or YIN definition file e g name node type file path namespace prefix imports description etc Figure 4 Note that some of the properties are displayed only if the selected module or submodule has these properties e g imports includes contact revision description etc LL 17 MG SOFT YANG Explorer User Manual Navigating and Exploring YANG Tree P5 MG SOFT YANG Explorer Professional Edition Fille Edit Module Window Help amp e xP f at e ietf inet types ietfipfix psamp 2010 10 25 ietf netconf 2011 01 16 Module ietf netconf acm 2011 03 11 ietf netconf monitoring 20 10 10 C Users A
39. datastores XML instance files which contain both state and configuration data config Use this content type when you wish to edit validate configuration data only get Use his content type when you wish to compose an XML document for a NETCONF get request This content type lets you add get operation specific elements in addition to being able to edit a configuration For example it will let you specify a NETCONF filter element get config Use his content type when you wish to compose an XML document for a NETCONF get config request This content type lets you add get config specific elements in addition to being able to edit a configuration For example it will let you specify a NETCONF filter element edit config Use his content type when you wish to compose an XML document for a NETCONF edit config request This content type differs from config in that it lets you add edit config specific elements and attributes in addition to being able to edit a configuration For example it will let you specify a NETCONF operation attribute for each element of the config subtree rpc Allows you to create RPC operation requests based on RPC definitions available in the input modules and also lets you send a valid document as an RPC request the same way this is possible with the get get config and edit config content type notification Lets you validate or create examples of notifications defined in your input modules get reply Enab
40. des and Sub Nodaes oooooooooooW om Xl 21 5 2 Searching tor Node Se sn 23 5 3 Exploring Cross References in YANG Modules ooW Woo Woo Wo mm 25 So Using ine Find Usages Fealllle ab ii nama ea alae discuss EN 26 5 292 Using the Goo Target Node Fealufe suce er a te E ntu Ems 27 ol Usmnoihe GO lO Delnmion Feal te usc BEN taedio 29 5 3 4 Finding all Leafref Nodes in a YANG Module nk 31 5 3 5 Finding all Leafref References of a Leaf or Leaf List Node 33 54 Viewing YANG Source File o o o o mooocmukukek kam mh makanan 35 541 JFinding Text in SOUICC FICS bea NN dps RE 36 5 5 Viewing Textual Data Tree Diagram Wo W mm WWW ma 37 6 Loading YANG and YIN Modules in YANG Explorer 40 6 1 Loading YANG and YIN MOGUICS xi o o Wowoomen kaga 40 6 2 Scanning Folders for YANG and YIN Modules oo oWo W momo Wo Wa 43 6 3 Loading Known YANG and YIN ModuleS o WWo WWW 46 7 Viewing UML Class Diagram of YANG Modules 49 7A teltering UML Glass Diagram NER 53 7 2 Understanding the YANG Explorer UML Class Diagram o oooWo oom 56 Teed Maan na aa ss E aie bake hace 56 LAZ HACIQUOMSIIOS cR 56 Tie MA MA TERT TC 59 52 JADBOLSIIOTIS aerae at makanan anta TE non Cebu od CR Rcs QUE 59 LL 3 MG SOFT YANG Explorer User Manual Introduction 8 Using NETCONF Content Editor
41. description E ER agi 677 The type of the routing instance E Eu default ib Eh address family m i e ri leaf enabled Me rib name EE E interfaces 680 type boolean amp E m interface 68 default true B name 582 description f ipv6 router adv 683 Enable disabl E routing pratocols sed EMI routing protocol 525 If this parameter is false the parent ro h name ae disabled and does not appear in operational description ans eas ues ANREDE cM ana A enabled bai a 2 Any otner c onfiguration Il G 23 nt E ire ent Szi type Ee connected ribs 669 uses router id i o E J connected 690 description Ag UCoantigauration o the global router I Figure 26 Viewing the definition of a selected leaf node YANG Explorer automatically applies YANG syntax coloring when presenting a YANG file in the Source File tab YANG keywords are displayed in blue arguments in black descriptions in gray and comments in green letters 5 4 1 Finding Text in Source Files This section describes how to use the convenient Find toolbar to search for a user specified text string in the YANG file displayed in the Source File tab in the Node Details panel 1 Right click inside the in the Source File tab in the Node Details panel and choose the Find pop up command or press the CTRL F keyboard keys to display the Find toolbar at the bottom of the Source File tab Figure 27 Node Properties Textual Data Tree Source File C
42. dministrator Documents MGSOFT YangExplorerimodules win vetf inet ietf netconf par tialtock 2009 1 ietf netconf with defaults 20 10 urniletf params xmil ns yang letf inet types AP ietf yang types 20 10 09 24 A nc notifications 2008 07 14 inet AF notifications 2008 07 14 I A yuma new 2009 12 21 IETF NETMOD NETCONF Data Modeling Language Working Group a a Ja Ja Ja Ja Ja Ja e E This module contains a collection of generally useful derived YANG data types for Internet addresses and related things Copyright c 2010 IETF Trust and the persons identified as authors of the code All rights reserved Redistribution and use in source and binary forms with or without modification is permitted pursuant to and subject to the license terms contained in the Simplified BSD License set forth in Section 4 c of the IETF Trust s Legal Provisions Relating to IETF Documents http trustes ietf org license info This version of this YANG module is part of RFC 6021 see the RFC itself for full legal notices WG Web lt http tools ietf org wa netmod gt WG List lt mailto netmod ietf org gt WG Chair David Partain lt mailto david partain ericsson com gt Figure 4 Viewing the properties of the selected YANG module ietf inet types 5 1 2 To Expand the YANG Tree and Select a Node 1 In the YANG Tree panel select the root node root if you want to expand the hierarchical tre
43. e Note To install the software on Windows you need to have administrative privileges 2 Click the Start button and select the Run command 3 The Run dialog box appears Figure 1 Run meam _e ype the name of a program folder document or Internet resource and Windows will open it for you Open DAsetup exe Figure 1 Run dialog box 4 Into the Open input line type D setup and click the OK button LLI 10 MG SOFT YANG Explorer User Manual Installing YANG Explorer Professional Edition Note D is the letter assigned to the CD or DVD drive If your CD or DVD has a different letter type that one instead of D 5 Follow the instructions displayed on the screen Once the installation is complete you can start MG SOFT YANG Explorer program 2 2 2 Linux Operating System Before the installation please close all running MG SOFT applications and uninstall any previous version of MG SOFT YANG Explorer Professional Edition 1 Put the MG SOFT YANG Explorer Professional Edition CD into your CD ROM drive and mount the CD 2 The software comes in three different software packages rpm deb and tgz Depending on your Linux distribution run one of the following commands in a Terminal window to install the software a Linux distributions with the RPM package manager RHEL Fedora SUSE Mandriva etc a Ona 32 bit 1386 Linux distribution with the RPM package manager install the 32 bit RPM package
44. e Furthermore you can also select any leaf or leaf list node in the YANG tree and search for leafrefs that reference it by using the Find Referencing Leafrefs functionality MG SOFT YANG Explorer can visualize the selected YANG modules in form of a UML Unified Modeling Language class diagram UML class diagram displays different types of YANG nodes as classes with their attributes methods and relationships between the classes e g dependency composition inheritance etc You can explore the UML objects and their relationships either within the scope of a single or several associated YANG modules Furthermore YANG Explorer lets you focus on the desired elements of YANG modules by specifying excludes excluding specific user selected classes and by setting various display options to toggle displaying certain types of classes globally etc You can zoom in and out of the UML class diagram pan the diagram reposition classes and connections in the diagram print the diagram on a printer and save it as an image file for external use Last but not least MG SOFT YANG Explorer incorporates the RFC 6110 compliant NETCONF Content Editor and Validator tool This XML document editor with syntax coloring and auto complete feature lets you easily compose any type of NETCONF XML document and validate it using the DSDL schemas which are automatically generated from the selected YANG modules in the background The tool contains templat
45. e Help About command displays your license details correctly LL 16 MG SOFT YANG Explorer User Manual Navigating and Exploring YANG Tree 5 NAVIGATING AND EXPLORING YANG TREE When YANG Explorer is started for the first time it automatically loads all standard YANG modules that are included in the distribution and graphically displays loaded modules in the YANG Tree panel in the left portion of the main window Additional vendor specific YANG or YIN modules can be loaded by the user YANG is a data modeling language for the Network Configuration Protocol NETCONF YANG module defines a hierarchy of data that can be used for NETCONF based operations including configuration state data Remote Procedure Calls and notifications Typically a YANG module defines a tree of data elements that represent the configuration and runtime status of a particular network element managed via NETCONF A YANG module is normally stored in a file with the yang extension YANG modules can be translated into an equivalent XML syntax called YIN YANG Independent Notation allowing applications using XML parsers to operate on the models The conversion from YANG to YIN is lossless Typically a YIN module is stored in a file with the yin extension Submodules are partial modules that contribute definitions to a module A module may include zero or more submodules but each submodule may belong to only one module Loaded YIN and YANG modules are hierar
46. e d 20 14 02 08 E e ietf yang types 2013 07 15 ag off tailf aaai20 10 06 17 H tailf di extensions 20 10 12 02 Tail f Systems E tailf common 20 10 12 02 H 9 tailf meta extensions 20 10 08 19 E tailf xsd types 2009 03 17 tailf aaa uis HEEB 99999999999999999 Er Ed add E E E E Ee tailf Common C yang tail f tailf common yang This module defines the Tail f AAA data model Log Referencing Leafrefs x Module Leafrefs x PHASE 5 transformations applied These modules were loaded tailf xsd types 2009 03 17 tailf meta extensions 2010 08 195 tailf cli extensions 2010 12 02 tailf common 2010 12 02 Figure 33 Newly loaded modules displayed in the YANG Tree window panel LL 42 MG SOFT YANG Explorer User Manual Loading YANG and YIN Modules in YANG Explorer 6 2 The location of the standard YANG modules bundled with YANG Explorer depends on the operating system used Windows My Documents MGSOFT YangExplorer modules Windows Vista Windows 7 Windows Server 2008 C Users username Documents MGSOFT YangExploren modules yang Windows XP Server 2003 C Documents and Settings username My Documents MGSOFTYangExplorer modules yang Linux Documents MGSOFT YangExplorer modules home username Documents MGSOFT YangExplorer modules yang Mac OS X Documents MGSOFT YangExplorer modules Users username Documents MGSOFT YangExplorer modules
47. e root downwards If a matching node is found the tree structure from the root to the matching node is expanded and the node is selected in the YANG Tree panel Figure 14 m MG SOFT YANG Explorer Professional Edition File Edit View Module Window Help a s f a aS E W pre provisioning Node Properties Textual Data Tree Source File fi if mib E PM interfaces Po description Inter See cor El E interface ipv6 r D key name t 4 description The far P UNS Container amp B name ot description ce fa type Parameters for the IPv6 address family Br E enabled E B link up down trap en Enables IPv6 unless the enabled leaf wb if feature Tmt which defaults to true is set to false a type enumeratio it a enum eran This node was added through augment vail Find Nodes mm j Rss t 49 reference Find what ipv EN Br m ipv4 je ip ipv6 Ek E ipvs Mode type any type 3 IV interfaces state maa NG N o ovg 1 RE Match whole word only Direction Cancel je ip ipv6 5 config Take iL 3 description Daian Match case Up i Down interface L 4 key hame D description 774 EH name EL Figure 14 The found node is selected in the YANG Tree panel 8 If you would like to continue the search click the Find next button again or press the F3 keyboard key to search for the next node whose argument matches the search criteria The F3
48. e structure of all the loaded modules or a module or submodule node to expand and display the hierarchical tree structure of that sub module only 2 Right click the selected node to display the mouse context pop up menu and select the Expand Entire Subtree pop up command Figure 5 LL 18 MG SOFT YANG Explorer User Manual Navigating and Exploring YANG Tree PS MG SOFT YANG Explorer Professional Edition File Edit Module Window Help x f root H4 ietf inet types 20 10 09 24 ietf netconf acm fh ietfipfix psamp amp 2010 10 25 Ah Siege o 1 5 ietf netconf monit F Expand Entire Subtree ers Administ g ietf netconf partiz x Collapse Entire Subtree E ietf netconf with otf params xn ce ietf types View Property Nodes H 8 nc notifications H 8 notifications 200 m yuma ncx i2009 ee Previous Node Selection Alt Left H 4 ietf netconf 2011 01 16 Module G Find Nodes Ctrl F Figure 5 Expanding the subtree of a module in the YANG Tree panel 3 The hierarchy of the expanded subtree is displayed in the YANG Tree panel Figure 6 Ss 05 Tm n n e E f secure bek very secure nacm user name type d nacm matchall string type e d nacm ights type Re nacm group name type e nacm action type Re schema nstance identifier nacm very secure lB enable nacm AB read default AB write default n L
49. ear Edad Ce man Figure 44 Excluding elements e g schema node classes from UML class diagram Example The ietf interfaces YANG module contains the interfaces and interfaces state data subtrees If we want to focus only on the configuration portion of the data tree i e interfaces subtree we can exclude the state data portion of the module To do that select the iet f interfaces module from the LL 53 MG SOFT YANG Explorer User Manual Viewing UML Class Diagram of YANG Modules Owner drop down list in the Excludes tab of the UML Class Diagram Settings dialog box Then select the schema node entry from Class drop down list to display the top level schema nodes that are represented as classes ie interfaces and interfaces state in the Available list on the left hand side Select the interfaces state node in the Available list and click the right arrow button gt to move it to the Excluded list in the right portion of the dialog box and click the Apply button or the OK button to apply the changes and close the dialog box Figure 45 G B UML Class Diagram ex lt z BN ed 3 ietf yang typesin2013 07 15 letf interfaces 2014 05 03 UML Class Diagram Settings Excludes owner ietf interfaces 2014 05 08 Class schema node Available Exduded E P interfaces fifinterfaces state fifinterfaces state Sa Interface state ref s x
50. ect the Module Known Modules command from the main menu 2 The Known Modules dialog box appears listing all YANG and YIN modules that are currently known to YANG Explorer Figure 36 a Select a module in the list of known module files in the upper panel to view the module details location last modified date etc in the middle section and the module files it imports and submodules files it includes in the lower panel LL 46 MG SOFT YANG Explorer User Manual Loading YANG and YIN Modules in YANG Explorer a The status column in the list of known modules indicates the OK status if all dependencies imported module files and included submodule files for the given module are available a If the status of a module is not OK or if the status is OK but you would like to change the path of the files that will be imported or included by the module click the Browse button next to the Override column in the list of Imports or Includes Figure 37 Module Name Module Revision File Path tailf di extensions 2010 12 02 C Private Yang Modules Submodules tailf di extensions yang tailf meta exten 2010 08 19 Private fang Modules Submodulestailf meta extensions yang Figure 37 Specifying a different include file in the Known Modules dialog box a Inthe Edit Override dialog box that appears select the Browse entry and click the OK button to open the Load Module dialog box Figure 30 that lets you browse the file system a
51. elected subtree PS MG SOFT YANG Explorer Professional Edition File Edit Module Window Help sr F root Gl ietfinet types 20 10 09 24 H ietf netconf acn 20 11 03 11 H 4 ietf netconf partial4ock 2009 10 19 H 8 ietf yang types 20 10 09 24 E485 nc notifications 2008 07 14 EH netconf o ERE Er sin PS Expand Entire Subtree A T3 Collapse Entire Subtree View Property Modes T A replayCom A Find Nodes ff notification ex Previous Node Selection me notifications 8 i i E a t mat anaman E Next Node Selection Reload Module Unload Module Ctrl F Alt Left Alt Right streams Container The list of event streams supporta a query Is issued the returned se determined based on user privile This is a state data node Toggle for Selected Node Ctrl Right Ctrl Shift Right Ctrl Shift Left Show for Subtree Hide for Subtree Figure 8 Selecting the View Property Nodes for Subtree option in the YANG Tree panel L 20 MG SOFT YANG Explorer User Manual Navigating and Exploring YANG Tree 2 he property sub nodes 7 are displayed for all nodes in the selected subtree Figure 9 1 48 ietfinet types 20 10 09 24 Key al ietf yang types 20 10 09 24 H nc notifications22008 07 14 name EM netconf EM streams This is a state data node A M stream nc notifications manageEvent netconf manageEvent streams manageEve name description E replaySupport
52. en the corresponding dialog box Figure 40 to configure which YANG module s you want to include into UML diagram and optionally set other UML class diagram settings e g excludes display options UML Class Diagram Settings e e e e e e e e e e e e e iana crypt hash 2014 04 04 iana if type 2014 05 08 ietf inet typesig20 13 07 15 ietfinter faces 20 14 05 08 ietfHpfix psamp 2012 09 05 ietf netconf acmi20 12 02 22 ietf netconf monitoring 20 10 10 ietf netconf notifications 20 12 0 ietf netconf partialocki 2009 10 ietf netconf with defaultsig20 11 ietf netconfi20 11 06 01 ietf routing 22014 05 24 ietf system 2014 05 14 ietf x509 cert to name 20 14 02 ietf yang types 2013 07 15 ietf ipy4 unicast routing 20 14 05 ietf ipv6 unicast routing i 20 14 05 Focus on gh iethipi 2014 06 16 Figure 40 Selecting the YANG module for UML class diagram LU 49 MG SOFT YANG Explorer User Manual Viewing UML Class Diagram of YANG Modules 4 Inthe UML Class Diagram Settings dialog box in the Modules tab Figure 40 in the Available list on the left hand side select the YANG module whose UML class diagram you would like to view and click the right arrow button gt to select the module move it to the list on the right hand side Tip If the YANG YIN module you would like to include into UML diagram is not currently loaded in YANG Explorer you can click the Load button
53. ent and a config datastore part note that this may result in loss of certain information e g NETCONF operation attributes within an edit config s config element will be discarded if the content is converted to the config type etc a Besides the standard text editing features such as Find Replace and file operations Save Open New the editor also offers XML pretty printing capabilities Edit Format XML which will transform the entire document into a form that is easily readable LL 64
54. er node ooooooW Woo 39 Figure 30 Selecting the YANG modules to load into YANG Explorer o o W Wanna 40 Figure 31 YANG Explorer prompts you to provide the location of the required module 41 Figure s2s Loadirig a YANG MOdUlE iren itn t a node temas Uam trials san edu uu ance iud 41 Figure 33 Newly loaded modules displayed in the YANG Tree window panel 42 Figure 34 The Scan tor Modules dialog DOX oe fe a Pep ndius aget usta tt 43 Figure 35 The Known Modules dialog box listing YANG modules found in the scanned folder tree 45 Figure 36 The Known Modules dialog box viewing details of selected module 46 Figure 37 Specifying a different include file in the Known Modules dialog box 47 Figure 38 User overridden include submodule is displayed in blUe o Woo Woo oo 47 Figure 39 Loading selected YANG modules Wa 48 Figure 40 Selecting the YANG module for UML class diagram ooooW Wook 49 Figure 41 Viewing a portion of the UML class diagram of the etf jp YANG module 50 Figure 42 Viewing the relationships between classes of two modules in the UML class diagram 51 LL 5 MG SOFT YANG Explorer User Manual Figure 43 Figure 44 Figure 45 Figure 46 Figure 47 Figure 48 Fig
55. es for composing typical NETCONF document types such as RPC requests get get config edit config entire configuration datastores RPC replies etc By default the XML documents you are editing are being automatically validated in real time The NETCONF Content Editor window displays easy to understand error and warning messages if any inconsistencies are detected in the validated document This way one can quickly fix all syntax and semantic inconsistencies before saving them to XML file format MG SOFT YANG Explorer is a Java application that can be installed and used on Windows Linux and Mac OS X operating systems with Java Runtime Environment version 6 0 a k a JRE 1 6 or later installed LL 8 MG SOFT YANG Explorer User Manual Installing YANG Explorer Professional Edition 2 INSTALLING YANG EXPLORER PROFESSIONAL EDITION This section presents the basic system requirements your computer has to meet to install and use MG SOFT YANG Explorer Professional Edition and it describes the installing procedures for MG SOFT YANG Explorer on Windows Linux Mac OS X operating systems 2 1 Requirements MG SOFT YANG Explorer is a Java TM application that can be installed and used on Windows Linux and Mac OS X operating systems with Java Runtime Environment version 6 0 a k a JRE 1 6 or later installed Additionally administrator root user privileges are required to install the software 2 1 1 Windows Operating System The W
56. indows version of MG SOFT YANG Explorer has been tested on the following 32 bit and 64 bit Microsoft Windows operating systems a Windows XP Windows Server 2003 Windows Vista Windows Server 2008 Windows 7 Windows Server 2012 Windows 8 x D D D 0 0D 2 1 2 Linux Operating System The Linux version of MG SOFT YANG Explorer requires on the following 32 bit and 64 bit Linux distributions running on Intel x86 x86 64 architecture a Red Hat Enterprise Linux 5 or newer Fedora Core 8 or newer SUSE 11 or newer Ubuntu 9 or newer Slackware 13 or newer D D D L For the most recent information about the supported distributions please refer to the release notes READ ME TXT of the current software release LL 9 MG SOFT YANG Explorer User Manual Installing YANG Explorer Professional Edition 2 1 3 Mac OS X Operating System The Mac OS X version of MG SOFT YANG Explorer has been successfully tested by MG SOFT on a Mac OS X v10 6 x Snow Leopard Intel Mac OS X v10 7 x Lion Intel Mac OS X v10 8 x Mountain Lion Intel Mac OS X v10 9 x Mavericks Intel Mac OS X v10 10 x Yosemite Intel D D DU O 2 2 Installing YANG Explorer Before installing YANG Explorer Professional Edition on your computer please make sure your computer meets the system requirements described in the Reguirements section 2 2 1 Windows Operating System 1 Put the MG SOFT YANG Explorer Professional Edition CD into your CD or DVD driv
57. key lets you find the next matching node even after closing the Find Nodes dialog box 5 3 Exploring Cross References in YANG Modules YANG Explorer implements a wealth of features that let you effectively explore references between YANG statements within one or more YANG YIN modules as explained in this section LL 25 MG SOFT YANG Explorer User Manual Navigating and Exploring YANG Tree 5 3 1 Using the Find Usages Feature YANG Explorer incorporates the Find Usages command that lets you select a node in the YANG Tree that represents a reusable definition and quickly find all occurrences in the currently loaded YANG modules and submodules where this reusable definition is used Node types that represent reusable definitions are O grouping typedef extension feature 0 D D O identity 1 In YANG Tree panel select a reusable node e g a typedef node right click it and choose the Find Usages command from the pop up menu Figure 15 m MG SOFT YANG Explorer Professional Edition Fille Edit View Module Window Help set qef cm de Node Properties Textual Data Tree Source File 4 iana crypt hash 2014 04 04 H 9 iana if typeq22014 05 08 c3 E e ietf inet types 2013 07 15 E re ietfinterfaces 2014 05 08 namespace urrnetffnarams xm ns yang ietfante 8 prefix W import eff yang types organization TE7F NETMOD NETCONF Data Mode contact WG Web chtto fooks ietf org wgyhetmi This type is u
58. les you to validate or create examples of possible rpc reply messages defined by your input modules which would be created on server with a NETCONF get operation get config reply Enables you to validate or create examples of possible rpc reply messages defined by your input modules which would be created on server with a NETCONF get config operation rpc reply Enables you to validate or create examples of possible rpc reply messages defined by your input modules which would be created on server with any NETCONF RPC operation request 3 Once you have chosen a content type you can refine the schema behind it via the Configuration tabs There are currently two ways to refine the schema d by selecting input modules for the schema generation algorithm among all loaded YANG YIN modules and by selecting enabled features defined by the input modules To include or exclude a YANG YIN module select the Input Modules tab and click the Change button below it to open a dialog which will let you select the input modules Similarly you can enable or disable features in the Enabled Features tab provided that the selected input modules define features LL 62 MG SOFT YANG Explorer User Manual Using NETCONF Content Editor Each time you make a change to the settings above the schema that is used to validate your document may have to be re generated A progress bar dialog will appear each time this occurs temporarily preventing
59. ls after data node names means an optional node and denotes a list or leaf list node a Parentheses and enclose choice and case nodes and case nodes are also marked with a colon a Ellipsis stands for contents of subtrees that are not shown Click any data node container list leaf list leaf anyxml in the YANG Tree panel to view the corresponding textual data tree in the Textual Data Tree tab in the Node Details window panel Figure 29 oi interfaces Node Properties Textual Data Tree EHE interface E name AB description H type By enabled i m arenan T rw ip mtu uint16 x gl TNI rw ip address ip w ip ip inet ipv 4 address no zone a subnet T rw ip enabled boolean T rw ip forwarding boolean ea address prefix length EE m rw ip prefix length uint8 Eur subnet netmask Ely prefixtength rw ip netmask yang dotted quad 8 prefixdength rw ip neighbor ip Ely netmask rw ip ip inet ipvd address no zone f netmask rw ip link layer address yang phys address ed neighbor p E linkJayer address Figure 29 Viewing the textual data tree diagram of a container node To copy as text the contents of the Textual Data Tree tab select it right click it and choose the Copy command from the context pop up menu To save the contents of the Textual Data Tree tab to a plain ASCII text file txt click the Save
60. module files from that folder and optionally from all its subfolders are registered and can later be loaded from the Known Modules dialog box The Known Modules dialog box also lets you view and configure dependencies for each module that is the module s it imports and the submodule s it includes BG Known Modules Modified only Filter Load Module Name File Path Status al jietfinet types 20 10 09 24 IC Users Administrator Documents MGSOFTNetconfBrowser modules yang jetfinet types 20 10 09 24 yang lietf netconf acm amp 2011 03 11 IC Users Administrator Documents MGSOFTNetconfBrowser nodules yang Vetf netconf acm 20 11 03 11 yang ietf netconf base notifications 22011 06 13 Z Home SasoR WETCONF etf netconf base notifications draft 20 11 06 13 yang jietf netconf monitoring 20 10 10 04 IC Users Administrator Documents MGSOFTNetconfBrowser modules yang etf netconf monitoring 20 10 10 04 yang lietf netconf partial 4ock 2009 10 19 IC Users Administrator Documents MGSOFTNetconfBrowser nodules yang etf netconf par tial4ock 2009 10 19 yang a F jietf netconf with defaults 20 10 06 09 IC Users Administrator Documents MGSOFTNetconfBrowser modules yang Vetf netconf with defaults 20 10 06 09 yang lok 1 jietf netconf 2011 01 16 IC Users Administrator Documents MGSOFTNetconfBrowser nodules yang Vetf netconf 20 11 01 16 yang I tf yang types 220 10 09 24
61. n the Node Details panel to view the line of code in the YANG sub module that defined the referencing leafref node To quickly go back to the previous location node in the YANG Tree panel right click the current node and choose the Previous Node Selection or press the ALT keyboard keys LO 34 MG SOFT YANG Explorer User Manual Navigating and Exploring YANG Tree 5 4 Viewing YANG Source File The Source File tab in the Node Details panel displays the YANG source file i e YANG code that defines the node subtree currently selected in the YANG Tree 1 In the YANG Tree panel select a module or submodule node whose source file you would like to view and click the Source File tab in the in the Node Details panel 2 he respective YANG source file that defines the selected module or submodule is displayed in the Source File tab with the blue arrow marker IM pointing to the line where the given module submodule definition starts Figure 25 P MG SOFT YANG Explorer Professional Edition File Edit View Module Window Help e e gm amp urea De VLL Source File E multiple ribs module ietf routing namespace urn iertf paramsa 23 Z routing4nstance type Z standard routing instance routing protocol j Ag direct 7 import ietf yang types i static pner were gg route filter 3 Z deny all route filter i i allow all route filter 1 import ietf interfaces tua routing inst
62. n the last scan operation select the Last scan results only checkbox in the Known Modules dialog box 6 Tofilter results by file extension i e to view only modules saved in files with a specific filename extension select the desired extension e g yang yin form the Extension drop down list in the Known Modules dialog box 7 To filter results by text i e to view only those lines that contain a specific text string enter the desired text string into the Filter input line in the Known Modules dialog box 8 To view the entire known modules cache all the registered modules select the A11 entry from the Scan location drop down list in the Known Modules dialog box 9 To load one or more modules and their dependencies check the Load checkbox of the modules you want to load in the list of known module files and click the Load Selected button at the bottom of the Known Modules dialog box Figure 35 LL 44 MG SOFT YANG Explorer User Manual Loading YANG and YIN Modules in YANG Explorer Module revision 2011 05 14 File path CO YANG MG SOFT mgsoft cof ine 2011 05 14 yang Last changed 24 Jun 2011 14 25 17 Figure 35 The Known Modules dialog box listing YANG modules found in the scanned folder tree LL 45 MG SOFT YANG Explorer User Manual Loading YANG and YIN Modules in YANG Explorer 6 3 Loading Known YANG and YIN Modules Once a folder has been scanned for files that contain YANG or YIN modules all
63. n the selected module is validated and loaded a If you are prompted for any other missing module repeat the above procedure to specify its location Note Once a module has been loaded from disk this module and all other modules from the same folder and optionally all its subfolders are registered and can later be loaded from the Known Modules dialog box 5 After the selected module s have been successfully parsed and validated no syntax or semantic errors were found the module s are loaded and displayed in the YANG Tree panel in the left portion of the main window Figure 33 You can expand the loaded modules to view their tree structure and the properties of nodes as described in the next section PS MG SOFT YANG Explorer Professional Edition File Edit View Module Window Help e f qm T Es e ge F root Node Properties Textual Data Tree E e iana crypt hash 2014 04 04 fa 2 ianaif type 20 14 05 08 jetf net types 2013 07 15 ietf nterfaces 2014 05 03 ietfip 2014 06 16 ietf ipfix psamp 2012 08 05 ietf ipv4 unicast routing amp 2014 05 24 Module ietf ipv6 unicast routing 20 14 05 25 ietf netconfiz2011 06 01 C yang tail f tailf aaa yang ietf netconf acmie2012 02 22 ietf netconf monitoring 220 10 10 04 http tail f com ns aaa 1 1 ietf netconf natifications 20 12 02 06 ietf netconf partialJocki 2009 10 19 ietf netconf with defaults 2011 06 01 ietf outing 2014 05 24 iett system 20 14 05 14 ietf x 509 cert to nam
64. nce config when must if feature module properties Display dass descriptions Display dass descriptions in tooltips n zzconisineres interfaces F1 xe isi interface name string ley description string type identityref finterface typel mandatory enabled boolean true link up down trap enable enumeration enabled disabled fitteature itm Figure 46 UML class diagram etf interfaces without the state data typedef and identitity classes 3 Click the Apply button in the UML Class Diagram Settings dialog box to apply the changes without closing the dialog box or the OK button to apply the changes and close the dialog box LL 55 MG SOFT YANG Explorer User Manual Viewing UML Class Diagram of YANG Modules 7 2 Understanding the YANG Explorer UML Class Diagram YANG Explorer can display loaded modules in form of a UML Class diagram http www omg org spec UML 2 4 1 a structure diagram which shows the structure of the designed system at the level of classes and shows their features constraints and relationships 7 2 1 Classes The following YANG statements are represented as classes in the UML class diagram module submodule identity typedef grouping container list choice case notification rpc input output augment and deviation Other statements are either omitted for brevity appear as attributes or methods of a class or are represented as annotations Each class has a name an ic
65. nd select a different file containing the definition of the given submodule Figure 38 User overridden include submodule is displayed in blue 3 Check the Load checkbox of the modules and their dependencies you want to load in the list of known module files and click the Load Selected button at the bottom of the Known Modules dialog box Figure 39 LL 47 MG SOFT YANG Explorer User Manual Loading YANG and YIN Modules in YANG Explorer Modified only Load Module Name File Path otifications 2008 07 14 C Wsers Administrator Documents MGSOFTNetconfBrowser modules yang notifications 20083 07 14 yang tailf aaa 20 10 06 17 IC VPrivate Yang Modules tailf aaa yang Fj tailf di extensions 20 10 1 C Private Yang Modules Submodules Itailf di extensions yang tailf common 2010 12 02 C Private Yang Modules tailf common yang TT Itailf meta extensions 20 1 C Private Yang Modules Submodules tailf meta extensions yang tailf xsd types 2009 03 17 C Private Yang Modules tailf xsd types yang yuma ncx 2009 12 21 IC Users Administrator Documents MGSOFTNetconfBrowser modules yang yuma ncx 2009 12 21 yang tailf common 2010 12 02 C Private Yang Modules tailf common yang 20 Jan 2011 15 52 41 Wrivate Yang Modules Submodules tailf meta extensions yang Figure 39 Loading selected YANG modules 4 Known Modules dialog box closes and the selected modules load into the YANG
66. numeration boolean rw ip forwarding boolean uintl inet ipv address no zone T prefix length T rw ip prefix length uint yang dotted quad inet ipv 4 address no zone yang phys address boolean boolean uint32 rw ip 4 rw IW T rw ip rw rw T rwW ip T rw ip IW address ip ip ip ip prefix length uint8 neighbor ip ip ip ip link layer address yang phys address dup addr detect transmits uinrt32 autocont ip create global addresses inet ipv amp address no zone inet ipv amp address no zone boolean ietf systemf2014 05 14 Figure 28 Viewing the textual data tree diagram of a YANG module This format is commonly used in IETF NETMOD NETCONF Data Modeling Language Working Group mailing lists Internet Draft and RFC documents The meaning of the symbols in textual data tree diagrams is as follows a Abbreviations before data node names rw means configuration read write ro state data read only n denotes a notification and x stands for rpo a Data type of every leaf node is shown near the right end of the corresponding line e g string uint32 boolean etc a Brackets and enclose list keys a Curly braces and contain names of optional features that make the corresponding node conditional LL 38 MG SOFT YANG Explorer User Manual Navigating and Exploring YANG Tree a Symbo
67. o oo om om oo momo 61 LL 4 MG SOFT YANG Explorer User Manual Introduction TABLE OF FIGURES Figure Run dialOg DOK dt 10 Foure 2 YANG EXDIOFGEOOSKIOD united aaa anna 14 Figure 3 Selecting and applying the license key file oooWoW Won 16 Figure 4 Viewing the properties of the selected YANG module ietf inet typeS ooo om 18 Figure 5 Expanding the subtree of a module in the YANG Tree panel oooo W W momo XX 19 Figure 6 Expanded subtree of a YANG module Wo W o W Km Kana 19 Figure 7 Viewing the properties of a selected leaf node oocoo W Wo oom Woman 20 Figure 8 Selecting the View Property Nodes for Subtree option in the YANG Tree panel 20 Figure 9 Viewing the properties of a property sub node oooo Woo Woo Wa 21 Figure 10 Node icons in the YANG Tree panel representing different types of YANG statements 22 Figure 11 Example of configuration and state data nodes displayed in the YANG Tree panel 23 Figure 12 Selecting the Find Nodes command in the YANG Tree panel eese 24 Figure 13 Specifying the search options in the Find Nodes dialog box WW oo oW Wo 24 Figure 14 The found node is selected in the YANG Tree panel ooooooooooW Woo 25 Figure 15 Selecting the Find USAGES command oo W W oom Wa 26
68. odule command from the main menu The Load Module dialog box appears Figure 30 In this dialog box navigate to the folder containing the private YANG or YIN module s select one or more modules use the CTRL or SHIFT keyboard key to select more than one module and click the Open button B Load Module Look in ivate Yang Mod m d eeu tailf aaa yang ja taif common yang jai tailf xsd types yang Tip To select more than one file to load hold down the Ctrl key on the keyboard and click the desired module files Figure 30 Selecting the YANG modules to load into YANG Explorer 4 YANG E xplorer first starts scanning the current folder for files that contain valid YANG and YIN modules to build a list of known modules i e for all modules it detects the module name its revision and full path of the file defining this module is stored in the LO 40 MG SOFT YANG Explorer User Manual Loading YANG and YIN Modules in YANG Explorer program cache known modules list for future use When done YANG Explorer stars parsing the selected YANG or YIN module s and checking their consistency While parsing the module s the progress and error messages are being logged in the Log window panel at the bottom of the main window During this process every module is also checked for dependencies i e the modules it imports and submodules it includes this is done recursively for all referenced modules a If any dependency is found
69. on and a stereotype included in lt lt gt gt identifying the statement it represents Many classes have attributes e g container with leaf child nodes etc or methods notification which if present are displayed below the separator line in the class box Figure 47 stereotype icon i ipvG u name enabled boolean true forwarding boolean false mtu uint32 1280 max 1units octets dup addr detect transmits uint32 1 attributes Figure 47 Example of a container class Note In YANG Explorer you can select which types of classes will be displayed in the UML diagram as well as whether to display the packages annotation and descriptions This can be configured in the UML Class Diagram Settings dialog box Misc tab 7 2 2 Relationships A relationship between two classes is represented with a directed line and can be one of the following a composition is part of O ELLE gt dependency depends on a I generalization inherits from a navigable association has alternative LL 56 MG SOFT YANG Explorer User Manual Viewing UML Class Diagram of YANG Modules Composition represents a tight coupling relationship between classes and is read as is a part of in the direction of the arrow An example composition relationship is one connecting a top level container class and the class representing a module container ipv4 enabled
70. onfiguration and operational state data tree of the selected module or submodule is displayed in the Textual Data Tree tab using ASCII characters only e g Figure 28 LL 37 MG SOFT YANG Explorer User Manual Navigating and Exploring YANG Tree PS MG SOFT YANG Explorer Professional Edition File Edit View Module Window Help oreo w EE fictf interfaces 2014 05 08 Lg interface ref fr interface state ref interface type M arbitrary names LN pre provisioning P interfaces B J interface AB link up down trap enable EE ipy4 i m enabled id a forwarding mtu e address Elus prefixJength 8 prefixtength EFE ipve oof enabled 2 Lay forwarding m mtu ed address A prefixJength eu neighbor PO p A linktayer address Wh dup addr detect transmits f autoconf m create global addresses m treate temporary addresses m temporary valid ifetime M temporary preferred ifetime i n Node Propertie J Textual Data Tree l ource File module ietf interfaces rw interfaces rw interface name rw name description type enabled 7 ip ipw4 T rw ip enabled T rw ip mtu ip address ip ip ip subnet T netmask rw ip neighbor ip rw ip ip rw ip ipv T rw ip enabled rw ip forwarding T rw ip mtu link up down trap enable T rw ip netmask T rw ip link layer address string string identityref boolean e
71. re Subtree ai F ji gi View Property Nodes g i i 3 Find Nodes Ctrl F B iy Find Usages Ctrl Shift B Bud eae Figure 12 Selecting the Find Nodes command in the YANG Tree panel 2 Into the Find what input line in the Find Nodes dialog box enter the name or part of the name of the node you are looking for Find Nodes Find what lipv Node type Match whole ar Cancel Match case 3 argument 4 augment J base 3 belongs to 3 bit Figure 13 Specifying the search options in the Find Nodes dialog box 3 From the Node type drop down list optionally select the type of the node or sub node you are looking for If the any type option is selected YANG Explorer will search all types of nodes and sub nodes and find the first one from the selected node root whose argument contains the string specified in the Find what input line 4 Select the Down radio button in the Direction frame see Figure 14 to enable searching in the direction downward from the selected node 5 Optionally select the Match case it makes search case sensitive and Match whole word only it finds only occurrences that are whole word not part of a larger word checkboxes if they are applicable to your search 6 Click the Find next button LL 24 MG SOFT YANG Explorer User Manual Navigating and Exploring YANG Tree 7 YANG Explorer starts searching for the matching node or sub node in all loaded modules from th
72. ree selected in the YANG tree panel as follows a Node Properties tab Displays the properties of the node selected in the YANG Tree panel in form of a table a Textual Data Tree tab Displays a simplified text based data tree diagram commonly used in IETF NETMOD publications of the node subtree selected in the YANG Tree panel a Source File tab Displays the section of the YANG code in the respective YANG source file that defines the selected node subtree Q Output bottom panel The Output panel contains the Log tab which displays application log records that indicate module compilation loading and validation progress and error messages In addition to the Log tab this panel can also display additional tabs that are created when specific functions are used in YANG Explorer e g the Usages tab appears after selecting the Find Usages command the Module Leafrefs tab appears after choosing the Find Leafrefs command etc All these commands and the corresponding tabs are described in the respective subsections of the Exploring Cross References in YANG Modules section The above listed window panels are arranged side by side in the main window Window panels can be resized by dragging their borders Additional windows and dialog boxes can be opened from the program menu toolbar and the pop up context menu LL 15 MG SOFT YANG Explorer User Manual Applying License Key 4 APPLYING LICENSE KEY To use MG SOFT YANG Explorer without limi
73. ription The Est of interfaces on he Erid name interface state ref pet type F3 admin status oper status last change if index EL phys address 9 type Yanguhys address 3 description The inter ace s address D reference RAC 2863 The Interfaa higher ayer f D description H Ast of references fo reference RAC 2863 The Inter aa SA lower ayerif OM Usages of typedef interface state ref 3 occurrences Lg type Wier ace statever i EA o ietf interfaces 3 description A Ast of references fo e 4 D reference RAC 2863 The Interfaa 9 444 type interface state ref speed Bae ietf routing type yang gauge64 i 476 type ifinterface state ef D units Sis Second ietf interfaces if zinterfaces state if interface if Figure 16 Inspecting the usage of the selected reusable element 3 Double click a usage entry in the Usages tab to quickly display the node in the sub module in the YANG Tree panel where the reusable definition is being used Figure 16 4 Switch to the Source File tab in the Node Details panel to view the line of code in the YANG sub module where the reusable definition is used 5 To quickly go back to the previous location node in the YANG Tree panel right click the current node and choose the Previous Node Selection or press the ALT keyboard keys 5 3 2 Using the Go to Target Node Feature YANG Explorer features the Go to Target Node function
74. rt the settings in this dialog box to the default values 3 Click the OK button to close the Scan for Modules dialog box and start scanning the selected folder YANG Explorer scans the specified folder and its subfolder if selected SO for files that contain valid YANG and YIN modules to build a list of known modules i e for all modules it detects the module name its revision and full path of the file defining this module is stored in the program cache known modules list for future use During the scan operation every module is also checked for dependencies i e YANG Explorer verifies if all the module s it imports and submodule s it includes are available The progress of the scan operation is displayed in the Module scan dialog box 4 When the scan operation finishes the results are displayed in the Known Modules dialog box Figure 35 a Select a module in the list of known module files in the upper panel to view the module details location last modified date etc in the middle section and the module files it imports and submodules files it includes in the lower panel a The status column in the list of known modules indicates the OK status if all dependencies imported module files and included submodule files for the given module are available If the status of a module is not OK you can specify the location of the missing sub module as described in this section 5 To view only the new modules that have been found i
75. s EH d revision 2014 05 08 Hg Tajinterface sefi leafref H type Tes M Expand Entire Subtree ue 3 descripti T3 Collapse Entire Subtree E QM interface sta a interface typ View Property Nodes i Wil descriptid E E arbitrary nar H E pre provisior Find Usages Ctrl Shift B H if mib 1 P interfaces e B idnterfaces st Next Node Selection Alt Fight 3 e ietip22014 08 Go To Target Node Po Pe namespace B prefix p Reload Module 3b import ez 3 B import i i Unload Module 3 import Jeff yang types Figure 17 Selecting the Go to Target Node command on a leafref typedef node interface ref Typedef if interfaces if interface if z name Find Nodes Ctrl F ietf interfaces it interface ref Previous Node Selection Alt Left 2 The node that represents the respective target node e g a leaf node that the given leafref path points to becomes selected in the YANG Tree panel so you can view its properties textual data tree diagram or source code depending on the tab selected in the Node Details panel Figure 18 LL 28 MG SOFT YANG Explorer User Manual Navigating and Exploring YANG Tree W ajaa J Node Properties Textual Data Tree Source File dg namespace ULrnetfzparams xminse yangsetFanterh II z prefix W E d import Te f yang types Wi organization ETF NETMOD NETCONF Data Modet contact MG Web hip toos ieii org Wwgheimot B description 77s
76. s information and collected statistics 5 2 Searching for Nodes YANG Explorer lets you search for nodes and sub nodes whose argument contains a user specified text string For main YANG nodes this argument is node name while for sub nodes the argument can be any text e g the argument of a description property sub node is the entire description text Furthermore the software lets you search for and find all nodes and sub nodes of a certain type To do this select the desired type e g a container Or leaf Or description Of config Or base etc from the Node type drop down list and repeatedly press the Find Next button in the Find Nodes dialog box to walk through nodes of selected type Optionally you can combine both search conditions to find a sub node of a certain type whose argument contains a user specified string Search is performed on all the loaded YANG and YIN modules and one can start the search operation from the desired node in the YANG Tree panel LL 23 MG SOFT YANG Explorer User Manual Navigating and Exploring YANG Tree To find a YANG tree node start searching from the root node 1 Right click the root node in the YANG Tree panel and select the Find Nodes pop up command Figure 12 The Find Nodes dialog box appears Figure 13 Fa MG SOFT YANG Explorer Professional Edition File Edit View Module Window Help org Miroot Ln gam i PZ Expand Entire Subtree Ad ii 74 Collapse Enti
77. sed by data mda description Tis module contains a collection of YA the operationally present inte revision 27 14 05 05 td anm leafref X4 E d Expand Entire Subtree arbitrary names P9 Collapse Entire Subtree fif interfaces s gt a View Property Nodes terfa e 3 Find Nodes Ctrl F interfaces state m ietipQ2014 06 16 Ses Ctrl Shift B if interface state ref ietfipfix psamp 201 Previous Node Selection Alt Left e ietFipv4 unicastrouti ietfipvG unicast routi P Met Node Selection Alt Right ietf netconf 2011 0 V Locate Leafref Destination ietf netconf acm ge 20 Reload Module Validation of ietf ipv6 un ietf netcanf natificatir Validation completed Warnir Unload Module ietf netconf partialfow_ ietf netconf with defaults 20 11 06 01 PHASE 5 transformations apr ee interface state ref Typedef m e trm ietf interfaces m Jg 6 t E E EN Ed Ed Ed E a E E Figure 15 Selecting the Find Usages CONO LL 26 MG SOFT YANG Explorer User Manual Navigating and Exploring YANG Tree 2 A new Usages tab appears in the Output panel at the bottom of the main window The Usages tab lists all occurrences in the loaded modules and submodules where the reusable node is used Figure 16 eT config ase d 3 description Daia nodes for the operational interface r 3 key hame Type j desc
78. sktop appears and you can start using the software Please refer to the Applying License Key section for instructions on how to apply your license Tip To start the software from the command prompt open the Terminal window CD to the directory where the mgYangExplorer jar file is usr local mg soft mgyangexplorer java and run the following command java jar mgYangExplorer jar 3 1 3 Mac OS X Operating System Open the Finder and select the Applications entry in the panel on the left Select and double click the MG SOFT YANG Explorer app icon to start the YANG Explorer application The YANG Explorer desktop appears and you can start using the software Please refer to the Applying License Key section for instructions on how to apply your license LL 13 MG SOFT YANG Explorer User Manual Starting YANG Explorer Professional Edition 3 2 YANG Explorer Desktop The YANG Explorer desktop is composed of typical graphical user interface components like the title bar menu bar toolbar and the working area lia tM MERE PS MG SOFT YANG Explorer Professional Edition File Edit View Module Window Help Ara Node Properties Textual Data Tree H iana crypt hash 2014 04 04 E iana if type 2014 05 08 c3 EP ietfinet types 2013 07 15 EP ietf nterfacesi2014 05 08 Le 3 namespace urnetffiarams xm ns yang i gib prefix W E 3 import eff yang types GRH Typedef L organization TETF NETMOD NETCONF Ds d contact WG
79. t output rt iroute rt next hop op V f rt rauting state rt routingdnstance frt interfaces frt inter ietf routing 2014 05 24 593 3 rterouting state rt ribs rt rib rt routes rt route rt V9 rt routing state rt routing instance rt interfaces rt inter ietf routingg2014 05 24 984 Lat rt active route rt output rt iraute rt next hop op V3 rt routing state rt routing instance rt interfaces rt inter ietf routing 2014 05 24 593 4 rtrouting state rtribs rtrib rtroutes rtroute rt Ve rt routing state rt routing nstance rt interfaces rt inter p PI HN cat 14 05 24 164 rt routing rt routing instance rt routing protocols Ves Prouingrtroutng nstencs ire e rtrouting rt routing nstance rt routing protocols Figure 22 The list of found eafrefs displayed in the Module Leafrefs tab in the Output window LL 32 MG SOFT YANG Explorer User Manual Navigating and Exploring YANG Tree 4 Right click an entry in the Module Leafrefs tab and choose the Go to Leafref pop up command to quickly find and select the given leafref node in the YANG Tree panel 5 Right click an entry in the Module Leafrefs tab and choose the Go to Target Node pop up command to quickly find and select the node in the YANG Tree panel that the leafref path ofthe given leafref node points to 6 To quickly go back to the previous location node in the YANG Tree panel right click the current node and choose the Previous Node Selection or press the
80. tations you need to apply a valid license key file to the software as follows 1 Select the Help Apply License Key command from the main menu or click the E Apply License toolbar button the latter is displayed only when the software is run without a valid license key file in place 2 Adialog box appears that lest you select and apply your license key Figure 3 PG Please provide your license key P y Look in iy Local Disk C i cm n n PerfLogs ee E Program Files Recent Items n ProgramData di Users license key My Documents A eng Computer ile name license key Tw Files of type Key file key Figure 3 Selecting and applying the license key file 3 Navigate to the drive and folder containing your 1icense key file for MG SOFT YANG Explorer Professional Edition select the 1icense key file and click the Apply License button in the license key selection dialog box 4 The software will copy the selected 1icense key file to the proper location in order for YANG Explorer to read it and unlock its features after a restart 5 Exit YANG Explorer by choosing the File Exit command and restart it as described in the Starting YANG Explorer section Now the selected license should be applied and you can start using the software without licensing restrictions Tip You can check if the license key has been properly applied by verifying if the About YANG Explorer dialog box accessible via th
81. te from other statements e g augment extension node originating from an augment statement e g e in A node originating from use of a grouping or extension e 9 m gk leafref node leaf or leaf list node with the 7eafref type property e g B mi leaf node that is a key ofa list i e Wy x F node originating from use of a grouping in an augment statement e g e LL 22 MG SOFT YANG Explorer User Manual Navigating and Exploring YANG Tree About configuration and state data nodes Note In contrast to configuration data nodes which are depicted with normal colored icons the state data nodes are depicted with light colored translucent icons in the YANG Tree panel Figure 11 This principle lets you quickly distinguish between configuration e g read write and state data read only nodes in the YANG tree For example configuration data nodes state data nodes light colored icons configuration data nodes Figure 11 Example of configuration and state data nodes displayed in the YANG Tree panel RFC 4741 section 1 3 The information that can be retrieved from a running system is separated into two classes configuration data and state data Configuration data is the set of writable data that is required to transform a system from its initial default state into its current state State data is the additional data on a system that is not configuration data such as read only statu
82. thi Mas L 4 key hame Referencing Leafrefs x pe D unique Ar pe 3 description Each st entry amp ac nas E wj B gj Th Referencing leafrefs of leaf rtrouting state rtrouting instance rtinterfaces rtinterface rename 7 occ name B ietfrouting 2014 05 24 id A E 252 leaf rt outgoing interface rt outgoing interface type AB 350 leaf rt next hop content rt next hop options rt simple next hop rt outgoing nterface routerid 352 leaf rt next hop content rt next hop options rt next hopdist rt next hopJist rt next hop rt outgoing int j al default ribs 5284 leaf rtactive route rtoutput rtroute rt next hop options rt simple next hop rt outgoing inter face EE interfaces Z 595 leaf rt routing state rt ribs rt rib rt routes rt route rt xnext hop options rt simple next hop rt outgoing i 3 D description Ne work layer LM 254 leaf rt active route rt output rt route rt next hop options rt next hopJist rt next hopdist rt next hop r interface 8 535 leaf rt routing state rt ribs rt rib rt routes rt route rt next hop options rt next hopist rt next hopJist 3 key tame H b description List ofnetw _ io mm j Figure 24 Exploring the referencing leafrefs Double click a referencing leafref entry in the Referencing Leafrefs tab to quickly display the leafref node in the YANG Tree panel which points to the leaf or leaf list node selected in step 1 Switch to the Source File tab i
83. ton to write the image file to disk LL 52 MG SOFT YANG Explorer User Manual Viewing UML Class Diagram of YANG Modules 7 1 Filtering UML Class Diagram By default UML Class Diagram displays all classes of the selected YANG module s It also displays class annotations as UML comments and class descriptions in tooltips However YANG Explorer lets you control which elements of the selected YANG module s will be shown in the UML class diagram and which not This can be achieved by configuring the excludes by excluding specific user selected classes and by setting the display options to enable disable displaying certain types of classes globally e g typedef leafref identity etc select whether to display class packages annotations descriptions Excludes and display options can be configured in the UML Class Diagram Settings dialog box on the Excludes tab and Display Options tab 1 To exclude certain elements from the UML class diagram click the toolbar button to open the UML Class Diagram Settings dialog box switch to the Excludes tab and select the types of nodes and their instances you want to exclude from the diagram Figure 44 UML Class Diagram Settings Modules Exdudes Display Options Owner e ietf interfaces i20 14 05 08 Class schema node Exduded ct interfaces gt ffinterfaces state MM interface a All Excludes Af interfaces state
84. ture 4 NETCONF content Tree editor panel represents the currently edited XML document in a tree form and lets you edit the tree 5 Informational text area containing description of the currently selected tree node if the corresponding YANG module provides it 6 Configuration tabs which let you refine the current schema YANG modules features 7 Notification area displaying the validation errors File Edit Configure K u A A a edit config lt rpc xmlns urn iertf params xml ns netconf base 1 0 E i Si E 4 meer lt edit config gt i z 4 target lt target gt Lg candidate 4 lt candidate gt lt target gt lt fedit config gt z rpc Input Modules Enabled Fea tures change 6 Input Module Namespace ietf interfaces 20 11 urn ietf params xml ietfipfix psamp 20 urn ietf params xml ietf ipv4 unicast rout urn ietf params xml Error at 2 54 element rpc missing required attribute message id Error at 8 19 element edit config incomplete missing required element config Figure 54 NETCONF Content Editor window LL 61 MG SOFT YANG Explorer User Manual Using NETCONF Content Editor 2 After opening the NETCONF Content Editor window select the type of content you wish to edit or validate by selecting it from the Content type drop down list in the toolbar You can choose between these content types d data Use this content type to edit validate entire
85. ure 49 Figure 50 Figure 51 Figure 52 Figure 53 Figure 54 Figure 55 Introduction Setting the print options for printing UML class diagram as a 2x2 poster 52 Excluding elements e g schema node classes from UML class diagram 53 Example of UML class diagram ietf interfaces without the state data classes 54 UML class diagram etf interfaces without the state data typedef and identitity classes 55 Example ola contamef GIASS qus Paten Favuscuztastesd a sieQvs veut usecase DA Facio bxc Det beue 56 Example of a composition is part of relationship between UML classes 57 Example of a dependency depends on relationship between UML classes 57 Example of a generalization inherits from relationship between UML classes 58 Example of a navigable association relationship between UML classes 58 Example of a package containing all classes of a module oo ooWoW WooWoo 59 Viewing annotations and descriptions UML comments shown in dark yellow notes 60 NETCONF Content Editor window na 61 Using the autocomplete feature in the NETCONF Content Editor window 63 LL 6 MG SOFT YANG Explorer User Manual Introduction 1 1 INTRODUCTION This document contains instructions for completing basi
86. you from editing the document The main purpose of the schema is to enable document validation NETCONF Content Editor also uses it for the autocomplete feature that is available when writing XML documents Note Actually three different schemas are automatically generated in the background a Relax NG schema a DSRL schema Document Schema Renaming Language schema and an ISO Schematron schema but for simplicity reasons we refer to them as if it were a single schema the schema files are generated in the following folder SUSER HOME mgyangexplorer schemas 4 Edit your document in the NETCONF content editor When you start writing an XML tag the editor will assist you with the autocomplete feature which displays a list of all possible elements defined by the schema The autocomplete drop down list of choices appears in the NETCONF content editor panel when you type in the character or when you press the CTRL Space keyboard keys when the cursor is placed where completions are possible Select an item in the autocomplete drop down list to view its description from YANG module in a tooltip next to the selected item Figure 55 Press the Enter key to insert the selected item into the NETCONF content editor panel Note Autocomplete is provided for XML elements attributes and their values Note that completions for attribute and element values will only be provided if a set of possible values can be determined for the current attri

YANG Explorer - MG

Contents

Download Pdf Manuals

Related Search

Related Contents