レベル: 初級 祖父江 達也 (sobue@jp.ibm.com), Lotus テクノロジー開発, WPLC Business Partner Technical Enablement/ソフトウェア開発研究所, IBM
2009年 10月 02日 IBM Lotus Foundations は、小規模企業が必要とするサーバー・ソフトウェアをひとつのパッケージとして提供するアプライアンス製品です。すべてのサーバー機能を簡単な手順でセットアップすることができ、専任の IT 部門を持たない企業でも、サーバー・ソフトウェアを運用可能にします。Lotus Foundations には Lotus Domino サーバーも標準で含まれており、すぐにチーム・コラボレーションをはじめることができます。この Lotus Domino サーバーでは、標準で用意されているもの以外にも、独自に開発した Lotus Domino アプリケーションを追加インストールして利用することが可能です。本稿では、独自開発の Lotus Domino アプリケーションを、IBM Smart Business Developers' Kit を利用して、Lotus Foundationsにインストール可能な形式にパッケージングする手順を紹介します。
IBM Smart Business Developers' Kit
IBM Smart Business Developers' Kit は、サーバー・ハードウェアを含めたアプリケーション・アプライアンスである IBM Smart Cube や、サーバー・ソフトウェア・アプライアンスである IBM Lotus Foundations 向けのアプリケーションを、インストール可能な形式にパッケージングするための Eclipse ベースのツールを提供します。さまざまなタイプのアプリケーションをパッケージング可能ですが、Lotus Foundation 向けには、Lotus Domino アプリケーションのパッケージング機能が利用可能です。
IBM Smart Business Developers' Kit (以後「開発者キット」と呼びます。)を利用するためには、まず開発環境へのインストールから始めます。開発者キットのインストール・プログラムは、IBM PartnerWorld のメンバー向けに、こちらのサイトよりダウンロード可能となっています。このサイトをアクセスするためには、IBM PartnerWorld のユーザー ID とパスワードが必要です。IBM PartnerWorld プログラムの詳細に関しては、こちらのサイトを参照してください。ダウンロードしたインストール・プログラムを実行し、指示に従ってインストールを完了してください。インストール後、開発者キットを起動すると以下のようなウィンドウが表示されます (図 1)。
図 1. IBM Smart Business Developers' Kit 起動画面

なお、開発者キットをインストールする PC のシステム用件は以下の通りです。
ハードウェア
- Windows Vista Business SP 1
- Windows Vista Enterprise SP 1
- Windows Vista Ultimate SP 1
- Windows XP Professional SP 3
ソフトウェア
- メモリー: 最小1GB、推奨 2GB
- プロセッサー: Intel Pentium 4 プロセッサー 1.7 GHz 以上
- 空きディスク容量:最大 850MB、一時ファイル 410MB
IBM Smart Business Developers' Kit を使った Lotus Domino アプリケーションのパッケージング
IBM Smart Business Developers' Kit を利用した Lotus Domino アプリケーションのパッケージング作業は、以下の4つのステップからなります。
 | ステップ 1:準備 (Prepare)
Lotus Foundations にインストールする Lotus Domino アプリケーションを構成するすべてのファイルを、開発者キットからアクセス可能な場所に準備します。 |  | ステップ 2:パッケージング (Package)
開発者キットが持つパッケージング用プロジェクトと、そのプロジェクトを完成するために用意されたウイザードを使って、ステップ1で用意したファイル群をパッケージングします。 |  | ステップ 3:テスト (Test)
ステップ2で行ったパッケージングが正しいかどうかを、Lotus Foundations サーバーに実際にファイルを転送してインストールしてみることにより確認します。 |  | ステップ 4:配布 (Deploy)
ステップ3でテストを行い、正しいことを確認したパッケージング情報に基づき、ファイル群をひとつの ZIP ファイルにまとめて配布可能にします。 |
以下に各ステップを順に解説します。
ステップ1:準備
開発者キットが Lotus Domino アプリケーションをパッケージングする際には、アプリケーションを構成するファイルすべてを開発者キットが自動収集します。そのため、すべてのファイルは開発者キットが動作している PC からアクセス可能である必要があります。
最初に、パッケージング対象の Lotus Domino アプリケーションを実行している Lotus Domino サーバー上のファイルへ、OS のファイル・システム経由でアクセスが可能であることを確認します。Lotus Domino サーバーが動作している PC 上に開発者キットをインストールした場合には特に問題はありませんが、一般的には開発者キットを使用する PC と Lotus Domino サーバーが稼動する PC は異なり、その場合には注意が必要です。Lotus Dominoアプリケーションが稼動するサーバー PC 上の Lotus Domino の notes.ini ファイルやデータ・ディレクトリーが置かれているファイル・システムに読み書き可能な共有設定を行い、このリソースにアクセス可能なユーザー ID とパスワードを用意します。各OS ごとの設定方法に関しては、IBM Smart Business Developers' Kit Information Center の前提条件の記述を参照してください。
「.nsf」や「.ntf」以外のファイルで、同時にパッケージングする必要のあるファイルが別途存在する場合には、同様にして対象となるファイルへのアクセスが可能であることを確認してください。
参考:開発者キットを使用したパッケージングを行う際に問題が発生した場合、開発者キットのログ・ファイルを参照することにより問題が解決する場合があります。このログ・ファイルは開発者キットのインストール・ディレクトリーの下にSolutionEnabler\workspace\.metadata\.log として作成されます。
ステップ2:パッケージング
Lotus Domino サーバーへのアクセスが確認できたら、実際のパッケージング作業に入ります。ここからの説明では、サンプルとして Lotus Notes/Domino 8.0 に標準で用意されているディスカッション・テンプレートを基に作成した Lotus Domino アプリケーション、discussion.nsf を用います。このアプリケーションは Lotus Domino サーバーのデータ・ディレクトリーにあらかじめ作成されており、いくつかの文書がその中に既に作成されているものとします。
開発者キットのメニューより、「File」 > 「New」 > 「IBM Smart Business Project」を選択して、新規プロジェクトを作成します。図 1 の画面からは、最下部の「Get started with a New IBM Smart Business Project」をクリックすることでも、プロジェクトの作成を開始できます。プロジェクトの作成を開始すると作成ウイザードが起動します (図 2)。
図 2. IBM Smart Business Project Wizard

「Project name」として適当な名前を入力し、パッケージングに利用する言語を 「Default language」 として選択します。「Target platforms」としては、「IBM Lotus Foundations Start V1.0」を選択します。最後に「Finish」ボタンを押してプロジェクトを作成します。プロジェクトが作成された直後は以下のような画面となります (図 3)。以後、順を追って必要な情報を入力していきます。
図 3. 作成されたプロジェクト

最初に入力するのは「Application Basics」ページです。ここでは、「Application Name」、「Version」および「Product ID」を入力します。それぞれ任意の値が入力可能ですが、「Product ID」は他のアプリケーションと重ならないものにする必要があります (図 4)。
図 4. Application Basics

次に、パッケージングする Lotus Domino アプリケーションを追加します。「Lotus Domino Component」のページで「Add a new Domino component」をクリックします (図 5)。
図 5. Lotus Domino Component

表示されたパネルで、追加する Lotus Domino アプリケーションの名前を入力します (図 6)。
図 6. Lotus Domino アプリケーション名の入力

“OK” ボタンを押すと、Lotus Domino サーバーの情報入力画面となります (図 7)。Lotus Domino サーバーが開発者キットと同じ PC 上に存在する場合には「Local computer」を選択します。サーバーが異なる PC 上に存在する場合には「Remote computer」を選択した上で、その PC をリモート・アクセスするための情報を入力します。リモート・アクセスに必要な情報はサーバーのホスト名および管理者のユーザー ID とパスワードになります。これらを入力した後に「Browse」ボタンを押すと、選択したサーバーのファイル一覧が表示されます。その中から、Lotus Domino サーバーの notes.ini ファイルが置かれているディレクトリーを選択してください。
図 7. Lotus Domino サーバー情報の入力

すべての情報を入力した後に「Next」ボタンを押すと、開発者キットは notes.ini より Lotus Domino サーバーの情報を読み出し、サーバー上に存在するすべての Lotus Domino アプリケーションをリストします (図 8)。その中からパッケージング対象のアプリケーションを選択します。その際には、アプリケーションに含まれる文書データも同時にパッケージングするかどうかも設定します。アプリケーションは同時に複数を選択することが可能です。複数個を選択した際にはインストールする順番も指定します。「.ntf」タイプのアプリケーションを選択した場合には、そのアプリケーションをテンプレートとしてインストールするように指定することもできます。また必要に応じて、インストール後に Lotus Domino サーバーを再起動するオプションを指定することも可能です。
図 8. Lotus Domino サーバー上の Lotus Domino アプリケーション

「Next」ボタンを押すと、選択した Lotus Domino アプリケーション・ファイルがプロジェクト内にコピーされた後、個々のアプリケーションの構成を行うためのパネルが表示されます。 (図 9)。
「File name」には、Lotus Foundations サーバー上にインストールする際のファイル名を相対パスで入力します。更に、インストールした後の ACL に設定するアクセス制御の情報も定義します。これら以外のオプションとして、
- 全文検索を行うための索引をインストール時に作成する
- インストールするアプリケーションがメールを受け取るタイプのアプリケーションの場合に、そのメールを受け取るために利用するメールボックスに関する情報を入力する
- インストール時に特別な設定が必要な場合、その設定を行うためのエージェントを選択する
- インストールが行われた際にシステム管理者に送られるメールの内容を選択する
などの設定も必要に応じて行います。これらを入力後、最後に「Next」ボタンを押します。
図 9. Lotus Domino アプリケーションの構成

