Bug 698784 - Script "install.php" missing from DokuWiki; yet not clear how to get DokuWiki going?
Summary: Script "install.php" missing from DokuWiki; yet not clear how to get DokuWiki...
Keywords:
Status: CLOSED WONTFIX
Alias: None
Product: Fedora
Classification: Fedora
Component: dokuwiki
Version: 14
Hardware: i386
OS: Linux
unspecified
medium
Target Milestone: ---
Assignee: Andrew Colin Kissa
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2011-04-21 19:06 UTC by Daniel Berlin
Modified: 2012-08-16 12:08 UTC (History)
2 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2012-08-16 12:08:48 UTC
Type: ---


Attachments (Terms of Use)

Description Daniel Berlin 2011-04-21 19:06:57 UTC
Description of problem:

In general, a DokuWiki installation from scratch provides the script "install.php" which the user can call to do further adjustments to the DokuWiki installation (like switching on Access Control Lists, set the name of the superuser, set the title of the Wiki, among other things), most of which will end up in the file "local.php", which holds settings specific to the installation site at hand (like Wiki title etc).

However, the script "install.php" is not contained in the Fedora DokuWiki RPM.

This might be a mistake, or it might indicate that it was decided to drop "install.php" from the package and let instead some post installation script of the RPM do some of the work of "install.php".

But if so, it is not clear from the RPM description or from the files that come with the DokuWiki RPM which next step the user is expected to undertake after the installation of the DokuWiki RPM to finish setting up a working DokuWiki.

Is the user expected to set up the file "local.php" all manually?

A look at the file "local.php" after the installation of the DokuWiki RPM shows that the file doesn't contain any specific settings, so it seems no RPM post-installation script takes care of the settings that the script "install.php" would commonly take care of.


Version-Release number of selected component (if applicable):
Observed with DokuWiki RPM for Fedora 14.

How reproducible:
Standard RPM installation procedure (by yum, possibly with yumex).

Steps to Reproduce:
1. Check file list of DokuWiki RPM for "install.php".
2.
3.
  
Actual results:


Expected results:


Additional info:
* There's a short page regarding the Fedora DokuWiki RPM at the DokuWiki website: http://www.dokuwiki.org/install:fedora?s[]=fedora
* A thread in the FedoraForum is related to the bug report at hand: http://forums.fedoraforum.org/showthread.php?t=261529
* Also, a thread in the DokuWiki forum is related to the bug report at hand: http://forum.dokuwiki.org/post/24514

Comment 1 Daniel Berlin 2011-04-22 21:56:56 UTC
I compared the script /conf/dokuwiki.php from the original DokuWiki tgz at http://www.splitbrain.org/projects/dokuwiki with the /conf/dokuwiki.php created by the RPM / yum / yumex install of the package dokuwiki-0-0.7.20101107.a.fc14 and realized that the only difference is the definition of the data directory.

So I made up this workaround:
(Become root to do steps 03 to 09.)

01 _ Install package dokuwiki-0-0.7.20101107.a.fc14 (and possibly dokuwiki-selinux).
02 _ Download the original DokuWiki tgz at http://www.splitbrain.org/projects/dokuwiki.
03 _ Copy the script install.php from the tgz archive to /usr/share/dokuwiki
04 _ Symlink from /usr/share/dokuwiki/data to /var/lib/dokuwiki/data
05 _ Rename /usr/share/dokuwiki/conf/dokuwiki.php to dokuwiki.php.bak
06 _ Copy the original script /conf/dokuwiki.php from the tgz archive to /usr/share/dokuwiki/conf
07 _ Rename /usr/share/dokuwiki/conf/local.php to local.php.bak
08 _ Rename /usr/share/dokuwiki/conf/users.auth.php to user.auth.php.bak
09 _ Rename /usr/share/dokuwiki/conf/acl.auth.php to acl.auth.php.bak
10 _ Call /dokwiki/install.php on your http server.

The script install.php will guide the user through the setup process of DokuWiki and will arrange for a default DokuWiki user.

Comment 2 kalanzun 2011-11-12 11:15:04 UTC
You may just add an admin user by hand. I wrote some instructions in the dokuwiki wiki at http://www.dokuwiki.org/install:fedora

Prehaps the package should come with an admin user enabled by default. The users may the immediately access dokuwikis own admin tools to configure dokuwiki and to change the default password of the admin user.

Comment 3 Fedora End Of Life 2012-08-16 12:08:51 UTC
This message is a notice that Fedora 14 is now at end of life. Fedora 
has stopped maintaining and issuing updates for Fedora 14. It is 
Fedora's policy to close all bug reports from releases that are no 
longer maintained.  At this time, all open bugs with a Fedora 'version'
of '14' have been closed as WONTFIX.

(Please note: Our normal process is to give advanced warning of this 
occurring, but we forgot to do that. A thousand apologies.)

Package Maintainer: If you wish for this bug to remain open because you
plan to fix it in a currently maintained version, feel free to reopen 
this bug and simply change the 'version' to a later Fedora version.

Bug Reporter: Thank you for reporting this issue and we are sorry that 
we were unable to fix it before Fedora 14 reached end of life. If you 
would still like to see this bug fixed and are able to reproduce it 
against a later version of Fedora, you are encouraged to click on 
"Clone This Bug" (top right of this page) and open it against that 
version of Fedora.

Although we aim to fix as many bugs as possible during every release's 
lifetime, sometimes those efforts are overtaken by events.  Often a 
more recent Fedora release includes newer upstream software that fixes 
bugs or makes them obsolete.

The process we are following is described here: 
http://fedoraproject.org/wiki/BugZappers/HouseKeeping


Note You need to log in before you can comment on or make changes to this bug.