NeoOffice 3.0.1 Release Tasks

Rebuild all custom NeoOffice code using the existing NeoOffice 3.0.1 Early Access 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:

• 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=3.0.1
  PRODUCT_DIR_VERSION=3.0.1
  PREVIOUS_PRODUCT_VERSION=$(PRODUCT_VERSION)
  PRODUCT_PATCH_VERSION=Patch 0
  PRODUCT_DIR_PATCH_VERSION=Patch-0
  NEO_TAG:=-rNeoOffice-3_0_1
  

• 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.

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

This includes the following steps:

• Do a cvs update -rNeoOffice-2_2_6_branch branch -d 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=2.2.6
  PRODUCT_DIR_VERSION=2.2.6
  PREVIOUS_PRODUCT_VERSION=$(PRODUCT_VERSION)
  X11_PRODUCT_VERSION=2.2.6
  X11_PRODUCT_DIR_VERSION=2.2.6
  X11_PREVIOUS_PRODUCT_VERSION=$(X11_PRODUCT_VERSION)
  PRODUCT_PATCH_VERSION=Patch 0
  PRODUCT_DIR_PATCH_VERSION=Patch-0
  X11_PRODUCT_PATCH_VERSION=Patch 0
  X11_PRODUCT_DIR_PATCH_VERSION=Patch-0
  NEO_TAG:=-rNeoOffice-2_2_6
  X11_NEO_TAG:=
  

• 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.

Verify that none of the NeoOffice 3.0.1 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)

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

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

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

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

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

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

Tag the code in the HEAD branch with the NeoOffice-3_0_1 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_1.
• If there are any build errors, fix and commit them, retag the changed files by invoking cvs tag -F NeoOffice-3_0_1, and repeating the step.

Tag the code in the NeoOffice-2_2_6_branch branch with the NeoOffice-2_2_6 tag using the following:

• Do a cvs update -rNeoOffice-2_2_6_branch -d 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-2_2_6.
• If there are any build errors, fix and commit them, retag the changed files by invoking cvs tag -F NeoOffice-2_2_6, and repeating the step.

Create releasable NeoOffice 3.0.1 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_1 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 the build.package file. This will force the installer and language packs to be rebuilt without causing any of the code to be rebuilt.
• Invoke make all to create the releasable installer and language packs.

Create releasable NeoOffice 3.0.1 build for PowerPC.

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

Create releasable NeoOffice 2.2.6 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 -rNeoOffice-2_2_6 -d 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 -rNeoOffice-2_2_6_branch -d so that you can do bug fixing and release patches after you create your releasable build
• Delete the build.package file. This will force the installer and language packs to be rebuilt without causing any of the code to be rebuilt.
• Invoke make all to create the releasable installer and language packs.

Create releasable NeoOffice 2.2.6 build for PowerPC.

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

