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

Gfdnavi インストールガイド ver. 1.0

このドキュメントは UNIX 系 OS における Gfdnavi のインストール手引きです. Gfdnavi を動かすために必要な事前準備についても解説します. Windowsでのインストールについては, 手引き「Windows に Gfdnavi をインストールする」を参照して下さい.

  1. Ruby 及び GPhys のインストール
  2. RubyGems のインストール
  3. Rails 2.0 のインストール
  4. RDBMS の導入
  5. Gfdnavi のインストール

Ruby 及び GPhys のインストール

手引き「Ruby 及び GPhys のインストール」を参照して下さい. プラットホーム別の解説があります.

RubyGems のインストール

手引き「RubyGems のインストール」を参照して下さい. プラットホーム別の解説があります.

Rails 2.0 のインストール

rubygems の設定が済んでいるならば 以下のコマンドを実行することで, rails がインストールできます.

# gem install rails --include-dependencies

プロキシが必要なときは次のオプションを加えます:

-p 'http://your.proxy.server:port'

また, 以下のようなエラーが表示されることがあるかもしれませんが, その場 合は再度上記のインストールコマンドを実行してください.

例1)

ERROR:  While executing gem ... (NoMethodError)
   undefined method `passed?' for nil:NilClass

例2)

ERROR:  While executing gem ... (Gem::GemNotFoundException)
   Could not find rails (> 0) in any repository

無事インストールされたかは,

rails -v

として確認することができます.

RDBMS の導入

Gfdnavi において動作確認されている RDBMS (関係データベースマネージメントシステム)は, SQLite3, MySQL, PostgreSQL です*1.

以下の手引きを参照していずれかをインストールして下さい. プラットホーム別の解説があります.

Gfdnavi のデフォルトは SQLite3 です.

Gfdnavi のインストール

パッケージの取得

Gfdnavi ver.1.1 は ここ からダウンロードできます。

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

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

初回インストール時

プロキシの設定

Rails 2.0 を使っている場合はインストール時にネットワークに接続する必要があります。 もしプロキシが必要な環境の場合には予め環境変数 http_proxy を設定しておいてください。

csh / tcsh の場合
setenv http_proxy http://your.proxy.server:port
bash / zsh などの場合
export http_proxy=http://your.proxy.server:port
Windows コマンドプロンプトの場合
set http_proxy=http://your.proxy.server:port

インストーラの起動

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/hoge/gfdnavi/config/database.yml

YOU CAN MANUALLY EDIT IT LATER IF YOU LIKE.
データベースの種類の設定
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) SQLite3 の場合

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

(2) MySQL の場合

Cygwin の場合は Windows ネイティブの MySQL か Cygwin 上でコンパイルした MySQL か指定します。

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

既に MySQL で Gfdnavi 用の設定を行ってある場合は 用いたユーザー名とパスワードを入力します。 まだの場合はここで入力したものを使って設定してください。 この例では davis, hogehero です。

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

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. 

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

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

Gfdnavi の設定

Gfdanvi configuration


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

   /home/hoge/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: [email protected]
インストールタイプ
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):
rails コマンドの実行

ここで自動的に rails コマンドが実行されます。 再インストール時には再度実行するか聞かれます。

プラグインのインストール

rails 2.0.x を使っている場合にはここで ネットワーク経由でプラグインがインストールされます。 プロキシが必要な場合には予め環境変数 http_proxy に プロキシサーバを設定しておいてください。

+ ./README
+ ./init.rb
+ ./lib/active_record/acts/list.rb
+ ./test/list_test.rb
+ ./README
+ ./Rakefile
+ ./init.rb
+ ./lib/active_record/acts/tree.rb
+ ./test/abstract_unit.rb
+ ./test/acts_as_tree_test.rb
+ ./test/database.yml
+ ./test/fixtures/mixin.rb
+ ./test/fixtures/mixins.yml
+ ./test/schema.rb
+ ./LICENSE
+ ./README
+ ./Rakefile
+ ./init.rb
+ ./lib/will_paginate/collection.rb
+ ./lib/will_paginate/core_ext.rb
+ ./lib/will_paginate/finder.rb
+ ./lib/will_paginate/view_helpers.rb
+ ./lib/will_paginate.rb
+ ./test/array_pagination_test.rb
+ ./test/boot.rb
+ ./test/console
+ ./test/finder_test.rb
+ ./test/fixtures/admin.rb
+ ./test/fixtures/companies.yml
+ ./test/fixtures/company.rb
+ ./test/fixtures/developer.rb
+ ./test/fixtures/developers_projects.yml
+ ./test/fixtures/project.rb
+ ./test/fixtures/projects.yml
+ ./test/fixtures/replies.yml
+ ./test/fixtures/reply.rb
+ ./test/fixtures/schema.rb
+ ./test/fixtures/schema.sql
+ ./test/fixtures/topic.rb
+ ./test/fixtures/topics.yml
+ ./test/fixtures/user.rb
+ ./test/fixtures/users.yml
+ ./test/helper.rb
+ ./test/lib/activerecord_test_case.rb
+ ./test/lib/activerecord_test_connector.rb
+ ./test/lib/load_fixtures.rb
+ ./test/pagination_test.rb
サンプルデータのインストール
Do you want to install sample data? (yes/no, default:yes):

設定ファイルの作成

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

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

データベースの初期化

Step 4: Execute rake setup
Could not find table 'nodes'
(in /home/hoge/gfdnavi)
root ユーザーのパスワード

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

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

後は自動的に進みます。

== 1 InitialScheme: migrating =================================================
-- create_table("nodes", {:force=>true})
   -> 0.1570s
-- create_table("guest_owners", {:force=>true})
   -> 0.1140s
-- create_table("directories", {:force=>true})
   -> 0.1690s
-- create_table("actual_files", {:force=>true})
   -> 0.1330s
-- create_table("variables", {:force=>true})
   -> 0.1380s
-- create_table("images", {:force=>true})
   -> 0.4150s
-- create_table("knowledges", {:force=>true})
   -> 0.2010s
-- create_table("knowledge_figures", {:force=>true})
   -> 0.1550s
-- create_table("node_relations", {:force=>true})
   -> 0.1160s
-- create_table("keyword_attributes", {:force=>true})
   -> 0.1000s
-- create_table("spatial_and_time_attributes", {:force=>true})
   -> 0.1810s
-- create_table("value_types", {:force=>true})
   -> 0.1930s
-- create_table("functions", {:force=>true})
   -> 0.1610s
-- create_table("function_outputs", {:force=>true})
   -> 0.1430s
-- create_table("function_arguments", {:force=>true})
   -> 0.1920s
-- create_table("draw_methods", {:force=>true})
   -> 0.1050s
-- create_table("draw_method_attributes", {:force=>true})
   -> 0.3150s
-- create_table("users", {:force=>true})
   -> 0.0880s
-- create_table("sign_up_users", {:force=>true})
   -> 0.0960s
-- create_table("groups", {:force=>true})
   -> 0.1310s
-- create_table("diagram_caches", {:force=>true})
   -> 0.1190s
-- create_table("diagram_cache_data", {:force=>true})
   -> 0.1660s
-- create_table("diagram_cache_sessions", {:force=>true})
   -> 0.1660s
-- create_table("draw_parameters", {:force=>true})
   -> 0.3280s
-- create_table("query_histories", {:force=>true})
   -> 0.1550s
== 1 InitialScheme: migrated (4.2570s) ========================================


registering  /
registering  /samples
registering  /samples/jmadata
registering  /samples/jmadata/MSM-P
registering  /samples/jmadata/MSM-P/2006
registering  /samples/jmadata/MSM-P/2006/010[1-3].nc
registering  /samples/jmadata/MSM-P/2006.nc
registering  /samples/jmadata/MSM-P/2006/0101.nc
registering  /samples/jmadata/MSM-P/2006/0102.nc
registering  /samples/jmadata/MSM-P/2006/0103.nc
registering  /samples/jmadata/MSM-P/2006/0104.nc
registering  /samples/jmadata/MSM-P/2006/0105.nc
registering  /samples/reanalysis
registering  /samples/reanalysis/era40
registering  /samples/reanalysis/era40/t.jan.nc
registering  /samples/reanalysis/ncep
registering  /samples/reanalysis/ncep/T.jan.nc
registering  /samples/reanalysis/ncep/T.jan.zonal_mean.nc
registering  /samples/reanalysis/ncep/UV.jan.nc
registering  /samples/sonde_operational
registering  /samples/sonde_operational/std_plev
registering  /samples/sonde_operational/std_plev/41256.spl.nc
registering  /samples/sonde_operational/std_plev/42410.spl.nc
registering  /samples/sonde_operational/std_plev/43333.spl.nc
registering  /samples/sonde_operational/std_plev/43346.spl.nc
registering  /samples/sonde_operational/std_plev/48698.spl.nc
registering  /samples/sonde_operational/std_plev/61641.spl.nc
registering  /samples/sonde_operational/std_plev/63741.spl.nc
registering  /samples/sonde_operational/std_plev/67083.spl.nc
registering  /samples/sonde_operational/std_plev/72261.spl.nc
registering  /samples/sonde_operational/std_plev/76805.spl.nc
registering  /samples/sonde_operational/std_plev/82193.spl.nc
registering  /samples/sonde_operational/std_plev/91165.spl.nc
registering  /samples/sonde_operational/std_plev/91610.spl.nc
registering  /samples/sonde_operational/std_plev/91948.spl.nc
registering  /samples/sonde_operational/std_plev/94294.spl.nc
registering  /usr
registeration functions
registeration draw methods
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).

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

再インストール時

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

*1他のRDBMS であっても, Ruby on Rails が対応していれば動作すると期待されますが, 定かではありません. 動作報告&レポートお待ちしております.

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