5.18 Connectors for ECM の設定

Connector for IBM FileNet を LiveCycle ソリューションの一部としてインストールした場合は、FileNet オブジェクトストアに接続するように、このサービスを設定する必要があります。

FileNet 4.0、4.5 または FileNet 5.0 を使用して Connector for IBM FileNet サービスを設定するには、次の手順を実行します。

    5.18.1 FileNet 4.0、4.5 または 5.0 および CEWS トランスポートを使用してコネクタを設定する

    1. （JBoss 4.2.1）アプリケーションサーバーの実行ファイル [JBoss root]/bin/run.bat をテキストエディターで開きます。

      （JBoss 5.1）アプリケーションサーバーの実行ファイル [JBoss root]/bin/run.conf.bat をテキストエディターで開きます。

    2. FileNet 設定ファイルの場所を、アプリケーションサーバーの start コマンドに Java オプションとして追加し、ファイルを保存します。

      注意： JBoss がサービスとして実行されている場合、他の JVM 引数が定義されているレジストリに、Java オプションを追加します。
    3. -Dwasp.location= <configuration files location>

      例えば、デフォルトの FileNet Application Engine インストールを Windows オペレーティングシステムで使用する場合、次の Java オプションを追加します。 

      -Dwasp.location=C:/Progra~1/FileNet/AE/CE_API/wsi

    4. デプロイメントで Process Engine Connector サービスを使用している場合は、[JBoss root]¥client¥logkit.jar を次のディレクトリにコピーします。

      • [JBoss root]/server/lc_turnkey/lib

    5. [JBoss root]/bin フォルダーにある adobe-component-ext.properties ファイルを開きます（ファイルが存在しない場合は、ファイルを作成します）。

    6. 次の FileNet Application Engine JAR ファイルの場所を指定する、新しいシステムプロパティを追加します。

      FileNet 4.x の場合、次の JAR ファイルを追加します。

      • javaapi.jar

      • soap.jar

      • wasp.jar

      • builtin_serialization.jar（FileNet 4.0 のみ）

      • wsdl_api.jar

      • jaxm.jar

      • jaxrpc.jar

      • saaj.jar

      • jetty.jar

      • runner.jar

      • p8cjares.jar

      • Jace.jar

      • （オプション）pe.jar

      FileNet 5.0 の場合、次の JAR ファイルを追加します。

      • Jace.jar

      • javaapi.jar

      • log4j.jar

      • mailapi.jar

      • pe.jar

      • stax-api.jar

      • xlxpScanner.jar

      • xlxpScannerUtils.jar

      • xml.jar

      注意： pe.jar ファイルは、デプロイメントで IBMFileNetProcessEngineConnector サービスを使用する場合にのみ追加します。新しいシステムプロパティには、次の構造を反映させる必要があります。
      [component id].ext=[JAR files and/or folders]
      注意： プロパティファイルの既存のコンテンツを上書きしないでください。コンテンツに新しいシステムプロパティを追加します。

      例えば、デフォルトの FileNet Application Engine インストールを Windows オペレーティングシステムで使用する場合、次のシステムプロパティをファイルに追加します。その際、システムプロパティは新しい行に記述し、行中に改行を入れず、末尾で改行してください。

      注意： 次のテキストには、改行が含まれています。このテキストを、このドキュメント以外の場所にコピーする場合は、新しい場所に貼り付けるときに改行を削除してください。
      注意： FileNet 4.x の場合、次のファイルを追加します。
      com.adobe.livecycle.ConnectorforIBMFileNet.ext= 
C:/Program Files/FileNet/AE/CE_API/lib2/javaapi.jar, 
C:/Program Files/FileNet/AE/Workplace/WEB-INF/lib/soap.jar, 
C:/Program Files/FileNet/AE/CE_API/wsi/lib/wasp.jar, 
C:/Program Files/FileNet/AE/CE_API/wsi/lib/builtin_serialization.jar, 
C:/Program Files/FileNet/AE/CE_API/wsi/lib/wsdl_api.jar, 
C:/Program Files/FileNet/AE/CE_API/wsi/lib/jaxm.jar, 
C:/Program Files/FileNet/AE/CE_API/wsi/lib/jaxrpc.jar, 
C:/Program Files/FileNet/AE/CE_API/wsi/lib/saaj.jar, 
C:/Program Files/FileNet/AE/CE_API/wsi/lib/jetty.jar, 
C:/Program Files/FileNet/AE/CE_API/wsi/lib/runner.jar, 
C:/Program Files/FileNet/AE/CE_API/lib2/p8cjares.jar, 
C:/Program Files/FileNet/AE/CE_API/lib/Jace.jar, 
C:/Program Files/FileNet/AE/Workplace/WEB-INF/lib/pe.jar
      注意： C:¥Program Files¥FileNet¥AE¥Workplace¥WEB-INF¥lib¥pe.jar は、実際のデプロイメントで IBMFileNetProcessEngineConnector サービスを使用している場合にのみ追加します。
      注意： FileNet 4.5 の場合は、C:¥Program Files¥FileNet¥AE¥CE_API¥wsi¥lib¥builtin_serialization.jar, の行を削除します。
      注意： FileNet 5.0 の場合、次の JAR ファイルを追加します。
      C:/Program Files/FileNet/AE/CE_API/lib/Jace.jar, 
