Sun ONE ロゴ      前へ      目次      索引      次へ     

Sun ONE Portal Server 6.2 インストールガイド

第 2 章
Sun ONE Portal Server のインストール


インストールの概要

SunTM ONE Portal Server と必要な基本コンポーネント製品は、JavaTM Enterprise System インストーラプログラムを使用してインストールされます。Java Enterprise System インストーラの使用について詳細は、『Sun Java Enterprise System インストールガイド』を参照してください。

この章には、次の節があります。


インストール前の情報

Sun ONE Portal Server ソフトウェアをインストールする前に、以前のバージョンの Web コンテナソフトウェアと SunTM ONE Identity Server ソフトウェアをすべて削除してください。

Web コンテナ

SunTM ONE Web Server と SunTM ONE Application Server Web コンテナは、Java Enterprise System インストーラを使用して、Directory Server、Identity Server、Portal Server とともに 1 回のインストールセッションでインストールすることができます。Sun ONE Portal Serverと必要なコンポーネントを 1 回のセッションでインストールすることを選択した場合、インストール前のステップは必要ありません。

ただし、Sun ONE Portal Server を後で既存の Sun ONE Web Server または Sun ONE Application Server の中にインストールするように選択した場合、Web コンテナを最初に再起動する必要があります。

BEA WebLogic ServerTM または IBM WebSphere Application Server Web コンテナ上に Sun ONE Portal Server を配備するように選択した場合、これらの製品を最初にインストールし、その製品のマニュアルに従って起動する必要があります。


Sun ONE Portal Server のインストール

Sun ONE Portal Server は Java Enterprise System エンタープライズソリューションのコンポーネント製品としてインストールされます。Java Enterprise System は、Sun ONE Portal Server と、Sun ONE Portal Server の実行に必要なコンポーネント製品をインストールするのに使用されます。

第 1 章のチェックリストから収集した情報に基づき、Java Enterprise System インストーラで最小インストールを実行した場合、configurator スクリプトを使用して Sun ONE Portal Server を設定します。configurator スクリプトは、portal-server-install-root/SUNWps/lib にあります。

インストールできる Sun ONE Portal Server コンポーネントは次のとおりです。

Sun ONE Portal Server、Sun ONE Portal Server Secure Remote Access、ゲートウェイ、Netlet プロキシ、リライタプロキシは単一マシン (Sun ONE Portal Server Web アプリケーションノード)、あるいは別々のノードにインストールすることができます。ただし、ゲートウェイは別ノードにインストールする必要があります。

今回のリリースでは、Communication Channels が Sun ONE Portal Server ソフトウェアとともにインストールされます。Communication Channels は、メールチャネル、カレンダーチャネル、アドレス帳チャネル、Instant Messagingチャネルで構成されます。

Sun ONE Portal Server ソフトウェアのインストール

Sun ONE Portal Server ソフトウェアをインストールするには、次のようにします。

  1. Java Enterprise System インストールウィザードを使用して、Sun ONE Portal Server を選択します。
  2. インストールする Sun ONE Portal Server コンポーネントを選択します。
  3. Sun Java Enterprise System インストールウィザードを使用すると、1 つのマシンにインストールする複数の Sun ONE Portal Server コンポーネントを選択できます。たとえば、単一のマシンに次のコンポーネントをインストールするように選択できます。

    • Sun ONE Portal Server ポータルソフトウェア
    • Sun ONE Portal Server, Secure Remote Access サポート
    • Netlet プロキシ
    • リライタプロキシ

    • ゲートウェイ、プロキシ、リライタプロキシをインストールするとき、 Portal Server ノードに Secure Remote Access サポートをインストールする ことを選択する必要があります。


  4. 設定を完了し、選択したコンポーネントをインストールするには、Java Enterprise System インストールウィザードを使用します。

Sun ONE Portal Server と別ノードのゲートウェイ、Netlet プロキシ、リライタプロキシのインストール

