[ 地球流体電脳倶楽部 / davis / Gfdnavi / doc ]

GFDNAVI インストーラ使用法

バージョン 0.2 で導入された GFDNAVI インストーラの使い方を以下に示します。


  1. あらかじめ必要なもの
  2. RDBMS の設定
  3. パッケージの取得
  4. 初回インストール時
  5. 再インストール時

あらかじめ必要なもの

  1. Ruby: (ver 1.8.*) オブジェクト指向スクリプト言語です。なるべく新しいものがいいでしょう。
  2. GPhys 等の電脳 Ruby 資源:
  3. Ruby on Rails: (ver 1.2.*) Rubyと関係データベースを用いた Web アプリケーションフレームワークで す。現在 1.1.* 系の Rails では動作しないので、新しいものを 使用してください。
  4. 関係データベースマネージメントシステム(RDBMS): Ruby on Railsが対応している RDBMS は多数ありますが、以下では Rails のチュートリアルで良く使われてる mysql を使います。 ほかに、小規模用の RDBMS として SQLite もおすすめです。
  5. RDBMS の Ruby アダプタ: 使用している環境や RDBMS の種類に応じて Ruby 用のアダプタをインストールする必要がある場合があります。

RDBMS の設定

SQLite3 を使用する場合は特に事前に設定する必要はありません。

MySQL を使用する場合は以下のように設定します。

% mysql -u root -p 

などでログインします。

mysql> create database gfdnavi_development;
mysql> create database gfdnavi_test;
mysql> create database gfdnavi_production;
mysql> grant all on gfdnavi_development.* to 'davis'@'localhost' identified by 'hogehero';
mysql> grant all on gfdnavi_test.* to 'davis'@'localhost' identified by 'hogehero';
mysql> grant all on gfdnavi_production.* to 'davis'@'localhost' identified by 'hogehero';

これでユーザー名 davis のパスワードは hogehero になります。

パッケージの取得

GFDNAVI Ver.0.2 は ここ からダウンロードできます。

ダウンロード後、展開してください。

$ tar zxvf gfdnavi-0.2.tar.gz
$ cd gfdnavi-0.2

初回インストール時

インストーラの起動

ruby install.rb とするとインストーラが起動し、キー入力を求めてくるので従います。

$ ruby install.rb
Welcome to Gfdnavi.
In order install Gfdnavi,
there are the following steps.
Step 1: Setup parameters
Step 2: Execute rails and copy files"
Step 3: Create "database.yml" and "gfdnavi.yml"
Step 4: Execute "rake setup"
Step 5: Set root's password
press any key to continue

インストール先

インストール先を聞いてくるので指定します。

Step 1: Setup parametes
Set destination directory name and copy files.
gfdnavi will be installed to "/path_you_input/gfdnavi"
Please input destination path (defalult: /home/hoge): 

データベース関連の設定

The database settings you will specify in the following will
be written in the file:

   /home/otsuka/gfdnavi/config/database.yml

YOU CAN MANUALLY EDIT IT LATER IF YOU LIKE.

You must finish settings of RDBMS before installing gfdnavi unless you
will use "SQLite3". If you have not, use another terminal now to set up
an RDBMS. If you would like to use mysql, I can show you how to do that. 

MySQL の設定方法の表示

ここで yes と答えると MySQL の設定方法が表示されるので、 MySQL を用いる場合で事前に設定を行っていない場合は次の項目に進む前に別途設定を行います。

Would you like read the how-to for mysql? (yes/no, default:yes): no

データベースの種類の設定

If you have finished the settings, specify the RDBMS.
1. MySQL
2. SQLite3
(Sorry, other RDBMSs are not supported in this installation script.)
Select the RDBMS (default:1): 2

(1) MySQL の場合

Windows の場合は Windows ネイティブの MySQL か Cygwin 上の MySQL か指定します。

1. windows native MySQL
2. MySQL compiled on cygwin
Select the RDBMS platform (default:1): 

GFDNAVI 用の設定を行ったときに用いたユーザー名とパスワードを入力します。 この例では davis, hogehero です。

