Download the PHP package netcommons/netcommons3 without Composer

NetCommons

国立情報学研究所が次世代情報共有基盤システムとして開発しています。サポート情報やライセンスなどの最新の情報は公式サイトを御覧ください。 こちらのリポジトリは最新版として開発中のv3となります。安定版ではありませんのでご注意ください。現在の安定版についてはこちらのレポジトリをご覧ください。

NetCommons公式サイト

dependencies	status
Gemfile
composer.json

動作実績

以下の組み合わせで動作することを確認しています。

インストール

共通

下記アプリケーションをインストールして下さい。

• virtualbox
  • https://www.virtualbox.org/wiki/Downloads
• vagrant
  • http://www.vagrantup.com/downloads.html
• chef-dk
  • https://downloads.getchef.com/chef-dk

Windows ホストの場合、vagrant は 管理者権限が必要なフォルダ（Program Files 等）にはインストールしないようにしてください。vagrant 起動時にエラーが発生します。

依存ライブラリのインストール

共通

vagrant plugin

vagrant plugin (vagrant 1.4.x)

vagrant plugin (vagrant 1.5.x 1.6.x)

vagrant plugin (vagrant 1.7.2)

ubuntu 12.10

OSX Mavericks

Windows

git クライアントインストール

• msysgit
  • http://msysgit.github.io/

git コマンドのパスが通っていないと下記エラーが発生します。

その場合 msysgit を再度インストールするなど試して下さい。

Tar ファイルコピー

git clone 以外の処理は、C:\HashiCorp\Vagrant\embedded\mingw\mingw32env.cmd の使用を推奨します。
Tar ファイルが不足しているため、 Tar for Windows から Binaries(Zip): tar-1.13-1-bin.zip と Dependencies(Zip): tar-1.13-1-dep.zip をダウンロードし、解凍した中身のファイルを、C:\HashiCorp\Vagrant\embedded\mingw にコピーしてください。
※ コピーを忘れると、dep-selector-libgecode で失敗します。

ソースの配置

このリポジトリを git でクローンするか、ZIP などでダウンロードしてください。
git でクローンする場合は、ソースを配置したいパスに移動して以下のコマンドを実行します。

Windows ホストの場合

git について

git の pre commit hook で phpcs, phpmd, phpunit, php -l が通らないものを commit できないようにしていますが、Windows 用の git クライアントには pre commit hook を無視するクライアントがあるようなので、guest 側 の git command をご利用下さい。
Windows ホスト側で git コマンドを使うのは、初回 git clone 時のみとして下さい。

synced_folder 無効化

virtualbox のある時点から Windows では synced_folder 上で symlink が貼れなくなっています。
synced_folder を有効にしたままで vagrant up すると symlink が破壊されます。下記の通り Vagrantfile に 『disabled: true』 を指定して下さい。

↓

synced_folder に関する記載は3箇所ありますが、上記箇所のみ修正してください。

Berksfile の修正（vagrant1.4.xのバージョンのみ）

vagrant-berkshelf の古いバージョンでは、source が使えないため下記の修正を行い、Berksfile.lock ファイルを削除してから、vagrant up を実行しないとエラーになります。

↓

起動

vagrant を起動

配置したソースのパスで vagrant を起動します。初回のみ OS のダウンロードに時間がかかります。

Windows ホストの場合

vagrant が正常に起動された後に、vagrant により作成された仮想環境（ゲスト環境）に SSH で接続し、下記コマンドを実行してください。
SSH 接続には、Putty などの SSH クライアントソフトを使用し、127.0.0.1 のポート 2222 に接続してください。
SSH 認証のユーザ名とパスフレーズはともに「vagrant」です。

その後、ホスト側で下記コマンドを実行してください。

再度ゲスト環境に SSH で接続した後、下記コマンドを実行してください。

動作確認

ホスト側で vagrant up を実行すると、以下のようなコマンドラインが表示されます。

それぞれ SSH と HTTP に使用するポート番号です。
デフォルトでは上記のポート番号を使用しますが、デフォルトのポートが使用中の場合は他のポート番号を使用する場合があります。
値が異なる場合は適宜以下の説明を読み替えてください。

