GMAT R2016a Release Process

GMAT R2016a Release Process

This page is used to track the process and progress of the R2015a release.

Release Lead Roles

Role

Assignee

Authority/Responsibility

Role

Assignee

Authority/Responsibility

Release Manager

SPH

"owns" release, initiates process, creates tracking page, sends daily status updates, tracks issues to completion, makes sure everyone gets their stuff done, brings decisions to CCB/team, maintains tracking page, collects lessons learned, documents process improvements for next release. Must be reachable and preferably in the office during critical stages like creating and testing RCs.

Build Manager

LOJ

controls build system, creates RCs, sends RC availability announcements. Must be reachable and preferably in the office during critical stages like creating and testing RCs.

Test Manager

TR

control GUI/script testing for each RC.  Must be reachable and preferably in the office during critical stages like creating and testing RCs.

Open Process Questions R2015a

  • Consider merging to production and test this before next release process

  • Automate installer packaging

  • Consider sanity check from mission users' scripts

  • Feature Freeze/QA Complete/Beta Test must happen earlier (month before code/App Freeze)

    • We need to baseline the test results well before release process starts.  Probably at Feature Freeze\QA Freeze

    • Consider allowing GATS to produce multiple reports from one test run

  • When should we merge with production and baseline tests?

Release Risks

This is a list of all risks (opened and closed) related to smooth release of R2015a.

Owner

Status

Description

Resolution

Owner

Status

Description

Resolution

LOJ

Closed

GUI Behavior when using Includes is not completed.

GUI is viewable not savable when using includes.  Basically disable saving of the GUI view.  Propose closing as not a risk, just work that needs to be done.

SPH

Closed

Display command fell of the radar

This command will be combined with Save and called Write. Propose closing as not a risk, just work that needs to be done.

DSC

Closed

Save command is not defined yet.

This command will be combined with Display and called Write. Propose closing as not a risk, just work that needs to be done.

DJC

Closed

MATLAB Writer for nav data. 

Stand alone is working, ready for GMAT integration.  Has MATLAB dependency which affects integration.  Tracked in ticket system.

RQ

Closed

Delta V computation from finite burn is not on task and harder than SPH's origional idea.

SDO is evaulating if approximations are good enough.  Since the maneuvers times are short, dt*thrust is an excellent approximation for delta-V.  Preliminary tests indicate about 1% error using approximation.

The main question from SDO was whether the approximations are good enough for the delta H maneuvers.  They see 5 sig figs which is good enough.  The approximation is not good enough for large maneuvers they plan far in the future.   Current plan is to change SOW deliverables for R2016b to include integration of delta V to ensure long term needs are met.  Deliver R2016a with the approximation.

DSC

Closed

Alpha/Beta Features are exposed but not easy to turn off.  FileThrust, GUIs for Nav components

This is being tracked on GMT-4862.   This does not seem to be a tall pole.  Propose closing as not a risk, just work that needs to be done.  Still need a plan for disabling untested data types. 

Scrub things that should be disabled.   For example, old syntax like DataFile, MeasurementModel.  This is being tracked in JIRA.

DSC

Closed

May need to use RedHat 6.?. 

Might need to use Windows, status of Linux for ODT is unknown.

 

FDF is running Linux 7, with workaround for ssh.

TGG

Closed

Installer for cross platform supporting SVN data update utility

Current plan is that Data Update Utility will be included only if time allows, and that means time to fix issues and get installer working.  Note, we probably do not need installer fro RC1, so that work could be pushed back until September if need be. 

 

Data file update utility will not be in R2016a, it will be in R2016b.

 

Tasks

All dates are referenced to 12:00 noon EDT.

For example, a deadline of March 15 should be interpreted as March 15, 12:00 noon EDT.

Git Repo Branching Policy

This is our branching strategy during RC testing by the FDF for ODT.

  • We will create a new R2017aTemp branch from master, and developers working on code changes for R2017a would work in R2017aTemp. 

  • Those working on docs, app freeze items, and the few remaining code updates for R2016a keep working in master. 

  • Code changes for master could continue to require code reading and CCB approval.

  • Once we've promoted the RCs to release builds, we'll first branch R2016a from master, then merge R2017aTemp back into master and return to normal branching/commit policy.

Early Tasks

These are long-lead early tasks that can be completed before the detailed release cycle.

Use "(/)" for the checkmark () and "(x)" for the cross ()

Task

Who

Status

Internal

Status

Notes

Task

Who

Status

Internal

Status

Notes

Review Previous Build Release R2015b Process Notes

All

 

Obtain Release Approvals

SPH

 

 

Needed by release day.

Get updated legal statement/license

SPH

N/A

 

