Installing CMF 1.2

Requirements

• Zope v. 2.3.3, 2.4.3 or 2.5 and later (not 2.4.2 or 2.4.1)
• Zope PageTemplates

Assumptions

• New installation
• Zope configured using INSTANCE_HOME, /var/zope, and SOFTWARE_HOME, /usr/local/zope/Zope-2.3.2

Procedure

1. Unpack the CMF-1.2.tar.gz tarball or CMF-1.2.zip file into a working directory. For instance:

           $ cd /usr/local/zope
           $ tar xzf /tmp/CMF-1.2.tar.gz
   

Note for Windows users: if you are using WinZip to unpack the file, be sure to disable the "TAR file smart CR/LF expansion" option (thanks to Frank McGeough for tracking down this problem!)

1. Link (or copy/move) the CMF packages into $INSTANCE_HOME/Products (or into $SOFTWARE_HOME/lib/python/Products). For instance:

           $ cd /var/zope/Products  # /var/zope is INSTANCE_HOME
           $ ln -s /usr/local/zope/CMF-1.2/CMFCore .
           $ ln -s /usr/local/zope/CMF-1.2/CMFDefault .
           $ ln -s /usr/local/zope/CMF-1.2/CMFTopic .
   

or, as a shortcut:

        $ ln -s /usr/local/zope/CMF-1.2/CMF* .

       Since linking doesn't apply on Windows, you will need
       to cut or copy the files from the place where you unpacked
       them to the 'Products' directory of your Zope.

    3. Restart Zope; verify that the CMF products loaded
       property, by examining them in Control_Panel/Product.

    4. Create a CMF Site object. join, and begin adding content.
       Enjoy!

    *Note:* --
          CMFDecor has been merged into CMFDefault, it is not longer and
          optional product. It requires that you have
          "Zope Page Templates", http://www.zope.org/Members/4am/ZPT
          installed.

Upgrading from CMF 1.1

Install the New Software.

1. Download the tarball.
2. Copy your "working" products off to one side (in case you need / choose to revert).
3. Unpack the tarball into a separate location; copy or link the subdirectories into the Products directory of your INSTANCE_HOME.
4. Restart Zope.
5. Note

   If your CMF instance was setup to use CMFDecor you will need to Create and run the external method Upgrade.py (upgrade_decor_skins) from the root of your CMF instance to upgrade your skin paths. This fixes breakage due to the merging of CMFDecor into CMFDefault.

Upgrading from CMF 1.0

Install the New Software.

1. Follow the procudures for upgrading from CMF 1.1

Create and Configure New tools

portal_metadata tool

1. From the ZMI of your CMFSite, select "CMFDefault Tool" from the Add list. Select "Default Metadata Tool" and click "Add".
2. Configure the "Elements" tab, particularly the "Subject" element (give it "suggested" subjects, perhaps by looking at the values on the search page).

portal_syndication

1. From the ZMI of your CMFSite, select "CMFDefault Tool" from the Add list. Select "Default Syndication Tool" and click "Add".
2. Use the "Properties" tab to enable syndication for the site (if desired), and then to configure the "sitewide" policies for outbound syndication. Once enabled, you will be able to toggle syndication and policies for individual folders as well.

Add New Content Type: Event

1. Build and run the installation ExternalMethod as described in CMFCalendar/INSTALL.txt.