|
NeoOffice 3.0.2 Early Access Release Tasks
From NeoWiki
Revision as of 23:40, 28 December 2009 (edit) ( | contribs) (Update task statuses) ← Previous diff |
Revision as of 01:50, 19 January 2010 (edit) (undo) ( | contribs) (Update cvs commands to use new bin/cvsplusperms.sh script) Next diff → |
||
Line 108: | Line 108: | ||
<p>This includes the following steps:</p> | <p>This includes the following steps:</p> | ||
<ul> | <ul> | ||
- | <li>Do a <tt> | + | <li>Do a <tt>bin/cvsplusperms.sh update -Ad</tt> to ensure that you have the latest code in your workspace, verify that none of the files are marked as updated, patched, modified, or have conflicts, and verify that the latest code actually builds through the installer.</li> |
<li>Copy <tt>custom.neo.mk</tt> file to <tt>custom.mk</tt> so that the clean checkout will build with the trademarked product names.</li> | <li>Copy <tt>custom.neo.mk</tt> file to <tt>custom.mk</tt> so that the clean checkout will build with the trademarked product names.</li> | ||
<li> | <li> | ||
Line 157: | Line 157: | ||
<p>Tag the code in the HEAD branch with the <tt>NeoOffice-3_0_2_Early_Access</tt> tag using the following:</p> | <p>Tag the code in the HEAD branch with the <tt>NeoOffice-3_0_2_Early_Access</tt> tag using the following:</p> | ||
<ul> | <ul> | ||
- | <li>Do a <tt> | + | <li>Do a <tt>bin/cvsplusperms.sh update -Ad</tt> to ensure that you have the latest code in your workspace, verify that none of the files are marked as updated, patched, modified, or have conflicts, and verify that the latest code actually builds through the installer.</li> |
- | <li>Tag all files in your workspace by invoking <tt> | + | <li>Tag all files in your workspace by invoking <tt>bin/cvsplusperms.sh tag NeoOffice-3_0_2_Early_Access</tt>.</li> |
- | <li>If there are any build errors, fix and commit them, retag the changed files by invoking <tt> | + | <li>If there are any build errors, fix and commit them, retag the changed files by invoking <tt>bin/cvsplusperms.sh tag -F NeoOffice-3_0_2_Early_Access</tt>, and repeating the step.</li> |
</ul> | </ul> | ||
</td> | </td> | ||
Line 170: | Line 170: | ||
<p>Note: the following steps are overkill, but they ensure that all recent changes to the NeoOffice custom code has been built:</p> | <p>Note: the following steps are overkill, but they ensure that all recent changes to the NeoOffice custom code has been built:</p> | ||
<ul> | <ul> | ||
- | <li>Do a <tt> | + | <li>Do a <tt>bin/cvsplusperms.sh update -d -rNeoOffice-3_0_2_Early_Access</tt> and verify that none of the files are marked as updated, patched, modified, or have conflicts. If any such errors appear, the previous task (tagging of the workspace) has not been done properly and it needs to done properly before you can proceed with this task.</li> |
- | <li>Do a <tt> | + | <li>Do a <tt>bin/cvsplusperms.sh update -Ad</tt> so that you can do bug fixing and release patches after you create your releasable build</li> |
<li>Delete all <tt>build.neo_*</tt> and <tt>build.odf-converter*</tt> files. This will force the installer to rebuild the odf-converter code and all of the NeoOffice custom code without causing any of the OpenOffice.org or ooo-build code to be rebuilt.</li> | <li>Delete all <tt>build.neo_*</tt> and <tt>build.odf-converter*</tt> files. This will force the installer to rebuild the odf-converter code and all of the NeoOffice custom code without causing any of the OpenOffice.org or ooo-build code to be rebuilt.</li> | ||
<li>Invoke <tt>make all</tt> to create the releasable installer and language packs.</li> | <li>Invoke <tt>make all</tt> to create the releasable installer and language packs.</li> | ||
Line 294: | Line 294: | ||
<li>Manually edit all of the <tt>strings_*.php</tt> pages in the <tt>/includes</tt> directory and set the <tt>$eapDonationStartDate</tt>, <tt>$eapEndDate</tt>, and <tt>$eapStartDate</tt> values to the Early Access Program start and end dates wherever they are listed.</li> | <li>Manually edit all of the <tt>strings_*.php</tt> pages in the <tt>/includes</tt> directory and set the <tt>$eapDonationStartDate</tt>, <tt>$eapEndDate</tt>, and <tt>$eapStartDate</tt> values to the Early Access Program start and end dates wherever they are listed.</li> | ||
<li>Manually edit all of the <tt>earlyaccessfeatures.php</tt> pages in the <tt>/neojava</tt> directory and add any new or missing features compared to the matching OpenOffice.org version.</li> | <li>Manually edit all of the <tt>earlyaccessfeatures.php</tt> pages in the <tt>/neojava</tt> directory and add any new or missing features compared to the matching OpenOffice.org version.</li> | ||
- | <li>After you verify that the changes look correct, invoke the following command to commit your changes: <tt> | + | <li>After you verify that the changes look correct, invoke the following command to commit your changes: <tt>bin/cvsplusperms.sh commit</tt></li> |
</ul> | </ul> | ||
</td> | </td> | ||
Line 301: | Line 301: | ||
<tr> | <tr> | ||
- | <td>Tag the <tt>www.neooffice.org</tt> website to avoid modifying production web pages while we modify the web pages in the test website by logging into the <tt>www.neooffice.org</tt> server, <tt>cd</tt> to the its webroot directory, and set the tag by invoking the following commands: <tt> | + | <td>Tag the <tt>www.neooffice.org</tt> website to avoid modifying production web pages while we modify the web pages in the test website by logging into the <tt>www.neooffice.org</tt> server, <tt>cd</tt> to the its webroot directory, and set the tag by invoking the following commands: <tt>bin/cvsplusperms.sh tag NeoOffice-3_0_2_Early_Access ; bin/cvsplusperms.sh update -d -rNeoOffice-3_0_2_Early_Access</tt> |
</td> | </td> | ||
<td>12/14/2009</td><td>pluby</td><td>Done</td> | <td>12/14/2009</td><td>pluby</td><td>Done</td> | ||
Line 317: | Line 317: | ||
<li>Manually edit all of the <tt>header.html</tt> pages in the <tt>/neojava</tt> directory and put the NeoOffice 3.0.2 Early Access announcement within the news banner's "if ($earlyaccessdownloadenabled)" section.</li> | <li>Manually edit all of the <tt>header.html</tt> pages in the <tt>/neojava</tt> directory and put the NeoOffice 3.0.2 Early Access announcement within the news banner's "if ($earlyaccessdownloadenabled)" section.</li> | ||
<li>Manually edit the <tt>/neojava/donations/config.php</tt> file and set the <tt>DONATIONSDOWNLOADCOOKIEKEY</tt> and <tt>DONATIONSDOWNLOADCOOKIEVALUE</tt> defines to values that have not been used in past Early Access Programs.</li> | <li>Manually edit the <tt>/neojava/donations/config.php</tt> file and set the <tt>DONATIONSDOWNLOADCOOKIEKEY</tt> and <tt>DONATIONSDOWNLOADCOOKIEVALUE</tt> defines to values that have not been used in past Early Access Programs.</li> | ||
- | <li>After you verify that the changes look correct, invoke the following command to commit your changes: <tt> | + | <li>After you verify that the changes look correct, invoke the following command to commit your changes: <tt>bin/cvsplusperms.sh commit</tt></li> |
</ul> | </ul> | ||
</td> | </td> | ||
Line 324: | Line 324: | ||
<tr> | <tr> | ||
- | <td>Manually edit the <tt>mirror_htdocs</tt> CVS module's <tt>/neojava/earlyaccessdownloads/.htaccess</tt>, update any lines to match the changes made in the <tt>www_htdocs</tt> CVS module's <tt>/neojava/donations/config.php</tt> file, and if the changes look correct, invoke the following command to commit your changes: <tt> | + | <td>Manually edit the <tt>mirror_htdocs</tt> CVS module's <tt>/neojava/earlyaccessdownloads/.htaccess</tt>, update any lines to match the changes made in the <tt>www_htdocs</tt> CVS module's <tt>/neojava/donations/config.php</tt> file, and if the changes look correct, invoke the following command to commit your changes: <tt>bin/cvsplusperms.sh commit</tt>. Then, propagate the change by logging into each of the servers listed in the <tt>www_htdocs</tt> CVS module's <tt>/neojava/includes/earlyaccessmirrors.php</tt> file and invoking the following command: <tt>bin/cvsplusperms.sh update -Ad</tt></td> |
<td>12/15/2009</td><td>pluby</td><td>Done</td> | <td>12/15/2009</td><td>pluby</td><td>Done</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
- | <td>Update the NeoOffice 3.0.2 Early Access main installer and language pack file sizes and set the 2 patch file sizes to <tt>0</tt> in the <tt>/neojava/includes/globals/earlyaccessfilesizes.php</tt> file and if the changes look correct, invoke the following command to commit your changes: <tt> | + | <td>Update the NeoOffice 3.0.2 Early Access main installer and language pack file sizes and set the 2 patch file sizes to <tt>0</tt> in the <tt>/neojava/includes/globals/earlyaccessfilesizes.php</tt> file and if the changes look correct, invoke the following command to commit your changes: <tt>bin/cvsplusperms.sh commit</tt></td> |
<td>12/27/2009</td><td>pluby</td><td>Done</td> | <td>12/27/2009</td><td>pluby</td><td>Done</td> | ||
</tr> | </tr> | ||
Line 339: | Line 339: | ||
<tr> | <tr> | ||
- | <td>Prepare the <tt>NeoOffice_3.0.2_Early_Access.html</tt> press release file, save it in the <tt>www-test-primary.neooffice.org</tt> website's <tt>/press_releases</tt> directory using the following naming format, <tt> | + | <td>Prepare the <tt>NeoOffice_3.0.2_Early_Access.html</tt> press release file, save it in the <tt>www-test-primary.neooffice.org</tt> website's <tt>/press_releases</tt> directory using the following naming format, <tt>bin/cvsplusperms.sh add</tt> the file, and invoke the following command to commit the new file: <tt>bin/cvsplusperms.sh commit</tt></td> |
<td>12/28/2009</td><td>pluby</td><td>Done</td> | <td>12/28/2009</td><td>pluby</td><td>Done</td> | ||
</tr> | </tr> | ||
Line 373: | Line 373: | ||
<tr> | <tr> | ||
- | <td>Verify that all mirrors listed for the NeoOffice 3.0.2 Early Access main installer and language pack links work in the <tt>www-test.neooffice.org</tt> website's Early Access Program download pages. If any do not work, comment them out in the <tt>/neojava/includes/earlyaccessmirrors.php</tt> file (for the main installer) and in the <tt>neojava/includes/mirror.php</tt> (for the language packs) and invoke the following command: <tt> | + | <td>Verify that all mirrors listed for the NeoOffice 3.0.2 Early Access main installer and language pack links work in the <tt>www-test.neooffice.org</tt> website's Early Access Program download pages. If any do not work, comment them out in the <tt>/neojava/includes/earlyaccessmirrors.php</tt> file (for the main installer) and in the <tt>neojava/includes/mirror.php</tt> (for the language packs) and invoke the following command: <tt>bin/cvsplusperms.sh commit</tt></td> |
<td>12/27/2009</td><td>pluby</td><td>Done</td> | <td>12/27/2009</td><td>pluby</td><td>Done</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
- | <td>Make the NeoOffice 3.0.2 Early Access binaries downloadable from the <tt>www.neooffice.org</tt> website's Early Access Program download pages by updating the <tt>www.neooffice.org</tt> website's pages to match what is in the <tt>www-test.neooffice.org</tt> website's pages. Login into the <tt>www.neooffice.org</tt> server, <tt>cd</tt> to the its webroot directory, and invoke the following command: <tt> | + | <td>Make the NeoOffice 3.0.2 Early Access binaries downloadable from the <tt>www.neooffice.org</tt> website's Early Access Program download pages by updating the <tt>www.neooffice.org</tt> website's pages to match what is in the <tt>www-test.neooffice.org</tt> website's pages. Login into the <tt>www.neooffice.org</tt> server, <tt>cd</tt> to the its webroot directory, and invoke the following command: <tt>bin/cvsplusperms.sh update -Ad</tt></td> |
<td>12/28/2009</td><td>pluby</td><td>Done</td> | <td>12/28/2009</td><td>pluby</td><td>Done</td> | ||
</tr> | </tr> |
Revision as of 01:50, 19 January 2010
This page is an attempt to document all of the tasks required to release NeoOffice 3.0.2 Early Access. This page is by no means comprehensive, but hopefully as we work through the release process, we will leave behind enough details to make future releases simpler and less error prone.
Here is what the colors mean:
Not yet assigned | |
Assigned but not yet due |
Contents |
Builds
In this release, we are making changes to NeoOffice's underlying OpenOffice.org code. Also, new application and toolbar icons were added. Because of these changes, an upgrade patch would be excessive large so no upgrade patch will be released.
Task | Date Completed | Assigned | Status |
Commit and test updated icon files and copyright date range changes in your workspace's NeoOffice 3.0.2 etc/package directory.
|
11/13/2009 | pluby | Done |
Commit and test updated icon files in your workspace's NeoOffice 3.0.2 etc/package directory.
|
12/7/2009 | pluby | Done |
Rebuild all custom NeoOffice code using the existing NeoOffice 3.0.1 development builds. Perform a confirming checkout of the HEAD branch and set build to build with a new version and the NeoOffice trademarked product names. This includes the following steps:
|
12/12/2009 | pluby | Done |
Verify that none of the NeoOffice 3.0.2 Early Access Intel build's executables or libraries link to any X11 libraries. Note: to do this task, install your latest NeoOffice build and, in a terminal, execute the following commands: sh cd /Applications/NeoOffice.app/Contents for i in `find . -type f`; do echo $i ; otool -L $i 2>&1 | grep X11; done If none of the binaries link to any X11 libraries, the above commands will only print a list of files. However, if you see any lines that look similar to the following, the file listed just before this type of line is linked to an X11 library and this must be correct before the NeoOffice binaries can be released. /usr/X11R6/lib/libX11.6.dylib (compatibility version 6.2.0, current version 6.2.0) |
12/14/2009 | pluby | Done |
Verify that none of the NeoOffice 3.0.2 Early Access PowerPC build's executables or libraries link to any X11 libraries. Note: Use the same steps as used for the matching Intel task. |
12/14/2009 | pluby | Done |
Tag the code in the HEAD branch with the NeoOffice-3_0_2_Early_Access tag using the following:
|
pluby | ||
Create releasable NeoOffice 3.0.2 Early Access build for Intel. Note: the following steps are overkill, but they ensure that all recent changes to the NeoOffice custom code has been built:
|
12/27/2009 | pluby | Done |
Create releasable NeoOffice 3.0.2 Early Access build for PowerPC. Note: Use the same steps as used for the matching Intel task. |
12/27/2009 | pluby | Done |
Create backup copy of the NeoOffice 3.0.2 Early Access releasable Intel binaries and upload them to staging server. The following steps are the steps that I used to create my backup copy:
Put the NeoOffice-3.0.2_Early_Access folder in a new empty directory and create a CD master NeoOffice-3.0.2_Early_Access.cdr file of the new directory using the following command: hdiutil create -srcfolder /path/to/new/directory \ -format UDTO -ov -o /path/to/output/NeoOffice-3.0.2_Early_Access.cdr |
12/27/2009 | pluby | Done |
Create backup copy of the NeoOffice 3.0.2 Early Access releasable PowerPC binaries and upload them to staging server. Note: Use the same steps as used for the matching Intel task. |
12/27/2009 | pluby | Done |
Verify that the releasable NeoOffice 3.0.2 Early Access installers and one or more language packs install and run on Intel for the following Mac OS X versions:
|
12/27/2009 | pluby | Done |
Verify that the releasable NeoOffice 3.0.2 Early Access installers and one or more language packs install and run on PowerPC for the following Mac OS X versions:
|
12/27/2009 | pluby | Done |
Mirrors
NeoOffice's rsync server is hosted on rsync.neooffice.org and our volunteer mirrors obtain the NeoOffice binaries by nightly runs of the following command on their mirrors:
rsync --archive --delete rsync://rsync.neooffice.org/neojavadownloads/ \ /path/to/NeoOffice/mirror/directory
Note that the NeoOffice Early Access Program main installer binaries are only mirrored on neooffice.org servers so using the above command will only copy the language pack and patch binaries.
Task | Date Completed | Assigned | Status |
Copy the 2 NeoOffice main installer NeoOffice-3.0.2_Early_Access-*.dmg files from the joe.neooffice.org server's /neojava/earlyaccessdownloads directory to the /neojava/earlyaccessdownloads directory on all of the mirrors listed in the joe.neooffice.org server's /neojava/includes/earlyaccessmirrors.php file. | 12/27/2009 | pluby | Done |
Upload the 116 NeoOffice language pack installer NeoOffice-3.0.2_Early_Access-Language_Pack_*.dmg files to the joe.neooffice.org server's /neojava/downloads directory. | 12/14/2009 | pluby | Done |
Website
Task | Date Completed | Assigned | Status |
Set the start and end dates and new features for the upcoming Early Access Program on the www-test-primary.neooffice.org server's neojava directory. Note: I used the following steps to do this:
$earlyaccessdownloadenabled = false; $earlyaccessredirectenabled = false; $earlyaccessfreeproduct = 'NeoOffice 3.0.2'; $earlyaccessproductversion = '3.0.2 Early Access'; $earlyaccessproductfamily[0] = ''; $earlyaccesspatch = 'Patch 0'; $oldearlyaccessproductversion = ''; $oldearlyaccessproductfamily[0] = ''; |
12/2/2009 | pluby | Done |
Tag the www.neooffice.org website to avoid modifying production web pages while we modify the web pages in the test website by logging into the www.neooffice.org server, cd to the its webroot directory, and set the tag by invoking the following commands: bin/cvsplusperms.sh tag NeoOffice-3_0_2_Early_Access ; bin/cvsplusperms.sh update -d -rNeoOffice-3_0_2_Early_Access | 12/14/2009 | pluby | Done |
Update all NeoOffice and version names, file URLs, and patch version names in all of the files in the www-test-primary.neooffice.org server's neojava directory. Note: I used the following steps to do this:
$earlyaccessdownloadenabled = true; |
12/15/2009 | pluby | Done |
Manually edit the mirror_htdocs CVS module's /neojava/earlyaccessdownloads/.htaccess, update any lines to match the changes made in the www_htdocs CVS module's /neojava/donations/config.php file, and if the changes look correct, invoke the following command to commit your changes: bin/cvsplusperms.sh commit. Then, propagate the change by logging into each of the servers listed in the www_htdocs CVS module's /neojava/includes/earlyaccessmirrors.php file and invoking the following command: bin/cvsplusperms.sh update -Ad | 12/15/2009 | pluby | Done |
Update the NeoOffice 3.0.2 Early Access main installer and language pack file sizes and set the 2 patch file sizes to 0 in the /neojava/includes/globals/earlyaccessfilesizes.php file and if the changes look correct, invoke the following command to commit your changes: bin/cvsplusperms.sh commit | 12/27/2009 | pluby | Done |
Update the name and start and end dates for the current Early Access Program membership and subscription categories in the Early Access Program database by logging into the the www.neooffice.org server and using the server's /neojava/donationsadmin/manage_categories.php program to update the names and start and end dates for the current Early Access Program membership and subscription categories. Note that the start date should overlap slightly with the end date of the last Early Access Program to ensure that no donations get missed. | 12/15/2009 | pluby | Done |
Prepare the NeoOffice_3.0.2_Early_Access.html press release file, save it in the www-test-primary.neooffice.org website's /press_releases directory using the following naming format, bin/cvsplusperms.sh add the file, and invoke the following command to commit the new file: bin/cvsplusperms.sh commit | 12/28/2009 | pluby | Done |
Release
Generally, we try to time the release when it is early morning of the release date in New Zealand which is the most populous country closest to the international date line. So for this release, 29 December 2009 translates to in the afternoon on 28 December 2009 in California.
Task | Date Completed | Assigned | Status |
Synchronize the donation's database to PayPal's database to ensure that none of the donors' transactions are missing and to pick up any e-mail address changes made by donors during the Early Access period using the following steps:
|
12/27/2009 | pluby | Done |
Verify that all mirrors listed for the NeoOffice 3.0.2 Early Access main installer and language pack links work in the www-test.neooffice.org website's Early Access Program download pages. If any do not work, comment them out in the /neojava/includes/earlyaccessmirrors.php file (for the main installer) and in the neojava/includes/mirror.php (for the language packs) and invoke the following command: bin/cvsplusperms.sh commit | 12/27/2009 | pluby | Done |
Make the NeoOffice 3.0.2 Early Access binaries downloadable from the www.neooffice.org website's Early Access Program download pages by updating the www.neooffice.org website's pages to match what is in the www-test.neooffice.org website's pages. Login into the www.neooffice.org server, cd to the its webroot directory, and invoke the following command: bin/cvsplusperms.sh update -Ad | 12/28/2009 | pluby | Done |
Append the NeoOffice MD5 checksums page with the NeoOffice 3.0.2 Early Access MD5 checksums. | 12/27/2009 | pluby | Done |
Add "3.0.2 EA" as a version in Bugzilla. | 12/15/2009 | pluby | Done |
Close all bugs with a status of "Resolved" by setting the following field values:
|
12/29/2009 | pluby | Done |
Close any bugs with a status of "Assigned" or "Reopened" and resolution of "Fixed" (bugs fixed in the release build after the final Early Access patch) by setting the following field values:
|
12/29/2009 | pluby | Done |
Post the press release as an article on trinity.neooffice.org. Note: be sure to change the language field from "English" to "All" in when submitting the article so that all Trinity users will see the article. | 12/28/2009 | pluby | Done |
Post a release announcement to this Trinity forum topic, this Trinity forum topic, and this Trinity forum topic so that the news is included in the RSS feed. | 12/28/2009 | pluby | Done |