XWiki

XWiki は Java で書かれたオープンソースのエンタープライズ用 wiki です。拡張性に重きが置かれています。詳しくは Wikipedia の記事や XWiki ホームページ を参照。

同じようなソフトウェアとして Perl で書かれた Foswiki も存在します。

インストール

XWiki インストールガイド に従ってインストールしてください。以下の手順では Tomcat と PostgreSQL を使用します。他の組み合わせに変えるのはそう難しくはありません。

• PostgreSQL をインストール。
• PostgreSQL を楽に管理するために、phpPgAdmin をインストール。
• Tomcat 7 をインストール (tomcat-native も必要です)。
• XWiki の WAR ファイルをダウンロード。
• WAR ファイルの名前を xwiki に変更。
• WAR ファイルを /var/lib/tomcat7/webapps ディレクトリに移動。
• Tomcat は自動的に WAR ファイルを展開します。展開されない場合、Tomcat を再起動してください。
• この時点で、/var/lib/tomcat7/webapps に data ディレクトリが作られます。削除してください。
• root で以下のコマンドを実行:

# cd /var/lib/tomcat7
# mkdir data
# chown tomcat:tomcat data

• /var/lib/tomcat7/webapps/xwiki/WEB-INF ディレクトリで以下の操作を実行:
  • xwiki.cfg ファイルを開いて xwiki.work.dir フィールドを変更し /var/lib/tomcat7/data/xwiki が読み込まれるようにしてください。
  • xwiki.properties ファイルを開いて container.persistentDirectory フィールドを変更し /var/lib/tomcat7/data/xwiki が読み込まれるようにしてください。
  • hibernate.cfg.xml ファイルを開いて以下を編集:
    • "Configuration for the default database" という名前のセクションをコメントアウト。
    • "PostgreSQL Configuration" という名前のセクションをアンコメント。
    • データベースの名前 (connection.url) やユーザー名、パスワードを適宜編集。
• PostgreSQL に hibernate の設定と同じロールとデータベースを作成してください。
• Arch User Repository から postgresql-jdbc^AUR をインストール。
• root で以下を実行:

# cd /usr/share/java/tomcat7
# ln -s /usr/share/java/postgresql-jdbc/postgresql-jdbc4.jar

• Tomcat を再起動。
• Tomcat Manager で /xwiki をクリックして XWiki アプリケーションを起動。
• XWiki の XAR ファイルをダウンロードして空の Wiki を作成。

Nginx プロキシ設定

nginx をプロキシとして使って http://localhost:8080/xwiki/ にアクセスするようにしても、生成される URL に問題が発生します。XWiki ドキュメント に書かれていることと異なり、HTTP ヘッダーを使って修正できません。

Tomcat の server.xml ファイルに新しい Host エレメントを作成することで解決できます:

• 既存の Host エレメントをコピーして name 属性を xwiki に変更。
• appBase 属性を /var/lib/tomcat7/webapps-xwiki に変更。
• xwiki アプリケーションを /var/lib/tomcat7/webapps/xwiki から /var/lib/tomcat7/webapps-xwiki/ROOT に移動。
• Tomcat を再起動。
• /etc/hosts にローカルホストのエイリアスとして xwiki を追加 (127.0.0.1 の行の末尾に追加)。
• Nginx で http://xwiki:8080/ を使うようにプロキシ設定。