doc/release_steps.txt
changeset 3289 bd7baccf47a3
parent 3288 8a4b9d15ff04
child 3358 42504fb1f7be
equal deleted inserted replaced
3288:8a4b9d15ff04 3289:bd7baccf47a3
    24    - cp -r /home/code/repos/ns-3-dev /home/code/repos/ns-3.1x
    24    - cp -r /home/code/repos/ns-3-dev /home/code/repos/ns-3.1x
    25    - cd /home/code/repos/ns-3.1x/.hg and edit the hgrc appropriately:
    25    - cd /home/code/repos/ns-3.1x/.hg and edit the hgrc appropriately:
    26      "description = ns-3.1x release
    26      "description = ns-3.1x release
    27       name = ns-3.1x"
    27       name = ns-3.1x"
    28    - clone the ns-3-dev-ref-traces and place it on the repository as above
    28    - clone the ns-3-dev-ref-traces and place it on the repository as above
    29      but use the name ns-3.1x-ref-traces
    29      but use the name ns-3.1x-ref-traces and edit the hgrc appropriately
    30 7. check out a clean version of the new release (ns-3.1x) somewhere
    30 7. check out a clean version of the new release (ns-3.1x) somewhere
    31 8. Update the VERSION for this new release
    31 8. Update the VERSION for this new release
    32    - change the string 3-dev in the VERSION file to the real version 
    32    - change the string 3-dev in the VERSION file to the real version 
    33      (e.g. 3.1)  This must agree with the version name you chose in the clone
    33      (e.g. 3.1)  This must agree with the version name you chose in the clone
    34      for the regression tests to work.
    34      for the regression tests to work.
    35    - hg commit
    35    - hg commit
    36    - hg push
    36    - hg push
    37 9. Run the regression tests on the new release
    37 9. Run the regression tests on the new release (debug and optimized)
       
    38    - ./waf -d debug configure
       
    39    - ./waf
       
    40    - ./waf --regression
       
    41    - ./waf --valgrind --regression (for valgrind version)
       
    42    - ./waf -d optimized configure
       
    43    - ./waf
    38    - ./waf --regression
    44    - ./waf --regression
    39    - ./waf --valgrind --regression (for valgrind version)
    45    - ./waf --valgrind --regression (for valgrind version)
    40    - There should be no regression errors at this time
    46    - There should be no regression errors at this time
    41 10. Create final tarballs
    47 10. Create final tarballs
    42    - run "./waf dist" 
    48    - ./waf configure; ./waf dist
       
    49    - this will create an ns-3.1x.tar.bz2 tarball
       
    50    - this will also create a ns-3.1x-ref-traces.tar.bz2 tarball
    43 11. upload "ns-3.1x.tar.bz2" to the /var/www/html/releases/ directory on 
    51 11. upload "ns-3.1x.tar.bz2" to the /var/www/html/releases/ directory on 
    44    the www.nsnam.org server
    52    the www.nsnam.org server
    45    - give it 644 file permissions, and user/group = apache
    53    - give it 644 file permissions, and user/group = apache
    46 12. upload "ns-3.1x-ref-traces.tar.bz2" to the /var/www/html/releases/ 
    54 12. upload "ns-3.1x-ref-traces.tar.bz2" to the /var/www/html/releases/ 
    47    directory on the www.nsnam.org server
    55    directory on the www.nsnam.org server
    59    - build and update Doxygen directory on the server
    67    - build and update Doxygen directory on the server
    60      -- edit ~/bin/update-doxygen-release file and change RELEASE variable 
    68      -- edit ~/bin/update-doxygen-release file and change RELEASE variable 
    61         to the right version number 
    69         to the right version number 
    62      -- run ~/bin/update-doxygen-release
    70      -- run ~/bin/update-doxygen-release
    63 14. Final checks
    71 14. Final checks
    64     - download tarball from web, build and run regression tests for as many
    72    - download tarball from web, build and run regression tests for as many
    65       targets as you can
    73      targets as you can
    66     - download release from mercurial, build and run regression tests for as
    74    - download release from mercurial, build and run regression tests for as
    67       many targets as you can
    75      many targets as you can
       
    76    - test and verify until you're confident the release is solid.
    68 15. announce to ns-developers, with summary of release notes
    77 15. announce to ns-developers, with summary of release notes