MapStore Release Procedure

1. Open the issue inside the related milestone in github

2. Create a new branch 1.N.x

3. In 1.N.x create Tag 1.N_branch

   git tag -a 1.N_branch -m "Prepare 1.N release" git push origin --tags

4. In 1.N.x change the version reference for the other application (i.e ServiceBox, http_proxy etc...) ONLY IF necessary

5. In 1.N.x make a check build and a check tour of the main component:

    - MapManager
    - WMSGetFeatureInfo tools
    - MarkerEditor
    - Metadata Explorer
    - Import Export
    - Print plugin 
    - BBOXQueryForm
    - PrintSnapshot
   

Then should be tested also:

	- MapStore Binary    (using 'ant release' and 'ant gnrelease')
	- MapStore Installer (https://github.com/geosolutions-it/mapstore/wiki/Windows-Installer)
	- Site    (using 'ant site')

6. In 1.N.x make a 'mvn deploy' (THIS NOT FOR MAPSTORE but only for maven applications: GeoStore, ServiceBox, Http_Proxy etc...)

7. Upload MapStore binaries (mapstore-binary-v1.x-zip and mapstoregn-binary-1.x.zip) and installers (mapstore-1.x.exe and mapstoregn-1.x.exe) to demo server and copy to the lastest versions.

You need

• Create a folder on /home/www/share/github/mapstore/downloads/binaries/1.N.x
• Upload files via sftp

When you'll finished the status of the files should be:

.
├── 1.N.x
│   ├── mapstore-1.N.x.exe
│   ├── mapstore-binary-v1.N.x.zip
│   ├── mapstoregn-1.N.x.exe
│   └── mapstoregn-binary-1.N.x.zip
├── mapstore-binary-latest.zip <-- Copy of mapstore-binary-v1.N.x.zip
├── mapstoregn-binary-latest.zip <-- Copy of mapstoregn-binary-1.N.x.zip
├── mapstoregn-latest.exe <-- Copy of mapstoregn-1.N.x.exe
└── mapstore-latest.exe <-- Copy of mapstore-1.N.x.exe

8. In 1.N.x do commit&push(-m "Prepare for next 1.N release iteration")

9. In 1.N.x create a Tag v1.N and push it:

    git tag -a v1.N -m "Final 1.N release"
    git push origin --tags
   

10. In 1.N.x change the version reference with the olds one and then make commit&push

            (-m "Revert the project to the 1.N-SNAPSHOT version")
    

11. In master upgrade the project version 1.(N+1)-SNAPSHOT and then do commit&push

            (-m "Update the project to the 1.(N+1)-SNAPSHOT version")
    

12. In master make a 'mvn deploy' for the new SNAPSHOT (THIS NOT FOR MAPSTORE but only for maven applications: GeoStore, ServiceBox, Http_Proxy etc...)

13. Upload war files generated with ant site to demo2 server:

• Update http_proxy, geostore, servicebox applications if needed on /usr/local/tomcat_instances/geostore/webapps/

Maybe you need to run the mapstore-migrator. If it's needed you should follow belowed steps:

1. Backup geostore db pg_dump geostore > geostore.dmp
2. Clone repository
3. Change the migrate.properties
4. Recompile migrator
5. Run the migrator

Finally you must check the status of the demo, checking all maps available

14. Write release notes of the 1.x version like 1.4 Release Notes and add to main wiki page.

15. Close the opened issue on GitHub