Input the RDB user name for gfdnavi_* databases : davis
Input the password for the databases: hogehero

(2) SQLite3 の場合

特に設定する必要はありません。

GFDNAVI の設定

Gfdanvi configuration


The gfdnavi settings you will specify in the following will
be written in the file:

   /home/otsuka/gfdnavi/config/gfdnavi.yml

YOU CAN MANUALLY EDIT IT LATER IF YOU LIKE.

暗号化のためのパスフレーズ

Set salt for encryption
input phrase (at least 5 characters): hogehoge

管理者のメールアドレス

Set admin's email address
Input email address: hoge@hoge.ac.jp

インストールタイプ

Select server type to set default configuration parameters
The configurations in "config/gfdnavi.yml" will be set according to your choice of server type.
 1. private server
 2. open server
Select the server type (default:1): 

インストールの開始

インストールが開始されます。いくつか質問されるので答えます。

Step 2: Execute rails and copy files

ディレクトリの作成

/home/hoge/gfdnavi does not exist.
Can I create the directories? (yes/no, default:yes): 

サンプルデータのインストール

Do you want to install sample data? (yes/no, default:yes): 

設定ファイルの作成

これまでの設定項目を設定ファイルに書き込みます。

Step 3: Create "database.yml" and "gfdnavi.yml"

データベースの初期化

Step 4: Execute rake setup
(in /home/hoge/gfdnavi)

root ユーザーのパスワード

root のパスワードを設定します。

Input password for root(number of characters must be 5 to 40): 
Repeat password: 

後は自動的に進みます。

== InitialScheme: migrating ===================================================
-- create_table("directories", {:force=>true})
   -> 0.1250s
-- create_table("variables", {:force=>true})
   -> 0.2810s
-- create_table("actual_files", {:force=>true})
   -> 0.1720s
-- create_table("variable_relations", {:force=>true})
   -> 0.1560s
-- create_table("keyword_attributes", {:force=>true})
   -> 0.1410s
-- create_table("spatial_attributes", {:force=>true})
   -> 0.1410s
-- create_table("functions", {:force=>true})
   -> 0.1710s
-- create_table("function_outputs", {:force=>true})
   -> 0.1250s
-- create_table("types", {:force=>true})
   -> 0.1250s
-- create_table("function_arguments", {:force=>true})
   -> 0.1880s
-- create_table("users", {:force=>true})
   -> 0.1410s
-- create_table("sign_up_users", {:force=>true})
   -> 0.0460s
-- create_table("groups", {:force=>true})
   -> 0.1570s
-- create_table("group_members", {:force=>true})
   -> 0.1870s
-- create_table("diagram_caches", {:force=>true})
   -> 0.1880s
-- create_table("diagram_cache_data", {:force=>true})
   -> 0.1560s
-- create_table("diagram_cache_sessions", {:force=>true})
   -> 0.1560s
== InitialScheme: migrated (2.6560s) ==========================================

== Rel01: migrating ===========================================================
-- create_table("draw_parameters", {:force=>true})
   -> 0.1680s
-- create_table("knowledges", {:force=>true})
   -> 0.1610s
-- create_table("knowledge_figures", {:force=>true})
   -> 0.1380s
-- create_table("query_histories", {:force=>true})
   -> 0.1440s
== Rel01: migrated (0.6130s) ==================================================

"/home/hoge/gfdnavi/public/data" is set as top directory.
...............................................................................
...............................................................................
....................
Directory tree search has been completed.
  Notice: for analysis of variable relation, parse again. (tentatively).

Directory tree search has been completed.
Congraturations!
You sucessed to install gfdnavi to /home/hoge/gfdnavi.
Before you start gfdnavi,
change the following configurations
 1. "config/database.yml" 
 2. "config/gfdnavi.yml"
and check file pamissoin mode of their files (only webserver can read the files).

以上でインストールは終了です。

再インストール時

再インストールの場合は前回の設定を残すかどうか聞かれるので それぞれ質問に答えてください。


davis Group / GFD Dennou Staff dcstaff@gfd-dennou.org
Last Updated: 2007/10/11 (大塚 成徳), Since: 2007/08/15 (大塚 成徳)