Search Results

Keyword: ‘documentation’

Slides from the documentation session at JAMF Nation User Conference 2016

October 20, 2016 1 comment

For those who wanted a copy of my documentation talk at at JAMF Nation User Conference 2016, here are links to the slides in PDF and Keynote format.

PDF – http://tinyurl.com/JNUC2016DocPDF

Keynote – http://tinyurl.com/JNUC2016DocKeynote

Documentation session at JAMF Nation User Conference 2016

October 11, 2016 Leave a comment

I’ll be speaking about how to various ways to document your Casper Suite and other IT needs at JAMF Nation User Conference 2016, which is being held from October 18th – 20th, 2016 in Minneapolis, MN. For those interested, my talk will be on Thursday, October 20th.

For a description of what I’ll be talking about, please see the Preparing for the Road Ahead: Documenting Your Casper Suite Setup session description. You can see the whole list of JNUC sessions here on the Sessions page.

Slides from the Documentation session at X World 2016

July 8, 2016 Leave a comment

For those who wanted a copy of my documentation talk at at X World 2016, here are links to the slides in PDF and Keynote format.

PDF – http://tinyurl.com/XWorld2016DocPDF

Keynote – http://tinyurl.com/XWorld2016DocKeynote

Displaying documentation of all options available with the Casper agent

April 13, 2016 1 comment

I recently learned that there’s a way to display all the various verbs which can be used with the Casper agent’s jamf binary in one list, including the verbs which are normally hidden from view. For more details, see below the jump.

Read more…

Slides from the documentation session at Penn State MacAdmins Conference 2015

July 11, 2015 Leave a comment

For those who wanted a copy of my documentation talk with Vanessa White at Penn State MacAdmins Conference 2015, here are links to the slides in PDF format.

PDF – http://tinyurl.com/PSU2015docPDF

Casper’s hidden documentation

June 29, 2015 4 comments

I’m interested in discovering when tools have hidden documentation, so I was curious when I learned recently that the Casper agent has explicitly hidden documentation which requires root privileges to access. For more information, see below the jump.

Read more…

Categories: Casper, Documentation

Preparing for a Bad Day – How to write Disaster Recovery documentation

June 1, 2015 Leave a comment

IT disasters are unpleasant, and can take many forms. However overwhelming the idea of a possible disaster may be, it is crucial to have a well-formed plan in place. Many IT professionals don’t have a good grasp on how to write disaster recovery documentation, which can lead to confusion and problems when disaster strikes.

To give an idea of how good disaster recovery documentation can save the day, I’d like to share a story of how good documentation not only saved the day, but also saved my vacation. 

A few years ago, I was riding the airport shuttle on my way to a cruise ship vacation. While en-route, I got a call from my workplace where the person calling said that they had a power outage at our main datacenter. I was gone, my alternate was stuck in traffic, what should they do? I said “Can you find the Mac server rack?” Yes, they found it. “Do you see the packet marked Emergency Server Startup and Shutdown Procedures?” Yes, they did. “OK, open that and start reading. It’ll walk you through the process.” I talked with them for a few more minutes to make sure that they were OK, then I said goodbye, ended the call and prepared to board my plane.

Without that packet attached to the front of the server rack, which I had made sure was updated the day before with the latest information, I might have been trying to talk someone through the shutdown procedure for about fifteen servers and twelve RAID arrays over the phone up until the moment that the flight attendant yanked my phone out of my hand because the plane needed to take off.

There are a few lessons to take from this story.

Q: Where was I when the disaster occurred?
A: Off-site and without access to either a computer or a way to connect back to the work network.

Q: Where was the other person who had been trained on our disaster recovery process?
A: Off-site and unavailable.

Q: Who was the person on the phone?
A: Someone who wasn’t trained in our disaster recovery process.

Q: What allowed the person on the phone to successfully bring down my servers?
A: Accurate and easily-understood documentation that was placed for ready access.

Q: What was not affected by this disaster?
A: My vacation.

With these lessons in mind, see below the jump for my advice on how to write disaster recovery documentation.

Read more…

“Take Vacations using this One Weird Trick – DOCUMENTATION!” session at Penn State MacAdmins Conference 2015

I’ll be collaborating with my colleague Vanessa White to give a lab session at the Penn State MacAdmins Conference 2015, which is being held from July 7th – 10th 2015 in State College. For those interested, our session will be a two-parter lab on Wednesday, July 8th.

For a description of what we’ll be discussing, please see the Take Vacations using this One Weird Trick – DOCUMENTATION! session description. You can see the whole list of speakers here on the Sessions page.

Slides from the Documentation session at MacTech Conference 2014

November 6, 2014 Leave a comment

For those who wanted a copy of my documentation talk at at MacTech Conference 2014, here are links to the slides in PDF and Keynote ’09 format.

PDF – http://tinyurl.com/MT2014DocPDF

Keynote – http://tinyurl.com/MT2014DocKeynote

Documentation session at MacTech Conference 2014

November 1, 2014 Leave a comment

I’ll be speaking at MacTech Conference 2014, which is taking place from November 5th – 7th in Los Angeles. I’ll be talking about documentation and the various lessons I’ve learned over the years that I’ve been writing it.

You can see the entire list of speakers at http://www.mactech.com/conference/sessions. If you’ve been on the fence about attending, it’s not too late! Come attend a great conference; seats are still available.

%d bloggers like this: