Geeklog Documentation

Geeklogのインストール

用語

インストールに必要なもの

必要なソフトウェア

Geeklogをインストールして使用するには、ApacheやMicrosoft IISなどのWebサーバとPHP 5.3.3(7.xもサポートしています)以降が必要です。PHPのエクステンションで必要なものは:

また、データベースとして、MySQL 4.1.3以降か、(MariaDB 5.1以降も可), PostgreSQL 9.1.7以降が必要です。

PostgreSQLユーザーのための注意: 現在、GeeklogではPostgresオプション standard_conforming_stringsoff に設定する必要があります(PostgreSQL 9.1以降はデフォルトで on になっています)。

MySQLユーザーのための注意: 多言語サイトでは、通常、データベースの照合順序に utf8_general_ci を使用します。 この照合順序では異なる言語の文字セットを処理できます。MySQLのバージョン5.5.3では4バイト文字をサポートしています。 例えば4バイトの絵文字アイコンの文字をサポートしたい場合は、utf8mb4_general_ci などの、それをサポートする照合順序を使用する必要があります。 異なる照合順序を使用している既存のGeeklogのデータベースでは、phpMyAdminなどのツールを使用して、データベースのデフォルトやすべての照合順序を変更できます。当初の照合順序によっては、テーブルのデータを更新する必要があります。

必要な技術力

はじめてGeeklogをインストールするなら、次のことを確認しましょう。

