Ogenstad.net

Security Stories and Help with Network Documentation

Once upon a time this used to be my blog. For current updates head over to Networklore.

About / Stories / Contact

  • GitHub
  • LinkedIn
  • RSS
  • Twitter

Powered by Genesis

How to Document Servers with SYDI – Part 1 of 3

October 18, 2006 by patrick.ogenstad 63 Comments

Having written SYDI from scratch, I know it inside and out. Unfortunately I don’t think I’ve managed to communicate how SYDI works in an efficient way. The readme file included in SYDI is far from perfect. While people in this line of business can usually figure out how it works, others will just ignore reading the manual anyway. In this how-to I will go through the basics of how SYDI-Server works and then describe how I use SYDI-Server.

Getting the Software

You probably have the software already, but just in case. Download it from the SYDI website, or if you love this site and don’t want to leave it no matter what: you can download it from here. This guide is written for SYDI-Server 2.0, if there is a newer version when you read this, don’t worry; it should be useful anyway. Just be sure to check the changelog.txt file for new features.

Unzip the file to your target directory.

Running SYDI in default mode

To see what the software does, open a command prompt and navigate to your sydi directory. This step requires you to have Microsoft Word installed on your computer. Type the command:

cscript.exe sydi-server.vbs [enter]

A message box appears and asks you which host you want to target, the default is localhost. You can select another host if you have administrative access on that machine. Though for now, just press enter.

In the command prompt window you will now see that SYDI starts to gather information about your machine. Soon a Word document is created and SYDI writes the information gathered into the document.

Take a look at the document. Not all this information will be relevant to you and you can remove the parts you don’t want by reading further. Close Word, or save the file it if you want to.

The Options

To view the available options use the help command (-h):

cscript.exe sydi-server.vbs -h [enter]

Options in five categories will be listed; Gathering, Output, Word, XML and Other. In reality there are only two, Gathering and Output.

Gathering the Information

Breaking down the gathering option we have five different arguments -w for WMI options, -r for Registry options and -u and -p for username and password if you want to connect to a different user. Finally we have the -t option where you specify which host you want to target against.

Looking closer at the -w argument from the help menu (-h) you could see that SYDI defaults to using -wabefghipPqrsSu, meaning everything gathered from the WMI providers will be included.

You cannot remove everything from the report, but let’s create a document without all the extra information. Run:

cscript.exe sydi-server.vbs -w [enter]

As you can see the report created is much shorter than the previous one. We have removed the optional WMI providers, but we still have the basic ones and the information coming from the Registry.

To choose which options you want, just check the help menu and see what they mean. If we want to add Bios Information, Printers and Services we would run:

cscript.exe sydi-server.vbs -wbps [enter]

This way you can pick and choose the options you want. The Registry switch works the same way. For an even smaller report you can run:

cscript.exe sydi-server.vbs -w -r [enter]

Now you can add the registry options that you want. Please note though that a lot of the “Computer Roles” are gathered from the Windows Components, so if you want these roles you must have the Windows Components in your report (-rc).

Using the -t option removes the message box asking you which host you want to target. A few examples of using the -t switch:

cscript.exe sydi-server.vbs -tServer1
cscript.exe sydi-server.vbs -tDC1
cscript.exe sydi-server.vbs -tWebServer
cscript.exe sydi-server.vbs -t192.168.0.10

The user and password options should work as you would expect them to, if they don’t: report the bug to me 🙂

Word Options

As you’ve seen, sydi-server defaults to writing output to Word. The reason for this is so that you can get a quick overview of what the script can collect without having to do any tricks. Having said that, I only use the Word option to get a quick view of a machine, later I throw away the document. I always use the XML format which I later convert to a Word document, more on that later. Even though you won’t use the Word options much we’ll just take a quick look at them to see what you can do, it won’t be a total waste as a few of the options are used by another script called ss-xml2word.vbs.

-b is for the border of the tables created in the document. As you might have noticed there isn’t any borders by default (when you print the document). You can use all borders you have installed in Word. To test it, type:

cscript.exe sydi-server.vbs -b”Table Contemporary” [enter]

-f is if you want different font sizes, the default font size for the text is 12. To change it, use:

cscript.exe sydi-server.vbs -f8

-d tells SYDI not to display Word until the entire report is written. Using the -d option makes the process go faster. Also if you want to save the file (-o option, more on that later), you might not want to see Word at all. For example if you are running a scheduled task you don’t want a GUI to be loaded.

