RE: Asking for help in designing a new document

Subject: RE: Asking for help in designing a new document
From: "Giordano, Connie" <CGiordano -at- tiaa-cref -dot- org>
To: "Keith Hood" <klhra -at- yahoo -dot- com>, "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 28 Jul 2006 13:15:09 -0400

A run book generally includes everything you have listed including the
separate documents you mention--especially backup and maintenance
schedules and scripts. In my last gig, they also requested inclusion of
top troubleshooting procedures, startup and shutdown routines, key
contacts for support and troubleshooting, and references to change and
release management policies and guidelines. If your DBAs adhere to SLAs
and OLAs, you should also reference these documents.

Connie Giordano, MA
Document Management Specialist
IT Transformation/AIM3
Charlotte, NC
-----Original Message-----
From: techwr-l-bounces+cgiordano=tiaa-cref -dot- org -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+cgiordano=tiaa-cref -dot- org -at- lists -dot- techwr-l -dot- com] On
Behalf Of Keith Hood
Sent: Thursday, July 27, 2006 4:03 PM
Subject: Asking for help in designing a new document

Our main database guy asked me to put together a "run
book" for our Oracle databases. He wants something
that would give a new database developer all the
information needed to understand our database
environment, to minimize the ramp-up time needed by
new personnel. The idea is, if his ROBAB probability
goes to 100%, this document should tell his
replacement everything he needs to know about keeping
the databases running. (Run Over By A Bus)

However, I've never before had to document anything to
do with databases, so I really don't have a clear idea
what to put in this thing. I'd like to hear from
anyone who knows something about database maintenance.

Here's a list of things said our database guy thinks
should be in this document:

* Server names and IP addresses
* Login information for database administrator
* Full pathname of Oracle home directory
* Locations of listener configuration files and
* List of all maintenance jobs and scripts

To avoid reinventing the wheel, I've been trying to
figure out how much we already have covered. We have
a document that covers required security measures. It
gives things like setting the password lock time and
login session timeout limits. We also have a document
that covers maintenance procedures, things like backup
schedules/procedures, and administrator account
environment variables.

I need to figure out what else should go into this
"run book" before I can decide what pre-existing
material would be useful. Any feedback would be appreciated.


Keith Hood
Senior (only) tech writer
ACS, Inc.

This message, including any attachments, contains confidential information intended for a specific individual and purpose, and is protected by law. If you are not the intended recipient, please contact sender immediately by reply e-mail and destroy all copies. You are hereby notified that any disclosure, copying, or distribution of this message, or the taking of any action based on it, is strictly prohibited.


WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today!

Doc-To-Help includes a one-click RoboHelp project converter. It's that easy. Watch the demo at

You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit for more resources and info.

Previous by Author: Re: Usability through Fun
Next by Author: RE: Outlook received "Today, Yesterday, Sunday..."
Previous by Thread: RE: Asking for help in designing a new document
Next by Thread: RE: TECHWR-L Digest, Vol 9, Issue 25

What this post helpful? Share it with friends and colleagues:

Sponsored Ads