環境設定情報

Java

Java 8(OracleJDKのみ)、Java 11、Java 17

Webサーバ

Apache HTTP Server 2.4 推奨

APサーバ

Tomcat 9.0 (Servlet 4.0、JSP 2.3以上を実装するWebServer)

DBサーバ

Oracle 11gR2以上※1、MySQL 5.7/8.0、PostgreSQL 9.6以上、SQL Server 2012以上※2、Amazon Aurora※3

※1

バージョンは11.2.0.3.0以上を推奨します。

※2

SQL Serverでは以下の制限があります。

  • EQLのLOCALTIME関数は使用できません。

※3

Aurora利用の際はMySQL純正のJDBCドライバを利用してください。

Google Chrome, Safari, Mozilla Firefox, Microsoft Edge

Apache版

Apache HTTP Server 2.4
Windows、RHEL、Amazon Linux

IIS版

IIS 8.5以上
.NET 4.5.1以上
Windows Server 2012R2以上

JavaEE版

Tomcat 8.5以上 (Servlet 3.1、JSP 2.3以上を実装するWebServer)
Java 8 (Oracle JDK)、Java 11 (Oracle JDK、Open JDK)
Windows、RHEL、Amazon Linux

Serverless(JavaScript)版

Fetch APIに対応したJavaScriptランタイムが提供されるサーバーレス環境(CDN前段などで動作するエッジ環境)

iPLAssのDB及びテーブルの作成手順についてはiPLAss SDKをダウンロードし、同梱されているサーバセットアップキット(iplass-server-setup-kit)のreadme_setup.txtを参照ください。

トランザクション分離レベルは「READ COMMITTED」である必要があります。

  • データベースキャラクターセットは「AL32UTF8」を使用して下さい。

  • データベースの文字コードは「utf8mb4」を使用して下さい。

  • データベースの照合順序は「utf8mb4_bin」を推奨します。

    照合順序について

    大文字、小文字を区別する場合は、「utf8mb4_bin」
    大文字、小文字を区別しない場合は、「utf8mb4_general_ci」

  • データベースの文字セット符号化方式は「UTF8」を使用して下さい。

  • データベースの照合順序は「Japanese_Unicode_CI_AS_KS_WS」を使用して下さい。

利用するDBに応じたservice-configファイルを継承してください。

DBservice-configファイル

Oracle

mtp-core-service-config-oracle.xml

MySQL 8.0以上

mtp-core-service-config-mysql.xml

MySQL 5.7

mtp-core-service-config-mysql-5.7.xml

PostgreSQL

mtp-core-service-config-postgre.xml

SQL Server

mtp-core-service-config-sqlserver.xml

テーブル作成時に疑似パーティションを作成するDDLを利用した場合は、対応する service-config ファイルを利用する必要があります。
詳細については service-configファイルの分割 を参照してください。

設定例:DBにOracleを利用する場合
<serviceDefinition>
  <inherits>/mtp-core-service-config-oracle.xml</inherits>
</serviceDefinition>

擬似パーティションを利用する場合は、mtp-service-config.xmlに以下の設定を行い、疑似パーティションテーブルを作成する事で対応が可能となります。
疑似パーティションテーブルとして作成する対象は、保存先変更対象テーブル一覧を参照ください。

設定例:(以下の丸1の部分を追加)
<service>
  <interface>org.iplass.mtp.impl.datastore.StoreService</interface>
  <property name="dataStore" class="org.iplass.mtp.impl.datastore.grdb.GRdbDataStore">
    <property name="storageSpace">
      <property name="tableCount" value="3" /> (1)
      <property name="storageSpaceName" value="default" />
      <property name="varcharColumns" value="128" />
        :
    </property>
  </property>
</service>
■命名規約

テーブル名称+__+インクリメント数値

例:tableCountが3の場合

OBJ_STORE、OBJ_STORE__1、OBJ_STORE__2

iPLAssでは、Entityは全て同一のテーブルに登録されます。特定のEntityのみデータ量が多いといった場合、そのEntityのみ別の物理テーブルへ登録する事が出来ます。
保存先テーブルを変更する場合は、保存先となるテーブルを作成し、mtp-service-config.xmlに以下の設定をする事で対応が可能となります。
保存先テーブルとして作成する対象テーブルは、保存先変更対象テーブル一覧を参照ください。

設定例:(以下の丸1及び丸2の部分を追加。securespace、fastの二つを追加する例)
<service>
  <interface>org.iplass.mtp.impl.datastore.StoreService</interface>
  <property name="dataStore" class="org.iplass.mtp.impl.datastore.grdb.GRdbDataStore">
    <property name="storageSpace"> (1)
      <property name="storageSpaceName" value="securespace" />
      <property name="tableNamePostfix" value="S" />
      <property name="varcharColumns" value="128" />
        :
    </property>
    <property name="storageSpace"> (2)
      <property name="storageSpaceName" value="fast" />
      <property name="tableNamePostfix" value="FAST" />
      <property name="varcharColumns" value="128" />
        :
    </property>
      :
  </property>