-n will remove all the text inside the brackets, such as “Logical location: [provide info: Server VLAN 2]”. This way you won’t have a bad conscience about not completing the documentation. 🙂 But as I have already stated, the whole idea of sydi-server writing directly to word is obsolete. If you start changing the document after it is created and want to run SYDI again your changes will be lost, or you will have to cut and paste them to the new document. There is a way around this though (hint: continue reading!).

-T This is if you want to specify a corporate Word Template file (.dot), which enables you to choose which fonts you want to have as well as their size. This way you can get your “look and feel” in the document.

Read Part 2
Read Part 3

[tags]network documentation, server documentation, sydi, how to, tutorial[/tags]

Filed Under: SYDI

Comments

  1. Graycat says

    October 18, 2006 at 8:23 pm

    Awesome! many thanks for putting this together, Patrick. Any chance of rolling it all together into a word doc for download / distribution? or shall I stop being a cheeky bugger and copy and paste it myself? (with your permission, of course) 🙂

    Tim/.

  2. Patrick Ogenstad says

    October 21, 2006 at 11:10 am

    Tim, I don’t have any immediate plans on distributing a Word document. If you want one for yourself, you are free to copy and past (or write a script that does this 🙂 )

    What did you think of the ss-xml2word script?

  3. mo says

    March 5, 2007 at 8:27 pm

    This is a very useful and extremelly easy to use tool. Thanks Patrick for creating something that it actually helps a network administrator. I will tell my colleagues about this cool gem…Thanks again

  4. Michael Wilton says

    October 17, 2007 at 9:46 pm

    An excellent tool and a great “How To” – thank you very much.

    Just a tip – it might pay to note that the tool writes to the ‘currently active’ Word document window so if you open a Word doc while it is writing it will start spitting the output into that doc :-).

    Thanks!

  5. Jarl says

    July 20, 2008 at 5:48 pm

    How about an output to Wiki code?

  6. jennifer says

    October 22, 2008 at 7:04 pm

    what level of access rights do you need to run this…we are thiking of giving this as a task for our Graduate Assistant

    thanks…awesome program…we LOVE it here

  7. Pete Wood says

    November 10, 2008 at 4:24 pm

    amazing….

    wiki code would be the icing on the cake..

    thank you…

  8. Roberto says

    December 11, 2008 at 9:36 pm

    Great tool, I can not believe what it does. I will start documenting all my servers right now.

  9. Roberto says

    December 11, 2008 at 9:37 pm

    Thank you very much for such a great tool!!!

  10. Jason says

    January 27, 2009 at 9:32 am

    Hey,
    This is a great tool. However, I just wanted to find out if I can ues this over a network from a Vista Ultimate machine to Windows NT Server 4.0 to get information from the Server? I am in the process of rolling over from NT Server to SBS 2003. Thanks.

  11. Patrick Ogenstad says

    January 28, 2009 at 9:23 pm

    Jason – NT4 isn’t really supported but some parts work. Though you have to install the WMI provider for NT4. If you do a search on Microsofts download site you should find it.

  12. Kevin says

    March 18, 2009 at 9:46 pm

    Patrick
    Thanks for your hard work. Network documentation is difficult enough and it can become expensive. Thanks for this tool. It makes life easier.

    Kevin

  13. Milton Bliss says

    May 4, 2009 at 6:05 am

    This tool is fabulous, thank you for creating it. Most machines create a 23 page document, two machines create a 230 page document. About 200 pages of startup commands. Where are startup commands created, the registry? Where should I investigate. to try to understand what is happening?

  14. Patrick Ogenstad says

    May 5, 2009 at 7:01 pm

    Milton – They might be under the default user account in the registry. Some vendors like IBM can have quite a few startup commands…

  15. Don B says

    May 15, 2009 at 4:45 pm

    Fantastic work. Accomplished in minutes what would have been hours worth of tedious work. THANK YOU!

    D.

  16. Dan Ryan says

    June 14, 2009 at 5:04 pm

    Patrick,
    This a great tool and will make short work of documenting my desktop lab environment. Though I am not getting the credentials promt I was expecting. So far it only works localy. What I get in the command promt when attempting to run on a remote host is “access denied”. Should I get a promte or should that be in the command line also?
    Thanks.

  17. Doug Brescia says

    June 18, 2009 at 3:32 am

    Patrick,
    I just wanted to take the opportunity to chime in and say thank you for creating this tool. I had finally decided to the bite bullet and tackle the task of documenting the network. I found this tool and your site doing a web search. The initial results and flexibility of this tool are going to make a tedious (but necessary) task tolerable.

  18. Dale says

    July 16, 2009 at 2:50 pm

    Good morning,
    I have a question in regards to running the “SYDI” script. I’m able to run the “SYDI” script using the following syntax “cscript.exe sydi-server.vbs -tLANOPPS -uxxxx –pxxxxxxx” and retrieve all the data.

    My question is how to run the script to automatically dump the information as a (.doc or .xls) can you please provide me with the proper syntax I’ve tried using the help but I’m not quite understanding all the switches.

    By the way Great script.

    Thanks,

  19. Jim says

    August 10, 2009 at 7:23 pm

    How do you gather harddrive and partition Info?

  20. Patrick says

    August 12, 2009 at 8:14 pm

    Don B and Doug Brescia Thanks 🙂

    Dan Ryan There is no authentication prompt, you can run it with a user who has access or use the -u and -p parameters.

    Dale Perhaps this page can help you: ss-xml2word.vbs

    Jim If you run the script locally and don’t have administrative access the disk information won’t show up.

  21. Randy says

    September 16, 2009 at 3:27 pm

    Is there a way to also add what Programs are installed, could be as simple as listing whats on the Start – All Programs menu. And also all Scheduled Tasks?

  22. Andy.T. says

    October 14, 2009 at 4:19 pm

    Excellent tool. I was wondering though, as I need to check all of my companies PC’s around europe to see which are or are not ok to use Windows 7 all i need is the first bit of information listed under hardware plateform. Is there any way to get this to only return that information and none of the rest?

    Thanks in advance.

  23. Andy.T. says

    October 14, 2009 at 4:25 pm

    Also one more question,,,can this be used to get information from multiple machines at the same time???

    Thanks

  24. Patrick says

    October 15, 2009 at 8:05 pm

    Andy – Take a look at this site for how to get a more compact report:
    http://sydiproject.com/howto/limiting-the-length-of-a-sydi-report/

    Concerning running the script against multiple machines. Continue reading the rest of this guide and you’ll find out.

  25. Dave Kawula says

    November 25, 2009 at 10:21 am

    You should look at the Microsoft Assessment and Planning tool 5.0 — MAP 5.0 — It will give you a comprehensive report on which machines can take Windows 7.

    Dave Kawula
    Principal Consultant
    TriCon Technical Services Inc.

  26. Alcides Romeu says

    January 5, 2010 at 12:01 pm

    This is a very good tool im impressing how this generate the report…
    thanks for that and i hope that you keep working on it…

  27. Bhupinder Sodhi says

    March 23, 2010 at 8:58 am

    Great work..Keep it up.

    I have one very small query , will it be possible to store the results in csv format?

  28. Fabricio R Webster says

    April 6, 2010 at 9:55 pm

    WHAT A GREAT TOOL!!!!!! YOU SAVED ME MANY MANY HOURS OF WORK.

  29. TUP says

    May 27, 2010 at 11:23 pm

    Thank you for this, very easy to use! Keep up the good work.

  30. Manohar says

    June 1, 2010 at 4:15 pm

    Great work !!! you people are best !!!!

  31. Bertl says

    July 13, 2010 at 1:56 pm

    Hello,

    Thanks for that good tool.
    Is there a posibillity to collect Informations from a WIN CE Client?

    Bert

  32. Francois Gravel says

    July 29, 2010 at 3:47 pm

    What a great tool, we’ll actually use it to document DRP targeted servers

  33. Thobbe says

    October 20, 2010 at 11:57 am

    Hi Patrick,

    Thanks for that good tool.
    This is fabulous, thank you for creating it.

  34. Ram says

    November 27, 2010 at 3:25 pm

    Dear ,
    The Script you have created is very good and helpful for a fast paced environment to get complete details of the system.

    I have a small issue. In our company we still use 98 based systems. Help me resolving things in 98 and some of our XP systems doesnt have Activex for Word.

    I am facing problem in these two areas. Kindly Help me for the same.

    Regards
    Ram

  35. Patrick Ogenstad says

    November 30, 2010 at 4:40 pm

    Ram – I don’t want to be rude… Windows 98?

  36. Ron Egolf says

    March 21, 2011 at 10:30 pm

    I see this only works for Exchange 2000 and 2003, is there something in the works for Exchange 2007/2010?

  37. lewis amundson says

    March 22, 2011 at 10:29 am

    I was testing the sydi-exchange script and get an error. Not being proficient in vbs, I’m not sure what it is referring to…

    Start subroutine: GatherLDAPInformation()
    Gathering information from the Organization Object
    Gathering information from Global Settings
    Gathering Recipient information
    Gathering information of Administrative Groups
    Gathering information of Exchange Servers
    Gathering information of Information Stores
    C:\Download\Scripts\Documentation\sydi-exchange-0.4\sydi-exchange.vbs(578, 4) (n
    ull): There is no such object on the server.

    This is an Exchange 2003 environment. Do I need to edit the script to provide local configuration information?

    I understand these are open source, and I may find time to decipher everything myself eventually, but I’d love to find out if this works..

  38. Frank says

    April 6, 2011 at 2:12 pm

    GREAT PROGRAM, AFTER A FEW DAYS I CAN DO EVERYTHING WITH THIS (GREAT) PROGRAM.

    THANKS FOR THE GREAT TOOL PARTRICK

    FRANK.

  39. CT says

    April 7, 2011 at 1:18 pm

    Hello,

    First off, this tool is really good and it does a great job. Having put together a list of servers in my org, I used the script to query the server and it returned all the info I need, including a storage section listing all drives and their space usage. This last information is what I need most for a backup project.
    Sadly though, when converted to excel from xml, the storage information is missing in the overview excel document. Any help on how to get the drives and other storage related info into the excel overview will be greatly appreciated.

    CT

  40. Andrew Brooke says

    November 5, 2011 at 11:25 am

    Great tool. I use the output from SYDI to populate our WIKI. Setting SYDI to output as XML and then apply an XSLT to make it WIKI test. Works like a dream! I have been able to categorise my servers into Virtual, Physical, OS, Manufacture etc etc. Thanks again for a excellent tool.

  41. Stephen Wright says

    November 10, 2011 at 3:36 pm

    Hi Patrick,

    I’ve sbeen using SYDI for a few years now and I’d like to say thank you for this great product. I have all the xml files stored on a webserver and broken down by domain and application so my whole team can check details really quickly.

    A couple of things for the wish list would be “Storage” information to be included in the XLS Overview and “Product Keys” from W2008.

    Thanks again.

    SteveW

  42. Rahul says

    November 15, 2011 at 2:47 pm

    Hi,
    I tried -t -u -p still what i get is 70 — Permission denied

    Now to give you a little idea…my systems are not a on a domain, its simple workgroup.
    I get IP of all the system by running IP scanner and then i want to run this script remotely to get the xml as well.
    Please help.

    Regards
    Rahul

  43. Keynetz says

    December 23, 2011 at 6:45 am

    I love this tool, I run one bat file I created from a USB on any computer I want documented and within seconds I have it in an HTML file with everything.

    I have a ton of little utilities that I feel could be used by Sydi, such as password recovery. One thing I really would like Cydi to do is to grab:

    Windows users & Passwords
    Outlook and e-mail info & passwords
    Network Passwords

    I feel that this would really put Cydi Documentation above and beyond the rest, even though it already is!!!

  44. Ben Hammond says

    January 18, 2012 at 6:31 pm

    Hi! Thanks for the great product.

    Having trouble getting it to run remotely for a local server. I’m running the script with -t -u -p (with administrator access) and I’m getting:

    Start subroutine: GatherWMIInformation(server)
    -2147024891 — Access is denied. (server)

    Firewalls on the server are off. Login credentials are correct.

    Any ideas?

  45. shadowss says

    March 12, 2012 at 1:37 pm

    i have all the output xml file. i want to collect the mac address using sydi-overview. how can i do that. which field i have to modify.

  46. Dan says

    April 11, 2012 at 6:21 am

    This is an awesome project!

    It integrates well with Kaseya too, every document contains the same information, and it takes a few minutes to document hundreds of servers.

  47. Mark says

    October 3, 2012 at 9:24 pm

    I have been running the VB script for some time and just now getting a cDate type mismatch error in line 335. Any ideas.

  48. Rick says

    November 27, 2012 at 3:34 pm

    Thanks for sharing your work!

    I’m working on porting the linux side over to work with more than gentoo, and I would like to share it in a place where people will actually find it. Right now, I’m setting up the script to work with Debian and Centos for a project. That should cover the needs of just about any linux sysadmin that wants to make short work of documentation. I will keep you posted on my progress.

  49. Bertland Hope says

    December 4, 2012 at 7:55 pm

    This tool is awesome. wow thanks for taking time out to write and share this tool. I really appreciate it. This tool is really helpful in documenting my network. Woow all this information and ina word document wow. Xml features are nice – but not required for my task as I wish to make a standard document too present to my boss.

    Thanks again

Newer Comments »

Trackbacks

  1. Review: Script Your Documentation Instantly at Nerhood Weblog says:
    May 11, 2007 at 8:03 pm

    […] The software is written by an IT Consultant named Patrick Ogenstad. He has posted some really good how-to guides on his […]

Leave a Reply Cancel reply

You must be logged in to post a comment.