この製品のマニュアルセットは、偏向のない言語を使用するように配慮されています。このマニュアルセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザーインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブランゲージに対する取り組みの詳細は、こちらをご覧ください。
このドキュメントは、米国シスコ発行ドキュメントの参考和訳です。リンク情報につきましては、日本語版掲載時点で、英語版にアップデートがあり、リンク先のページが移動/変更されている場合がありますことをご了承ください。あくまでも参考和訳となりますので、正式な内容については米国サイトのドキュメントを参照ください。
目次
IM and Presence サービス ノード上では、SIP Proxy が SIP 要求のルーティングを担当し、XCP SIP Federation Connection Manager は、Microsoft SIP とネイティブ XMPP 間の SIP プロトコル変換を担当します。 したがって、これらのサービスは IM and Presence サービスと Lync/OCS 間の SIP パーティション イントラドメイン フェデレーション統合の中心となります。
XCP ルータは、IM and Presence サービスの中核サービスです。 要求の受信者が Microsoft サーバか IM and Presence サービス ユーザであるかどうかで決まります。
2:26:18.719 |PID(25333) sip_protocol.c(5964) Received 536 bytes TCP packet from 10.53.56.17:34282SUBSCRIBE sip:ysam@implync.net SIP/2.0^M From: <sip:fbear@implync.net>;tag=a4cdaec0-1138350a-13d8-45026-4d755b8a-2162aa7a-4d755b8a^M To: <sip:ysam@implync.net>^M Call-ID: a30386f0-1138350a-13d8-45026-4d755b8a-2c25871c-4d755b8a^M CSeq: 1 SUBSCRIBE^M Via: SIP/2.0/TCP 10.53.56.17:5080;branch=z9hG4bK-4d755b8a-926d95b4-3c330144^M Expires: 7446^M Accept: application/pidf+xml, application/cpim-pidf+xml^M User-Agent: Cisco-Systems-Partitioned 8.0^M Max-Forwards: 70^M Event: presence^M Contact: <sip:10.53.56.17:5080;transport=TCP>^M Content-Length: 0^M … 22:26:18.719 |ID(25333) sip_sm.c(4977) SIPGW Partitioned Fed UA Header found in this request 22:26:18.719 |ID(25333) sip_sm.c(5010) This is a partitioned federation request, skip User Location DB lookup 22:26:18.719 |ID(25333) sip_sm.c(5200) This is an outbound Partitioned federation request. 22:26:18.719 |Mon Mar 07 22:26:18 2011] PID(25333) mod_sip_routing.c(1435) Routing: dipping for cuplcs.net 22:26:18.719 |Mon Mar 07 22:26:18 2011] PID(25333) mod_sip_routing.c(1473) Routing: Found domain route for cuplcs.net:10.53.56.18:5061;TLS pwf 1:1:5 22:26:18.719 |ID(25333) sip_dns.c(811) "A" Query for 10.53.56.18 successful, Got 1 IP addresses 22:26:18.719 |ID(25333) sip_dns.c(139) A Record : 10.53.56.18
21:48:44.277 |SIPGWDir.cpp:463: [FROM XMPP] <presence from='fbear@implync.net' to='ysam@implync.net' type='probe'/>... ... 21:48:44.743 |SIPGWController.cpp:622: Skipping DNS lookup: <presence from='fbear@implync.net' to='ysam@implync.net' type='probe'/> 21:48:44.743 |SIPGWController.cpp:704: Entering _handleOutContinue: <presence from='fbear@implync.net' to='ysam@implync.net' type='probe'/> 21:48:44.743 |SIPGWController.cpp:989: _findSession (JID): local(fbear@implync.net) remote(ysam@implync.net) 21:48:44.743 |SIPGWController.cpp:999: _findSession: Session not found 21:48:44.743 |SIPHostInfo.cpp:82: hostinfo(0x09a10ce8) refInc: 3 cuplcs.net:cuplcs.net 21:48:44.743 |SIPGWSession.cpp:58: Creating SIPGWSession sess=0x09a5a090 local=fbear@implync.net remote=ysam@implync.net 21:48:44.743 |SIPGWController.cpp:1017: _findSession: Made new session: sess=0x09a5a090 local(fbear@implync.net) remote(ysam@implync.net) 21:48:44.743 |SIPGWSession.cpp:990: sess=0x09a5a090 Entering handleOut: <presence from='fbear@implync.net' to='ysam@implync.net' type='probe'/> 21:48:44.743 |SIPGWSession.cpp:1090: _createOutgoingSubs local=fbear@implync.net, remote=ysam@implync.net 48:44.744 |SIPSubs.cpp:1037: from=<sip:fbear@implync.net> to=<sip:ysam@implync.net> local_contact=sip:10.53.56.17:5080;transport=TCP remote_contact=sip:ysam@implync.net
12:29:24.762 |debug sdns_plugin-1.gwydlvm453 sdns_plugin handling:<presence type='subscribed' to='ysam@implync.net' from='bbird@implync.net'><status>Already Subscribed</status></presence> 12:29:24.762 |debug ConnectionPool.cpp:166 connection pool checkout: ccm2/dbuser (success) 12:29:24.762 |debug IdsODBC.cpp:648 Performing SQL operation select userid, jsmid from enduser, enterprisenode where my_lower(xep106userid) = my_lower(?) and primarynodeid=id 12:29:24.763 |debug ODBCConnection.cpp:315 (elapsed 0.002407) select userid, jsmid from enduser, enterprisenode where my_lower(xep106userid) = my_lower(?) and primarynodeid=id 12:29:24.763 |debug CUPDatabaseAlgorithm.cpp:311 This is probably a Partitioned OCS user ... redirecting to cm-3-sip-fed-s2s.gwydlvm453 component 12:29:24.763 |debug IdsODBC.cpp:229 (elapsed 0.000137) rollback 12:29:24.763 |debug ConnectionPool.cpp:207 connection pool checkin: ccm2/dbuser (success) 12:29:24.763 |debug sdns_plugin-1.gwydlvm453 sdns_plugin redirecting to: cm-3-sip-fed-s2s.gwydlvm453
[Cisco Unified IM and Presence Service Serviceability(Cisco Unified IM and Presence サービスのサービス性)] ユーザ インターフェイス上では、SIP Proxy、XCP SIP Federation Connection Manager、および XCP Router のデバッグ トレースを有効にできます。
次の手順では、[Cisco Unified IM and Presence のサービスアビリティ(Cisco Unified IM and Presence Serviceability)] GUI 上で、SIP Proxy、XCP SIP Federation Connection Manager、および XCP Router のデバッグ トレースを設定する方法について説明します。 トレース用に設定するサービスごとに、この手順を繰り返します。
注意 |
デバッグ レベル トレースは、システム パフォーマンスに影響を与えることがあります。 必要なときにのみデバッグ トレース レベルを有効にし、システム調査が完了した後、ログの設定をデフォルトにリセットします。 |
Lync/OCS SIP Proxy コンポーネントは、すべての SIP 要求のルーティングを行います。 ルーティングの問題をデバッグするには、Microsoft サーバに固有のメソッドを使用して Microsoft サーバのデバッグ トレース(Standard Edition または Enterprise Edition)をイネーブルにできます。
次の手順は、Lync 上で SIP トレースを有効にする方法について説明します。
必要なすべてのアクセス コントロール リスト(ACL)エントリが IM and Presence サービスに追加され、任意の ACL エントリを追加した後に Cisco Sip Proxy サービスが再起動されたことを確認します。
問題が続く場合は、すべての ACL エントリを追加し、Cisco SIP Proxy を再起動します。
ACL エントリ追加の詳細については、着信アクセス コントロール リストの設定に関するトピックを参照してください。
連絡先について有効な利用可能状態が表示されている場合は、Microsoft Lync または Microsoft Office Communicator のユーザが以前に IM and Presence サービスのクライアント ユーザからの登録を受け入れているかどうかを確認します。
Microsoft サーバ サブスクリプションの承認は永久なので、IM and Presence サービスのクライアント ユーザが Microsoft Lync または Microsoft Office Communicator のユーザを削除して、再度追加すると、2 番目のポップアップが表示されないことを意味します。
連絡先に「確認の待機中(Waiting for Confirmation)」状態が表示される場合は、必要に応じて残りのトラブルシューティング手順を実行します。
連絡先の MOC SIP URI が有効なことを確認します。
Cisco SIP Proxy および Cisco SIP Federation Connection Manager サービスが各 IM and Presence サービス ノードで実行中であることを確認します。
パーティション イントラドメイン フェデレーションが IM and Presence サービス クラスタごとに有効であることを確認します。
パーティション化されたフェデレーションのルーティング モードが選択した配置に適用されるか確認します。
拡張ルーティングは、シングル クラスタの IM and Presence サービス配置でのみサポートされています。
IM and Presence サービス スタティック ルートが Microsoft サーバへの要求をルーティングするように正しく設定されているか確認します。 これを行うには、IM and Presence サービス ユーザのホーム ノードにある SIP Proxy ログを確認し、SIP Proxy が Microsoft サーバに対する SIP NOTIFY 要求の SIP 408 要求タイムアウト エラーを返すかどうか確認します。
また、IM and Presence サービスのスタティック ルートが OCS/Lync ユーザのドメインにあることを確認します。
TLS 暗号化が設定されている場合、Wireshark または同等の監視ツールを使用して、TLS ハンドシェイクが成功したことを確認します。
それでも TLS ハンドシェイクが失敗する場合、さらなる TLS トラブルシューティング手順について IM and Presence サービスおよび Microsoft サーバ間の TLS ハンドシェイク エラー をご覧ください。
Microsoft Server ホスト認証エントリが SIP NOTIFY を送信する IM and Presence サービス ノードにあることを確認します。
少なくとも IM and Presence サービス ノードごとに IP アドレス エントリが存在する必要があります。
TLS 暗号化を設定すると、IM and Presence サービス ノード向けに 2 つ目の FQDN エントリも必要になります。
IM and Presence サービスのアクセス コントロール リスト(ACL)がすべての Lync/OCS サーバ/プールからの要求を許可することを確認します。 ACL の問題がある場合は、IM and Presence Service ノードのルーティングの SIP Proxy ログの中に、「ACL - 信頼されていないアップストリーム - 認証が必要(ACL - upstream not trusted - need to authenticate)」というエントリが表示されます。
有効な利用可能状態が表示されている場合は、ローカルのプレゼンス ドメイン内のユーザからのサブスクリプション要求を自動的に承認するように IM and Presence サービス が設定されているか確認します。 この機能が有効な場合、IM and Presence サービスは IM and Presence サービス ユーザにポップアップを表示することなく、自動的に要求を承認します。
そうでない場合、「ステータスが不明(Status Unknown)」または「プレゼンスが不明(Presence Unknown)」と表示される場合は、必要に応じて残りのトラブルシューティング手順を実行します。
Cisco SIP Proxy および Cisco SIP Federation Connection Manager サービスが各 IM and Presence サービス ノードで実行中であることを確認します。
パーティション イントラドメイン フェデレーションが IM and Presence サービス クラスタごとに有効であることを確認します。
パーティション化されたフェデレーションのルーティング モードが選択した配置に適用されるか確認します。
拡張ルーティングは、シングル クラスタの IM and Presence サービス配置でのみサポートされています。
TLS 暗号化が設定されている場合、Wireshark または同等の監視ツールを使用して、TLS ハンドシェイクが成功したことを確認します。
それでも TLS ハンドシェイクが失敗する場合、さらなる TLS トラブルシューティング手順について IM and Presence サービスおよび Microsoft サーバ間の TLS ハンドシェイク エラー をご覧ください。
ルーティング IM and Presence サービス ノードをポイントするスタティック ルートが Lync/OCS Standard Edition サーバまたは Enterprise Edition プールごとに設定されていることを確認します。 スタティック ルートも、IM and Presence サービスで構成された各 IM のユーザのドメインに設定する必要があります。
各 IM and Presence サービス ノードが Microsoft サーバの配置からドメイン ネーム サービス(DNS)によって解決可能であることを確認します。
Microsoft サーバ ホスト認証のエントリが SIP NOTIFY メッセージを送信している IM and Presence サービス ノードに存在していることを確認します。
IM and Presence サービスのアクセス コントロール リスト(ACL)がすべての Microsoft サーバ/プールからの要求を許可することを確認します。 ACL の問題がある場合は、IM and Presence Service ノードのルーティングの SIP Proxy ログの中に、「ACL - 信頼されていないアップストリーム - 認証が必要(ACL - upstream not trusted - need to authenticate)」というエントリが表示されます。
これがマルチクラスタ IM and Presence サービス の配置である場合は、クラスタ間ピアリングが正しく設定されていることを確認します。
Cisco SIP Proxy および Cisco SIP Federation Connection Manager サービスが各 IM and Presence サービス ノードで実行中であることを確認します。
パーティション イントラドメイン フェデレーションが IM and Presence サービス クラスタごとに有効であることを確認します。
パーティション化されたフェデレーションのルーティング モードが選択した配置に適用されるか確認します。
拡張ルーティングは、シングル クラスタの IM and Presence サービス配置でのみサポートされています。
IM and Presence サービス スタティック ルートが Lync/OCS に要求をルーティングするように正しく設定されているか確認します。 これを行うには、IM and Presence サービス ユーザのホーム ノードにある SIP Proxy ログを確認し、SIP Proxy が Microsoft サーバに対する SIP INVITE 要求の SIP 408 要求タイムアウト エラーを返すかどうか確認します。
また、IM and Presence Service のスタティック ルートが OCS/Lync ユーザのドメインにあることを確認します。
TLS 暗号化が設定されている場合、Wireshark または同等の監視ツールを使用して、TLS ハンドシェイクが成功したことを確認します。
それでも TLS ハンドシェイクが失敗する場合、さらなる TLS トラブルシューティング手順について IM and Presence サービスおよび Microsoft サーバ間の TLS ハンドシェイク エラー をご覧ください。
Microsoft サーバ ホストの認証エントリが SIP INVITE 要求を送信する IM and Presence サービス ノードにあることを確認します。
Cisco SIP Proxy および Cisco SIP Federation Connection Manager サービスが各 IM and Presence サーバ ノードで実行中であることを確認します。
パーティション イントラドメイン フェデレーションが IM and Presence サービス クラスタごとに有効であることを確認します。
パーティション化されたフェデレーションのルーティング モードが選択した配置に適用されるか確認します。
拡張ルーティングは、シングル クラスタの IM and Presence サービス配置でのみサポートされています。
Microsoft Lync の場合、TLS 暗号化が設定されていることを確認します。
TLS 暗号化が設定されている場合、Wireshark または同等の監視ツールを使用して、TLS ハンドシェイクが成功したことを確認します。
それでも TLS ハンドシェイクが失敗する場合、さらなる TLS トラブルシューティング手順について IM and Presence サービスおよび Microsoft サーバ間の TLS ハンドシェイク エラー をご覧ください。
ルーティング IM and Presence サービス ノードをポイントするスタティック ルートが Lync/OCS Standard Edition サーバまたは Enterprise Edition プールごとに設定されていることを確認します。
また、IM and Presence サービス スタティック ルートが Microsoft サーバ ユーザのドメインにあることを確認します。
各 IM and Presence サービス ノードが MIcrosoft サーバの配置から DNS によって解決可能であることを確認します。
Microsoft サーバ ホストの許可エントリが SIP INVITE を送信している IM and Presence サービス ノードに存在していることを確認します。
IM and Presence サービスのアクセス コントロール リスト(ACL)がすべての Microsoft サーバ/プールからの要求を許可することを確認します。 ACL の問題がある場合は、IM and Presence Service ノードのルーティングの SIP Proxy ログの中に、「ACL - 信頼されていないアップストリーム - 認証が必要(ACL - upstream not trusted - need to authenticate)」というエントリが表示されます。
これがマルチクラスタ IM and Presence サービス の配置である場合は、クラスタ間ピアリングが正しく設定されていることを確認します。
このような遅延の最も一般的な理由は、配置内の DNS の設定が不足していることです。 IM and Presence サービスは、着信 SIP 要求の送り側となる Lync/OCS の IP アドレスのリバース DNS 検索を実行します。 IP アドレスがホスト名に解決されない場合、逆検索は約 20 秒後にタイムアウトします。 これが発生すると、SIP Proxy ログに「incoming ACL check took over 2 seconds – check DNS」というログが生成されます。
この問題を解決するには、DNS ポインタ(PTR)レコードが Microsoft サーバの IP アドレスごとに存在することを確認してください。
IM and Presence サービス ユーザが Microsoft サーバから移行されて以来、Lync/OCS アドレス帳サービスによる完全同期が実施されていることを確認します。 この同期は、デフォルトで毎夜実施されます。
Microsoft Lync または Microsoft Office Communicator のユーザに新しいアドレス帳のダウンロードをトリガするために、サインアウトしてサインインするように要求します。 デフォルトでは、Microsoft サーバから新しいアドレス帳をダウンロードするのに 1 時間以上かかる場合があります。
IM and Presence サービス ユーザが前に Microsoft Lync または Microsoft Office Communicator のユーザだった場合、IM and Presence サービス ユーザがまだ Active Directory(msRTCSIP-PrimaryUserAddress)に入力した古い Microsoft サーバ SIP URI を持っていることを確認します。
IM and Presence サービス ユーザが前は Microsoft Lync または Microsoft Office Communicator ユーザでなかった場合、または古い Microsoft サーバ SIP URI が Active Directory から消去されている場合は、Active Directory の [msRTCSIP-PrimaryUserAddress] フィールドに手動で入力し、IM and Presence サービス ユーザが Microsoft サーバ アドレス帳に表示されることを確認します。 [msRTCSIP-PrimaryUserAddress] フィールドにsip:user's_uri と入力する必要があります。
Lync/OCS の配置がドメイン間フェデレーション用に正しく設定されていることを確認します。 これを行うには、Microsoft サーバ ユーザがフェデレーションできることを確認します。
Cisco SIP Proxy および Cisco SIP Federation Connection Manager が各 IM and Presence サービス ノードで実行中であることを確認します。
IM and Presence サービスが外部ドメイン用にドメイン間フェデレーション用に設定されており、そのダイレクト フェデレーションが有効になっていることを確認します。
外部ドメイン用にスタティック ルートが IM and Presence サービスに設定され、スタティック ルートが Microsoft サーバをポイントしていることを確認します。
外部ドメインが IM and Presence サービスのアクセス コントロール リスト(ACL)に含まれていることを確認します。
Lync/OCS がポート 5061 でお互いの TLS 接続をリッスンするように設定されていることを確認します。
プレゼンスのピア認証ポートが 5061 に設定されているように IM and Presence サービスのアプリケーション リスナーが設定されていることを確認します。
IM and Presence サービス証明書が Microsoft のサーバと同じ認証局によって署名されていることを確認します。
Microsoft サーバまたは IM and Presence サービス証明書が期限切れになっていないことを確認します。
Microsoft のサーバ証明書がサーバ認証とクライアント認証の両方に設定されていることを確認します。
IM and Presence サービス TLS ピア サブジェクト リストに、TLS ハンドシェイク時に Microsoft サーバによって提供される証明に使用される件名共通名(CN)が含まれることを確認します。
IM and Presence サービス TLS ピア認証 TLS コンテキストが正しく設定されており、すべての TLS ピア サブジェクトが選択されていることを確認します。
Cisco Unified Personal Communicator レジストリの設定が正しいこと、特に LDAP_AttributeName_uri and LDAP_UriSchemeName サブキーが正しいことを確認します。 詳細は、『Configuration and Administration of IM and Presence Service on Cisco Unified Communications Manager( Cisco Unified Communications Manager での IM and Presence サービスの設定および管理)』の Active Directory の設定に関連する章を参照してください。
Cisco Unified Personal Communicator レジストリの設定が正しいこと、特に LDAP_AttributeName_uri and LDAP_UriSchemeName サブキーが正しいことを確認します。 詳細は、『Configuration and Administration of IM and Presence Service on Cisco Unified Communications Manager( Cisco Unified Communications Manager での IM and Presence サービスの設定および管理)』の Active Directory の設定に関連するトピックを参照してください。
ここでは、ユーザ移行のトレースとユーザ移行の一般的な問題について説明します。
ここでは、ユーザ移行のトレースに使用されるツールについて説明します。
連絡先リスト エクスポート ツールを使用すると、管理者はユーザの移行用に Lync/OCS から連絡先リストを一括でエクスポートすることができます。 ツールを実行するたびに、ExportContactsLog<Timestamp>.txt と呼ばれるログ ファイルが生成されます。 ログファイルには、発生した障害やエラーに関する詳細が含まれています。 ログファイルは、ツール自体と同じ場所に保存されます。
連絡先リスト エクスポート ツールのログ ファイルの例は次のとおりです。
>>------------------- 18/05/2011 16:59:38 ------------------->>Version: 2.1 [DEBUG] Enter>> ExportContacts.LdapConnection.CreateLdapDirectoryEntry [DEBUG] Enter>> ExportContacts.LdapConnection.CreateDirectoryEntry [DEBUG] Enter>> ExportContacts.LdapConnection.checkLdapPrefix [DEBUG] Exit>> ExportContacts.LdapConnection.checkLdapPrefix [DEBUG] Exit>> ExportContacts.LdapConnection.CreateDirectoryEntry [DEBUG] Current line item is: sip:ExampleUser@dtstfedcup2.com [DEBUG] Exit>> ExportContacts.ExportContactsUtilities.getAllSipUriFromStandardFile [DEBUG] Enter>> ExportContacts.ExportContactsUtilities.getAndPrintContactsForUsers [DEBUG] Total number of users found is: 1 [DEBUG] Processing user number: 1 [INFO] Preparing to get contacts for User [sip:ExampleUser@dtstfedcup2.com] [DEBUG] Enter>> ExportContacts.OcsWmiConnection.getContactsAndGroupsForUser [DEBUG] Enter>> ExportContacts.OcsWmiConnection.getUserInstanceID [DEBUG] Searching for userInstanceId [SELECT * FROM MSFT_SIPESUserSetting WHERE PrimaryURI = 'sip:ExampleUser@dtstfedcup2.com'] [DEBUG] Enter>> ExportContacts.OcsWmiConnection.GetScope [DEBUG] Exit>> ExportContacts.OcsWmiConnection.GetScope [DEBUG] Search results returned [DEBUG] Found user with PrimaryURI : sip:ExampleUser@dtstfedcup2.com, InstanceId : {7D777FD5-A8F6-8243-B4D6-7F331008C58C} [DEBUG] Exit>> ExportContacts.OcsWmiConnection.getUserInstanceID [DEBUG] Enter>> ExportContacts.OcsWmiConnection.getContacts [DEBUG] Searching for contacts [SELECT * FROM MSFT_SIPESUserContactData WHERE UserInstanceID = '{7D777FD5-A8F6-8243-B4D6-7F331008C58C}'] [DEBUG] Enter>> ExportContacts.OcsWmiConnection.GetScope [DEBUG] Exit>> ExportContacts.OcsWmiConnection.GetScope [DEBUG] Search results returned [DEBUG] Found contact: SIPURI : [SIP:lyncContact@dtstfedcup2.com] with GroupId: [1] [DEBUG] Found contact: SIPURI : [SIP:ExampleUser@dtstfedcup2.com] with GroupId: [1] [DEBUG] Exit>> ExportContacts.OcsWmiConnection.getContacts [DEBUG] Enter>> ExportContacts.OcsWmiConnection.getGroups [DEBUG] Searching for groups [SELECT * FROM MSFT_SIPESUserContactGroupData WHERE UserInstanceID = '{7D777FD5-A8F6-8243-B4D6-7F331008C58C}'] [DEBUG] Enter>> ExportContacts.OcsWmiConnection.GetScope [DEBUG] Exit>> ExportContacts.OcsWmiConnection.GetScope [DEBUG] Search results returned [DEBUG] Found group: groupName : [General] with GroupId: [1] [DEBUG] Exit>> ExportContacts.OcsWmiConnection.getGroups [INFO] User Processed Successfully [DEBUG] Exit>> ExportContacts.OcsWmiConnection.getContactsAndGroupsForUser [DEBUG] Enter>> ExportContacts.ExportContactsUtilities.PrintContactsForUser [DEBUG] Exit>> ExportContacts.ExportContactsUtilities.PrintContactsForUser [DEBUG] Exit>> ExportContacts.ExportContactsUtilities.getAndPrintContactsForUsers [INFO] Summary: [INFO] 1 users successfully processed [INFO] 0 users not found [INFO] 0 users could not be processed due to errors <<------------------- 18/05/2011 16:59:41 -------------------<<
アカウント無効化ツールは、Active Directory(AD)に接続し、ユーザの Lync/OCS 属性を更新して Microsoft サーバ カウントを無効にします。 ツールを実行するたびに、DisableAccountLog<Timestamp>.txt と呼ばれるログ ファイルが生成されます。 ログファイルには、発生した障害やエラーに関する詳細が含まれています。 ログファイルは、ツール自体と同じ場所に保存されます。
このツールでエラーが発生する一般的な原因の一部は次のとおりです。
不正な入力ファイル名が指定された
入力ファイルの中にスペルミスがある
ユーザは、Microsoft サーバ データベースに存在しません
ツールを実行している管理者が AD に対する読み取り/書き込み権限を持っていない
このツールによって AD に変更内容が適用され、Microsoft サーバ データベースまで伝播するのに必要な時間を管理者が十分に設けていない。 変更が Microsoft サーバ データベースに反映されていることを検証せずに、管理者が次の移行ステップに進んだ場合、移行が失敗することがある。
アカウント無効化ツールのログ ファイルの例は次のとおりです。
>>------------------- 18/05/2011 17:02:07 ------------------->>Version: 2.0 [DEBUG] Enter>> DisableAccount.LdapConnection.CreateLdapDirectoryEntry [DEBUG] Enter>> DisableAccount.LdapConnection.CreateDirectoryEntry [DEBUG] Enter>> DisableAccount.LdapConnection.checkLdapPrefix [DEBUG] Exit>> DisableAccount.LdapConnection.checkLdapPrefix [DEBUG] Exit>> DisableAccount.LdapConnection.CreateDirectoryEntry [DEBUG] Enter>> DisableAccount.AccountDisable.DisableUsersInFile [DEBUG] Enter>> DisableAccount.AccountDisable.GetSipUriFromLine [DEBUG] Exit>> DisableAccount.AccountDisable.GetSipUriFromLine [INFO] Preparing to Disable Communications Server Account for User [sip:ExampleUser@dtstfedcup2.com] [DEBUG] Enter>> DisableAccount.LdapConnection.DisableAccount [INFO] Searching for user [sip:ExampleUser@dtstfedcup2.com] [INFO] Search results returned [DEBUG] Enter>> DisableAccount.LdapConnection.CreateLdapDirectoryEntry [DEBUG] Enter>> DisableAccount.LdapConnection.CreateDirectoryEntry [DEBUG] Enter>> DisableAccount.LdapConnection.checkLdapPrefix [DEBUG] Exit>> DisableAccount.LdapConnection.checkLdapPrefix [DEBUG] Exit>> DisableAccount.LdapConnection.CreateDirectoryEntry [INFO] Found user with PrimaryURI : sip:ExampleUser@dtstfedcup2.com, DisplayName : Example User, Enabled : True [DEBUG] Committed changes to the AD [INFO] User Account Disabled [DEBUG] Exit>> DisableAccount.LdapConnection.DisableAccount [DEBUG] Enter>> DisableAccount.AccountDisable.GetSipUriFromLine [DEBUG] Exit>> DisableAccount.AccountDisable.DisableUsersInFile [INFO] Summary: [INFO] 1 users successfully processed [INFO] 0 users not found [INFO] 0 users could not be processed due to errors <<------------------- 18/05/2011 17:02:08 -------------------<<
アカウント無効化ツールの使用方法の詳細については、移行するユーザの Microsoft のサーバ アカウントの無効化に関連するトピックを参照してください。
アカウント削除ツールを使用すると、移行するユーザを削除することで、それらのユーザへのプレゼンス要求が後から IM and Presence サービス にルーティングされるようにします。その一方で、削除されたユーザは、Lync/OCS に残っているユーザの連絡先リストからは削除されません。 アカウント削除ツールを実行すると、DeleteAccountLog<Timestamp>.txt と呼ばれるログ ファイルがツールと同じディレクトリに生成されます。 ログファイルには、発生した障害やエラーに関する詳細が含まれています。
このツールでエラーが発生する一般的な原因の一部は次のとおりです。
>>------------------- 02/12/2013 15:13:50 ------------------->> Version: 10.x.x-xx [DEBUG] Enter>> DeleteAccount.DbConnectionFactory.GetCommSvrDbCon [DEBUG] Enter>> DeleteAccount.DbConnectionFactory.GetConnection [DEBUG] Attempting to Open connection with String : Server=lyncServer\rtclocal;Database=rtc;Trusted_Connection=yes; [DEBUG] Connection Opened Ok [DEBUG] Exit>> DeleteAccount.DbConnectionFactory.GetConnection [DEBUG] Enter>> DeleteAccount.DbConnectionFactory.tableExists [DEBUG] SQL is [SELECT id FROM sysobjects WHERE name = 'Resource'] [DEBUG] Found id [1077578877] [DEBUG] Exit>> DeleteAccount.DbConnectionFactory.tableExists [INFO] Found the Resource Table, appears to be a valid Communications Server Database [DEBUG] Enter>> DeleteAccount.DbConnectionFactory.tableExists [DEBUG] SQL is [SELECT id FROM sysobjects WHERE name = 'Endpoint'] [DEBUG] No result [DEBUG] Exit>> DeleteAccount.DbConnectionFactory.tableExists [DEBUG] Enter>> DeleteAccount.DbConnectionFactory.tableExists [DEBUG] SQL is [SELECT id FROM sysobjects WHERE name = 'Container'] [DEBUG] Found id [1202103323] [DEBUG] Exit>> DeleteAccount.DbConnectionFactory.tableExists [DEBUG] Enter>> DeleteAccount.DbConnectionFactory.tableExists [DEBUG] SQL is [SELECT id FROM sysobjects WHERE name = 'HomedResource'] [DEBUG] No result [DEBUG] Exit>> DeleteAccount.DbConnectionFactory.tableExists [DEBUG] Enter>> DeleteAccount.DbConnectionFactory.tableExists [DEBUG] SQL is [SELECT id FROM sysobjects WHERE name = 'CertificateStore'] [DEBUG] Found id [1826105546] [DEBUG] Exit>> DeleteAccount.DbConnectionFactory.tableExists [INFO] Found the CertificateStore table, dealing with a version of Lync. [DEBUG] Enter>> DeleteAccount.DbConnectionFactory.tableExists [DEBUG] SQL is [SELECT id FROM sysobjects WHERE name = 'ForestDirectory'] [DEBUG] Found id [853578079] [DEBUG] Exit>> DeleteAccount.DbConnectionFactory.tableExists [INFO] Found the ForestDirectory table, Creating Lync2013 Connection [DEBUG] Exit>> DeleteAccount.DbConnectionFactory.GetCommSvrDbCon [DEBUG] Enter>> DeleteAccount.CommSvrDbConnection.CheckConnection [DEBUG] Enter>> DeleteAccount.CommSvrDbConnection.GetConnection [DEBUG] Exit>> DeleteAccount.CommSvrDbConnection.GetConnection [DEBUG] Exit>> DeleteAccount.CommSvrDbConnection.CheckConnection [DEBUG] Enter>> DeleteAccount.DeleteUserData.DisableUsersInFile [DEBUG] Enter>> DeleteAccount.DeleteUserData.GetUserAtHostFromLine [DEBUG] Exit>> DeleteAccount.DeleteUserData.GetUserAtHostFromLine [INFO] Preparing to Delete Communications Server Data for User [lyncUser@lyncDomain.net] [DEBUG] Enter>> DeleteAccount.DeleteUserData.DeleteOcsUserData [DEBUG] Enter>> DeleteAccount.CommSvrDbConnection.GetResourceIdForUser [DEBUG] Enter>> DeleteAccount.CommSvrDbConnection.GetConnection [DEBUG] Exit>> DeleteAccount.CommSvrDbConnection.GetConnection [DEBUG] Enter>> DeleteAccount.CommSvrDbConnection.SqlEscape [DEBUG] Exit>> DeleteAccount.CommSvrDbConnection.SqlEscape [DEBUG] Exit>> DeleteAccount.CommSvrDbConnection.GetResourceIdForUser [INFO] Found user [lyncUser06@cork.com] with ResourceId [1010], proceeding to delete data [DEBUG] Enter>> DeleteAccount.Lync2013DbConnection.DeleteResourceDirectory [DEBUG] Enter>> DeleteAccount.CommSvrDbConnection.GetConnection [DEBUG] Exit>> DeleteAccount.CommSvrDbConnection.GetConnection [DEBUG] Ran dbo.RtcpDeleteHomedResourceTransaction for resource [1010] [DEBUG] Deleted CachedContainerMember for resource [1010] [DEBUG] Deleted ContainerMemberUser for resource [1010] [DEBUG] Deleted PromptedSubscriber for resource [1010] [DEBUG] Deleted Delegate for resource [1010] [DEBUG] Ran RtcpDeleteConferenceParticipantByEnterpriseId for resource [1010] [DEBUG] Deleted UserPolicy for resource [1010] [DEBUG] Deleted ResourcePhone for resource [1010] [DEBUG] Deleted RtcItem for resource [1010] [DEBUG] Deleted PUIDDirectory for resource [1010] [DEBUG] Deleted ResourceDirectory for resource [1010] [DEBUG] Committing transaction for resource [1010] [INFO] Completed Updates for resource [1010] [DEBUG] Exit>> DeleteAccount.Lync2013DbConnection.DeleteResourceDirectory [DEBUG] Exit>> DeleteAccount.DeleteUserData.DeleteOcsUserData [DEBUG] Enter>> DeleteAccount.DeleteUserData.GetUserAtHostFromLine [DEBUG] Exit>> DeleteAccount.DeleteUserData.GetUserAtHostFromLine [DEBUG] Exit>> DeleteAccount.DeleteUserData.DisableUsersInFile Summary: Users successfully processed: 1 Users not found: 0 Users not processed due to errors: 0 <<------------------- 02/12/2013 15:13:50 -------------------<<
アカウント削除ツールの使用方法の詳細については、移行するユーザのデータベースからユーザ データを削除することに関するトピックを参照してください。
IM and Presence サービス 一括管理ツール(BAT)は、連絡先リストのインポート ジョブの結果をログ ファイルに書き込みます。 ログ ファイルには、次の情報が含まれています。
このログ ファイルにアクセスするには、次の手順を実行します。
[Cisco Unified IM and Presence Administration(Cisco Unified IM and Presence Administration)] ユーザ インターフェイスにログインします。 を選択します。
[Find(検索)] を選択し、連絡先リストのインポート ジョブのジョブ ID を選択します。
[Log File Name(ログ ファイル名)] リンクを選択し、ログを開きます。
任意の BAT ジョブの詳細が必要な場合は、一括プロビジョニング サービスのデバッグ ログを参照してください。 これらのログには、/var/log/active/cm/trace/bps/log4j/bps000*.txt からアクセスできます。
一括プロビジョニング サービスのデバッグ ロギングは、[Cisco Unified IM and Presence Serviceability(Cisco Unified IM and Presence Serviceability)] ユーザ インターフェイスから有効にできます。
次の手順では、IM and Presence サービスで一括プロビジョニング サービスでロギングを設定する方法について説明します。
注意 |
デバッグ レベル トレースは、システム パフォーマンスに影響を与えることがあります。 必要なときにのみデバッグ トレース レベルを有効にし、システム調査が完了した後、ログの設定をデフォルトにリセットします。 |
IM and Presence サービス一括管理ツール(BAT)により、ある形式から別の形式にユーザの連絡先リストのコンタクト ID(JID)の名前を変更できます。 たとえば、firstname.lastname@domain.com から userid@domain.com にユーザのコンタクト ID の名前を変更できます。また、BAT は新しいコンタクト ID で各ユーザの連絡先リストを更新します。
一括管理ツールはコンタクトの名前変更ジョブ結果をログ ファイルに書き込みます。 ログ ファイルには、次の情報が含まれています。
正常に取得された連絡先の数。
連絡先を取得しようとした際に発生した内部サーバ エラーの数。
無視された連絡先の名前変更レコードの数。 ログ ファイルには、それぞれの無視されたレコードの理由がログ ファイルの末尾に記載されます。
一括ジョブが早く終了するエラーが発生したために処理されなかった CSV ファイル内の連絡先の名前変更レコードの数。 このエラーは滅多に起こりません。
これらの連絡先の変更内容が通知されたユーザの数。
これらの連絡先の変更内容が通知されなかったユーザの数。
このログ ファイルにアクセスするには、次の手順を実行します。
[Cisco Unified CM IM and Presence Administration(Cisco Unified CM IM and Presence 管理)] ユーザ インターフェイスにログインします。 を選択します。
[Find(検索)] をクリックし、連絡先の名前変更ジョブのジョブ ID を選択します。
[Log File Name(ログ ファイル名)] リンクを選択し、ログを開きます。
エラー発生の一般的な理由は次のとおりです。
Cisco XCP ルータのサービスがクラスタ内のノードで停止する。
アップロードされた CSV ファイルの形式が誤っている。 ファイル形式が正しいことと、そのファイルにヘッダーがあることを確認する必要があります。 ファイル形式の詳細については、コンタクト ID の名前変更に関するトピックを参照してください。
コンタクト ID に無効な文字が含まれているか、最大許容長を超えている。
任意の一括管理ジョブの詳細が必要な場合は、一括プロビジョニング サービスのデバッグ ログを参照してください。 これらのログには、/var/log/active/cm/trace/bps/log4j/bps000*.txt からアクセスできます。
一括プロビジョニング サービスのデバッグ ロギングは、[Cisco Unified Serviceability] ユーザ インターフェイスから有効にできます。 詳細については、デバッグ ロギングおよび一括プロビジョニング サービス ロギングに関するトピックを参照してください。
ここでは、共通のユーザ移行の問題について説明します。
ユーザ移行ツールのいずれかを実行しようとすると、「Application failed to initialize properly(アプリケーションが正常な初期化に失敗しました)」というエラーが表示される場合があります。 このエラーの原因は、.NET 2.0 フレームワークのインストールされていないユーザ移行ツールを実行しようとしていることです。 シスコが提供する各ユーザ移行ツールを使用するには、.NET Framework の少なくともバージョン 2.0 が、そのツールを実行している場所からサーバにインストールされている必要があります。
NET 2.0 フレームワークは、Windows Server 2003 R2 以降で標準としてインストールされています。
Lync サーバから連絡先リストをエクスポートするには、データベース インスタンスのパラメータを含む必要があります。 データベース インスタンス パラメータを省略するか、誤ったデータベース パラメータを入力した場合、エラーが連絡先リスト エクスポートのログに書き込まれます。 ログを確認し、データベース パラメータを省略したか、間違ったパラメータを入力したかを特定します。
次の手順に従って各サーバ/プールのデータベース インスタンスを見つけます。
データベース インスタンスの名前はコマンド出力のデータ ソース パラメータの値です。
Lync ユーザのエクスポート ツールを実行したときに「Error occurred in getAndPrintContactsForUsers(getAndPrintContactsForUsers でエラーが発生しました)」というエラーがログに表示された場合は、連絡先リスト エクスポート ツールは、Lync データベースに接続できません。 ツールを実行しているユーザ アカウントに Lync データベースの適切な読み取り権限があることを確認します。 dbo 実行アカウント権限が RTC データベースに許可されていることを確認します。 問題が解決しない場合は、データベース インスタンスの名前に入力ミスがないことを確認します。
IM and Presence サービス のエクスポート済みファイルを入力として使用する場合は、正しいドメインが -d/ パラメータに使用され、ファイル内に入力ミスがないことを確認してください。
SIP URI ファイルを入力ファイルとして使用している場合は、ユーザが有効(Active Directory [AD] および Lync/OCS に存在する)で、入力ファイルに "sip:" プレフィックス付きで正しく入力されていることを確認します。
IM and Presence サービス のエクスポート済みファイルあるいは SIP URI ファイルを入力として使用していない場合、または OU 入力ファイルを使用している場合、ユーザ アカウントは AD の中で無効になっている可能性が高いです。 ユーザ アカウントを再度有効にし、このツールを再度実行してください。
連絡先リスト エクスポートのログに次のエラーがないか確認します。「次の IP/FQDN/ホスト名を使用して LDAP に接続することができません:[some_ip_or_hostname](Unable to connect to LDAP using IP/FQDN/Hostname: [some_ip_or_hostname])」
連絡先リスト エクスポートのログに次のエラーがないか確認します。「ファイルを開くことに失敗しました…(Failed to open file…)」
OCS のエクスポートの連絡先リスト ツールを実行する場合は、データベース インスタンス パラメータを入力していないことを確認します。 データベース インスタンスのパラメータは、Lync からのみ連絡先をエクスポートするために必要です。
[Cisco Unified Communications Manager IM and Presence Administration(Cisco Unified Communications Manager IM and Presence 管理)] ユーザ インターフェイスにログインします。 を選択し、[Find(検索)] をクリックします。
ファイルが存在し、その機能タイプが [ユーザの連絡先のインポート - カスタム ファイル(Import Users' Contacts – Custom File)] であることを確認します。
不正な機能タイプのファイルが存在する場合、そのファイルを削除します。 ファイルを削除したか、ファイルが存在しない場合は、もう一度ファイルをアップロードし、そのターゲットが [連絡先リスト(Contact Lists)] であり、そのトランザクション タイプが [ユーザの連絡先のインポート - カスタム ファイル(Import Users' Contacts – Custom File)] であることを確認します。
BAT の連絡先インポート ジョブのログがジョブの結果ページから欠落している場合、BAT ジョブはサブスクライバ ノードから実行されました。 ログは、パブリッシャ ノードからのみアクセス可能です。 ログを表示するには、パブリッシャ ノード上の [Cisco Unified Communications Manager IM and Presence Administration(Cisco Unified Communications Manager IM and Presence 管理)] にサインインします。
このドキュメントで説明したように、連絡先が IM and Presence サービスに完全に移行されていることを確認します。
移行プロセス中、移行連絡先を Microsoft Lync または Microsoft Office Communicator ユーザが利用できない期間があります。 シスコでは、そのような問題がなるべく発生しないようにするために、予定されたメンテナンス ウィンドウの中でユーザ移行を実行することをお勧めします。
Microsoft Lync または Microsoft Office Communicator ユーザにログアウトしてから再度ログインするよう要求します。
移行された連絡先が IM and Presence サービスにインポートされても、Microsoft サーバ ユーザには、クライアントからサインアウトしてサインインするまでそれらの連絡先のプレゼンスは表示されません。
問題が解決しない場合は、このドキュメントで説明したように移行手順が正しく実行されたことを確認します。
それでも移行した連絡先が [Presence Unknown(プレゼンスが不明)]" "と表示される場合は、IM and Presence サービス と Microsoft サーバとの間の統合に問題がある可能性があります。 統合の問題のトラブルシューティングに関するヘルプについては、統合の一般的な問題を参照してください。
目次
- 統合のトラブルシューティング
- IM and Presence サービスのトレース
- IM and Presence サービスでのトレースの設定
- Microsoft サーバ SIP トレース
- Lync での SIP トレースの有効化
- OCS 上での SIP トレースの有効化
- 統合の一般的な問題
- Lync の 2013 クライアントが、IM and Presence サービス ユーザを連絡先リストに追加した後、繰り返しログアウトおよびログインする
- Microsoft サーバのユーザを IM and Presence サービス連絡先リストに追加すると、ポップアップを受信しない
- Microsoft サーバのユーザを IM and Presence サービスの連絡先リストに追加すると、ポップアップを受信するが、承認後のアベイラビリティがない
- Microsoft Lync または Microsoft Office Communicator ユーザが連絡先リストにユーザを追加した場合に IM and Presence サービス ユーザにポップアップが表示されない
- IM and Presence Service のユーザが送信した IM を Microsoft サーバのユーザが受信しない
- Microsoft サーバ ユーザによって送信された IM を IM and Presence ユーザが受信しない
- Microsoft サーバのユーザ更新と IM の表示に最大 40 秒かかる
- 高度なルーティングが有効になっている場合にアベイラビリティが IM and Presence サービスと Microsoft サーバの間で交換されない
- IM and Presence サービス ユーザが Microsoft サーバアドレス帳に表示されない
- IM and Presence サービスがドメイン間フェデレーション要求を Microsoft サーバの配置経由でルーティングできない
- IM and Presence サービスおよび Microsoft サーバ間の TLS ハンドシェイク エラー
- Microsoft Lync ユーザまたは Microsoft Office Communicator ユーザが Cisco Unified Personal Communicator の連絡先リストに追加されると、不正な SIP URI がそのユーザに指定される
- Cisco Unified Personal Communicator 上の Microsoft Lync または Microsoft Office Communicator の連絡先に表示名が表示されない
- ユーザ移行のトラブルシューティング
- ユーザ移行のトレース
- 連絡先リスト エクスポート ツール
- アカウント無効化ツール
- アカウント削除ツール
- IM and Presence BAT による連絡先リストのインポート
- IM and Presence サービスでの一括プロビジョニング サービス ロギングの設定
- IM and Presence サービス一括管理ツールの連絡先の名前変更
- ユーザ移行の一般的な問題
- アプリケーションが正しく初期化できない - ユーザ移行ツールのいずれかを実行しているときにエラーが発生する
- 連絡先リスト エクスポート ツールが Lync ユーザ用の出力ファイルを生成しない
- 連絡先リスト エクスポート ツールのログに getAndPrintContactsForUsers エラーが表示される
- 連絡先リスト エクスポート ツール:ログの概要にいくつかのユーザが見つからないと表示される
- 連絡先リスト エクスポート ツール:通常モードで実行すると、ツールは経過表示バーを表示せず、エクスポートされた連絡先の出力ファイルを生成しない
- アカウント無効化ツール:ログには、IP/FQDN/ホスト名を使用して LDAP に接続できないことが記載されている
- アカウント削除ツール:Microsoft サーバ データベースまたはサーバ インスタンスが見つからない
- アカウント削除ツール:SQL Server への接続中にログにエラーが表示される
- BAT 連絡先リストの更新:アップロードされた連絡先リスト ファイルがドロップダウン リストに表示されない
- BAT 連絡先リストの更新:BAT ジョブの後にログ ファイルが結果ページ上に存在しない
- BAT 連絡先リストの更新:ユーザの連絡先が BAT ジョブ中にインポートされない
- BAT 連絡先リストの更新:ユーザの連絡先が BAT ジョブ中に部分的にインポートされる
- BAT 連絡先リストの更新:連絡先が BAT ジョブ中にインポートされない
- ユーザ ステータスの移行は、移行プロセス中に Microsoft サーバ ユーザに対して [ステータスが不明(Status Unknown)] または [プレゼンスが不明(Presence Unknown)] と表示される
IM and Presence サービスのトレース
IM and Presence サービス ノード上では、SIP Proxy が SIP 要求のルーティングを担当し、XCP SIP Federation Connection Manager は、Microsoft SIP とネイティブ XMPP 間の SIP プロトコル変換を担当します。 したがって、これらのサービスは IM and Presence サービスと Lync/OCS 間の SIP パーティション イントラドメイン フェデレーション統合の中心となります。
XCP ルータは、IM and Presence サービスの中核サービスです。 要求の受信者が Microsoft サーバか IM and Presence サービス ユーザであるかどうかで決まります。
SIP Proxy のログの例
2:26:18.719 |PID(25333) sip_protocol.c(5964) Received 536 bytes TCP packet from 10.53.56.17:34282SUBSCRIBE sip:ysam@implync.net SIP/2.0^M From: <sip:fbear@implync.net>;tag=a4cdaec0-1138350a-13d8-45026-4d755b8a-2162aa7a-4d755b8a^M To: <sip:ysam@implync.net>^M Call-ID: a30386f0-1138350a-13d8-45026-4d755b8a-2c25871c-4d755b8a^M CSeq: 1 SUBSCRIBE^M Via: SIP/2.0/TCP 10.53.56.17:5080;branch=z9hG4bK-4d755b8a-926d95b4-3c330144^M Expires: 7446^M Accept: application/pidf+xml, application/cpim-pidf+xml^M User-Agent: Cisco-Systems-Partitioned 8.0^M Max-Forwards: 70^M Event: presence^M Contact: <sip:10.53.56.17:5080;transport=TCP>^M Content-Length: 0^M … 22:26:18.719 |ID(25333) sip_sm.c(4977) SIPGW Partitioned Fed UA Header found in this request 22:26:18.719 |ID(25333) sip_sm.c(5010) This is a partitioned federation request, skip User Location DB lookup 22:26:18.719 |ID(25333) sip_sm.c(5200) This is an outbound Partitioned federation request. 22:26:18.719 |Mon Mar 07 22:26:18 2011] PID(25333) mod_sip_routing.c(1435) Routing: dipping for cuplcs.net 22:26:18.719 |Mon Mar 07 22:26:18 2011] PID(25333) mod_sip_routing.c(1473) Routing: Found domain route for cuplcs.net:10.53.56.18:5061;TLS pwf 1:1:5 22:26:18.719 |ID(25333) sip_dns.c(811) "A" Query for 10.53.56.18 successful, Got 1 IP addresses 22:26:18.719 |ID(25333) sip_dns.c(139) A Record : 10.53.56.18SIP Federation Connection Manager のログの例
21:48:44.277 |SIPGWDir.cpp:463: [FROM XMPP] <presence from='fbear@implync.net' to='ysam@implync.net' type='probe'/>... ... 21:48:44.743 |SIPGWController.cpp:622: Skipping DNS lookup: <presence from='fbear@implync.net' to='ysam@implync.net' type='probe'/> 21:48:44.743 |SIPGWController.cpp:704: Entering _handleOutContinue: <presence from='fbear@implync.net' to='ysam@implync.net' type='probe'/> 21:48:44.743 |SIPGWController.cpp:989: _findSession (JID): local(fbear@implync.net) remote(ysam@implync.net) 21:48:44.743 |SIPGWController.cpp:999: _findSession: Session not found 21:48:44.743 |SIPHostInfo.cpp:82: hostinfo(0x09a10ce8) refInc: 3 cuplcs.net:cuplcs.net 21:48:44.743 |SIPGWSession.cpp:58: Creating SIPGWSession sess=0x09a5a090 local=fbear@implync.net remote=ysam@implync.net 21:48:44.743 |SIPGWController.cpp:1017: _findSession: Made new session: sess=0x09a5a090 local(fbear@implync.net) remote(ysam@implync.net) 21:48:44.743 |SIPGWSession.cpp:990: sess=0x09a5a090 Entering handleOut: <presence from='fbear@implync.net' to='ysam@implync.net' type='probe'/> 21:48:44.743 |SIPGWSession.cpp:1090: _createOutgoingSubs local=fbear@implync.net, remote=ysam@implync.net 48:44.744 |SIPSubs.cpp:1037: from=<sip:fbear@implync.net> to=<sip:ysam@implync.net> local_contact=sip:10.53.56.17:5080;transport=TCP remote_contact=sip:ysam@implync.netXCP Router のログの例
12:29:24.762 |debug sdns_plugin-1.gwydlvm453 sdns_plugin handling:<presence type='subscribed' to='ysam@implync.net' from='bbird@implync.net'><status>Already Subscribed</status></presence> 12:29:24.762 |debug ConnectionPool.cpp:166 connection pool checkout: ccm2/dbuser (success) 12:29:24.762 |debug IdsODBC.cpp:648 Performing SQL operation select userid, jsmid from enduser, enterprisenode where my_lower(xep106userid) = my_lower(?) and primarynodeid=id 12:29:24.763 |debug ODBCConnection.cpp:315 (elapsed 0.002407) select userid, jsmid from enduser, enterprisenode where my_lower(xep106userid) = my_lower(?) and primarynodeid=id 12:29:24.763 |debug CUPDatabaseAlgorithm.cpp:311 This is probably a Partitioned OCS user ... redirecting to cm-3-sip-fed-s2s.gwydlvm453 component 12:29:24.763 |debug IdsODBC.cpp:229 (elapsed 0.000137) rollback 12:29:24.763 |debug ConnectionPool.cpp:207 connection pool checkin: ccm2/dbuser (success) 12:29:24.763 |debug sdns_plugin-1.gwydlvm453 sdns_plugin redirecting to: cm-3-sip-fed-s2s.gwydlvm453[Cisco Unified IM and Presence Service Serviceability(Cisco Unified IM and Presence サービスのサービス性)] ユーザ インターフェイス上では、SIP Proxy、XCP SIP Federation Connection Manager、および XCP Router のデバッグ トレースを有効にできます。
IM and Presence サービスでのトレースの設定
手順次の手順では、[Cisco Unified IM and Presence のサービスアビリティ(Cisco Unified IM and Presence Serviceability)] GUI 上で、SIP Proxy、XCP SIP Federation Connection Manager、および XCP Router のデバッグ トレースを設定する方法について説明します。 トレース用に設定するサービスごとに、この手順を繰り返します。
注意
デバッグ レベル トレースは、システム パフォーマンスに影響を与えることがあります。 必要なときにのみデバッグ トレース レベルを有効にし、システム調査が完了した後、ログの設定をデフォルトにリセットします。
Microsoft サーバ SIP トレース
Lync での SIP トレースの有効化
手順
関連情報
OCS 上での SIP トレースの有効化
手順
関連情報
統合の一般的な問題
- Lync の 2013 クライアントが、IM and Presence サービス ユーザを連絡先リストに追加した後、繰り返しログアウトおよびログインする
- Microsoft サーバのユーザを IM and Presence サービス連絡先リストに追加すると、ポップアップを受信しない
- Microsoft サーバのユーザを IM and Presence サービスの連絡先リストに追加すると、ポップアップを受信するが、承認後のアベイラビリティがない
- Microsoft Lync または Microsoft Office Communicator ユーザが連絡先リストにユーザを追加した場合に IM and Presence サービス ユーザにポップアップが表示されない
- IM and Presence Service のユーザが送信した IM を Microsoft サーバのユーザが受信しない
- Microsoft サーバ ユーザによって送信された IM を IM and Presence ユーザが受信しない
- Microsoft サーバのユーザ更新と IM の表示に最大 40 秒かかる
- 高度なルーティングが有効になっている場合にアベイラビリティが IM and Presence サービスと Microsoft サーバの間で交換されない
- IM and Presence サービス ユーザが Microsoft サーバアドレス帳に表示されない
- IM and Presence サービスがドメイン間フェデレーション要求を Microsoft サーバの配置経由でルーティングできない
- IM and Presence サービスおよび Microsoft サーバ間の TLS ハンドシェイク エラー
- Microsoft Lync ユーザまたは Microsoft Office Communicator ユーザが Cisco Unified Personal Communicator の連絡先リストに追加されると、不正な SIP URI がそのユーザに指定される
- Cisco Unified Personal Communicator 上の Microsoft Lync または Microsoft Office Communicator の連絡先に表示名が表示されない
Microsoft サーバのユーザを IM and Presence サービス連絡先リストに追加すると、ポップアップを受信しない
トラブルシューティングの手順
連絡先について有効な利用可能状態が表示されている場合は、Microsoft Lync または Microsoft Office Communicator のユーザが以前に IM and Presence サービスのクライアント ユーザからの登録を受け入れているかどうかを確認します。
Microsoft サーバ サブスクリプションの承認は永久なので、IM and Presence サービスのクライアント ユーザが Microsoft Lync または Microsoft Office Communicator のユーザを削除して、再度追加すると、2 番目のポップアップが表示されないことを意味します。
連絡先に「確認の待機中(Waiting for Confirmation)」状態が表示される場合は、必要に応じて残りのトラブルシューティング手順を実行します。
連絡先の MOC SIP URI が有効なことを確認します。
Cisco SIP Proxy および Cisco SIP Federation Connection Manager サービスが各 IM and Presence サービス ノードで実行中であることを確認します。
パーティション イントラドメイン フェデレーションが IM and Presence サービス クラスタごとに有効であることを確認します。
パーティション化されたフェデレーションのルーティング モードが選択した配置に適用されるか確認します。
拡張ルーティングは、シングル クラスタの IM and Presence サービス配置でのみサポートされています。
IM and Presence サービス スタティック ルートが Microsoft サーバへの要求をルーティングするように正しく設定されているか確認します。 これを行うには、IM and Presence サービス ユーザのホーム ノードにある SIP Proxy ログを確認し、SIP Proxy が Microsoft サーバに対する SIP NOTIFY 要求の SIP 408 要求タイムアウト エラーを返すかどうか確認します。
また、IM and Presence サービスのスタティック ルートが OCS/Lync ユーザのドメインにあることを確認します。
TLS 暗号化が設定されている場合、Wireshark または同等の監視ツールを使用して、TLS ハンドシェイクが成功したことを確認します。
それでも TLS ハンドシェイクが失敗する場合、さらなる TLS トラブルシューティング手順について IM and Presence サービスおよび Microsoft サーバ間の TLS ハンドシェイク エラー をご覧ください。
Microsoft Server ホスト認証エントリが SIP NOTIFY を送信する IM and Presence サービス ノードにあることを確認します。
少なくとも IM and Presence サービス ノードごとに IP アドレス エントリが存在する必要があります。
TLS 暗号化を設定すると、IM and Presence サービス ノード向けに 2 つ目の FQDN エントリも必要になります。
Microsoft Lync または Microsoft Office Communicator ユーザが連絡先リストにユーザを追加した場合に IM and Presence サービス ユーザにポップアップが表示されない
トラブルシューティングの手順
有効な利用可能状態が表示されている場合は、ローカルのプレゼンス ドメイン内のユーザからのサブスクリプション要求を自動的に承認するように IM and Presence サービス が設定されているか確認します。 この機能が有効な場合、IM and Presence サービスは IM and Presence サービス ユーザにポップアップを表示することなく、自動的に要求を承認します。
そうでない場合、「ステータスが不明(Status Unknown)」または「プレゼンスが不明(Presence Unknown)」と表示される場合は、必要に応じて残りのトラブルシューティング手順を実行します。
Cisco SIP Proxy および Cisco SIP Federation Connection Manager サービスが各 IM and Presence サービス ノードで実行中であることを確認します。
パーティション イントラドメイン フェデレーションが IM and Presence サービス クラスタごとに有効であることを確認します。
パーティション化されたフェデレーションのルーティング モードが選択した配置に適用されるか確認します。
拡張ルーティングは、シングル クラスタの IM and Presence サービス配置でのみサポートされています。
TLS 暗号化が設定されている場合、Wireshark または同等の監視ツールを使用して、TLS ハンドシェイクが成功したことを確認します。
それでも TLS ハンドシェイクが失敗する場合、さらなる TLS トラブルシューティング手順について IM and Presence サービスおよび Microsoft サーバ間の TLS ハンドシェイク エラー をご覧ください。
ルーティング IM and Presence サービス ノードをポイントするスタティック ルートが Lync/OCS Standard Edition サーバまたは Enterprise Edition プールごとに設定されていることを確認します。 スタティック ルートも、IM and Presence サービスで構成された各 IM のユーザのドメインに設定する必要があります。
各 IM and Presence サービス ノードが Microsoft サーバの配置からドメイン ネーム サービス(DNS)によって解決可能であることを確認します。
Microsoft サーバ ホスト認証のエントリが SIP NOTIFY メッセージを送信している IM and Presence サービス ノードに存在していることを確認します。
IM and Presence サービスのアクセス コントロール リスト(ACL)がすべての Microsoft サーバ/プールからの要求を許可することを確認します。 ACL の問題がある場合は、IM and Presence Service ノードのルーティングの SIP Proxy ログの中に、「ACL - 信頼されていないアップストリーム - 認証が必要(ACL - upstream not trusted - need to authenticate)」というエントリが表示されます。
これがマルチクラスタ IM and Presence サービス の配置である場合は、クラスタ間ピアリングが正しく設定されていることを確認します。
- [Cisco Unified IM and Presence Administration(Cisco Unified IM and Presence 管理)] ユーザ インターフェイスにログインします。 宛先ルーティング IM and Presence サービス ノードを含むクラスタのパブリッシャ ノードで を選択します。
- クラスタ間ピアのリストに IM and Presence サービス ユーザがプロビジョニングされているクラスタ向けのピアが含まれていること、およびそのピアに関連付けられたユーザの数が 0 より大きいことを確認します。
- クラスタ間ピアのステータスを検証するために、クラスタ間ピアを選択します。
- 強調表示されたエラーが存在しないことを確認してください。
IM and Presence Service のユーザが送信した IM を Microsoft サーバのユーザが受信しない
トラブルシューティングの手順
Cisco SIP Proxy および Cisco SIP Federation Connection Manager サービスが各 IM and Presence サービス ノードで実行中であることを確認します。
パーティション イントラドメイン フェデレーションが IM and Presence サービス クラスタごとに有効であることを確認します。
パーティション化されたフェデレーションのルーティング モードが選択した配置に適用されるか確認します。
拡張ルーティングは、シングル クラスタの IM and Presence サービス配置でのみサポートされています。
IM and Presence サービス スタティック ルートが Lync/OCS に要求をルーティングするように正しく設定されているか確認します。 これを行うには、IM and Presence サービス ユーザのホーム ノードにある SIP Proxy ログを確認し、SIP Proxy が Microsoft サーバに対する SIP INVITE 要求の SIP 408 要求タイムアウト エラーを返すかどうか確認します。
また、IM and Presence Service のスタティック ルートが OCS/Lync ユーザのドメインにあることを確認します。
TLS 暗号化が設定されている場合、Wireshark または同等の監視ツールを使用して、TLS ハンドシェイクが成功したことを確認します。
それでも TLS ハンドシェイクが失敗する場合、さらなる TLS トラブルシューティング手順について IM and Presence サービスおよび Microsoft サーバ間の TLS ハンドシェイク エラー をご覧ください。
Microsoft サーバ ホストの認証エントリが SIP INVITE 要求を送信する IM and Presence サービス ノードにあることを確認します。
Microsoft サーバ ユーザによって送信された IM を IM and Presence ユーザが受信しない
トラブルシューティングの手順
Cisco SIP Proxy および Cisco SIP Federation Connection Manager サービスが各 IM and Presence サーバ ノードで実行中であることを確認します。
パーティション イントラドメイン フェデレーションが IM and Presence サービス クラスタごとに有効であることを確認します。
パーティション化されたフェデレーションのルーティング モードが選択した配置に適用されるか確認します。
拡張ルーティングは、シングル クラスタの IM and Presence サービス配置でのみサポートされています。
Microsoft Lync の場合、TLS 暗号化が設定されていることを確認します。
TLS 暗号化が設定されている場合、Wireshark または同等の監視ツールを使用して、TLS ハンドシェイクが成功したことを確認します。
それでも TLS ハンドシェイクが失敗する場合、さらなる TLS トラブルシューティング手順について IM and Presence サービスおよび Microsoft サーバ間の TLS ハンドシェイク エラー をご覧ください。
ルーティング IM and Presence サービス ノードをポイントするスタティック ルートが Lync/OCS Standard Edition サーバまたは Enterprise Edition プールごとに設定されていることを確認します。
また、IM and Presence サービス スタティック ルートが Microsoft サーバ ユーザのドメインにあることを確認します。
各 IM and Presence サービス ノードが MIcrosoft サーバの配置から DNS によって解決可能であることを確認します。
Microsoft サーバ ホストの許可エントリが SIP INVITE を送信している IM and Presence サービス ノードに存在していることを確認します。
IM and Presence サービスのアクセス コントロール リスト(ACL)がすべての Microsoft サーバ/プールからの要求を許可することを確認します。 ACL の問題がある場合は、IM and Presence Service ノードのルーティングの SIP Proxy ログの中に、「ACL - 信頼されていないアップストリーム - 認証が必要(ACL - upstream not trusted - need to authenticate)」というエントリが表示されます。
これがマルチクラスタ IM and Presence サービス の配置である場合は、クラスタ間ピアリングが正しく設定されていることを確認します。
- [Cisco Unified Communications Manager IM and Presence Administration(Cisco Unified Communications Manager IM and Presence 管理)] ユーザ インターフェイスにログインします。 宛先ルーティング IM and Presence サービス ノードを含むクラスタのパブリッシャ ノードで を選択します。
- クラスタ間ピアのリストに IM and Presence サービス ユーザがプロビジョニングされているクラスタ向けのピアが含まれていること、およびそのピアに関連付けられたユーザの数が 0 より大きいことを確認します。
- クラスタ間ピアのステータスを検証するために、クラスタ間ピアをクリックします。
- 強調表示されたエラーが存在しないことを確認してください。
Microsoft サーバのユーザ更新と IM の表示に最大 40 秒かかる
トラブルシューティングの手順
このような遅延の最も一般的な理由は、配置内の DNS の設定が不足していることです。 IM and Presence サービスは、着信 SIP 要求の送り側となる Lync/OCS の IP アドレスのリバース DNS 検索を実行します。 IP アドレスがホスト名に解決されない場合、逆検索は約 20 秒後にタイムアウトします。 これが発生すると、SIP Proxy ログに「incoming ACL check took over 2 seconds – check DNS」というログが生成されます。
この問題を解決するには、DNS ポインタ(PTR)レコードが Microsoft サーバの IP アドレスごとに存在することを確認してください。
IM and Presence サービス ユーザが Microsoft サーバアドレス帳に表示されない
トラブルシューティングの手順
IM and Presence サービス ユーザが Microsoft サーバから移行されて以来、Lync/OCS アドレス帳サービスによる完全同期が実施されていることを確認します。 この同期は、デフォルトで毎夜実施されます。
Microsoft Lync または Microsoft Office Communicator のユーザに新しいアドレス帳のダウンロードをトリガするために、サインアウトしてサインインするように要求します。 デフォルトでは、Microsoft サーバから新しいアドレス帳をダウンロードするのに 1 時間以上かかる場合があります。
IM and Presence サービス ユーザが前に Microsoft Lync または Microsoft Office Communicator のユーザだった場合、IM and Presence サービス ユーザがまだ Active Directory(msRTCSIP-PrimaryUserAddress)に入力した古い Microsoft サーバ SIP URI を持っていることを確認します。
IM and Presence サービス ユーザが前は Microsoft Lync または Microsoft Office Communicator ユーザでなかった場合、または古い Microsoft サーバ SIP URI が Active Directory から消去されている場合は、Active Directory の [msRTCSIP-PrimaryUserAddress] フィールドに手動で入力し、IM and Presence サービス ユーザが Microsoft サーバ アドレス帳に表示されることを確認します。 [msRTCSIP-PrimaryUserAddress] フィールドにsip:user's_uri と入力する必要があります。
IM and Presence サービスがドメイン間フェデレーション要求を Microsoft サーバの配置経由でルーティングできない
トラブルシューティングの手順
Lync/OCS の配置がドメイン間フェデレーション用に正しく設定されていることを確認します。 これを行うには、Microsoft サーバ ユーザがフェデレーションできることを確認します。
Cisco SIP Proxy および Cisco SIP Federation Connection Manager が各 IM and Presence サービス ノードで実行中であることを確認します。
IM and Presence サービスが外部ドメイン用にドメイン間フェデレーション用に設定されており、そのダイレクト フェデレーションが有効になっていることを確認します。
外部ドメイン用にスタティック ルートが IM and Presence サービスに設定され、スタティック ルートが Microsoft サーバをポイントしていることを確認します。
外部ドメインが IM and Presence サービスのアクセス コントロール リスト(ACL)に含まれていることを確認します。
IM and Presence サービスおよび Microsoft サーバ間の TLS ハンドシェイク エラー
トラブルシューティングの手順
Lync/OCS がポート 5061 でお互いの TLS 接続をリッスンするように設定されていることを確認します。
プレゼンスのピア認証ポートが 5061 に設定されているように IM and Presence サービスのアプリケーション リスナーが設定されていることを確認します。
IM and Presence サービス証明書が Microsoft のサーバと同じ認証局によって署名されていることを確認します。
Microsoft サーバまたは IM and Presence サービス証明書が期限切れになっていないことを確認します。
Microsoft のサーバ証明書がサーバ認証とクライアント認証の両方に設定されていることを確認します。
IM and Presence サービス TLS ピア サブジェクト リストに、TLS ハンドシェイク時に Microsoft サーバによって提供される証明に使用される件名共通名(CN)が含まれることを確認します。
IM and Presence サービス TLS ピア認証 TLS コンテキストが正しく設定されており、すべての TLS ピア サブジェクトが選択されていることを確認します。
Microsoft Lync ユーザまたは Microsoft Office Communicator ユーザが Cisco Unified Personal Communicator の連絡先リストに追加されると、不正な SIP URI がそのユーザに指定される
トラブルシューティングの手順
Cisco Unified Personal Communicator レジストリの設定が正しいこと、特に LDAP_AttributeName_uri and LDAP_UriSchemeName サブキーが正しいことを確認します。 詳細は、『Configuration and Administration of IM and Presence Service on Cisco Unified Communications Manager( Cisco Unified Communications Manager での IM and Presence サービスの設定および管理)』の Active Directory の設定に関連する章を参照してください。
Cisco Unified Personal Communicator 上の Microsoft Lync または Microsoft Office Communicator の連絡先に表示名が表示されない
トラブルシューティングの手順
Cisco Unified Personal Communicator レジストリの設定が正しいこと、特に LDAP_AttributeName_uri and LDAP_UriSchemeName サブキーが正しいことを確認します。 詳細は、『Configuration and Administration of IM and Presence Service on Cisco Unified Communications Manager( Cisco Unified Communications Manager での IM and Presence サービスの設定および管理)』の Active Directory の設定に関連するトピックを参照してください。
ユーザ移行のトラブルシューティング
ここでは、ユーザ移行のトレースとユーザ移行の一般的な問題について説明します。
ユーザ移行のトレース
ここでは、ユーザ移行のトレースに使用されるツールについて説明します。
- 連絡先リスト エクスポート ツール
- アカウント無効化ツール
- アカウント削除ツール
- IM and Presence BAT による連絡先リストのインポート
- IM and Presence サービス一括管理ツールの連絡先の名前変更
連絡先リスト エクスポート ツール
連絡先リスト エクスポート ツールを使用すると、管理者はユーザの移行用に Lync/OCS から連絡先リストを一括でエクスポートすることができます。 ツールを実行するたびに、ExportContactsLog<Timestamp>.txt と呼ばれるログ ファイルが生成されます。 ログファイルには、発生した障害やエラーに関する詳細が含まれています。 ログファイルは、ツール自体と同じ場所に保存されます。
連絡先リスト エクスポート ツールのログ ファイルの例は次のとおりです。
>>------------------- 18/05/2011 16:59:38 ------------------->>Version: 2.1 [DEBUG] Enter>> ExportContacts.LdapConnection.CreateLdapDirectoryEntry [DEBUG] Enter>> ExportContacts.LdapConnection.CreateDirectoryEntry [DEBUG] Enter>> ExportContacts.LdapConnection.checkLdapPrefix [DEBUG] Exit>> ExportContacts.LdapConnection.checkLdapPrefix [DEBUG] Exit>> ExportContacts.LdapConnection.CreateDirectoryEntry [DEBUG] Current line item is: sip:ExampleUser@dtstfedcup2.com [DEBUG] Exit>> ExportContacts.ExportContactsUtilities.getAllSipUriFromStandardFile [DEBUG] Enter>> ExportContacts.ExportContactsUtilities.getAndPrintContactsForUsers [DEBUG] Total number of users found is: 1 [DEBUG] Processing user number: 1 [INFO] Preparing to get contacts for User [sip:ExampleUser@dtstfedcup2.com] [DEBUG] Enter>> ExportContacts.OcsWmiConnection.getContactsAndGroupsForUser [DEBUG] Enter>> ExportContacts.OcsWmiConnection.getUserInstanceID [DEBUG] Searching for userInstanceId [SELECT * FROM MSFT_SIPESUserSetting WHERE PrimaryURI = 'sip:ExampleUser@dtstfedcup2.com'] [DEBUG] Enter>> ExportContacts.OcsWmiConnection.GetScope [DEBUG] Exit>> ExportContacts.OcsWmiConnection.GetScope [DEBUG] Search results returned [DEBUG] Found user with PrimaryURI : sip:ExampleUser@dtstfedcup2.com, InstanceId : {7D777FD5-A8F6-8243-B4D6-7F331008C58C} [DEBUG] Exit>> ExportContacts.OcsWmiConnection.getUserInstanceID [DEBUG] Enter>> ExportContacts.OcsWmiConnection.getContacts [DEBUG] Searching for contacts [SELECT * FROM MSFT_SIPESUserContactData WHERE UserInstanceID = '{7D777FD5-A8F6-8243-B4D6-7F331008C58C}'] [DEBUG] Enter>> ExportContacts.OcsWmiConnection.GetScope [DEBUG] Exit>> ExportContacts.OcsWmiConnection.GetScope [DEBUG] Search results returned [DEBUG] Found contact: SIPURI : [SIP:lyncContact@dtstfedcup2.com] with GroupId: [1] [DEBUG] Found contact: SIPURI : [SIP:ExampleUser@dtstfedcup2.com] with GroupId: [1] [DEBUG] Exit>> ExportContacts.OcsWmiConnection.getContacts [DEBUG] Enter>> ExportContacts.OcsWmiConnection.getGroups [DEBUG] Searching for groups [SELECT * FROM MSFT_SIPESUserContactGroupData WHERE UserInstanceID = '{7D777FD5-A8F6-8243-B4D6-7F331008C58C}'] [DEBUG] Enter>> ExportContacts.OcsWmiConnection.GetScope [DEBUG] Exit>> ExportContacts.OcsWmiConnection.GetScope [DEBUG] Search results returned [DEBUG] Found group: groupName : [General] with GroupId: [1] [DEBUG] Exit>> ExportContacts.OcsWmiConnection.getGroups [INFO] User Processed Successfully [DEBUG] Exit>> ExportContacts.OcsWmiConnection.getContactsAndGroupsForUser [DEBUG] Enter>> ExportContacts.ExportContactsUtilities.PrintContactsForUser [DEBUG] Exit>> ExportContacts.ExportContactsUtilities.PrintContactsForUser [DEBUG] Exit>> ExportContacts.ExportContactsUtilities.getAndPrintContactsForUsers [INFO] Summary: [INFO] 1 users successfully processed [INFO] 0 users not found [INFO] 0 users could not be processed due to errors <<------------------- 18/05/2011 16:59:41 -------------------<<アカウント無効化ツール
アカウント無効化ツールは、Active Directory(AD)に接続し、ユーザの Lync/OCS 属性を更新して Microsoft サーバ カウントを無効にします。 ツールを実行するたびに、DisableAccountLog<Timestamp>.txt と呼ばれるログ ファイルが生成されます。 ログファイルには、発生した障害やエラーに関する詳細が含まれています。 ログファイルは、ツール自体と同じ場所に保存されます。
このツールでエラーが発生する一般的な原因の一部は次のとおりです。
不正な入力ファイル名が指定された
入力ファイルの中にスペルミスがある
ユーザは、Microsoft サーバ データベースに存在しません
ツールを実行している管理者が AD に対する読み取り/書き込み権限を持っていない
このツールによって AD に変更内容が適用され、Microsoft サーバ データベースまで伝播するのに必要な時間を管理者が十分に設けていない。 変更が Microsoft サーバ データベースに反映されていることを検証せずに、管理者が次の移行ステップに進んだ場合、移行が失敗することがある。
アカウント無効化ツールのログ ファイルの例は次のとおりです。
>>------------------- 18/05/2011 17:02:07 ------------------->>Version: 2.0 [DEBUG] Enter>> DisableAccount.LdapConnection.CreateLdapDirectoryEntry [DEBUG] Enter>> DisableAccount.LdapConnection.CreateDirectoryEntry [DEBUG] Enter>> DisableAccount.LdapConnection.checkLdapPrefix [DEBUG] Exit>> DisableAccount.LdapConnection.checkLdapPrefix [DEBUG] Exit>> DisableAccount.LdapConnection.CreateDirectoryEntry [DEBUG] Enter>> DisableAccount.AccountDisable.DisableUsersInFile [DEBUG] Enter>> DisableAccount.AccountDisable.GetSipUriFromLine [DEBUG] Exit>> DisableAccount.AccountDisable.GetSipUriFromLine [INFO] Preparing to Disable Communications Server Account for User [sip:ExampleUser@dtstfedcup2.com] [DEBUG] Enter>> DisableAccount.LdapConnection.DisableAccount [INFO] Searching for user [sip:ExampleUser@dtstfedcup2.com] [INFO] Search results returned [DEBUG] Enter>> DisableAccount.LdapConnection.CreateLdapDirectoryEntry [DEBUG] Enter>> DisableAccount.LdapConnection.CreateDirectoryEntry [DEBUG] Enter>> DisableAccount.LdapConnection.checkLdapPrefix [DEBUG] Exit>> DisableAccount.LdapConnection.checkLdapPrefix [DEBUG] Exit>> DisableAccount.LdapConnection.CreateDirectoryEntry [INFO] Found user with PrimaryURI : sip:ExampleUser@dtstfedcup2.com, DisplayName : Example User, Enabled : True [DEBUG] Committed changes to the AD [INFO] User Account Disabled [DEBUG] Exit>> DisableAccount.LdapConnection.DisableAccount [DEBUG] Enter>> DisableAccount.AccountDisable.GetSipUriFromLine [DEBUG] Exit>> DisableAccount.AccountDisable.DisableUsersInFile [INFO] Summary: [INFO] 1 users successfully processed [INFO] 0 users not found [INFO] 0 users could not be processed due to errors <<------------------- 18/05/2011 17:02:08 -------------------<<アカウント無効化ツールの使用方法の詳細については、移行するユーザの Microsoft のサーバ アカウントの無効化に関連するトピックを参照してください。
アカウント削除ツール
アカウント削除ツールを使用すると、移行するユーザを削除することで、それらのユーザへのプレゼンス要求が後から IM and Presence サービス にルーティングされるようにします。その一方で、削除されたユーザは、Lync/OCS に残っているユーザの連絡先リストからは削除されません。 アカウント削除ツールを実行すると、DeleteAccountLog<Timestamp>.txt と呼ばれるログ ファイルがツールと同じディレクトリに生成されます。 ログファイルには、発生した障害やエラーに関する詳細が含まれています。
このツールでエラーが発生する一般的な原因の一部は次のとおりです。
>>------------------- 02/12/2013 15:13:50 ------------------->> Version: 10.x.x-xx [DEBUG] Enter>> DeleteAccount.DbConnectionFactory.GetCommSvrDbCon [DEBUG] Enter>> DeleteAccount.DbConnectionFactory.GetConnection [DEBUG] Attempting to Open connection with String : Server=lyncServer\rtclocal;Database=rtc;Trusted_Connection=yes; [DEBUG] Connection Opened Ok [DEBUG] Exit>> DeleteAccount.DbConnectionFactory.GetConnection [DEBUG] Enter>> DeleteAccount.DbConnectionFactory.tableExists [DEBUG] SQL is [SELECT id FROM sysobjects WHERE name = 'Resource'] [DEBUG] Found id [1077578877] [DEBUG] Exit>> DeleteAccount.DbConnectionFactory.tableExists [INFO] Found the Resource Table, appears to be a valid Communications Server Database [DEBUG] Enter>> DeleteAccount.DbConnectionFactory.tableExists [DEBUG] SQL is [SELECT id FROM sysobjects WHERE name = 'Endpoint'] [DEBUG] No result [DEBUG] Exit>> DeleteAccount.DbConnectionFactory.tableExists [DEBUG] Enter>> DeleteAccount.DbConnectionFactory.tableExists [DEBUG] SQL is [SELECT id FROM sysobjects WHERE name = 'Container'] [DEBUG] Found id [1202103323] [DEBUG] Exit>> DeleteAccount.DbConnectionFactory.tableExists [DEBUG] Enter>> DeleteAccount.DbConnectionFactory.tableExists [DEBUG] SQL is [SELECT id FROM sysobjects WHERE name = 'HomedResource'] [DEBUG] No result [DEBUG] Exit>> DeleteAccount.DbConnectionFactory.tableExists [DEBUG] Enter>> DeleteAccount.DbConnectionFactory.tableExists [DEBUG] SQL is [SELECT id FROM sysobjects WHERE name = 'CertificateStore'] [DEBUG] Found id [1826105546] [DEBUG] Exit>> DeleteAccount.DbConnectionFactory.tableExists [INFO] Found the CertificateStore table, dealing with a version of Lync. [DEBUG] Enter>> DeleteAccount.DbConnectionFactory.tableExists [DEBUG] SQL is [SELECT id FROM sysobjects WHERE name = 'ForestDirectory'] [DEBUG] Found id [853578079] [DEBUG] Exit>> DeleteAccount.DbConnectionFactory.tableExists [INFO] Found the ForestDirectory table, Creating Lync2013 Connection [DEBUG] Exit>> DeleteAccount.DbConnectionFactory.GetCommSvrDbCon [DEBUG] Enter>> DeleteAccount.CommSvrDbConnection.CheckConnection [DEBUG] Enter>> DeleteAccount.CommSvrDbConnection.GetConnection [DEBUG] Exit>> DeleteAccount.CommSvrDbConnection.GetConnection [DEBUG] Exit>> DeleteAccount.CommSvrDbConnection.CheckConnection [DEBUG] Enter>> DeleteAccount.DeleteUserData.DisableUsersInFile [DEBUG] Enter>> DeleteAccount.DeleteUserData.GetUserAtHostFromLine [DEBUG] Exit>> DeleteAccount.DeleteUserData.GetUserAtHostFromLine [INFO] Preparing to Delete Communications Server Data for User [lyncUser@lyncDomain.net] [DEBUG] Enter>> DeleteAccount.DeleteUserData.DeleteOcsUserData [DEBUG] Enter>> DeleteAccount.CommSvrDbConnection.GetResourceIdForUser [DEBUG] Enter>> DeleteAccount.CommSvrDbConnection.GetConnection [DEBUG] Exit>> DeleteAccount.CommSvrDbConnection.GetConnection [DEBUG] Enter>> DeleteAccount.CommSvrDbConnection.SqlEscape [DEBUG] Exit>> DeleteAccount.CommSvrDbConnection.SqlEscape [DEBUG] Exit>> DeleteAccount.CommSvrDbConnection.GetResourceIdForUser [INFO] Found user [lyncUser06@cork.com] with ResourceId [1010], proceeding to delete data [DEBUG] Enter>> DeleteAccount.Lync2013DbConnection.DeleteResourceDirectory [DEBUG] Enter>> DeleteAccount.CommSvrDbConnection.GetConnection [DEBUG] Exit>> DeleteAccount.CommSvrDbConnection.GetConnection [DEBUG] Ran dbo.RtcpDeleteHomedResourceTransaction for resource [1010] [DEBUG] Deleted CachedContainerMember for resource [1010] [DEBUG] Deleted ContainerMemberUser for resource [1010] [DEBUG] Deleted PromptedSubscriber for resource [1010] [DEBUG] Deleted Delegate for resource [1010] [DEBUG] Ran RtcpDeleteConferenceParticipantByEnterpriseId for resource [1010] [DEBUG] Deleted UserPolicy for resource [1010] [DEBUG] Deleted ResourcePhone for resource [1010] [DEBUG] Deleted RtcItem for resource [1010] [DEBUG] Deleted PUIDDirectory for resource [1010] [DEBUG] Deleted ResourceDirectory for resource [1010] [DEBUG] Committing transaction for resource [1010] [INFO] Completed Updates for resource [1010] [DEBUG] Exit>> DeleteAccount.Lync2013DbConnection.DeleteResourceDirectory [DEBUG] Exit>> DeleteAccount.DeleteUserData.DeleteOcsUserData [DEBUG] Enter>> DeleteAccount.DeleteUserData.GetUserAtHostFromLine [DEBUG] Exit>> DeleteAccount.DeleteUserData.GetUserAtHostFromLine [DEBUG] Exit>> DeleteAccount.DeleteUserData.DisableUsersInFile Summary: Users successfully processed: 1 Users not found: 0 Users not processed due to errors: 0 <<------------------- 02/12/2013 15:13:50 -------------------<<アカウント削除ツールの使用方法の詳細については、移行するユーザのデータベースからユーザ データを削除することに関するトピックを参照してください。
IM and Presence BAT による連絡先リストのインポート
IM and Presence サービス 一括管理ツール(BAT)は、連絡先リストのインポート ジョブの結果をログ ファイルに書き込みます。 ログ ファイルには、次の情報が含まれています。
- 正常にインポートされた連絡先の数。
- 連絡先をインポートしようとした際に発生した内部サーバ エラーの数。
- インポートされなかった(無視された)連絡先の数。 ログ ファイルには、無視されたそれぞれの連絡先の理由がログ ファイルの末尾に記載されます。
- BAT ジョブを早期に終了させたエラーが原因で処理されなかった CSV ファイル内の連絡先の数。 このエラーは滅多に起こりません。
このログ ファイルにアクセスするには、次の手順を実行します。
[Cisco Unified IM and Presence Administration(Cisco Unified IM and Presence Administration)] ユーザ インターフェイスにログインします。 を選択します。
[Find(検索)] を選択し、連絡先リストのインポート ジョブのジョブ ID を選択します。
[Log File Name(ログ ファイル名)] リンクを選択し、ログを開きます。
任意の BAT ジョブの詳細が必要な場合は、一括プロビジョニング サービスのデバッグ ログを参照してください。 これらのログには、/var/log/active/cm/trace/bps/log4j/bps000*.txt からアクセスできます。
一括プロビジョニング サービスのデバッグ ロギングは、[Cisco Unified IM and Presence Serviceability(Cisco Unified IM and Presence Serviceability)] ユーザ インターフェイスから有効にできます。
IM and Presence サービスでの一括プロビジョニング サービス ロギングの設定
手順次の手順では、IM and Presence サービスで一括プロビジョニング サービスでロギングを設定する方法について説明します。
注意
デバッグ レベル トレースは、システム パフォーマンスに影響を与えることがあります。 必要なときにのみデバッグ トレース レベルを有効にし、システム調査が完了した後、ログの設定をデフォルトにリセットします。
関連資料
IM and Presence サービス一括管理ツールの連絡先の名前変更
IM and Presence サービス一括管理ツール(BAT)により、ある形式から別の形式にユーザの連絡先リストのコンタクト ID(JID)の名前を変更できます。 たとえば、firstname.lastname@domain.com から userid@domain.com にユーザのコンタクト ID の名前を変更できます。また、BAT は新しいコンタクト ID で各ユーザの連絡先リストを更新します。
一括管理ツールはコンタクトの名前変更ジョブ結果をログ ファイルに書き込みます。 ログ ファイルには、次の情報が含まれています。
正常に取得された連絡先の数。
連絡先を取得しようとした際に発生した内部サーバ エラーの数。
無視された連絡先の名前変更レコードの数。 ログ ファイルには、それぞれの無視されたレコードの理由がログ ファイルの末尾に記載されます。
一括ジョブが早く終了するエラーが発生したために処理されなかった CSV ファイル内の連絡先の名前変更レコードの数。 このエラーは滅多に起こりません。
これらの連絡先の変更内容が通知されたユーザの数。
これらの連絡先の変更内容が通知されなかったユーザの数。
このログ ファイルにアクセスするには、次の手順を実行します。
[Cisco Unified CM IM and Presence Administration(Cisco Unified CM IM and Presence 管理)] ユーザ インターフェイスにログインします。 を選択します。
[Find(検索)] をクリックし、連絡先の名前変更ジョブのジョブ ID を選択します。
[Log File Name(ログ ファイル名)] リンクを選択し、ログを開きます。
エラー発生の一般的な理由は次のとおりです。
Cisco XCP ルータのサービスがクラスタ内のノードで停止する。
アップロードされた CSV ファイルの形式が誤っている。 ファイル形式が正しいことと、そのファイルにヘッダーがあることを確認する必要があります。 ファイル形式の詳細については、コンタクト ID の名前変更に関するトピックを参照してください。
コンタクト ID に無効な文字が含まれているか、最大許容長を超えている。
任意の一括管理ジョブの詳細が必要な場合は、一括プロビジョニング サービスのデバッグ ログを参照してください。 これらのログには、/var/log/active/cm/trace/bps/log4j/bps000*.txt からアクセスできます。
一括プロビジョニング サービスのデバッグ ロギングは、[Cisco Unified Serviceability] ユーザ インターフェイスから有効にできます。 詳細については、デバッグ ロギングおよび一括プロビジョニング サービス ロギングに関するトピックを参照してください。
ユーザ移行の一般的な問題
- アプリケーションが正しく初期化できない - ユーザ移行ツールのいずれかを実行しているときにエラーが発生する
- 連絡先リスト エクスポート ツールが Lync ユーザ用の出力ファイルを生成しない
- 連絡先リスト エクスポート ツールのログに getAndPrintContactsForUsers エラーが表示される
- 連絡先リスト エクスポート ツール:ログの概要にいくつかのユーザが見つからないと表示される
- 連絡先リスト エクスポート ツール:通常モードで実行すると、ツールは経過表示バーを表示せず、エクスポートされた連絡先の出力ファイルを生成しない
- アカウント無効化ツール:ログには、IP/FQDN/ホスト名を使用して LDAP に接続できないことが記載されている
- アカウント削除ツール:Microsoft サーバ データベースまたはサーバ インスタンスが見つからない
- アカウント削除ツール:SQL Server への接続中にログにエラーが表示される
- BAT 連絡先リストの更新:アップロードされた連絡先リスト ファイルがドロップダウン リストに表示されない
- BAT 連絡先リストの更新:BAT ジョブの後にログ ファイルが結果ページ上に存在しない
- BAT 連絡先リストの更新:ユーザの連絡先が BAT ジョブ中にインポートされない
- BAT 連絡先リストの更新:ユーザの連絡先が BAT ジョブ中に部分的にインポートされる
- BAT 連絡先リストの更新:連絡先が BAT ジョブ中にインポートされない
- ユーザ ステータスの移行は、移行プロセス中に Microsoft サーバ ユーザに対して [ステータスが不明(Status Unknown)] または [プレゼンスが不明(Presence Unknown)] と表示される
アプリケーションが正しく初期化できない - ユーザ移行ツールのいずれかを実行しているときにエラーが発生する
トラブルシューティングの手順
ユーザ移行ツールのいずれかを実行しようとすると、「Application failed to initialize properly(アプリケーションが正常な初期化に失敗しました)」というエラーが表示される場合があります。 このエラーの原因は、.NET 2.0 フレームワークのインストールされていないユーザ移行ツールを実行しようとしていることです。 シスコが提供する各ユーザ移行ツールを使用するには、.NET Framework の少なくともバージョン 2.0 が、そのツールを実行している場所からサーバにインストールされている必要があります。
NET 2.0 フレームワークは、Windows Server 2003 R2 以降で標準としてインストールされています。
連絡先リスト エクスポート ツールが Lync ユーザ用の出力ファイルを生成しない
連絡先リスト エクスポート ツールのログに getAndPrintContactsForUsers エラーが表示される
トラブルシューティングの手順
Lync ユーザのエクスポート ツールを実行したときに「Error occurred in getAndPrintContactsForUsers(getAndPrintContactsForUsers でエラーが発生しました)」というエラーがログに表示された場合は、連絡先リスト エクスポート ツールは、Lync データベースに接続できません。 ツールを実行しているユーザ アカウントに Lync データベースの適切な読み取り権限があることを確認します。 dbo 実行アカウント権限が RTC データベースに許可されていることを確認します。 問題が解決しない場合は、データベース インスタンスの名前に入力ミスがないことを確認します。
連絡先リスト エクスポート ツール:ログの概要にいくつかのユーザが見つからないと表示される
トラブルシューティングの手順
IM and Presence サービス のエクスポート済みファイルを入力として使用する場合は、正しいドメインが -d/ パラメータに使用され、ファイル内に入力ミスがないことを確認してください。
SIP URI ファイルを入力ファイルとして使用している場合は、ユーザが有効(Active Directory [AD] および Lync/OCS に存在する)で、入力ファイルに "sip:" プレフィックス付きで正しく入力されていることを確認します。
IM and Presence サービス のエクスポート済みファイルあるいは SIP URI ファイルを入力として使用していない場合、または OU 入力ファイルを使用している場合、ユーザ アカウントは AD の中で無効になっている可能性が高いです。 ユーザ アカウントを再度有効にし、このツールを再度実行してください。
連絡先リスト エクスポート ツール:通常モードで実行すると、ツールは経過表示バーを表示せず、エクスポートされた連絡先の出力ファイルを生成しない
トラブルシューティングの手順
連絡先リスト エクスポートのログに次のエラーがないか確認します。「次の IP/FQDN/ホスト名を使用して LDAP に接続することができません:[some_ip_or_hostname](Unable to connect to LDAP using IP/FQDN/Hostname: [some_ip_or_hostname])」
連絡先リスト エクスポートのログに次のエラーがないか確認します。「ファイルを開くことに失敗しました…(Failed to open file…)」
OCS のエクスポートの連絡先リスト ツールを実行する場合は、データベース インスタンス パラメータを入力していないことを確認します。 データベース インスタンスのパラメータは、Lync からのみ連絡先をエクスポートするために必要です。
アカウント削除ツール:Microsoft サーバ データベースまたはサーバ インスタンスが見つからない
BAT 連絡先リストの更新:アップロードされた連絡先リスト ファイルがドロップダウン リストに表示されない
トラブルシューティングの手順
[Cisco Unified Communications Manager IM and Presence Administration(Cisco Unified Communications Manager IM and Presence 管理)] ユーザ インターフェイスにログインします。 を選択し、[Find(検索)] をクリックします。
ファイルが存在し、その機能タイプが [ユーザの連絡先のインポート - カスタム ファイル(Import Users' Contacts – Custom File)] であることを確認します。
不正な機能タイプのファイルが存在する場合、そのファイルを削除します。 ファイルを削除したか、ファイルが存在しない場合は、もう一度ファイルをアップロードし、そのターゲットが [連絡先リスト(Contact Lists)] であり、そのトランザクション タイプが [ユーザの連絡先のインポート - カスタム ファイル(Import Users' Contacts – Custom File)] であることを確認します。
ユーザ ステータスの移行は、移行プロセス中に Microsoft サーバ ユーザに対して [ステータスが不明(Status Unknown)] または [プレゼンスが不明(Presence Unknown)] と表示される
トラブルシューティングの手順
このドキュメントで説明したように、連絡先が IM and Presence サービスに完全に移行されていることを確認します。
移行プロセス中、移行連絡先を Microsoft Lync または Microsoft Office Communicator ユーザが利用できない期間があります。 シスコでは、そのような問題がなるべく発生しないようにするために、予定されたメンテナンス ウィンドウの中でユーザ移行を実行することをお勧めします。
Microsoft Lync または Microsoft Office Communicator ユーザにログアウトしてから再度ログインするよう要求します。
移行された連絡先が IM and Presence サービスにインポートされても、Microsoft サーバ ユーザには、クライアントからサインアウトしてサインインするまでそれらの連絡先のプレゼンスは表示されません。
問題が解決しない場合は、このドキュメントで説明したように移行手順が正しく実行されたことを確認します。
それでも移行した連絡先が [Presence Unknown(プレゼンスが不明)]" "と表示される場合は、IM and Presence サービス と Microsoft サーバとの間の統合に問題がある可能性があります。 統合の問題のトラブルシューティングに関するヘルプについては、統合の一般的な問題を参照してください。