This question about Installation of Foswiki, Configuration, Using an extension: Answered

Classification plugin installation debian installation

After several unsuccessful try to add the ClassificationPlugin to an existing (old: 1.1.5) installation I decided to start from scratch and start with a completely new debian setup. This "question" describes the adventures on the way. I ended up with a working plugin, so this question answers itself. I hope others that run into issues will find something useful in this story.

For foswiki I used the debian packages at:
deb stable main contrib
deb-src stable main contrib
  • apt-get install apache2 OK
  • apt-get install foswiki
    • The installation reported an error: /var/lib/dpkg/info/foswiki.postinst: -bd: not found
    • the diagnosis was a missing /usr/bin/htpasswd. Fixed by:
  • apt-get install apache2-utils OK
    • in retrospect this was listed as a suggested package in foswiki. But suggested packages are not automatically installed.
  • apt-get install foswiki OK with all dependent plugins
  • apt-get install foswiki-classificationplugin OK
  • Add ServerName Localhost to the /etc/apache2/apache2.conf
    • the default apache page can now be accessed.
  • link /etc/foswiki/apache.conf
    • ln -s /etc/foswiki/apache.conf /etc/apache2/conf-available/foswiki.conf
  • configure using:
    • fix the following reported errors:
      1. warning the http host and alias don't match
      2. protection on /etc/foswiki (make owner www-data)
      3. Jquery version. was 1.4.3 set to 2.0.1 (default 1.8.3)
      4. {JQueryPlugin}{Plugins}{Themeswitcher}{Enabled} was ticked. set default (off)
      5. no errors left. warning 2 left. Of no consequence.
  • Access to Main/Webhome fails!!
    • Error in error log: " AH01630: client denied by server configuration: /var/lib/foswiki/bin/view"
    • fixed on irc (related to Apache 2.4 vs 2.2. Update /etc/foswiki/apache.conf
      • In the section for the /bin directory,
      • After Allow from all
      • Add Require all granted
    • Same issue for /pub. same resolution
  • Access to Main.WebHome now works
  • Enable the following plugins
    • {Plugins}{BreadCrumbsPlugin}{Enabled} 1
    • {Plugins}{ClassificationPlugin}{Enabled} 1
    • {Plugins}{DBCachePlugin}{Enabled} 1
    • {Plugins}{FilterPlugin}{Enabled} 1
    • {Plugins}{FlexFormPlugin}{Enabled} 1
    • {Plugins}{FlexWebListPlugin}{Enabled} 1
    • {Plugins}{JQGridPlugin}{Enabled} 1
    • {Plugins}{NatEditPlugin}{Enabled} 1
    • {Plugins}{RenderPlugin}{Enabled} 1
  • Starting the ClassificationPlugin gives:
    • Can't locate Textpath in @INC (you may need to install the Text::Unidecode module) (@INC contains: path path . path path path path path path path path)
    • use cpan to install Text::Unidecode

At this point the ClassificationPlugin appears to work and I can see the WebHome page of the installed Applications.ClassificationApp. I follow the instructions on the foswiki Extensions.ClassificationPlugin page. My notes are a bit jumbled. Below is a list of all the things I did to get going.

I installed and activated the following plugins to get buttons and grids that I recognised.
  • apt-get install foswiki-editchapterplugin
    • to get the pencil with the chapter headings on the WebHome page of the created Knowledge web
  • apt-get install JsonRpcContrib
  • apt-get install MoreFormfieldsContrib
  • cpan install JSON
    • the three items resolved issues I had in previous installations of the ClassificationPlugin. I am not sure if they made the difference this time.
  • apt-get install foswiki-reddotplugin
  • apt-get install foswiki-imageplugin
  • apt-get install foswiki-topicinteractionplugin
    • these three plugins then made the functionality under Recent Changes operational
  • Make sure you enable every plugin installed!

At this stage I have not installed solr, but I believe I have a working ClassificationPlugin installation. Here are my observations on the Getting started instructions.

  • create a new web called "Knowledge" using _ClassificationTemplate
    • works without a hitch
  • create new categories on the Knowledge.Category topic
    • This had me puzzled for a long time. The secret is:
      • Right Click on the Test category displayed in the filter box!
  • create new categorizable and taggable content.
    • I used the NEW button on this topic. I am unaware of another way to create topics.

In closing; missing plugins create issues with invisible fields, buttons and other stuff. If they are all there, you should be in business.

-- BramVanOosterhout - 22 Jun 2015


QuestionForm edit

Subject Installation of Foswiki, Configuration, Using an extension
Extension ClassificationPlugin
Version Foswiki 1.1.9
Status Answered
Related Topics
Topic revision: r1 - 22 Jun 2015, BramVanOosterhout
The copyright of the content on this website is held by the contributing authors, except where stated elsewhere. See Copyright Statement. Creative Commons License    Legal Imprint    Privacy Policy