Needed by Code Freeze.

Update sample scripts

SPH

Needed by App Freeze.

  • Write examples that demonstrate new functionality

  • Clean up all errors and warnings

  • Remove deprecated fields

Write draft Release Notes

SPH

Needed by App Freeze.

See Writing Release Notes

Update standard descriptive text

SPH

Needed by App Freeze.

Will be used in User Guide, websites, release announcement.

Update version number in User Guide cover

SPH

Needed by App Freeze.

Contact Katy Gammage or Mary Hrybyk-Keith to update cover page.

Next time: integrate sejda-console to do this automatically.

Update info on public-facing websites

TGG

 

 

Needed by Release Day.

See the list of sites. Update this list as well, if necessary.

Updated major sites before announcement. Minor ones can be updated a bit later.

Update release announcement contacts

SPH

 

 

Needed by Release Day. Located here.

Put in order for additional icons

SPH

(if necessary)

Needed by Visual Freeze.

For QA Complete (July 10)

QA complete means that all known bugs are being tracked, all bug fixes are verified and documented, and the release process can begin.

Use "(/)" for the checkmark () and "(x)" for the cross ()

Task

Who

Status

Notes

Task

Who

Status

Notes

Verify that all known bugs are checked into JIRA

(All)

DSC:

RQ:

SPH:

 

Complete all JIRA verifications

(All)

DSC:

RQ:

SPH:

   

 

Complete QA wrap-up tasks

DJC, SPH, JJKP, RQ

DSC:

RQ:

SPH:  

JJKP: Need to run save mode one last time before code freeze.

DJC: No Wrap-up tasks assigned to me

Address all JIRA tickets awaiting feedback

(All)

DSC:

RQ:

SPH:   

 

Mark .tc files with requirements and verify traceability to new requirements

(All)

DSC:
RQ:

SPH:  

This is new this year! 

Perform Static Analysis

TGG

 

For Visual Freeze (Aug. 5)

Visual Freeze finalizes all graphical changes to the software, so that screenshots, documentation, and TestComplete can be updated.

Use "(/)" for the checkmark () and "(x)" for the cross ()

Task

Who

Status

Internal

Status

Notes

Task

Who

Status

Internal

Status

Notes

Update About panel

LOJ

 

  1. Update release number (i.e. R2015a).  

  2. Add any new libraries used. 

  3. Update an links.

Update splash screen

TGG

  1. Add new contributors

  2. Remove contributors who did not contribute to this release

  3. Design updates

  4. Update SplashScreen.psd in GmatDevelopment\moredata\graphics\splash

  5. Use GIMP to save a flattened TIF file and overwrite splash screen in GmatDevelopment\application\data\graphics\splash.

  6. Make sure there is a BETA splash as well. 

Update icons

TGG

SPH:

WCS:

TGG: 

SPH:

WCS:

TGG: 

If there are any updates, additions, deletions.

Including GMATIcon for Welcome Page

Update gmat_startup_file.txt

WCS

 

 

  • Update formatting, comments

  • Add any additional plugins

  • Switch to release configuration (comment out alpha plugins)

Switch to release configuration in script test system

SPH

 

 

  • Create new rundef.R2015aInternal.template.m and rundef.R2015aPublic.template.m.

  • Switch autorun.m to use appropriate one.

Complete visual updates

(All)

 

For Code Freeze (Aug. 8) 

Code Freeze is a freeze on the software itself before final testing.

Use "(/)" for the checkmark () and "(x)" for the cross ()

Task

Who

Status

Internal

Status

Notes

Task

Who

Status

Internal

Status

Notes

Update EOP files (EOP, PCK, TK)

WCS

Update eopc04_08.62-now and run smoke tests and SPICE .bpc file (SHOULD be moved to App Freeze)

Update tai-utc file & naif LSK

WCS

Update gmat_startup_file with new LSK

Update Info.plist and RunGMAT as needed;

also, RunGmat.m if needed

WCS

Need copyright and release number/name at least; Update to default MATLAB version in test system file

Update files w/ updated legal statement

LOJ

 N/A

 N/A

  • Readme file

  • Source code files

Update license text

LOJ

N/A

N/A

Update application/License.txt file.  Nothing to do since license did not change.

Update copyright and code headers

LOJ

 N/A

 N/A

This tool makes adding paragraphs and changing headers simple.  http://sourceforge.net/projects/findandreplace/

As of R2015a these directories have files that need updating.

public\src (hpp, cpp)

public\plugin (hpp, cpp)

public\application\matlab\gmat_keyword (.m)

internal\code (hpp,cpp)

Final bug fixes

(All)

 

 

Mark all open bugs as Affects: current release

SPH

SPH: