VMWareは，米国VMWare社によって提供されている仮想マシン環境構築・運用ソフトウェアです。

　仮想マシンとは，１台のコンピュータ上で見かけ上複数のコンピュータを稼働させたり，別の種類のオペレーティングシステム(ＯＳ)を同時に稼働させたりするための技術です。

　たとえば，VMWare製品群の１つであるVMWare Player4をWindowsコンピュータにインストールし，同一のコンピュータでLinuxなど他のＯＳを起動します。この場合，LinusはWindoes上の１つのアプリケーションのように動作します。したがって，コンピュータを再起動することなく，WindowsとLinuxをいったりきたりしたり，両方のＯＳ上で動作するソフトウェア間でデータを受け渡したりすることができます。その意味で，ハードディスクのパーティションを２分割した複数のＯＳをインストールした環境とはまったく異なります。このとき，WindowsをホストＯＳ，Linux をゲストＯＳと呼びます。

VMWareを利用するメリット

　VMware Player4を用いた場合，その上で動作するゲストＯＳを各環境までセットアップ済みのファイルとして提供できるメリットがあります。これに対して仮想マシン環境を使用しない場合は，LinuxなどのＯＳのインストールからはじめて，Ruby,Ruby on Rails，さらにSolrのようなミドルウェアのインストールが必要になります。また仮想マシン環境では，他のパッケージシステムとの競合などに注意を払う必要もありません。比較的簡単に行えるVMWare Playerのインストールを行うだけで，Enjuの動作環境の構築を大幅に簡略化することができます。

　またVMware Player4は無償で提供されており，追加費用なしで動作環境を構築できることも大きなメリットです。

１−５　インストールの流れ

■インストールの全体

　VMWare Playerを使ったEnjuのインストールは以下の手順で行います。

第２章 動作環境の確認とVMWare Player4のインストール

２−１　動作環境を確認する

　作業を開始する前に，Enjuをインストールするコンピュータの環境を確認します。また，コンピュータの環境に応じてEnju仮想マシンの64bit版を用いるか32bit版を用いるかを決めます。

■コンピュータの仕様の確認

■Enjuパッケージの提供場所

　Enjuは，以下のURLで最新版が提供されています。インストールする環境に合わせ，必要なパッケージをダウンロードします。

64bit版のEnju仮想マシンを利用する場合

　WindowsコンピュータにインストールしたVMware Player4上で64bit版のEnju仮想マシンをインストールする場合，「 64bit版Enju仮想マシン 」をダウンロードしてください。ダウンロードするファイルは，以下のファイル名です。

enju_leaf_*.*.*_vmware.zip

【Memo】*.*.* にはバージョン番号が表示されます。複数のパッケージが存在する場合は，最新バージョンを利用してください。

32bit版のEnju仮想マシンを利用する場合

　WindowsコンピュータにインストールしたVMware Player4上で32bit版のEnju仮想マシンをインストールする場合，「 32bit版Enju仮想マシン 」をダウンロードしてください。ダウンロードするファイルは，以下のファイル名です。

enju_leaf_*.*.*_vmware_x86.zip

【Memo】*.*.* にはバージョン番号が表示されます。複数のパッケージが存在する場合は，最新バージョンを利用してください。

/>

■パッケージの展開

Enju仮想マシンは，ダウンロードしたパッケージを展開してインストールを行います。

1. Enjuをインストールするフォルダーを作成します。
   

2. ダウンロードした zip ファイルパッケージを展開します。
   

３−２　VMWare Playerの設定

VMWare Playerを起動し，Enju仮想マシンを開く環境を設定します。

1. VMWare Playerを起動します。
   
2. 使用許諾に同意します。
   

3. ［仮想マシンを開く］をクリックします。
   

4. 前項で展開したフォルダーを選択します。
5. 「enju_ubuntu_xxxx.vmx」を選択します。
   
   ファイル名はEnju仮想マシンのバージョンによって異なります。
6. ［Enju_Ubuntu_xxxx］をクリックして，［ファイル］−［Playerの環境設定］を選択します。
   

7. ［閉じるときの動作］を選択します。
   Enju仮想マシンのウィンドウを閉じるときの動作を選択します。選択する項目は任意です。

8. ［仮想マシンを閉じるとき］を選択します。
   Enju仮想マシンを閉じるときの動作を選択します。選択する項目は任意です。

9. ［ソフトウェアの更新］および［ユーザーエクスペリエンス改善プログラム］を設定します。
   オン／オフは任意です。

10. ［OK］をクリックします。
    
【Memo】任意の設定項目が不明な場合，以下のように設定します。


［閉じるときの動作］	［仮想マシンを閉じる前に確認画面を表示］
［仮想マシンを閉じるとき］	［パワーオフ］
［ソフトウェアの更新］	オン
［ユーザーエクスペリエンス改善プログラム］	オン

３−３　Enju仮想マシンの設定

VMWareがEnju仮想マシンに割り当てるメモリ量などの動作環境を設定します。

1. ［Enju_Ubuntu_xxxx］をクリックして，［仮想マシン］−［仮想マシンの設定］を選択します。
   
   仮想マシンの名前は，Enju仮想マシンのバージョンによって異なることがあります。

2. ［ハードウェア］タブを選択します。
3. 表示された画面で，以下の推奨値を参考に各項目を設定します。
   
   • メモリ　　　　　　　：コンピュータに搭載されている全メモリ容量から 1 〜 2GB を減じた値
   • プロセッサ　　　　　：コンピュータに搭載されている CPU のコア数
   • ハードディスク　　　：蔵書規模に応じた値
   • ネットワークアダプタ：［NAT］を選択
4. ［OK］をクリックします。
   

３−４　Enju仮想マシンの起動

Enju仮想マシンを起動し，Ubuntuにログインします。

1. ［Enju_Ubuntu____］をクリックして，［仮想マシンの再生］を選択します。
   

2. 以下のような画面が表示された場合，［コピーしました］を選択して［OK］をクリックします。
   
   
   【Memo】このメッセージ画面は，初回起動時のみ表示される場合があります。また，取外し可能デバイスの選択などが求められる場合もあります。この場合「OK」を押して先に進んでください。

3. Ubuntuのプロンプトが表示されていることを確認します。

4. ［Ctrl］＋［G］を押して入力を仮想マシンに切り替えます。
   VMWare Player4の画面にマウスカーソルをあわせてクリックするだけでも仮想マシンに切替ができる場合もあります。

5. 以下の初期ユーザー名，初期パスワードでログインします。
   

   初期ユーザー名　：　enju

   >

   初期パスワード　：　enjupassword

   
   

6. ログインし，プロンプトが表示されていることを確認します。
   
   
   【Memo】VMWare Playerでキーボードから入力するときは，［Ctrl］＋［ G ］を押して仮想マシン（ゲストＯＳ）に，［Ctrl］＋［Alt］を押してホストＯＳに切り替えます。

■キーボードの設定

使用するキーボードの種類を登録します。

1. コンピュータに接続しているキーボードの種類によって， enju@enju:~$ に続いて以下のコマンドを入力します。
   

   日本語キーボード：

   sudo loadkeys jp

   英語キーボード　：

   sudo loadkeys us

   enju のパスワード入力が求められますので，パスワードを打ち込んでください(画面には出力されません)。

2. パスワード（初期パスワード：enjupassword）を入力します。
   