次のパネルでは、インストールするアプリケーションが特定のサーバー・タスクの動作を前提としている場合に、そのタスクを有効にするための設定を行います (図 10)。有効にする必要のあるサーバー・タスクを選択後、「Next」ボタンを押します。
図 10. サーバー・タスクの設定

次のパネルでは、「.nsf」や「.ntf」以外で追加インストールする必要のあるファイルを設定します (図 11)。設定可能なファイルは、Lotus Domino サーバーのデータ・ディレクトリーにコピーするファイルと、Linuxネイティブな実行ファイルの2種類です。すべての必要なファイルを追加した後、「Next」ボタンを押します。
図 11. 追加ファイルの指定1

最後のパネルでは、その他一般の追加ファイルを設定します (図 12)。インストールするファイルを追加した後、Lotus Foundations サーバー上のどこにコピーするのかを指定します。最後に「Finish」ボタンを押して、Lotus Domino アプリケーションの追加を完了します。
図 12. 追加ファイルの指定2

3つめの入力ページは「Application Installation」です (図 13)。ここでは、コンポーネントをインストールする際の順序、ライセンス情報と readme 情報を指定します。
図 13. Application Installation

以上で、パッケージングに必要なすべての情報の入力が完了しました。
ステップ3:テスト
入力したアプリケーション情報に基づき行われるパッケージングが正しいことを、実際に Lotus Foundations サーバーにパッケージを転送してインストールを行い確認します。「Test Deployment」ページにある「Test Deployment」をクリックします (図 14)。
図 14. Test Deployment

テストを行う Lotus Foundations サーバーの情報を入力するパネルが表示されます (図 15)。Lotus Foundations サーバーのホスト名、インストールのテストを行うためのユーザー ID とパスワードを入力して「Finish」ボタンを押します。これにより、作成したインストール・パッケージが Lotus Foundations サーバーにコピーされ、インストール可能な状態になります。
図 15. Lotus Foundations サーバーの情報入力

この際の注意点として、インストールのテストを行うユーザー ID は「autoinstall」のチームに属していなければいけません。Lotus Foundations のユーザー ID およびチーム属性の設定に関しては、Web ブラウザーを利用してアクセスする Lotus Foundation の Web 設定の画面より、「ユーザ」を選択して確認、設定することができます (図 16)。なお、標準構成のままの Lotus Foundation の root ユーザーは、autoinstall チームに追加するだけではインストールのテストに利用することはできません。SSH によるアクセスを有効にする設定が追加で必要となります。この設定に関する詳細は、こちらのオンライン・ヘルプを参照してください。
図 16. Lotus Foundations のユーザー ID

インストール・パッケージが正しくコピーされると、Web 設定の「ソフトウェア更新」の画面に、「インストール可能なアドオンパッケージ」として表示されるようになりますので、実施にインストールを行ってその動作を確認します (図 17)。
図 17. インストール可能なアドオンとしてリストされたパッケージ

ステップ4:配布
最後に、完成したパッケージを配布可能な ZIP ファイルの形式に書き出します。「Application Packaging」ページの「Export the final package」をクリックします (図 18)。出力先の情報を求められますので、パッケージ・ファイルを出力するディレクトリーを指定します。
図 18. インストール・パッケージのエクスポート

以上で、Lotus Foundations 用Lotus Domino アプリケーションのパッケージングが完了しました。作成した ZIP ファイルの中にはインストールに必要なすべてのファイルが含まれています。これを展開した後、通常のアドオンパッケージの配布手順に従いターゲットの Lotus Foundations の保管用ディレクトリーにコピーします。これにより、Web 設定画面からインストール可能となります。
まとめ
本稿では、既に Lotus Domino サーバー上で動作している Lotus Domino アプリケーションを、Lotus Foundations 用インストール・パッケージにパッケージングする方法を解説しました。IBM Smart Business Developers' Kit を利用することにより、手動で必要なファイルを集めることなく、自動で簡単にパッケージングおよびそのテストを行うことが可能です。
参考文献
著者について  | |  | 祖父江 達也は日本アイ・ビー・エムのソフトウェア開発研究所に勤務。日本アイ・ビー・エムに入社後、長らくOS/2関連の仕事に関わり、その後はさまざまな製品の開発やお客様案件を経て、現在はIBM Lotus Notes や IBM Lotus Connections、IBM Lotus Quickr といった、各種 IBM Lotus 製品の技術支援を行なっています。先日、国際宇宙ステーションを目視で観測することができました。夕空の天頂付近をすーっと移動してゆく様子は、ちょっと感動的でした。 |
記事の評価
|