</service>
■命名規約

テーブル名称+__+tableNamePostfixの値

例:tableNamePostfixが「S」の場合

OBJ_STORE__S

疑似パーティション及び保存テーブル変更時の対象テーブル一覧
Noテーブル名称

1

OBJ_STORE

2

OBJ_STORE_RB

3

OBJ_REF

4

OBJ_REF_RB

5

OBJ_INDEX_DATE

6

OBJ_INDEX_DBL

7

OBJ_INDEX_NUM

8

OBJ_INDEX_STR

9

OBJ_INDEX_TS

10

OBJ_UNIQUE_DATE

11

OBJ_UNIQUE_DBL

12

OBJ_UNIQUE_NUM

13

OBJ_UNIQUE_STR

14

OBJ_UNIQUE_TS

テーブル定義は バッチツール - Custom Storage Space で作成することができます。

行ロックのタイムアウト時間を設定します。iPLAssのデフォルト設定では0(NOWAIT)となっています。

■Oracleの場合

ロックタイムアウト時間を変更したい場合は、mtp-service-config.xmlの以下の設定を0以上に変更してください。

<service>
  <interface>org.iplass.mtp.impl.rdb.adapter.RdbAdapterService</interface>
  <property name="adapter" class="org.iplass.mtp.impl.rdb.oracle.OracleRdbAdapter">
    <property name="lockTimeout" value="0" />
  </property>
</service>
■MySQLの場合

MySQLにはロックタイムアウト時間をDB単位で設定しているため、Oracleの「select for update nowait」のようなロック取得直後にエラーとするような処理が存在しません。

■PostgreSQLの場合

ロックタイムアウト時間を変更したい場合は、mtp-service-config.xmlの以下の設定を0以上に変更してください。 PostgreSQLではロックタイムアウトの待機時間指定は出来ません。0以上を設定するとロック出来るまで待ち続けます。

<service>
  <interface>org.iplass.mtp.impl.rdb.adapter.RdbAdapterService</interface>
  <property name="adapter" class="org.iplass.mtp.impl.rdb.postgresql.PostgreSQLRdbAdapter">
    <property name="lockTimeout" value="0" />
  </property>
</service>
■SQL Serverの場合

ロックタイムアウト時間を変更したい場合は、mtp-service-config.xmlの以下の設定を0以上に変更してください。

<service>
  <interface>org.iplass.mtp.impl.rdb.adapter.RdbAdapterService</interface>
  <property name="adapter" class="org.iplass.mtp.impl.rdb.sqlserver.SqlServerRdbAdapter">
    <property name="lockTimeout" value="0" />
  </property>
</service>
  • LIKE句のワイルドカードについて
    11.2.0.3.0よりLIKE句のワイルドカードの仕様が変更になっています。
    上記バージョンより、全角の%、_がワイルドカードではなくなり、通常の文字となっています。
    この差異を吸収するため、OracleRdbAdapterにescapeFullwidthWildcardフラグを用意しています。
    デフォルトはfalse(11.2.0.3.0以上で正しく動作する設定)です。
    11.2.0.2.0を利用する場合は、このフラグをtrueに設定するようにしてください。

    <service>
      <interface>org.iplass.mtp.impl.rdb.adapter.RdbAdapterService</interface>
      <property name="adapter" class="org.iplass.mtp.impl.rdb.oracle.OracleRdbAdapter">
        <property name="escapeFullwidthWildcard" value="true" />
      </property>
    </service>
  • ストレージエンジン:InnoDB、ファイルフォーマット:Barracuda(with innodb_large_prefix)の利用が前提

    ストレージエンジン

    InnoDB

    ファイルフォーマット

    Barracuda

    を利用し、innodb_large_prefixが有効化されていることが必要です。

MySQL5.7.7以上の場合、innodb_large_prefixの設定は不要です。
  • 文字コードは「utf8mb4」を標準使用

    但し、こちらの文字コードを使用する事により以下の制約が発生します。

    • EntityのStringプロパティで「Unique Index」「Index」を指定した場合、MySQLの利用文字コードによって対象とできる値サイズに制約が発生します。

    • utf8mb4の場合、StringProperty値に255文字を超える値が設定されている場合は更新時にエラーになります。

    オプションファイル(my.ini/cnf)文字コードの指定は次の形となります。

[client]
default-character-set=utf8mb4
[mysql]
default-character-set=utf8mb4
[mysqld]
character-set-server=utf8mb4
  • クエリキャッシュの無効化
    クエリキャッシュが有効の場合は、書き込み時にテーブルをロックしてしまいます。 更新に時間がかかる処理を実施する場合に他のセッションへ影響が出てしまうため無効にする必要があります。

    [mysqld]
    query_cache_size=0
MySQL8.0.1以上の場合、本設定は不要です。
  • LOBデータの保存先設定
    MySQLでは、LOBデータはRDB外に保存することを推奨します。LOBデータはファイルシステム、もしくは AWS S3 に格納することが可能です。 保存先の設定が必要になります。 LOB保存先 を参照ください。

  • GTIDの利用
    グループレプリケーションで必要となるGTIDを利用する場合、テンポラリテーブルに関する設定の変更が必要になります。
    iPLAssの標準ではテンポラリテーブルの作成及び削除はトランザクション内で行っていますが、GTIDを利用した場合トランザクション内でテンポラリテーブルの作成及び削除が出来ません。 そのため、iPLAssではテンポラリテーブルの作成及び削除をトランザクション外で行う又はデータソース側で行うためのオプションを用意しています。

    トランザクション外で行う場合
    <service>
      <interfaceName>org.iplass.mtp.impl.rdb.adapter.RdbAdapterService</interfaceName>
      <property name="adapter" className="org.iplass.mtp.impl.rdb.mysql.MysqlRdbAdaptor">
        <property name="localTemporaryTableManageOutsideTransaction" value="true" />
      </property>
    </service>
    データソース側で行う場合
    <service>
      <interfaceName>org.iplass.mtp.impl.rdb.adapter.RdbAdapterService</interfaceName>
      <property name="adapter" className="org.iplass.mtp.impl.rdb.mysql.MysqlRdbAdaptor">
        <property name="localTemporaryTableCreatedByDataSource" value="true" />
      </property>
    </service>

    データソース側でのコネクション(セッション)初期化時の処理として、次のSQL文を実行するよう設定してください。

    CREATE TEMPORARY TABLE `obj_store_tmp` (`obj_id` VARCHAR(64) NOT NULL, `obj_ver` BIGINT(10) DEFAULT 0 NOT NULL) ENGINE = MEMORY;
  • 内部一時テーブルの設定
    MySQL5.7より、内部一時テーブルのストレージエンジンがデフォルトで InnoDB になりました。 これにより内部一時テーブルが利用された際に行サイズ制限のエラーが発生する可能性があります。
    ストレージエンジンを MyISAM に切り替えることで回避することが可能です。

    [mysqld]
    internal_tmp_disk_storage_engine=MyISAM
MySQL8.0.16以上の場合、本設定は不要です。
  • タイムゾーンデータのインポート
    タイムゾーンデータがインポートされている必要があります。 タイムゾーンのインポートについてはMySQLのタイムゾーンの ダウンロードサイト を参照してください。

  • タイムゾーンの指定
    Connector/J 8.0以上ではタイムゾーンの指定が必要です。
    Windows環境の場合、システムのデフォルトタイムゾーンがMySQLに適用されないため必ずタイムゾーンを指定する必要があります。
    Linux環境の場合、システムのタイムゾーンをMySQLが利用するため変更以外でタイムゾーンの指定は必要ありません。

    指定の仕方には次の3つの方法があります。

    • 環境変数「TZ」による指定(推奨)

      指定例

      TZ=JST-9

    • JDBCパラメータ「serverTimezone」による指定

      指定例

      jdbc:mysql://<mysqlserver>:3306/mtdb?serverTimezone=Asia%2FTokyo

    • MySQL設定ファイルによる指定
      事前にタイムゾーンデータがインポートされている必要があります。

      指定例
      [mysqld]
      default-time-zone='Asia/Tokyo'