場合によっては，「 unknown charset unicode - ignoreing charset request 」などと表示され，キーボード上の配置が変更されないこともあるようです。ただし，サーバ上で記号を使うすることがなければ，大きな問題はありませんので，そのまま続けてください。ただし，キーボードの記号(!"#$%&'()など)が正しく入力されていない状況では，次項のパスワード中には記号は含めないようにしてください。

■パスワードの変更

初期ユーザー名「Enju」に対するパスワードを変更します。

1. enju@enju:~$ に続いて以下のコマンドを入力します。
   
   passwd

2. 現在のパスワード，新しいパスワード，新しいパスワード（確認）の順に入力します。
   

■IPアドレスの確認と設定

　Enju仮想マシンの設定時に，ネットワークアダプタを「 NAT(ホストのIPアドレスを共有して使用) 」と設定しましたので，Enju仮想マシンに対しては自動的に適切なIPアドレスが割り当てられています。
　そこで，まず割り当てられたIPアドレスを確認し，これを Enjuサーバが認識できるように設定する必要があります。

1. enju@enju:~$ に続いて以下のコマンドを入力します。
   
   ifconfig
   
   　etho (または eth1)のところに書かれている inet addr: の値をメモします。以下の画面では，192.168.112.128です。
   
   もし，画面が流れていって，読めない場合には ifconfig|more と入力してください。

2. enju@enju:~$ に続いて以下のコマンドを入力します。
   
   ruby setip.rb IP_addr

   「IP_addr」に固定するIPアドレスの値として，前項でメモしたIPアドレスを入力します。下の画面では192.168.13.11を指定していますが，これをそのまま打ち込むのではなく，必ず前項でメモした値を指定してください。
   

■Enju仮想マシンの起動

Enju仮想マシンを起動します。

1. enju@enju:~$ に続いて以下のコマンドを入力します。
   
   sudo enju start
   enju のパスワード入力が求められますので，パスワードを打ち込んでください(画面には出力されません)。
   

2. 画面上に何か文字列が表示されただけで， enju@enju:~$ という文字列が表示され，本当に正しく動いているのかどうかわかりにくいですが，正しく動いている場合でも上記のようになります。

VMWare Player4上でNext-L Enjuが動作している間，VMWare Player4は閉じてはいけません。もし，画面上で邪魔だと感じる場合は，アイコン化(最小化)した状態としておいてください。

３−５　Enju仮想マシンが正しく起動されているかの確認

　Next-L Enjuが正しく起動したかどうかは，サーバ上だけではわかりにくいので，ネットワークに接続された別のコンピュータから確認します。別のマシンといっても，物理的に別のマシンを使うのではなく，Next-L Enjuが動作している同じコンピュータのWebブラウザを用いて確認を行います。なすなわち，ゲストＯＳ(今回の場合はVMWare Player中のEnju仮想マシン)とホストＯＳ(ここではVMWareが動作しているWindows)とは論理的には別のマシンと見なすことができますので，Windows上のWebブラウザを使って確認すれば良いことになります。

1. ホストＯＳ(Windows)に制御を戻します。
   　「Ctrl」 + 「Alt」 キーを押します。
   　「Ctrl」 + 「Alt」キーを押すと，それまで表示されていなかったマウスカーソルが再度表示されます。
2. ブラウザからアクセスします。
   　Windows上でWebブラウザを立ち上げ，アドレス欄に，「http://仮想マシンに割り当てたに割り当てたIPアドレス」と入力してください。たとえば，前項の例では 192.168.112.128 というIPアドレスを仮想マシンに割り当てていた場合には，アドレス欄に以下のように入力することになります。
   http://192.168.1.128

　これで，同じPC上からも，また別のマシンからもEnjuサーバに対してアクセスすることが可能になったと思います。このようにアクセスしても正しく画面が表示されない場合には，何らかの設定ミスがあると思われますので，再度インストールしなおしてください。

３−６　Enjuサーバの停止と再起動

■Enju サーバのシャットダウン

　Enjuサーバを終了(シャットダウン)させる場合には，正しい手順でのシャットダウンを行う必要があり，VMWare Player4をいきなり終了させたり，PCの電源ボタンを押すなどして強制終了させると，使用中のデータベースファイルが壊れて，再起動できなくなるなどの問題が発生する可能性があります。

1. enju@enju:~$ に続いて以下のコマンドを入力します。
   
   sudo enju stop
2. enju@enju:~$ に続いて以下のコマンドを入力します。
   
   sudo shutdown -h now
これらでenju のパスワード入力が求められますので，パスワードを打ち込んでください(画面には出力されません)。

　Enjuサーバをシャットダウンするタイミングは，図書館の運用方針で決定することができます。システム的には，起動したら基本的にはずっと動作させ続けていても問題ありません。毎日システムをシャットダウンする，必要な時だけ稼働させるなど，ポリシーに応じた運用をすることができます。

■Enju サーバの再起動

1. VMWare Player4が終了していた場合，再度VMWare Player4を起動してください。
   
   

2. VMWare Player4が起動後，「 enju_ubuntu_xxxx 」を指定して「仮想マシンの再生」を選択してください。
   
   

3. 再起動して，ユーザ名とパスワードの入力が求められますので，ユーザー名( enju )と，前に変更したパスワードを入力してログインしてください。
   
   

4. enju@enju:~$ に続いて，以下のコマンドを入力します。パスワードの入力が求められることがあります。
   
   sudo enju start

　これで，再度Enjuサーバが利用できるようになりました。

第４章　他のコンピュータからの利用設定

第５章　Enjuのアップデートとデータのパックアップ

５−１　Enjuのアップデート

　Enjuは，以下の手順で，Enjuのソースコードが公開されているGitHUBから変更されたファイルを取り込み最新版にすることができます。

■最新ソースコードの取り込み

1. 　enju@enju:~$ に続いて以下のコマンドを入力します。
   
   cd enju_leaf

2. enju@enju:~/enju_leaf$ に続いて以下のコマンドを入力します。
   
   git pull origin 1.0

   　各種の処理が行われ，メッセージが出力されます。時間もかかります。

3. enju@enju:~/enju_leaf$ に続いて以下のコマンドを入力します。
   
   bundle

   　各種の処理が行われ，メッセージが出力されます。時間もかかります。

4. enju@enju:~/enju_leaf$ に続いて以下のコマンドを入力します。
   
   rake db:migrate RAILS_ENV=production

   　各種の処理が行われ，メッセージが出力されます。時間もかかります。

■コンピュータを再起動します。

　enju@enju:~$ または enju@enju:~/enju_leaf$ に続いて以下のコマンドを入力します。

■起動後の処理

1. 再起動して，ユーザ名とパスワードの入力が求められますので，ユーザー名( enju )と，前に変更したパスワードを入力してログインしてください。
   
   

2. enju@enju:~$ に続いてで以下のコマンドを入力します。
   
   $ sudo /etc/init.d/tomcat restart
   $ sudo /etc/init.d/apache restart
   
   enju のパスワード入力が求められますので，パスワードを打ち込んでください(画面には出力されません)。

５−２　データのバックアップ

第６章　その他

1. 最新の配付パッケージを使用すること

Enju仮想マシンファイルについても，今後，バージョンアップを重ねるたびに配付を予定しています。機能面での充実というだけではなく，セキュリティ面からも最新のパッケージを使用ください。

2. 不必要な外部からのアクセスを禁止すること

場合によっては，ファイアウォールの導入やリモートルータでのフィルタリングについても検討した方が良いこともあるでしょう。

第７章　トラブルシューティング

Q. VT機能が無効になっているというメッセージが表示されます。

　VMware Playerを起動した際，64bit CPUを使用していても，以下のような警告画面が表示されて起動できないことがあります。これは，Virtualization Technologyという機能が無効になっている場合などに表示されます。
　各コンピュータのマニュアルを参照してBIOSのセットアップでVirtualization Technology機能を有効にしてから再起動してください。

　Virtualization Technology機能を有効にしても，VMware Playerを再起動した際，エラーが発生して正しく動作しないことがあります。その場合，再起動を何度か行う，再インストールを行うなどしてください。

Q.「ubuntu64-bitEnju.vmx」というファイルが見つからない。

A. 以下を確認してください。

1. 「仮想マシンを開く(O)」を押していますか。
   「仮想マシンを開く(O)」を押すと，「仮想マシンを開く」というウィンドウが開いて，ファイルを選択することができるようにならな いでしょうか？
2. 正しい場所を選択していますか。
   　配布されているzipファイルを展開した時に作成されるフォルダを選択してください。展開したフォルダが見つからない場合は，zipファイルを展開するということ自体が正しくできているかどうか確認してください。

Q. ネットワークの設定で，IPアドレスの割り当てが正常に行われません。

　eth1に対するIPアドレスの割り当てが正常に行われず，ifconfigした場合にlo のみしか表示されなくなってしまう場合があります。このような場合においては，2.7に示す /etc/network/interfacesの指定時に，eth1 ではなく，全てeth0と指定して再度起動してみてください。

Appendix

■ Enju仮想マシン中の設定ファイル

　Enju仮想マシンのファイル中には，「Ubuntu 64-bit Enju.vmx」というファイルが存在しています。実は，この *.vmx ファイルはテキストファイルであり，VMware Playerの設定ファイルとなっています。ネットワークの設定や，仮想マシンへの割り当てメモリ量などが変更可能です。

　　数多くの設定項目のうち，Enju仮想マシンで特に重要なのは，以下の項目です。仮想マシンを作成している環境の都合上，配布されているパッケージは，必ずしも以下の設定になっていない部分がありますので，各自，自分の環境にあわせて修正してください。修正については，エディタと呼ばれるソフトウェアを用いることができます。たとえば，MS-Windowsに標準で付与されている「メモ帳」はエディタのひとつです。

　なお，MS-Wordなどの日本語ワープロを用いた修正は，テキスト以外の記号が混じってしまい正しく設定されない可能性があるので，行わないでください。

1. 全般設定

config.version = "8"

virtualHW.version = "7"

extendedConfigFile = "Ubuntu 64-bit Enju.vmxf"

displayName = "Ubuntu 64-bit Enju"

guestOS = "ubuntu-64"

nvram = "Ubuntu 64-bit Enju.nvram"

virtualHW.productCompatibility = "hosted"

memsize = "2048"

　　　# PCに搭載したメモリ量に応じて変更してください

2. 作成したディスクイメージファイルをSCSIディスクとして接続する設定

scsi0.present = "TRUE"

scsi0:0.present = "TRUE"

scsi0:0.fileName = "Ubuntu 64-bit Enju.vmdk"

scsi0.virtualDev = "lsilogic"

　　　# Fusion MPT SPI SCSI Host Adapter(Ultra320)のエミュレーションなので

　　　　うまく動作しなければ，lsilogic ではなく buslogicでも試してください

3. ネットワークの設定

ethernet0.present = "TRUE"

ethernet0.connectionType = "bridged"

ethernet0.virtualDev = "e1000"

ethernet0.wakeOnPcktRcv = "FALSE"

ethernet0.addressType = "generated"

ethernet0.linkStatePropagation.enable = "TRUE"

ネットワークの設定については，設置者の状況によって大きく異なる可能性がある

4. その他のデバイスの設定

usb.present = "TRUE"

ehci.present = "TRUE"

floppy0.present = "FALSE"

　　　　# フロッピーディスクが存在する場合は"TRUE"としてください

　これ以外の設定については，基本的には必要ありません(必要なものは，起動後に自動生成されます)が，自身の環境にあわせて設定する場合は，以下のような設定をすることもできます。詳細はご自身で確認ください。たとえば，サウンド機能が実装されているPCであれば，「sound.present = "TRUE"」と指定する，サーバに接続したプリンタを使用する場合には「printers.enabled = "TRUE"」と指定するなどがあります。ただし，Enjuの標準機能では，これらの機能は使用しませんので，Enjuを実行するためには不要です。

　また，Enju仮想マシンファイルのバージョンによっては，以下の指定がされている場合があります。これらの指定がある場合，起動時にエラーが表示される場合もあり，また設定そのものも不必要ですので削除いただいて構いません。

ide1:0.present = "TRUE"

ide1:0.fileName = "/Users/kosuke/Downloads/ubuntu-10.04-server-amd64.iso"

ide1:0.deviceType = "cdrom-image"