DOCUMENTATION AND SOURCE CODE CONTROL
The EMA Microsoft Teams folder will be used to store the following files:
· Functional System Specifications
· Migration Packages (zip files)
· Backup Presentation XML files
· MXS files
· MIF Files
· Master Packet Document, PacketLog.xlsx that will list the ‘Packets’ and the environments to which they have been applied
All ‘source code’ will be included in the related FSS.
Source Code includes the following:
· Automation Scripts
· XML Screens
· MXS files
· Java Classes (if required)
· SQL Scripts
1.1 As-Built Documentation Updates
As-built documentation will not be changed after go-live.
Changes to functionality previously applied to production should be documented appropriate to the level of complexity of the change. Where appropriate, an FSS will be developed, and associated changes will be documented in the FSS. Smaller changes will be documented in a less structured manner. Release notes will refer to the documentation of all included changes.
For Data Visibility Rework, changes will be documented in the Data Visibility Rework FSS.
The ability for users to enable/disable the screen reader from their user profile was documented in a memo.
The Priority Code change will be documented as part of the go-live process for PFR or TS, which ever goes live first.
Changes proposed by COT will be documented for review by the COT Change Approval Board (CAB) and EMA and this documentation will be deemed adequate to be associated with the applicable release.
1.2 Roles and Responsibilities
Environment | Activity | Requestor | Instructions | Execution | Knowledge Transfer | Documentation |
Development (DEV) | ||||||
| DB Backup and restore | EMA/City | City | EMA/City | N/A | City |
| WebSphere MXServer | City | City | City | N/A | City |
| Ifix - Maximo Base product | City | City | City | N/A | City |
| Ifix - Maximo Spatial | City | City | City | N/A | City |
| Maximo EAR Deployments | City | City | City | N/A | City |
| Apply Packets | EMA | EMA | EMA | N/A | EMA |
System Integration Testing (SIT) | ||||||
| DB Backup | City | City | City | N/A | City |
| DB Restore | City | City | City | N/A | City |
| WebSphere MXServer | City | City | City | N/A | City |
| Ifix - Maximo Base product | City | City | City | Yes | City |
| Ifix - Maximo Spatial | City | City | City | Yes | City |
| Maximo EAR Deployment | City | City | City | Yes | City |
| Apply Packets | EMA | EMA | EMA | N/A | EMA |
Test/Pre-Production (QA) | ||||||
| DB Backup | City | City | City | N/A | City |
| DB Restore | City | City | City | N/A | City |
| WebSphere MXServer | City | City | City | N/A | City |
| Ifix - Maximo Base product | City | City | City | N/A | City |
| Ifix - Maximo Spatial | City | City | City | N/A | City |
| Maximo EAR Deployments | City | City | City | N/A | City |
| Apply Packets | City | City | City | N/A | N/A |
Production (PROD) | ||||||
| DB Backup and restore | City | City | City | N/A | City |
| WebSphere MXServer | City | City | City | N/A | City |
| Ifix - Maximo Base product | City | City | City | N/A | City |
| Ifix - Maximo Spatial | City | City | City | N/A | City |
| Maximo EAR Deployments | City | City | City | N/A | City |
| Apply Packets | City | City | City | N/A | N/A |
Training (TRN) | ||||||
| DB Backup and restore | City | City | City | N/A | City |
| WebSphere MXServer | City | City | City | N/A | City |
| Ifix - Maximo Base product | City | City | City | N/A | City |
| Ifix - Maximo Spatial | City | City | City | N/A | City |
| Maximo EAR Deployments | City | City | City | N/A | City |
| Apply Packets | City | City | City | N/A | City |