[{"_1":2,"_155":-5,"_156":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_134":135},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_125":-5,"_126":11,"_127":17,"_128":11,"_129":-5,"_130":11,"_131":-5,"_132":133},"canonicalUrl","https://hub.docker.com/r/robertcsapo/yang-explorer/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","robertcsapo","reponame","yang-explorer","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":58,"_60":61,"_62":-5,"_63":64,"_65":66,"_67":11,"_68":29,"_69":70,"_75":17,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2016-08-02T19:55:40.411906Z","description","An open-source Yang Browser and RPC Builder Application","is_private","last_updated","2017-10-07T16:23:33.665259Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",2534,"repository_type","star_count",1,"status","status_description","active","source","collaborator_count",0,"full_description","Copyright 2015, Cisco Systems, Inc\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\nhttp://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n\n### Docker support\n**Run** \n```docker run -it --rm -p 8088:8088 robertcsapo/yang-explorer```\n\n**Build** \n```git clone https://github.com/robertcsapo/yang-explorer.git``` \n```cd yang-explorer``` \n```docker build -t robertcsapo/yang-explorer .``` \n\n###1. Description\n An open-source Yang Browser and RPC Builder Application to experiment with Yang Data Models\n \n **Features**\n - Upload / Compile yang models from User Interface Or Command Line\n - Build NetConf RPC\n - Generate Python example code **[new]**\n - Search yang xpaths **[new]**\n - Execute RPC against real netconf server\n - Save created RPCs to collections for later use\n - Build dependency graph for models\n - Browse data model tree and inspect yang properties\n \n Restconf support is **experimental**\n \n This application is under Beta mode, contributions / suggestions are welcome !!\n\n#####Screenshots:\n ![alt tag](https://github.com/CiscoDevNet/yang-explorer/blob/master/docs/images/explorer.png)\n ![alt tag](https://github.com/CiscoDevNet/yang-explorer/blob/master/docs/images/graph.png)\n ![alt tag](https://github.com/CiscoDevNet/yang-explorer/blob/master/docs/images/script.png)\n ![alt tag](https://github.com/CiscoDevNet/yang-explorer/blob/master/docs/images/netconf-operations.png)\n\n###2. Installation\n####2.1 First time installation\n#####Prerequisite:\n - MAC, Linux (not supported on Windows)\n - python 2.7\n - pip package manager (https://pip.pypa.io/en/stable/installing/)\n```bash\n If already installed, make sure that pip / setuptools are upto date (commands may vary)\n \n pip install --upgrade pip\n \n Ubuntu: sudo pip install --upgrade setuptools\n```\n - virtualenv (recommended)\n```bash\n Ubuntu: sudo apt-get install python-virtualenv\n Fedora: sudo dnf install python-virtualenv\n MAC: sudo pip install virtualenv\n```\n - graphviz (http://www.graphviz.org/Download.php)\n```bash\n Ubuntu: sudo apt-get install graphviz\n Fedora: sudo dnf install graphviz\n MAC: brew install graphviz\n```\n - Browser with latest flash plugin (tested with google chrome)\n\n#####Download and install:\n```bash\n git clone https://github.com/CiscoDevNet/yang-explorer.git\n cd yang-explorer\n bash setup.sh\n\n Note: sudo may be required if you do not use virtualenv.\n```\n See section 7 Troubleshooting for more:\n```bash\n If you get installation error for missing python.h or xmlversion.h try installing\n dependency packages:\n \n Ubuntu: sudo apt-get install libxml2-dev libxslt1-dev python-dev zlib1g-dev\n Fedora: sudo dnf install libxml2-devel libxslt-devel python-devel zlib-devel\n```\n####2.2 Update exising installation\n\n```bash\n cd /yang-explorer\n git stash (if you have local changes)\n git pull origin\n git stash apply (if you have local changes)\n bash setup.sh\n```\n####2.3 Backing up data\n\n YangExplorer data can be backed up from data directory and it is portable to new servers -\n```bash\n cp -r /yang-explorer/server/data /data\n```\n\n **Restore from backup location -**\n```bash\n cd /yang-explorer/server\n\n # move current data to tmp location\n mv data data_old\n \n # replace data from backup location\n cp -r /data data\n```\n\n###3. Running YangExplorer\n####3.1 Running with localhost\n#####Start Server:\n```bash\n cd /yang-explorer\n [sudo] ./start.sh &\n\n Note: sudo may be required if you did not use virtualenv during installation.\n```\n\n#####Start Explorer:\n```bash\n http://localhost:8088/static/YangExplorer.html\n```\n####3.2 Running with ip-address (Shared server)\n#####Start Server:\n```bash\n # Determine using if-config\n \n # Add ip-address/port in YangExplorer.html after following line:\n cd /yang-explorer/server/static\n vi YangExplorer.html\n var flashvars = {}; \n+ flashvars.host = '';\n+ flashvars.port = '8088';\n\n # save & quit\n\n # Update ip-address in startup script\n cd /yang-explorer\n vi start.sh\n (update HOST variable with )\n # save & quit\n \n ./start.sh\n\n Note: sudo may be required if you did not use virtualenv during installation.\n```\n\n#####Start Explorer:\n```bash\n http://:8088/static/YangExplorer.html\n```\n\n###4. Caveats\n - Yang Model upload fails, Workaround: Use Google Chrome.\n - See section 6 Troubleshooting for more:\n\n###5. User Guide (TBD)\n\n####5.1 Work Flow\n\n#####5.2.1 Login:\n YangExplorer uses user accounts to manage workspaces. You can create a user account using admin page (See 5.3.1 Creating User Account) or use the predefined login (guest/guest). You must login (click on the Login button on top right corner)\n\n You can use guest login **(guest/guest)** or newly created account.\n ![alt tag](https://github.com/CiscoDevNet/yang-explorer/blob/master/docs/images/YangExplorer.png)\n\n#####5.2.2 Adding/Deleing Yang Models:\n###### Upload using yang-explorer user interface (TBD: screen shot is out-of-date)\n ![alt tag](https://github.com/CiscoDevNet/yang-explorer/blob/master/docs/images/manage.png)\n - Click **Manage Models** tab\n - Click **Workspace** tab\n - Click **Add** button\n - Click **Browse** and select models to upload\n - Click *Upload*\n - **Clear** button can be used clear models in upload window\n - Click Subscribe & Un-subscribe buttons to make selected models visible/invisible in explorer area\n - Click Delete button to delete selected models from user account\n\n###### Sync from Device\n - Click **Manage Models** tab\n - Click **Device** tab\n - Select a device from profile list\n - YangExplorer will list yang models on device\n - Select models to Sync to YangExplorer Workspace\n - **Sync** button to Sync Models to YangExplorer\n - You may encounter these error during sync:\n - Missing models: Select missing models from the list and try sync again\n - Duplicate models: In workspace tab, select duplicate models and delete\n - Click **Workspace** tab\n - Click Subscribe & Un-subscribe buttons to make selected models visible/invisible in explorer area\n - Click Delete button to delete selected models from user account\n\n###### Upload models using server console\n\n```bash\n cd /yang-explorer\n source v/bin/activate\n cd server\n python manage.py --user --git --dir \n \n example: local upload (assumes models are already available at dir path)\n python manage.py bulkupload --user guest --dir /users/prgohite/git/yang/vendor/cisco/xr/531\n \n example: git upload\n python manage.py bulkupload --user guest --git https://github.com/YangModels/yang.git --dir vendor/cisco/xr/531\n```\n All models must be compiled successfully, in case of any error none of the models will be uploaded to yang-explorer.\n \n#####5.2.3 Generating the model dependency graph:\n - Click **Manage Models** tab\n - Click **Workspace** tab\n - Select one or more model name to get dependency graph\n - If no models are selected, all subscribed model will be used to generate graph\n - Click Graph buttons to generate graph\n\n#####5.2.4 Creating RPCs:\n You can explore yang models in explorer area (left pane) using tree navigation:\n ![alt tag](https://github.com/CiscoDevNet/yang-explorer/blob/master/docs/images/explorer.png)\n \n - Value and Operation columns in explorer area are editable.\n - Explore model in explorer area by navigating model tree\n - Click value cell next to data node (leaf, container etc)\n - Edit values\n - Select <get> and <get-config> for get, get-config netconf operations\n - Select <rpc> for RPCs\n - Enter data values for edit-config operation\n - Use **Reset** button on top-right bar to reset data in the model tree\n\n - Update netconf operations for edit-config (optional advance option)\n\n ![alt tag](https://github.com/CiscoDevNet/yang-explorer/blob/master/docs/images/netconf-operations.png)\n - Select **Operations** tab\n - Select error-option\n - Check / Uncheck lock option\n - Click **RPC** button under **Build** tab\n\n#####5.2.5 Executing RPCs:\n - Create RPC using *5.2.4*\n - Populate Device info in Device Settings Tab\n - Click **Run** button under **Build** tab\n \n Yang Explorer uses ncclient library to execute RPCs, connection timeout can be configured via\n environment varible default timout value is 45 seconds. \n```\n #update value in start.sh & restart server\n export NCCLIENT_TIMEOUT=120\n```\n\n##### 5.2.6 Generating Python example:\n - Create a netconf / xml RPC\n - Create RPC using *5.2.4*\n - (OR) Provide custom netconf XML (Click custom RPC Checkbox)\n\n - Click **Script** button under **Build** tab\n - Click **Copy** button to copy generated code into system clipboard\n - Save content as a python script (say example.py)\n - Run python script from command line using given instruction in script header comments.\n \n##### 5.2.7 Saving RPCs to Collection:\n - Create RPC using *5.2.4*\n - Click **Save** button under **Build** tab\n\n#####5.2.7 Loading saved RPC:\n - Click **Collections** Tab\n - Double click on the RPCs title you want to load.\n\n####5.3 Admin Tasks \n\n#####5.3.1 Creating User Account (optional):\n\n Creating user account is optional as you can use default guest/guest login, however creating user account can be userful\n if you have a shared yang-explorer installation.\n \n - Click **Admin** button in YangExplorer\n - Login as admin (user: admin, password: admin)\n - On admin page, click **Users** link\n - On User Profiles page, click **Add user** link (top-right)\n - Add user account info and click **Save** (Warning: passwords are transmitted in plaintext)\n\n#####5.3.2 Creating Device Profiles:\n\nDevice profiles can be created to quickly populate device info from drop-down list in yang-explorer.\n\n *Note: You can use default user login (guest/guest)*\n - Click **\"Create device profile\"** link on **Build -> Device Settings**\n - (OR) Click **\"Create device profile\"** link on **Manage Models -> Device**\n - (OR) Click **Admin** button in YangExplorer\n - Login login as guest or your own login\n - On admin page, click *Device profiles* link\n - On User Profiles page, click *Add device profiles* link (top-right)\n - Add device credentials (device login info is not secured)\n - Add netconf credentials (Required for connecting to netconf server)\n - Add restconf credentials (Not used currently)\n - click *Save*\n - \n\n#####5.3.3 Creating Collection:\n\nCollections can be used to save user generated RPCs on the server so that saved RPCs can be re-used.\n\n *Note: You can use default user login (guest/guest)*\n - Click **Admin** button in YangExplorer\n - Login login as guest or your own login\n - On admin page, click **Collections** link\n - On User Profiles page, click *Add collection* link (top-right)\n - Provide collection name\n - Select User from drop-down box\n - Provide description for this collection\n - click **Save**\n\n###6 Misc Features\n####6.1 UI Model Tree annotations\nTargeted content in YangExplorer UI tree can be annotated in different color, usually to represent additional information about of the Yang model node.\n\nInstallation:\n```bash\n cd /yang-explorer\n bash setup.sh -a \n```\n\nPlease refresh browser to reflect changes. You should see UI model tree node name in different color as per annotation file.\n\nUninstall:\n```bash\n cd /yang-explorer\n bash setup.sh -r\n```\n\n###7 Troubleshooting\n####7.1 Installation\n#####7.1.1 error for missing python.h or xmlversion.h\n - Ubuntu: sudo apt-get install libxml2-dev libxslt1-dev python-dev\n - Mac : xcode-select --install\n\n#####7.1.2 django.db.utils.OperationalError: near \"񐁂򐁇N\": syntax error\n - http://stackoverflow.com/questions/33270297/django-db-utils-operationalerror-near-n-syntax-error\n\n#####7.1.3 After install if you are not able to login using guest/guest try one of the following\n - mv server/data/db.sqlite3 server/data/db.sqlite3_backup\n - bash setup.sh\n In end of setup.sh script log you should see something like this -\n```bash\n ...\n Creating default users ..\n Copying default models ..\n Setup completed.. \n \n Use start.sh to start yang-explorer server\n```\n\n#####7.1.4 Installation failed due to python 3 not supported\n Python 3 is not supported by ncclient. Please install python 2.7 before proceeding futher. If python 2.7 is already installed on your system along with python 3, virtualenv may try to create python 3 environment. You can do following -\n ```bash\n cd YangExplorer\n rm -rf v\n \n # find path to python 2.7 on your system\n ➜ ~ which python2.7 \n /usr/bin/python2.7\n \n # create a virtualenv with python 2.7, path may differ based on your installation\n virtualenv -p /usr/bin/python2.7 v\n \n # rerun setup\n setup.sh\n ```\n\n####7.2 Yang Model Upload\n#####7.2.1 Failure during upload of yang model\n - Chrome browser is required currently to upload models using User Interface\n - Please see failure message, if dependent models are missing you will see specific error in message window.\n\n \n\n\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",2858485961,"orgData","recentTags",[87],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":61,"_124":17},"content_type","creator",789642,"full_size",640504747,"id",4119710,"images",[97],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":61,"_113":-5},"architecture","amd64","digest","sha256:8ef9e6ba045e673ce7a6f24156d21239a76e8c42dc46529049bfecc173cf1407","features","","last_pulled","2026-09-22T05:29:33.525115558Z","last_pushed","2017-10-07T16:23:34Z","os","linux","os_features","os_version","size","variant","2017-10-07T16:23:33.268485Z","last_updater","last_updater_username","media_type","latest","repository",833931,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":136,"_143":144,"_132":153,"_154":11},{"_36":137,"_38":138,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":139,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":58,"_60":61,"_62":-5,"_63":64,"_65":66,"_67":11,"_68":29,"_69":140,"_75":17,"_76":142,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":141},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_145":58,"_146":-5,"_147":-5,"_148":149},"count","next","previous","results",[150],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":151,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":61,"_124":17},[152],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":61,"_113":-5},[],"canDeleteTags","actionData","errors"]

robertcsapo/yang-explorer

Tags for robertcsapo/yang-explorer