本番機（サーバ）の設定

最終更新日: 2023年7月31日

Wagbyで構築したアプリケーションはオンプレミスでもクラウドでも運用することができます。

オンプレミス（自社サーバへのインストール）

自社サーバへの Wagby のインストールは、次の手順で行います。

開発機で「フルビルド」を行います。
Wagbyをインストールしたフォルダに用意されるwagbyappをzip形式ファイルで圧縮します。
自社サーバ（本番機）に wagbyapp.zip をコピーし、展開します。

展開された wagbyapp フォルダには、Tomcat という Web アプリケーションサーバが含まれています。以下のいずれかの方法を選択します。

Tomcat 単体で運用する。[標準]: 最も簡単な方法です。
Linux または Windows OS 上で、Apache Web Server と連携して運用する。: 複数のアプリケーションを統合して運用する場合に有効です。一つの Apache Web Server に複数の Tomcat を連携させることで、利用者からみた URL を統合することができます。
Windows OS 上で、Microsoft IIS と連携して運用する。: 上記 Apache Web Server と同じ効果があります。

具体的な手順

サーバの設定は専門的な知識が必要です。Wagby販売パートナーによるサポートサービスをご利用ください。

クラウド

Wagby販売パートナーにご相談ください。

TomcatをWindowsのサービスに登録する

Tomcat を Windows のサービスの登録する方法を説明します。本説明に関するお問い合わせは標準サポートには含まれません。Premium Support をご利用ください。

1. ファイルコピー

この処理をスキップできます

Wagby R8.5.6/R9.0.2以降の Wagby では、この手順は不要です。（Windowsサービスに登録するための x64 版の 3 ファイル wagbyapp/bin/tomcat<バージョン番号>.exe, wagbyapp/bin/tomcat<バージョン番号>w.exe, wagbyapp/bin/tcnative-1.dll が最初から含まれています。）手順2へお進みください。

旧バージョンをご利用の場合

R8.5.6/R9.0.2より前のWagbyをご利用の場合、サービス登録の前に、それぞれのOSにあったファイルを次の手順でコピーします。

