Portal Toolkit Installation Notes

This document is the main installation document for the PTK. It assumes the following things:

• You want to install the latest "released" version of the PTK from a tarball.
• See Installing PTK from CVS to install from a CVS checkout.

1. Download the snapshot

   Snapshots can be downloaded from the PTK page.

2. Unpack the snapshot

   To install a snapshot, extract it into a temporary directory. For instance:

         $ cd /tmp
         $ tar xzf ~/downloads/ZopePTK-x.x.x-src.tar.gz
   

   The tarball should produce a single directory, typically with the same name as the "stem" of the tarball's name, containing three subdirectories:

   • PTKBase
   • PTKDemo
   • ZCallable

   Copy or link the three product directories into your Products area, e.g.:

         $ cd /usr/local/Zope2/lib/python/Products
         $ mv /tmp/ZopePTK-x.x.x-src/PTKBase .
         $ mv /tmp/ZopePTK-x.x.x-src/PTKDemo .
         $ mv /tmp/ZopePTK-x.x.x-src/ZCallable .
   

3. Verify filesystem products

   Start or restart your Zope server. Check to see that the following products are present in the Control_Panel / Products list; each should show a "normal" (non-broken) icon, and should have a version number matching the release version of the snapshot:

   • PTKBase
   • PTKDemo
   • ZCallable

4. Prepare exported through-the-web products

   Copy or link the following two files from the Products/PTKDemo directory to the import directory of your Zope server:

   • Wizard.zexp
   • DemoPortal.zexp

   For instance:

         $ cd /usr/local/Zope2/import
         $ ln -s ../lib/python/Products/PTKDemo/Wizard.zexp .
         $ ln -s ../lib/python/Products/PTKDemo/DemoPortal.zexp .
   

5. Install through-the-web products

   In the Control_Panel / Products list, select the "Import/Export" tab. Import the following products:

   • Wizard.zexp
   • DemoPortal.zexp
   1. Create a portal

      From the management interface, somewhere in the "main" section of your site (not the Control_Panel!), select "Portal" from the add list. Fill out each page of the portal wizard, and click the "Finish" button.

• You are installing the PTK "from scratch", with no previous versions of the software to replace, and no existing portals or content to migrate.
  • See Upgrading PTK if you have previously installed an earlier verison of the PTK.
  • See Migrating Content from 0.7.1 if you need to migrate a portal and content from PTK v. 0.7.1.

Installation