差分
このページの2つのバージョン間の差分を表示します。
両方とも前のリビジョン前のリビジョン次のリビジョン | 前のリビジョン | ||
wiki:install [2005/11/29 12:16] – osamu | wiki:install [2013/08/06 16:22] (現在) – 削除 osamu | ||
---|---|---|---|
行 1: | 行 1: | ||
- | ====== インストール ======= | ||
- | [[doku> | ||
- | |||
- | **ステップ1: | ||
- | |||
- | **ステップ2: | ||
- | |||
- | 基本のインストール作業の直後の**箱から出したまま**の状態のDokuWikiは次のような動作をします。 | ||
- | * そのままではまだ動きません。 " | ||
- | * この他のディレクトリでも同様の問題が起こります。 " | ||
- | * アクセスコントロール機能が動いていません([[config# | ||
- | * 誰でもページを読め、編集でき、作成できる状態になっています([[acl# | ||
- | * FIXME (上記の『ディレクトリやファイルがない』という問題は将来の新しいバージョンでは修正したいと思っています。提案:必要な空のファイルとディレクトリをあらかじめアーカイブファイルの中に入れておく。可能か?あるいは、スペース1つだけが入ったファイルを入れる? | ||
- | |||
- | |||
- | ===== Linux/ | ||
- | これは企業内サーバーなどroot権限を持っているサーバーにDokuWikiをインストールする場合など、もっとも通常の方法です。 | ||
- | |||
- | * Apache(Webサーバー)とPHPがインストールされていることを確認してください(たいていのGNU/ | ||
- | * Webサーバーのドキュメントルートの下のどこかにDokuWikiのtarボールファイルを展開します。例: | ||
- | |||
- | #> cd /var/www/ | ||
- | #> tar -xzvf / | ||
- | |||
- | * できたディレクトリを好きな名前に変えます | ||
- | |||
- | #> mv dokuwiki-YYYY-MM-DD dokuwiki | ||
- | |||
- | * 空のログファイルを作ります | ||
- | |||
- | #> touch dokuwiki/ | ||
- | |||
- | * アクセスコントロール(ACL)機能を使いたい場合は、If you're going to be using the access control (ACL) features, you need to create the users.auth.php and acl.auth.php files (just a user, TL) | ||
- | |||
- | #> cp dokuwiki/ | ||
- | #> cp dokuwiki/ | ||
- | |||
- | * Set up the correct permissions | ||
- | * Usually the webserver runs as a unprivileged user eg '' | ||
- | * The webserver needs to be able to write to some files and directories (so change the chown nobody to match your configuration e.g. chown apache ...) | ||
- | * If you're using access control, you need to change the group ownership permissions on the appropriate files and make them writeable by the web server user's group (use group ownership, because as a user/web site admin, you'll need to edit the files directly) - otherwise, users won't be able to register, and you won't be able to set ACL controls via the web interface, and you'll get error messages; I always forget these steps when I do an install using ACL features, so that's why I'm adding them here. | ||
- | * The group name the web server runs as is usually identical to the user name, except in the case of the " | ||
- | |||
- | #> chgrp nogroup dokuwiki/ | ||
- | #> chgrp nogroup dokuwiki/ | ||
- | |||
- | #> chown -R nobody dokuwiki/ | ||
- | |||
- | * edit '' | ||
- | * finally, test if everything is set up correctly. Use the '' | ||
- | |||
- | * if you're using the access control features, you'll need to set yourself up as an administrative user (either add your user account to the appropriate entry in the dokuwiki.php or local.php file, or put your account in the admin group you specified in these files), in order for the " | ||
- | |||
- | === Notes === | ||
- | |||
- | * Occasionally chowning can be no good at all, I couldn' | ||
- | * The options specified in .htaccess can sometimes cause an error. It gave me an ' | ||
- | |||
- | ===== Debian GNU/Linux, Ubuntu Linux ===== | ||
- | |||
- | Official [[debianpackage|Debian Packages]], provided by [[mpo@iki.fi|Matti Pöllä]], can be fetched with apt from the testing and unstable sections. | ||
- | |||
- | On Ubuntu, Dokuwiki is avaliable from the " | ||
- | |||
- | To install DokuWiki, use the standard [[http:// | ||
- | |||
- | #> apt-get update | ||
- | #> apt-get install dokuwiki | ||
- | |||
- | The package is unpacked, debconf asks a few questions, and it is set up. You can then invoke dokuwiki through your browser. For example, if you said the web-accessible location should be /dokuwiki, and access should be by localhost only, %%http:// | ||
- | |||
- | Use the Debian bug tracking system to report any bugs with the package [[http:// | ||
- | |||
- | ===== FreeBSD ===== | ||
- | |||
- | To install dokuwiki using the FreeBSD ports tree, do the following: | ||
- | |||
- | #> cd / | ||
- | #> make install clean | ||
- | |||
- | The default DokuWiki directory is ''/ | ||
- | |||
- | To upgrade using the ports tree, do: | ||
- | |||
- | #> portupgrade dokuwiki | ||
- | |||
- | Make sure that the ports tree has been updated, or this will have no effect. | ||
- | |||
- | ===== Mac OS X and Apache ===== | ||
- | |||
- | See the detailed [[http:// | ||
- | |||
- | The HOWTO does not appear to be up-to-date (though it was helpful). | ||
- | |||
- | Below is what I did for Tiger (no previous DokuWiki installed): | ||
- | |||
- | - [[http:// | ||
- | - [[http:// | ||
- | - From the command line:< | ||
- | $ cd ~/Desktop && tar -zxvf dokuwiki-2005-07-13.tgz | ||
- | $ mv dokuwiki-2005-07-13 ~/ | ||
- | $ cd ~/ | ||
- | $ touch data/ | ||
- | $ sudo chown -R www data</ | ||
- | - If you want autorization (change useacl in conf/ | ||
- | $ cp conf/ | ||
- | $ sudo chown www conf/ | ||
- | $ cp conf/ | ||
- | $ sudo chown www conf/ | ||
- | - Important: set <code php> | ||
- | |||
- | ## in 10.4.3 client running the built in apache, but with site at / | ||
- | |||
- | ===== Windows ===== | ||
- | |||
- | ==== With Apache ==== | ||
- | |||
- | This is for people who want to use DokuWiki on their Desktop-Machine | ||
- | |||
- | * Make sure you have Apache and PHP installed ((The easiest way to do this is using an installer package like [[http:// | ||
- | * Unpack the tarball using a tool like [[http:// | ||
- | * move the '' | ||
- | * in the '' | ||
- | * edit the '' | ||
- | * Your new Wiki should be available at %%http:// | ||
- | |||
- | Sometimes, you might require to create a attic/ directory under data dir. Thanks to oak to help me out with this. | ||
- | |||
- | > In the last version (2005-07-01) you have to create those directories too : data/cache, data/meta, data/ | ||
- | |||
- | ==== With IIS ==== | ||
- | |||
- | This is for people who want to use DokuWiki on a Windows machine with IIS webserver (Windows 2000, Windows XP or Windows Server 2003) | ||
- | |||
- | * Make sure you have PHP installed. See the [[http:// | ||
- | * Unzip the DokuWiki archive using a tool like [[http:// | ||
- | * Rename the '' | ||
- | * somewhere below your new webserver documentroot, | ||
- | * any other location on your machine, and make sure to setup a Virtual Directory mapping to that location | ||
- | * In the '' | ||
- | * Edit the '' | ||
- | * Your new Wiki should be available at %%http:// | ||
- | |||
- | \\ | ||
- | |||
- | === File Extraction === | ||
- | |||
- | Windows-Users may need to rename the file from '' | ||
- | |||
- | The windows file extension is now .tar - however renaming it and using winzip works just fine. | ||
- | |||
- | **Extraction Programs:** | ||
- | |||
- | * Windows zipping and compression program, [[http:// | ||
- | * Opensource file archiver, [[http:// | ||
- | * For Windows and other platforms, [[http:// | ||
- | * Use the amazing [[http:// | ||
- | |||
- | |||
- | ===== NanoWeb Web Server ===== | ||
- | |||
- | [[http:// | ||
- | |||
- | However, after following the instructions as described above for use with the [[http:// | ||
- | |||
- | Autodetection of an URL is not possible in all thinkable environments. Especially not when extensive URL rewriting and other forwarding mechnisms are in use. Furthermore the word " | ||
- | |||
- | Change the line: | ||
- | $conf[' | ||
- | to something like: | ||
- | $conf[' | ||
- | Note that, for whatever reason, //a trailing slash is **required**!!// | ||
- | |||
- | ===== Hosted Server with FTP access ===== | ||
- | |||
- | **This applies to most users of rented webspace**. | ||
- | |||
- | A [[wiki: | ||
- | |||
- | * Extract the tarball somewhere on your local host ((Windows-Users can use a tool like [[http:// | ||
- | * in the '' | ||
- | * Windows-Users: | ||
- | * edit the '' | ||
- | * Now upload everything inside the '' | ||
- | * Depending on how your provider configured your FTP-Access DokuWiki may work already -- to check it use the '' | ||
- | * If you had any red warnings you need to change some permissions using your FTP program | ||
- | * The option to do so is mostly called '' | ||
- | * The simplest thing is to change the permissions to '' | ||
- | * :!: You may want to try the permissions of '' | ||
- | |||
- | |||
- | ===== Development Versions ===== | ||
- | |||
- | You can also check out the newest development version using [[darcs]]. | ||
- | |||
- | |||
- | ====== Upgrading ====== | ||
- | |||
- | Before upgrading, you should always read the [[changes|changelog]] to see if something changed you should be aware of when upgrading. To determine the version you are running, have a look in the HTML source of a Page generated by DokuWiki there should be something like ''< | ||
- | |||
- | > Some reminders! | ||
- | |||
- | The easiest way to upgrade is perform the following steps | ||
- | * Move your old installation to a backup directory | ||
- | * Install the new Version as described above | ||
- | * Copy your '' | ||
- | * As of 2005-07-01, ... | ||
- | * ... '' | ||
- | * ... the user-created content that was in the '' | ||
- | * ... the '' | ||
- | * Copy your old '' | ||
- | * If you had originally edited .htaccess in the root directory for dokuwiki to have "nice URLs", you should replace the overwritten file from the prior installation. | ||
- | * Copy your '' | ||
- | * These are new files for version 2005-07-13, so you'll have to copy the contents of '' | ||
- | * Try the doku.php? | ||
- | * Changelog is not writable | ||
- | * Datadir is not writable | ||
- | * This was because the data/pages/ directory was new for 2005-07-01 | ||
- | * Attic is not writable | ||
- | * Mediadir is not writable | ||
- | * Cachedir is not writable | ||
- | |||
- | If you have made any changes on [[interwiki]] or smiley configurations or the source code itself, you will probably want to reapply them after upgrading. | ||
- | |||
- | When you upgrade from a version prior to 2005-02-06, you will need to [[utf8update|convert your data to UTF8]] after upgrading. | ||
- | |||
- | If you encounter some inconsistencies in [[DokuWikis]] behaviour after upgrading, you should delete the cache files in '' | ||
- | |||
- | [[moreupgradedetail | Example Upgrade Process]] | ||
- | |||
- | ====== Easier/ | ||
- | This method is not official - i (redeeman, visitor) just thought it would be nice to present this method of upgrade, which i just have used myself to upgrade from 2005-07-01 to 2005-07-13. | ||
- | |||
- | the thing i do, is to use diff, a command to generate a patch, this should be present on almost any unix system, however, it is probably also possible to find a win32 version on google. | ||
- | |||
- | now all we do to create the patch is to unpack the two different versions, so we get the dirs: " | ||
- | < | ||
- | now we have the patch, this is essentially only the differences between the two directories (e.g it knows nowthing of your pages, which is good) and you should be able to patch up, without it interfering with anything. however, you should not, that it might have changes in the conf/ dir in files you have edited, in which case you should do a backup of the file, copy the file from the version you already have, so the patch will work, and then when the patch is applied redo your changes, however this is only the case if changes to the dokuwiki standard php file is in an upgrade. | ||
- | |||
- | To check which files the patch will affect, you can run with --dry-run.. just cd into the dir where dokuwiki is installed, and run: | ||
- | < | ||
- | then if you accept it :) just run it like this, without --dry-run: | ||
- | < | ||
- | |||
- | [[alternativeupgradedetail | Example of everything needed for this]] | ||
- | |||
- | ====== It Works - What Now ? ====== | ||
- | |||
- | Here is **what** you may want to do when everything is up and working. | ||
- | |||
- | * Check the [[security]] page for hotfixes | ||
- | * Consider enabling [[http:// | ||
- | * Choose a license for your content -- edit the '' | ||
- | * [[http:// | ||
- | * [[http:// | ||
- | * If using [[http:// | ||
- | * Change the '' | ||
- | * Enter a few words how and where you use [[DokuWiki]] in the [[users|userpage]] | ||
- | * [[http:// | ||
- | |||
- | ====== Multiple Wiki ====== | ||
- | |||
- | The topic of multi-wiki, or wiki farms, comes up briefly in | ||
- | [[http:// | ||
- | [[http:// | ||
- | [[http:// | ||
- | [[http:// | ||
- | In the last one, [[http:// | ||
- | |||
- | Note that namespaces could be used to separate content in a single installation. And multiple installation means each one will need its own upgrade. It is not the same as multiple instances sharing common code. Package upgrades, like Debian’s, will not handle multiple installations. But for some this is a price worth paying. Here is an approach that worked with the GNU/Linux installation using Apache. It can probably be adapted to the other situations: | ||
- | |||
- | - Do the regular installation, | ||
- | - Create conf/ | ||
- | - Copy the folder “dokuwiki” and give it a name suggesting its content. | ||
- | - Set $conf[’title’] in local.php of new folder, to title and differentiate the installation. | ||
- | - If the new folder is named “newwiki, | ||
- | |||
- | Do the first two steps once and repeat the last three to make multiple installations. |