ライセンスのセットアップ

申請いただいたホスト名を基に作成したライセンスファイル「licence.properties」を別途送付します。指定のフォルダ（<bsws_server_home>/lib ）へコピーしてください。ライセンスファイル｢licence.properties｣がない場合は、Webサービスサーバが正常に動作しませんのでご注意ください。

• biz-Streamライブラリ共通ガイド 『biz-Stream ライセンスのセットアップ』を参照してください

JDBCドライバの設定

データベース機能を用いる場合は、JDBCドライバが必要になります。JDBCドライバは各ベンダーより取得してください。取得した jar または zip ファイルを<bsws_server_home>/libへコピーしてください。
コピーが終了するとJDBCドライバの設定は完了です。

TimeOut の設定

biz-Stream での TimeOut の設定は呼び出し側と呼び出される側の両方で TimeOut の設定を行うことができます。

1. サーバ側でのセッション Timeout 設定方法 <bsws_server_home>/conf/web.xml ファイルの <session-timeout>タグにおいて、下図"5"の部分を変更するとサーバ側のセッション TimeOut の設定を変更することができます。
   
   
2. 【注】 単位：分
   

   <session-config>
   　　　<session-timeout>5</session-timeout>
   </session-config>

3. クライアント（アプリケーション）側での Timeout 設定
   アプリケーション側での設定は、開発環境によって異なります。開発環境毎の設定方法に関しては、後述のサンプルアプリケーションにて設定していますので、そちらをご参考にしてください。

JVM ヒープメモリの設定

biz-Stream Webサービスサーバでは、サイズの大きいレイアウト定義ファイルや PDF を出力する場合は JVM の設定がデフォルトのままですと、ヒープメモリが足りずに OutOfMemory の例外が発生してしまいます。そのため JVMの設定変更をする必要があります。なお JVM 引数の詳細については、JDK のドキュメントなどをご参照ください。

Windows の場合

1. スタートメニューの Apache Tomcat 8.5 → Monitor Tomcat をクリックします。
   表示された Apache Tomcat Properties パネル上のJavaタブをクリックします。
   
   
2. フィールドに設定値を定義してください。
   Apache Tomcat Properties パネル上のJavaタブで入力するフィールドは次のようになっています。

   フィールド名	内容
   Java Virtual Machine	サーバのVMを指定するパラメータ
   Initial memory pool	メモリの初期使用量を指定するパラメータ
   Maximum memory pool	メモリの最大使用量を指定するパラメータ
   Thread stack size	スレッドスタックサイズを指定するパラメータ

Linux/UNIX の場合

setenv.shのCATALINA_OPTS にJVMの引数で設定値を定義してください。設定するJVMの引数は次のようになっています。

（例）export CATALINA_OPTS="-server -Xms64M -Xmx128M -Xss256K"

起動方法

biz-Stream Webサービスサーバを起動するには、次の手順で起動してください。

Windows の場合

スタートメニューの Apache Tomcat 8.5 → Monitor Tomcat をクリックし、表示されたApache Tomcat Properties パネルの[Start]ボタンを押します。

Linux/UNIX の場合

1. <bsws_server_home>/bin　に移動します。
2. startup.sh ファイルを実行します。

• biz-Stream Webサービスサーバの起動確認については『2.9 インストール結果の確認』をご参照ください。

停止方法

biz-Stream Webサービスサーバを停止するには、次の手順で起動してください。

Windows の場合

スタートメニューの Apache Tomcat 8.5 → Monitor Tomcat をクリックし、表示されたApache Tomcat Properties パネルの[Stop]ボタンを押します。

Linux/UNIX の場合

1. <bsws_server_home>/bin　に移動します。
2. shutdown.sh ファイルを実行します。

• OSによってはプロセスが残ってしまう場合がありますので、その場合はshutdown.sh -force コマンドで停止してください。

${base-dir} の設定と確認

ファイルパスの共通部分について、${base-dir} 変数で指定することができます。base_dir の設定内容を各環境にあわせて設定することで、アプリケーションを修正することなく環境の移行が円滑にできます。
${base-dir} の設定は、<bsws_server_home>/lib/default_values.properties ファイル内の項目base_dir で指定します。

• 『第3章 プロパティファイル』を参照してください

注意事項

一部のOSでPDF生成に遅延が発生する場合があります。 現在本事象が発生することが確認されている環境はRed Hat Enterprise Linux (およびCentOS)6, 7です。
その場合は、<bsws_server_home>/bin/setenv.sh の以下の行をコメントインしてください。

CATALINA_OPTS="$CATALINA_OPTS -Djava.security.egd=file:/dev/./urandom"