This arcticle describes how to install the CMFBoard online bulletin board / forum Product for Plone on a Linux system. The examples assume that you have already installed Plone in the /opt/plone directory and created a Plone site named INSTANCE. See the article How to Build Plone from Source for more information on building and installing Plone on a Linux system.

A. download and install CMFBoard

1. Download the latest CMFBoard distribution from CMFBoard.org
2. cd into the Products directory of you Plone instance : cd /opt/plone/INSTANCE/Products
3. unzip and untar the distribution ... something like this : gunzip -c CMFBoard-2.1.3.tar.gz | tar xv

B. dependency on Portal Transport

CMFBoard requires PortalTransport to provide it's subscription service. You can find out more about PortalTransport here or via this Google search

If ProtalTransport is not in your Products directory, follow these intstruction to install it

1. Download the latest PortalTransPort distribution from Source Forge
2. cd into the Products directory of you Plone instance : cd /opt/plone/INSTANCE/Products
3. unzip and untar the distribution ... something like this : gunzip -c PortalTransport-1.1.tar.gz | tar xv

C. dependency on stripogram

PortalTransport requires stripogram to provide clean messages. You can find out more about stripogram here or via this Google search

If stripogram is not in your Products directory, follow these intstruction to install it

1. Download the latest stripogram distribution from Source Forge
2. cd into the Products directory of you Plone instance : cd /opt/plone/INSTANCE/Products
3. unzip and untar the distribution ... something like this : gunzip -c stripogram-1.4.tgz | tar xv

D. register new products with Plone/Zope

Now that CMFBoard and it's dependencies have been installed, you must register them with Plone.

1. If Plone is running, then you must stop it using one of the following (remember, you must be root to start/stop Plone) :
   1. If you originally started Plone using the zopectl command, then use :
      /opt/plone/INSTANCE/bin/zopectl stop
   2. If you originally started Plone using the runzope command, then do the following :
      ps -ef to find the PID of the Plone process
      kill -9 #### to terminate the Plone process ( #### is the PID of the Plone process).
   3. From the ZMI (Zope Management Interface), select Control_Panel and click on the Shutdown button.
2. start the Plone server
3. login as the site administrator
4. click on the plone setup button in the upper right of the home page to get to the Plone Configuration page.
5. click on the Add/Remove Products tool to get to the list of available products.
6. CMFBoard should appear in the Products Available for Install list. Check the box to the left of CMFBoard and then click on the install button at the bottom of the list.

You are now ready to configure CMFBoard for your application.