開発者ツールを使用して、リモート Liberty サーバーを作成および開始できます。
始めに
ローカル・システムおよびリモート・システムの前提条件を満たす必要があります。
- ローカル・システムとは、開発ツールをインストールしたシステムを指します。
- リモート・システムとは、 Liberty ランタイム環境がインストールされ、 Liberty サーバーが作成されているシステムのことです。
リモート・システムの場合、必ず、configUtility を呼び出して、リポジトリーから
remoteAdministration スニペットをダウンロードしてセットアップしてください。 configUtility で取得した config テキストを server.xml ファイルにコピーします。 詳しくは、 configUtility コマンドを参照してください。
server.xml ファイルの例として、以下のリモート構成サンプルを使用できます。
<server description="new server">
<!-- Enable features-->
<featureManager>
<feature>restConnector-2.0</feature>
</featureManager>
<keyStore id="defaultKeyStore" password="password" />
<quickStartSecurity userName="admin" userPassword="password"/>
<httpEndpoint id="defaultHttpEndpoint" host="*" httpPort="9080" httpsPort="9443"/>
<remoteFileAccess>
<writeDir>${server.config.dir}</writeDir>
<writeDir>${server.output.dir}</writeDir>
<writeDir>${wlp.user.dir}</writeDir>
</remoteFileAccess>
</server>
手順
- ワークベンチで、 「サーバー」 タブをクリックして「サーバー」ビューを開きます。
ヒント: 「サーバー」ビューが表示されない場合は、 にナビゲートします。 フィルター・テキストに Server と入力します。 その後、「サーバー」を選択します。
- 「サーバー」 ビュー内を右クリックして、 を選択します。
- サーバー・タイプ・リストの下で、 IBM を展開し、 「Liberty サーバー」 サーバー・タイプを選択します。
- 「サーバーのホスト名」 フィールドにリモート・ホスト名を入力します。
- 「次へ」をクリックします。 「Liberty ランタイム環境」ページが表示されます。
ローカル・システムとリモート・システムの Liberty ランタイム環境に、同じフィーチャー・セットがインストールされていることを確認します。 また、それらが同じレベルの Java™ ランタイム環境 (JRE) を使用するように構成されていることも確認してください。 ローカル・システムの Liberty ランタイム環境は、開発環境のターゲット・ランタイムとして使用されます。 ローカル・システムのランタイムとリモー
ト・システムのランタイム間の不一致は、構成エラーからアプリケーション・パブリッシングの問題まで、各種の問題を引き起こす可能性があります。
ヒント: Liberty ランタイムが既にインストールされている場合は、 「新規リモート Liberty サーバー」 ページに直接移動し、ステップ 7 にスキップします。
インストールを選択するか、アーカイブ・ファイルからインストールするか、または (無料の開発者エディションの場合は) Libertyをダウンロードしてインストールします。
以前に Libertyをインストールした場合は、以下のステップを実行します。
- 「既存のインストールを選択」を選択します。
- 「パス」 フィールドで、 Liberty ランタイム環境をインストールしたディレクトリーを入力するか、参照して選択します。
- 「Liberty ランタイム環境」 ページで、 「次へ」をクリックします。
アプリケーション・サービス環境が選択されているため、ステップ 7 にスキップできます。
以前にダウンロードしたアーカイブ・ファイルから Liberty をインストールする場合は、以下のステップを実行します。
- 「アーカイブまたはリポジトリーからのインストール (Install from an archive or repository)」を選択し、 「次へ」をクリックします。
- 「宛先」 フィールドで、 Liberty ランタイム環境をインストールするディレクトリーを入力するか、参照して選択します。
存在しないパスを入力すると、ステップ 12 の終了時に、そのパスのフォルダーが自動的に作成されます。
- 「アーカイブから新規ランタイム環境をインストールする (Install a new runtime environment from an archive)」を選択します。
- 「パス」 フィールドで、ローカル・ファイル・システム上のアーカイブ・ファイルを入力するか参照して、 「次へ」をクリックします。
- 「アドオンのインストール」 ページで、 「インストール」 または 「インストール保留中」 をクリックして、 Liberty ランタイム環境にインストールするアドオン・アーカイブ・ファイルを選択します。
アドオン・アーカイブ・ファイルは、以下のいずれかの方法でインストールできます。
- ローカル・ファイル・システムから
- ファイルをダウンロードすることによって
- 複数のアドオン・アーカイブ・ファイルをインストールする場合は、両方を組み合わせて使用することによって
ローカル・ファイル・システムからアドオン・アーカイブ・ファイルをインストールする場合は、以下のステップを行います。
- 「アーカイブの追加」をクリックします。
- 「アドオン・アーカイブ」フィールドで、ローカル・ファイル・システム上にあるアドオン・アーカイブ・ファイルを入力するか参照して選択します。
- 「OK」をクリックします。
ローカル・ファイル・システムからさらにアドオン・アーカイブ・ファイルをインストールする場合は、完了するまでこの手順を繰り返してください。
カスタム・リポジトリーからアドオン・ファイルをインストールする場合は、以下のステップを行います。
- リポジトリーを追加するため、「リポジトリーの構成」をクリックします。
- 「新規 ...」をクリックします。
そうすると、ファイルがアドオン・ファイルのリストに追加されます。
「アドオンのインストール」ページの選択が完了したら、「次へ」をクリックします。
- 「ライセンスの同意」 ページで、ライセンス条項に同意する場合は、 「すべてのご使用条件の条項に同意します」 を選択し、 「次へ」をクリックします。
Libertyの無料の開発者エディションをダウンロードしてインストールする場合は、以下のステップを実行します。
- 「アーカイブまたはリポジトリーからのインストール (Install from an archive or respository)」を選択し、 「次へ」をクリックします。
- 「宛先」 フィールドで、 Liberty ランタイム環境をインストールするディレクトリーを入力するか、参照して選択します。
存在しないパスを入力すると、ステップ 12 の終了時に、そのパスのフォルダーが自動的に作成されます。
- 「 ibm.comから新規ランタイム環境をダウンロードしてインストールし、ランタイム環境のバージョンを選択して、 「次へ」をクリックします。
- 「アドオンのインストール」 ページで、 「インストール」 または 「インストール保留中」 をクリックして、 Liberty ランタイム環境にインストールするアドオン・アーカイブ・ファイルを選択します。
アドオン・アーカイブ・ファイルは、以下のいずれかの方法でインストールできます。
- ローカル・ファイル・システムから
- ファイルをダウンロードすることによって
- 複数のアドオン・アーカイブ・ファイルをインストールする場合は、両方を組み合わせて使用することによって
ローカル・ファイル・システムからアドオン・アーカイブ・ファイルをインストールする場合は、以下のステップを行います。
- 「アーカイブの追加」をクリックします。
- 「アドオン・アーカイブ」フィールドで、ローカル・ファイル・システム上にあるアドオン・アーカイブ・ファイルを入力するか参照して選択します。
- 「OK」をクリックします。
ローカル・ファイル・システムからさらにアドオン・アーカイブ・ファイルをインストールする場合は、完了するまでこの手順を繰り返してください。
カスタム・リポジトリーからアドオン・ファイルをインストールする場合は、以下のステップを行います。
- リポジトリーを追加するため、「リポジトリーの構成」をクリックします。
- 「新規 ...」をクリックします。
そうすると、ファイルがアドオン・ファイルのリストに追加されます。
「アドオンのインストール」ページの選択が完了したら、「次へ」をクリックします。
- 「ライセンスの同意」 ページで、ライセンス条項に同意する場合は、 「すべてのご使用条件の条項に同意します」 を選択し、 「次へ」をクリックします。
- 「Liberty サーバー・タイプ」 ページが表示された場合は、 「スタンドアロン・サーバー」を選択します。
- リモート・サーバーのユーザー ID、パスワード、およびポート情報を入力し、 「検証」をクリックします。
重要:
- ユーザーIDとパスワードは、 quickStartSecurity 構成項目またはリモートLibertyサーバーのユーザーレジストリで定義されている適切なセキュリティ資格情報を持っている必要があります。
- ポートは、server.xml ファイルで構成された HTTPS ポートです。
「検査」をクリックして、次のメッセージが表示された場合は、
同じ名前でローカル・サーバーまたはリモート・サーバーが既に作成されています。
The Liberty server already exists
この状況を検証するには、
「エンタープライズ・エクスプローラー」ビューで以下のフォルダーを展開し、以下のプロジェクトにリストされるサーバーを確認します。
- WebSphere® Application Server Liberty
- WebSphere Application Server Liberty (リモート)
接続が成功した場合、同じページにリモート・ディレクトリーが表示されます。 同じ名前の 2 つのサーバーによるこの問題を解決するには、リモート・システムのリモート・ディレクトリー・フォルダーを名前変更できます。
- 「新規リモート Liberty サーバー」 ページで、 「次へ」をクリックします。
「リモート WebSphere Application Server の設定」ページが表示されます。
- リモートでの始動、停止、および再始動を有効にしない場合は、 「サーバーをリモートで開始できるようにする」 がクリアされていることを確認し、 「次へ」をクリックして、次のステップをスキップします。
- リモートの始動、停止、および再始動を有効にします。
- 「サーバーをリモートで開始できるようにする」を選択します。
- リモート・サーバーが Windows オペレーティング・システムにインストールされているか、その他のオペレーティング・システムにインストールされているかを選択します。
- ランタイム・インストールとサーバー構成の場所を入力します。
- リモート・サーバーの認証情報を入力します。
認証には、以下のオプションのいずれかを行います。
- ログオン資格情報を使用してリモート・サーバーへアクセスする場合は、ユーザー名およびパスワードを入力します。 Windows プラットフォームでは、サーバーにアクセスできるユーザー・アカウントの Windows ユーザー名とパスワードを使用します。 Windows 以外のプラットフォームでは、SSH ユーザー名とパスワード資格情報を使用します。
- Secure Shell (SSH) を介して秘密鍵を使用してリモート・サーバ
ーへアクセスする場合は、ワークベンチがインストールされたコンピューターに秘密鍵ファ
イルをコピーし、鍵ファイルの場所とユーザー ID を指定します。
- オプション: アプリケーションのプロジェクトをサーバーに追加します。 「追加および削除」ページの「使用可能」リストで、サーバーに追加するプロジェクトを選択し、「追加」をクリックします。 プロジェクトが「構成済み」リストに表示されます。
- 「終了」をクリックします。
次の作業
- サーバー構成を編集してください。 編集が行われると、リモート・サーバーでは、構成変更が同期され、リモート・バージョンのファイルに反映されます。 構成ファイルがリモート・サーバーと同期していない場合は、
リモート・ファイルの上書きの前に開発者ツールからプロンプトが出されます。 詳しくは、「 開発者ツールを使用した Liberty の管理 」トピックを参照してください。ここでは、リモート・サーバーに固有の情報を確認できます。 さらに、「 開発者ツールを使用した Liberty 構成の編集 」トピックを参照してください。
制約事項: リモート・サーバーの場合、ツールは、サーバー構成で絶対パスを使用したインクルード・ファイルの指定をサポートしません。 この問題を回避するには、
絶対パスを使用する代わりに、事前定義されたサーバー変数 (server.config.dir や shared.config.dir など) を使用してインクルード・パスを指定します。
- サーバーの始動または停止、サーバー上のアプリケーションの追加または削除、およびその他の多くのタスク。 これらのタスクを実行するには、サーバー・メニューを使用する (サーバーを右クリックしてポップアップ・メニューを開く) か、または「サーバー」ビューでトレイのボタンを選択します。
ヒント: 「サーバー」ビューで、これらのタスクを実行するサーバー・エントリーを選択する必要があります。 これらのタスクを実行するための Server Configuration
[server.xml] エントリーなどのサーバー構成を選択しないでください。
- 製品資料の サーバー環境ファイルを作成および編集 できます。
![分散: [AIX MacOS Linux Windows]](../ngdist.svg)