Support:Releasing

From Arianne
Revision as of 23:10, 4 March 2012 by imported>Hendrik Brummermann
Jump to navigation Jump to search

From /home/marauroa/doc/releasing.txt

Preparing for release

Announcements

  • Announce a code freeze (allow bug fixes only)
  • Ask testers to test everything new and everything old
  • Ask developers to update doc/CHANGES.txt
  • Ask testers to make nice screenshots of the changes (to use later for the arianne.sf.net announcement)

Version numbers

The correct way to change version numbers is to edit build.ant.properties then run ant init (or ant dist).

You edit the lines 

   version.old = 0.95
   version  = 0.96

Branching procedure

We develop code on HEAD and branch from HEAD for each release.

Eclipse is a good way to branch: from a HEAD checkout, right click and select Team -> Branch, Click details... to see the names of existing branches, like VERSION_00_RELEASE_XX, so that you are sure you're choosing a name for the new branch which sticks with conventions. Ensure your cvs timeout is sufficiently large that the branching prcoess can complete.

Once branch is successfully created, one can can update their IDE to use that branch (follow your IDE instructions for this) or for command line cvs, run cvs update -rVERSION_00_RELEASE_XX -Pd on your existing HEAD checkout to change it to be for the XX release.

Releasing

CVS Checkout

  • In a shell go to directory /home/marauroa/branch_cvs
  • Create subfolder with the version number (e. g. 1.00)
  • cd into subfolder
  • run with the correct branch name: cvs -d :pserver:arianne.cvs.sf.net:/cvsroot/arianne checkout -r VERSION_01_RELEASE_00 stendhal