新規インストール

  1. Geeklogの現バージョンのターボール(圧縮ファイル)をGeeklog.netGeeklog.jpからダウンロードします。

  2. 次のコマンドを実行して、ダウンロードしたターボールを展開(解凍)します。

    tar -zxvf geeklog-2.0.0.tar.gz

    注意: WinZipを使用すると、そのバージョンによっては、ファイルが壊れると報告しているユーザーがいます。こうなるとインストールの最中にエラーになるので、ローカルでファイルを解凍する必要がある場合は、WinZipの代わりに7-ZipWinRARを使うことを強くお勧めします。(訳註: ExpLZH)

  3. MySQLや、PostgreSQL、Microsoft SQLを使用し、空のデータベースと変更権限のあるユーザーを作成します。ホスティング会社がデータベースを作成してアカウントを作成している場合もあるので、必要ならホスティング会社に尋ねてみてください。

  4. geeklog-2.0.0/public_html/ ディレクトリの中身をWebサーバーのドキュメントルートに転送します。ドキュメントルートには、"public_html"や"htdocs"、"www"などの名前がつけられていることが多いです。

    次に、geeklog-2.0.0/ ディレクトリの中身の残りをドキュメントルートの親ディレクトリ(お勧め!)かWebからアクセスできないディレクトリに転送します。インストールウィザードはこれらの場所を自動的に検出しようとします。検出できない場合は、インストールの過程でパスを入力するよう要求されます。インターネットからのアクセスを防ぐセキュリティ対策としてこのような仕様になっています。

    注意: ホスティング会社がドキュメントツリーの外にファイルを置くことを許可していない場合は、

  5. Webブラウザーを起動し、Geeklogのインストールウィザードを実行します(http://サイトのURL/admin/install/index.php をアドレス欄に入力します)。Geeklogのファイルをサブドメインに置いた場合は、http://サイトのURL/サブドメイン名/admin/install/index.php などとなります。

    Geeklogのインストールウィザードは自動的にインストールを行うので、表示される手順に従ってください。

  6. インストールが終了したら、必ず、 admin/install ディレクトリを削除してください。サイトに最初に表示される記事を読んで、管理者としてのログイン情報を知り、デフォルト状態のパスワードを速やかに変更してください。

旧バージョンからのアップグレード

データベースが既に存在していて更新する必要があるということを除けば、アップグレードは新規インストールと全く同じです。

現在インストールしているGeeklogの中で自分で変更したカスタムコードがあれば(特に lib-custom.php。カスタマイズしたコードはすべてこのファイルの中に入れることをお勧めします)、必ずバックアップを取っておいてください。修正したテーマ、画像、静的ページのバックアップを必ず取っておいてください。

また、データベースのバックアップも必ず取っておいてください。ファイル類とデータベースをバックアップする重要性はいくら強調してもし足りないくらいです。

警告しましたよ!

  1. Geeklogの現バージョンのターボール(圧縮ファイル)をGeeklog.netGeeklog.jpからダウンロードします。

  2. 次のコマンドを実行して、ダウンロードしたターボールを展開(解凍)します。

    tar -zxvf geeklog-2.0.0.tar.gz

    注意: WinZipを使用すると、そのバージョンによっては、ファイルが壊れると報告しているユーザーがいます。こうなるとインストールの最中にエラーになるので、ローカルでファイルを解凍する必要がある場合は、WinZipの代わりに7-ZipWinRARを使うことを強くお勧めします。

  3. geeklog-2.0.0/ ディレクトリの中身を、現在インストールしているバージョンの同じディレクトリに転送します。たとえば、現在のバージョンを /usr/home/www/geeklog/ にインストールしているなら、新しいバージョンも /usr/home/www/geeklog/ に転送します。

  4. 旧バージョンからのアップグレード:
  5. Webブラウザーを起動し、Geeklogのインストールウィザードを実行します(http://サイトのURL/admin/install/index.php をアドレス欄に入力します)。Geeklogのファイルをサブドメインに置いた場合は、http://サイトのURL/サブドメイン名/admin/install/index.php などとなります。

    Geeklogのインストールウィザードは自動的にインストールを行うので、表示される手順に従ってください。

  6. インストールが終了したら、必ず、 admin/install ディレクトリを削除してください。

  7. 必要なら lib-custom.php などのバックアップしておいたコードやテーマなどのファイル類を戻します。

移行

インストール・スクリプトの「移行」オプションは、他のサーバーやドメイン名からサイトの移動の手助けとなります。これはデータベースに保持されている構成情報を更新と、記事にようなコンテンツに含まれる(変更するGeeklogサイトのドメイン名やURLである)URLも更新できます。

「移行」をクリックした後は、いつものように(新しい)データベース・サーバーの認証情報を入力しなければなりません。移行オプションは自動的に検出するので、テーブルの接頭子を入力する必要はないことに注意してください。

次に、あなたのコンピュータからデータベースのバックアップをアップロードするか、サーバー(のGeeklogのbackupsディレクトリ)に既に存在するバックアップから取り込むか、既に他の手段で取り込んでいる場合に現在のデータベースを使用するか、オプションから選択します。

注意: あなたのコンピュータからバックアップをアップロードするには、バックアップ・ファイルの大きさがサーバーのアップロードの制限の最大値以下の場合だけ動作します。許可されている最大のサイズは、このオプションを選択すると表示されます。バックアップ・ファイルの大きさが制限を越えている場合はバックアップ・ファイルを圧縮する(zipやgzipが使用できます)か、他の2つのオプションを使用してください。

よくある問題と解決法

先に進む前に、 siteconfig.php を開き、パスを確認してください。パスが不正であったり、間違いがあったりすると、様々な種類のエラーが発生します。

エラーメッセージが出たら、それを注意深く読んでください。PHPに詳しくなくても、エラーに関するヒントは得られます。エラーメッセージに含まれるパス情報に特に注意してください。上述の通り、パスの間違いは最もよく見られる原因です。

複数のエラーメッセージが表示される場合は、必ず最初のエラーメッセージから手をつけてください。最初のエラーを解決したら、残りのエラーが消えることもよくあります。

よくあるエラー(以下の例で行番号は状況に応じ、違うものになりえます):

これでも問題が生じるなら、次のことを試してみましょう。

  1. https://www.geeklog.net を訪問して、「サポート(Support)」のセクションを調べてみましょう。サポートセクションには、 よくある質問(FAQ)検索(Search)システムがあります。表示されたエラーメッセージを(行番号を除いて)検索してみるとよいでしょう。

  2. http://eight.pairlist.net/pipermail/geeklog-users/ に保存されているメーリングリストの過去ログを読みましょう。このメーリングリストを購読し、Geeklogコミュニティに(英語で)質問を投稿してもよいでしょう。

  3. irc.freenode.net, channel #geeklog のIRCを試しましょう。siteconfig.phpとdb-config.phpに含まれるパス情報とデータベースの情報を手元に用意しておいてください。

  4. エラーメッセージをGoogleで検索してみましょう。他の人が同じ問題に遭遇し、解決している可能性があります。Googleで検索していると、同じエラーが発生している壊れたページが表示されることもあります。

  5. なお、サポートについて詳しくは、ドキュメント「サポート」をご覧ください。