Create backup copy of the NeoOffice 3.0.1 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.1 directory outside of the workspace
• Copy all 59 install/*.dmg files from your releasable build into the empty NeoOffice-3.0.1 directory and chmod 444 *.dmg in that directory

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

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

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

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

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

Create backup copy of the NeoOffice 2.2.6 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 NeoOffice 3.0.1 installers and one or more language packs install and run on Intel for the following Mac OS X versions:

• 10.4.11
• 10.5.8
• 10.6.1

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

• 10.4.11
• 10.5.8

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

• 10.4.11
• 10.5.8
• 10.6 developer seed build 10A432

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

• 10.3.9
• 10.4.11
• 10.5.8

Upload the 2 main installer NeoOffice-3.0.1-*.dmg files to the rsync.neooffice.org server's /neojava/earlyaccessdownloads directory using the following steps:

• Upload the files to your home directory on the server using the sftp command
• Use the md5 command to verify that the MD5 checksums of the source file and the uploaded file are the same
• Invoke cd ~ ; chmod 444 NeoOffice-3.0.1-*.dmg so that the files will be readable by all mirrors' webservers
• Move the file from your home directory to the server's /neojava/earlyaccessdownloads directory

Upload the 116 NeoOffice language pack installer NeoOffice-3.0.1-Language_Pack_*.dmg files to the rsync.neooffice.org server's /neojava/downloads directory using the following steps:

• Upload the files to your home directory on the server using the sftp command
• Use the md5 command to verify that the MD5 checksums of the source file and the uploaded file are the same
• Invoke cd ~ ; chmod 444 NeoOffice-3.0.1-Language_Pack_*.dmg so that the files will be readable by all mirrors' webservers
• Move the file from your home directory to the server's /neojava/downloads directory

Upload the 2 main installer NeoOffice-2.2.6-*.dmg files to the rsync.neooffice.org server's /neojava/earlyaccessdownloads directory using the following steps:

• Upload the files to your home directory on the server using the sftp command
• Use the md5 command to verify that the MD5 checksums of the source file and the uploaded file are the same
• Invoke cd ~ ; chmod 444 NeoOffice-2.2.6-*.dmg so that the files will be readable by all mirrors' webservers
• Move the file from your home directory to the server's /neojava/earlyaccessdownloads directory

Upload the 112 NeoOffice language pack installer NeoOffice-2.2.6-Language_Pack_*.dmg files to the rsync.neooffice.org server's /neojava/downloads directory using the following steps:

• Upload the files to your home directory on the server using the sftp command
• Use the md5 command to verify that the MD5 checksums of the source file and the uploaded file are the same
• Invoke cd ~ ; chmod 444 NeoOffice-2.2.6-Language_Pack_*.dmg so that the files will be readable by all mirrors' webservers
• Move the file from your home directory to the server's /neojava/downloads directory

Copy the 2 main installer NeoOffice-3.0.1-*.dmg files to the rsync.neooffice.org server's /neojava/downloads directory using the following steps:

• Copy the files to your home directory from the server's /neojava/earlyaccessdownloads directory
• Use the md5 command to verify that the MD5 checksums of the source file and the copied file are the same
• Invoke cd ~ ; chmod 444 NeoOffice-3.0.1-*.dmg so that the files will be readable by all mirrors' webservers
• Move the file from your home directory to the server's /neojava/downloads directory

Copy the 2 main installer NeoOffice-2.2.6-*.dmg files to the rsync.neooffice.org server's /neojava/downloads directory using the following steps:

• Copy the files to your home directory from the server's /neojava/earlyaccessdownloads directory
• Use the md5 command to verify that the MD5 checksums of the source file and the copied file are the same
• Invoke cd ~ ; chmod 444 NeoOffice-2.2.6-*.dmg so that the files will be readable by all mirrors' webservers
• Move the file from your home directory to the server's /neojava/downloads directory

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:

$earlyaccessdownloadenabled = true;
$earlyaccessredirectenabled = false;
$earlyaccessfreeproduct = 'NeoOffice 3.0.1';
$earlyaccessproductversion = '3.0.1';
$earlyaccessproductfamily[0] = '3.0.1 Early Access';
$earlyaccesspatch = '';
$oldearlyaccessproductversion = '2.2.6';
$oldearlyaccessproductfamily[0] = '2.2.6 Early Access';

• After you verify that the changes look correct, invoke the following command to commit your changes: sudo chmod -Rf ug+rw . ; cvs commit ; sudo chmod -Rf g-w,o-rwx .

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:

• 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 = false;
$earlyaccessredirectenabled = true;
$earlyaccessproductversion = '3.0.1 Early Access';
$earlyaccessproductfamily[0] = '';
$earlyaccesspatch = '';
$oldearlyaccessproductversion = '2.2.6 Early Access';
$oldearlyaccessproductfamily[0] = '';
$currentproductversion = '3.0.1';
$currentproductfamily[0] = '';
$currentpatch = '';
$oldproductversion = '2.2.6';
$oldproductfamily[0] = '';
$oldpatch = '';

• Manually edit all of the header.html pages in the /neojava directory and update the text in the news banner section.
• Manually edit all of the features.php and the oldfeatures.php pages in the /neojava directory and add any new features listed in the earlyaccessfeatures.php pages.
• Manually edit all of the index.php pages in the /neojava directory, comment out the existing text, and add new text and images to highlight the new NeoOffice Mobile feature.
• After you verify that the changes look correct, invoke the following command to commit your changes: sudo chmod -Rf ug+rw . ; cvs commit ; sudo chmod -Rf g-w,o-rwx .

Enable the BitTorrent links using the following steps:

• Delete and cvs remove all of the *.torrent files in the www-test-primary.neooffice.org website's /neojava/downloads directory.
• Obtain the 2 NeoOffice-3.0.1-*.torrent files and the 2 NeoOffice-2.2.6-*.torrent files from the mirrors.freesmug.org mirror maintainer and cvs add these 4 files in the www-test-primary.neooffice.org website's /neojava/downloads directory.
• After you verify the that changes look correct, invoke the following command to commit your changes: cvs commit ; chmod -Rf ug+rw .htaccess *

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.

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.1"
• Set "Closed in Version" field to "3.0.1"

Close any bugs with a status of "Assigned" or "Reopened" and resolution of "Fixed" by setting the following field values:

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

Create a new category in the donations database that has a start date and time that is a few hours before the planned release time to ensure that donors who donate after we make the NeoOffice 3.0.1 binaries downloadable get their donation credited to the next Early Access Program using the following steps:

• Login to the www.neooffice.org server, cd to the /neojava/donationsadmin directory, and execute the following command to add a new category:

  ./manage_categories.php -a
  

• Set the category_name to Next Planned NeoOffice Early Access Program Membership, the mc_gross_USD amount to the same amount that was used for the current NeoOffice 3.0.1 Early Access Program Membership category, the other mc_gross_* amounts to the exchange rate used by the trinity.neooffice.org website, start_date to 2009-10-26, end date to 2010-12-31, and enabled to 1
• Run the command again and set the category_name to Next Planned NeoOffice 3.x Early Access Program Subscription, the mc_gross_USD amount to the same amount that were used for the current NeoOffice 3.x Early Access Program Subscription category, the other mc_gross_* amounts to the exchange rate used by the trinity.neooffice.org website, start_date to 2009-10-26, end date to 2010-12-31, and enabled to 1

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 one year and one 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.