C:/Program Files/FileNet/AE/CE_API/lib2/javaapi.jar, 
C:/Program Files/FileNet/AE/CE_API/lib2/log4j.jar, 
C:/Program Files/FileNet/AE/Router/lib/mailapi.jar, 
C:/Program Files/FileNet/AE/Workplace/WEB-INF/lib/pe.jar, 
C:/Program Files/FileNet/AE/CE_API/lib/stax-api.jar, 
C:/Program Files/FileNet/AE/CE_API/lib/xlxpScanner.jar, 
C:/Program Files/FileNet/AE/CE_API/lib/xlxpScannerUtils.jar, 
C:/Program Files/FileNet/AE/Router/java/jre/lib/xml.jar

    7. （FileNet Process Engine Connector のみ）次の手順で、プロセスエンジンの接続プロパティを設定します。

      • テキストエディターを使用してファイルを作成し、次のコンテンツを 1 行で入力します。末尾で改行してください。 

        RemoteServerUrl = cemp:http://[contentserver_IP]:[contentengine_port]/ 
wsi/FNCEWS40DIME/

      • このファイルを WcmApiConfig.properties という名前で別のフォルダーに保存して、そのフォルダーの場所を adobe-component-ext.properties ファイルに追加します。

        例えば、このファイルを c:¥pe_config¥WcmApiConfig.properties として保存して、パス c:¥pe_config を adobe-component-ext.properties ファイルに追加します。

      注意： ファイル名では大文字と小文字が区別されます。

    8. 次のフォルダーで login-config.xml ファイルを探し、次のアプリケーションポリシーを <policy> ノードの子として追加します。

      • [JBoss root]/server/lc_turnkey/conf 

      <application-policy name = "FileNetP8WSI"> 
     <authentication>  
     <login-module code = "com.filenet.api.util.WSILoginModule" flag = 
    "required" /> 
     </authentication>  
</application-policy>

    9. （FileNet Process Engine Connector のみ）実際のデプロイメントでプロセスエンジンを使用している場合は、次のノードを login-config ファイルに追加します。

      <application-policy name = "FileNetP8"> 
    <authentication> 
        <login-module code = "com.filenet.api.util.WSILoginModule" flag = 
        "required" /> 
    </authentication> 