Sun ONE Portal Server と、Sun ONE Portal Server ノード以外のノードのゲートウェイ、Netlet プロキシ、リライタプロキシをインストールするには、次のようにします。

  1. Java Enterprise System インストールウィザードを使用して、次のコンポーネントインストールオプションを選択します。
    • Identity Server SDK の単体インストール
    • ゲートウェイ、Netlet プロキシ、リライタプロキシ
    • ゲートウェイ、Netlet プロキシ、リライタプロキシは、Sun ONE Identity Server SDK とともに 1 つのマシンにインストールする必要があります。

  2. 設定を完了し、選択したコンポーネントをインストールするには、Java Enterprise System インストールウィザードを使用します。

  3. ゲートウェイ、Netlet プロキシ、リライタプロキシをインストールすると き、Portal Server ノードに Secure Remote Access サポートをインストール することを選択する必要があります。



    Sun ONE Identity Server SDK をインストールするとき、Sun ONE Identity Server のインストール時に指定したパスワードと同じ暗号化パスワード キーを指定してください。

    Sun ONE Identity Server SDK のインストール時に Sun ONE Identity Server の詳細を正しく設定してください。


インストールとダウンロードについて詳細は、『Java Enterprise System インストールガイド』を参照してください。


Sun ONE Portal Server インストール後の作業

次の各コンポーネントに対して、インストール後の作業を実行する必要があります。

Sun ONE Portal Server

Portal Server または Identity Server 管理コンソールにアクセスするには、まず Directory Server と Web コンテナを起動する必要があります。

Directory Server のローカルインストールを開始するには、次のコマンドを使用します。

/var/opt/mps/serverroot/slapd-hostname/start-slapd


ユーザーに UNIX ログインを提供するには、Portal Server 管理コンソール で UNIX 認証を設定した後、管理サーバーを停止し、再起動してくださ い。

/etc/init.d/amserver stop

/etc/init.d/amserver start


次のインストール後の作業は、Sun ONE Portal Server を配備する Web コンテナのタイプによって異なります。

Sun ONE Web Server

Sun ONE Web Server を起動するには、次のようにします。

  1. 管理インスタンスを起動します。ターミナルウィンドウで次のように入力します。
  2. cd web-server-install-root/https-admserv

    ./start

  3. Sun ONE Web Server 管理コンソールへのアクセス
  4. 「変更の適用」をクリックし、Web コンテナを再起動します。

Sun ONE Application Server

アプリケーションサーバーインスタンスの設定
  1. 管理インスタンスを起動します。ターミナルウィンドウで次のように入力します。
  2. cd /var/opt/SUNWAppserver7/domains/domain1/admin

    ./start

  3. ブラウザで、Sun ONE Application Server 管理コンソールにアクセスします。デフォルト URL は次のとおりです。
  4. http://hostname:4848

  5. 左ナビゲーションフレームで、アプリケーションサーバーインスタンスの左側のキーをクリックします。
  6. server1、あるいは Sun ONE Identity Server がインストールされたアプリケーションサーバーの名前を選択します。
  7. 「変更の適用」をクリックします。
Sun ONE Application Server の停止と起動

Sun ONE Application Server インスタンスを起動します。

ターミナルウィンドウで、ディレクトリをアプリケーションサーバーのインスタンスユーティリティディレクトリに変更し、startserv スクリプトを実行します。次の例は、デフォルトのアプリケーションサーバードメインとインスタンスが使用されたことを想定しています。

cd /var/opt/SUNWappserver7/domains/domain1/server1/bin

./startserv

asadmin ユーティリティを使用して、あるいは Sun ONE Application Server 管理コンソールから Sun ONE Application Server の停止と起動を行うには、Sun ONE Application Server のマニュアルを参照してください。

Secure Remote Access の MIME マッピングの変更

Sun ONE Portal Server ノードに Secure Remote Access をインストールした場合

  1. 各ゲートウェイプロファイルで、MIME マッピングエントリを次のように変更します。
  2. JAVASCRIPT=application/x-javascript

    変更後:

    JAVASCRIPT=application/x-javascript:text/javascript

  3. プロファイルを保存します。
  4. ゲートウェイを再起動します。
  5. /var/opt/SUNWappserver7/domains/domain1/server1/config/
    server.policy
    を次のように変更します。
  6. permission java.net.SocketPermission"*","connect,accept,listen,resolve"

    permission java.io.FilePermissionlt;<ALLFILES>>途ead,write,execute,delete/span>

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