Building the release

  • still in /home/marauroa/<version> move all the files from the subfolder "stendhal", which was created by CVS, one into the current folder: mv stendhal/* stendhal/.hotspotrc stendhal/.cvsignore .
  • copy the keystore.ks and build.ant-private.properties: cp ../skeleton/* .
  • download the last official release to build-archive: cd build-archive; wget http://arianne.sourceforge.net/download/stendhal.zip; mv stendhal.zip stendhal-<oldversion>.zip; cd ..
  • run ant dist
  • copy the output from the signupdated-step into an editor.

So, the download and release files are build nowupdate-0.95.properties.xxx

Preparing the updater

Note: 0.95 is the version of the update-base. (The last time the updater was broken).

  • download the file http://arianne.sourceforge.net/stendhal/updates/update-0.95.properties and save it as update-0.95.properties.xxx
  • edit update-0.95.properties.xxx. The file has lots of comments. Important: for the *file-list* file list parameters, stendhal/stendhal-diff must be the last entry in order to recover from a half download.
  • You need at least stendhal-data-1.xx.jar and stendhal-1.xx.jar for the initial download and stendhal-data-diff-1.xx-1.xx.jar,stendhal-diff-1.xx-1.xx.jar for the update. If there had been changes, include marauroa-client, stendhal-sound-diff and/or stendhal-music-diff.
  • Upload the files to the arianne webspace on Sourceforge.

Testing the updater

  • On your local computer find ~/.stendhal/jar/jar.properties and add this line server.update-prop-0.95=http://arianne.sourceforge.net/stendhal/updates/update-0.95.properties.
  • Test a normal update for the download client
  • Test a update for the webstart client.
  • Test a fresh download for the webstart client.
  • Test a webstart start with only diff-files (created by an update of a downloaded client) in the jar-folder


Note: The content on this page is very old and is likely outdated. You may want to check on the irc channel #arianne.


Uploading the File Release

  • download + z_old


You need to get the folder ready for the files to go in. You can: 

Make a shell session using
ssh -t kymara,arianne@shell.sourceforge.net create
then
cd /home/frs/project/a/ar/arianne/stendhal/
mkdir (version number)

From your directory of files, 
Copy these using for example
scp stendhal-*0.72.zip  kymara@frs.sourceforge.net:/home/frs/project/a/ar/arianne/stendhal/0.72
Upload a text file to the same location with release notes. 

Or, you can use the UI from sourceforge at Develop -> Project Admin -> File Manager to create the folder and upload the files.


Once files are uploaded,

Copy the server zip to the server machine

Next you need to make the diff files for the updater and sign them. 
Go back to your stendhal source directory. We need to know the differences between this version and the old one (as defined in build.ant.properties). So get a stendhal-oldversion.zip and copy it into the directory build-archive.

Now run:
ant -f release.xml  -Dkeystore.alias=miguelangelblanchlardin@hotmail.com -Dkeystore.password=qwerty

From build/lib, copy stendhal-data-diff-0.67-0.68.jar, stendhal-diff-0.67-0.68.jar, stendhal-starter-0.68.jar to your home directory on sf.net.
Use for example scp /home/katie/72stendhal/build/lib/stendhal-diff-0.71-0.72.jar kymara@web.sourceforge.net:htdocs/stendhal/updates/

The updater needs a correctly configured file at http://arianne.sourceforge.net/stendhal/updates/update.properties. We usually create one in that 
place called update.properties.xxx and test that it works correctly by editing our ~/stendhal/jar/jar.properties file to have the line 
server.update-prop=http\://arianne.sourceforge.net/stendhal/updates/update.properties.xxx

There is now an example of update.properties in src/games/stendhal/client/update. File sizes are gotten with ls -l.
To login and change these files, do e.g. ssh -t kymara,arianne@shell.sourceforge.net create 
or use scp as above.


Sourceforge side things
1) Enter in Sourceforge
2) Click in Develop -> Project Admin -> File Manager
3) Find stendhal and the newly added folder
4) Left click on the release notes text file you uploaded. Tick that it's a release note and save
5) left click on each other file and select the release note for it using teh drop down menu
6) left click on the main download file (full zip) and select all platforms
7) wait for them to show up

8) Finally email users (arianne-announce@..)
If not already done:
9) Copy diff files for updates and the properties file to /home/project-web/arianne/htdocs/stendhal/updates/
-9b) Copy stendhal-starter-0.XX.jar to /home/project-web/arianne/htdocs/jws/ - if needed
10) Test that updates work with update.properties.xxx. See above


Only do these next steps when you are sure that you are ready to restart server and make the release go live. get yourself a calming drink and take some deep breaths because the next 10 minutes is going to be hard work.
*Announce to users that server is going down. Shut it down. 
*Unzip your stendhal-server-XX.zip into the correct place
*Edit the version number server side in the script /home/marauroa/server/stendhal
*Wait for the person (you?) who is doing the client release to tell you when to restart server.

Back to client release as fast as possible.
11) Update /home/project-web/arianne/htdocs/stendhal.version to be 0.XX 
11b) NOT usually necessary as update takes care of it : Edit /home/project-web/arianne/htdocs/jws/stendhal.jnlp to 
have a 0.XX at the line <jar 
href="http://arianne.sourceforge.net/jws/stendhal-starter-0.YY.jar" ...
11c) Rename update.properties.xxx to update.properties

12) Finally you need to update the website.
13) Edit /home/project-web/arianne/htdocs/xml/game_stendhal.xml - update the top part for version and release date.
*Tell the server admin they are ok to restart the server
*Login to stendhal just to check all is ok

13b) Update the changelog on /home/project-web/arianne/htdocs/xml/game_stendhal.xml if you want to.
14) Finally write a news item at /home/project-web/arianne/htdocs/xml/website_news.xml
Just copy an old news item and edit it. Use the blurb and some nice screenshots.

If at the same time as doing you're stendhal release, you're also having to do a marauroa release (and all alone) then I sympathise. However the marauroa release is a lot easier. There are no updates 
to fiddle with. Just a simple file release, and rememeber to edit 
/home/project-web/arianne/htdocs/xml/server_marauroa.xml. 

For stendhal server website you need to edit /var/www/stendhal/configuration.php to show the new version. You can also make a news items there perhaps linking to the main news item at 
http://arianne.sf.net
To make new items, creatures and outfits show on the webpage you need to 
run a cvs update (to the new branch as detailed at top of this guide) in 
the folder /home/marauroa/branch_cvs/stendhal/. The folder for the 
website /var/www/stendhal/data/ is sym linked to this so that's it 
updated then.

After Release

TODO: Notify arianne-announce email list, Sourceforge Project News Feed, Twitter, Support:Pages_covering_Stendhal

Retrieved from "https://meet.konsthol.eu/w/index.php?title=Support:Releasing&oldid=48701"