Adding Products to Buildout

Wiki Tools

This document outlines the steps taken to upgrade Bethel's products from Silva 2.0 to Silva 2.1 and place them in the buildout.

Prior to adding any products to the buildout

1. check out a copy of the trunk

2. update the version.txt file

   • determine if there is a difference between the current trunk and the last tag
   • if a difference exists, increment the version number by a point in version.txt

3. clean up the HISTORY.txt / changes.txt file

   • convert the file to the ReST format
4. commit the changes back to the trunk
5. create a branch from the trunk prior to upgrading
6. create a tag from the branch
7. check out the working copy of the trunk into buildout for upgrade work
8. update the version.txt file
9. record changes made to the product in the HISTORY.txt / changes.txt file
10. commit the changes to the trunk

Add The new products

1. Add products to the working configuration
2. Run the buildout script (bin/buildout) from the buildout directory

3. Add write permission to the products directory

   • When a new product is added the products directory is rebuilt
   • Permissions to write to files in the products directory is not given to the webadmin group by default
   • Write permission for the group will enable you to edit the product files as a member of the webadmin group
   • The zope user owns the files but does not have permission to run the emacs editor.
   • You can run vi as zope if you choose to edit with vi
   • command to run from the buildout directory:  chmod -R g+w products

Installing a New Silva Service Extension

1. Add the service to the zope Products directory
2. Start or restart the server instance
3. Open the ZMI.  Open the Silva Product
4. Click on the Services Tab of the Silva Product
5. Click on the service_extensions (Silva Product and Extension Configuration)product
6. The resulting service Extention dialog will show all of the Silva service extensions that have been installed.

Troubleshooting the process

ValueError:  README.txt

Occasionally when products are upgraded using svn in a particular directory you will receive a ValueError when trying to run a new buildout

• ValueError: New path have been added to the location: <buildout directory>/products/README.txt.

SVN Error - No Ancestry Information

Occasionally the products directory will be overwritten.  This can be caused by trying to correct the error above.  The error will show up when you are trying to commit changes for one of the products in the products directory (see ErrorMsg below).  When you get this error you will need to checkout your products directory again (see Solution below)  This will add the ancestry information (.svn file) back into the directory

• ErrorMsg:  svn: '.../products' has no ancestry information
• Solution:   svn co <repository>/buildout/silva/trunk/products products/

Now you should be able to run svn commit