DebianPackage

Packaging for Debian .deb / apt distribution

Authored by SvenDowideit. Originated on http://twiki.org/cgi-bin/view/Codev/TWikiOnDebian and http://twiki.org/cgi-bin/view/Codev/TWikiOnDebianPlugins

foswiki is installed into /var/lib/foswiki with the configuration files (including apache.conf) installed into /etc/foswiki, and the cgi scripts at /var/lib/foswiki/bin. (before 1.0.7, they were in /usr/lib/cgi-bin/foswiki)

Because the apt package system is more capable than the Foswiki configure based Extension installer, you should always use apt-get, not the web interface, which is likely to break the package. apt will automatically install and configure foswiki, Extensions and their dependencies - making it trivial to install and maintain.

How to install (you must be root)

Install from Sven's fosiki foswiki debian repository with foswiki v1.0.9 and 200+ autobuilt extensions from Extensions.WebHome. (see http://fosiki.com/Foswiki_debian/FoswikiPackagesList.txt for a complete list)

To try it out, add the following to your /etc/apt/sources.list

(Note the spelling of the domain! fosiki not foswiki !)

deb http://fosiki.com/Foswiki_debian/ stable main contrib
deb-src http://fosiki.com/Foswiki_debian/ stable main contrib

and then run

apt-get update
apt-get install apache2 foswiki

Note that you will get a warning that the foswiki package cannot be authenticated. You can reply y to this warning.

To see what foswiki extensions are available, run

apt-cache search foswiki

you should see over 200 (as of July 2009)

The package building script requires an Extension is packaged and uploaded using BuildContrib, and that the DEPENDENCIES is defined correctly and runs once a day, downloading from foswiki.org and then building newly uploaded Extensions.

The source for the foswiki core package is maintained in foswiki svn, while the Extension builder is currently an unreleased work that Sven is re-writing as CPAN modules.

Note that these packages are not official Debian packages, so bug reports shouldn't be filed to the Debian bugtracker. To know the status of the eventual integration of foswiki into Debian's official archive, see http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=509864

See also : DebianPackagingTaskTeam

Installation notes

• The debian packages use a different installation structure than would be expected with a conventional Foswiki installation
  • Foswiki is installed into the /var/lib/foswiki/ directory
  • Foswiki CGI scripts are installed into /var/lib/foswiki/bin (prior to 1.0.7, they were in /usr/lib/cgi-bin/foswiki)
  • Logs are written to the /var/log/foswiki directory
  • The Foswiki configuration file LocalSIte.cfg is installed into the /etc/foswiki/ directory, as is the Apache configuration for Foswiki
  • URL's are the standard /foswiki/bin/view/ (but they were different in the past with the use of /cgi-bin/foswiki/view/ url
• External dependencies such as htmldoc (for GenPDFAddOn) or GraphViz (for DirectedGraphPlugin - Tasks.Item1202) are automatically resolved unless they can't be automatically detected from the package's DEPENDENCIES file, and a present in debian stable. If they are not detected automatically, but there is a relevant debian package, raise a task for that contrib mentioning that you found the issue when using the debs. (basically, its either a difficult to detect dependency, or is missing or wrong in the Foswiki Extension)
• If you are updatingfrom e.g. Foswiki 1.0.0. The apt-get routine will ask you to change the files apache.conf and LocalSite.cfg . Accept the change, otherwise the update will not run correctly. If you, for whatever reason do not accept the change, you can later extract the files using the dpkg command and copy them by hand into the /etc/foswiki directory. Note that you will have to re-set the password and some of the configure settings if you do this.

---

*Standard Component template bellow

Active Items

