Jboss eap 7.1配置
11659 ワード
LinuxシステムでのJboss-eap-7.1サーバstandaloneモードの構成導入について説明します.90%の内容はjbossの公式構成ドキュメントから来ており、初心者の観点から構成プロセスを整理し、アプリケーションを導入する際に一般的に使用される構成項目を紹介しています.この文書を参照すると、ほとんどのアプリケーションはJboss-eap-7.1で正常に実行できます.以下に示すコマンド、コード、およびファイルアドレスでは、{JBOSS_HOME}はJboss-eap-7.1のルートディレクトリを指します.インストールと起動、インストールの停止:いわゆる「インストール」は、ダウンロードしたパッケージをあるアドレスに解凍すればよい.起動:{JBOSS_HOME}/binディレクトリに入り、standalone.shスクリプトを実行し、started in XXXXmsを出力すると、サーバが正常に起動したことを証明します.停止:通常、サーバのプロセスはバックグラウンドで実行されます.停止時、{JBOSS_HOME}/binディレクトリで./jboss-cli.sh--connectを実行し、コマンドライン管理ページに入り、shutdownコマンドを入力するとサーバーを停止します.(文:./jboss-cli.sh--connect command=:shutdownにマージすることもできます)構成:{JBOSS_HOME}/binのstandalone.confファイルを変更し、Jboss起動の構成を変更できます.ファイルにJAVA_を入れるHOME=「/path/jdk」は、システムのデフォルトのjava環境変数に依存することなく、使用するjdkを指定できます.ファイルにLANG=Zh_を入れるCN.GB 18030、言語環境を中国語に変更できるJAVA_OPTSは、JVMの起動パラメータの基本概念を設定できます
jboss-eap-7.1には、standalone-スタンドアロンモードとdomain-クラスタモードの2つの動作モードがあります.この文書では、シングルマシンモードの導入について説明します.jbossがサーバを起動すると、デフォルトで読み込まれるプロファイルは{JBOSS_HOME}/standalone/configuration/standalone.xmlです.他のプロファイルの読み込みを指定することもできます.コマンドは./standalone.sh--server-config=standalone-custom.xmlです.
jboss-cli(command line interface)は、jbossのコマンドライン管理ツールです.{JBOSS_HOME}/bin/jboss-cli.shを実行するとアクセスできます.コマンドラインにより、アンインストールアプリケーションの導入、システム設定の構成、管理タスクの実行機能を実現します.このツールを使用してシステム構成を変更すると、最終的にはstandalone.xmlにも作用します.xmlを直接変更する方法は非常に直感的であるため、本人に好まれ、本稿のすべての構成例はxmlを直接変更することである.管理コンソール.jbossが提供するweb管理システムで、アドレスはhttp://localhost:9990/console/App.htmlすべての操作はjboss-cliで実現できますが、このツールはここでは説明しません.
standalone.xml構成アドレスはデフォルトの構成を構成し、サーバが起動するとlocalhostからしかアクセスできません.NIC IPアドレスからアクセスする場合は、プロファイルを変更する必要があります.次のコンフィギュレーションクリップを見つけます
publicタグの下のアドレスをNIPアドレスに変更すると、IPアドレスでアクセスできます.0.0.0.0に設定することもでき、マシン上で使用可能なipアドレスはすべてアクセスできます.管理ラベルの下のアドレスの変更はお勧めしませんが、個人的にはリモートの管理に一定のリスクがあると思いますので、直接機械でやったほうがいいと思います.ポート構成リスニングされたポートを変更し、次の構成フラグメントを見つけます.
必要に応じて、異なるプロトコルで傍受されるポートを変更します.管理コンソールのポートのデフォルトは9990です.ここで変更することもできます.データソースの構成
データソースの構成は、次のコードに示すように、ラベルの意味が非常に明確であり、ラベルについて説明しません.
データソースを構成した後、データベースドライバjarパッケージを{JBOSS_HOME}/modulesの下で正しい位置に置く必要があります.ドライバの配置ディレクトリはdriverラベルのmoduleの値と一致しなければならない.上記の構成を例にとると、ドライバjarパケットのパスは${JBOSS_HOME}/modules/modules/net/sourceforge/jtds/jdbc/124/main/mainが属性に現れないようにし、124フォルダの下にmainフォルダが必要であり、jarパケットはmainフォルダにある.mainフォルダの下にmodule.xmlもあります.構成例は次のとおりです.
module.xmlのmoduleラベルのnameプロパティはstandalone.xmlのdriverラベルのmoduleプロパティと一致します.JDBC規格に準拠したデータソースの構成が完了しました.ただし、この例ではjtdsを使用しているので、追加の操作を行う必要があります.そうしないと、データソースを正しくバインドできません.jarパッケージを駆動するMETA-INFフォルダにservicesフォルダを新規作成し、java.sql.Driverというファイルを新規作成し、ファイルの最初の行にDriverのパスを書きます.この例ではjava.sql.Driverファイルの内容は、net.sourceforge.jtds.jdbc.Driverが上記の構成を経て、サーバを起動すると、出力Started Driver service with driver-name=jtds 124が表示され、データソース構成が成功したことを証明します.Undertowコンテナ構成は、httpリクエストを受信する設定、コンテナデフォルトの文字セットを変更し、jbossデフォルトのウェルカムページを削除し、httpアクセスのログを開き、httpリクエストと応答の情報を出力します.次の構成フラグメントが見つかり、デフォルトでは次のように構成されています.
変更された構成は次のとおりです.
httpリクエスト設定の変更:http-listenerラベルにurl-charsetとdecode-urlを追加します.url-charsetのデフォルトで使用されるUTF-8は、必要に応じて変更できます.decode-urlは、文字セットを使用してurlとパラメータを復号するかどうかを指し、デフォルトはtrueです.falseとすると後続コードにより復号処理が行われる.http-listenerの詳細な構成プロパティはここをクリックします.
コンテナのデフォルト文字セットの変更:servlet-containerラベルでdefault-encodingはすべてのアプリケーションの文字セット(デフォルトはutf-8)を設定し、use-listener-encodingはlistener定義の符号化を使用するかどうかを指します.servlet-containerの詳細な構成プロパティはここをクリックします.
Jbossデフォルトウェルカムページの削除:コンフィギュレーションファイルのコメントの部分、つまりjbossデフォルトウェルカムページの構成です.直接コメントは、削除するか、デフォルトのアドレスをアプリケーションにマッピングすることです.
httpアクセスログを開く:hostラベルの下にaccess-logというラベルを追加すると、httpリクエストの情報をログに記録することができ、デバッグが容易になります.Directoryはログに格納されているディレクトリで、デフォルトのファイル名はaccess_です.log.log.patternはログに記録する情報で、commonとcombinedの2つのモードを事前に定義しており、combinedの情報は豊富です.カスタム出力モードの詳細は、ここを参照してください.
httpリクエストと応答を出力する情報:filtersラベルの下にrequest-dumperというfilterを追加し、hostラベルの下に名前が一致するfilter-refを追加すると、jbossログにhttpリクエストごとのrequestとresponse情報を出力でき、デバッグが容易になります.
注意:上記の操作1では、以前のバージョンではextensionsとmanagementラベルの間に次の構成コードを追加し、同様の効果を実現しました.しかしwildfly 8以降、jbossはtomcat容器を放棄してundertowを使用するため、以下の構成は機能しなくなった.
アプリケーションの配備
以下では、3つの導入モデルについて説明しますが、本番環境では、開発環境に適用できる3つ目の手動モデルを使用することを推奨します.アプリケーションの導入に関するデフォルトの構成は次のとおりです.
scan-intervalは、deploymentsフォルダの下の変化を数ミリ秒おきにスキャンします.設定値が1より小さい場合は、起動時のみスキャンします.全自動モードはデフォルト設定でwarパッケージを{JBOSS_HOME}/standalone/deploymentsにアップロードします.サーバーは起動時と5000ミリ秒ごとにdeploymentsのファイルの変化を確認し、アプリケーションを配置します.半自動モード属性auto-deploy-zipped=「false」にmyApp.warをdeploymentsフォルダにアップロードすると、deploymentsフォルダの下にmyApp.war.dodeployというファイルが新規作成され、サーバがこのファイルを検出するとデプロイが開始されます.詳細はこちらをクリックしてください.手動モードプロパティscan-enabled=「false」このモードは、deploymentsフォルダにアプリケーションをアップロードすることなく、公式に推奨される本番環境導入アプリケーションです.まず、myApp.warが/usr/me/myApp.warであると仮定してサーバ上に存在することを保証します.サーバを起動し、./jboss-cli.sh--connectコマンドを使用してコマンドライン管理インタフェースに入ります.コマンドdeploy/usr/me/myApp.war配備アプリケーションを実行します.デプロイをキャンセルすると、コマンドライン管理インタフェースでundeploy myApp.warが実行されます.アプリケーションのデータは{JBOSS_HOME}/standalone/data/contentの下にあり、standalone.xmlの一番下にdeploymentsラベルが表示され、すでに配備されているアプリケーションが表示されます.余談ですが、入門レベルのチュートリアルである以上、jbossの一連の製品を紹介します.改名のため、jbossシリーズがますます乱れているので、簡単に整理します.Undertow:Jbossが独自に開発したサーブレット容器.Jboss AS(Application Server):Jbossコミュニティ版の初期バージョンで、Jboss eap名に近いため、Jboss AS 7以降はWildflyと改名した.内部カプセル化されたコンテナはTomcatベースのアップグレード版です.WildFly:バージョン番号はWildFly 8.0から始まり、Jboss ASから改名された.内部に封入されている容器はUndertowです.Jboss EAP(Enterprise Application Platform):Jbossのエンタープライズ版.コミュニティ版で検証された成熟したテクノロジーが導入され、サポートサイクルが長くなります.6のバージョンはJboss AS 7をベースにしています.7のバージョンはWildflyをベースにしています.
参考資料
変換元:https://www.jianshu.com/p/4baaf549436b
jboss-eap-7.1には、standalone-スタンドアロンモードとdomain-クラスタモードの2つの動作モードがあります.この文書では、シングルマシンモードの導入について説明します.jbossがサーバを起動すると、デフォルトで読み込まれるプロファイルは{JBOSS_HOME}/standalone/configuration/standalone.xmlです.他のプロファイルの読み込みを指定することもできます.コマンドは./standalone.sh--server-config=standalone-custom.xmlです.
jboss-cli(command line interface)は、jbossのコマンドライン管理ツールです.{JBOSS_HOME}/bin/jboss-cli.shを実行するとアクセスできます.コマンドラインにより、アンインストールアプリケーションの導入、システム設定の構成、管理タスクの実行機能を実現します.このツールを使用してシステム構成を変更すると、最終的にはstandalone.xmlにも作用します.xmlを直接変更する方法は非常に直感的であるため、本人に好まれ、本稿のすべての構成例はxmlを直接変更することである.管理コンソール.jbossが提供するweb管理システムで、アドレスはhttp://localhost:9990/console/App.htmlすべての操作はjboss-cliで実現できますが、このツールはここでは説明しません.
standalone.xml構成アドレスはデフォルトの構成を構成し、サーバが起動するとlocalhostからしかアクセスできません.NIC IPアドレスからアクセスする場合は、プロファイルを変更する必要があります.次のコンフィギュレーションクリップを見つけます
publicタグの下のアドレスをNIPアドレスに変更すると、IPアドレスでアクセスできます.0.0.0.0に設定することもでき、マシン上で使用可能なipアドレスはすべてアクセスできます.管理ラベルの下のアドレスの変更はお勧めしませんが、個人的にはリモートの管理に一定のリスクがあると思いますので、直接機械でやったほうがいいと思います.ポート構成リスニングされたポートを変更し、次の構成フラグメントを見つけます.
………… ………… …………
………… ………… …………
必要に応じて、異なるプロトコルで傍受されるポートを変更します.管理コンソールのポートのデフォルトは9990です.ここで変更することもできます.データソースの構成
データソースの構成は、次のコードに示すように、ラベルの意味が非常に明確であり、ラベルについて説明しません.
………… ………… …………
jdbc:jtds:sybase://10.2.4.16:11100/testDB;charset=cp936
jtds124
1
20
true
user
password
SELECT 1
true
30000
1
true
………… ………… …………
net.sourceforge.jtds.jdbcx.JtdsDataSource
データソースを構成した後、データベースドライバjarパッケージを{JBOSS_HOME}/modulesの下で正しい位置に置く必要があります.ドライバの配置ディレクトリはdriverラベルのmoduleの値と一致しなければならない.上記の構成を例にとると、ドライバjarパケットのパスは${JBOSS_HOME}/modules/modules/net/sourceforge/jtds/jdbc/124/main/mainが属性に現れないようにし、124フォルダの下にmainフォルダが必要であり、jarパケットはmainフォルダにある.mainフォルダの下にmodule.xmlもあります.構成例は次のとおりです.
module.xmlのmoduleラベルのnameプロパティはstandalone.xmlのdriverラベルのmoduleプロパティと一致します.JDBC規格に準拠したデータソースの構成が完了しました.ただし、この例ではjtdsを使用しているので、追加の操作を行う必要があります.そうしないと、データソースを正しくバインドできません.jarパッケージを駆動するMETA-INFフォルダにservicesフォルダを新規作成し、java.sql.Driverというファイルを新規作成し、ファイルの最初の行にDriverのパスを書きます.この例ではjava.sql.Driverファイルの内容は、net.sourceforge.jtds.jdbc.Driverが上記の構成を経て、サーバを起動すると、出力Started Driver service with driver-name=jtds 124が表示され、データソース構成が成功したことを証明します.Undertowコンテナ構成は、httpリクエストを受信する設定、コンテナデフォルトの文字セットを変更し、jbossデフォルトのウェルカムページを削除し、httpアクセスのログを開き、httpリクエストと応答の情報を出力します.次の構成フラグメントが見つかり、デフォルトでは次のように構成されています.
………… ………… …………
………… ………… …………
変更された構成は次のとおりです.
………… ………… …………
………… ………… …………
httpリクエスト設定の変更:http-listenerラベルにurl-charsetとdecode-urlを追加します.url-charsetのデフォルトで使用されるUTF-8は、必要に応じて変更できます.decode-urlは、文字セットを使用してurlとパラメータを復号するかどうかを指し、デフォルトはtrueです.falseとすると後続コードにより復号処理が行われる.http-listenerの詳細な構成プロパティはここをクリックします.
コンテナのデフォルト文字セットの変更:servlet-containerラベルでdefault-encodingはすべてのアプリケーションの文字セット(デフォルトはutf-8)を設定し、use-listener-encodingはlistener定義の符号化を使用するかどうかを指します.servlet-containerの詳細な構成プロパティはここをクリックします.
Jbossデフォルトウェルカムページの削除:コンフィギュレーションファイルのコメントの部分、つまりjbossデフォルトウェルカムページの構成です.直接コメントは、削除するか、デフォルトのアドレスをアプリケーションにマッピングすることです.
httpアクセスログを開く:hostラベルの下にaccess-logというラベルを追加すると、httpリクエストの情報をログに記録することができ、デバッグが容易になります.Directoryはログに格納されているディレクトリで、デフォルトのファイル名はaccess_です.log.log.patternはログに記録する情報で、commonとcombinedの2つのモードを事前に定義しており、combinedの情報は豊富です.カスタム出力モードの詳細は、ここを参照してください.
httpリクエストと応答を出力する情報:filtersラベルの下にrequest-dumperというfilterを追加し、hostラベルの下に名前が一致するfilter-refを追加すると、jbossログにhttpリクエストごとのrequestとresponse情報を出力でき、デバッグが容易になります.
注意:上記の操作1では、以前のバージョンではextensionsとmanagementラベルの間に次の構成コードを追加し、同様の効果を実現しました.しかしwildfly 8以降、jbossはtomcat容器を放棄してundertowを使用するため、以下の構成は機能しなくなった.
アプリケーションの配備
以下では、3つの導入モデルについて説明しますが、本番環境では、開発環境に適用できる3つ目の手動モデルを使用することを推奨します.アプリケーションの導入に関するデフォルトの構成は次のとおりです.
scan-intervalは、deploymentsフォルダの下の変化を数ミリ秒おきにスキャンします.設定値が1より小さい場合は、起動時のみスキャンします.全自動モードはデフォルト設定でwarパッケージを{JBOSS_HOME}/standalone/deploymentsにアップロードします.サーバーは起動時と5000ミリ秒ごとにdeploymentsのファイルの変化を確認し、アプリケーションを配置します.半自動モード属性auto-deploy-zipped=「false」にmyApp.warをdeploymentsフォルダにアップロードすると、deploymentsフォルダの下にmyApp.war.dodeployというファイルが新規作成され、サーバがこのファイルを検出するとデプロイが開始されます.詳細はこちらをクリックしてください.手動モードプロパティscan-enabled=「false」このモードは、deploymentsフォルダにアプリケーションをアップロードすることなく、公式に推奨される本番環境導入アプリケーションです.まず、myApp.warが/usr/me/myApp.warであると仮定してサーバ上に存在することを保証します.サーバを起動し、./jboss-cli.sh--connectコマンドを使用してコマンドライン管理インタフェースに入ります.コマンドdeploy/usr/me/myApp.war配備アプリケーションを実行します.デプロイをキャンセルすると、コマンドライン管理インタフェースでundeploy myApp.warが実行されます.アプリケーションのデータは{JBOSS_HOME}/standalone/data/contentの下にあり、standalone.xmlの一番下にdeploymentsラベルが表示され、すでに配備されているアプリケーションが表示されます.余談ですが、入門レベルのチュートリアルである以上、jbossの一連の製品を紹介します.改名のため、jbossシリーズがますます乱れているので、簡単に整理します.Undertow:Jbossが独自に開発したサーブレット容器.Jboss AS(Application Server):Jbossコミュニティ版の初期バージョンで、Jboss eap名に近いため、Jboss AS 7以降はWildflyと改名した.内部カプセル化されたコンテナはTomcatベースのアップグレード版です.WildFly:バージョン番号はWildFly 8.0から始まり、Jboss ASから改名された.内部に封入されている容器はUndertowです.Jboss EAP(Enterprise Application Platform):Jbossのエンタープライズ版.コミュニティ版で検証された成熟したテクノロジーが導入され、サポートサイクルが長くなります.6のバージョンはJboss AS 7をベースにしています.7のバージョンはWildflyをベースにしています.
参考資料
[1. jdbc services](https://developer.jboss.org/thread/249928)
変換元:https://www.jianshu.com/p/4baaf549436b