Configure and use the Documentum connector in SharePoint Server
適用対象:2016 2019 Subscription Edition SharePoint in Microsoft 365
この記事では、Documentum 用の Microsoft SharePoint Server Indexing Connector をインストールして構成する方法について説明します。
Microsoft SharePoint Server Indexing Connector for Documentum を使用すると、EMC Documentum システムに格納されているコンテンツのインデックスを作成できます。 この記事では、SharePoint Server で使用するために Indexing Connector for Documentum をインストールして構成する方法について説明します。
Indexing Connector for Documentum
SharePoint Server Search Connector Framework に基づく 64 ビット コネクタです。
複数のバージョンの EMC Documentum Content Server をサポートします。
Documentum オブジェクトとオブジェクト メタデータにインデックスを設定します。 「SharePoint Server でサポートされている Documentum オブジェクトの種類とプロパティ」を参照してください。
Documentum セキュリティの定義とポリシーをサポートしています。
自動構成と管理のための Microsoft PowerShell をサポートします。 「SPEnterpriseSearchDCTMConnectorConfig コマンドレットの使用」を参照してください。
複数の Documentum クライアント アプリケーションをサポートするために構成可能な検索結果 URL があります。
クロール用のファイルとフォルダーの除外をサポートしています。
開始する前に
この操作を開始する前に、システムの前提条件と要件に関する以下の情報を確認してください。
サポートされているオペレーティング システムは、Windows Server 2008 R2、Windows Server 2008 Service Pack 2、Windows Server 2012 です。
次のいずれかの SharePoint 2019、SharePoint 2016、または SharePoint 2013 製品がインストールされ、構成されています。
Microsoft SharePoint Server Enterprise
Microsoft SharePoint Server Standard
Search Service Application をインストールして構成しておく必要があります。
DFS Productivity Layer 6.7 SP2 と互換性がある Documentum Foundation Services (DFS) Server バージョンを、Windows ホスト上にインストールしておく必要があります。
DFS Productivity Layer 6.7 SP2 をインストールし、DFS Productivity Layer 6.7 SP2 に入っている .NET アセンブリに対するアクセス権限がなければなりません。 Indexing Connector for Documentum は DFS を、 Documentum リポジトリにアクセスするための接続 API として使用します。
Documentum Content Server をインストールしておく必要があります。 サポート対象の Documentum Content Server バージョンは DFS 6.7 SP2 によって判別されます。 詳細なリストは、DFS Productivity Layer 6.7 SP2 リリース ノートに記されています。
Documentum Trusted Content Services (TCS) が有効にされている Documentum リポジトリをクロールするに必要がある場合、Indexing Connector for Documentum に -ACLTranslation "Claims" を指定して構成します。 また、このコネクタ構成を使用して、リポジトリで TCS が有効になっているかどうかに関係なく、Windows Active Directory ユーザーと Documentum ユーザーの間の自動マッピングを有効にできます。
概要
次の手順では、SharePoint Server で使用するために Indexing Connector for Documentum をインストールして構成するために必要なタスクの概要を示します。
1. 準備
システムが、「はじめに」というセクションに記載されているシステムの前提条件と要件を満たしていることを確認してください。
Microsoft ダウンロード センターから SharePoint Server 2016 Indexing Connector for Documentum をダウンロードします。
クロール コンポーネントをホストする SharePoint サーバーを準備します。 それぞれのサーバーで次の操作を行います。
machine.config ファイルを編集して、Documentum のバインディングを設定します。
2. Documentum のインデックス作成コネクタをインストールする
クロール コンポーネントをホストするファーム内の各 SharePoint サーバーに、Indexing Connector for Documentum をインストールします。
Microsoft PowerShell を使用して、Indexing Connector for Documentum を Search サービス アプリケーションに登録します。
3. Documentum のインデックス作成コネクタを構成する
Documentum PowerShell コマンドレットのインデックス作成コネクタを使用して、クロール コンポーネントをホストするファーム内の各 SharePoint サーバーで Documentum 用のインデックス作成コネクタを構成します。 次のいずれかの構成を選択してください。
構成 | ACL 変換 | 説明 | 参照セクション |
---|---|---|---|
自動ユーザー マッピングを使用した EMC Documentum Trusted Content Services (TCS) コンテンツまたは正規 Documentum コンテンツのクロールをサポートします。 | Claims | 自動ユーザー マッピングを有効するには、Security Trimmer Sync Service、およびプリ トリマーとポスト トリマーを個別に構成します。 | TCS と自動ユーザー マッピングをサポートするための Indexing Connector for Documentum の構成 |
Documentum コンテンツのクロールをサポートし、手動で作成されたユーザー マッピング テーブルを使用します。 | UserMappingTable | SQL Server でユーザー マッピング テーブルを手動で作成し、Documentum ユーザーと、Active Directory ドメイン サービス (AD DS) または Active Directory サービスのユーザーとの間のマッピングを指定します。 コネクタを構成するには、Microsoft PowerShell を使用してユーザー マッピング テーブルを作成したデータベースを指定します。 | ユーザー マッピング テーブルを使用した Indexing Connector for Documentum の構成 |
Documentum と Windows のユーザー アカウントが同じ場合に、Documentum コンテンツのクロールをサポートします。 | SameAccountName | Indexing Connector for Documentum では、Documentum ユーザーと SharePoint ユーザーが同じアカウント (Active Directory の共有アカウントなど) を共有すると想定します。 無効なアカウントが検出されると、Indexing Connector for Documentum はアカウント権限を破棄します。 | SPEnterpriseSearchDCTMConnectorConfig コマンドレットの使用 |
検索結果に対してセキュリティによるトリミングを行うことなく、Documentum コンテンツのクロールをサポートします。 | NoSecurity | すべてのユーザーが、Documentum 検索結果すべてを表示できるようになります。 たとえばこれは、すべてのユーザーがアクセス可能な Documentum 公開リポジトリがある場合に役立ちます。 | SPEnterpriseSearchDCTMConnectorConfig コマンドレットの使用 |
4. サーバーの全体管理を使用して、Search サービス アプリケーションで Documentum クロール ルールとコンテンツ ソースを構成する
フル クロールを実行します。
クロール コンポーネントをホストする SharePoint サーバーを準備する
クロールに使用する Documentum コンテンツ アクセス アカウントを決める
構成手順で後ほどクロール ルールを設定するときに、Documentum コンテンツ アクセス アカウントとパスワードを指定する必要があります。 Indexing Connector for Documentum では、このコンテンツ アクセス アカウントを使用して Documentum リポジトリからコンテンツを取得します。 このアカウントには、次の最小権限がなければなりません。
- クロールするドキュメントに対する読み取り権限。
- クロールするキャビネット、フォルダー、レコード (メタデータが含まれるドキュメントのみ) に対する参照権限。
DFS Productivity Layer の .NET アセンブリを設定する
次の DFS Productivity Layer の .NET アセンブリを探し、すべてのファイルのバージョン番号が 6.7.2000.36 であることを確認します。 既定のパスに抽出された場合、これらのファイルは
%local%\emc-dfs-sdk-6.7\emc-dfs-sdk-6.7\lib\dotnet
ディレクトリにあります。Emc.Documentum.FS.DataModel.Core.dll
Emc.Documentum.FS.DataModel.Shared.dll
Emc.Documentum.FS.runtime.dll
Emc.Documentum.FS.Services.Core.dll
クロール コンポーネントをホストする各サーバーで、そのサーバー上の Administrators グループのメンバーであるアカウントでログオンし、DFS Productivity Layer .NET アセンブリをグローバル アセンブリ キャッシュ
%windir%\assembly
に展開します。注:
これら 4 つの DLL はドラッグ アンド ドロップでグローバル アセンブリ キャッシュ (
%windir%\assembly
) に配置できますが、そのためにはユーザー アカウント制御を無効にしなければならない場合があります。
次の手順では、クロール コンポーネントをホストする各 SharePoint サーバー上の machine.config ファイルを編集して、DFS Productivity Layer の WCF 設定を含める方法について説明します。 このためには、DFS Productivity Layer の .NET アセンブリが正しく機能していることを確認しなければなりません。
machine.config ファイルを編集するで設定する WSF 設定では、1 つの Documentum コンテンツ オブジェクト (ドキュメント ファイルとそのメタデータ) につき最大で 30 メガバイト(MB) まで転送することが許可されています。 より大きなコンテンツに関しては、管理者は DfsDefaultService バインディングの maxReceivedMessageSize を増やすことができます。
machine.config ファイルを編集する
クロール コンポーネントをホストする各サーバーで、machine.config ファイルを開きます。 このファイルは、ディレクトリ
%windir%\Microsoft.NET\Framework64\v4.0.30319\Config
にあります。次の XML スニペットを <configuration> 要素にコピーします。
<system.serviceModel> <bindings> <basicHttpBinding> <binding name="DfsAgentService" closeTimeout="00:01:00" openTimeout="00:01:00" receiveTimeout="00:10:00" sendTimeout="00:01:00" allowCookies="false" bypassProxyOnLocal="false" hostNameComparisonMode="StrongWildcard" maxBufferSize="10000000" maxBufferPoolSize="10000000" maxReceivedMessageSize="10000000" messageEncoding="Text" textEncoding="utf-8" transferMode="Buffered" useDefaultWebProxy="true"> <readerQuotas maxDepth="32" maxStringContentLength="8192" maxArrayLength="16384" maxBytesPerRead="4096" maxNameTableCharCount="16384" /> <security mode="None"> <transport clientCredentialType="None" proxyCredentialType="None" realm="" /> <message clientCredentialType="UserName" algorithmSuite="Default" /> </security> </binding> <binding name="DfsContextRegistryService" closeTimeout="00:01:00" openTimeout="00:01:00" receiveTimeout="00:10:00" sendTimeout="00:01:00" allowCookies="false" bypassProxyOnLocal="false" hostNameComparisonMode="StrongWildcard" maxBufferSize="10000000" maxBufferPoolSize="10000000" maxReceivedMessageSize="10000000" messageEncoding="Text" textEncoding="utf-8" transferMode="Buffered" useDefaultWebProxy="true"> <readerQuotas maxDepth="32" maxStringContentLength="8192" maxArrayLength="16384" maxBytesPerRead="4096" maxNameTableCharCount="16384" /> <security mode="None"> <transport clientCredentialType="None" proxyCredentialType="None" realm="" /> <message clientCredentialType="UserName" algorithmSuite="Default" /> </security> </binding> <binding name="DfsDefaultService" closeTimeout="00:01:00" openTimeout="00:10:00" receiveTimeout="00:20:00" sendTimeout="00:10:00" allowCookies="false" bypassProxyOnLocal="false" hostNameComparisonMode="StrongWildcard" maxBufferSize="10000000" maxBufferPoolSize="10000000" maxReceivedMessageSize="30000000" messageEncoding="Text" textEncoding="utf-8" transferMode="StreamedResponse" useDefaultWebProxy="true"> <readerQuotas maxDepth="32" maxStringContentLength="8192" maxArrayLength="16384" maxBytesPerRead="1048576" maxNameTableCharCount="16384"/> <security mode="None"> <transport clientCredentialType="None" proxyCredentialType="None" realm=""/> <message clientCredentialType="UserName" algorithmSuite="Default"/> </security> </binding> </basicHttpBinding> </bindings> </system.serviceModel>
Indexing Connector for Documentum のインストールと登録
Indexing Connector for Documentum をインストールする
Indexing Connector for Documentum を Microsoft ダウンロード センター からダウンロードします。
クロール コンポーネントをホストするファーム内の各サーバーで、ファイル
DCTMIndexConn.exe
を実行して Indexing Connector for Documentum をインストールします。 インストール ウィザードの手順を実行します。
Indexing Connector for Documentum を Search Service Application に登録する
クロール コンポーネントをホストする SharePoint サーバーで次の手順を実行して、コネクタを Search サービス アプリケーションに登録します。
SharePoint 管理シェルを開始します。
Microsoft PowerShell コマンド プロンプトで、次のコマンドを入力します。
New-SPEnterpriseSearchCrawlCustomConnector -SearchApplication "<name of your Search service application>" -Protocol "dctm" -ModelFilePath "<%CommonProgramFiles%\Microsoft Shared\Web Server Extensions\15\CONFIG\SearchConnectors\Documentum\MODEL.xml>" -Name "Microsoft SharePoint 2016 Indexing Connector for Documentum"
ここで、
<name of your Search service application> は、コネクタを登録する Search Service Application の名前です。
<%CommonProgramFiles%\Microsoft Shared\Web Server Extensions\15\CONFIG\SearchConnectors\Documentum\MODEL.xml> は、Indexing Connector for Documentum モデル ファイルのパスです。 この例では既定の場所になっています。
Indexing Connector for Documentum の構成
Indexing Connector for Documentum PowerShell コマンドレット ( Set-SPEnterpriseSearchDCTMConnectorConfig
) を使用してコネクタ設定を構成します。 設定は %CommonProgramFiles%\Microsoft Shared\Web Server Extensions\15\CONFIG\SearchConnectors\Documentum\DCTMConfig.xml
に格納され、クロール コンポーネントをホストする各 SharePoint Server 2016 サーバーで同じである必要があります。
使用する PowerShell コマンドレット パラメーターおよび実行する必要がある追加の構成手順は、選択した構成モードによって異なります。
TCS と自動ユーザー マッピングをサポートするための Indexing Connector for Documentum の構成
次の手順は、TCS をサポートするための Indexing connector for Documentum の構成方法を示しています。 また、Security Trimmer Sync Service を構成して、カスタムのプリ セキュリティ トリマーとポスト セキュリティ トリマーを配置し、自動ユーザー マッピングを有効にする方法も示しています。 これらの手順を実行すると、Documentum ユーザー資格情報は Windows Active Directory ドメイン サービス (AD) と自動的に同期され、検索結果がそれに応じてトリミングされ、ユーザーは参照権限を持つ Documentum 検索結果だけを取得できるようになります。
セキュリティ トリマー同期サービスでは、Documentum ユーザーを AD ユーザーにマップするには、Documentum フィールドuser_os_domain、user_login_name、user_source、user_ldap_dnを確認します。 [user_ldap_dn] フィールドに値が設定されている場合、セキュリティ トリマー同期サービスは最初の DC 値からドメインを抽出しようとします。 たとえば、 user_ldap_dn フィールドに " CN=User Name、OU=Unit、DC=Domain、DC=Department、DC=Company " が設定されている場合、セキュリティ トリマー同期サービスは DC=Domain からドメインを抽出し 、DC=Department、DC=Company を無視します。
TCS と自動ユーザー マッピングをサポートするようコネクタを構成するには
クロール コンポーネントをホストする各サーバーで SharePoint 管理シェルを起動します。
Microsoft PowerShell コマンド プロンプトで、次のコマンドを入力します。
Set-SPEnterpriseSearchDCTMConnectorConfig -Shared -ACLTranslation "Claims" -DisplayURLPatternForDocument "http://<MyWebTopServer:PortOfMyWebTopServer>/webtop/component/drl?objectId={ObjectId}&format={Format}&RepositoryName={RepositoryName}" -DisplayURLPatternForContainer "http://<MyWebTopServer:PortOfMyWebTopServer>/webtop/component/drl?objectId={ObjectId}&RepositoryName={RepositoryName}" Set-SPEnterpriseSearchDCTMConnectorConfig -Repository -RepositoryName "<MyRepository1>" -DFSWebServiceURL @("http://<DFSWebServices>:<30000>/services"), ("http://<DFSWebServices2>:<30000>/services") Set-SPEnterpriseSearchDCTMConnectorConfig -Repository -RepositoryName "<MyRepository2>" -DFSWebServiceURL @("http://<DFSWebServices>:<30000>/services")
ここで、
<MyWebTopServer:PortOfMyWebTopServer> は、使用している DFS Web Top Server の名前とポート番号です。
<MyRepository n> は、クロールする Documentum リポジトリの名前です。
<DFSWebServices n>:<30000> は、クロールする Documentum リポジトリをホストする Documentum Web Services サーバーの名前とポート番号です。
OSearch15 サービスを再開します。 Documentum のコンテンツ ソースを作成する前にこれを行う必要があります。
大事な: SharePoint サーバーの全体管理 Web サイトの [サーバー上のサービス] ページを使用して、このサービスを再起動しないでください。 このページを使用すると、検索インデックスがリセットされるため、インデックスを再構築するためにすべてのコンテンツのフル クロールを実行しなければならなくなります。
この手順を実行するユーザー アカウントが、クロール コンポーネントをホストするサーバーの管理者であることを確認します。
コマンド プロンプト ウィンドウを開きます。
OSearch15 サービスを停止するには、「 net stop osearch15 」というコマンドを入力します。
OSearch15 サービスを開始するには、「 net start osearch15 」というコマンドを入力します。
Security Trimming Sync Service を設定するには
ファイル Microsoft.Office.Server.Search.Connector.Documentum.TrimmerSync.exe.config を開きます。このファイルは、Documentum コネクタ用の Indexing Connector をインストールしたフォルダーに格納されます。 既定の場所は
%CommonProgramFiles%\Microsoft Shared\Web Server Extensions\15\CONFIG\SearchConnectors\Documentum
Indexing Connector for Documentum を構成したときと同じ情報を使用して、次のように構成ファイルを編集します。
Emc.Documentum セクションの ModuleInfo 要素で、次の操作を行います。
host 属性に、Documentum サーバーのホスト名を入力します。
port 属性に、Documentum サーバーのポート番号を入力します。
Data Source: Documentum Settings セクションの Repositories 要素で、次の操作を行います。
リポジトリ ID 属性に、Documentum リポジトリ ID を入力します。
name 属性に、Documentum リポジトリの名前を入力します。
login 属性に、Documentum ログイン名を入力します。 Documentum コンテンツ アクセス アカウントと同じログイン名を使用します。 これは、Documentum Content Server で管理者特権のユーザー権限を持つユーザーでなければなりません。
dfs 属性に、DFS の URI を指定して Documentum Foundation Services (DFS) の場所を入力します。
(オプション) Documentum 接続で SSL/HTTPS が必要な場合、セキュリティ モードを変更しなければなりません。
Data Source: Documentum Settings セクションのサブセクション Documentum にある basicHttpBinding 要素で、次のバインディングのセキュリティ モード属性を None から Transport に設定します。
DfsAgentService
DfsContextRegistryService
DfsDefaultService
Data Source: Documentum Settings セクションのサブセクション Documentum にある netNamedPipeBinding 要素で、次のバインディングのセキュリティ モード属性を None から Transport に設定します。
- localNamedPipeBinding
ファイルを保存して閉じます。
DFS Productivity Layer の .NET アセンブリを、Security Trimming Sync Service を実行しているサーバーにコピーします。
次の DFS Productivity Layer の .NET アセンブリを探し、すべてのファイルのバージョン番号が 6.7.2000.36 であることを確認します。 既定のパスに抽出された場合、これらのファイルは
%local%\emc-dfs-sdk-6.7\emc-dfs-sdk-6.7\lib\dotnet
ディレクトリにあります。Emc.Documentum.FS.DataModel.Core.dll
Emc.Documentum.FS.DataModel.Shared.dll
Emc.Documentum.FS.runtime.dll
Emc.Documentum.FS.Services.Core.dll
セキュリティ トリミング同期サービスをホストするサーバーで、そのサーバー上の Administrators グループのメンバーであるアカウントでログオンし、DFS Productivity Layer .NET アセンブリをグローバル アセンブリ キャッシュ
%windir%\assembly
に展開します。
注:
これら 4 つの DLL はドラッグ アンド ドロップでグローバル アセンブリ キャッシュ (
%windir%\assembly
) に配置できますが、そのためにはユーザー アカウント制御を無効にしなければならない場合があります。Security Trimming Sync Service の認証を構成し、このサービスをインストールします。
この手順を実行するユーザー アカウントが、Farm Administrators グループのメンバーであることを確認します。
クエリ処理コンポーネントをホストする各サーバーで、コマンド プロンプト ウィンドウを開きます。
次のコマンドを入力します。 Microsoft.Office.Server.Search.Connector.Documentum.TrimmerSync.exe -p
ダイアログ ボックスを表示されたら、 login 属性に指定したアカウントのパスワードを入力します。 Documentum コンテンツ アクセス アカウントと同じログイン名を使用してください。 パスワードはすぐに自動的に暗号化され、Security Trimming Sync Service の構成ファイルに追加されます。
セキュリティ トリミング同期サービスをインストールします。 次のコマンドを入力 します:Microsoft.Office.Server.Search.Connector.Documentum.TrimmerSync.exe -i
Security Trimming Sync Service を開始します。
Windows サーバー マネージャーを開きます。
[ 構成] メニューを展開し、[ サービス] をクリックします。
[ SharePoint Documentum Security Sync] サービスを右クリックして [ プロパティ] をクリックします。 [ ログオン] タブで [ 現在のアカウント] を選択し、SharePoint サービスを実行するアカウントの詳細と資格情報を指定します。 [ OK] をクリックします。
[ SharePoint Documentum Security Sync] サービスを右クリックし、[ 開始] をクリックします。
[ 状況] 列が [ 開始済み] に変更されたことを確認します。
サービスが実行されていて、セキュリティ同期が完了したことを確認します。
コマンド Microsoft.Office.Server.Search.Connector.Documentum.TrimmerSync.exe -d を実行して、Security Trimming Sync Service のメモリをテキスト ファイルに書き出します。
Security Trimming Sync Service が Documentum サーバーに接続していることを確かめます。 ディレクトリにあるファイル DCTMSecuritySync.logを読み取ります
<Microsoft Office Server path>\15.0\Data\Office Server\Applications\Search\Nodes
Documentum サーバーからのメンバーシップ情報が、ディレクトリにあるファイル DCTMSecuritySync_Dump.txt に書き込まれることを確認します
<Microsoft Office Server path>\15.0\Data\Office Server\Applications\Search\Nodes
プリ セキュリティ トリマーおよびポスト セキュリティ トリマーを追加するには、その前に Documentum 用の簡単なクロール ルールを 1 つ追加しておく必要があります。 後ほど、クロール ルールをさらに指定したり、このクロール ルールを拡張したりできます。
Documentum の簡単なクロール ルールを作成する
この手順を実行しているユーザー アカウントが Search Service アプリケーションの管理者であることを確認します。
SharePoint サーバーの全体管理 ホーム ページの [ アプリケーション管理] セクションで、[ サービス アプリケーションの管理] をクリックします。
[サービス アプリケーションの管理] ページで、クロール ルールを作成する Search Service Application をクリックします。
[検索管理] ページの [ クロール] セクションで、[ クロール ルール] をクリックします。
[クロール ルールの管理] ページの [新しいクロール ルール] をクリックします。
[クロール ルールの追加] ページで、クロール ルールを作成するための次の情報を指定します。
[パス] ボックスに、dctm://* と入力します。
[クロールの構成] セクションで、[このパスにあるアイテムをすべて含める] を選択し、[複合 URL (疑問符 - ? が含まれる URL) をクロールする] を選択します。
[ 認証の指定] セクションで、[ 別のコンテンツ アクセス アカウントを指定する] を選択して該当するボックスに Documentum コンテンツ アクセス アカウントとパスワードを入力します。
[ 基本認証を許可しない] チェック ボックスがオフになっていることを確認します。
[OK] をクリックしてクロール ルールを追加します。
Indexing Connector for Documentum のプリ セキュリティ トリマーとポスト セキュリティ トリマーを追加するには
クエリ処理コンポーネントをホストする各サーバーで SharePoint 管理シェルを起動します。
Microsoft PowerShell コマンド プロンプトで、次のコマンドを入力します。
New-SPEnterpriseSearchSecurityTrimmer -SearchApplication <name of your Search service application> -typeName "Microsoft.Office.Server.Search.Connector.Documentum.Trimmers.DctmTrimPre, Microsoft.Office.Server.Search.Connector.Documentum.Trimmers, Version=15.0.0.0,Culture=neutral, PublicKeyToken=48e046c834625a88, processorArchitecture=MSIL" -id 26 -RulePath dctm:\\* New-SPEnterpriseSearchSecurityTrimmer -SearchApplication <name of your Search service application> -typeName "Microsoft.Office.Server.Search.Connector.Documentum.Trimmers.DctmTrimPost, Microsoft.Office.Server.Search.Connector.Documentum.Trimmers, Version=15.0.0.0,Culture=neutral, PublicKeyToken=48e046c834625a88, processorArchitecture=MSIL" -id 17 -RulePath dctm:\\*
ここで、
- <name of your Search service application> は、Search Service Application の名前です。
SharePoint Search Host Controller を再開します。
コマンド プロンプト ウィンドウを開きます。
SharePoint Search Host Controller を停止するには、 net stop spsearchhostcontroller コマンドを入力します。
SharePoint Search Host Controller を開始するには、「 net start spsearchhostcontroller 」というコマンドを入力します。
Documentum コンテンツ ソースの作成を次に行います。
ユーザー マッピング テーブルを使用した Indexing Connector for Documentum の構成
次の手順は、Documentum ユーザーを Active Directory ドメイン サービス (AD DS) または Active Directory サービスのユーザーとマッピングする方法を指定するユーザー マッピング テーブルを手動で作成する方法、および Documentum コンテンツのクロールをサポートし、ユーザー マッピング テーブルを使用するようにコネクタを構成する方法について示しています。
ユーザー マッピング テーブルは、SQL Server 2008 以降のバージョンのデータベースになければなりません。
OSearch15 サービス アカウントは、ユーザー マッピング テーブルに対して少なくとも読み取りアクセス許可を持っている必要があります。
ユーザー マッピング テーブルを作成するには
まず、SQL Server 2008 以降のバージョンでユーザー マッピング テーブルを作成します。 ユーザー マッピング テーブルは、次の形式でなければなりません。
列名 | SQL データベース | 説明 |
---|---|---|
DCTMCredentialDomain | nvarchar(255) NOT NULL | Documentum アカウントのドメイン名です。 アカウントがローカル コンピューターまたは LDAP システムから提供される場合は、この列を設定します。 Documentum アカウントの [ユーザー ソース ] プロパティは 、None または LDAP である必要があります。 それ以外の場合はこの列を空にしておきます。 |
DCTMCredentialRepository | nvarchar (32) NOT NULL | Documentum アカウントのリポジトリ名です。 アカウントが Documentum リポジトリから提供される場合は、この列を設定します。 |
DCTMCredentialLoginName | nvarchar (80) NOT NULL | Documentum アカウントのログイン名です。 |
NTCredential | nvarchar (255) NOT NULL | SharePoint Server 2016 で Documentum コンテンツを検索する Windows ドメイン ユーザー アカウント。 |
次のスクリプトを使用して、ユーザー マッピング テーブルを作成します。
CREATE TABLE <replace with your user mapping table name>
(
DCTMCredentialDomain nvarchar (255) NOT NULL ,
DCTMCredentialRepository nvarchar (32) NOT NULL ,
DCTMCredentialLoginName nvarchar (80) NOT NULL ,
NTCredential nvarchar (255) NOT NULL ,
CONSTRAINT PK_CredentialMapping PRIMARY KEY CLUSTERED
( DCTMCredentialDomain, DCTMCredentialRepository, DCTMCredentialLogonName )
)
または、SQL Server Management Studio あるいは同等のツールを使用して、ユーザー マッピング テーブルを手動で作成することもできます。 手動でこのテーブルを作成する場合、このスクリプトで定義されているのと同じスキームを使用してください。
次に、ユーザー マッピング テーブルに Documentum/Windows NT 資格情報ペアを設定します。 前述の手順に示されていた表には、予期される入力が示されています。
例:
Documentum リポジトリ ユーザーの Dan Park のログオンは、Finance リポジトリにリンクされています。 Dan の Windows ドメイン ユーザー アカウントは Contoso\dpark です。 この場合、Dan のユーザー マッピング テーブル エントリは次のようになります。
DCTMCredentialDomain | '' |
DCTMCredentialRepository | Finance |
DCTMCredentialLogonName | dpark |
NTCredential | Contoso\dpark |
注:
値が割り当てられていないセルがある場合は、 null または空にすることはできません。 次の空の文字列値を割り当てる必要があります: ''
。
> Documentum グループごとに、ユーザー マッピング テーブルに Windows NT グループが存在し、両方とも同じユーザー情報を含める必要があります。
最後に、OSearch15 アカウントにユーザー マッピング テーブルへの読み取りアクセス権を付与します。
ユーザー マッピング テーブルを使用してコネクタを構成するには
クロール コンポーネントをホストする各サーバーで SharePoint 管理シェルを起動します。
Microsoft PowerShell コマンド プロンプトで、次のコマンドを入力します。
Set-SPEnterpriseSearchDCTMConnectorConfig -Shared -ACLTranslation UserMappingTable -DisplayURLPatternForContainer "http://<MyWebTopServer:PortOfMyWebTopServer>/webtop/component/drl?objectId={ObjectId}&RepositoryName={RepositoryName}" -DisplayURLPatternForDocument "http://<MyWebTopServer:PortOfMyWebTopServer>/webtop/component/drl?objectId={ObjectId}&format={Format}&RepositoryName={RepositoryName}" -UnmappedAccount "DiscardACE" -UserMappingTableSQLServer "<YourDatabaseServerName>" -UserMappingTableSQLInstance "<YourDatabaseInstanceName>" -UserMappingTableDBName "<YourMappingDatabaseName>" -UserMappingTableName "<YourMappingTableName>" Set-SPEnterpriseSearchDCTMConnectorConfig -Repository -RepositoryName "<MyRepository1>" -DFSWebServiceURL @("http://<DFSWebServices>:<30000>/services", "http://<DFSWebServices2>:<30000>/services") Set-SPEnterpriseSearchDCTMConnectorConfig -Repository -RepositoryName "<MyRepository2>" -DFSWebServiceURL @("http://<DFSWebServices>:<30000>/services")
ここで、
<MyWebTopServer:PortOfMyWebTopServer> は、使用している DFS Web Top Server の名前とポート番号です。
<YourDatabaseServerName> は、ユーザー マッピング テーブルを作成したデータベース サーバーの名前です。
<YourDatabaseInstanceName> は、ユーザー マッピング テーブルを作成したデータベース サーバーのデータベース インスタンスの名前です。
<YourMappingDatabaseName> は、ユーザー マッピング テーブルを作成したデータベースの名前です。
<YourMappingTableName> は、作成したユーザー マッピング テーブルの名前です。
<MyRepository n> は、クロールする Documentum リポジトリの名前です。
<DFSWebServices n>:<30000> は、クロールする Documentum リポジトリをホストする Documentum Web Services サーバーの名前とポート番号です。
OSearch15 サービスを再開します。 クロール コンポーネントをホストするサーバーのサーバー管理者が Documentum 用のコンテンツ ソースを作成するには、その前には OSearch15 サービスを再開する必要があります。
重要
このサービスを再開するために SharePoint サーバーの全体管理 Web サイトの [サーバーのサービス] ページを使用しないでください。 このページを使用すると、検索インデックスがリセットされるため、インデックスを再構築するためにすべてのコンテンツのフル クロールを実行しなければならなくなります。
この手順を実行するユーザー アカウントが、クロール コンポーネントをホストするサーバーの管理者であることを確認します。
コマンド プロンプト ウィンドウを開きます。
OSearch15 サービスを停止するには、「 net stop osearch15 」というコマンドを入力します。
OSearch15 サービスを開始するには、「 net start osearch15 」というコマンドを入力します。
次に、Documentum のクロール ルールの作成、Documentum コンテンツ ソースの作成の順に操作を行います。
Documentum のクロールされたプロパティ カテゴリを作成する
Documentum のクロールされたプロパティを含む、クロールされたプロパティ カテゴリを作成する必要があります。 そのためには、New-SPEnterpriseSearchMetadataCategory cmdlet を使用して、cmdlet の PropSet パラメーターに対して定義済みの値 34972762-7E3F-4f4f-AE5C-5ABBA92EC530 を指定します。 この方法でクロールされたプロパティ カテゴリを作成するには、次の PowerShell コードを使用します。
$ssa = Get-SPEnterpriseSearchServiceApplication
New-SPEnterpriseSearchMetadataCategory -Name "Documentum Connector" -SearchApplication $ssa -PropSet "34972762-7E3F-4f4f-AE5C-5ABBA92EC530" -DiscoverNewProperties $true
Documentum のクロール ルールの作成
クロールを行う前に、DFS サーバーでクロールを認証するための 1 つ以上のクロール ルールを作成しておく必要があります。 特定のコンテンツを含めたり除外したりするための 1 つ以上のクロール ルールを Documentum に作成できます。
この手順を実行しているユーザー アカウントが Search Service アプリケーションの管理者であることを確認します。
SharePoint サーバーの全体管理 ホーム ページの [ アプリケーション管理] セクションで、[ サービス アプリケーションの管理] をクリックします。
[サービス アプリケーションの管理] ページで、クロール ルールを作成する Search Service Application をクリックします。
[検索管理] ページの [ クロール] セクションで、[ クロール ルール] をクリックします。
[クロール ルールの管理] ページの [新しいクロール ルール] をクリックします。
[クロール ルールの追加] ページで、次の情報を指定します。
[ パス] ボックスに、クロール ルールを適用するパスを入力します。 標準のワイルドカード文字を使用できます。 ワイルドカード文字ではなく正規表現を使用するには、[ このルールのマッチングに正規表現構文を使用する] を選択します。 例については、「Documentum オブジェクトを参照する構文」を参照してください。
[ クロールの構成] セクションで、[ このパスにあるアイテムをすべて含める] を選択し、[ 複合 URL (疑問符 - ? が含まれる URL) をクロールする] を選択します。
[ 認証の指定] セクションで [ 別のコンテンツ アクセス アカウントを指定する] を選択し、該当するボックスに Documentum コンテンツ アクセス アカウントとパスワードを入力します。 この記事の「使用する Documentum コンテンツ アクセス アカウントを決める」を参照してください。
[ 基本認証を許可しない] チェック ボックスがオフになっていることを確認します。
[ OK] をクリックしてクロール ルールを追加します。
注:
複数の Documentum 用クロール ルールを作成して Documentum コンテンツを含めたり除外したりできます。
複数のクロール ルールを使用すると、Documentum コンテンツごとに別々のコンテンツ アクセス アカウントを指定できます。 たとえば、2 つのリポジトリを用意し、それぞれに 2 つのコンテンツ アクセス アカウントを指定できます。 あるクロール ルールで指定された Documentum コンテンツ アクセス アカウントは、そのクロール ルールのパスでカバーされる Documentum コンテンツにのみ適用されます。 Security Trimming Sync Service を使用している場合、各 Documentum サーバーにこのサービスを設定する必要があります。
Documentum コンテンツ ソースの作成
Documentum コンテンツのコンテンツ ソースを作成し、クロールする Documentum コンテンツ リポジトリを指定します。
この手順を実行しているユーザー アカウントが Search Service アプリケーションの管理者であることを確認します。
SharePointSharePoint サーバーの全体管理ホーム ページの [ アプリケーション管理 ] セクションで、[ サービス アプリケーションの管理] をクリックします。
コンテンツ ソースを作成する Search Service Application をクリックします。
[検索管理] ページの [ クロール] セクションで、[ コンテンツ ソース] をクリックします。
[コンテンツ ソースの管理] ページで、[新しいコンテンツ ソース] をクリックします。
[コンテンツ ソースの追加] ページで、以下の手順を実行します。
[ 名前] ボックスに、新しいコンテンツ ソースの名前を入力します。
[ コンテンツ ソースの種類] セクションで、[ カスタム リポジトリ] を選択します。
[ リポジトリの種類] セクションで 、 Documentum の [SharePoint Indexing Connector] を選択します。 Search Service Application に Indexing Connector for Documentum を登録したときに指定した名前を使用します。
[ 開始アドレス] セクションに、開始アドレスを入力します。 開始アドレスの形式はパスのパターンと同じです。 同じコンテンツ ソースに対して複数の開始アドレスを 1 行に 1 アドレスの形で入力できます。 例については、「Documentum オブジェクを参照する構文」を参照してください。
[クロールのスケジュール] セクションで、[フル クロール] および [増分クロール] ドロップダウン リストからスケジュールを選択するか、各種類のクロールについてスケジュールを作成します。
[ コンテンツ ソースの優先度] セクションで、ビジネス要件に従ってコンテンツ ソースに優先度レベルを割り当てます。
[ OK] をクリックします。
[ コンテンツ ソースの管理] ページで、Documentum のコンテンツ ソースを右クリックして [ フル クロールの開始] をクリックします。
Documentum コンテンツ ソースが構成され、システムはそのコンテンツ ソースで指定された Documentum コンテンツ リポジトリをクロールできるようになります。
SharePoint Server では、パフォーマンス のスケールアウトにスケーラブルなアーキテクチャがサポートされています。クロール コンポーネントをホストする複数のサーバーをデプロイでき、EMC Documentum データベースを同時にクロールするように複数のクローラーを構成できます。
Documentum オブジェクトを参照する構文
Documentum オブジェクトを参照するための形式を次の表に示します。これらは、パス (クロール ルールを設定するとき) および開始アドレス (コンテンツ ソースを設定するとき) で使用します。
Documentum オブジェクトの種類 | パスまたは開始アドレスの構文 |
---|---|
リポジトリ | dctm://<clientapphostname>/<repository name> |
キャビネット | dctm://<clientapphostname>/<repository name>/<cabinet name> |
フォルダー | dctm://<clientapphostname>/<repository name>/<cabinet name>/<folder name> |
ドキュメント | dctm://<clientapphostname>/<repository name>/<cabinet name>/<folder name>/.../<folder name>?DocSysID=<r_object_id> (ここで、r_object_idはそのドキュメントのオブジェクト ID) |
<clientapphostname> は、Webtop や DA などの Documentum クライアント アプリケーションのホスト名です。 ここで構成><clientapphostname は、コンテンツ ソースで使用される名前と同じである必要があります。 <repository name> 、<cabinet name> 、および <folder name> は大文字と小文字が区別されます。
SPEnterpriseSearchDCTMConnectorConfig コマンドレットの使用
次の Microsoft PowerShell コマンドを使用して、Documentum 用 Indexing Connector コマンドレットのヘルプと例を表示します。
Get-help Set-SPEnterpriseSearchDCTMConnectorConfig -full
は、完全なヘルプを表示します。Get-help Set-SPEnterpriseSearchDCTMConnectorConfig -examples
は、例だけを示します。
Set-SPEnterpriseSearchDCTMConnectorConfig コマンドレットでは、3 つのパラメーター セットを指定できます。 Shared パラメーター セットは、クロールを行うすべての Documentum リポジトリに影響を及ぼす構成設定を変更する場合に使用します。 Repository パラメーター セットは、特定のリポジトリだけに影響を及ぼす構成設定を変更するときに使用します。 コネクタ構成から特定のリポジトリを削除する場合、Remove パラメーター セットを使用します。
次の表に、必須およびオプションのパラメーターを示します。
アクション | 必須のパラメーター | オプションのパラメーター |
---|---|---|
共有リポジトリ設定を構成する | Shared | DFSURL、 UserMappingTableSQLServer、UserMappingTableSQLInstance、UserMappingTableDBName、UserMappingTableName、 ACLTranslation、UnmappedAccount、DisplayURLPatternForDocument、DisplayURLPatternForContainer |
特定のリポジトリの設定を構成する | Repository、RepositoryName | DFSWebServiceURL、IndexAllVersions、ACLTranslation、 UnmappedAccount、DisplayURLPatternForDocument、DisplayURLPatternForContainer |
構成からリポジトリを削除する | Remove、 RepositoryName |
関連項目
SharePoint Server でのサポート対象および非サポート対象の Documentum オブジェクトの種類とプロパティ