BEA WebLogic Server

BEA WebLogic Server に Portal Server を配備するには、Sun ONE Portal Server ソフトウェアのインストールに続いて次のステップを実行します。

  1. /var/sadm/install/logs/Java_Enterprise_System_install.B/MMddhhmm ファイルのエラーをチェックします。
  2. MM = month

    dd = day

    hh = hour

    mm = minute

  3. perftune スクリプトを実行します。
  4. startWebLogic.sh スクリプトの次の行をコメントアウトします。このスクリプトは、たとえば、/opt/bea/wlserver6.1/config/mydomain/startWebLogic.sh にあります。
  5. #JAVA_OPTIONS="-hotspot $JAVA_OPTIONS"

    -hotspot オプションを使用すると、メモリ不足によりサーバーが停止します。

  6. すべての BEA WebLogic Server インスタンス (管理サーバーおよび管理対象サーバー) を停止します。
  7. BEA WebLogic 管理サーバーインスタンスを起動します。管理対象インスタンスをインストールした場合、管理対象インスタンスも起動します。
  8. コマンド行から、以下を実行します。
  9. portal-server-install-root/SUNWps/bin/deploy

    デフォルトの配備 URI とサーバーインスタンス名を選択し、プロンプトが表示されたら、BEA WebLogic Server 管理パスワードを入力します。

  10. 次のコマンドを実行します。
  11. portal-server-install-root/SUNWps/lib/postinstall_PortletSamples

    プロンプトが表示されたら、BEA WebLogic Server の管理パスワードと Identity Server の管理パスワードを入力します。

    このコマンドは、portletsamples.war ファイルを配備します。

  12. Sun ONE Portal Server が配備されたインスタンスを再起動します。Web コンテナインスタンスの起動方法については、Web コンテナのマニュアルを参照してください。

  13. 管理対象サーバーのインストールの場合、.war ファイルは配備されませ ん。.war ファイルは、BEA WebLogic Server 管理コンソールを使用して配 備する必要があります。


LDAP、UNIX、Anonymous など、複数の認証メソッドをサポートする場合、コアの認証サービスに各認証タイプを追加して認証メニューを作成する必要があります。詳細については、『Sun ONE Portal Server 6.2 管理者ガイド』を参照してください。

IBM WebSphere Application Server

  1. /var/sadm/install/logs/Java_Enterprise_System_install.B/MMddhhmm ファイルのエラーをチェックします。
  2. アプリケーションサーバーインスタンスとアプリケーションサーバーノードを停止し、再起動してください。Web コンテナインスタンスの起動の手順については Web コンテナのマニュアルを参照してください。

NetFile、NetMail、Netlet アプレットアーカイブをダウンロードするとき、応答ヘッダーの content-type は text/html に設定されます。ポータル Web アプリケーション配備記述子ファイルの .jar.cab 拡張子を mime type application/octet-stream に明示的に関連付ける必要があります。デフォルトでは、配備記述子ファイルは次の場所にあります。

/opt/WebSphere/AppServer/installedApps/PortalURI.ear/portal.war/
WEB-INF/web.xml

  1. 次の行を追加します。
  2. </session-config>:

    <mime-mapping>

    <extension>jar</extension>

    <mime-type>application/octet-stream</mime-type>

    </mime-mapping>

    <mime-mapping>

    <extension>cab</extension>

    <mime-type>application/octet-stream</mime-type>

    </mime-mapping>


    移行中に Secure Remote Access 製品に必要な MIME マッピング設定が削除 されます。これらのマッピングは、移行が終了した後にもう一度追加する 必要があります。


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

Secure Remote Access

ゲートウェイとともに Sun ONE Portal Server を使用するとき、Sun ONE Portal Server が HTTP または HTTPS モードのどちらで動作していても、ゲートウェイの認証局 (CA) 証明書を Sun ONE Portal Server の信頼されている CA のリストに追加する必要があります。

