Differences

This shows you the differences between two versions of the page.

--- install:gentoo [2014-06-04 12:57] – gentoo-wiki.com does not work anymore 2.235.201.237
+++ install:gentoo [2017-06-27 02:57] (current) – 50.4.233.35
@@ Line 1: / Line 1: @@
 ====== DokuWiki on Gentoo ======
+To install [[:DokuWiki]] on [[http://www.gentoo.org|Gentoo]]:
-To install [[:DokuWiki]] on [[http://www.gentoo.org|Gentoo]] include "xml" in your USE flags and do
+===== Prior Configs =====
+==== System Base ====
+First, be sure your system is up to date:
+  $> sudo emerge --sync
+As usual, be sure to follow any directions that come back from updating your system before you go on to the later parts of this outline.  It's also good practice to have your Gentoo system up to date, so if possible, do something like:
+  $> sudo emerge -auv @world
-  $> emerge --sync
+In this example, we assume you've got the ''equery'' command available.  It's not strictly necessary to run dokuwiki, but it is handy for this and lots of other situation.  It's part of the ''gentoolkit'' package; if you don't have that already:
-  $> emerge -a dokuwiki
+  $> sudo emerge -av gentoolkit
-This will install DokuWiki in ''/var/www/localhost/htdocs/dokuwiki''.
+Assuming that Apache is your web server, and already installed on your host, be sure that PHP is supported.  In:
+  /etc/conf.d/apache2
+...you should find PHP in the list of options supported; for instance:
+  APACHE2_OPTS="-D DEFAULT_VHOST -D INFO -D SSL -D SSL_DEFAULT_VHOST -D LANGUAGE -D PHP"
-When having //USE="vhosts"// set, use the webapp-config tool to install DokuWiki.
+We assume that you'll use the ''webapp-config'' process to control dokuwiki space on your server:
+  $> equery l webapp-config
+  * Searching for webapp-config ...
+  [IP-] [  ] app-admin/webapp-config-1.54-r1:0
+If it doesn't show up, go get it:
+  $> sudo emerge -av webapp-config
+==== DokuWiki package ====
+To use this example, ''vhosts'' will need to be recognized by your dokuwiki package.  In a new file:
+  /etc/portage/package.use/dokuwiki
+...be sure there's something like:
+  www-apps/dokuwiki vhosts
+===== Install =====
+Once that's ready, you can bring the package to your host.
+  $> sudo emerge -av dokuwiki
+To be sure that the ''vhosts'' option is in place, or to check for other options in the dokuwiki package, use ''equry u'':
+  $ equery u dokuwiki
+  [ Legend : U - final flag setting for installation]
+  [        : I - package is installed with flag     ]
+  [ Colors : set, unset                             ]
+   * Found these USE flags for www-apps/dokuwiki-20170219b:
+   U I
+   - - gd     : Add support for media-libs/gd (to generate graphics on the fly)
+   + + vhosts : Add support for installing web-based applications into a
+              virtual-hosting environment
+If you don't like what you see there -- for instance, if the ''vhosts'' setting shows up "-" instead of "+" and you want to keep following the instructions here -- find and fix any changes necessary, and build the ''dokuwiki'' package again.
+To use the ''webapp-config'' command, be sure you know the version you're using; equery can tell us that too.  As of 26 June 2017, we find version ''20170219b'':
+  $> equery l dokuwiki
+  * Searching for dokuwiki ...
+  [IP-] [  ] www-apps/dokuwiki-20170219b:20170219b
+Here, our ''webapp-config'' tool will only answer commands from root (which is probably a good thing):
   $> webapp-config --version
-.50.16
+  bash: webapp-config: command not found
+  $> sudo webapp-config --version
+.54
+To use ''webapp-config'' to install DokuWiki, version ''20170219b'', in a server named ''<host>'', in ''/var/www/<host>/htdocs/dokuwiki/''((If you don't want a virtual service, or you don't need your DokuWiki to appear on the network at all, "host" can just be "localhost".)):
-  $> webapp-config -I -h localhost -d /dokuwiki dokuwiki 20091225c
+  $> sudo webapp-config -h <host> -d dokuwiki -I dokuwiki 20170219b
   *   Creating required directories
   *   Linking in required files
   *     This can take several minutes for larger apps
   *   Files and directories installed
+  [...]
+If all goes well, that should be followed by "POST-INSTALL INSTRUCTIONS".  Read well!  In particular, follow the part about copying ''local.php.dist'' into ''local.php'', and adjust it to suit your needs.  Then... carry on!
-You should not forget to set up Apache (the web server) to support PHP.