</application-policy>

    10. アプリケーションサーバーが現在実行されていない場合は、サービスを起動します実行されている場合は、サーバーを停止し、再起動します。

    11. JBoss がサービスとして実行されている場合は、JBoss for Adobe LiveCycle ES3 サービスを開始（または再開）します。

    12. Web ブラウザーを開き、次の URL を入力します。

      http://[host]:[port]/adminui

    13. 次のデフォルトのユーザー名とパスワードを使用してログインします。

      ユーザー名：administrator

      パスワード：password

    14. サービス／Connector for IBM FileNet をクリックします。

    15. 必要なすべての FileNet リポジトリ情報を入力し、「リポジトリサービスプロバイダー」の下で「IBM FileNet リポジトリプロバイダー」を選択します。

      オプションのプロセスエンジンサービスをデプロイメントで使用する場合、「プロセスエンジン設定」領域で「プロセスエンジンコネクタサービスを使用」を選択し、プロセスエンジンの各設定を指定します。詳しくは、ページの右上隅にある「ヘルプ」リンクをクリックします。

      注意： この手順で指定する資格情報は、IBM FileNet リポジトリサービスを後で起動するときに検証されます。資格情報が無効な場合はエラーが発生し、サービスは起動されません。

    16. 「保存」をクリックし、サービス／アプリケーションおよびサービス／サービスの管理に移動します。

    17. IBMFileNetProcessEngineConnector（設定されている場合）の横のチェックボックスを選択して、「開始」をクリックします。

    18. 次の各サービスの横にあるチェックボックスを選択して「開始」をクリックします。

      • IBMFileNetAuthProviderService

      • IBMFileNetContentRepositoryConnector

      • IBMFileNetRepositoryProvider

      • IBMFileNetProcessEngineConnector（設定されている場合）

      サービスのいずれかが正常に開始しない場合は、手順 15 で入力した設定を確認します。

    19. 次のいずれかの操作を行います。

      • FileNet Authorization サービス（IBMFileNetAuthProviderService）を使用して Workbench の Resources ビューで FileNet オブジェクトストアからコンテンツを表示するには、この手順を続行します。FileNet Authorization サービスを使用すると、デフォルトの LiveCycle 認証が上書きされるので、FileNet の資格情報を使用して Workbench にログインするように設定する必要があります。

      • LiveCycle リポジトリを使用するには、LiveCycle の上級管理者の資格情報（デフォルトは Administrator と password）を使用して Workbench にログインします。この場合、手順 15 で指定した資格情報は、デフォルトリポジトリにアクセスするためにデフォルトの LiveCycle 認証サービスを使用します。

    20. 次のタスクを実行して、リモートおよび EJB のエンドポイントを有効にします。

      • Administration Console にログインして、ホーム／サービス／アプリケーションおよびサービス／サービスの管理を選択します。

      • Connector for IBM FileNet カテゴリをフィルタリングして、「IBMFileNetContentRepositoryConnector:1.0」をクリックします。

      • 無効になっているエンドポイントを選択して有効にします。

    21. アプリケーションサーバーを再起動します。

    22. Administration Console にログインし、設定／User Management／ドメインの管理をクリックします。

    23. 「新規エンタープライズドメイン」をクリックして、ドメイン ID と名前を入力します。ドメイン ID は、ドメインの一意の識別子です。名前は、ドメインの識別名です。

      注意： LiveCycle データベースとして MySQL を使用している場合、ID には 1 バイト（ASCII）文字のみを使用してください（LiveCycle の管理ヘルプの「エンタープライズドメインの追加」を参照）。

    24. カスタム認証プロバイダーを追加します。

      • 「認証を追加」をクリックします。

      • 「認証プロバイダー」リストで「カスタム」を選択します。

      • 「IBMFileNetAuthProviderService」を選択し、「OK」をクリックします。

    25. LDAP 認証プロバイダーを追加します。

      • 「認証を追加」をクリックします。

      • 「認証プロバイダー」リストで「LDAP」を選択し、「OK」をクリックします。

    26. LDAP ディレクトリを追加します。

      • 「ディレクトリを追加」をクリックし、「プロファイル名」ボックスに一意の名前を入力して、「次へ」をクリックします。

      • 「サーバー」、「ポート」、「SSL」、「バインド」および「ページに次の情報を入力」オプションの値を指定します。「バインド」オプションで「ユーザー」を選択する場合は、「名前」と「パスワード」フィールドにも値を指定する必要があります。

      • （オプション）必要に応じてベースドメイン名を取得するには、「BaseDN を取得」を選択します。完了したら、「次へ」をクリックします。

      • ユーザー設定を指定し、「次へ」をクリックし、必要に応じてグループ設定を指定して「次へ」をクリックします。

        設定について詳しくは、ページの右上隅にある「ヘルプ」リンクをクリックしてください。

    27. 「OK」をクリックして「ディレクトリを追加」ページを閉じ、もう一度「OK」をクリックします。

    28. 新しいエンタープライズドメインを選択し、「今すぐ同期」をクリックします。LDAP ネットワークのユーザーとグループ数および接続の速度によって、同期処理には数分かかる場合があります。

      （オプション）同期のステータスを確認するには、「更新」をクリックし、「現在の同期の状態」列にステータスを表示します。

    29. 設定／User Management／ユーザーとグループをクリックします。

    30. LDAP から同期されたユーザーを検索し、以下のタスクを実行します。

      • 1 つ以上のユーザーを選択し、「ロールをアサイン」をクリックします。

      • 1 つ以上の LiveCycle のロールを選択し、「OK」をクリックします。

      • 「OK」をもう一度クリックして、ロールアサインを確認します。

      ロールをアサインするすべてのユーザーについて、この手順を繰り返します。詳しくは、ページの右上隅にある「ヘルプ」リンクをクリックします。

    31. Workbench を起動して、IBM FileNet リポジトリ用の次の資格情報を使用してログインします。

      ユーザー名：[username]@[repository_name]

      パスワード：[password]

      これで、FileNet オブジェクトストアが Workbench の Resources ビューに表示されます。username@repository name を使用してログインしない場合、Workbench では、手順 15 で指定したデフォルトリポジトリへのログインが試行されます。

    32. （オプション）Connector for IBM FileNet の LiveCycle サンプルをインストールする場合、Samples という名前の FileNet オブジェクトストアを作成してその中にインストールします。

    Connector for IBM FileNet サービスを設定したら、LiveCycle 管理ヘルプを参照することをお勧めします。FileNet リポジトリを使用した Workbench の機能の設定について、Document Services 管理ヘルプを参照することをお勧めします。