指定するタイムゾーンはAPサーバ(正確にはJRE)のタイムゾーンと一致させる必要があります。
  • Window関数サポートの設定
    MySQL8.0以上を利用の場合はMySQLネイティブのWindow関数を利用可能です。 MySQLネイティブのWindow関数を利用する場合、次の設定が必要になります。

    <service>
      <interface>org.iplass.mtp.impl.rdb.adapter.RdbAdapterService</interface>
      <property name="adapter" class="org.iplass.mtp.impl.rdb.mysql.MysqlRdbAdaptor">
        <property name="supportWindowFunction" value="true" />
      </property>
    </service>

    Window関数をサポートしていないMySQL5.7以下を利用の場合、 Window関数のエミュレート機能 を有効にすることでWindow関数を利用することができます。
    Window関数のエミュレート機能を有効する場合は以下の設定を行ってください。

    <service>
      <interface>org.iplass.mtp.impl.datastore.StoreService</interface>
      <property name="dataStore" class="org.iplass.mtp.impl.datastore.grdb.EnterpriseGRdbDataStore">
        <property name="enableWindowFunctionEmulation" value="true" />
      </property>
    </service>
  • 小数点以下桁数の設定
    Entityのプロパティ型としてDecimal型、またはEQLにてDIV演算子を使用する際に、小数点第5位以下を扱う場合は、MySQLのシステム変数 div_precision_increment を設定してください。
    Decimal型はDIV演算子を使用しない場合でも、iPLAss内部で桁数調整のため自動的にDIVをしているので div_precision_increment の設定が必要です。

  • LOBデータの保存先設定
    PostgreSQLでは、LOBデータはRDB外に保存することを推奨します。LOBデータはファイルシステム、もしくは AWS S3 に格納することが可能です。 保存先の設定が必要になります。 LOB保存先 を参照ください。

  • コネクションプール接続設定
    コネクションプール接続の設定は、mtp-service-config.xmlに以下の設定を行ってください。

    <service>
      <interface>org.iplass.mtp.impl.rdb.connection.ConnectionFactory</interface>
      <class>org.iplass.mtp.impl.rdb.connection.DataSourceConnectionFactory</class>
      <property name="dataSourceName" value="java:comp/env/yourDataSource" />
    </service>

    ※yourDataSourceはデータソース名を設定

    合わせてAPサーバ側にデータソースの設定を行います。 (Tomcatの場合、Context.xmlに上記のデータソースの設定をします)

  • Webクライアント情報のJavaServlet環境へバイパス設定
    APサーバの前段にHTTPサーバなどのProxyが存在する場合、Webクライアント情報がJavaServlet環境へバイパスする設定をします。

    iPLAssでは、

    ServletRequest#getRemoteAddr()
    ServletRequest#isSecure()

    を利用しているため、最低限これらの情報をバイパス設定する必要があります。

    Tomcatの場合、

    org.apache.catalina.valves.RemoteIpValve

    を利用することにより、バイパス設定を行います。
    また、isSecureについては、すべての接続をHTTPSで受ける(そしてそれが前段のロードバランサでSSL terminationしている)場合は、Connecterの設定にて設定することも可能です。

  • 静的コンテンツのルートパス設定
    Apacheなどのプロキシサーバの設定により、WebApplicaton名(=war名)を別名でマッピングする場合、設定を変更してください。 設定しない場合、servletContextPathが静的コンテンツのルートパスとなります。

    <service>
      <interface>org.iplass.mtp.impl.web.WebFrontendService</interface>
      <class>org.iplass.mtp.impl.web.WebFrontendService</class>
      <property name="staticContentPath" value="/static" />
    </service>
  • ファイルアップロードの一時ファイル格納先
    ファイルアップロード時に一時ファイルとして作成される格納先を変更する事が可能です。

    <service>
      <interface>org.iplass.mtp.impl.web.WebFrontendService</interface>
      <class>org.iplass.mtp.impl.web.WebFrontendService</class>
      <property name="tempFileDir" value="/tmp" />
    </service>

    上記の設定を行わない場合、Servlet仕様で規定される、"javax.servlet.context.tempdir"を利用するため、意図しない場所に作成される可能性があるので注意してください。

  • アップロードファイルの最大サイズ制限
    アップロードされるファイルの最大サイズに制限をかけることが可能です。

    mtp-service-config.xmlに設定する事でアップロードファイルの最大サイズが設定可能です。

    <service>
      <interface>org.iplass.mtp.impl.web.WebFrontendService</interface>
      <class>org.iplass.mtp.impl.web.WebFrontendService</class>
      <property name="maxUploadFileSize" value="10000" />
    </service>
  • アップロードファイルのマジックバイトチェック
    マジックバイトチェック(ファイルの拡張子とファイル中身が一致しているか否か)について、カスタムでマジックバイトのルールを設定することが可能です。
    ファイルの作成方法によって、ファイルのマジックバイトが通常とは異なることがあります。 マジックバイトチェックがエラーとなる場合は、任意でマジックバイトのルールを追加してください。

    <service>
      <interface>org.iplass.mtp.impl.web.WebFrontendService</interface>
      <class>org.iplass.mtp.impl.web.WebFrontendService</class>
      <property name="isExecMagicByteCheck" value="true" />
      <property name="magicByteChecker" class="org.iplass.mtp.impl.web.fileupload.DefaultMagicByteChecker" >
        <property name="magicByteRule" >
          <property name="mimeType" >
            <property name="pattern" value="image/gif" />
          </property>
          <property name="magicByte" value="474946383761" />
          <property name="magicByte" value="474946383961" />
        </property>
         :
      </property>
    </service>
  • LOB保存先の設定
    Binary型及びLongText型のデータの保存先は、ファイル形式、RDB内(のBLOBなどのバイナリ型として)、 AWS S3 のいずれかの保存方式を選択することができます。
    保存方式を変更したい場合は、以下の設定を変更してください。

    RDB内で保存の場合は、org.iplass.mtp.impl.lob.lobstore.rdb.RdbLobStoreを指定
    ファイル形式で保存の場合は、org.iplass.mtp.impl.lob.lobstore.file.FileLobStoreを指定
    AWS S3で保存の場合は、org.iplass.mtp.impl.aws.lobstore.s3.S3LobStoreを指定

    RDBとしてMySQL、PostgreSQLを利用する場合、binaryStoreはFileLobStoreもしくはS3LobStoreの利用を推奨します。 これらのDBへJDBC経由でアクセスした場合、バイナリデータはストリーム処理されないため、OutOfMemoryErrorの危険性が増します。
    設定例1
    <service>
      <interface>org.iplass.mtp.impl.lob.LobStoreService</interface>
      <property name="binaryStore" class="org.iplass.mtp.impl.lob.lobstore.file.FileLobStore">
        <property name="rootDir" value="D:\tmp\fileLobStore" />
      </property>
      <property name="longTextStore" class="org.iplass.mtp.impl.lob.lobstore.rdb.RdbLobStore" />
    </service>

    この設定では、Binary型のデータを「D:\tmp\fileLobStore」フォルダ下にファイル形式で保存、LongText型のデータをDB内に保存します。

    設定例2
    <service>
      <interface>org.iplass.mtp.impl.lob.LobStoreService</interface>
      <property name="binaryStore" class="org.iplass.mtp.impl.aws.lobstore.s3.S3LobStore">
        <property name="region" value="ap-northeast-1" />
        <property name="endpoint" value="s3.ap-northeast-1.amazonaws.com" />
        <property name="bucketName" value="yourBucketName" />
      </property>
      <property name="longTextStore" class="org.iplass.mtp.impl.lob.lobstore.rdb.RdbLobStore" />
    </service>

    この設定では、Binary型のデータをS3のap-northeast-1リージョンのyourBucketNameバケットに保存します。

  • APサーバを冗長化した場合の設定
    APサーバを冗長化する場合、APサーバでのクラスタ設定に加えて、iPLAssにも設定が必要です。 iPLAssはメタデータ等をAPサーバ内のメモリにキャッシュして保持します。これらのキャッシュされたオブジェクトの変更通知等を共有する必要があるためです。

    クラスタメンバへの通知方法は以下のいずれかを利用します。

    • HttpMessageChannel
      HTTPベースで各APサーバへ非同期にメッセージ通知します。
      ClusterServiceにorg.iplass.mtp.impl.cluster.channel.http.HttpMessageChannelを設定します。

      <service>
        <interface>org.iplass.mtp.impl.cluster.ClusterService</interface>
        <property name="messageChannel" class="org.iplass.mtp.impl.cluster.channel.http.HttpMessageChannel">
          <property name="serverUrl" value="http://1号機のHOST名/mtp/cmcs" /> (1)
          <property name="serverUrl" value="http://2号機のHOST名/mtp/cmcs" />
          <property name="certKey" value="yourOwnCertKey" /> (2)
          <property name="connectionTimeout" value="300000" />
          <property name="soTimeout" value="300000" />
        </property>
      </service>
      1serverUrlに http://[HOST名]/[appContext]/cmcs の形式でクラスタメンバを羅列します
      2yourOwnCertKeyは、クラスタメンバに共通のシークレット(パスワード)を設定します。

      HttpMessageChannelを利用する場合、合わせて非同期送信スレッドのプール数を設定します。プール数は実際のサーバ数×2程度の値が目安です。

      <service name="AsyncTaskServiceForHttpMessageChannel">
        <interface>org.iplass.mtp.impl.async.AsyncTaskService</interface>
        <property name="corePoolSize" value="4" />
        <property name="threadPoolType" value="fixed" />
      </service>
    • JGroupsMessageChannel
      クラスタメッセージ基盤ツールのJGroupsを利用してメッセージ通知します。
      ClusterServiceにorg.iplass.mtp.impl.cluster.channel.jgroups.JGroupsMessageChannelを設定します。

      <service>
        <interface>org.iplass.mtp.impl.cluster.ClusterService</interface>
        <property name="messageChannel" class="org.iplass.mtp.impl.cluster.channel.jgroups.JGroupsMessageChannel">
          <property name="configFilePath" value="/path/to/jgroups_config_file.xml" />
          <property name="clusterName" value="jgroupsClusterName" />
        </property>
      </service>

      JGroupsではマルチキャスト、S3_PINGなどのプロトコルを利用しクラスタメンバを自動でディスカバリします。 クラスタメンバのノードの数、HOST名が不定の場合でも利用可能です。

    • InfinispanMessageChannel
      Infinispanのクラスタメンバ間の通知機能を利用しメッセージ通知します。
      ClusterServiceにorg.iplass.mtp.impl.infinispan.cluster.channel.InfinispanMessageChannelを設定します(別途、InfinispanServiceの設定も必要です)。

      <service>
        <interface>org.iplass.mtp.impl.cluster.ClusterService</interface>
        <property name="messageChannel" class="org.iplass.mtp.impl.infinispan.cluster.channel.InfinispanMessageChannel">
          <property name="sync" value="false" />
        </property>
      </service>

      Infinispanは内部でクラスタ通信にJGroupsを利用します。 CacheStoreとしてInfinispanを利用しない場合は、JGroupsMessageChannelを利用してください。

  • X-Frame-Optionsヘッダを設定する場合は「SAMEORIGIN」ディレクティブを指定
    iPLAssではiframeを利用しているため、クリックジャッキング対策としてX-Frame-Optionsヘッダを設定する場合は「SAMEORIGIN」ディレクティブを指定してください。

  • 依存ライブラリの追加
    利用する機能に応じ、build.gradleのコメントアウトされた行のコメントを解除して依存ライブラリを追加します。

  • 依存ライブラリのコピー
    Gradleの「copyRuntimeLibs」タスクを実行してバッチの実行に必要なライブラリを「lib」ディレクトリにコピーします。

    gradlew copyRuntimeLibs
  • バッチで利用するDB接続先の設定
    バッチで利用するDB接続先の設定が行われている必要があります。

    <service>
      <interface>org.iplass.mtp.impl.rdb.connection.ConnectionFactory</interface>
      <class>org.iplass.mtp.impl.rdb.connection.DriverManagerConnectionFactory</class>
      <property name="url" value="XXXXXXXXXX" />
      <property name="user" value="XXXXX" />
      <property name="password" value="XXXXX" />
      <property name="driver" value="XXXXXXXX" />
    </service>
  • tool_env.shまたはtool_env.batの設定
    tool_env.shまたはtool_env.bat内の以下の変数に適切な値が設定されている必要があります。

    SERVICE_CONFIG_NAME
    MTP_RESOURCE_PATH

