doc/release_steps.txt
author Tom Henderson <tomh@tomh.org>
Sat, 16 Feb 2008 13:24:08 -0800
changeset 2343 85959d329c8c
parent 2194 25bad6958d13
child 2865 d40eb18a4da0
permissions -rw-r--r--
a few tweaks to the release steps document
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
776
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     1
Steps in doing an ns-3 release
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     2
1789
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
     3
0. check out a clean ns-3-dev somewhere
776
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     4
1. prepare the source files
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     5
   - revise and check in AUTHORS, if needed
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     6
   - revise and check in RELEASE_NOTES
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     7
   - update and check in VERSION to the latest release number
1797
7cd3c92af131 Add Doxygen cleanup as a release step
Tom Henderson <tomh@tomh.org>
parents: 1789
diff changeset
     8
   - confirm that Doxygen builds cleanly and without warnings
7cd3c92af131 Add Doxygen cleanup as a release step
Tom Henderson <tomh@tomh.org>
parents: 1789
diff changeset
     9
     (./waf --doxygen), and check in any necessary changes 
2194
25bad6958d13 update release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1797
diff changeset
    10
2. ./waf configure; ./waf dist
1789
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
    11
   - this will create a ns-3.0.x.tar.bz2 tarball
2194
25bad6958d13 update release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1797
diff changeset
    12
3. test tarball on release platforms (waf check and maybe some other scripts)
25bad6958d13 update release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1797
diff changeset
    13
4. once you are happy with the tarball, tag ns-3-dev with "release ns-3.0.X"
1789
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
    14
   - hg tag "release ns-3.0.x"
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
    15
   - hg push 
2194
25bad6958d13 update release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1797
diff changeset
    16
5. clone the tagged ns-3-dev and place it on the repository
2343
85959d329c8c a few tweaks to the release steps document
Tom Henderson <tomh@tomh.org>
parents: 2194
diff changeset
    17
   - ssh code.nsnam.org; sudo tcsh; su code;
1789
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
    18
   - cp -r /home/code/repos/ns-3-dev /home/code/repos/ns-3.0.x
2194
25bad6958d13 update release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1797
diff changeset
    19
   - cd /home/code/repos/ns-3.0.x/.hg and edit the hgrc appropriately:
25bad6958d13 update release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1797
diff changeset
    20
     "description = ns-3.0.x release
25bad6958d13 update release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1797
diff changeset
    21
      name = ns-3.0.x"
25bad6958d13 update release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1797
diff changeset
    22
6. upload "ns-3.0.x.tar.bz2" to the /var/www/html/releases/ directory on 
1789
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
    23
   the www.nsnam.org server
2343
85959d329c8c a few tweaks to the release steps document
Tom Henderson <tomh@tomh.org>
parents: 2194
diff changeset
    24
   - give it 644 file permissions, and user/group = apache
85959d329c8c a few tweaks to the release steps document
Tom Henderson <tomh@tomh.org>
parents: 2194
diff changeset
    25
7. update web pages on www.nsnam.org (source is in the www/ module)
776
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    26
   - add link to news.html
1789
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
    27
   - update getting_started.html
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
    28
   - update documents.html
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
    29
   - update roadmap on wiki
776
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    30
   - build and update Doxygen directory on the server
1789
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
    31
     -- ssh www.nsnam.org; sudo tcsh; su nsnam;
2194
25bad6958d13 update release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1797
diff changeset
    32
     -- edit ~/bin/update-doxygen-release file and change RELEASE variable 
25bad6958d13 update release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1797
diff changeset
    33
        to the right version number 
25bad6958d13 update release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1797
diff changeset
    34
     -- run ~/bin/update-doxygen-release
2343
85959d329c8c a few tweaks to the release steps document
Tom Henderson <tomh@tomh.org>
parents: 2194
diff changeset
    35
8. announce to ns-developers, with summary of release notes