ユーザーセッションタイムアウトまたはユーザーセッションログアウトアクションが発生した場合、Sun ONE Identity Server はゲートウェイにセッション通知を送信します。Sun ONE Identity Serverは、HTTP モードで動作しているときでも、HttpsURLConnection を使用して通知を送信する SSL クライアントの働きをします。SSL サーバー (ゲートウェイ) に接続されているため、ゲートウェイの認証局 (CA) 証明書を信頼されている CA のリストの一部として持つか、あるいは、自分自身で署名した証明書を許可するオプションを持つことが必要です。


信頼認証局 (CA) 一覧に認証局を追加する方法は、定義されたプロトコル ハンドラによって異なります。


HttpsURLConnection を作成する場合、Java 仮想マシン (JVMTM) プロパティ -Djava.protocol.handler.pkgs を設定する必要があります。

Sun ONE Portal Server が Sun ONE Web Server で稼動している場合、このプロパティは、デフォルトで -Djava.protocol.handler.pkgs に正しく設定されます。Sun ONE Identity Servercom.iplanet.services.comm パッケージは、HttpsURLConnection を実装し、フラグ com.iplanet.am.jssproxy.trustAllServerCerts=true を追加して SSL サーバーから自分自身で署名した証明書を受け入れるオプションを提供します。

Sun ONE Application Server、BEA WebLogic Server、および IBM WebSphere Application Server では、デフォルトで -Djava.protocol.handler.pkgs は設定されません。サポートされているアプリケーションサーバーの HttpsURLConnection 実装は、独自のデフォルトハンドラを使用する必要があります (これは JSSE またはカスタム SSL 実装となる可能性があります)。

ゲートウェイ

  1. 次のコマンドを使用してゲートウェイを起動します。
  2. gateway-install-root/SUNWps/bin/gateway -n new-profile-name start

    default は、インストール中に作成されるゲートウェイプロファイルのデフォルト名です。後で独自のプロファイルを作成し、新しいプロファイルでゲートウェイを再起動することができます。『Sun ONE Portal Server, Secure Remote Access 6.2 管理者ガイド』の第 2 章、「ゲートウェイプロファイルの作成」を参照してください。

    複数のゲートウェイインスタンスがある場合、次を使用します。

    gateway-install-root/SUNWps/bin/gateway start


    ゲートウェイのインストール中に「イストール後にゲートウェイを起動す る」オプションに y を選択した場合、このステップは必要ありません。



    警告

    開始するインスタンスの設定ファイルのみが /etc/opt/SUNWps ディレクト リにあることを確認してください。


特定のノード上で動作するすべてのゲートウェイインスタンスを停止する場合、次のコマンドを使用します。

gateway-install-root/SUNWps/bin/gateway stop

Netlet とゲートウェイには、PAC ファイルをサポートする Rhino JavaScriptTM パーサー (rhino/js.jar としてバンドル) が必要です。これは、ゲートウェイと Portal Server ノードにインストールする必要があります。インストールするには、${JAVA_HOME}/jre/lib/ext ディレクトリに rhino/js.jar をコピーする必要があります。

Netlet およびリライタプロキシ

Netlet プロキシとリライタプロキシを起動するには、ゲートウェイプロファイルが Netlet プロキシとリライタプロキシの各オプションで更新されていることを確認してください。

Sun ONE Portal Server ゲートウェイ、Netlet プロキシ、リライタプロキシは JSS 3.2、NSS 3.4.2、NSPR 4.2 のみで動作します。ゲートウェイ、Netlet プロキシ、リライタプロキシをインストール後に次の手順に従います。

  1. 必要なバージョンの JSS、NSS、NSPR をダウンロードし、/usr/share/lib ディレクトリにコピーします。
  2. ゲートウェイ、Netlet プロキシ、リライタプロキシを再起動します。

  3. これを行うのは、ゲートウェイ、Netlet プロキシ、リライタプロキシの単 体インストールの場合のみです。