$(DEVHOME)\misc フォルダ内に用意されている apache-tomcat-8.5.XX-x64.zip を展開します。(XXはバージョン番号です。適切に読みかえてください。）

"-x64" は 64ビットWindows用です。32ビットOSではWagbyの運用は行えません。

このファイルの中に apache-tomcat-8.5.XX\bin フォルダに3つのファイルがあるので、これを$(DEVHOME)\wagbyapp\binフォルダにコピーします。

1 ※1 ビルド時に自動的にファイルのコピーを行いたい場合、$(DEVHOME)\customize\tomact\binフォルダにコピーします。開発サーバと運用サーバのOSの種類が同じであれば、この方法でも問題はありません。

※2 このファイルはWagbyのバージョンによって変わる可能性があるので、customize\tomcat\binフォルダに置いたファイルは、Wagbyのバージョンアップの際には適切に置き換えてください。

2.既存のサービスの確認

コントロールパネルの「サービス」を開き、Tomcatのサービスがないことを確認します。

すでにサービスが存在した場合は「コマンドプロンプト(管理者)」を開き、コマンドプロンプトから wagbyapp/bin フォルダに移動します。binフォルダにある remove_service.bat を実行します。

3.サービスの登録

サービスの登録は「コマンドプロンプト(管理者)」を開き、コマンドプロンプトから wagbyapp/bin フォルダに移動します。binフォルダにある install_service.bat を実行します。

※3 wagbyapp/bin フォルダに移動して実行する必要があります。

※4 環境変数 CATALINA_HOME がセットされて*いない*ことを前提としています。すでに CATALINA_HOME がセットされていた場合、こちらが想定していない動作になる可能性があります。

4.自動起動

OS起動時に、Tomcat を自動的に起動するには、サービスのプロパティを開き、スタートアップの種類を「手動」から「自動」変更します。

TomcatにSSLサーバ証明書を登録する

SSLサーバ証明書の登録は、Wagbyが利用しているTomcatの設定を変更することで対応します。詳細は、Tomcat付属のマニュアルを参考にしてください。

"SSL/TLS Configuration HOW-TO"
Tomcat 9 系https://tomcat.apache.org/tomcat-9.0-doc/ssl-howto.html
Tomcat 8.5 系https://tomcat.apache.org/tomcat-8.5-doc/ssl-howto.html

TLS 1.0/1.1 を無効にする

SSLサーバ証明書を設定する場合、セキュリティ向上策として TLS 1.0/1.1 を無効にすることを推奨します。Java Nio Connector を使った SSL 接続で SSLHostConfig 要素を使って TLS 1.2 のみを使うように設定した例を示します。

    <Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
               maxThreads="150" SSLEnabled="true">
        <SSLHostConfig protocols="TLSv1.2">
            <Certificate certificateKeystoreFile="conf/localhost-rsa.jks"
                         type="RSA" />
        </SSLHostConfig>
    </Connector>

Premium Support

本説明に関するお問い合わせは標準サポートには含まれません。上記「サービスメニュー」に記載のパートナーへご相談ください。

利用できる Java のバージョン

Wagbyが対応しているJavaのバージョン

Javaバージョン	Wagbyサポート対象	R7系	R8系	R9.0.0〜R9.1.x	R9.2.0〜
Java 7	◯	すべての R7	(動作しない)
Java 8	◯	すべて (最新のJava 8を使うこと。古いJava 8では動作しないことがあります。)			(動作しない)
Java 9 (*2)	-	R7.12.1からR7.12.4	R8.0.0からR8.0.2	-
Java 9/10	-	R7.12.5〜	R8.0.3〜	-
Java 11	◯	R7.12.8〜	R8.1.1〜	R9.0.0〜
Java 12	-	R7.12.13〜	R8.2.3〜	R9.0.0〜
Java 13	-	R7.12.15〜	R8.3.2〜	R9.0.0〜
Java 14	-	R7.12.19〜	R8.5.1〜	R9.0.0〜
Java 15	-	(動作しない)		R9.0.0〜
Java 16	-	(動作しない)		R9.0.3〜R9.1.x 注:Javaバージョンに"11"を指定すること。詳細は「Java16以降について」を参照。)	R9.2.0〜
Java 17	◯
Java 18〜	-

※ R7/R8 は Java 14 まで動作します。Java 15 以降は動作しません。

※ 正規ライセンス購入時に必要な「申請ID」の作成を Java 9 以降の環境で行えるのは R7.12.7/R8.0.5 よりあとです。それ以前の Wagby は Java 8 でのみ、申請IDの作成を行うことができます。

Javaのバージョンの指定

WagbyDesignerをJava9以降で実行した場合、Javaのバージョンに1.8以前のバージョンを指定することはできません。（起動時にエラーになります。）ビルドしたアプリケーションを Java 9以降で動作させる場合、必ずそのJavaでビルドしたものを利用してください。

「環境 > サーバ > ビルド > Javaのバージョン」に数字を指定します。詳細はリンク先のマニュアルをお読みください。

Java 16 以降について

R9.2.0以降は、Java 16 以降に対応しています。例えばJava17を利用する場合、Javaのバージョンを "17" と指定してください。

R9.0.0〜R9.1.xは、Java11として動作させてください。具体的にはJavaのバージョンを "11" と指定してください。これにより開発・実行環境が Java 16 以降であっても、コンパイルされたクラスファイルは Java 11 用としてビルドされるため、動作します。

※ R8.5.9〜およびR9.1.0〜のWagbyでは、開発者がカスタマイズしたコードで、指定したJavaバージョンでサポートされていない文法を利用するとコンパイルエラーとなります。（それ以前のWagbyはコンパイルできるものの実行時エラーとなります。）

警告メッセージについて

Tomcatのコンソールや、コマンドラインツール(import_db.batなど)を実行した際に、次の警告メッセージが表示されることがあります。