また、Windows ホスト以外では、ゲスト環境への SSH 接続に vagrant コマンドを使用可能です。

ゲスト環境には下記 vhosts が作成され、動作の確認ができます。

Windows ホストの場合

vagrant up default 実行時に hosts ファイルに下記設定が追加されます。

hosts ファイルの編集には管理者権限が必要です。vagrant up default 実行時にユーザーアカウント制御ダイアログが表示されるため、「はい」をクリックし、編集を許可してください。
また、上記 URL へ接続できない場合は、hosts ファイルの設定を見直してください。

開発

virtualbox の最新版, vagrant 1.4.x の組み合わせで Windows のホスト側にてファイルを編集する場合は、下記 samba をマウントし作業をする必要があります。

その他の OS は vagrant up したディレクトリ直下のファイルを直接編集するだけで host <=> guest 間でファイルが同期できます。

終了

vagrantコマンドで仮想マシンを終了、又は破棄できます。

• 一旦止めるだけの場合

• データを破棄する場合 次回、vagrant up の際にはまっさらなマシンから新規インストールが行われます。

• provision する場合 default オプションをつける必要があります。

Workaround

• 仮想化機能が無効である場合 vagrant up 実行時に、仮想化支援機構(VT-x/AMD-V)が有効化されていないメッセージが表示された場合は、BIOSの設定を見直してください。
  また、ゲスト環境に /var/www/app/ ディレクトリが生成されていない場合、仮想化機能が無効となっている可能性があります。

• vagrant up default 実行時に下記エラーメッセージが表示された場合（vagrant plugin インストール漏れ）

上記エラーメッセージが表示された場合は、vagrant プラグインをインストールしてください。
なお、インストール済プラグインの一覧は、下記コマンドで確認できます。

• vagrant up default 実行時に下記エラーメッセージが表示された場合（jenkins インストール失敗）

ネットワーク環境またはキャッシュにより、タイムアウトが発生し、jenkins のインストールに失敗しています。
この状態から vagrant provision default を実行しても環境は正常に構築されないため、再度環境構築を実施してください。
Windows ホストの場合、下記手順で環境の初期化を実施します。

1. ホスト側で vagrant halt コマンドを実行
2. ホスト側で vagrant destroy コマンドを実行
3. ホスト側に配置した NetCommons3 をディレクトリごと削除
4. ユーザディレクトリ直下に作成される、下記ディレクトリを削除（Windows 8、8.1 ホストの場合、ユーザーディレクトリは C:\Users\ユーザー名\）
   • .berkshelf
   • .gem
   • .vagrant.d

上記後、vagrant プラグインのインストール、NetCommons3のソース配置を実行してください。

• http://app.local:9090 にアクセスした際に、インストール画面が表示されない場合 ゲスト環境に SSH で接続し、下記コマンドを実行してください。

composer update の途中で token の入力を求められた場合は、ブラウザで Github にログイン後、下記手順で token を取得し、入力してください。

1. Github にログイン後、https://github.com/settings/profile に遷移
2. Personal Settings から Personal access tokens をクリック
3. Generate new token ボタンをクリック
4. Github のパスワード再入力
5. Token Description に適当な値を入力し、Generate token ボタンをクリック

• http://app.local:9090 にアクセスした際に、インストール画面がきれいに表示されない場合 CSS の配置に失敗しています。ゲスト環境に SSH で接続し、下記コマンドを実行してください。

実行時に下記メッセージが表示されます

bower 改善のため、匿名による情報収集を許可するかの確認です。Y または N を入力してください。

• ブラウザによる NetCommons3 インストール中に /usr/bin/hhvm/ というエラーメッセージが表示される場合 ゲスト環境に SSH で接続し、下記コマンドを実行してください。

Windows ホストの場合

• vagrant up default 時に vagrant-berkshelf プラグインの起動に失敗する場合

上記エラーが発生した場合は、C:\HashiCorp\Vagrant\embedded\mingw\mingw32env.cmd から vagrant up default を実行して下さい。

• vagrant up default 時に Apache の再起動に失敗する場合

上記エラーが発生した場合は、気にせず vagrant provision default を実行してください。