If this article is covering dev / test / production severs within one article, then each environment may have any differences specified within in each category below. Some sections may need multiple outside resources created and added to this page (e.g. a Visio diagram for each environment).
Index
- Overview - Executive Summary
- How to access
- Administrative access
- Customer access
- Compliance
- Copy of Data Use Agreement
- FSU Data Classification Level
- Compliance Standards this system must meet
- Setup and Configuration
- Prerequisites
- Server(s) Configuration
- Server Requirements
- Networking
- Installing Roles / Features / Applications
- Security
- Scheduled Jobs
- Data Protection
- Functionality and Monitoring
- Functionality of the system
- Service Health
- Monitoring
- Support
- Links to relevant MED KB articles (in TDX)
- Links to online support documents from vendors
- Initial Procurement Info (if not on the TDX Asset Pages)
- Support contact information
- Troubleshooting
- Common issues to look out for and resolutions to them
- Ongoing Maintenance Needs
- Special Considerations for OS Updates
- Vendor Updates
- Is other recurring work required to have this system function optimally?
Who is the system primarily designed for?
What is this system designed to accomplish?
Administrative access
Customer access
Copy of Data Use Agreement
FSU Data Classification Level
Compliance Standards this system must meet
Prerequisites
- What needs to exist before this document can be used to fully recreate this application / server?
Server(s) Configuration
Follow the standard procedure for servers, physical or virtual - KBs exist for both
- List of Assets Involved in the Application
- Links to MED Asset Records (in TDX)
- What is the function of each part of the system?
-
- Link to code repo
Server Requirements
- Hardware requirements for the server(s)
- CPU / RAM / Disk space
- Vendor Requirements document(s)
Diagrams
- Insert relevant diagrams about how the systems interact
- network, server, storage, logical, etc.
- You may choose to use Draw.io, Visio, or other compatible tool to create the diagrams.
- Please store the originals in Microsoft Teams.
Networking
- Load Balancing in Use?
- Load Balancer Name
- VIP IP / name / DNS
- Load Balanced Servers
- Type of load balancer
- DNS Names and IP address information if different than the server's name
- Be sure the load balancer information is displayed in the system diagram
Installing Roles / Features / Applications
- What needs to be installed and what is the purpose?
- How to install each item
Security
- User Permissions
- Customer permissions
- AD Groups and what they have access to
- Administrative permissions
- AD Groups and what they have access to
- What passwords / keys are used? Link to Secret Server secrets.
- Logging
- Where are logs stored?
- Who can access them?
- Necessary Firewall Rule Documentation
- Rules needed for Windows firewall
- Rules needed for external (Sophos) firewall
Scheduled Jobs
- What jobs or tasks have been configured to run to ensure that this system functions optimally, and at what frequency?
Data Protection
- Backup Process
- Where are backups stored?
- How often are backups run?
- Restore Process
- How long of an outage (approximately) does it take to restore?
Functionality of the system
- What are the key functions that customers rely on for this system?
- How are these functions configured in technical detail?
Service Health
- How do we function test the system to ensure that it is working as intended?
- Service validation
- Program validation
- Website validation
Monitoring
- What special monitoring needs does this system have?
- What special alerting needs does this system have?
Links to relevant MED KB articles (in TDX)
Links to online support documents from vendors
Initial Procurement Info (if not on the TDX Asset Pages)
Downtime Policy
Define uptime requirements, who to notify, and how to request unscheduled downtime
Support contact information
- How to enter support requests
- Technical Account Manager
- Key support contacts
- How to onboard new team members with support
What can we do to troubleshoot during the day
- Simply describe the criticality of the system so a determination can be made for troubleshooting
- Do we need approval for a therapeutic reboot
- Individual or team that can provide authorization
- include a contact method, i.e. distro or teams channel
- Are there special steps needed to ensure the reboot doesn't break things or to bring the server back up
Common issues to look out for and resolutions to them
Special Considerations for OS Updates
Vendor (application) Updates
- Name of software
- Downtime estimate for an update
- release cadence of Vendor Updates
- Steps to Install Vendor Updates
Is other recurring work required to have this system function optimally?
- Downtime estimate
- Frequency of the work
- Steps to complete the activities
- Does the system need a scheduled reboot