このセクションでは、WebSphere に Virtualize Server をデプロイする手順の例を示します。新しいバージョンの SOAtest/Virtualize Server にアップデートする方法については「WebSphere にデプロイされた SOAtest/Virtualize Server のアップグレード」を参照してください。
- parasoft_soavirt_server_<version>.zip をダウンロードし、soavirt.war ファイルを展開します。
- WebSphere をインストールし、サーバーを作成します。インストール手順のドキュメントを確認してください: WebSphere 8.5 および 8.5.5 のインストール、アップデート、設定
次の WebSphere for Developers リポジトリから WebSphere をダウンロードできます。 https://developer.ibm.com/wasdev/downloads/#asset/WAS_traditional_for_Developers - Profile Creation Summary で、場所 (<WEBSPHERE_HOME>) とサーバー名 (<SERVER_NAME>) を確認してください。
- WebSphere が Java 8 を使用していることを確認します。手順については、次の記事で説明されています。 Which Java version is my WebSphere Application Server V8.5 using?
WebSphere 用に Java 8 をインストールする必要がある場合、次の記事に説明があります。Installing IBM WebSphere SDK Java Technology Edition Version 8.0 using the GUI
- 次のコマンドを実行して、サーバーが実行されていることを確認します。
<WEBSPHERE_HOME>/bin/serverStatus.bat <SERVER_NAME>
サーバーが実行されていない場合は、startServer.bat スクリプトを実行して起動します。<WEBSPHERE_HOME>/bin/startServer.bat <SERVER_NAME> - WebSphere の管理コンソールにログインします: http://localhost:9060/ibm/consoleユーザー ID フィールドは空のままで構いません。または、WebSphere をインストールしたときに作成した ID を使用します。
- [Applications] > [Application Types] > [WebSphere enterprise applications] をクリックし、デフォルトのアプリケーションをアンインストールします。
- [Applications] > [New Application] > [New Enterprise Application] をクリックし、soavirt.war ファイルを選択します。
- [Next] をクリックします。
- [Fast Path] を選択し、[Next] をクリックします。
- [Directory to install] オプションに <SERVER_HOME> を指定し、[Next] をクリックします。
- SOAVirt モジュールを選択し、[Next] をクリックします。
- "default_host" のままにして [Next] をクリックします。
- [Context root] に "/" が設定されていることを確認し、[Next] をクリックします。
- 設定を確認して [Next] をクリックします。
- インストールが完了したら、[Save directly to the master configuration] をクリックします。
- [Applications] > [Application Types] > [WebSphere enterprise applications] をクリックし、[SOAVirt] をクリックします。
- [Modules settings] グループで [Manage Modules] を選択し、[SOAVirt] モジュールを選択します。
- [class loader order] を [parent last] に変更し、[OK] をクリックします。
- [Detail Properties settings] グループで [ Class loading and update detection] を選択します。
- [class loader order] を [parent last] に変更し、[OK] をクリックします。
- [OK] をクリックし、[Save directly to the master configuration] をクリックします。
- <SOAVIRT_HOME>/<SOAVIRT_WAR>.ear/<SOAVIRT_WAR>/WEB-INF/config.properties ファイルでポートと適切なライセンスを指定します。
- (任意) HTTPS を介して WAR ファイルをデプロイするには、以下の操作を行って SSL を構成します。
- [Security] > [SSL certificate and key management] > [Key stores and certificates] > [NodeDefaultKeystore] > [Personal certificates]を選択し、[Import/Create SSL certificate] をクリックします。
- [Security] > [SSL certificate and key management] > [SSL configurations] > [NodeDefaultSSLSettings] を選択し、[Default server certificate alias] オプションに [use the new certificate] を設定します。
- [Servers] > [Server Types] > [WebSphere Application Servers] > <SERVER_NAME> > [Ports]を選択し、[WC_defaulthost_secure port] を変更して config.properties ファイルで設定した
server.port.httpsのポート設定と一致させます。 - [Environment] > [Virtual Hosts] > [default_host] > [Host Aliases]を選択し、新規 Host Alias を追加します。
Host Name = *Port = SSL port - [Save directly to the master configuration] をクリックします。
- 以下のコマンドを実行してサーバーを再起動します。
<WEBSPHERE_HOME>/bin/stopServer.bat <SERVER_NAME><WEBSPHERE_HOME>/bin/startServer.bat <SERVER_NAME> - http://localhost:<WEB_PORT> を開きます。<WEB_PORT> は [Servers] > [Server Types] > [WebSphere Application Servers] > <SERVER_NAME> > [Ports] で設定した WC_defaulthost port と同じです。
次のようなメッセージが表示された場合、アプリケーションは正しくインストールされています。
There are no deployments on this server.Cannot respond to this request: /.
インストールが成功した場合、次の場所にワークスペース ディレクトリが作成されます。
<SOAVIRT_HOME>/<SOAVIRT_WAR>.ear/<SOAVIRT_WAR>/workspace
有効なクエリー パラメーターについて
クエリー パラメーターの期待される形式は name=value です。等号 (=) を含まないクエリーのデフォルトの動作は、null 値の返却です。リクエストのクエリー パラメーターに文字列名だけが含まれる場合、値として空の文字列を返すように WebSphere (バージョン 8.5.5.2+) を構成できます。
Web コンテナのカスタム プロパティ設定で次のプロパティを設定します:
com.ibm.ws.webcontainer.AllowQueryParamWithNoEqual=true
詳細については WebSphere のドキュメントを参照してください。