Sun ONE Portal Server ソフトウェア NetFile には、Windows アクセス用に jCIFS ライブラリ (SUNWjcifs としてバンドル) が必要です。これは、Portal Server ノードにのみインストールする必要があります。インストールするには、次のステップを行います。

  1. 現在のディレクトリから pkgadd -d . SUNWjcifs を実行することによって、このパッケージを追加します。
  2. portal-server-install-root/SUNWps/bin/postinstall_JCIFS を実行します。
  3. portal-server-install-root/SUNWps/bin/undeploy コマンドに続けて portal-server-install-root/SUNWps/bin/deploy コマンドを実行します。
  4. サーバーを再起動します。

最小インストール後の Sun ONE Portal Server の設定

Java Enterprise System インストーラで最小設定インストールを実行したあと、Portal Server の configurator スクリプトを使用して Sun ONE Portal Server コンポーネント製品を設定します。このマニュアルの第 1 章にあるチェックリストで、Sun ONE Portal Server コンポーネント製品の設定に使用されるパラメータについて説明しています。

configurator を実行するには、次の手順に従います。

  1. ターミナルウィンドウで root として、configurator スクリプトを含む次のディレクトリに移動します。
  2. cdportal-server-install-root/lib

  3. 次のように入力し、configurator スクリプトを実行します。
  4. ./configurator


    デバッグをオンにするには次のようにします。

    configurator -DPS_CONFIG_DEBUG=y

    デバッグをオンにする場合、パスワードがデバッグ情報とともに画面に表 示されます。



Sun ONE Portal Server のインストールの確認

Sun ONE Portal Server 管理コンソールおよびデスクトップへのアクセス

Sun ONE Identity Server 管理コンソールへのアクセス

  1. ブラウザを開きます。
  2. protocol://hostname.domain:port/amconsole と入力します。
  3. たとえば、次のようなエントリがあります。

    http://example.com/amconsole

  4. 管理コンソールを表示するには、管理者の名前とパスワードを入力します。
  5. これは Sun ONE Identity Server ソフトウェアをインストールしたときに指定した名前とパスワードです。

Sun ONE Portal Server デスクトップへのアクセス

デスクトップにアクセスすることによって、Sun ONE Portal Server のインストールを確認します。次の URL を使用してデスクトップにアクセスします。

protocol://fully-qualified-hostname/portal-URI

たとえば、次のようなエントリがあります。

http://example.com/portal

デスクトップにアクセスするとき、認証なしデスクトップが表示されます。これによって、ユーザーはデスクトップ URL にアクセスできるようになり、自動認証とデスクトップへのアクセス権を与えられます。

サンプルポータルデスクトップが例外なしで表示されていれば、Portal Server のインストールは正常に行われました。


ゲートウェイのインストールの確認

  1. ゲートウェイが指定されたポートで動作しているかどうかをチェックするには、次のコマンドを実行します。
  2. netstat -an | grep port-number

    デフォルトゲートウェイポートは 443 です。

    ゲートウェイが動作していない場合、ゲートウェイをデバッグモードで起動し、コンソールに印刷されたメッセージを表示します。次のコマンドを使用してゲートウェイをデバッグモードで起動します。

    portal-server-install-root/SUNWps/bin/gateway -n profilename start debug

    platform.conf.profilename ファイルで gateway.debug 属性をメッセージに設定したあと、ログファイルを表示します。詳細については、『Sun ONE Portal Server, Secure Remote Access 6.2 管理者ガイド』の第 2 章、「ゲートウェイの管理」の「platform.conf ファイルの概要」の節を参照してください。

  3. ゲートウェイ URL をブラウザに入力することによって、セキュアモードで Portal Server を実行します。
  4. https://gateway-machine-name:portnumber

    インストール中にデフォルトポート (443) を選択した場合、ポート番号を指定する必要はありません。

  5. ユーザー名 amadmin とインストール中に指定したパスワードを使用して、管理者としてディレクトリサーバー管理コンソールにログインします。

これで管理コンソールで新しい組織、ロール、ユーザーを作成し、必要なサービスと属性を割り当てることができるようになりました。



前へ      目次      索引      次へ     


Copyright 2003 Sun Microsystems, Inc. All rights reserved.