マニュアル

2015年5月31日

サーバー動作環境

  • OS
    Linux、FreeBSD、Windows
    ※ Windows は XAMPP では動作確認済み
    ※ OSX は持ってないので分からない
  • Webサーバー
    Apache (Apache でしか動作検証してません)
  • PHP
    バージョン 5.3 以上
  • MySQL または MariaDB
    MySQL 4.2 以上 (5.0以上推奨、5.6以上だとさらに高速)
    MariaDB 5.1 以上（10.0以上だとさらに高速）

クライアント環境

  • OS
    Windows、OSX、Linux、FreeBSD、iOS、Android 等
  • ブラウザ
    Javascript、Cookie が使用できるブラウザ
    ※ IE、Firefox、Chrome、Chromium、Opera、Sleipnir、Konqueror、Dolphin、
    Android標準ブラウザ 等で検証済み

インストール

画像付きの解説は「簡単インストール」を参照。

  1. THK Analytics 用に MySQL のデータベースを準備しておく (文字コード UTF-8)。
  2. ダウンロードしたファイルを解凍してサーバーにアップロードする。
    (アップロードしてからサーバー側で unzip 等で解凍してもいい。て言うかむしろ、そっちの方がはやい)
  3. ファイル構成 
    ─┼─ _core
 ├─ _data
 ├─ thk (名前変更可)
  4. インストール画面へのアクセス
    • ブラウザで「http://（THK Analytics までのパス）/thk (名前変更可)/view/」にアクセス。
    • 画面に従い、必要な情報を入力していけばインストール完了。
  5. 解析用コードの埋め込み
    • アクセス解析をしたい Web サイトに発行された解析用コードを貼る。
  6. GeoLiteCity.dat ファイルの準備 (必須ではないが推奨)
    • 詳細は後述。

複数サイトの解析

  • 以下のようにファイルを設置してください。 
    ─┼─ _core
 ├─ _data
 ├─ thk (名前変更可)
 ├─ site2 (thk のコピー、名前変更可)
 ├─ site3 (thk のコピー、名前変更可)
  • コピーしたディレクトリの setting の中身は .htaccess のみにしてください。
    (THK Analytics は setting ディレクトリ内にファイルを作成するため、コピーする場合は .htaccess 以外は削除してください。)
  • 解析サイトごとにデータベースを用意するか、
    同じデータベースを使用する場合は、テーブルプレフィクスを解析サイトごとに変更してください。

アップグレード

  1. 本体とDBアップグレード用のファイルをダウンロード。
  2. ダウンロードした本体とDBアップグレード用ファイルを解凍
  3. 解凍した本体のファイルを古いファイルに上書きする。
    (特に指定が無い限り _core フォルダの上書きだけで OK です)。
  4. DBアップデート用ファイル（_upgrade）を以下のように設置。 
    　├ _core
　├ _data
　├ thk (名前変更可)
　├ _upgrade
  5. ブラウザで「http://(THK Analytics までのパス)/thk (名前変更可)/view/」にアクセス。
  6. 画面の指示に従い、データベースをアップグレードする。
    複数サイトの解析を行っている場合は、
    解析サイトごとにデータベースをアップグレードしてください
    （上記「名前変更可」の部分を解析サイトごとにブラウザでアクセスする）。
  7. _upgrade をディレクトリごと削除。
  8. 以上でアップグレードは完了です。

GeoLiteCity.dat ファイルのアップロード

THK Analytics ではドメイン名で国名と都道府県名を判別しますが、
GeoLiteCity.dat があれば、ドメイン名で判別できなかった国名や都道府県名を判別できることがあります。

  1. Maxmind の Webサイトから GeoLiteCity(Binary) をダウンロードしてください。
  2. ファイルを解凍して、GeoLiteCity.dat を「_data」ディレクトリにアップロードしてください。

ログイン用ID・パスワードを忘れた場合

ログイン用のID・パスワードを忘れてしまった時は、以下の操作でシステムの再設定を行ってください。

  1. thk/setting/ ディレクトリの権限(パーミッション) を 755 に変更。
  2. thk/setting/siteurl.php を削除。
  3. ブラウザで「http://Webサーバー/thk (名前変更可)/view/」にアクセス。

MySQL データベースの設定を変更したい場合

データベースの設定を変更する場合は、以下の操作でシステムの再設定を行ってください。

  1. thk/setting/ ディレクトリの権限(パーミッション) を 755 に変更。
  2. thk/setting/database.php を削除。
  3. ブラウザで「http://Webサーバー/thk (名前変更可)/view/」にアクセス。

Posted by るな