JBoss にディプロイするには

制約事項: 本トピックは、Enterprise Server 機能が有効な場合にのみ該当します。

本トピックでは、Interface Mapping Toolkit を使用して開発したアプリケーションを JBoss Application Server にディプロイする方法を説明します。

JBoss Application Server のインストール

JBoss Application Server は、JBoss の公式 Web サイトからダウンロードしてインストールできます。

JBoss Application Server を開く方法は、次のとおりです。

  • Web ブラウザーで、URL http://localhost:8080 を入力します。8080 は、デフォルト ポートです。

JBoss Application Server の管理

JBoss Application Server には、アプリケーション サーバーを管理するための Web インターフェイスがあります。この管理インターフェイスは、JBoss 管理コンソールと呼ばれます。コンソールを開始する方法は、次のとおりです。

  • Web ブラウザーに「http://localhost:9990/console/App.html」と入力します。ポート 9990 は、管理コンソールのソケット バインディングとしてあらかじめ定義されています。

JBoss Application Server の開始および停止

JBoss Application Server を、JBoss コンソールまたはコマンド ラインから、次のようにして開始および停止できます。

JBoss EAP 7.1

Windows 環境の場合

  • 開始するには、jboss_home\bin\standalone.bat を実行します。
  • 停止するには、jboss_home\bin\jboss-cli --connect command=:shutdown を実行します。

UNIX 環境の場合

  • 開始するには、jboss_home/bin/standalone.bat を実行します。
  • 停止するには、jboss_home/bin/jboss-cli --connect command="shutdown を実行します。

リソース アダプターのディプロイ

JBoss EAP 7.1
JBoss EAP 7.1 のリソース アダプターをディプロイするには、次のように、standalone.xml ファイルを更新します (このファイルは、JBoss インストールの standalone\configuration(Windows) または standalone/configuration(UNIX) ディレクトリにあります)。
jca サブシステムを無効にする
<subsystem xmlns="urn:jboss:domain:jca:5.0"> 要素の子 <archive-validation> を次のように編集します。
<archive-validation enabled="false" fail-on-error="true" fail-on-warn="false"/>
mfcobol-notx.rar リソース アダプターを追加する
既存のリソース アダプター サブシステム要素全体を次のサブシステム定義に置き換えます。
<subsystem xmlns="urn:jboss:domain:resource-adapters:5.0">
	<resource-adapters>
		<resource-adapter>
			<archive>mfcobol-notx.rar</archive>
			<transaction-support>NoTransaction</transaction-support>
			<connection-definitions>
				<connection-definition class-name="com.microfocus.cobol.connector.spi.CobolNoTxManagedConnectionFactory" jndi-name="java:/eis/MFCobol_v1.5" pool-name="CobolConnectionFactory">
					<pool>
						<min-pool-size>2</min-pool-size>
						<max-pool-size>10</max-pool-size>
					</pool>
					<security>
						<application/>
					</security>
				</connection-definition>
			</connection-definitions>
		</resource-adapter>
	</resource-adapters>
</subsystem>
mfcobol-localtx.rar リソース アダプターを追加する
<subsystem xmlns="urn:jboss:domain:resource-adapters:5.0"> タグ内で、次の <resource-adapter> 定義を <resource-adapters> の子として追加します。
<resource-adapter>
			<archive>mfcobol-localtx.rar</archive>
			<transaction-support>LocalTransaction</transaction-support>
			<connection-definitions>
				<connection-definition class-name="com.microfocus.cobol.connector.spi.CobolLocalTxManagedConnectionFactory" jndi-name="java:/eis/MFCobol_v1.5" pool-name="CobolConnectionFactory">
					<pool>
						<min-pool-size>2</min-pool-size>
						<max-pool-size>10</max-pool-size>
					</pool>
					<security>
						<application/>
					</security>
				</connection-definition>
			</connection-definitions>
		</resource-adapter>
mfcobol-xa.rar リソース アダプターを追加する
<subsystem xmlns="urn:jboss:domain:resource-adapters:5.0"> タグ内で、次の <resource-adapter> 定義を <resource-adapters> の子として追加します。
<resource-adapter>
			<archive>mfcobol-xa.rar</archive>
			<transaction-support>XATransaction</transaction-support>
			<connection-definitions>
				<connection-definition class-name="com.microfocus.cobol.connector.spi.CobolManagedConnectionFactory" jndi-name="java:/eis/MFCobol_v1.5" pool-name="CobolConnectionFactory">
					<xa-pool>
						<min-pool-size>2</min-pool-size>
						<max-pool-size>10</max-pool-size>
					</xa-pool>
					<security>
						<application/>
					</security>
				</connection-definition>
			</connection-definitions>
		</resource-adapter>

アプリケーションの .ear ファイルのディプロイ

アプリケーションの .ear ファイルを生成する場合、JBoss Application Server では、.ear ファイルにアプリケーションのディプロイ情報を指定するディプロイメント記述子があることが必要です。Interface Mapping Toolkit を使用してクライアントおよび EJB を生成する場合は、これらのディプロイメント記述子は自動的に作成されて .ear にパッケージ化されます。

JBoss EAP 7.1
アプリケーションの .ear ファイルをディレクトリ my-project\repos\my-service.deploy\my-service.ear(Windows) または my-project/repos/my-service.deploy/my-service.ear(UNIX) から JBoss ディプロイ ディレクトリにコピーします。デフォルトのディプロイ ディレクトリは jboss_home\standalone\deployments(Windows) または jboss_home/standalone/deployments(UNIX) です。

ロギング

JBoss EAP 7.1
デフォルトでは、jboss_home\standalone\log\server.logjboss_home\standalone\log\server.log にログ ファイルおよびトレースが保存されます。

JDBC データ ソースの XA トランザクション用の構成

ディプロイするアプリケーションからサード パーティのデータベースに接続する場合は、JDBC データ ソースを構成し、データ ソースの JNDI 名などの情報を指定する必要があります。

JBoss EAP 7.1
データ ソースを standalone.xml ファイルに追加します。

JDBC データ ソースの構成の詳細については、JBoss 管理のドキュメントを参照してください。

その他の情報

詳細情報は、JBoss Application Server インストール環境のリリース ノートおよび JBoss Web サイトを参照してください。