In this post I wanted to dig into the topic of documentation, specifically as it relates to documenting your SharePoint farm and configuration. As a consultant here at C5 Insight, I rely on, create and work with documentation all the time, and I’ve come to appreciate what I think makes good documentation. I’m not referring to any form of training or user manuals; this is technical documentation for the IT folks. Documents vary by exactly what’s included, how they’re written and how they’re used, but the basic premise is the same. “I need to know some details about my SharePoint farm, servers, and its configuration.”
Go back to your first day on the job as the SharePoint administrator at Contoso (we’ve all worked there one day or another right?). Were you the only SharePoint admin? How did you know what’s what? You ask your manager, “Do we have any documentation?” He laughs, and your heart sinks. That means you have investigative work to do. That’s no fun, and you have better things to do.
What if instead, your manager said “Sure here’s our documentation, enjoy.” “Awesome thanks!” you say. You know exactly what servers are doing what, how things are configured, what is installed and URLs for everything. What a great feeling. When it comes to writing documentation, it is unfortunately one of those things that you will get to tomorrow, gets pushed because this server was down, or Bob needs his password reset. But I believe it’s important to at least have some form of documentation. This is important because:
This can vary in topics and format. These are the topics that I believe should be included in good SharePoint Documentation:
The format can be simplistic and auto-generated by tools or scripts, or be complete and well-rounded. The most important part is having one. You may notice that I didn’t mention governance or disaster recovery. That’s because those should be separate documents! There are entire books devoted to each topic, so I won’t discuss here. So how do you get this information? There are some tools, some PowerShell scripts, and of course always the manual look and copy.
SPDocKit hasn’t been around all that long I believe, but is a well-rounded tool. It is a good fit for consultants based on how it’s licensed. You can find reviews for it on sharepointreviews.com.
SPDocGen has been around since 2007, and was converted by the community to work with 2010. It’s a great tool to give some good detailed tables of information in Word and XML format. The 2007 version will also dump passwords of service accounts / application pool accounts which is nice if you happen to have misplaced it for an old environment, or if you took over for someone else.
SPSFarmReport is a favorite by Microsoft support, when they need to quickly gather information on your environment. Currently it only supports 2007 and 2010, it is unclear on a version for 2013.
The rest of the links I have compiled use PowerShell scripts in some form or fashion to create an inventory or listing of an environment.
As I said, it all depends on what you’re trying to gather, and how you need to display it. Of course feel free to write your own script or cobble these together. Whatever you do, make time for this, it’s important! What if you just take site collection backups, and your single farm server completely dies. Now what? I’ll say it again, make time for documentation. You just might learn something along the way.
Trackback from Blog de Juan Carlos González en Geeks.MS
Si nos encontramos con la necesidad de documentar un ambiente de SharePoint (Versiones 2010 y 2013), ...
The complementary paper includes over 12 years of research, recent survey results, and CRM turnaround success stories.
This 60-second assessment is designed to evaluate your organization's collaboration readiness.
Learn how you rank compared to organizations typically in years 1 to 5 of implementation - and which areas to focus on to improve.
This is a sandbox solution which can be activated per site collection to allow you to easily collect feedback from users into a custom Feedback list.
Whether you are upgrading to SharePoint Online, 2010, 2013 or the latest 2016, this checklist contains everything you need to know for a successful transition.