Sun Java System Portal Server 7.1 配備計画ガイド

Portal Server の障害追跡

ここには、Sun Java System Portal Server の障害追跡情報が記載されています。

Portal Server のインストールの障害追跡

Portal Server のログファイルを調べて、Portal Server の配備のインストール段階で発生した可能性のあるエラーを特定することができます。次のセクションでは、ログファイルの場所および情報について説明します。

インストールログファイル

Java Enterprise System インストーラログファイルは次に格納されています。

/var/sadm/install/logs/。これらのログファイルには、インストールされているポータルパッケージおよび基本的な設定ステータスに関する情報が含まれています。ファイルは、次のとおりです。

Java_Enterprise_System_5_Summary_Report_install.timestamp
Java_Enterprise_System_5_install.B.timestamp
Java_Enterprise_System_5_install.A.timestamp
JavaES_Install_log.timestamp

インストールエラーを確認するには

インストールエラーを表示するには、次のコマンドを使用します。

grep -i failed /var/sadm/install/logs/*

例 B–1 Java Enterprise System のインストールログ

 Java_Enterprise_System_5_Summary_Report_install.timestamp 
***********抜粋************ 
Sun Java(TM) System Access Manager 7.1 : Installed, Configured 
Service Registry 3.1 : Installed, Configure After Install 
Sun Java(TM) System Portal Server 7.1 : Installed, Configuration Failed 
Sun Java(TM) System Portal Server Secure Remote Access 7.1 : Installed, Configuration 
Failed 
*************************

JavaES_Install_log.timestamp 
***********抜粋************ 
Creating Portals 
Successfully created Portal: portal1|#] 
[#|2006-11-21T14:22:15+00:00|WARNING|JavaES|JavaESInstall|
_versionID=1.0;_threadID=13;_SourceJavaFile=EntsysConfigurator;
_SourceMethodName=executeCmd(cmdArray);_JavaESMessageID=;_JavaESResourceBundle=| 
Configuration Failed : com.sun.portal.fabric.tasks.ConfigurationException: 
javax.management.MBeanException: 
Exception thrown in operation createAndFinalizeInstance|#] 
****************************

Portal の設定ログファイル

Portal Server の設定ログファイルは、次に格納されています。

/var/opt/SUNWportal/logs/config/portal.fabric.0.0.log

次の例は、Portal の設定ログファイルの一部を示しています。

***********抜粋************
[#|2006-11-21T14:22:14.109+0000|INFO|SJS Portal Server|
debug.com.sun.portal.fabric.config|
ThreadID=10; ClassName=com.sun.portal.fabric.config.PortalConfigurator; 
MethodName=configurePortal; |PSFB_CSPFC0032:Creating Portal Instances|#]
                                                                                
[#|2006-11-21T14:22:14.509+0000|SEVERE|SJS Portal Server|
debug.com.sun.portal.fabric.config|
ThreadID=10; ClassName=com.sun.portal.fabric.config.PortalConfigurator; 
MethodName=createPortalInstances; |PSFB_CSPFC0041:Failed invoking mbean action : 
create instance.
javax.management.MBeanException: Exception thrown in operation 
createAndFinalizeInstance
        at com.sun.jmx.mbeanserver.StandardMetaDataImpl.invoke
(StandardMetaDataImpl.java:435)
Caused by: com.sun.portal.admin.common.PSMBeanException: 
com.sun.portal.fabric.tasks.ValidationException: Could not fetch 
the value of Platform. Please check wadm username and password
****************************

Portal の管理および MBeans ログファイル

Portal の管理および MBeans ログファイルは次にあります。

/var/opt/SUNWportal/logs/admin/portal.0.0.log

設定済みポータルの確認

psadmin コマンドを使用して、どのポータルが設定されているのかを確認できます。次のコマンドは、どのポータルが設定されているかを示します。

入力

PATH=/opt/SUNWportal/bin:/usr/jdk/entsys-j2se/bin:${PATH};export PATH

psadmin list-portals -u amadmin -f /tmp/passwd

出力

Domain: defaultDomain
============================================
Portal: portal1
============================================

Unix プロセスの確認

ポータルが適切に機能するには、次の root 所有プロセスが実行されていることを確認します。この出力を表示するには、ps コマンドを使用します。

Sun Java System Directory Server:

ps -ef | grep dsee

ns-slap -D /var/opt/SUNWdsee/dsins 1 -i /var/opt/SUNWdsee/dsins1/logs/pid

Sun Java System Access Manager:

Web コンテナプロセス (Web Server) を確認します

ps -ef | grep webserv

webservd -d /var/opt/SUNWwbsvr7/https-xxxx.pstest.com/config - r /opt/SUNWwb

Sun Java System Portal Server:

Web コンテナプロセス (Application Server) を確認します

ps -ef | grep appserver

/opt/SUNWappserver/appserver/lib/appservDAS domain1

Cacao サーバー:

cacao プロセスが動作していることを確認します

/usr/ucb/ps -auxww | grep cacao

/usr/jdk/jdk1.5.0_09/bin/java -Xms 128M -Xmx256M ...-classpath .../usr/lib/cacao/lib/cacao_cacao.jar ... Dcacao.config.dir=/etc/cacao/instances/default ...

Derby データベース:

ps -ef | grep derby

Admin Web Server (オプションであるが、通常は実行される):

./uxwdog -d web-container-install-root/SUNWam/servers/https-admserv/config
ns-httpd -d web-container-install-root/SUNWam/servers/https-admserv/config

実行時ログファイル

次のログファイルでエラーを調べます。

Access Manager ログは、次に格納されています。

/var/opt/SUNWam/debug

Portal Server の実行時ログ:

Portal インスタンスの実行時ログは、次にあります。

/var/opt/SUNWportal/portals/portal-server-ID/logs

プロセスの再起動

次の作業は、コンポーネントプロセスの一部を再起動する方法を示しています。

Web Server を再起動する

次のコマンドを使用して、Web Server インスタンスディレクトリに移動します。

cd /var/opt/SuNWwbsvr7/https-instance-name.pstest.com/bin 。

Web Server を停止します。

./stopserv

Web Server を起動します。

./startserv

ポータルモジュールが読み込まれると、次のメッセージが表示されます。

info: WEB0100: Loading web module in virtual server [xxxx.pstest.com] at [/portal]

Cacao を再起動する

次のコマンドを使用して、cacao ディレクトリに移動します。

cd /usr/lib/cacao/bin

cacao サーバーを停止します。

./cacaoadm stop

cacao サーバーを起動します。

./cacaoadm start

Directory Server を再起動する

次のコマンドを使用して、Directory Server を再起動します。

Directory-Server-install-dir/SUNWdsee/ds6/bin/dsame start /var/optSUNWdsee/dsins1

ディスプレイプロファイルの操作

ポータルのディスプレイプロファイルの XML コンテンツを障害追跡する必要がある場合は、調査のためにコンテンツをファイルから抽出します。障害追跡の過程のある時点で、ディスプレイプロファイルを再読み込みすると役立つ場合があります。

ディスプレイプロファイルを抽出する

管理者としてログインします。

psadmin コマンドを使用して、ディスプレイプロファイルを抽出します。次に例を示します。

psadmin list-display-profile -u uid=amadmin,ou=People,dc=pstest,dc=com - f /tmp/passwd -p portal1 -o /tmp/global_dp.xml -g

この例では、ディスプレイプロファイルのコンテンツを /tmp/global_dp.xml ファイルに格納します。

ディスプレイプロファイルを再読み込みする

管理者としてログインします。

psadmin コマンドを使用して、ディスプレイプロファイルを再読み込みします。次に例を示します。

psadmin modify-display-profile -u uid=amadmin,ou=People, dc=pstest,dc=com -f /tmp/passwd -d uid=user001,ou=People,o=DeveloperSample,dc=pstest,dc=com -p portal1 /tmp/updated_display.xml

この例は、ディスプレイプロファイルのコンテンツを /tmp/updated_displayxml ファイルから再読み込みします。

HTTP プロキシの設定

Portal Server ソフトウェアが、インターネットまたはイントラネットの特定の部分に直接アクセスできないホストにインストールされている場合、エラーが表示されることがあります。たとえば、SampleSimpleWebService プロバイダを使用する場合、プロキシが設定されていないと、次のエラーが表示されることがあります。

HTTP transport error: java.net.ConnectException: Connection refused

Portal Server インスタンスに対する HTTP プロキシの使用を設定するには

次の手順は、Sun Java System Web Server 上の Portal Server インスタンスに対する HTTP プロキシの設定方法を示しています。

ディレクトリを、インスタンスの設定が含まれる Web コンテナのデータディレクトリに変更します。

cd webcontainer-install-root /SUNWwbsvr7/https-instance-name/config

次に例を示します。/var/opt/SUNWwbsvr7/https-siroe.com/config

このディレクトリ内の server.xml ファイルを編集し、次の行を追加します。
<jvm-options>-Dhttp.proxyHost=proxy-host</jvm-options>
<jvm-options>-Dhttp.proxyPort=proxy-port</jvm-options>
<jvm-options>-Dhttp.nonProxyHosts=portal-host</jvm-options>
各表記の意味は次のとおりです。proxy-host は、プロキシホストの完全修飾ドメイン名であり、proxy-port はプロキシが実行されるポート、portal-host はポータルホストの完全修飾ドメイン名です。

Web コンテナを再起動して、変更を有効にします。