doc/release_steps.txt
changeset 3280 25fbf06f9a56
parent 3278 3abce59c8bf8
child 3288 8a4b9d15ff04
equal deleted inserted replaced
3279:61d5b66cdb25 3280:25fbf06f9a56
     6    - revise and check in RELEASE_NOTES
     6    - revise and check in RELEASE_NOTES
     7    - update and check in VERSION to the latest release number
     7    - update and check in VERSION to the latest release number
     8    - confirm that Doxygen builds cleanly and without warnings
     8    - confirm that Doxygen builds cleanly and without warnings
     9      (./waf check; ./waf --doxygen), and check in any necessary changes 
     9      (./waf check; ./waf --doxygen), and check in any necessary changes 
    10    - ensure no regressions (./waf --regression)
    10    - ensure no regressions (./waf --regression)
       
    11    - update the wscript in ns-3-dev to point REGRESSION_TRACES_TAR_NAME and
       
    12      REGRESSION_TRACES_DIR_NAME to the correct places.
    11 2. ./waf configure; ./waf dist
    13 2. ./waf configure; ./waf dist
    12    - this will create a ns-3.0.x.tar.bz2 tarball
    14    - this will create a ns-3.1x.tar.bz2 tarball
    13    - this will also create a ns-3.0.x-ref-traces.tar.bz2 tarball
    15    - this will also create a ns-3.1x-ref-traces.tar.bz2 tarball
    14 3. test tarball on release platforms (waf check and maybe some other scripts)
    16 3. test tarball on release platforms (waf check and maybe some other scripts)
    15 4. once you are happy with the tarball, tag ns-3-dev with "release ns-3.0.X"
    17 4. once you are happy with the tarball, tag ns-3-dev with "release ns-3.0.X"
    16    - hg tag "release ns-3.0.x"
    18    - hg tag "release ns-3.1x"
    17    - hg push 
    19    - hg push 
    18 5. clone the tagged ns-3-dev and place it on the repository
    20 5. clone the tagged ns-3-dev and place it on the repository
    19    - ssh code.nsnam.org; sudo tcsh; su code;
    21    - ssh code.nsnam.org; sudo tcsh; su code;
    20    - cp -r /home/code/repos/ns-3-dev /home/code/repos/ns-3.0.x
    22    - cp -r /home/code/repos/ns-3-dev /home/code/repos/ns-3.1x
    21    - cd /home/code/repos/ns-3.0.x/.hg and edit the hgrc appropriately:
    23    - cd /home/code/repos/ns-3.1x/.hg and edit the hgrc appropriately:
    22      "description = ns-3.0.x release
    24      "description = ns-3.1x release
    23       name = ns-3.0.x"
    25       name = ns-3.1x"
    24 6. Run the regression tests on the new release and update the reference traces
    26 6. Run the regression tests on the new release and update the reference traces
    25    - ./waf --regression
    27    - ./waf --regression
    26    - ./waf --valgrind --regression (for valgrind version)
    28    - ./waf --valgrind --regression (for valgrind version)
    27    - There should be no regression errors at this time
    29    - There should be no regression errors at this time
    28    - tag ns-3-dev-ref-traces with "release ns-3.0.X"
    30    - tag ns-3-dev-ref-traces with "release ns-3.1X"
    29      hg tag "release ns-3.0.x"
    31      hg tag "release ns-3.1x"
    30      hg push
    32      hg push
    31    - clone the ns-3-dev-ref-traces and place it on the repository as in step
    33    - clone the ns-3-dev-ref-traces and place it on the repository as in step
    32      5 but use the name ns-3.0.x-ref-traces
    34      5 but use the name ns-3.1x-ref-traces
    33 7. Create a reference traces tarball
    35 7. Create a reference traces tarball
    34    - again, run "./waf dist" 
    36    - again, run "./waf dist" 
    35 8. upload "ns-3.0.x.tar.bz2" to the /var/www/html/releases/ directory on 
    37 8. upload "ns-3.1x.tar.bz2" to the /var/www/html/releases/ directory on 
    36    the www.nsnam.org server
    38    the www.nsnam.org server
    37    - give it 644 file permissions, and user/group = apache
    39    - give it 644 file permissions, and user/group = apache
    38 9. upload "ns-3.0.x-ref-traces.tar.bz2" to the /var/www/html/releases/ 
    40 9. upload "ns-3.1x-ref-traces.tar.bz2" to the /var/www/html/releases/ 
    39    directory on the www.nsnam.org server
    41    directory on the www.nsnam.org server
    40    - give it 644 file permissions, and user/group = apache
    42    - give it 644 file permissions, and user/group = apache
    41 10. update web pages on www.nsnam.org (source is in the www/ module)
    43 10. update web pages on www.nsnam.org (source is in the www/ module)
    42    - clone the source repo (hg clone http://code.nsnam.org/www)
    44    - clone the source repo (hg clone http://code.nsnam.org/www)
    43    - add link to news.html
    45    - add link to news.html