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-- |
776 | 1 |
Steps in doing an ns-3 release |
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 | 4 |
1. prepare the source files |
5 |
- revise and check in AUTHORS, if needed |
|
6 |
- revise and check in RELEASE_NOTES |
|
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 | 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 | 12 |
3. test tarball on release platforms (waf check and maybe some other scripts) |
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 | 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 | 19 |
- cd /home/code/repos/ns-3.0.x/.hg and edit the hgrc appropriately: |
20 |
"description = ns-3.0.x release |
|
21 |
name = ns-3.0.x" |
|
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 | 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 | 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 | 32 |
-- edit ~/bin/update-doxygen-release file and change RELEASE variable |
33 |
to the right version number |
|
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 |