addToKit を使用して Notes® インストールキットに新規フィーチャーを追加する (Macintosh)

Notes® クライアントを Macintosh にインストールする場合、Notes® をインストールまたはアップグレードする前に addToKit ツールを使用して新規の署名付きフィーチャーを Notes® インストールキットに追加できます。

このタスクについて

Notes® をインストールまたはアップグレードする前に、addToKit ツールを使用して、カスタマイズされた zip 形式の更新サイトの署名付き内容 (features サブディレクトリー、plugins サブディレクトリー、site.xml ファイル) とカスタマイズされたインストールマニフェスト (install.xml) ファイルを Notes® インストールキット構造にコピーすることで、Macintosh 用の Notes® インストールキットをカスタマイズできます。必要なファイル構造と署名情報については、関連トピックを参照してください。

addToKit ツールは addToKit_Mac.pl として提供されています。

addToKit ツールは、Notes® インストールキットと一緒に利用できる Apps ディレクトリツールキットの一部です。

zip 形式の更新サイトディレクトリーの内容を更新した後、これらのディレクトリーを Notes® インストールキット構造と同じレベルに配置し、addToKit ツールを使用してインストールキットの構造内にソースファイルをコピーします。

addToKit ツールを使用する前に、次のタスクを実行します。

  • Notes® インストールキットに追加するすべての新しい Eclipse フィーチャーを作成し、署名します。
  • 更新サイトの features と plugins サブディレクトリ (updateSite.zip\featuresupdateSite.zip\plugins) に新しいフィーチャーとプラグインの JAR ファイルを配置します。
  • 新しい site.xml サイトマニフェストファイル (updateSite.zip\site.xml) を作成し、検証します。
  • deploy ディレクトリーに新しい install.xml インストールマニフェスト (deploy\install.xml) を作成し、検証します。

addToKit ツールの使用時には、次の点に注意してください。

  • addToKit ツールには検証機能がないため、XML が検証済みであること、および「installfeature」ID 属性値が一意であることを必ず確認してください。
  • addtoKit ツールは、引数を指定しても、しなくても実行できます。
  • addTokitPath には、deploy ディレクトリーと、Notes® インストールキットのフォーマットに一致する zip 形式の updateSite ディレクトリーが含まれている必要があります。
  • updatesSite.zip\site.xmldeploy\install.xml の情報は、addTokitPath から destKit パスにマージされ、プラグインとフィーチャーは上書きコピーされます。addTokitPath 内のファイルは、既存のキットに追加されます。具体的には、宛先 site.xml ファイルと install.xml ファイルに追加されます。
  • 引数なしでこのツールを実行すると、ファイルは一時ディレクトリーにコピーされます。コマンドラインでソースパス .\addTokitPath を指定しなかった場合、デフォルトのソースパスは .\addToKit です。宛先パス destKit を指定しなかった場合、デフォルトの宛先パスは現在の作業ディレクトリーです。.\addToKit の値は、デフォルトのソースパスにする必要があります。
  • このツールを実行する前に、署名付きのフィーチャーとプラグインを更新サイトディレクトリーに正しく配置し、適切なディレクトリー内の site.xml ファイルと install.xml ファイルを更新します。更新サイトディレクトリーを zip 形式で圧縮します。

手順

  1. ファイルが存在する一時ディレクトリーに addToKit.zip を解凍します (たとえば、c:\temp\notes8abx.mac)。この zip ファイルには addToKit というディレクトリーが含まれており、このディレクトリーには zip 形式の更新サイトディレクトリ (updateSite.zip) とデプロイディレクトリ (deploy) が含まれています。
  2. addToKit_Mac.pl を同じ一時ディレクトリーにコピーします。
  3. 次のコマンドラインを使用してツールを実行します。
    sudo perl addToKit_Mac.pl [-dhnV] kitPath installPath

    このコマンドは kitPath の情報を installPath にマージします。

    kitPath は、サードパーティの updateSite.zipsite.xml が含まれているフォルダを示します。デフォルトでは「addToKit」です。

    installPathNotes® インストールのメタパッケージを示します。デフォルトでは HCL Notes Installer.mpkg です。

    コマンドラインのパラメーターは次のとおりです。
    sudo perl addToKit_Mac.pl -h
    • -d Turns debugging on
    • -h Prints command line option usage
    • -n Runs the utility as a dry run
    • -V Prints version information