キャッシュの生存時間(TimeToLive)の設定による期限切れでキーが削除された場合に発行される削除イベントの通知を受け取る場合は、 RedisのKeyspace通知機能を有効にする必要があります。

設定はredis.confの’notify-keyspace-events’を通してExpiredイベントの通知を有効にしてください。

設定例:全てのKeyspace通知を有効にする
notify-keyspace-events KEA

Redisの仕様により、期限切れによるキー削除イベントの通知が期限切れ時に行われることは保障されていません。 Keyspace通知機能の仕様についてはRedis Keyspace Notificationsを参照してください。

Enterprise Editionにアップグレードする場合、Gradleプロジェクトの置き換え又はライブラリの差し替えと、テーブルの追加が必要です。

ライブラリとテーブルDDLは有償版のSDKに同梱されています。

Gradleプロジェクトの置き換えとライブラリの差し替えはどちらか一方を行ってください。

有償版SDKの「iplass-ee-skeleton」フォルダにある「build.gradle」と「gradle.properties」を既存のファイルと置き換えます。

置き換えた「gradle.properties」をエディタで開き、「iPLAssMavenRepoUsername」及び「iPLAssMavenRepoPassword」にEnterprise Edition Mavenリポジトリのアカウントのユーザー名とパスワードを設定してください。

