この節では、インストール、設定、起動、または Communications Express ユーザーインタフェースクライアントコンポーネントにアクセスしているときに、発生する可能性のある問題の概要を説明します。
次のリストは、Communications Express コンポーネントで一般に判明している問題の一部とその考えられる原因です。
Web コンテナを再起動しても、設定の変更が反映されない
設定の変更が適切な設定パス内のファイルに適用されていることを確認します。
Communications Express 設定が完了すると、次に示す設定ディレクトリがシステムに作成されます。
uwc-deployed-path/staging/WEB-INF/config
uwc-basedir/SUNWuwc/WEB-INF/config
変更内容がアプリケーションに反映されるようにするには、設定の変更を uwc-deployed-path/WEB-INF/config に行うようにします。
uwc-deployed-path/staging/WEB-INF/config および uwc-basedir/SUNWuwc/WEB-INF/config の 2 つのディレクトリは、設定プログラムが設定中に内部的に作成して使用している一時的なプレースホルダです。これらのディレクトリ内への変更は、アプリケーションに反映されません。
設定タスクが失敗した
問題を特定するには、uwc-basedir/SUNWuwc/install/uwc-config _TIME-STAMP.log にあるログファイルを使用します。
TIME-STAMP は設定のタイムスタンプであり、YYYYMMDDhhmmss という形式です。
設定プログラムが正しく動作しない
問題を特定するには、次に示すデバッグモードを使用してデバッグオプションを有効にし、設定プログラムを呼び出します。
-debug: 一般的なデバッグ情報を生成する。
-debugMessage: エラーおよび警告のログを生成する。
-debugWarning: 警告メッセージおよびエラーメッセージのログを生成する。
-debugError: エラーメッセージのログを生成する。デフォルトではこのオプションが有効です。
UWC アプリケーションの起動に失敗し、Web コンテナのログには例外が示される
このエラーは、設定が不完全であるか不正である場合に発生することがあります。
回避策
すべての設定後の手順を終えていることを確認します。設定後の手順については、第 2 章「Communications Express の概要」の 「設定後の手順」を参照してください。
設定中に、「chown」コマンドが失敗する
回避策
設定プログラムを実行し、「Web コンテナのユーザーとグループ」パネルで Web コンテナユーザーおよびグループに正しい値を入力します。
認証後に Access Manager が有効な状態で Communications Express にアクセスすると、「この処理の実行中にエラーが発生しました」というメッセージが表示される
回避策
uwc-deployed-path/WEB_INF/config/uwcauth.properties 内の uwcauth.identity.binddn および uwcauth.identity.bindcred プロパティーに、Access Manager SDK をインストールしたときに指定した amAdmin DN のプロパティーが設定されていることを確認します。「uwcauth.properties ファイルでの Access Manager パラメータの設定」の節を参照してください。
Access Manager SSO のために uwcauth.identity.binddn と uwcauth.indentity.bindcred にディレクトリ管理者の資格が指定される可能性がありますが、ディレクトリ管理者には、Communications Express が正常に機能するのに必須の特定のドメイン固有属性を取得するために必要な ACL がありません。
Access Manager SDK 統合用に Web コンテナ設定を変更するためのサポートがない
設定プログラムは、Access Manager SDK 統合用の Web コンテナ設定の変更をサポートしていません。
回避策
Access Manager に用意されているツールを手動で呼び出し、Access Manager 用の Web コンテナ設定を変更します。
SSL で Messaging SSO がサポートされていない
回避策
SSL による Messaging SSO をサポートするには、次の手順に従います。
Web Server を SSL モードで設定します。
Communications Express で Web Server の SSL ポートを設定します。
uwcauth.ssl.enabled=true を設定します。
uwcauth.https.port に Web Server の SSL ポートを設定します。
Messaging Server を SSL モードで有効にします。
uwcconfig.properties 内の webmail.port に Messaging Server の SSL ポートを設定します。
messagingsso.ims.url に Messaging Server の非 SSL ポートを指定します。
Web Server と Messaging Server の両方に Certificate Management Server ルート認証局 (CMS ルート認証局) をインストールします。
Web Server を再起動します。
local.webmail.sso.ims.verifyurl に、Messaging Server の非 SSL ポートを指す値を指定します。
Messaging Server を再起動します。
Communications Express からカレンダにアクセスすると、「この処理の実行中にエラーが発生しました」というメッセージが表示される
このエラーは、次のどれか 1 つ以上の理由で表示されることがあります。
uwc-deployed-path/WEB_INF/config/uwcconfig.properties の Calendar Server の設定が正しくない
Communications Express の uwcconfig.properties ファイル内の Calendar Server の calmaster 情報が、Calendar Server の cal deploy path/bin/config/ics.conf ファイル内の値と同じでない
「uwcconfig.properties ファイルでの Calendar Server のパラメータの設定」を参照してください。
Communications Express と Calendar Server の両方が、ホストドメインで有効でない
Communications Express と Calendar Server の両方が仮想ドメインに対して有効になっているか、または両方が仮想ドメインに対して無効になっているかのどちらかであることを確認してください。Communications Express および Calendar Server を仮想ドメインに対して有効にする方法の詳細については、「カレンダでのホストドメイン設定の有効化」を参照してください。
Calendar Server が開始していない
カレンダーサービスがこのユーザーで利用できない
Communications Express からカレンダにアクセスすると、「カレンダを使用できません。表示できませんでした。選択したカレンダは削除されたか、存在していません。または、表示するための権限がありません。別のカレンダを選択してください」というメッセージが表示される
このエラーは、ユーザーが Schema 2 で使用される commcli を使用して、ホストされていないドメインのセットアップシナリオでプロビジョニングしている場合に起こります。このエラーメッセージは、commcli がユーザーの LDAP エントリ内の icsCalendar 属性の値に @domain を誤って付加しているために表示されます。
回避策
ホストされていないドメイン環境で commcli を使用してユーザーをプロビジョニングする場合は、commadmin コマンドで -k legacy オプションを使用します。ホストドメイン環境の場合は、-k hosted オプションを使用します。-k オプションを指定しない場合は、ホストドメインのセットアップと見なされます。
例
./commadmin user create -D admin -w password -X siroe .varrius .com -n siroe.varrius.com -p 85 -d siroe.varrius.com -F test -L user2 -l user2 -W user2 -S mail,cal -k legacy ok |
または
すでにプロビジョニングされているユーザーに対応するエントリを削除できない場合は、icsCalendar、icsSubscribed、および icsOwned 属性から \q@domain \q の部分を手動で削除します。
Communications Express からドメインにわたるカレンダの可用性を検索、招待、登録、または確認すると、「ドメインにわたるカレンダを検索できません」、「ドメインにわたるカレンダを招待できません」、「ドメインにわたるカレンダを登録できません」、または「ドメインにわたるカレンダの可用性の確認を実行できません」というメッセージが表示される
回避策
カレンダの可用性を検索、招待、登録、または確認するには、クロスドメイン検索を有効にする必要があります。『Sun Java System Calendar Server 6 2005Q1 管理ガイド』の第 13 章にある「クロスドメイン検索の有効化」の節を参照してください。
デフォルトの予定状況フィルタに関する問題
「カレンダのオプション」ウィンドウにあるデフォルトの予定状況フィルタは、日別、週別、および月別のカレンダ表示で表示する予定を指定します。選択可能なオプションは、次のとおりです。「受諾済み」、「暫定」、「辞退済み」、「返信なし」。
予定状況として「受諾済み」オプションが選択されていると、日別、週別、または月別のカレンダ表示には受諾済みの出席依頼だけが表示されます。ただし、作成した予定はすべて、日別、週別、または月別のカレンダ表示に常に表示されます。
「カレンダのオプション」ウィンドウでは、デフォルトでは「受諾済み」と「暫定」だけが選択されています。 つまり、ユーザーには、辞退済みの予定や、まだ返信していない予定は表示されません。
回避策
日別、週別、月別、および年別表示にすべての予定を表示するには、「カレンダのオプション」ウィンドウですべてのオプション、つまり、「受諾済み」、「暫定」、「辞退済み」、「返信なし」を選択してください。
2M バイトを超えるファイルのアップロード中に Communications Express で「サーバーエラー」が表示される
このエラーは、アップロードされるファイルのサイズが 2M バイトより大きい場合に、予定や作業のカレンダへのインポート中または連絡先のアドレス帳へのインポート中に発生します。
デフォルトでは、Communications Express でインポートできるのは 2M バイトまでのファイルデータです。ただし、アップロードファイルのサイズ制限は設定できます。
回避策
アップロードファイルのサイズ制限を大きな値に設定します。
アップロードファイルのサイズ制限を大きな値に設定するには、web.xml 内のフィルタ MultipartFormServletFilter の、次に示す初期化パラメータを設定します。
fileSizeHardLimit: エラーが発生し、要求処理が停止されるまでにアップロードされるファイルコンテンツの最大のバイトサイズを指定します。たとえば、ユーザーが 1 つの要求で 3 つのファイルをアップロードし、1 つ以上のファイルが fileSizeHardLimit の制限を超えた場合は、すべてのファイルが破棄され、フィルタによってエラー状況が報告されます。
requestSizeLimit: 着信要求全体の最大のバイトサイズを指定します。要求がこの制限に違反している場合は、要求処理が停止され、入力ストリームは破棄されます。次に、フィルタはこの違反を、コンテンツサイズの強い制限値違反として処理します。この制限のデフォルト値は 4M バイトです。
fileSizeLimit: アップロードされるファイルコンテンツの最大のバイトサイズを指定します。たとえば、ユーザーが 1 つの要求で 3 つのファイルをアップロードする場合は、これらのファイルのいずれもこの制限を超えることはできません。この制限は弱い制限値です。つまり、アップロードされるコンテンツがこの制限を超えた場合、そのコンテンツは破棄されますが、要求は引き続き正常に処理されるため、サイズの違反をアプリケーションで処理できます。この制限のデフォルト値は 1M バイトです。
failureRedirectURL (省略可能): エラーが発生した場合に要求が転送されるリダイレクト URL を指定します。リダイレクト URL は、failureRedirectURL 初期化パラメータで設定できます。リダイレクト URL が指定されていない場合は、フィルタによって例外がスローされ、要求はただちに終了されます。この制限のデフォルト値は 2M バイトです。
たとえば、アップロードファイルのサイズを 10M バイトに増やすには、次の設定手順に従います。
uwc-deployed-path/WEB-INF/web.xml から、既存の web.xml のバックアップを取ります。
uwc-deployed-path/WEB-INF/web.xml で、web.xml ファイルを編集します。
web.xml 内の MultipartFormServletFilter の設定を、コード例 5-2 の太字で示すように指定します。
<web-app\> .. .. <filter\> <filter-name\>MultipartFormServletFilter</filter-name\> <filter-class\>com.sun.uwc.calclient.MultipartFormServletFilter</filter-class\> .. .. <init-param\> <param-name\>fileSizeHardLimit</param-name\> <param-value\>10485760</param-value\> <description\>Ten mega bytes</description\> </init-param\> <init-param\> <param-name\>requestSizeLimit</param-name\> <param-value\>10485760</param-value\> <description\>Ten mega bytes</description\> </init-param\> <init-param\> <param-name\>fileSizeLimit</param-name\> <param-value\>10485760</param-value\> <description\>Ten mega bytes</description\> </init-param\> <init-param\> <param-name\>failureRedirectURL</param-name\> <param-value\>put your url here</param-value\> <description\>Request is redirected to this url when uploaded file size crosses fileSizeHardLimit value</description\> </init-param\> .. .. </filter\> .. .. .. .. </web-app\> |
Web コンテナを再起動して、変更内容を有効にします。
アドレス帳にアクセスすると「サーバーエラー」が発生する。Web Server のログには次の例外が記録されている。「org.apache.xml.utils.WrappedRuntimeException:The output format must have a ’{http://xml.apache.org/xslt}content-handler’ property!」
この例外は、JDK Web Server が JDK 1.4.2 未満のバージョンを指しているときに、Web Server がスローします。Communications Express では、XML/XSL の構文解析に、xalan および xerces の最新バージョンを使用します。このエラーは、次の場合に表示されることがあります。
JES インストーラで配備されていない Web Server 6.1 を使用している。Web Server 6.1 には通常、JDK 1.4.1 が同梱されています。
Java Enterprise System に含まれている共有 xalan および xerces コンポーネントのバージョンが最新ではない。
回避策
このエラーが、Web Server を JES インストーラからインストールしていないために表示されている場合は、server.xml Web Server 設定ファイル内で java タグの java_home 属性として定義されている Web コンテナの JDK バージョンを手動でアップグレードします。
または
Web Server を Java Enterprise System から再インストールして、インストールプロセスによって JDK が自動的にアップグレードされるようにします。
この手順を実行すると、その他の Web アプリケーションをすべて再配備する必要があります。万が一に備えて、server.xml ファイルのバックアップを取得しておいてください。
このエラーが、共有 xalan および xerces コンポーネントのバージョンが最新でないために表示されている場合は、uwc-deployed-path/WEB-INF/lib から xalan.jar および xerces.jar のシンボリックリンクを削除します。
例
# cd /var/opt/SUNWuwc/WEB-INF/lib
# rm xalan.jar xercesImpl.jar
次に、Web Server を再起動します。
Communications Express からアドレス帳にアクセスすると、「この処理の実行中にエラーが発生しました」というメッセージが表示される
このエラーは、個人アドレス帳 (PAB) の LDAP 設定が正しくない場合に発生します。アドレス帳にアクセスすると、Communications Express は個人アドレス帳ストア、つまり PAB 用に設定された LDAP に接続します。個人アドレス帳ストアで接続を確立できない場合は、エラーが表示されます。
回避策
WEB-INF/config/ldappstore/db_config.properties 内の LDAP 設定を確認します。
正しくない設定を編集します。
Communications Express が配備される Web Server を再起動します。
詳細については、「db_config.properties ファイルでの企業ディレクトリパラメータの設定」の節を参照してください。
検索を実行すると、企業ディレクトリにインラインエラーが表示される
企業ディレクトリの LDAP 設定が正しく設定されていない場合に起こります。
回避策.
WEB-INF/config/corp-dir/db_config.properties の LDAP 設定に誤りがないかどうか確認し、誤りを修正して、Communications Express を再起動します。
詳細については、「db_config.properties ファイルでの企業ディレクトリパラメータの設定」の節を参照してください。
企業ディレクトリの連絡先を表示すると、「表示」ウィンドウにエラーが表示される
このエラーは、企業ディレクトリ内の連絡先エントリにアクセスするキーが「uid」でない場合に表示されます。
uid は、Communications Express に設定されたデフォルト値です。
回避策
企業ディレクトリから連絡先にアクセスするには、uwc-deployed-path/WEB-INF/config 内の db_config.properties および xlate-inetorgperson.xml 設定ファイルで、キー値が希望の値に設定されていなければなりません。
これらのファイルに次の変更を加えます。
uwc-deployed-path/WEB-INF/config/WEB-INF/config/corp-dir/db_config.properties で適切なキー値を設定します。
次のファイルで、entry entryID="db:uid" の “uid” の代わりに適切なキーを設定します。
uwc-deployed-path/WEB-INF/config/WEB-INF/config/corp-dir/xlate-inetorgperson.xml
Communications Express が配備される Web Server を再起動します。
詳細については、「db_config.properties ファイルでの企業ディレクトリパラメータの設定」の節を参照してください。
psRoot の値を設定できない
ユーザー設定にある LDAP の属性 psRoot は、アドレス帳サーバーの水平方向のスケーラビリティーのために使用されます。詳細については、「アドレス帳サーバーの水平方向のスケーラビリティーのサポート」を参照してください。配備に、アドレス帳サーバーの水平方向のスケーラビリティーが必要なければ、このエラーは無視してかまいません。
ユーザーが Communications Express に最初にログインすると、psRoot の自動的な設定が試みられます。しかし、この値が自動的に設定されない場合もあります。この状況は、一般に、 Java Enterprise System Directory Server がインストールされていないために、Java Enterprise System Directory Server インストール後の Java Enterprise System の comm_dssetup.p1 が実行されていない場合に発生します。このため、LDAP Schema が更新されていません。
スキーマが更新されていないため、水平方向にスケーラブルなアドレス帳サーバーの配備に psRoot 属性が必要な場合も、この属性を手動で設定できません。
回避策
psRoot 属性の設定を有効にするには、Directory Server を、psRoot 属性を含むように更新します。それには、次の場所にある ipUser オブジェクトクラスの定義に属性 psRoot を含めます。
Directory ServerInstance/ config/schema/99user.ldif
psRoot 属性を含むように Directory Server を更新する必要があるのは、現在の配備で Java Enterprise System Directory Server がインストールされておらず、Java Enterprise System Directory Server インストール後に Java Enterprise System の comm_dssetup.p1 を実行していない場合だけです。
「メール」タブをクリックすると、ログインページが表示される
Communications Express と Messaging Server との間の設定が正しく行われていない場合に、この問題が発生します。Messaging Server と Communications Express がシームレスに動作するには、Messaging Server または Access Manager のシングルサインオンが使用可能でなければなりません。Communications Express を開始する前に、第 2 章「Communications Express の概要」で説明しているシングルサインオン設定の手順に従ってください。
Communications Express からメールにアクセスすると、「この処理の実行中にエラーが発生しました」というメッセージが表示される
このエラーは、Communications Express のメールコンポーネントが配備されていないか、または有効になっていない場合に、Communications Express にログインしているユーザーが「メール」をデフォルトのアプリケーションとして設定した場合に発生します。
回避策
管理者は、ユーザーの LDAP エントリの属性 sunUCDefaultApplication の値を「calendar」または「addressbook」に変更する必要があります。
ユーザーが Communications Express からログアウトしたにもかかわらず、ログインしたままになっている
この問題は、Access Manager (以前の Identity Server) と Communications Express が別のマシンにインストールされており、かつ Access Manager Remote SDK が Communications Express と同じマシンにインストールされている場合に発生します。
回避策
Communications Express がインストールされているマシンで、AMConfig.properties ファイル内の次の設定パラメータを指定します。
com.iplanet.am.notification.url=url-to-access-web-container-of-CommunicationsExpress /servlet/com.iplanet.services.comm.server.PLLRequestServlet
AMConfig.properties ファイルは、IS-SDK-BASEDIR/SUNWam/lib にあります。
メールからアドレス帳機能にアクセスすると、次のような問題が発生する場合がある
カレンダ、アドレス帳、および「オプション」ページに「メール」タブページからアクセスできない。
メール作成ウィンドウで「宛先」をクリックするか、アドレス帳で「メールの送信」をクリックすると、JavaScript エラーが表示される。
メールのオプションが保存されない。
ブラウザで JavaScript を使用してこれらの機能を相互運用させるには、Communications Express と Messenger Express (MEM) を同じホストに配備しなければなりません。
有効なユーザー ID およびパスワードを入力しても認証できない
認証は次のような理由で失敗します。
ユーザーが commcli または Access Manager (以前の Identity Server ) を使用してプロビジョニングされておらず、Sun Java System LDAP Schema v.2 が使用されている。
回避策
Sun Java System LDAP Schema v.2 を使用している場合は、そのユーザーが commcli ユーティリティーまたは Access Manager UI コンソールを使用して追加されていることを確認します。
ログインしようとしているユーザーが組織に存在しない。
uwc-deployed-path/WEB_INF/config/uwcauth.properties に定義されている defaultdomain プロパティは、user@domain の形式のドメイン情報がない場合にユーザー ID を認証するために使用されます。ユーザーがそのドメインの組織ツリー内に存在しない場合は、認証に失敗します。
uwc-deployed-path/WEB_INF/config/ uwcauth.properties にある管理者の資格が正しくない。
詳細については、「uwcauth.properties ファイルでの Access Manager パラメータの設定」を参照してください。