セットアップ手順概要

てがろぐをXREAのサーバにセットアップする方法は、とても簡単です。

セットアップ手順は下記の2ステップだけです。

1. 全ファイルを同一のディレクトリ下にアップロードする。
2. パーミッション(属性値)を指定通りに設定する。

これだけで動作します。

設置手順1：ウェブサーバへファイルをアップロード

てがろぐ公式TOPページからダウンロードしたZIPファイルを展開し、すべてのファイルを任意のディレクトリ^※1にアップロードして下さい。（説明用の「README.TXT」は不要です。）

お使いのFTPソフトに転送モードの設定がある場合は、「バイナリモード」にしておく方が無難^※2です。

設置後のディレクトリ構造は下図のようになります。 考えるのが面倒なら、とりあえず全部そのままアップロードすれば良いです。
サブフォルダは、フォルダ構造(階層構造)を維持したままアップロードして下さい。

図の左側は最小限のファイルだけで使う場合のディレクトリ構造、中央は最小限のファイルだけで使う場合の推奨形^※3、右側は完全構成ZIPの全ファイルをUPする場合のディレクトリ構造です。
初めてお使いになる場合は、完全構成版のZIPの中身を全部アップロードして、上図の右端の「完全構成」にすることをお勧め致します。

設置手順2：パーミッションの設定

アップロードしたファイルのパーミッション(アクセス権/属性)を下表の「suEXEC」の方に設定して下さい。

※A：suEXECという安全な仕組みが採用されているサーバでは、こちらの値を設定しないと正しく動かない場合があります。（特にディレクトリの値を「一般の場合」にはしないようご注意下さい。）
※B：ウェブサーバのヘルプをご参照頂き、サーバ側が要求する（推奨する）値があればそれに設定して下さい。そのような情報がないか分からない場合は、まずは「705」や「604」のように真ん中がゼロの値にしてみて下さい。それで支障がある場合には、「755」や「644」などの（真ん中がゼロではない）値の方をお試し下さい。

※0：ファイル名を「index.cgi」に変更しても動作可能ですが、それよりは『ファイル名「tegalog.cgi」を省略してアクセス可能にする方法』の採用がお勧めです。
※1：ファイル名は自由に変更可能です。（ファイル名の変更内容は tegalog.cgi 内に反映させる必要があります。よく分からない場合はデフォルトのままご使用下さい。）
※2：ファイル拡張子は.xml以外に変更しても構いません。（記録形式はXMLです。）
※3：ファイル拡張子は.ini以外に変更しても構いません。（記録形式はINIベースの独自仕様です。）
※4：ファイル拡張子は.cgi以外でも構いませんが、外部から閲覧されるのを防ぐために「.cgi」にしてあります。他の拡張子に変更する場合は、.htaccessファイルなどを使って中身が閲覧されないように設定して下さい。ログイン用のパスワードを忘れてしまった場合は、このファイルの中身を空っぽにして再度アップロードすると、無条件ログインが可能になります。
※5：ファイル拡張子は.cssでなければなりません。ファイル名は、skin-cover.htmlのlink要素に書かれているファイル名に合わせる必要があります（スキンによっては tegalog.css ではない場合もあります）。
※6：このディレクトリには「書き込み権限」の付与が必須です。しかし、サーバでsuEXECが使われている場合は、705等の一般的な値のままで正しく動作します。その場合に777等に設定すると（主に画像表示の面で）正しく動作しなくなる可能性があります。
※7：ディレクトリ名は何でも構いません。必ずしも「skin-」で始まっている必要はありません。

➡ 以上で、もう動作するハズです。

ブラウザで tegalog.cgi にアクセスして表示を確認してみて下さい。

▼表示を確認した後

• 動いた場合は、そのままお使い下さい。
  • 使い方・設定方法ページもご参照頂くと良いかもしれません。
  • カスタマイズの余地を知るには、カスタマイズ方法ページをご参照下さい。
  • そのほか細かなTipsは、豆知識・FAQページにあります。

    てがろぐをさらに複数個セットアップして併用する場合は、セットアップ方法ページの「CGIを複数個設置して併用する方法」もご覧下さい。

• 404 Not Found になる場合は、
  • アクセス先が間違っています。「アップロードした先のディレクトリ」と「URL」との関係を再度ご確認になり、正しいURLでアクセスして下さい。

    てがろぐ自身が「404 Not Found」エラーを出すことはありませんので、もし 404 Not Found エラーが見えたなら、それは100％ アクセスするURLが間違っている のが原因です。
    ※例えば、tegalog.cgi と同じ位置に dummy.html などのファイル名で適当なHTMLを置いてみて下さい。そのファイルにアクセスできないのなら、URLが間違っています。

• 403 Forbidden（You don't have permission to access this resource.）になる場合は、
  • ブラウザで tegalog.cgi にアクセスしているかどうかをご確認下さい。 自身で何らかの工夫をしない限り、ディレクトリ名までのURLにアクセスしても表示されません。 ディレクトリ名までのURLで動くようにしたい場合は、さらに『ファイル名「tegalog.cgi」を省略してアクセス可能にする方法』をご参照下さい。
  • tegalog.cgiにアクセスできているのに（404 Not Foundではなく）このエラーが出る場合は、パーミッションの設定値を再度ご確認下さい。
• 403 Forbidden（Server unable to read htaccess file, denying access to be safe）になる場合は、
  • おそらく、パーミッションの設定値が間違っています。パーミッションの値を再度ご確認下さい。

    ディレクトリ内をこねくり回しすぎて何が何やら分からんわ……という場合は、一旦そのディレクトリを全部消して、もう一度（アップロードする前の）ディレクトリを新規作成するところからやり直してみることをお勧め致します。^^;

• 動かない場合（404や403以外のエラーが出る場合）は、
  • パーミッションの値を再度ご確認下さい。
  • ソースを編集した場合は、編集していない状態のファイルでまず動作を試してみて下さい。

    編集していない状態のファイルなら正常に動作する場合は、（編集したことで）改行コードが正しくなくなっている可能性があります。改行コードを明示して保存できるテキストエディタ（EmEditor等）を使って、改行コードは [LF] で保存して下さい。もしくは、FTPソフトの転送モードを「アスキーモード（テキストモード）」に設定してアップロードしてみて下さい。

  • WordPress等のCMSの配下にあるディレクトリにアップロードした場合は、特別な対策が必要な可能性があります。まずは、CMSの影響下にない場所でお試し下さい。
  • そのほか、トラブルシューティング項目等をご参照下さい。

XREA特有の補足情報

おそらく tegalog.cgi のソースを書き換える必要はありません。しかし、tegalog.cgiの77行目付近にある設定項目 my $howtogetpath = 2; の値を、 my $howtogetpath = 1; のように「1」に変更しないと正常に動作しなかったというご報告を1件だけ受けています。