doing a free form media wiki sounds good in theory... and one only starts to comprehend how much info one is missing when one starts to work with a more regimented system... i.e. lots of boxes and related information to fill out...
we all do a good job of figuring things out...if you want a real test of the quality of one's system documentation, take a green junior tech, put them in front of the documentation and observe if they can figure it the required information. Faisal Imtiaz Snappy Internet & Telecom 7266 SW 48 Street Miami, FL 33155 Tel: 305 663 5518 x 232 Help-desk: (305)663-5518 Option 2 or Email: supp...@snappytelecom.net > From: "Eric Kuhnke" <eric.kuh...@gmail.com> > To: af@afmug.com > Sent: Friday, August 5, 2016 7:44:24 PM > Subject: Re: [AFMUG] network device map/wiki/management/database/documentation > system > yeah, for that you really want an internal https/web interface mediawiki, > confluence or similar server. Create a page for every POP and have a thorough > section describing how it's organized physically, and at OSI layers 2 and 3. > On Fri, Aug 5, 2016 at 4:27 PM, Sean Heskett < af...@zirkel.us > wrote: >> Those features are valuable but I kind of want this the be a "user manual" >> type >> system only for our entire wisp. I want our techs to have access to >> everything >> that is currently rattling around in my brain. So basically a brain dump of >> all >> things wisp from me to the rest of the staff. >> -Sean >> On Friday, August 5, 2016, Jesse Dupont < jesse.dup...@celeritycorp.net > >> wrote: >>> NIPAP is great because it keeps track of the hierarchy in tree form, which >>> is >>> invaluable for v6 (which it supports fully). >>> On Aug 5, 2016, at 12:15 PM, Eric Kuhnke < eric.kuh...@gmail.com > wrote: >>>> NIPAP might be way more than you need for IP address tracking. It's meant >>>> for >>>> big ISPs that have multiple people doing stuff simultaneously with their >>>> 10.0.0.0/8 and 172.16.0.0/12 space, and handles multiple VRFs. >>>> Also stuff like creating "pools" for new assignments that can be run >>>> through an >>>> automation system, eg: "We need a /25 sized pool for the dhcpd serving this >>>> segment of GPON customers". >>>> On Fri, Aug 5, 2016 at 10:59 AM, Sean Heskett < af...@zirkel.us > wrote: >>>>> Thanks Faisal! >>>>> so far i-doit is the closest to the type of documentation system i'm >>>>> looking >>>>> for. it's still very data center oriented but it looks like it can be >>>>> made to >>>>> accomplish what i need. >>>>> NIPAP is a confusing set of acronyms that i have no i idea where to begin >>>>> with >>>>> even understanding what it does. it seems like something that would >>>>> replace >>>>> IPPLAN. their entire web page is all acronyms :-/ >>>>> confluence seems more like a group project/task management that also does >>>>> some >>>>> documentation. >>>>> -sean >>>>> On Thu, Aug 4, 2016 at 6:02 PM, Faisal Imtiaz < fai...@snappytelecom.net > >>>>> wrote: >>>>>> I share your sentiment and pain....and there is a lot you are leaving out >>>>>> ...related to keeping track of other bits of related information, >>>>>> keeping it >>>>>> updated on a regular basis.... >>>>>> after trying lots of things... we are getting ready to pull the trigger >>>>>> on >>>>>> this... >>>>>> https://www.i-doit.com/en/ >>>>>> It's a German Company... but the product is very interesting, very >>>>>> flexible, and >>>>>> may get you thinking on a few other section of the business, how you >>>>>> keep info, >>>>>> organize info etc. >>>>>> Do keep us posted on what you end up with. >>>>>> Faisal Imtiaz >>>>>> Snappy Internet & Telecom >>>>>> 7266 SW 48 Street >>>>>> Miami, FL 33155 >>>>>> Tel: 305 663 5518 x 232 >>>>>> Help-desk: (305)663-5518 Option 2 or Email: supp...@snappytelecom.net >>>>>>> From: "Sean Heskett" < af...@zirkel.us > >>>>>>> To: af@afmug.com >>>>>>> Sent: Thursday, August 4, 2016 6:20:09 PM >>>>>>> Subject: [AFMUG] network device >>>>>>> map/wiki/management/database/documentation >>>>>>> system >>>>>>> Hey guys and gals, >>>>>>> I don't know if something like this already exists so i thought i'd ask >>>>>>> y'all >>>>>>> before i went and created it. I basically need a complete documentation >>>>>>> system >>>>>>> for our network infrastructure. >>>>>>> -we have our network mapped in visio >>>>>>> -we have our network monitored in intermapper >>>>>>> -we have our network graphed in cacti >>>>>>> -i'm working on creating a wiki type page for all devices that has some >>>>>>> static >>>>>>> info (like date put in service, a link to it's manual) and some dynamic >>>>>>> info >>>>>>> (like Tx frequency) >>>>>>> -the devices all typically have a web config page >>>>>>> I want to turn our visio maps into HTML so that you can click on the >>>>>>> device and >>>>>>> bring up it's wiki page that either links to all the other pages or >>>>>>> includes >>>>>>> the info on that wiki page etc. >>>>>>> it seems like this is probably just a custom documentation database. >>>>>>> When i >>>>>>> search on the google there are systems kind of like this but they seem >>>>>>> to be >>>>>>> either too narrow minded (geared towards data center and server >>>>>>> infrastructure) >>>>>>> or too broad...nothing seems to be "just right" >>>>>>> does something like this currently exist? what do you use to keep track >>>>>>> of all >>>>>>> this information? what would you recommend? >>>>>>> Thanks! >>>>>>> -Sean