差分
このページの2つのバージョン間の差分を表示します。
両方とも前のリビジョン前のリビジョン次のリビジョン | 前のリビジョン | ||
wiki:install [2005/11/29 21:17] – 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)機能を使いたい場合は、users.auth.phpとacl.auth.phpというファイルを作ります。 (just a user, TL) | ||
- | |||
- | #> cp dokuwiki/ | ||
- | #> cp dokuwiki/ | ||
- | |||
- | * ファイルのパーミッションを正しく設定します | ||
- | * 通常、Webサーバーのプログラムは '' | ||
- | * DokuWikiが使うファイルやディレクトリの中にはWebサーバーが書き込みができるようにパーミッションを設定する必要があるものがあります(ですから下の例の '' | ||
- | * アクセスコントロール機能を使う場合は、ファイルのグループオーナーもWebサーバーが属するグループが書き込めるように変更する必要があります(ユーザーとWebサイトの管理者であるあなたも直接ファイルを編集できるようにするためにグループオーナーを使います)――これを設定しないと、ユーザー登録ができなくなり、あなた自身もWebブラウザからACLの設定ができなくなります。私自身、ACL機能を使ったサイトをインストールするときによくこの設定を忘れてしまうので、ここでご説明しています。 | ||
- | * Webサーバープログラムが属しているグループの名前は通常はユーザー名と同じか " | ||
- | |||
- | #> chgrp nogroup dokuwiki/ | ||
- | #> chgrp nogroup dokuwiki/ | ||
- | |||
- | #> chown -R nobody dokuwiki/ | ||
- | |||
- | * その他、必要に応じて '' | ||
- | * 最後に、設定がすべて正しくできたか確認します。DokuWikiのURLの後ろに '' | ||
- | |||
- | * アクセスコントロール機能を使うときは、自分がログインしたときに画面に " | ||
- | |||
- | === 注意 === | ||
- | |||
- | * まれに、chownがうまく効かない場合があります。そのときは、dataディレクトリをchownするかわりにchmodして書き込めるようにします | ||
- | * .htaccessファイルでの指定がエラーを起こす場合があります。 ' | ||
- | |||
- | |||
- | |||
- | ===== Debian GNU/Linux, Ubuntu Linux ===== | ||
- | |||
- | [[mpo@iki.fi|Matti Pöllä]]による公式[[doku> | ||
- | |||
- | Ubuntuでは、" | ||
- | |||
- | DokuWikiのインストールは[[http:// | ||
- | |||
- | #> apt-get update | ||
- | #> apt-get install dokuwiki | ||
- | |||
- | これでパッケージが展開され、debconfからの質問にいくつか答えると完了です。ブラウザからDokuWikiを開けます。例えば、Webでのアクセスの場所を /dokuwiki にして、localhostからのみアクセスできると指定した場合、%%http:// | ||
- | |||
- | パッケージのバグを見つけたときはDebianのバグトラッキングシステム[[http:// | ||
- | |||
- | |||
- | |||
- | ===== FreeBSD ===== | ||
- | |||
- | FreeBSDのportsからDokuWikiをインストールするには次のようにします: | ||
- | |||
- | #> cd / | ||
- | #> make install clean | ||
- | |||
- | DokuWikiをインストールするディレクトリはデフォルトでは''/ | ||
- | もちろん、インストール先を別のディレクトリにしたり、別の場所へシンボリックリンクを張ることもできます。 :-) | ||
- | |||
- | Portsでのアップグレードは: | ||
- | |||
- | #> portupgrade dokuwiki | ||
- | |||
- | Ports treeが新しい物に更新されている必要があります。そうでないと、何も起こりません。 | ||
- | |||
- | |||
- | |||
- | ===== Mac OS X と Apache ===== | ||
- | |||
- | くわしくは[[http:// | ||
- | |||
- | このHOWTOは大変役に立ちますが、少し内容が古いようです。 | ||
- | |||
- | 私がTiger(古いDokuWikiはインストールされていない環境)にインストールしたときは次のような手順でした: | ||
- | |||
- | - [[http:// | ||
- | - [[http:// | ||
- | - コマンドラインから:< | ||
- | $ cd ~/Desktop && tar -zxvf dokuwiki-2005-07-13.tgz | ||
- | $ mv dokuwiki-2005-07-13 ~/ | ||
- | $ cd ~/ | ||
- | $ touch data/ | ||
- | $ sudo chown -R www data</ | ||
- | - アクセスコントロールを使いたい場合は(conf/ | ||
- | $ cp conf/ | ||
- | $ sudo chown www conf/ | ||
- | $ cp conf/ | ||
- | $ sudo chown www conf/ | ||
- | - 重要:conf/ | ||
- | |||
- | ## 10.4.3 クライアントで、標準装備のApacheを走らせて、サイトを/ | ||
- | |||
- | ===== 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**!!// | ||
- | |||
- | |||
- | |||
- | |||
- | |||
- | ===== FTPでファイルを転送するホスティングサービスのサーバー ===== | ||
- | |||
- | **レンタルサーバーをお使いの方はほとんどこれに該当します** | ||
- | |||
- | このタイプのサーバーへのインストールの[[doku> | ||
- | |||
- | * ダウンロードしたtarボールのファイルをローカルのパソコンのハードディスク上に展開します ((例えばWindowsの場合、[[http:// | ||
- | * '' | ||
- | * Windowsの場合: | ||
- | * '' | ||
- | * お好みのFTPツールを使って'' | ||
- | * ホスティング会社のFTPサーバーの設定によっては、このままですでにDokuWikiが使える状態になっているかもしれません ― 次のようにURLの後ろに'' | ||
- | * 赤い警告メッセージが出ている場合は、FTPプログラムを使ってファイルのパーミッションを変更する必要があります。 | ||
- | * FTPプログラムでファイルのパーミッションを変更するオプションはたいてい'' | ||
- | * いちばん単純な設定は、'' | ||
- | * :!: その前に、まず'' | ||
- | |||
- | ===== 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]] | ||
- | |||
- | |||
- | |||
- | ====== 動いた ― 次はどうすればいい? ====== | ||
- | |||
- | 無事すべての設定が終わって動き始めたら、次にやるべきことは次のとおりです。 | ||
- | |||
- | * 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. |