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

Release Lead Roles

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.

Tasks

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
Review Previous Build Release R2015b Process Notes	All
Obtain Release Approvals	SPH	Done	Done	Needed by release day.
Get updated legal statement/license	SPH	Done	Done	Needed by Code Freeze.
Update sample scripts	SPH	Done	Done	Needed by App Freeze. Write examples that demonstrate new functionality Clean up all errors and warnings Remove deprecated fields
Write draft Release Notes	JJKP SPH	Done	Done	Needed by App Freeze. See Writing Release Notes
Update standard descriptive text	SPH	Done	Done	Needed by App Freeze. Will be used in User Guide, websites, release announcement.
Update version number in User Guide cover	JJKP	Done	Done	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	JJKP			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	Done	Done	(if necessary) Needed by Visual Freeze.

For QA Complete (Sept. 16)

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 ()

For Visual Freeze (Oct. 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
Update About panel	LOJ			Update release number (i.e. R2015a).   Add any new libraries used.  Update an links.
Update splash screen	TGG			Add new contributors Remove contributors who did not contribute to this release Design updates Update SplashScreen.psd in GmatDevelopment\moredata\graphics\splash Use GIMP to save a flattened TIF file and overwrite splash screen in GmatDevelopment\application\data\graphics\splash.
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	JJKP			Update formatting, comments Add any additional plugins Switch to release configuration (comment out alpha plugins)
Switch to release configuration in script test system	JJKP			Create new rundef.R2015aInternal.template.m and rundef.R2015aPublic.template.m. Switch autorun.m to use appropriate one.
Complete visual updates	(All)	SPH: RQ:

For Code Freeze (Oct. 9) 

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
Update EOP files	WCS			Update eopc04_08.62-now and run smoke tests and SPICE .bpc file
Update tai-utc file & naif LSK	WCS			Update gmat_startup_file with new LSK
Update Info.plist and RunGMAT as needed	WCS			Need copyright and release number/name at least
Update files w/ updated legal statement	LOJ			Readme file Source code files
Update license text	LOJ			Update application/License.txt file.  Nothing to do since license did not change.
Update copyright and code headers	LOJ			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:

For App Freeze (Oct 9) 

App Freeze is a freeze on all application bundle files beyond data and code. This includes documentation, sample scripts, stuff in the extras folder, etc.

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

Task	Who	Status	Notes
Update README.txt	JJKP	(/)	Update with major release highlights.
Update extras folder	JJKP	(/)	Notepad++ syntax coloring file
Update PDF files in docs folder	SPH/DJC	DJC:  SPH:	Update watermark: "Draft for Release R2015a" Put into application/docs folder, and individual doc source folders
Gather list of compatibility changes since last release	SPH		Deprecated fields Removed & disabled fields Anything a user would need to know to make R2013b scripts compatible with this release.
Update Release Notes	SPH
Update screenshots in User Guide	(Feature leads)	JJKP:  SPH:  RQ:  DSQ:
Test User Guide instructions & code	(Feature leads)	RQ:  DSQ:  JJKP:  SPH:	Tutorials Common Tasks script snippets reference page examples SPH:  only tested features that changed for which I was FDE
Update Windows installer package	JJKP
Update links in GMAT.ini	JJKP		Help links Welcome page links
Update link tests in TestComplete	TR		Help buttons Welcome Page links Help menu links

Testing of Release Candidate 1 (Oct 14 - Oct. 28 )

This will start with the 2014-05-05 daily build. Repeat this phase until tests check out. Steve will make the call.

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

Stage Release (Oct 30)

This is a soft release, putting all the files in place and updating information. Then on release day, we only need to send the announcements.  

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

* DJC can only do steps 1-3 here because of contractual constraints

Release Day (Nov. 2)

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

This needs to be assigned to a different person; DJC cannot post to SF

Post-Release

Use "(/)" for the checkmark ().

Notes for postmortem

Please add your notes to the R2015a Lessons Learned document.

Compatibility changes

See Writing Release Notes

Creating an RC

1. Create the build
   1. Log into gs580w-gmat-t4 as "gsfc580gmatbuild". The credentials are on the network drive, in the Infrastructure folder.
   2. Start Task Scheduler.
   3. [RC1 only] Disable the "GMAT Daily Build" task, so it doesn't run automatically during the RC cycle (this can make things overly confusing).
   4. Manually run the "GMAT Daily Build" task.
2. Create the bundles
   1. On your local system, navigate to GmatDevelopment\build\install\windows-nsis. Note that you do not need to pull files down from the Git repository; this process will pull files from the remote build and create the packages in your local directory. There's a README.txt file there that explains things.
   2. Open a MinGW, MSYS2, or Cygwin shell in this directory.
   3. Run 'make assemble VERSION="R2015a-rc#"', where "#" is the number of the RC you're creating. This will create two directories in the current directory: gmat-internal and gmat-public.

   4. Run the following commands to add the User Guide cover. This requires sejda-console.

      sejda-console merge -f ../../../doc/help/src/files/images/Cover-UserGuide-A4-Trimmed.pdf gmat-internal/GMAT/docs/help/help-a4.pdf -o gmat-internal/GMAT/docs/help/help-a4-new.pdf -s all:all:
      mv gmat-internal/GMAT/docs/help/help-a4-new.pdf gmat-internal/GMAT/docs/help/help-a4.pdf
      
      sejda-console merge -f ../../../doc/help/src/files/images/Cover-UserGuide-Letter-Trimmed.pdf gmat-internal/GMAT/docs/help/help-letter.pdf -o gmat-internal/GMAT/docs/help/help-letter-new.pdf -s all:all:
      mv gmat-internal/GMAT/docs/help/help-letter-new.pdf gmat-internal/GMAT/docs/help/help-letter.pdf
      
      sejda-console merge -f ../../../doc/help/src/files/images/Cover-UserGuide-A4-Trimmed.pdf gmat-public/GMAT/docs/help/help-a4.pdf -o gmat-public/GMAT/docs/help/help-a4-new.pdf -s all:all:
      mv gmat-public/GMAT/docs/help/help-a4-new.pdf gmat-public/GMAT/docs/help/help-a4.pdf
      
      sejda-console merge -f ../../../doc/help/src/files/images/Cover-UserGuide-Letter-Trimmed.pdf gmat-public/GMAT/docs/help/help-letter.pdf -o gmat-public/GMAT/docs/help/help-letter-new.pdf -s all:all:
      mv gmat-public/GMAT/docs/help/help-letter-new.pdf gmat-public/GMAT/docs/help/help-letter.pdf

   5. Run 'make VERSION="R2015a-rc#"', where "#" is the number of the RC you're creating. This will create four packages in the current directory: A .zip and a .exe file for both the internal and public versions. Note: To create only an internal version, run 'make internal VERSION="R2015a-rc#"'.
   6. Copy the four package files to the network: \\mesa-file\595\GMAT\Builds\windows\VS2013_build_32\R2015a
   7. To clean everything up afterwards, run "make clean".
3. Run the script test system on the internal installer package. See Running the script test system, below.

Note: To make the final release bundles, you can't just rename the files to take off the "-rc#" portion. You need to recreate the bundles using this command: make VERSION="R2015a" 

Running the script test system

In the steps below, "#" is the RC number and "<config>" is "internal" or "public".

1. Log into gs580w-gmat-t4 as "gsfc580gmattest". The credentials are on the network drive, in the Infrastructure folder.
2. [RC1 only] Start Task Scheduler and disable the "Run Script Test" task. You'll need to run the RC tests manually.
3. Uninstall all previous versions of GMAT.
4. Install the version being tested.
   1. Check "Enable MATLAB interface".
   2. Leave "Associate file types" unchecked.
5. Update the test system repo (located at C:\Users\gsfc580gmattest\Documents\GmatTest)
6. In MATLAB (64-bit):
   
   1. Run:
      >> cd C:\Users\gsfc580gmattest\Documents\GmatTest\bin
   2. Run (replace # with RC number and <config> with "internal" or "public"):
      >> diary('..\log\R2015a-rc#-<config>.log')
   3. Run (this command copies application files such as SPICE kernels needed for regression tests into the new installation of GMAT):
      >> preparegmat('C:\Path\To\GMAT')
   4. In C:\Users\testuser\Documents\GmatTest\bin, copy the appropriate template (autorundef.R2015aInternal.template.m or autorundef.R2015aPublic.template.m) to a new name (such as autorundef.R2015aRc1Internal.m) and fill in the values:
      
      1. RunDef.Build: "R2015a-rc#-<config>"
      2. RunDef.GmatExe: path to installed GMAT.exe
      3. RunDef.RegressionBuild: last build date if testing RC1 (look in GmatTest\output for latest folder, such as 2013-07-31), otherwise, "R2015a-rc#-<config>"
   5. Run:
      >> gmattest <name of rundef.m> (e.g. autorundef.R2015aRc1Internal.m) 
   6. Wait until run completes (usually 8+ hours)
   7. Run:
      >> diary('off')
7. In a Windows cmd window, post results to network using robocopy:
   >robocopy "C:\Users\gsfc580gmattest\Documents\GmatTest\output\R2015a-rc#-<config>" "\\mesa-file\595\GMAT\TestResults\win7\R2015a-rc#-<config>" /E /MT /LOG:%TEMP%\robocopy.txt