NeoOffice 3.0 Early Access Release Tasks

From NeoWiki

(Difference between revisions)
Jump to: navigation, search
Revision as of 21:35, 11 January 2009 (edit)
( | contribs)
(Website - Update task descriptions and statuses)
← Previous diff
Revision as of 21:43, 11 January 2009 (edit) (undo)
( | contribs)
(Release - Update task descriptions)
Next diff →
Line 329: Line 329:
== Release == == 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, 15 January 2009 translates to afternoon on 14 January 2009 in California.+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, 15 January 2009 translates to in the afternoon on 14 January 2009 in California.
<table width="100%" border="1"> <table width="100%" border="1">
Line 338: Line 338:
<tr bgcolor="pink"> <tr bgcolor="pink">
- <td>Add "3.0 Early Access" as a version in [http://bugzilla.neooffice.org/ Bugzilla].</td>+ <td>
 + <p>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:</p>
 + <ul>
 + <li>Login to PayPal, click on the History tab, click on Download My History link, select Custom Date Range, enter the day before the start of the Early Access period as the "From" date and the current date as the "To" date, and "Comma Delimited - All Activity" as the "File Types to Download".</li>
 + <li>It will take some time for PayPal to prepare the file. Once the file is ready, download it and use <tt>sftp</tt> to copy it to the <tt>www.neooffice.org</tt> server. Note: be sure to delete your local copy.</li>
 + <li>Once the history file is on the <tt>www.neooffice.org</tt> server, login to the server, <tt>cd</tt> to the <tt>/donationsadmin</tt> directory, and execute the following command to import the history file:
 +<pre>
 +sh
 +./import_paypal_transaction_history.php /path/to/history/file 2>/path/to/error/file
 +</pre>
 + </li>
 + <li>Inspect the entries in the error file created in the previous command and verify that none of the rejected lines from the file are donor transactions.</li>
 + </ul>
 + </td>
<td></td><td></td><td></td> <td></td><td></td><td></td>
</tr> </tr>
<tr bgcolor="pink"> <tr bgcolor="pink">
- <td>Make the NeoOffice and RetroOffice 3.0 Early Access binaries downloadable from the <tt>www.neooffice.org</tt> website's 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>cvs update -Ad ; chmod -Rf ug+rw .htaccess *</tt>.</td>+ <td>Add "3.0 EA" as a version in [http://bugzilla.neooffice.org/ Bugzilla].</td>
<td></td><td></td><td></td> <td></td><td></td><td></td>
</tr> </tr>
<tr bgcolor="pink"> <tr bgcolor="pink">
- <td>On the <tt>neowiki.neooffice.org</tt> main page, replace all occurrences of <tt>2.2.5</tt> that are related to NeoOffice or RetroOffice with <tt>3.0 Early Access</tt>. Do not change any that are related to OpenOffice.org since there is no OpenOffice.org 3.0 Early Access release.</td>+ <td>Verify that all mirrors listed for the NeoOffice 3.0 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>cvs commit ; chmod -Rf ug+rw .[ch]* *</tt>.</td>
- <td></td><td>pluby</td><td></td>+ <td></td><td></td><td></td>
</tr> </tr>
<tr bgcolor="pink"> <tr bgcolor="pink">
- <td>On the [[NeoOffice_3.0 Early Access_New_Features]] page, remove any test patch text and links.</td>+ <td>Make the NeoOffice 3.0 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>cvs update -Ad ; chmod -Rf ug+rw .[ch]* *</tt>.</td>
<td></td><td></td><td></td> <td></td><td></td><td></td>
</tr> </tr>
<tr bgcolor="pink"> <tr bgcolor="pink">
- <td>Replace the [http://neowiki.neooffice.org/index.php/NeoOffice_MD5_Checksums NeoOffice 2.2.5 MD5 checksums] page with the NeoOffice 3.0 Early Access MD5 checksums and replace the [http://neowiki.neooffice.org/index.php/RetroOffice_MD5_Checksums RetroOffice 2.2.5 MD5 checksums] page with the RetroOffice 3.0 Early Access MD5 checksums.</td>+ <td>Append the [http://neowiki.neooffice.org/index.php/NeoOffice_MD5_Checksums NeoOffice MD5 checksums] page with the NeoOffice 3.0 Early Access MD5 checksums.</td>
<td></td><td></td><td></td> <td></td><td></td><td></td>
</tr> </tr>
Line 398: Line 411:
<tr bgcolor="pink"> <tr bgcolor="pink">
<td>Post a release announcement to the [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&t=4975 Trinity forum topic] so that the news is included in the RSS feed.</td> <td>Post a release announcement to the [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&t=4975 Trinity forum topic] so that the news is included in the RSS feed.</td>
- <td></td><td></td><td></td> 
- </tr> 
- 
- <tr bgcolor="pink"> 
- <td>Delete the 114 NeoOffice 2.2.5 <tt>NeoOffice-2.2.5-*.dmg</tt> files from the <tt>rsync.neooffice.org</tt> and <tt>www.planamesa.net</tt> servers' <tt>/neojava/downloads</tt> directory.</td> 
- <td></td><td></td><td></td> 
- </tr> 
- 
- <tr bgcolor="pink"> 
- <td>Delete the 114 RetroOffice 2.2.5 <tt>RetroOffice-2.2.5-*.dmg</tt> files from the <tt>www.planamesa.com</tt> and <tt>www.planamesa.net</tt> servers' <tt>/retro/downloads</tt> directory.</td> 
- <td></td><td></td><td></td> 
- </tr> 
- 
- <tr bgcolor="pink"> 
- <td>Delete the 2 obsolete NeoOffice 2.2.5 <tt>NeoOffice-2.2.5-Patch-*.dmg</tt> patch installer files from the <tt>rsync.neooffice.org</tt> server's <tt>/neojava/downloads</tt> directory.</td> 
- <td></td><td></td><td></td> 
- </tr> 
- 
- <tr bgcolor="pink"> 
- <td>Delete the 2 obsolete RetroOffice 2.2.5 <tt>RetroOffice-2.2.5-Patch-*.dmg</tt> patch installer files from the <tt>jane.neooffice.org</tt> server's <tt>/retro/downloads</tt> directory.</td> 
- <td></td><td></td><td></td> 
- </tr> 
- 
- <tr bgcolor="pink"> 
- <td>After the files have been deleted from the rsync server, wait 48 hours and verify that these files have been deleted from the mirrors listed in the <tt>www.neooffice.org</tt> website's <tt>/neojava/include/mirrors.php</tt> file. Contact any mirror maintainers that still have these files to confirm that they are rsynching to the rsync server regularly. 
- </td> 
- <td></td><td></td><td></td> 
- </tr> 
- 
- <tr bgcolor="pink"> 
- <td> 
- <p>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:</p> 
- <ul> 
- <li>Login to PayPal, click on the History tab, click on Download My History link, select Custom Date Range, enter the day before the start of the Early Access period as the "From" date and the current date as the "To" date, and "Comma Delimited - All Activity" as the "File Types to Download".</li> 
- <li>It will take some time for PayPal to prepare the file. Once the file is ready, download it and use <tt>sftp</tt> to copy it to the <tt>www.neooffice.org</tt> server. Note: be sure to delete your local copy.</li> 
- <li>Once the history file is on the <tt>www.neooffice.org</tt> server, login to the server, <tt>cd</tt> to the <tt>/donationsadmin</tt> directory, and execute the following command to import the history file: 
-<pre> 
-sh 
-./import_paypal_transaction_history.php /path/to/history/file 2>/path/to/error/file 
-</pre> 
- </li> 
- <li>Inspect the entries in the error file created in the previous command and verify that none of the rejected lines from the file are donor transactions.</li>  
- </ul> 
- </td> 
<td></td><td></td><td></td> <td></td><td></td><td></td>
</tr> </tr>
</table> </table>

Revision as of 21:43, 11 January 2009

This page is an attempt to document all of the tasks required to release NeoOffice 3.0 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, a new OpenOffice.org tag was used. 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.

TaskDate CompletedAssignedStatus

Verify that OpenOffice.org does not have a newer tag for version 3.0.x than the OOO300_m14 tag.

01/06/2009plubyDone

Verify that ooo-build does not have a newer tag than the OOO_BUILD_3_0_1 branch.

01/03/2009plubyDone

Verify that Novell's patched odf-converter does not have a newer version than 2.5-2 in Novell's odf-converter source repository.

01/06/2009plubyDone

Commit and test updated icon files in etc/package.

  • cd etc/package
  • Execute the following shell script:
    #!/bin/csh
    #
    # execute within etc/package directory
    
    setenv PKGDIR `pwd`
    
    pushd ~
    curl -C - -O http://homepage.mac.com/punto_mac/projects/neo/downloads/Akua_Final2008_Release.dmg
    popd
    
    setenv VOL `hdiutil mount ~/Akua_Final2008_Release.dmg | perl -ne 'if ( /(\/Volumes.*)$/ ) { print $1; }'`
    if ( "$VOL" != "" ) then
            mkdir "Akua Final2008 Release"
            pushd "$VOL"
            cp -rf * "$PKGDIR/Akua Final2008 Release"
            popd
            pushd "Akua Final2008 Release"
            find . -type f -name \.\* -print0 | xargs -0 -n 1 rm -f
            popd
    
            if ( -e AkuaIcons.zip ) then
                    rm AkuaIcons.zip
            endif
            zip -r AkuaIcons.zip "Akua Final2008 Release"
            hdiutil unmount "$VOL"
            rm -rf "Akua Final2008 Release"
    endif
    
  • Rebuild NeoOffice installers with new icon zip files and verify proper build.
  • Reinstall both builds and check that updated icons are available.
01/03/2009plubyDone

Rebuild all custom NeoOffice code using the existing NeoOffice 3.0 Early Access development builds. Perform a confirming checkout of the HEAD branch and set build to build with a new version and NeoOffice and RetroOffice trademarked product names.

This includes the following steps:

  • Do a cvs update -Ad 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.
  • Copy custom.neo.mk file to custom.mk so that the clean checkout will build with the trademarked product names.
  • In makefile, change the following macros to the respective values:

    PRODUCT_VERSION_FAMILY=3.0
    PRODUCT_VERSION=3.0 Early Access
    PREVIOUS_PRODUCT_VERSION=3.0 Early Access
    PRODUCT_DIR_VERSION=3.0_Early_Access
    PRODUCT_PATCH_VERSION=Patch 0
    PRODUCT_DIR_PATCH_VERSION=Patch-0
    NEO_TAG:=-rNeoOffice-3_0_Early_Access
    
  • Delete all build.neo_* files so that all custom NeoOffice and RetroOffice code will be rebuilt.
  • Commit makefile changes and invoke make all to rebuild all applicable code and installers.
01/03/2009plubyDone

Verify that none of the NeoOffice 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)
01/06/2009plubyDone

Verify that none of the NeoOffice PowerPC build's executables or libraries link to any X11 libraries.

Note: Use the same steps as used for the matching Intel task.

01/06/2009plubyDone

Tag the code in the HEAD branch with the NeoOffice-3_0_Early_Access tag using the following:

  • Do a cvs update -Ad 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.
  • Tag all files in your workspace by invoking cvs tag NeoOffice-3_0_Early_Access.
  • If there are any build errors, fix and commit them, retag the changed files by invoking cvs tag -F NeoOffice-3_0_Early_Access, and repeating the step.
01/06/2009plubyDone

Create releasable NeoOffice 3.0 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:

  • Do a cvs update -d -rNeoOffice-3_0_Early_Access 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.
  • Do a cvs update -Ad so that you can do bug fixing and release patches after you create your releasable build
  • Delete all build.neo_* and build.odf-converter* 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.
  • Invoke make all to create the releasable installer and language packs.
01/06/2009plubyDone

Create releasable NeoOffice 3.0 Early Access build for PowerPC.

Note: Use the same steps as used for the matching Intel task.

01/06/2009plubyDone

Create backup copy of releasable Intel binaries and upload them to staging server.

The following steps are the steps that I used to create my backup copy:

  • Create an empty NeoOffice-3.0_Early_Access directory outside of the workspace
  • Copy all 59 install/*.dmg files from your releasable build into the empty NeoOffice-3.0_Early_Access directory and chmod 444 *.dmg in that directory

sftp all 59 files up to staging server and chmod 444 *.dmg all of the files on the staging server.

Put the NeoOffice-3.0_Early_Access folder in a new empty directory and create a CD master NeoOffice-3.0_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_Early_Access.cdr

Create backup copy of releasable PowerPC binaries and upload them to staging server.

Note: Use the same steps as used for the matching Intel task.

Verify that the releasable installers and one or more language packs install and run on Intel for the following Mac OS X versions:

  • 10.4.11
  • 10.5.6

Verify that the releasable installers and one or more language packs install and run on PowerPC for the following Mac OS X versions:

  • 10.4.11
  • 10.5.6

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.

TaskDate CompletedAssignedStatus
Upload the 2 NeoOffice main installer NeoOffice-3.0_Early_Access-*.dmg files to the joe.neooffice.org server's /neojava/earlyaccessdownloads directory. 01/08/2009plubyDone
Copy the 2 NeoOffice main installer NeoOffice-3.0_Early_Access-*.dmg files from the joe.neooffice.org server's /neojava/earlyaccessdownloads directory to the /neojava/downloads directory on all of the mirrors listed in the joe.neooffice.org server's /neojava/includes/earlyaccessmirrors.php file. 01/08/2009plubyDone
Upload the 116 NeoOffice language pack installer NeoOffice-3.0_Early_Access-Language_Pack-*.dmg files to the joe.neooffice.org server's /neojava/downloads directory. 01/08/2009plubyDone
Copy the 116 NeoOffice language pack installer NeoOffice-3.0_Early_Access-Language_Pack-*.dmg files from the rsync.neooffice.org server's /neojava/downloads directory to the www.planamesa.net server's /neojava/downloads directory. 01/08/2009plubyDone

Website

TaskDate CompletedAssignedStatus
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: cvs tag NeoOffice-2_2_5 ; cvs update -d -rNeoOffice-2_2_5 ; chmod -Rf ug+rw .[ch]* * 01/09/2009plubyDone

Update all NeoOffice and version names, file URLs, and patch version names in all of the files in the www-test.neooffice.org server's neojava directory.

Note: I used the following steps to do this:

  • Manually edit the /neojava/includes/globals.php page and set the following variables to the following values and delete all but the zero'th element:
  • $earlyaccessdownloadenabled = true;
    $earlyaccessredirectenabled = false;
    $earlyaccessfreeproduct = 'NeoOffice 3.0';
    $earlyaccessproductversion = '3.0 Early Access';
    $earlyaccessproductfamily[0] = '';
    $earlyaccesspatch = 'Patch 0';
    
  • Manually edit all of the header.html pages in the /neojava directory and put the NeoOffice 3.0 Early Access announcement within the new banner's "if ($earlyaccessdownloadenabled)" section.
  • Manually edit all of the earlyaccess.php pages in the /neojava directory and add the previous Early Access Program to the list past Early Access Programs wherever they are listed.
  • Manually edit all of the earlyaccess.php pages in the /neojava directory and update the Early Access Program start and end dates wherever they are listed.
  • Manually edit all of the earlyaccessfeatures.php pages in the /neojava directory and add any new or missing features compared to the matching OpenOffice.org version.
  • Manually edit the /neojava/donations/config.php file and set the DONATIONSDOWNLOADCOOKIEKEY and DONATIONSDOWNLOADCOOKIEVALUE defines to values that have not been used in past Early Access Programs.
  • After you verify that the changes look correct, invoke the following command to commit your changes: cvs commit ; chmod -Rf ug+rw .[ch]* *
01/09/2009plubyDone
Update the 118 NeoOffice 3.0 Early Access file sizes in all of the /neojava/includes/globals/earlyaccesfilesizes.php file and if the changes look correct, invoke the following command to commit your changes: cvs commit ; chmod -Rf ug+rw .[ch]* * 01/09/2009plubyDone
Manually edit the mirror_htdocs CVS module's /neojava/earlyaccessdownloads/.htaccess<tt>, update any lines to match the changes made in the <tt>www_htdocs CVS module's /neojava/donations/config.php file, and if the changes look correct, invoke the following command to commit your changes: cvs commit ; chmod -Rf ug+rw .[ch]* *. 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: cvs commit ; chmod -Rf ug+rw .[ch]* * 01/09/2009plubyDone
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. 01/09/2009plubyDone

Obtain each localized version of the NeoOffice 3.0 Early Access press release in HTML format, save them in the www-test.neooffice.org website's /neojava/press_releases directory using the following naming format so that the webserver's language detection will serve the closest matching file, cvs add the files, and invoke the following command to commit your changes: cvs commit ; chmod -Rf ug+rw .htaccess *:

  • English - Save as two files: NeoOffice_2.2.5.html.en and NeoOffice_2.2.5.html.html
  • Other languages - Save using the format NeoOffice_2.2.5.html.<two-digit-language-code> replacing <two-digit-language-code> with the standard language code (e.g. de for German, fr for French, etc.

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, 15 January 2009 translates to in the afternoon on 14 January 2009 in California.

TaskDate CompletedAssignedStatus

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:

  • Login to PayPal, click on the History tab, click on Download My History link, select Custom Date Range, enter the day before the start of the Early Access period as the "From" date and the current date as the "To" date, and "Comma Delimited - All Activity" as the "File Types to Download".
  • It will take some time for PayPal to prepare the file. Once the file is ready, download it and use sftp to copy it to the www.neooffice.org server. Note: be sure to delete your local copy.
  • Once the history file is on the www.neooffice.org server, login to the server, cd to the /donationsadmin directory, and execute the following command to import the history file:
    sh
    ./import_paypal_transaction_history.php /path/to/history/file 2>/path/to/error/file
    
  • Inspect the entries in the error file created in the previous command and verify that none of the rejected lines from the file are donor transactions.
Add "3.0 EA" as a version in Bugzilla.
Verify that all mirrors listed for the NeoOffice 3.0 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: cvs commit ; chmod -Rf ug+rw .[ch]* *.
Make the NeoOffice 3.0 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: cvs update -Ad ; chmod -Rf ug+rw .[ch]* *.
Append the NeoOffice MD5 checksums page with the NeoOffice 3.0 Early Access MD5 checksums.

Close all bugs with a status of "Resolved" by setting the following field values:

  • Set "Status" field to "Closed"
  • Set "Resolution" field to "Fixed"
  • Set "Target Version" field to "3.0 EA"
  • Set "Closed in Version" field to "3.0 EA"

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:

  • Set "Status" field to "Closed"
  • Set "Resolution" field to "Fixed"
  • Set "Target Version" field to "3.0 EA"
  • Set "Closed in Version" field to "3.0 EA"
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.
Post a release announcement to the NeoJUpdate mailing list.
Post a release announcement to the Trinity forum topic so that the news is included in the RSS feed.
Personal tools