Community Editionの下記ライブラリをEnterprise Editionの相応するライブラリで差し替えます。

差し替え対象ライブラリ一覧
Community EditionEnterprise Edition

iplass-core

iplass-ee-core

iplass-gem

iplass-ee-gem

iplass-web

iplass-ee-web

iplass-admin

iplass-ee-admin

iplass-tools

iplass-ee-tools

iplass-tools-batch

iplass-ee-tools-batch ※

ライブラリファイルは有償版SDKの「lib」フォルダに格納されています。
※iplass-ee-tools-batchのライブライファイルは、有償版SDKに同梱されている「iplass-ee-tools-batch-x.x.x.zip」ファイル内の「lib」フォルダに格納されています。

有償版のSDKに同梱されている下記DDLを実行し、テーブルを作成します。

  • audit_log.sql

  • sys_stats.sql

  • t_available.sql

DDLファイルは有償版SDKに同梱されている「iplass-ee-server-setup-kit-x.x.x.zip」ファイル内の「ddl」フォルダにデータベースの種類ごとに格納されています。

MySQL及びパーティション対応のPostgreSQLを利用の場合、「audit_log」テーブルのパーティションを既存のテナント数分、追加作成する必要があります。 パーティションの追加作成はテナント管理ツール「TenantManager」のパーティション管理機能を利用してください。

インストーラにてiPLAssのセットアップを行います。 インストーラではiPLAssの動作に必要な情報を画面または設定ファイルにて指定することによりiPLAssの動作環境を作成します。

インストールの方式には、セットアップ画面にてインストールを行う「ウィザードインストール」と、セットアップ画面を介さずセットアップに必要な情報を予め設定したインストール設定ファイルを用いてインストールを行う「サイレントインストール」の2通りの方式があります。

セットアップ画面にて情報を入力しインストールを行います。

手順
  1. iPLAssのURLにアクセスします。

  2. セットアップ画面に必要な情報を入力しセットアップ開始ボタンを押下します。

  3. セットアップ画面に従いAPサーバを再起動します。

  4. 再度、iPLAssのURLにアクセスします。

  5. 準備中画面の表示後、iPLAssのログイン画面が表示されます。

セットアップ画面

iPLAssSetup
セットアップ画面入力項目(接続情報)

データベース

使用するデータベースの種類を選択します。

DBAユーザー名

データベースのDBA権限を持つユーザーのユーザー名を入力します。

DBAパスワード

データベースのDBA権限を持つユーザーのパスワードを入力します。