WARNING: An illegal reflective access operation has occurred
WARNING: Illegal reflective access by org.springframework.cglib.core.ReflectUtils$1 (file:/C:/Wagby-7.12.1/wagbyapp/webapps/wagby/WEB-INF/lib/spring-core.jar) to method java.lang.ClassLoader.defineClass(java.lang.String,byte[],int,int,java.security.ProtectionDomain)
WARNING: Please consider reporting this to the maintainers of org.springframework.cglib.core.ReflectUtils$1
WARNING: Use --illegal-access=warn to enable warnings of further illegal reflective access operations
WARNING: All illegal access operations will be denied in a future release

これはWagbyがJava9/10/11で非推奨としている機能を使用しているための警告を示すメッセージです。動作に支障はありませんので、無視してください。

InitLoader.jar の実行

インポート・エクスポートを行うコマンドラインツール InitLoader.jar を実行する場合、java コマンドのオプションに --add-modules ...を指定する必要があります。

手動での設定変更が必要な Wagby バージョン (*1)

R7.12.8 以降の Wagby を Java 7 で動作させる場合、開発者は以下に示す修正を手動で行う必要があります。

コマンドプロンプトを開き、Wagbyのインストールフォルダ内のmiscフォルダをカレントディレクトリとする。
このフォルダ内にあるuse_java7.batを実行する。

use_java7.batを実行すると、下記のようなメッセージがコンソールに出力されます。

Move Java7 un-used jar files to BACKUPDIR ../bak_java7
...
Process Complete.

このコマンドは1回だけ実行できます。再度、実行した場合はエラーとなり、動作しないように制御されています。

このコマンド実行により、Java7では必要ではない、いくつかのJARファイルがWagbyインストールフォルダ内のbak_java7フォルダに移動されます。このあとDesignerを起動し、フルビルドを行ってください。

[ご注意ください] Java7でビルドしたアプリケーション(wagbyapp)は、Java7とJava8でのみ実行できます。Java9以降では動作しません。

手動での設定変更が必要な Wagby バージョン (*2)

R7.12.1 から R7.12.4 および R8.0.0 から R8.0.2 までの Wagby を使って Java 9/10 で開発・運用する場合、開発者は以下に示す修正を手動で行う必要があります。（R7.12.5/R8.0.3 以降の Wagby では、ここに記載している設定や制約は不要です。）

setenv.batの変更 (Windows OS 利用時)

wagbydesigner/bin/setenv.batに下記を追記してください。

set CATALINA_OPTS=%CATALINA_OPTS% "--add-modules" "java.xml.bind,java.activation,java.xml.ws.annotation"

setenv.shの変更 (Linux/Mac OS 利用時)

wagbydesigner/bin/setenv.shに下記を追記してください。

CATALINA_OPTS=$CATALINA_OPTS\ --add-modules\ java.xml.bind,java.activation,java.xml.ws.annotation

この設定を行わないと、WagbyDesigner起動時に"java.lang.NoClassDefFoundError: javax/activation/DataSource"エラーが生じます。

この設定は Java 7/8 では不要です。Java を 7/8 に戻す場合は、この設定も削除してください。

技術情報

Javaの種類

サーバ（本番機）にも JDK をインストールしてください。JRE でのご利用は、サポート対象外です。

起動時のカレントディレクトリ

起動時は、スクリプトのあるディレクトリまでカレントを移動してから実行します。インストールディレクトリを wagby7 としたときの Linux OS での操作例を示します。

cd /home/wagby7/wagbyapp/bin; ./startup.sh

WagbyDesignerも同様です。

cd /home/wagby7/wagbydesigner/bin; ./startup.sh

終了処理 (shutdownスクリプト) も同じようにカレントを移動してから実行してください。

OS環境変数

Linux系

日付の書式に違和感がある場合、環境変数 LANG を ja_JP.UTF8 に設定するとよいでしょう。例を示します。

export LANG=ja_JP.UTF8