Id	Summary	Priority	Current State	Creation Date	Last Edit
Item8299 DebianPackage	Separate default configurations from the Foswiki binaries and topics distro:e40acada53cd Rev 6021 not found distro:6202af6bb11f distro:01c66e383f0d distro:bcc55337c63f distro:99705279094b distro:55240bbe54dc distro:740039c91918 distro:b6f97ee987dc distro:c8a6c118b783 distro:30a57ab1bb91 Rev 6685 not found distro:c905516be4a9 distro:cd37204ac6cd distro:fe9654019f33 distro:1454ae233a1d distro:23294e399007 distro:e68cd37b681c distro:204b8381c7d9 distro:43cf7031de32 distro:610a6266c2e4 distro:1bffd4c594ad distro:3f19eed1ec30 Rev 6711 not found distro:669e85bb52ce distro:f1861c8624ee distro:6d8c656af30d	Enhancement	Being Worked On DrakeDiedrich	07 Oct 2009 - 03:04	06 Mar 2010 - 01:30
Item2658 DebianPackage	2 improvments to debian upgrading distro:32eb9a9ca672	Normal	Being Worked On DrakeDiedrich	18 Jan 2010 - 22:08	10 Mar 2010 - 14:58
Item1563 DebianPackage	DebianPackage should set up {PermittedRedirectHostUrls} synomyms distro:1c2326a01706	Normal	Being Worked On SvenDowideit	04 May 2009 - 01:01	18 Mar 2010 - 19:19
Item8726 MailInContrib, DebianPackage	MailInContrib missing dependencies - debian	Normal	New	18 Mar 2010 - 19:38	18 Mar 2010 - 19:38
Item1661 DebianPackage	RenderListPlugin: wrong default module path	Normal	New	24 May 2009 - 16:43	29 Jun 2010 - 17:35
Item2517 DebianPackage, KinoSearchContrib	KinoSearchContrib missing dependencies under Debian 5.0.3	Urgent	Confirmed	21 Dec 2009 - 08:16	18 Jul 2010 - 16:31
Item9479 DebianPackage	Error during foswiki-twistyplugin instalation	Normal	New 1.0.9	17 Aug 2010 - 02:12	17 Aug 2010 - 02:12
Item9599 DebianPackage	trunk deb autobuild broken distro:a6673ddb4edc distro:ecf7a14f81f9 distro:600d3a060859 distro:3c2d6e29477b	Enhancement	New	01 Sep 2010 - 11:02	01 Sep 2010 - 11:02
Item9299 DebianPackage	Foswiki.pm unable to read LocalSite.cfg on new Ubuntu install	Normal	New	10 Jul 2010 - 13:27	01 Sep 2010 - 11:28
Item9600 DebianPackage	Debian package cleanup distro:68a33bb1e06c distro:67cad1780835	Enhancement	New DrakeDiedrich	01 Sep 2010 - 11:56	01 Sep 2010 - 11:56
Item9912 DebianPackage	foswiki-fastcgienginecontrib depends on non-existant libposix-strptime-perl	Urgent	New n/a	27 Oct 2010 - 20:50	10 Nov 2010 - 10:25
Item9989 DebianPackage	Repository for perl package not available for Chart Plugin	Normal	New SvenDowideit n/a	10 Nov 2010 - 11:26	10 Nov 2010 - 11:26
Item10787 DebianPackage, foswiki-kinosearchcontrib	Extension Kinosearch for Foswiki 1.1.3-2 not installable on Ubuntu 10.04 LTS	Normal	New n/a	25 May 2011 - 11:13	25 May 2011 - 11:13
Item8869 DebianPackage	foswiki-topdfplugin cannot be installed, broken package	Normal	New n/a	09 Apr 2010 - 14:38	26 Jan 2012 - 01:56
Item10735 DebianPackage	Foswiki 1.1.3: several clashes with other debian packages distro:9076f0acfc94	Urgent	Confirmed SvenDowideit n/a	11 May 2011 - 09:30	14 Mar 2012 - 02:24
Item11849 DebianPackage	Foswiki-tableplugin installation reports it's already on foswiki base package	Enhancement	New n/a	10 May 2012 - 14:10	10 May 2012 - 14:10
Item8469 DebianPackage	missing dependency: foswiki-actiontrackerplugin needs libtime-modules-perl	Low	New n/a	05 Feb 2010 - 00:36	25 Oct 2012 - 22:35
Item12191 DebianPackage	Missing dependencies in Fosiki Foswiki Debian packages	Normal	New n/a	25 Oct 2012 - 08:21	25 Oct 2012 - 22:56
Item12265 DebianPackage	LocalSite.cfg / debian installer	Normal	Confirmed n/a	25 Nov 2012 - 21:52	31 May 2014 - 03:42
Item12208 DebianPackage	debian packages have root.root as owner for the files instead of www-data.www-data which gives then warnings because of insufficient privileges in configure script	Urgent	Confirmed n/a	31 Oct 2012 - 15:53	16 Nov 2014 - 15:57
Item13002 DebianPackage, ClassificationPlugin	add debian packaging support ClassificationPlugin:f3ba5d4bc022	Enhancement	Confirmed n/a	28 Aug 2014 - 09:36	24 Dec 2014 - 03:18
Item12219 DebianPackage	bundled extensions should be pulled in via "Depends" instead of packaged and added to "Provides" in debian package	Normal	Confirmed n/a	02 Nov 2012 - 13:48	04 Jan 2015 - 22:18
Item8591 DebianPackage	Debian package wrong delimiter used in PermittedRedirectHostUrls	Normal	Confirmed n/a	21 Feb 2010 - 14:04	06 Jan 2015 - 04:08
Item9252 DebianPackage	Debian installers do not support ARM based devices	Enhancement	Confirmed SvenDowideit n/a	02 Jul 2010 - 21:45	08 Jan 2015 - 04:30
Item10954 DebianPackage	Debian extension packages installed with wrong permissions	Urgent	Confirmed n/a	08 Jul 2011 - 16:42	10 Jan 2015 - 15:11
Item13265 DebianPackage	Installation on Ubuntu 14.04 fails, reports " -bd: not found" due to missing dependency apache2-utils	Normal	Confirmed n/a	18 Feb 2015 - 15:43	18 Feb 2015 - 15:43
Item13095 DebianPackage	Debian packages incompatible with apache 2.4	Urgent	Confirmed n/a	16 Nov 2014 - 16:01	03 Jun 2015 - 10:23
Item1610 DebianPackage	DebianPackage of FormQueryPlugin depends on libtime-modules-perl	Normal	Needs Developer n/a	10 May 2009 - 15:08	20 Jun 2015 - 08:25
Item13046 DebianPackage	missing local perl path in debian packages	Low	Needs Developer n/a	05 Oct 2014 - 18:07	11 Oct 2015 - 00:39
Item12834 DebianPackage	Debian package foswiki-ldapcontrib now depends on DB_File::Lock (libdb-file-lock-perl)	Urgent	Needs Developer n/a	31 Mar 2014 - 13:50	02 Nov 2015 - 07:57
Item13426 DebianPackage, RpmPackage	RPM packages have dependency loop with epel	Normal	Needs Developer n/a	22 May 2015 - 13:54	26 Sep 2016 - 15:30
Item13443 DebianPackage	Bug and misconfiguration during upgrade from Debian 7.x to Debian 8.x (jessie) with foswiki debian package	Enhancement	Needs Developer n/a	03 Jun 2015 - 11:03	26 Sep 2016 - 20:50
Item13263 DebianPackage	[Discussion] new strategy for the perl dependencies with the automatic debian package builder	Enhancement	Needs Developer n/a	17 Feb 2015 - 20:14	25 Mar 2017 - 20:53
Item2090 DebianPackage, GenPDFAddOn	GenPDFAddon not correctly installed using apt-get.	Normal	Needs Developer n/a	17 Sep 2009 - 19:43	31 Mar 2017 - 03:24
Item2527 ModPerlEngineContrib, DebianPackage	troubles getting ModPerlEngineContrib running from debian repository	Normal	Needs Developer n/a	24 Dec 2009 - 09:26	01 May 2017 - 03:34
Item1492 HolidayListPlugin, DebianPackage	Strange dependency list in Debian package for HolidayListPlugin	Normal	Needs Developer n/a	22 Apr 2009 - 14:56	12 Dec 2017 - 16:28
Item8311 DebianPackage	Configuration warnings and management in Debian packages	Enhancement	Needs Developer DrakeDiedrich n/a	23 Oct 2009 - 23:50	12 Dec 2017 - 16:36
Item8023 DebianPackage	Debian installer is not up to date, and not maintainable by hand. distro:28a723dd3d64 distro:40411550455a distro:0c91b9cf4f5d distro:658a0f84db28 distro:ecb3c6dadc12 distro:56d7e0eb2297 distro:a1ddf25e5b88 distro:953f86b8fbd0 distro:829497ec07df distro:e9108e9933e7 distro:509eae60cf9c distro:7289a4632d76 distro:704257874ce9	Urgent	Needs Developer DrakeDiedrich n/a	03 Dec 2008 - 19:48	12 Dec 2017 - 16:36
Item14587 DebianPackage	Debian package links dead	Urgent	Needs Developer n/a	22 Dec 2017 - 03:23	22 Dec 2017 - 07:18
Summary			Being Worked On DrakeDiedrich: 2 Being Worked On SvenDowideit: 1 Confirmed: 1 Confirmed n/a: 8 Confirmed SvenDowideit n/a: 1 Confirmed SvenDowideit n/a: 1 Needs Developer n/a: 10 Needs Developer DrakeDiedrich n/a: 2 New: 4 New 1.0.9: 1 New n/a: 6 New DrakeDiedrich: 1 New SvenDowideit n/a: 1	01 Sep 2010 - 11:02: 1 01 Sep 2010 - 11:56: 1 02 Jul 2010 - 21:45: 1 02 Nov 2012 - 13:48: 1 03 Dec 2008 - 19:48: 1 03 Jun 2015 - 11:03: 1 04 May 2009 - 01:01: 1 05 Feb 2010 - 00:36: 1 05 Oct 2014 - 18:07: 1 07 Oct 2009 - 03:04: 1 08 Jul 2011 - 16:42: 1 09 Apr 2010 - 14:38: 1 10 Jul 2010 - 13:27: 1 10 May 2009 - 15:08: 1 10 May 2012 - 14:10: 1 10 Nov 2010 - 11:26: 1 11 May 2011 - 09:30: 1 16 Nov 2014 - 16:01: 1 17 Aug 2010 - 02:12: 1 17 Feb 2015 - 20:14: 1 17 Sep 2009 - 19:43: 1 18 Feb 2015 - 15:43: 1 18 Jan 2010 - 22:08: 1 18 Mar 2010 - 19:38: 1 21 Dec 2009 - 08:16: 1 21 Feb 2010 - 14:04: 1 22 Apr 2009 - 14:56: 1 22 Dec 2017 - 03:23: 1 22 May 2015 - 13:54: 1 23 Oct 2009 - 23:50: 1 24 Dec 2009 - 09:26: 1 24 May 2009 - 16:43: 1 25 May 2011 - 11:13: 1 25 Nov 2012 - 21:52: 1 25 Oct 2012 - 08:21: 1 27 Oct 2010 - 20:50: 1 28 Aug 2014 - 09:36: 1 31 Mar 2014 - 13:50: 1 31 Oct 2012 - 15:53: 1

See also: Support.DebianPackage, Extensions.DebianPackage, Development.DebianPackage

---

See also : DebianPackagingTaskTeam -- OlivierBerger - 09 Jan 2009

---

other technical details

if you want to use a robots.txt file, it would go into the /var/www directory - its outside of the scope of the foswiki package, as it affects the entire apache system, not just foswiki.