バイナリデータファイル保存場所

バイナリデータファイルの保存先ルートディレクトリのパスを入力します。

テーブル自動作成

チェックをするとiPLAssで利用するテーブルを作成します。新規にセットアップを行う場合は必ずチェックしてください。
既にテーブルが存在する場合、テーブルは再作成されデータは初期化されます。
再セットアップ等で既存のデータを残す場合はチェックを外してください。

JDBC URL

ホスト名、ポート番号を入力すると自動的に設定されます。直接編集を行う場合は「編集」をチェックしてください。
※Oracle以外のデータベースを使用の場合、データベース名は必ず「mtdb」として下さい。

Microsoft JDBC Driver for SQL Server を利用する場合の注意点

10.2 以降のバージョンでは、デフォルトで TLS 接続が有効化されています。 TLS 接続を利用しない場合は JDBC URL の最後に ;encrypt=false を追記する必要があります。 追記するためには「編集」をチェックし直接編集が必要となります。

JDBC URL 設定例
# 10.2 よりも前のバージョンで TLS 接続を利用しない場合
jdbc:sqlserver://servername:1433;databaseName=mtdb

# 10.2 以降のバージョンで TLS 接続を利用しない場合
jdbc:sqlserver://servername:1433;databaseName=mtdb;encrypt=false

ホスト名

データベースのホスト名またはIPアドレスを入力します。

ポート番号

データベースのポート番号を入力します。データベースを選択すると自動的にデフォルトのポート番号が設定されます。
※ポート番号を変更した場合は変更したポート番号を入力してください。

スキーマ名/サービス名/データベース名

データベースがOracleの場合にのみ入力します。

ユーザー名

作成するiPLAssのデータベースのユーザー名を入力します。

パスワード

作成するiPLAssのデータベースのパスワードを入力します。
※パスワードを表示する場合は「パスワード表示」をチェックします。ブラウザがIEの場合は「パスワード表示」のチェックボックスは表示されません。

セットアップ画面入力項目(テナント情報)

テナント名

テナント名を入力します。(半角推奨)
※テーブル自動作成のチェックを外した場合、指定のテナント名のテナントが既に存在する場合は作成されません。

管理者ユーザーID

テナントの管理者ユーザーIDを入力します。

管理者パスワード

テナントの管理者パスワードを入力します。
※パスワードを表示する場合は「パスワード表示」をチェックします。ブラウザがIEの場合は「パスワード表示」のチェックボックスは表示されません。

管理者のユーザーIDおよびパスワードについて
ユーザーIDには4文字以上の「英数字」および「-」(マイナス)「@」「_」「.」(ピリオド)のみ入力可能です。
パスワードは6文字以上の英数字のみ入力可能です。

インストール設定ファイルを指定してAPサーバを起動することにより、指定されたインストール設定ファイルに基づいてインストール画面を介さずに自動的にインストールを行います。

手順
  1. インストール設定ファイル(install.properties)を作成します。

  2. 作成したインストール設定ファイルを環境に合わせて修正します。

  3. 作成したインストール設定ファイルを%USERPROFILE%/.iplass/下に配置するか、JVMオプション-Dmtp.install=<インストール設定ファイルのパス>を指定しAPサーバを起動します。

  4. iPLAssのURLにアクセスします。

  5. 準備中画面の表示後、iPLAssのログイン画面が表示されます。

%USERPROFILE%/.iplass/下に配置する場合、インストール設定ファイルのファイル名は必ずinstall.propertiesである必要があります。 但し、mtp.installオプションで指定する場合は任意のファイル名で構いません。

Tomcatでの設定例

作成したインストール設定ファイルをmy-install.propertiesとしJVMオプションmtp.installで指定する場合

  1. %CATALINA_HOME%/binディレクトリにsetenv.batファイルを作成します。

  2. 作成したsetenv.batに次のように記述します。

    set JAVA_OPTS=%JAVA_OPTS% -Dmtp.install="<インストール設定ファイルの配置場所>/my-install.properties"
既にsetenv.batファイルが存在する場合は追記してください。
# データベース
#
# [MySQL | Oracle_EE_11g | Oracle_EE_12c | Oracle_SE_ONE | PostgreSQL | SQLServer]
#
# MySQL         : MySQL
# Oracle_EE_11g : Oracle Database 11g Enterprise Edition
# Oracle_EE_12c : Oracle Database 12c Enterprise Edition
# Oracle_SE_ONE : Oracle Database Standard Edition One
# PostgreSQL    : PostgreSQL
# SQLServer     : Microsoft SQL Server
connection.db=MySQL

# DBAユーザー名
#
# データベースのDBA権限を持つユーザーのユーザー名を設定します。
connection.dba.user=root

# DBAパスワード
#
# データベースのDBA権限を持つユーザーのパスワードを設定します。
connection.dba.password=rootpass

# バイナリデータファイル保存場所
#
# バイナリデータファイルの保存先ルートディレクトリを設定します。
# MySQL及びPostgreSQLの場合、Binary型のデータは標準でファイル形式により外部保存されます。
# Oracle及びSQLServerの場合は保存場所を設定した場合のみ外部保存されます。
# MySQL及びPostgreSQLの場合は必ず設定が必要です。
# バックスラッシュの場合はエスケープが必要です。('\'->'\\')
binaryStoreRootdir=C:\\iPLAss\\FileLobStore\\MySQL

# テーブル自動作成
#
# [true | false]
#
# テーブルを作成する場合は「true」を設定します。
# 「true」を設定した場合は既存のテーブルは再作成されます。
# 再セットアップ等で既存のデータを削除したくない場合は「false」を設定してください。
# 未設定の場合は「false」が設定されたものとします。
# ※データベースまたはテーブルが存在しない場合は必ず「true」を設定してください。
tableSetupRequired=false

# JDBC URL
#
# 未設定の場合はデータベース、ホスト名、ポート番号、名前により以下のフォーマットで生成されます。
# 独自のURLを指定する場合に設定します。
# ※Oracle以外の場合、名前(データベース名)は「mtdb」である必要があります。
#
# MySQL         : jdbc:mysql://[<Hostname>|<IP Address>]:3306/mtdb
# Oracle_EE_11g : jdbc:oracle:thin:@[<Hostname>|<IP Address>]:1521:<Service name>
# Oracle_EE_12c : jdbc:oracle:thin:@[<Hostname>|<IP Address>]:1521/<Service name>
# Oracle_SE_ONE : jdbc:oracle:thin:@[<Hostname>|<IP Address>]:1521:<Service name>
# PostgreSQL    : jdbc:postgresql://[<Hostname>|<IP Address>]:5432/mtdb
# SQLServer     : jdbc:sqlserver://[<Hostname>|<IP Address>]:1433;databaseName=mtdb
#connection.jdbc.url=jdbc:mysql://localhost:3306/mtdb

# ホスト名
#
# データベースのホスト名またはIPアドレスを設定します。
connection.jdbc.host=localhost

# ポート番号
#
# 未設定の場合はデータベースに応じて以下のポート番号が使用されます。
# 他のポート番号を使用する場合に設定します。
#
# MySQL      : 3306
# Oracle     : 1521
# PostgreSQL : 5432
# SQLServer  : 1433
#connection.jdbc.port=3306

# 名前
#
# データベースの名前(サービス名)を設定します。
# データベースがOracleの場合にのみ設定が必要です。
# Oracle以外で設定された場合は無効となります。
#connection.jdbc.name=orcl

# ユーザー名
#
# 作成するiPLAssのデータベースユーザー名を設定します。
connection.jdbc.user=mtpusr

# パスワード
#
# 作成するiPLAssのデータベースユーザーパスワードを設定します。
connection.jdbc.password=mtpusrpass

# 初期テナント名
#
# 初期作成されるテナント名を設定します。
# 指定のテナント名のテナントが既に存在する場合は作成されません。
tenant.name=myTenant

# 初期テナント管理者ID
#
# 初期作成されるテナントの管理者IDを設定します。
tenant.admin.id=admin

# 初期テナント管理者パスワード
#
# 初期作成されるテナントの管理者パスワードを設定します。
tenant.admin.password=password

カスタマイズしたservice-configファイルを指定しインストールすることで、インストール後のservice-configファイルの設定が不要になります。

通常、インストール後に%USERPROFILE%/.iplass/下に作成されるservice-configファイルiplass-service-config.xmlを編集しservice-configを設定しますが、 あらかじめ設定し用意したカスタムservice-configを指定することにより、インストール後にservice-configを設定する必要が無くなります。

なお、カスタムservice-configはインストール後に指定することも指定を止めることも可能です。

指定を止めた場合は%USERPROFILE%/.iplass/下のiplass-service-config.xmlが使用されます。

カスタムservice-configは必ず/iplass-service-config.xmlを継承して作成してください。

作成例:テナントのデフォルトのメール送信に関する設定を行う場合

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<!DOCTYPE serviceDefinition>
<serviceDefinition>
  <inherits>/iplass-service-config.xml</inherits>

  <service>
    <interface>org.iplass.mtp.impl.core.TenantContextService</interface>

    <property name="defaultMailFrom" value="sample@sample.org" />
    <property name="defaultMailFromName" value="Sample" />
  </service>

</serviceDefinition>

カスタムservice-configはJVMのシステムプロパティmtp.config.customにて指定します。

指定例:カスタムservice-configのファイル名をcustom-service-config.xmlとした場合

-Dmtp.config.custom="<カスタムservice-configファイルの配置場所>/custom-service-config.xml"

インストールの状態を問わず新しいバージョンのインストーラファイル(war)を既存のファイルに上書きしてください。

Enterprise Editionへのアップグレードの場合は、インストーラの上書きと「Enterprise Editionへのアップグレード」の「テーブルの追加」を行ってください。