4.2 アップグレードガイド...3.4.8. ライブラリのインストール . . . . . . . . . ....

4.2 アップグレードガイド

ドキュメント・リリース日: 2020 年 1 月 8 日 (第 5 版)

Copyright © 2019 SAISON INFORMATION SYSTEMS CO., LTD. All rights reserved.

目次

1. はじめに. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

1.1. 注意事項 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

1.1.1. お客様へのお願い . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

1.1.2. 商標について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

1.2. 表記について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

1.3. マークについて . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

2. 販売およびサポートの終了について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2.1. サポートプラットフォーム . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2.2. リポジトリDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2.3. アダプタ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

3. DataSpider Servista のバージョンアップ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

3.1. バージョンアップの対象バージョン . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

3.2. バージョンアップする際の注意事項 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

3.2.1. サーバとクライアントのバージョンについて . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

3.2.2. バージョン間の互換について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

3.2.3. 言語の互換について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

3.2.4. Windows - Linux 間のバージョンアップについて . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

3.2.5. バージョンごとの修正内容や仕様変更について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

3.2.6. アダプタのサポートプラットフォームについて . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

3.2.7. サーバ移行機能で移行できる機能について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

3.2.8. 移行できない設定について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

3.2.9. サポート終了プラットフォーム・リポジトリDB・アダプタについて. . . . . . . . . . . . . . . . . . . . . . 12

3.2.10. マイプロジェクトのプロジェクトダウンロード・アップロード機能について. . . . . . . . . . . . . . . . 13

3.2.11. ライセンスファイルの再発行について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

3.2.12. UNIX/Linux のフォントファイルの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

3.3. バージョンアップの流れ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

3.4. リポジトリDB 有り環境のバージョンアップ (同一リポジトリ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

3.4.1. 旧バージョンの DataSpider Servista でトリガーを無効にする . . . . . . . . . . . . . . . . . . . . . . . . . 16

3.4.2. 旧バージョンの DataSpiderServer および DataSpider Studio の停止 . . . . . . . . . . . . . . . . . . . . 16

3.4.3. 旧バージョンの DataSpider Servista のバックアップ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

3.4.4. リポジトリDB のバックアップ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

3.4.5. 旧バージョンの DataSpider Servista のアンインストール. . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

3.4.6. 新バージョンの DataSpider Servista のインストール. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

3.4.7. ライセンスファイルの適用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

3.4.8. ライブラリのインストール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

3.4.9. 各種設定および各種データの移行 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

3.4.10. その他設定の移行 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

3.4.11. バージョンアップに伴う特別な設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

3.4.12. 各種ツールのバージョンアップ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

3.4.13. バージョンアップ後の起動 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

3.5. リポジトリDB 有り環境のバージョンアップ (別リポジトリ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

3.5.1. トリガーの停止ができる場合 (平行運用を行わないケース) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

3.5.2. トリガーの停止ができない場合 (平行運用を行うケース) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

3.6. リポジトリDB 無し環境のバージョンアップ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

3.6.1. 旧バージョンの DataSpider Servista で DataSpiderServer 設定のエクスポートを行う . . . . . . . . 22

3.6.2. 旧バージョンの DataSpiderServer および DataSpider Studio の停止 . . . . . . . . . . . . . . . . . . . . 23

3.6.3. 旧バージョンの DataSpider Servista のバックアップ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

3.6.4. 旧バージョンの DataSpider Servista のアンインストール. . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

3.6.5. 新バージョンの DataSpider Servista のインストール. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

3.6.6. ライセンスファイルの適用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

3.6.7. ライブラリのインストール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

3.6.8. 各種設定および各種データの移行 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

3.6.9. その他設定の移行 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

3.6.10. バージョンアップに伴う特別な設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

3.6.11. 各種ツールのバージョンアップ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

3.6.12. バージョンアップ後の起動 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

3.6.13. 新バージョンの DataSpider Servista で DataSpiderServer設定のインポートを行う . . . . . . . . . 27

3.7. バージョンアップと同時にリポジトリDB 無しからリポジトリDB 有りに変更する場合 . . . . . . . . . . . . . . 27

3.8. バージョンアップと同時にプラットフォームの移行を行う場合 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

4. サポート終了プラットフォーム、リポジトリDB、アダプタのバージョンアップ方法 . . . . . . . . . . . . . . . . . . . 29

4.1. プラットフォームの移行 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

4.2. リポジトリDB の移行 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

4.3. アダプタの移行 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

5. バージョンアップに伴う特別な設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

5.1. アダプタの互換性プロパティ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

5.1.1. DataSpider Servista 3.0 の互換性プロパティ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

5.1.2. DataSpider Servista 2.3.0 の互換性プロパティ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

5.2. Mapper の互換性プロパティ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42




5.3. Mapper の新アーキテクチャへの変換 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

5.3.1. 既存の Mapper の新アーキテクチャへの反映方法 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

5.4. カレンダーの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

5.4.1. 基準カレンダーの変更反映方法 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

5.4.2. 定期的な休日の設定の修正反映方法. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

5.5. 日付/時間型のスクリプト変数を文字列に展開する際のフォーマット . . . . . . . . . . . . . . . . . . . . . . . . . 50

5.6. スクリプト全般 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

5.6.1. UTF-8 のバックスラッシュを設定するとコンパイルエラーが発生する問題の修正反映方法 . . . . . . . 51

5.6.2. トランザクション処理、またはグループ処理に関する問題の修正反映方法 . . . . . . . . . . . . . . . . . . 52

5.6.3. サービス実行に関する問題の修正反映方法 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

5.7. Mapper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

5.7.1. ユーザ定義ロジックに関する問題の修正反映方法 (1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

5.7.2. ユーザ定義ロジックに関する問題の修正反映方法 (2) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

5.7.3. 単純な繰り返しロジックに関する問題の修正反映方法 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

5.7.4. Mapper ロジックに半角カンマを含む環境変数を設定した場合に発生する問題の修正反映方法 . . . . 55

5.7.5. 「文字列ごとに置換」ロジックの [マッチング方法] に関する問題の対処方法. . . . . . . . . . . . . . . . 55

5.8. データベースアダプタ全般 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

5.9. Accessアダプタ、ODBCアダプタ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

5.10. Oracle 11gR2 アダプタ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

5.10.1. ライブラリ (JDBCドライバ) の変更. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

5.11. Oracle OCI アダプタ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

5.11.1. [8iに接続] プロパティ項目にチェックありグローバルリソースの移行方法 . . . . . . . . . . . . . . . . . 59

5.12. SQL Server 2014 / 2012 アダプタ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60


5.13. SAP EICS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

5.14. SAPテーブルクエリアダプタ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

5.15. Tableau アダプタ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

5.15.1. Hyper ファイル出力の設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

5.16. List Creator アダプタ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

5.16.1. ライブラリのパスの区切り文字の変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

5.17. FTP アダプタ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

5.17.1. グローバルリソースの [エンコード] の設定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

5.18. Web アダプタ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

5.18.1. 「localhost」および「127.0.0.1」に対するプロキシサーバ接続の設定 . . . . . . . . . . . . . . . . . . 64

5.19. Webサービスアダプタ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

5.19.1. NamespaceDefinitionsGenerator の設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

5.20. Amazon RDS for SQL Server 2012 アダプタ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67


5.21. Amazon Redshift アダプタ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68


5.22. Azure SQL Database アダプタ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69


5.23. ScriptRunner. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

5.23.1. scriptrunner.bat の配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

5.24. ScriptRunnerProxy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

5.24.1. dssrconnection.jar の更新 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

5.25. DataSpiderServer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

5.25.1. Windows x64 版の「lax.nl.java.option.additional」設定について . . . . . . . . . . . . . . . . . . . . . 71

5.26. スマートコンパイラ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

5.26.1. バージョンアップしたスクリプトへのPSPの適用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

5.27. JDBC Proxy Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

5.28. StraForm-Xコネクタ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

5.29. HULFT DataSpider 接続アダプタ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

5.29.1. HULFT DataSpider 接続アダプタの設定情報の移行方法 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

6. 補足事項 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

6.1. スキーマ読み込みの仕様変更について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

6.1.1. 「2.1」ツールチップが表示されるドキュメントMapper / 変数Mapper について . . . . . . . . . . . . . 77

6.2. 外部アプリケーション起動処理の仕様変更について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

7. トラブルシューティング. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

7.1. DataSpider Servista 2.1.1

以前からバージョンアップ後、検索系SQL実行処理で「ClassCastException」が発生する

79

7.2. DataSpider Servista 2.4.6 以前から DataSpider Servista 3.0

以降にバージョンアップ後、妥当性検証(XML Schema)処理でエラーが発生する

79

1. はじめに

本ドキュメントは、既存の DataSpider Servista を新しいバージョンにバージョンアップする手順を記載しています。

バージョンアップを行う場合には、必ず本ドキュメントに記載の手順に従うようにしてください。

バージョンアップではなく、新規にインストールする場合には、「DataSpider Servista インストールガイド」を参照

してください。

1.1. 注意事項

1.1.1. お客様へのお願い

• 本ソフトウェアの著作権は株式会社セゾン情報システムズまたはそのライセンサーが所有しています。

• 本ソフトウェアおよび本ドキュメントを無断で複製、転載することを禁止します。

• 本ドキュメントは万全を期して作成されていますが、万一不明な点や誤り、記載もれなど、お気づきの点がござい

ましたら弊社までご連絡ください。

• 本ソフトウェアは使用者の責任でご使用ください。ご使用の結果、万一トラブルおよび訴訟などが発生しまして

も、あらゆる直接、または間接の損害および損失につきまして、弊社は一切責任を負わないものとします。あらか

じめご了承ください。

• 本ソフトウェアの仕様や本ドキュメントに記載されている内容は、改善のため予告なしに変更されることがありま

す。

• 本ソフトウェアの使用には、ソフトウェアライセンス契約が必要で、株式会社セゾン情報システムズまたはそのラ

イセンサーの重要な業務機密と独自の情報が含まれており、日本国政府の著作権法で保護されています。株式会社

セゾン情報システムズまたはそのライセンサーのソフトウェアと本ドキュメントの無断使用は、損害賠償、刑事訴

訟の対象となります。

1.1.2. 商標について

• DataSpider、DataSpider ロゴ、DataSpider Servista、その他の関連製品名、サービス名などは、株式会社セゾ

ン情報システムズの登録商標または商標です。

• その他記載されている会社名・商品名・サービス名などは、各社の商標および登録商標です。

• 個々のページに表示・記載されたこれら商標などの複製・転用を禁止致します。


Copyright © 2019 SAISON INFORMATION SYSTEMS CO., LTD. All rights reserved. 1

1.2. 表記について

本ドキュメント内の表記は、次の規則に沿って行われています。

• DataSpider Servista の画面に表示されるメニュー名・タブ名・プロパティ項目名および値・ボタン名は [] で囲

んで太字で表します。また、それ以外の機能名や画面のタイトル、名称のないものは「」で囲んで前者と区別し

ています。

• 「$DATASPIDER_HOME」は DataSpider Servista をインストールしたディレクトリを表します。

デフォルトでは、Windows 版の場合は「C:\Program Files\DataSpiderServista」、UNIX/Linux 版の場合は

「<ユーザのホームディレクトリ>/DataSpiderServista」となります。

• x86 版とは、32bit OS を表します。

x64 版とは、64bit(Intel 64/AMD64) OS を表します。

• <と> で囲まれた名称は、可変であることを表します。

例:$DATASPIDER_HOME/server/logs/<日付ディレクトリ>

• 本ドキュメント内に表記されているウェブサイトの URL は 2018年9月現在のものです。ウェブサイトの都合な

どにより、予告なしに URL が変更になる場合があります。

• 「Studio」とは「DataSpider Studio」を、「Studio for Web」とは「DataSpider Studio for Web」を指しま

す。

• DataSpiderServer についての記述は Windows 版・UNIX/Linux 版共通になっています。

オペレーティングシステムに依存する内容 (パス区切り文字など) は適宜読み替えてご使用ください。

• 「DSS-」で始まる番号は、各問題の管理用の一意な ID となります。



1.3. マークについて

本ドキュメント内で使用しているマークについての説明は以下の通りです。

マーク説明

操作や設定に関するヒントであることを表します。

操作や設定に関する注意事項や制限事項であることを表します。

詳細な説明が別の項目に記載されていることを表します。



2. 販売およびサポートの終了について

2020年1月8日現在、以下のサポートプラットフォーム、リポジトリDB、アダプタは販売、およびサポートを終了して

います。

最新の情報については、 https://www.hulft.com/support/dss-lifecycle を参照してください。

これらを使用している場合のバージョンアップについては「サポート終了プラットフォーム、リポジトリDB、アダ

プタのバージョンアップ方法」を参照してください。

2.1. サポートプラットフォーム

OS サポート終了日

Red Hat Enterprise Linux 2.1 2009/12/29

Solaris 8 2009/12/29

Windows 2000 2010/7/31

Red Hat Enterprise Linux 3 2012/1/31

AIX 5L V5.3 2013/10/31

Windows XP 2014/5/31

Windows Server 2003 2015/7/31

Windows Server 2003 R2 2015/7/31

Windows 8 2016/8/31

Red Hat Enterprise Linux 4 2017/3/31

Windows Vista 2017/4/30

CentOS 5 2017/4/30

2.2. リポジトリDB

リポジトリDB バージョンサポート終了日

DB2

UDB V7.2 2010/7/31

UDB V8.2 2012/1/31

V9.1 2013/7/31

V9.5 2015/4/30

V9.7 2017/9/30

V10.1 2017/9/30

MySQL



https://www.hulft.com/support/dss-lifecycle

リポジトリDB バージョンサポート終了日

5.0 2012/1/31

5.1 2015/10/31

5.5 2018/12/31

Oracle

8.1.6 2010/7/31

8.1.7 2010/7/31

9.0.1 2010/7/31

9.2.0 2012/1/31

10g R1 2012/6/30

10g R2 2013/7/31

11g 2015/10/31

PostgreSQL

8.0 2010/7/31

8.1 2012/1/31

8.2 2013/7/31

8.3 2013/5/31

8.4 2014/7/31

9.0 2015/9/30

9.1 2016/10/31

9.2 2017/9/30

9.3 2018/9/30

9.4 2019/12/31

SQL Server

2000 2013/5/31

2005 2016/4/30

2008 2019/7/31

2008 R2 2019/7/31

Amazon RDS for MySQL

5.1 2016/8/31

Amazon RDS for PostgreSQL

9.3 2018/9/30



2.3. アダプタ

アダプタバージョンサポート終了日

Access

2000 2012/1/31

2002 2012/1/31

2003 2014/5/31

DB2

UDB V7.2 2009/12/29

UDB V8.2 2012/1/31

V9.1 2013/7/31

V9.5 2015/4/30

V9.7 2017/9/30

V10.1 2017/9/30

DB2 for i

5.1 2009/12/29

5.2 2010/7/31

5.3 2012/1/31

5.4 2013/10/31

6.1 2016/2/29

7.1 2018/4/30

MySQL

5.0 2012/1/31

5.1 2015/10/31

5.5 2018/12/31

Oracle

8.1.6 2010/7/31

8.1.7 2012/1/31

9.0.1 2012/1/31

9.2.0 2012/1/31

10g R1 2012/6/30

10g R2 2013/7/31

11g 2015/10/31

PostgreSQL

8.0 2012/1/31

8.1 2012/1/31

8.2 2013/7/31

8.3 2013/5/31




8.4 2014/7/31

9.0 2015/9/30

9.1 2016/10/31

9.2 2017/9/30

9.3 2018/9/30

9.4 2019/12/31

SQL Server

2000 2013/5/31

2005 2016/4/30

2008 2019/7/31

2008 R2 2019/7/31

Amazon RDS for MySQL

5.1 2016/8/31

Amazon RDS for PostgreSQL

9.3 2018/9/30

Excel

97 2009/12/29

2000 2012/1/31

XP 2012/1/31

2003 2014/5/31

2007 2017/10/31

Calc

2015/12/31

Dr.Sum EA

2.2 a 2009/12/29

2.4 2012/1/31

2.5 2013/10/31

3.0 2019/09/30

IBM Domino

5.0 2010/7/31

6.0 2012/1/31

6.5 2012/1/31

7.0 2012/1/31

8.0 2015/5/31

8.5 2018/9/30

IBM Notes

4.6 2012/1/31




5.0 2012/1/31

6.0 2012/1/31

6.5 2012/1/31

7.0 2012/1/31

8.0 2015/5/31

8.5 2018/9/30

SAP

3.1H～4.7 2016/12/31

SAP BC

4.6 2016/10/31

SAPテーブルクエリ

R/3 4.6C、4.7 2016/12/31

Universal Connect/X

5.3 2015/7/31

Active Directory

2000 2012/1/31

2003 2015/7/31

BIGLOBEクラウドホスティング

2016/3/31

Azure Service Bus トリガー

2017/5/31

StraForm-X Ver 1.5

2017/5/31

Shunsaku

2018/12/31

Xuras inicio

2018/12/31

メインフレーム

2018/12/31



3. DataSpider Servista のバージョンアップ

本項では、既存の DataSpider Servista を新しいバージョンである DataSpider Servista 4.2 へバージョンアップす

る手順を説明します。

これ以降、現在使用している DataSpider Servista を「旧バージョン」、DataSpider Servista 4.2 を「新バージ

ョン」と表します。

3.1. バージョンアップの対象バージョン

新バージョンへバージョンアップを行う場合、対象となるバージョンは以下の通りです。

• DataSpider Servista 2.1.0 ～ 3.2 SP4 (日本語版)

DataSpider Servista 2.0.2.3 以前を使用している場合は、弊社サポートセンターまで問い合わせてくださ

い。

• DataSpider Servista 3.0 SP2 (英語版)

• DataSpider Servista 4.0 以降

DataSpider Servista 4.0 以降では、インストール後に日本語と英語が選択できます。

3.2. バージョンアップする際の注意事項

3.2.1. サーバとクライアントのバージョンについて

前提として、DataSpider Servista のサーバとクライアントは同一のバージョンである必要があります。

そのため、サーバとクライアントは同時にバージョンアップしてください。

DataSpider Studio を異なるバージョンの DataSpiderServer に接続した場合、モジュールの不整合が発生し、再

インストールが必要になるため、注意してください。

3.2.2. バージョン間の互換について

DataSpider Servista では、上位バージョンへのバージョンアップのみをサポートしています。下位バージョンへの

バージョンダウンはサポートしておりません。

また、リポジトリDB も同様となります。上位バージョンで使用したリポジトリDB を、下位バージョンで使用すること



はできません。

3.2.3. 言語の互換について

旧バージョンの言語と新バージョンのサーバ言語との組み合わせにより、サポート有無が異なります。旧バージョンの

言語に合わせて、新バージョンのサーバの言語を設定してください。

新バージョンのサーバ言語

日本語英語

旧バージョンの言語日本語 ○ ✕

英語 ✕ ○

上記表において「○」はサポート対象、「×」はサポート対象外になります。

サーバの言語が上記条件を満たしている場合、クライアントの言語は日本語/英語の双方がサポート対象となりま

す。

3.2.4. Windows - Linux 間のバージョンアップについて

Windows - Linux 間でバージョンアップする際には、通常のバージョンアップとは異なる確認が必要になります。以下

に、主に注意すべき項目をまとめました。バージョンアップ前に確認してください。

項目説明

バッチファイル/

シェルファイル

環境に応じて、バッチファイル/シェルファイルの再作成が必要です。

DataSpiderServer

起動方法

Windows はサービス登録ができますが、Linux ではできません。

マウント設定 Windows と Linux

ではパスやネットワークドライブの参照方法が異なるため、再設定が必要です。

アプリケーション

ログ出力先設定

NT イベントログは Windows でのみ使用できます。Linux では Syslog

に変更してください。

外部アプリケーション

起動処理の起動コマンド

環境に依存する実行形式のファイルを指定している場合、移行先の環境に合わせたファイル

を設定します。

アダプタのサポート

プラットフォーム

アダプタによって、サポートするプラットフォームが異なる場合があります。使用している

アダプタが移行先のプラットフォームをサポートしているかを確認してください。

ファイルアダプタ

の改行コード

Windows と Linux

では改行コードが異なります。そのため、「AUTO」を指定していた場合、結果も異なります

。また、「CRLF」や「CR」などの改行コードを指定した場合、必要に応じて修正が必要で

す。

DataSpiderServer 設定の

インポート

設定名にマルチバイト文字が含まれている場合、インポート後に文字化けが発生します。移

行先でエクスポートファイルを展開後、ZIP 圧縮のうえ、インポートしてください。



3.2.5. バージョンごとの修正内容や仕様変更について

バージョンごとの修正内容や仕様変更については、バージョンごとのリリースノートに記載されています。バージョン

アップの際には必ずご一読ください。

3.2.6. アダプタのサポートプラットフォームについて

アダプタによって、サポートするプラットフォームが異なる場合があります。バージョンアップ時に DataSpider

Servista のプラットフォームの変更を行う場合には、使用しているアダプタが移行先のプラットフォームをサポートし

ているかを、DataSpider Servista ヘルプの対象アダプタの「稼働環境」ページで確認してください。

3.2.7. サーバ移行機能で移行できる機能について

サーバ移行機能で移行できる機能は以下の通りです。

設定名備考

ユーザアカウント/

グループ

ユーザアカウント/

ユーザ

サービス

グローバル

リソース

新バージョンでサポート終了になったアダプタのグローバルリソースはエクスポート対象から外し

てください。

環境変数

トリガートリガーの状態を「無効」にしてエクスポートすることを推奨します。

休日設定カレンダー

プロジェクトファイルサーバに保存されたプロジェクトが対象となります。

アプリケーションログ出力

設定

マウント設定インポートする際に以下の点を確認してください。

• マウント元・マウント先がインポート先に存在する

• マウント元が参照可能になっている

グローバルスキーマ DataSpider Servista 4.0 からの新機能です。

グローバルユーザ定義ロジ

ック

DataSpider Servista 4.1 からの新機能です。



サーバ移行は、本ドキュメントの手順でのバージョンアップ用途以外の場合、バージョン・サービスパック・単体

パッチ適用のすべてが同一の DataSpiderServer 間でのみ使用することができます。

サーバ移行機能の詳細については、DataSpider Servista ヘルプの「DataSpiderServerの設定」ページを参照し

てください。

3.2.8. 移行できない設定について

以下の設定は、バージョンアップ時に自動で移行されません。新バージョンの DataSpider Servista で新しく設定して

ください。

設定名設定場所備考

ローカル保存された

プロジェクト

バージョンアップ前に必ずサーバにコミットするようにし

てください。

検索条件マイログリポジトリDB ありの場合は移行できます。

DataSpiderログ設定

(圧縮設定・削除設定)

コントロールパネル

ScriptRunner for

Amazon SQS 設定

コントロールパネル

HTTPSの設定コントロールパネル

チーム開発機能の設定コントロールパネル

最大同時実行数コントロールパネル

FTPサーバの設定　コントロールパネル

cacerts ファイル

.keystore ファイル　

lax ファイル内の設定項目 lax ファイル

アダプタやトリガーのプロパティフ

ァイルの設定項目

アダプタやトリガーのプロパ

ティファイル

DataSpider Studio の

接続先一覧

Studioのログイン画面

DataSpider Studio の

背景色

Studioデスクトップ

デザイナのレイアウトデザイナ

バージョンアップに伴う特別な設定詳細については、「バージョンアップに伴う特別な設定」

項を参照してください。

3.2.9. サポート終了プラットフォーム・リポジトリDB・アダプタについて

サポートを終了しているサポートプラットフォーム、リポジトリDB、アダプタをご使用の場合には、DataSpider

Servista 4.2 でそのままご使用にはなれません。サポート対象となるサポートプラットフォーム、リポジトリDB、ア



ダプタに移行する必要があります。

詳細については、「サポート終了プラットフォーム、リポジトリDB、アダプタのバージョンアップ方法」を参照し

てください。

3.2.10. マイプロジェクトのプロジェクトダウンロード・アップロード機能

について

マイプロジェクトのプロジェクトダウンロード・アップロード機能は、現在使用している本体バージョンよりも一つ前

の本体バージョン (マイナーバージョンを含む) でダウンロードしたプロジェクトのアップロードのみをサポートしま

す。

たとえば、DataSpider Servista 4.2 では、DataSpider Servista 4.1 でダウンロードしたプロジェクトのみをアップ

ロードできます。

二つ以上離れたバージョン間のバージョンアップ時には、マイプロジェクトのダウンロード・アップロード機能は使用

できませんので、注意してください。

3.2.11. ライセンスファイルの再発行について

以下のいずれかに当てはまる場合は、バージョンアップする際にライセンスファイルの再発行が必要となります。

• Select で Amazon S3 アダプタを使用していて、4.2 SP2 以降でライセンスの新規発行または再発行をしていな

い場合

• Select で Excel アダプタを使用していて、4.2 以降でライセンスの新規発行または再発行をしていない場合

• Azure SQL Database アダプタを使用していて、4.1 SP4 以降でライセンスの新規発行または再発行をしていな

い場合

• Amazon Web Services アダプタを使用していて、4.1 SP1 以降でライセンスの新規発行または再発行をしてい

ない場合

• Universal Connect/X アダプタを使用していて、3.2 SP1 以降でライセンスの新規発行または再発行をしていな

い場合

• 2010年8月31日以前に発行されている開発用サーバライセンスを使用している場合

初回出荷時点のバージョンが 2.4.4 以前の場合に該当します。

ライセンス再発行の詳細については、DataSpider Servista の販売元に問い合わせてください。



3.2.12. UNIX/Linux のフォントファイルの設定

UNIX/Linux 版で、使用言語のフォントファイルが OS に入っていない場合は、使用言語のフォントファイルを

$DATASPIDER_HOME/jre/lib/fonts/fallback ディレクトリへ配置してください。



3.3. バージョンアップの流れ

DataSpider Servista をバージョンアップするときは、新バージョンの DataSpider Servista を新規にセットアップし

て、旧バージョンの DataSpider Servista から設定を移行します。

バージョンアップの主な流れは以下の通りです。

1. 旧バージョンの DataSpiderServer および DataSpider Studio を停止する

2. 旧バージョンの DataSpider Servista をバックアップする

3. 旧バージョンの DataSpider Servista をアンインストールする

4. 新バージョンの DataSpider Servista をインストールする

5. 新バージョンの DataSpider Servista にライセンスファイルを適用する

6. 新バージョンの DataSpider Servista にライブラリをインストールする

7. 新バージョンの DataSpider Servista に各種設定および各種データを移行する

8. 新バージョンの DataSpider Servista にその他設定ファイルを移行する (省略可)

9. 新バージョンの DataSpider Servista にバージョンアップに伴う特別な設定を実施する (省略可)

10. 各種ツールをバージョンアップする (省略可)

11. 新バージョンの DataSpiderServer および DataSpider Studio を起動する

バージョンアップ前に作成したプロジェクトやスクリプト、ユーザアカウントなどの各種設定情報は、バージョンアッ

プ後もそのまま使用することができます。

バージョンアップの詳細手順は、リポジトリDB 有り / 無しによって変わります。次の図にしたがって、使用している

環境にあう項目を選択してください。



A.「バージョンアップと同時にプラットフォームの移行を行う場合」を参照。

B.「リポジトリDB 有り環境のバージョンアップ (別リポジトリ)」を参照

C.「リポジトリDB 有り環境のバージョンアップ (同一リポジトリ)」を参照

D.「バージョンアップと同時にリポジトリDB 無しからリポジトリDB 有りに変更する場合」を参照

E.「リポジトリDB 無し環境のバージョンアップ」を参照

3.4. リポジトリDB 有り環境のバージョンアップ (同一リポジトリ)

リポジトリDB 有りで、旧バージョンと新バージョンの DataSpider Servista で同じリポジトリDB を使用する場合の

バージョンアップは、以下の手順で行ってください。

3.4.1. 旧バージョンの DataSpider Servista でトリガーを無効にする

旧バージョンの DataSpider Servista で、トリガーを無効にします。マイトリガーでトリガーをすべて選択し、右クリ

ックメニューの [トリガーを無効にする] から一括で無効にできます。

3.4.2. 旧バージョンの DataSpiderServer および DataSpider Studio

の停止

旧バージョンの DataSpiderServer または DataSpider Studio が起動中の場合は停止してください。



DataSpiderServer および DataSpider Studio の停止方法については、旧バージョンに同梱されている

「DataSpider Servista インストールガイド」を参照してください。

3.4.3. 旧バージョンの DataSpider Servista のバックアップ

旧バージョンの DataSpider Servista のバックアップを行います。OS のコピー機能を使用して、退避ディレクトリに

移動します。

1. 任意の場所に退避ディレクトリを作成します。

2. 旧バージョンの DataSpider Servista をインストールディレクトリごとコピーします。

3. 退避ディレクトリに貼り付けます。

3.4.4. リポジトリDB のバックアップ

リポジトリDB のバックアップを行います。

バックアップ方法は各データベースにより異なります。各データベースが推奨するバックアップ手順にしたがって

実施してください。

3.4.5. 旧バージョンの DataSpider Servista のアンインストール

旧バージョンの DataSpider Servista のアンインストールを行います。アンインストールは、旧バージョンの

DataSpider Servista に付随のアンインストーラを使用します。

アンインストールの詳細については、旧バージョンに同梱されている「DataSpider Servista インストールガイ

ド」を参照してください。

3.4.6. 新バージョンの DataSpider Servista のインストール

新バージョンインストールの際、インストールディレクトリはファイルなどが存在しないディレクトリを指定して

ください。

新バージョンの DataSpider Servista のインストールを行います。インストール時に、以下の項目は旧バージョンの

DataSpider Servista と同じ設定にしてください。



• インストール対象の選択

• クライアント環境の選択

• 管理者パスワード

• リポジトリDB の有無および設定

リポジトリDB に MySQL、MySQL on Amazon RDS または Oracle Database Cloud Service を使用する場

合は、新バージョンに同梱されている「DataSpider Servista インストールガイド」の以下の項を参照して設定し

てください。

◦ リポジトリDB に MySQL を使用する場合

▪ 「MySQL を使用する場合」の「仕様制限/注意事項」項

◦ リポジトリDB に MySQL on Amazon RDS を使用する場合

▪ 「MySQL on Amazon RDS を使用する場合」の「仕様制限/注意事項」項

◦ リポジトリDB に Oracle Database Cloud Service を使用する場合

▪ 「Oracle Database Cloud Service を使用する場合」の「仕様制限/注意事項」項

• Windows サービス登録および Windows サービス名

• DataSpiderServer 情報の設定(ホスト名 /IPアドレス、ポート番号)

• インストール先の設定

3.4.7. ライセンスファイルの適用

新バージョンの DataSpider Servista にライセンスファイルを適用します。

$DATASPIDER_HOME/server/lic 下にライセンスファイル (license.lic) を配置してください。

インストール時に「ライセンスファイルの選択」でライセンスファイルを設定している場合には必要ありません。

ライセンスファイルの再発行が必要になる場合があります。詳細については、「ライセンスファイルの再発行につ

いて」を参照してください。

3.4.8. ライブラリのインストール

新バージョンの DataSpider Servista に各種アダプタで使用するライブラリをインストールします。



詳細については、新バージョンに同梱されている「DataSpider Servista

インストールガイド」を参照してください。

3.4.9. 各種設定および各種データの移行

旧バージョンの DataSpider Servista の設定を、新バージョンの DataSpider Servista に移行します。

退避ディレクトリにある旧バージョンの DataSpider Servista から、以下のファイルの設定を新バージョンの

DataSpider Servista の同階層ディレクトリ下にある同名ファイルに設定してください。

移行対象となるファイルは「システム設定ファイル」と「ユーザデータファイル」の 2 種類が存在します。

これらのファイルの設定がデフォルトのままである場合は、本項の設定は必要ありません。

1). システム設定ファイル

DataSpider Servista のシステム側で用意しているファイルです。これらファイルの設定をデフォルトから変更してい

る場合は、その設定項目を新バージョンの DataSpider Servista の同名ファイルに追加してください。

/conf 下のシステム設定ファイルの上書きコピーは行わないでください。

ディレクトリパスファイル名説明

$DATASPIDER_HOME/server/conf

dslog.properties DataSpiderServer

のログファイルの設定が保存されています。

system.properties DataSpiderServer

のシステム関連の設定が保存されています。

$DATASPIDER_HOME/client/conf

dslog.properties DataSpiderClient


system.properties DataSpiderClient


2). ユーザデータファイル

ユーザが任意で配置したファイルです。必要に応じて、移行してください。

3.4.10. その他設定の移行

必要に応じて、以下の設定を行ってください。



• cacerts ファイル

旧バージョンの DataSpider Servista の cacerts ファイルに証明書のインポートを行っている場合は、旧バージ

ョンと同じ証明書を新バージョンの DataSpider Servista の cacerts ファイルにインポートしてください。

cacerts ファイルの上書きコピーは行わないでください。

• .keystore ファイル

旧バージョンの DataSpider Servista の .keystore ファイルに証明書のインポートを行っている場合は、旧バー

ジョンの .keystore ファイルを新バージョンの DataSpider Servista に上書きコピーしてください。

• lax ファイル内の設定項目

各種ツールの起動設定ファイル (*.lax) で、メモリ割当値 (ヒープサイズ) や標準出力の変更を行っていた場合

は、その変更値を新バージョンの DataSpider Servista の同名ファイルに反映してください。

バージョンによって設定方法が異なる場合があります。設定値の反映方法については、新バージョンの

DataSpider Servista ヘルプの「プロパティリファレンス」ページを参照してください。

lax ファイルの上書きコピーは行わないでください。

• アダプタやトリガーのプロパティファイルの設定項目

DataSpider Servista ヘルプに記載されているプロパティファイルの設定を行っている場合は、その設定値を新

バージョンの DataSpider Servista の同名ファイルに反映してください。

設定値の反映方法については、新バージョンの DataSpider Servista ヘルプを参照してください。

• 「移行できない設定について」に記載の各種設定

3.4.11. バージョンアップに伴う特別な設定

コンポーネントやリポジトリDB の接続先によっては、バージョンアップ時に特別な設定が必要となる場合がありま

す。詳細については、本ドキュメントの「バージョンアップに伴う特別な設定」項を参照してください。

3.4.12. 各種ツールのバージョンアップ

SAP EICS や SAPテーブルクエリアダプタのコンフィギュレーションツールなど、DataSpider Servista のインストー



ルディレクトリにインストールするツールのバージョンアップ (再インストール) を行います。

再インストールは、必ず新バージョンの DataSpider Servista に同梱されている新しいインストーラで行ってくださ

い。

また、JDBC Proxy Server など DataSpider Servista とはインストールディレクトリが異なるツールも、DataSpider

Servista のバージョンアップに合わせて新しいインストーラで再インストールしてください。

詳細については、本ドキュメントの「バージョンアップに伴う特別な設定」項を参照してください。

3.4.13. バージョンアップ後の起動

新バージョンの DataSpiderServer、DataSpider Studio または DataSpider Studio for Web を起動します。

DataSpiderServer、DataSpider Studio および DataSpider Studio for Web の起動処理については、新バージョ

ンに同梱されている「DataSpider Servista インストールガイド」を参照してください。設定やデータが正しく移行さ

れているかどうかを確認してください。また、サービスパックがリリースされている場合、そちらも併せて適用するこ

とを推奨します。

3.5. リポジトリDB 有り環境のバージョンアップ (別リポジトリ)

リポジトリDB 有りで、旧バージョンと新バージョンの DataSpider Servista で別のリポジトリDB を使用する場合の

バージョンアップは、以下の手順で行ってください。

3.5.1. トリガーの停止ができる場合 (平行運用を行わないケース)

1. 旧バージョンの DataSpider Servista でトリガーを無効にします。

2. 旧バージョンの DataSpiderServer および各種クライアントアプリケーションを停止します。

3. 移行先リポジトリDB に DataSpider Servista のリポジトリDB 用ユーザを作成します。

ユーザ権限は移行元リポジトリDB と同等に設定します。

各データベースで必要な権限については「DataSpider Servista インストールガイド」を参照してくださ

い。

4. DataSpider Servista が使用しているデータベースインスタンスのテーブルを、移行元リポジトリDB から移行先

リポジトリDB に移行します。

移行方法は各データベースにより異なります。各データベースが推奨する移行手順にしたがって実施してく



ださい。

移行先データベースにあらかじめテーブルを作成しておく必要がある場合は、移行先データベースを新バー

ジョンの DataSpider Servista のリポジトリDB として設定し、DataSpiderServer の起動を行ってくださ

い。リポジトリDB 用テーブルの作成は DataSpiderServer の起動時に行われます。

5. DataSpider Servista のバージョンアップを行います。

以降のバージョンアップ手順については、「リポジトリDB 有り環境のバージョンアップ (同一リポジトリ)」の「

旧バージョンの DataSpider Servista のバックアップ」項以下を参照してください。

「新バージョンの DataSpider Servista のインストール」項では、リポジトリDB の設定を移行先リポジトリDB

にしてください。

3.5.2. トリガーの停止ができない場合 (平行運用を行うケース)

トリガーの停止ができない場合 (※) は、リポジトリDB 有り環境でサーバ移行機能を使用してバージョンアップしま

す。基本的な手順は、「リポジトリDB無し環境のバージョンアップ」と同じです。

(※) 旧バージョンの DataSpider Servista と新バージョンの DataSpider Servista を複数のライセンスで平行運用す

る場合などが該当します。

「新バージョンの DataSpider Servista のインストール」項では、リポジトリDB の設定を移行先リポジトリDB

にしてください。

サーバ移行機能でエクスポートする機能以外は、アクセス権限などのメタ情報が初期化されます。

3.6. リポジトリDB 無し環境のバージョンアップ

リポジトリDB 無し環境の場合のバージョンアップは、以下の手順で行ってください。

3.6.1. 旧バージョンの DataSpider Servista で DataSpiderServer 設

定のエクスポートを行う

旧バージョンの DataSpider Servista で、サーバ移行機能を使用して DataSpiderServer設定のエクスポートを行いま

す。

「エクスポートのオプション指定」画面で、[トリガーを次の状態としてエクスポート] と [無効] にチェックを入

れ、トリガーの状態を無効にしてエクスポートしてください。



サーバ移行を実行する前には、スクリプトが実行されていないこと、ほかのユーザが DataSpiderServer を使用し

ていないことを確認してください。

エクスポートが完了するまで時間がかかる際は、エクスポート項目を絞って数回に分けてエクスポートすることで

回避できる場合があります。

3.6.2. 旧バージョンの DataSpiderServer および DataSpider Studio

の停止

旧バージョンの DataSpiderServer または DataSpider Studio が起動中の場合は停止してください。

DataSpiderServer および DataSpider Studio の停止方法については、旧バージョンに同梱されている

「DataSpider Servista インストールガイド」を参照してください。

3.6.3. 旧バージョンの DataSpider Servista のバックアップ

旧バージョンの DataSpider Servista のバックアップを行います。OS のコピー機能を使用して、退避ディレクトリに

移動します。

1. 任意の場所に退避ディレクトリを作成します。

2. 旧バージョンの DataSpider Servista をインストールディレクトリごとコピーします。

3. 退避ディレクトリに貼り付けます。

3.6.4. 旧バージョンの DataSpider Servista のアンインストール

旧バージョンの DataSpider Servista のアンインストールを行います。アンインストールは、旧バージョンの

DataSpider Servista に付随のアンインストーラを使用します。

アンインストールの詳細については、旧バージョンに同梱されている「DataSpider Servista インストールガイ

ド」を参照してください。

3.6.5. 新バージョンの DataSpider Servista のインストール

新バージョンインストールの際、インストールディレクトリはファイルなどが存在しないディレクトリを指定して

ください。

新バージョンの DataSpider Servista のインストールを行います。インストール時に、以下の項目は旧バージョンの



DataSpider Servista と同じ設定にしてください。

• インストール対象の選択

• クライアント環境の選択

• 管理者パスワード

• リポジトリDB の有無

• Windows サービス登録および、Windows サービス名

• DataSpiderServer 情報の設定 (ホスト名 /IPアドレス、ポート番号)

• インストール先の設定

3.6.6. ライセンスファイルの適用

新バージョンの DataSpider Servista にライセンスファイルを適用します。 $DATASPIDER_HOME/server/lic 下にラ

イセンスファイル (license.lic) を配置してください。

インストール時に「ライセンスファイルの選択」でライセンスファイルを設定している場合には必要ありません。

ライセンスファイルの再発行が必要になる場合があります。詳細については、「ライセンスファイルの再発行につ

いて」を参照してください。

3.6.7. ライブラリのインストール

新バージョンの DataSpider Servista に各種アダプタで使用するライブラリをインストールします。

詳細については、新バージョンに同梱されている「DataSpider Servista インストールガイド」を参照してくださ

い。

3.6.8. 各種設定および各種データの移行

旧バージョンの DataSpider Servista の設定を、新バージョンの DataSpider Servista に移行します。

退避ディレクトリにある旧バージョンの DataSpider Servista から、以下のファイルの設定を新バージョンの

DataSpider Servista の同階層ディレクトリ下にある同名ファイルに設定してください。

移行対象となるファイルは「システム設定ファイル」と「ユーザデータファイル」の 2 種類が存在します。



これらのファイルの設定がデフォルトのままである場合は、本項の設定は必要ありません。

1). システム設定ファイル (/conf)

DataSpider Servista システム側で用意しているファイルです。これらファイルの設定をデフォルトから変更している

場合は、その設定項目を新バージョンの DataSpider Servista の同名ファイルに追加してください。

/conf 下のシステム設定ファイルの上書きコピーは行わないでください。

ディレクトリパスファイル名説明

$DATASPIDER_HOME/server/conf

dslog.properties DataSpiderServer


system.properties DataSpiderServer


$DATASPIDER_HOME/client/conf

dslog.properties DataSpiderClient


system.properties DataSpiderClient


2). ユーザデータファイル

ユーザが任意で配置したファイルです。必要に応じて、移行してください。

3.6.9. その他設定の移行

必要に応じて、以下の設定を行ってください。

• cacerts ファイル

旧バージョンの DataSpider Servista の cacerts ファイルに証明書のインポートを行っている場合は、旧バージ

ョンと同じ証明書を新バージョンの DataSpider Servista の cacerts ファイルにインポートしてください。

cacerts ファイルの上書きコピーは行わないでください。

• .keystore ファイル

旧バージョンの DataSpider Servista の .keystore ファイルに証明書のインポートを行っている場合は、旧バー

ジョンの .keystore ファイルを新バージョンの DataSpider Servista に上書きコピーしてください。



• lax ファイル内の設定項目

各種ツールの起動設定ファイル (*.lax) で、メモリ割当値 (ヒープサイズ) や標準出力の変更を行っていた場合

は、その変更値を新バージョンの DataSpider Servista の同名ファイルに反映してください。

バージョンによって設定方法が異なる場合があります。設定値の反映方法については、新バージョンの

DataSpider Servista ヘルプの「プロパティリファレンス」ページを参照してください。

lax ファイルの上書きコピーは行わないでください。

• アダプタやトリガーのプロパティファイルの設定項目

DataSpider Servista ヘルプに記載されているプロパティファイルの設定を行っている場合は、その設定値を新

バージョンの DataSpider Servista の同名ファイルに反映してください。

設定値の反映方法については、新バージョンの DataSpider Servista ヘルプを参照してください。

• 「移行できない設定について」に記載の各種設定

3.6.10. バージョンアップに伴う特別な設定

コンポーネントやリポジトリDB の接続先によっては、バージョンアップ時に特別な設定が必要となる場合がありま

す。詳細については、本ドキュメントの「バージョンアップに伴う特別な設定」項を参照してください。

3.6.11. 各種ツールのバージョンアップ

SAP EICS や SAPテーブルクエリアダプタのコンフィギュレーションツールなど、DataSpider Servista のインストー

ルディレクトリにインストールするツールのバージョンアップ (再インストール) を行います。

再インストールは、必ず新バージョンの DataSpider Servista に同梱されている新しいインストーラで行ってくださ

い。

また、JDBC Proxy Server など DataSpider Servista とはインストールディレクトリが異なるツールも、DataSpider

Servista のバージョンアップに合わせて新しいインストーラで再インストールしてください。

詳細については、本ドキュメントの「バージョンアップに伴う特別な設定」項を参照してください。



3.6.12. バージョンアップ後の起動

新バージョンの DataSpiderServer、DataSpider Studio または DataSpider Studio for Web を起動します。

DataSpiderServer、DataSpider Studio および DataSpider Studio for Web の起動処理については、新バージョ

ンに同梱されている「DataSpider Servista インストールガイド」を参照してください。設定やデータが正しく移行さ

れているかどうかを確認してください。また、サービスパックがリリースされている場合、そちらも併せて適用するこ

とを推奨します。

3.6.13. 新バージョンの DataSpider Servista で DataSpiderServer設

定のインポートを行う

新バージョンの DataSpider Servista で、サーバ移行機能を使用して DataSpiderServer設定のインポートを行いま

す。

インポート後は必ず DataSpiderServer の再起動を行ってください。

再起動後、設定やデータが正しく移行されているかどうかを確認してください。また、サービスパックがリリースされ

ている場合、そちらも併せて適用することを推奨します。

3.7. バージョンアップと同時にリポジトリDB 無しからリポジトリDB

有りに変更する場合

DataSpider Servista のバージョンアップと、リポジトリDB 無しからリポジトリDB 有りへの変更を同時に行う場合の

手順は、基本的に「リポジトリDB無し環境のバージョンアップ」の手順と同じです。

「新バージョンの DataSpider Servista のインストール」項では、リポジトリDB を「有り」で設定してインストール

するようにしてください。

リポジトリDB 有りの環境をリポジトリDB 無しの環境に移行することはできません。

3.8. バージョンアップと同時にプラットフォームの移行を行う場合

DataSpider Servista のバージョンアップと、プラットフォームの変更を同時に行う場合の特別な手順はありません。

詳細手順はリポジトリDB 有り / 無しによって変わるため環境に応じてバージョンアップを実施してください。

リポジトリDB 有りの場合の手順については、「リポジトリDB 有り環境のバージョンアップ (同一リポジトリ)」



または「リポジトリDB 有り環境のバージョンアップ (別リポジトリ)」を、リポジトリDB

無しの場合の手順については、「リポジトリDB無し環境のバージョンアップ」を参照してください。

移行先に、マウント設定のマウント元を用意するようにしてください。移行元とパスが異なる場合は、マウントポ

イントを再作成する必要があります。

Windows - Linux 間の移行に関する注意事項については、「Windows - Linux 間のバージョンアップについ

て」を参照してください。

アダプタによって、サポートするプラットフォームが異なる場合があります。詳細については、「アダプタのサ

ポートプラットフォームについて」を参照してください。



4. サポート終了プラットフォーム、リポジトリDB、アダ

プタのバージョンアップ方法

以下のウェブサイトにて、サポート終了となったサポートプラットフォーム、リポジトリDB、アダプタを公開していま

す。

• https://www.hulft.com/support/dss-lifecycle

サポートを終了しているこれらのサポートプラットフォーム、リポジトリDB、アダプタを使用している場合に

は、DataSpider Servista 4.2 でそのまま使用できません。サポート対象となるサポートプラットフォーム、リポジト

リDB、アダプタに移行する必要があります。次項にて、移行方法を説明します。

4.1. プラットフォームの移行

プラットフォームの移行の手順は、「バージョンアップと同時にプラットフォームの移行を行う場合」を参照してくだ

さい。

4.2. リポジトリDB の移行

リポジトリDB の移行の手順については、「リポジトリDB 有り環境のバージョンアップ (別リポジトリ)」を参照して

ください。

4.3. アダプタの移行

アダプタの移行は、スクリプトの変更を行わず、グローバルリソースの変更のみで行うことができます。移行の手順は

以下の通りです。

(ここでは、現在ご使用中の DataSpider Servista を「旧バージョンの DataSpider Servista」、DataSpider Servista

4.2 を「新バージョンの DataSpider Servista」、サポート終了になった接続先アプリケーションを「サポート終了接

続先」、サポート対象の接続先アプリケーションを「サポート内接続先」と表します。)

1. サポート終了接続先をサポート内接続先にアップグレード、もしくは新規に構築します。

2. DataSpider Servista のバージョンアップを行います。

◦ リポジトリDB 有り環境のバージョンアップ(同一リポジトリ)の場合



https://www.hulft.com/support/dss-lifecycle

▪ バージョンアップの手順については、「リポジトリDB 有り環境のバージョンアップ (同一リポジ

トリ)」を参照してください。

▪ 旧バージョンの DataSpider Servista をアンインストールする前に、「グローバルリソースの設

定」でサポート終了接続先のグローバルリソースを削除します。また、削除する際には、サポート終了

接続先のグローバルリソース名を控えておいてください。

◦ リポジトリDB 有り環境のバージョンアップ (別リポジトリ) の場合

▪ バージョンアップの手順については、「リポジトリDB 有り環境のバージョンアップ (別リポジト

リ)」を参照してください。

▪ 旧バージョンの DataSpider Servista をアンインストールする前に、サポート終了接続先のグ

ローバルリソース名を控えておいてください。

◦ リポジトリDB 無し環境のバージョンアップの場合

▪ バージョンアップの手順については、「リポジトリDB無し環境のバージョンアップ」を参照して

ください。

▪ 旧バージョンの DataSpider Servista で DataSpiderServer設定のエクスポートをする際に、サ

ポート終了接続先のグローバルリソースはエクスポート対象外としてください。また、サポート終了接

続先のグローバルリソース名を控えておいてください。

3. サポート内接続先の接続情報を確認します。

◦ 例: Oracle 10g アダプタから Oracle 12c アダプタに移行する場合は、Oracle 12c の「ホスト名」「ポー

ト番号」「SID」「ユーザ名」「パスワード」を確認します。

◦ 各データソースの接続に必要な情報の詳細については、DataSpider Servista ヘルプの｢グローバルリ

ソースのプロパティ｣ページを参照してください。

4. サポート内接続先用のアダプタが使用できる状態になっているかどうか確認します。

◦ 例: サポート内接続先としてOracle 12cを使う場合

▪ コントロールパネルの [グローバルリソースの設定]-[新しいグローバルリソースの追加]-[リソースの

種類の選択] で、Oracle 12c アダプタのリソースアイコンが表示されているかどうかを確認します。

一覧に現れない場合は、Oracle 12c アダプタのライブラリが配置されているかどうかを確認してくだ

さい。

◦ ライブラリの配置方法については、「DataSpider Servista インストールガイド」または DataSpider

Servista ヘルプの「ライブラリのインストール」ページを参照してください。



◦ ライブラリを配置した場合は必ず DataSpiderServer を再起動してください。

5. サポート内接続先のグローバルリソースを作成します。グローバルリソース名は 2. で控えておいた名前にしてく

ださい。

◦ 各コンポーネントでは、接続先に設定されたグローバルリソースの接続情報の取得を「グローバルリ

ソース名」で行います。そのため、サポート内接続先のグローバルリソースをサポート終了接続先のグロー

バルリソースの元の名前と同じにすることにより、スクリプトの変更をせずに、移行を行うことができま

す。

6. テストを実施します。

◦ 既存のスクリプトが正常に動作することを確認してください。



5. バージョンアップに伴う特別な設定

バージョンアップ元となる DataSpider Servista のバージョンによっては、バージョンアップ後に特別な設定が必要と

なる場合があります。それらの設定は必要に応じて、新バージョンの DataSpider Servista に行ってください。

5.1. アダプタの互換性プロパティ

DataSpider Servista では、仕様の変更や不具合の修正などにより、以前のバージョンと動作の互換性が取れなくなる

場合があります。その場合に、特定のプロパティを設定することにより、以前のバージョンの動作に戻し、互換性を保

つようにすることができます。そのようなプロパティ設定を「互換性プロパティ」と呼びます。

各互換性プロパティの「設定が必要なアップグレード元のバージョン」に記載のバージョンからバージョンアップを行

う場合、仕様が変更され、動作が変わります。修正前の動作を保つ必要がある場合には、互換性プロパティを設定する

ようにしてください。

旧バージョンの DataSpider Servista に互換性プロパティを設定している場合には、バージョンアップ後に新

バージョンの DataSpider Servista に新しく設定を行う必要があります。

互換性プロパティを追加した際には DataSpiderServer の再起動が必要になります。

5.1.1. DataSpider Servista 3.0 の互換性プロパティ

本項では、DataSpider Servista 3.0 から追加された互換性プロパティについて説明します。

• 設定が必要なアップグレード元のバージョン

◦ DataSpider Servista 2.4.x 以前

1).Excel アダプタ

empty.date.cell.not.null

本プロパティは、Excel 2007ブック (.xlsxファイル) に対しては適用されません。

• 修正内容

シートから読み取り処理、および定義済み範囲から読み取り処理で、値が空のセルを [列一覧] の [型] で「日

付」を指定して読み取った場合、「1970-01-01」として取得される問題を修正しました。

修正後は、「null」として取得されます。



以前の動作に変更したい場合には、以下の対象ファイルに互換性プロパティを設定してください。

• 対象ファイル

◦ component.properties

• 配置場所

◦ $DATASPIDER_HOME/server/plugin/data_processing/modules/excel_adapter/META_INF

• キー

◦ empty.date.cell.not.null

• 値の説明

◦ true: 日付型のセルが空の場合「1970-01-01」で読み取ります。(2.1.1 以前、2.3.0 以降~2.4.x以前の動

作)

◦ false: 日付型のセルが空の場合「null」で読み取ります。(2.2.0 以降 ~2.2.1.1 以前、3.0 以降の動作)

• デフォルト値

◦ false

2). 可変長アダプタ

emptyfield.typecheck.enabled

• 修正内容

可変長ファイル読み取り処理で、数値型・日付型フィールドから読み取ったデータが空文字の場合、エラーになる

問題を修正しました。



◦ adapter.properties

• 配置場所

◦ $DATASPIDER_HOME/server/plugin/data_processing/modules/variablelength_adapter/META-INF

• キー



◦ emptyfield.typecheck.enabled

• 値の説明

◦ true: 数値型・日付型フィールドで、読み取ったデータが空文字の場合、エラーとなります。(2.4.x 以前の

動作)

◦ false: 数値型・日付型フィールドで、読み取ったデータが空文字の場合にもエラーとなりません。(3.0 以降

の動作)


◦ false

3). Active Directory アダプタ

disable.accountexpires.adjustment

• 修正内容

◦ ユーザ検索処理およびユーザメンバ検索処理で、取得するアカウント有効期限の日付と Active Directory 上

で表示されている日付に 1 日の差異がある問題を修正しました。

◦ 1 件ユーザ登録処理および複数ユーザ登録/更新処理で、入力するアカウント有効期限の日付と Active

Directory 上で表示されている日付に 1 日の差異がある問題を修正しました。




• 配置場所

◦ $DATASPIDER_HOME/server/plugin/data_processing/modules/activedirectory_adapter/META-INF/

• キー

◦ disable.accountexpires.adjustment

• 値の説明

◦ true: アカウント有効期限の日付はアカウントが無効となる最初の日付となります。(2.4.x 以前の動作)

◦ false: アカウント有効期限の日付はアカウントが有効である最後の日付となります。(3.0 以降の動作)




◦ false

enable.emptyusernames.validation

• 修正内容

◦ 1 件ユーザ登録処理および複数ユーザ登録/更新処理で、[姓]、[名] および [表示名] の設定を省略できるよ

うにしました。

◦ 以下のオペレーションで、[姓]、[名] および [表示名] のいずれかが設定されていないアカウントも操作の

対象とできるよう変更しました。

▪ 複数ユーザ登録/更新処理

▪ ユーザ削除処理

▪ アカウント有効/無効処理

▪ ユーザ移動処理




• 配置場所

◦ $DATASPIDER_HOME/server/plugin/data_processing/modules/activedirectory_adapter/META-INF

• キー

◦ enable.emptyusernames.validation

• 値の説明

◦ true: 以下の動作となります。(2.4 以前の動作)

▪ 1件ユーザ登録処理で、[姓]、[名]、[表示名] すべての入力が必須となります。

▪ 複数ユーザ登録/更新処理で、[姓]、[名]、[表示名] すべての入力が必須となります。

▪ 複数ユーザ登録/更新処理、アカウント有効/無効処理、ユーザ移動処理、ユーザ削除処理で、[姓]、

[名]、[表示名] のいずれかが未設定のアカウントは処理対象となりません。



◦ false: 以下の動作となります。(3.0 以降の動作)

▪ 1件ユーザ登録処理で、[姓]、[名]、[表示名] いずれかの入力が必須となります。

▪ 複数ユーザ登録/更新処理で、[エントリ名]、[姓]、[名]、[表示名] いずれかの入力が必須となりま

す。

▪ 複数ユーザ登録/更新処理、アカウント有効/無効処理、ユーザ移動処理、およびユーザ削除処理で、

[姓]、[名]、[表示名] が未設定のアカウントも処理対象となります。


◦ false

5.1.2. DataSpider Servista 2.3.0 の互換性プロパティ

本項では、DataSpider Servista 2.3.0 から追加された互換性プロパティについて説明します。


◦ DataSpider Servista 2.2.1.1 以前

1). Excel アダプタ

get.sheet.end.condition.compat2211

• 修正内容

シートから読み取り処理で、[開始/終了条件] タブの [読み取り終了条件を指定] オプションを有効にして終了条

件を設定する際に、すべてのカラムに AND 演算子で条件を指定した場合、条件ごとに判定し、最後に条件を満た

した行を読み取り終了条件とする問題を修正しました。修正後は、すべての条件を満たす行を読み取り終了条件と

します。


( 本プロパティは、Excel 2007 ブック (.xlsxファイル) に対しては適用されません。)


◦ component.properties

• 配置場所



◦ $DATASPIDER_HOME/server/plugin/data_processing/modules/excel_adapter/META_INF

• キー

◦ get.sheet.end.condition.compat2211

• 値の説明

◦ true: 条件ごとに判定し、最後に条件を満たした行を読み取り終了条件とします。(2.2.1.1 以前の動作)

◦ false: すべての条件を満たす行を読み取り終了条件とします。(2.3.0 以降の動作)


◦ false

2). ファイルシステムアダプタ

disable.check.target.directory

• 修正内容

ファイルシステム書き込み処理の動作を以下のように変更しました。


▪ 入力データの path(2番目のカラムのデータ) が絶対パスの場合:

入力データの path に書き込み処理を行います。プロパティの [ディレクトリ] で指定したパスは参照

しません。

▪ 入力データの path が相対パスの場合:

ファイルチューザやディレクトリチューザ、エクスプローラなどで最後に選択したディレクトリをカレ

ントディレクトリとし書き込み処理を行います。プロパティの [ディレクトリ] で指定したパスは参照

しません。

◦ DataSpider Servista 2.3.0 以降

▪ 入力データの path が絶対パスの場合:

入力データの path に書き込み処理を行います。プロパティの [ディレクトリ] で指定したパスは参照

しません。

▪ 入力データの path が相対パスの場合:

プロパティの [ディレクトリ] で指定したパスをカレントディレクトリとして書き込み処理を行いま

す。



上記のように 2.2.1.1 以前では、[ディレクトリ]

で指定したパスは参照していなかったため、相対パスの指定ができました。しかし、2.3.0 以降では、入力データ

の path が相対パスで、プロパティの [ディレクトリ] で相対パスを指定した場合、エラーが発生するようになり

ます。(絶対パスのみ指定可)




• 配置場所

◦ $DATASPIDER_HOME/server/plugin/data_processing/modules/filesystem_adapter/META-INF

• キー

◦ disable.check.target.directory

• 値の説明

◦ true: 相対パスを許容し、例外が発生しません。(2.2.1.1 以前の動作)

◦ false: 相対パスを許容せず、例外が発生します。(2.3.0 以降の動作)


◦ false

3). IBM Notes アダプタ

disable.column.type

• 修正内容

ビュー読み取り処理、ノーツ式読み取り処理および全文検索読み取り処理で、プロパティの [カラム定義] で指定

された [型] にデータを型変換して読み取る機能を追加しました。



◦ lotusnotescommon.properties



• 配置場所

◦ $DATASPIDER_HOME/server/plugin/data_processing/share/classes

• キー

◦ disable.column.type

• 値の説明

◦ true: 型変換を行いません。(2.2.1.1 以前の動作)

◦ false: 型変換を行います。(2.3.0 以降の動作)


◦ false

notes.dateformat.compat.enabled

• 修正内容

ビュー読み取り処理で、カラムに「@Created」「@Modified」「@Accessed」が指定されているビューを指定

して実行した際に取得される日付データのフォーマットを、「EEE MMM dd hh:mm:ss z yyyy」から「yyyy-

MM-dd’T’HH:mm:ss.SSSZZ」に変更しました。




• 配置場所


• キー

◦ notes.dateformat.compat.enabled

• 値の説明

◦ true: 「EEE MMM dd hh:mm:ss z yyyy」フォーマットで値を取得します。(2.2.1.1 以前の動作)

◦ false: 「yyyy-MM-dd’T’HH:mm:ss.SSSZZ」フォーマットで値を取得します。(2.3.0 以降の動作)




◦ false

error.searchfulltext.nomatch

• 修正内容

全文検索読み取り処理で、指定した [検索文字列] の検索結果が 0 件であった場合にエラーが発生する問題を修正

しました。修正後は処理が正常終了するようになります。(結果は「0」件)




• 配置場所


• キー

◦ error.searchfulltext.nomatch

• 値の説明

◦ true: 検索文字列にマッチしない場合、エラーになります。(2.2.1.1 以前の動作)

◦ false: 検索文字列にマッチしなくてもエラーにはなりません。(2.3.0 以降の動作)


◦ false

4). FTP アダプタ

disable.support.schema

• 修正内容

各オペレーションを Mapper の入力元とした際に、Mapper の入力元スキーマにスキーマが自動で表示されるよ

うになりました。また、スキーマの編集も「不可」となります。






• 配置場所

◦ $DATASPIDER_HOME/server/plugin/data_processing/modules/ftp_adapter/META-INF

• キー

◦ disable.support.schema

• 値の説明

◦ true: Mapper でスキーマを手動でセットする必要があります。編集できます。(2.2.1.1 以前の動作)

◦ false: Mapper でスキーマが自動でセットされます。編集はできません。(2.3.0 以降の動作)


◦ false

disable.timeout.by.resource

• 修正内容

FTP サーバへのコネクションをプールできるようにしました。以前の動作に変更したい場合には、以下の対象フ

ァイルに互換性プロパティを設定してください。



• 配置場所

◦ $DATASPIDER_HOME/server/plugin/data_processing/modules/ftp_adapter/META-INF

• キー

◦ disable.timeout.by.resource

• 値の説明

◦ true: FTP アダプタの処理ごとに FTPClient のインスタンスを生成します。また、タイムアウト設定は各オ

ペレーションのプロパティで行います。(2.2.1.1 以前の動作)

◦ false: FTP アダプタの 1 番目の処理で FTPClient のインスタンスが生成されログインを行い、以降の処理

ではログインセッションを使い回します。スクリプト終了時 (グローバルリソースのクリーンアップ) にセ

ッションは破棄 (ログアウト) されます。また、タイムアウト設定はグローバルリソースのプロパティで行

います。(2.3.0 以降の動作)




◦ false

5.2. Mapper の互換性プロパティ

DataSpider Servista では、仕様の変更や不具合の修正などにより、以前のバージョンと動作の互換性が取れなくなる

場合があります。その場合に、特定のプロパティを設定することにより、以前のバージョンの動作に戻し、互換性を保

つようにすることができます。そのようなプロパティを「互換性プロパティ」と呼びます。

各互換性プロパティの「設定が必要なアップグレード元のバージョン」に記載のバージョンからバージョンアップを行

う場合、仕様が変更され、動作が変わります。修正前の動作を保つ必要がある場合には、互換性プロパティを設定する

ようにしてください。

旧バージョンの DataSpider Servista に互換性プロパティを設定している場合には、バージョンアップ後に新

バージョンの DataSpider Servista に新しく設定を行う必要があります。

互換性プロパティを追加した際には DataSpiderServer の再起動が必要になります。





1). Mapper 共通

vp.logic.numeric.default.type.int

• 修正内容

数値データを特定の Mapper ロジックで扱う際の内部データ型を BigDecimal 型固定に変更しました。



◦ system.properties



• 配置場所

◦ $DATASPIDER_HOME/server/conf

• キー

◦ vp.logic.numeric.default.type.int

• 値の説明

◦ true: 入力データのより高い精度の内部データ型を使用します。入力データが文字列型の場合は、int 型を使

用します。(2.3.x 以前の動作)

◦ false: 内部データ型の BigDecimal 型を使用します。(2.4.0 以降の動作)


◦ false

• プロパティの詳細

本プロパティを設定すると、入力データのより高い精度の内部データ型が使用されます。

内部データ型範囲

byte 8 ビット整数

short 16 ビット整数

int 32 ビット整数

float 32 ビット浮動小数点数

double 64 ビット浮動小数点数

BigDecimal 実数

byte 型がもっとも精度が低く、BigDecimal 型がもっとも精度が高くなります。たとえば、int 型と BigDecimal

型の演算では BigDecimal型を使用します。

◦ 入力データが文字列型の場合、内部データ型は int 型を使用します。内部データ型が int 型の動作は、以下

の通りです。

▪ 小数点以下が切り捨てられる

▪ 内部データ型の int 型の範囲外の数値が int 型の範囲内に丸められ、データの精度が落ちる

( int 型の範囲は「2147483647」から「-2147483648」となります。)

( 通常 (本プロパティ無効) 時は BigDecimal を使用するため、小数点の切り捨てや、データの精度が落

ちることはありません。)



◦ 本プロパティが影響する Mapper ロジックは、以下の通りです。

▪ [分岐]

条件判定による出力の切り替え

▪ [条件]-[数値]

等しい、等しくない、未満、以下、より大きい、以上

▪ [数値]-[演算]

足し算、引き算、掛け算、割り算、余り

▪ [数値]-[集合]

合計値、平均値、ノードの最大値、ノードの最小値

◦ 本プロパティ有効 / 無効時の動作例は以下の通りです。

▪ 条件判定による出力の切り替えロジック

[判定対象] が数値型のスクリプト変数「1」、[判定方法] が [指定した値との比較]、[判定基準] が

[~以上]、[判定内容] が「1.5」の場合の動作は以下になります。

▪ プロパティ有効時:「成立」

▪ プロパティ無効時:「不成立」

▪ 等しいロジック

文字列型「1.5」と文字列型「1.4」を比較した結果データは以下になります。

▪ プロパティ有効時:「true」

▪ プロパティ無効時:「false」

▪ 足し算ロジック

文字列型「1.5」と文字列型「1.5」を足し算した結果データは以下になります。

▪ プロパティ有効時:「2」

▪ プロパティ無効時:「3.0」

▪ 割り算ロジック

文字列型「10.5」と文字列型「3」を割り算した結果データは以下になります。





▪ 合計値ロジック

文字列型「3.3」、文字列型「3.4」、文字列型「3.3」を合計した結果データは以下になります。



内部データ型が int 型の場合、小数点以下が切り捨てられるため、上記のような動作になります。

2). ドキュメントMapper

mapper.xml2table.disableNullOutput

• 修正内容

入力元コンポーネントのデータモデルが XML 型かつ出力先コンポーネントがテーブルモデル型の場合に、文字列

型の出力先データに null 値をマッピングすると、null 値として出力されるようにしました。




• 配置場所


• キー

◦ mapper.xml2table.disableNullOutput

• 値の説明

◦ true: 空文字を出力します。(2.3.x 以前の動作)

◦ false: null 値を出力します。(2.4.0 以降の動作)

• デフォルト

◦ false






◦ DataSpider Servista 2.1.1 以前

1). マージ Mapper

merge.generate.empty.data

• 修正内容

マージ Mapper で、テーブルデータ型のデータをマージする際に、キーにマッチしなかった場合に空白行が出力

される問題を修正しました。




• 配置場所


• キー

◦ merge.generate.empty.data

• 値の説明

◦ true: キーにマッチしなかった場合には空白行を出力します。(2.1.1 以前の動作)

◦ false: キーにマッチしなかった場合には空白行を出力しません。(2.2.0 以降の動作)

• デフォルト

◦ false







1).マージ Mapper

merge.trim.result

• 修正内容

マージ Mapper で、結果文字列の前後のホワイトスペースのトリム (削除) の有効・無効を設定できる機能を追加

しました。




• 配置場所


• キー

◦ merge.trim.result

• 値の説明

◦ true: トリムを行います。(2.1.0 以前の動作)

◦ false: トリムを行いません。(2.1.1 以降の動作)

• デフォルト

◦ false

5.3. Mapper の新アーキテクチャへの変換

本項の手順は「設定が必要なアップグレード元のバージョン」からのバージョンアップ時に実施済みであれば、再

度行う必要はありません。



• 概要

DataSpider Servista 2.2.0 よりドキュメントMapper・変数Mapper の内部アーキテクチャが新しくなりまし

た。



マッピングファイルのサイズを縮小し、開いていないマッピングをメモリ上に展開しないように変更しました。

これにより、従来よりもプロジェクトのロード時間が短縮され、Mapperのメモリ使用量が縮小されます。

5.3.1. 既存の Mapper の新アーキテクチャへの反映方法

新アーキテクチャを DataSpider Servista 2.1.1 以前で作成された Mapper に反映させるためには、DataSpider

Servista 2.1.1 以前で作成されたプロジェクトを DataSpider Servista 2.2.0 以降で開き、保存後プロジェクトを

閉じ、再度開いてください。初回読み込み時にマッピングファイルの新アーキテクチャへの変換が行われ、プロジェク

トを閉じて開いたあとに有効になります。

5.4. カレンダーの設定



本項の手順で変更したカレンダーが、インターバルを選択したスケジュールトリガーの [使用する休日設定] に指

定されている場合、トリガーに反映されないことがあります。この場合は、以下の手順で再登録してください。

1. 対象のトリガーのプロパティ設定ダイアログを開く。

2. [完了] ボタンを押下。

5.4.1. 基準カレンダーの変更反映方法


◦ DataSpider Servista 4.0 以前

• 修正内容

◦ 休日設定で、[基準カレンダー] に 2030年までのカレンダー「2006-2030 日本カレンダー (土日・祝日あ

り)」を追加しました。

◦ 休日設定で、[基準カレンダー] の「2006-2020 日本カレンダー (土日・祝日あり)」に山の日 (8月11日)

を追加しました。

◦ 休日設定で、[基準カレンダー] の「2006-2020 日本カレンダー (土日・祝日あり)」に 2019年9月23日

(秋分の日) が祝日として設定されていない問題を修正しました。



既存のカレンダーで、[基準カレンダー] に「2006-2010 日本カレンダー (土日・祝日あり)」または「2006-2020

日本カレンダー (土日・祝日あり)」を指定している場合、本修正を適用させるには、既存のカレンダーの設定画面を開

き、[基準カレンダー]で「土日・祝日なし」を選択後、「2006-2030 日本カレンダー (土日・祝日あり)」を選択して

[了解]ボタンを押下してください。

また、既存のカレンダーで、[基準カレンダー] に「2006-2010 日本カレンダー (土日・祝日あり)」または「2006-

2020 日本カレンダー (土日・祝日あり)」を指定し、かつ土日・祝日を平日に設定している場合、上記手順で本修正を

反映させると設定が外れます。再度設定し直してください。

5.4.2. 定期的な休日の設定の修正反映方法



• 修正内容

◦ カレンダー設定の [定期的な休日の設定] で、以下の設定を行っていた場合、12月第5週に <任意の曜日>

が存在しないと、翌年1月第1週の <任意の曜日> が休日となり、翌年1月第5週の <任意の曜日> が休日に

ならない問題を修正しました。

事象が発生する設定

▪ パターンの設定

▪ 「月」

▪ 「曜日」「1」か月ごとの「第5」「<任意の曜日>」

▪ 期間

▪ 年をまたぐ設定

作成済みのカレンダー設定に本修正を反映させるためには、バージョンアップ後、対象のカレンダー設定の設定ダ

イアログを開き、[OK] ボタンを押下してください。

ただし、事象が発生して休日になった翌年1月第1週 <任意の曜日> の休日設定はそのままになります。再度設定

し直してください。



5.5. 日付/時間型のスクリプト変数を文字列に展開する際のフォーマッ

ト

system.properties に設定を行っている場合 (対処方法 2) は、バージョンアップ後に新バージョンの

DataSpider Servista に新しく設定を行う必要があります。

system.properties の設定を変更したあとは、DataSpiderServer を再起動してください。

スクリプト変数の型を変更した場合 (対処方法 1) は、「設定が必要なアップグレード元のバージョン」からの

バージョンアップ時に一度行っていれば、行う必要はありません。



• 概要

日時データを文字列に変換する際の仕様を、ISO 8601 に準拠するフォーマット (yyyy-MM-

dd’T’HH:mm:ss.SSSZZ) に変更しました。

それに伴い、プロパティ項目の入力フィールドに設定されている日付/時間型のスクリプト変数を展開する場合の

日付フォーマットが以下のように変更になりました。

◦ 変更前:「yyyy-MM-dd HH:mm:ss.SSS」

◦ 変更後:「yyyy-MM-dd’T’HH:mm:ss.SSSZZ」

DataSpider Servista 2.3.x 以前の動作(「yyyy-MM-dd HH:mm:ss.SSS」のフォーマットで日付/時間型スクリ

プト変数を展開する) に変更したい場合には、以下のいずれか設定を行ってください。

• 対処方法

1. スクリプト変数の型を「文字列型」に変更し、「日時フォーマッティング」ロジックを使用する

該当する日付/時間型スクリプト変数の型を文字列型に変更し、「日時フォーマッティング」ロジックでフ

ォーマッティングをしてください。

2. system.properties ファイルに日付フォーマットを指定する

「xmlfw.daterenderingformat」で指定したフォーマットは、日時データを文字列として出力するカ所

全般に適用されます。そのため、日時データをそのまま文字列として扱っているカ所では、書き込むデータ

の書式が「yyyy-MM-dd’T’HH:mm:ss.SSSZZ」から「yyyy-MM-dd HH:mm:ss.SSS」に変更になりま



す。



• 配置場所


• キー

◦ xmlfw.daterenderingformat

• 設定内容

コメントアウトを外して、以下の内容を記述してください。

◦ xmlfw.daterenderingformat=yyyy-MM-dd HH:mm:ss.SSS

5.6. スクリプト全般

本項では、スクリプト全般に関する、バージョンアップに伴う特別な設定について説明します。



5.6.1. UTF-8 のバックスラッシュを設定するとコンパイルエラーが発生す

る問題の修正反映方法



• 概要

UTF-8 のバックスラッシュ (0xC2A5) がスクリプト上の設定値に存在した場合、コンパイルエラーが発生する問

題を修正しました。

本修正を反映させるためには、次項「対処方法」に記載の手順にしたがってください。

• 対処方法

バージョンアップ後に、コンパイルエラーが発生するスクリプトのビルドを行ってください。スクリプトのビルド

は、以下のいずれかの方法で行うことができます。



◦ メニューの [テスト実行]-[ビルド] 選択

◦ ツールバーの [スクリプトのビルド] 選択

◦ F7 キー打鍵

ビルド後に、修正が適用されます。

5.6.2. トランザクション処理、またはグループ処理に関する問題の修正反映

方法



• 概要

トランザクション処理、またはグループ処理で、終了処理を通らないプロセスフローを経由してスクリプトが終了

した場合に発生する以下の問題を修正しました。

◦ グローバルリソースのコンポーネントプールが解放されない

◦ ファイルトランザクションのテンポラリファイルが残る


• 対処方法

バージョンアップ後に、対象スクリプトの再ビルドを行ってください。

スクリプトのビルドは、以下のいずれかの方法で行うことができます。

◦ メニューの [テスト実行]-[ビルド] 選択

◦ ツールバーの [スクリプトのビルド] 選択

◦ F7 キー打鍵

ビルド後に、修正が適用されます。

5.6.3. サービス実行に関する問題の修正反映方法





• 概要

プロジェクトを開いた直後にサービスとして登録すると、サービス内のマージMapper を含むスクリプトの実行時

に、「InputDataNotFoundException」エラーが発生する問題を修正しました。


• 対処方法

バージョンアップ後に、対象のプロジェクトを再度サービスとして登録してください。

5.7. Mapper

本項では、Mapper に関する、バージョンアップに伴う特別な設定について説明します。



5.7.1. ユーザ定義ロジックに関する問題の修正反映方法 (1)


◦ DataSpider Servista 3.0 ~ 3.0 SP2

• 概要

以下の条件をすべて満たしたユーザ定義ロジックを使用しているスクリプトを実行すると、実行結果が不正になる

場合がある問題を修正しました。

◦ DataSpider Servista 3.0 以降のバージョンで作成または編集している

◦ 一つの Mapper ロジックからほかの複数の Mapper ロジックにマッピングリンクを設定している

◦ Studio で、複数の Mapper で使用されている (※)

(※) Studio for Web では、単一の Mapper でも発生します。


• 対処方法

バージョンアップ後に、以下の手順を行ってください。



1. 事象が発生しているユーザ定義ロジックを開く。

2. Mapper ロジックの位置をずらすなどして Mapper を編集状態にする。

3. プロジェクトを保存する。

5.7.2. ユーザ定義ロジックに関する問題の修正反映方法 (2)



• 概要

ユーザ定義ロジック内にて、条件判定による出力の切り替えロジックを使用すると、エラーが発生するまたは値が

出力されない場合がある問題を修正しました。


• 対処方法


1. 事象が発生しているユーザ定義ロジックを開く。



5.7.3. 単純な繰り返しロジックに関する問題の修正反映方法



• 概要

単純な繰り返しロジックの指定ノードと値を出力する要素が同一の場合、結果データにマッピングされた値が出力

されない問題を修正しました。


• 対処方法




1. 事象が発生している Mapper を開く。



5.7.4. Mapper ロジックに半角カンマを含む環境変数を設定した場合に発

生する問題の修正反映方法



• 概要

Mapper ロジックに「,」(半角カンマ) を値に含む環境変数を設定した場合、変数の展開時に「,」の手前までの値

しか取得できない問題を修正しました。

※本現象を、「,」の前に文字エスケープ「\\」を記述して回避していた場合、本修正により「\\」がそのまま

出力されるようになります。

例: 環境変数「test1」 (値は「aaa,bbb」)、「test2」 (値は「aaa\\,bbb」)

◦ (修正前) %{test1} → 「aaa」、%{test2} → 「aaa,bbb」

◦ (修正後) %{test1} → 「aaa,bbb」、%{test2} → 「aaa\\,bbb」


• 対処方法


1. 事象が発生している Mapper を開く。



5.7.5. 「文字列ごとに置換」ロジックの [マッチング方法] に関する問題の

対処方法





• 概要

DataSpider Servista 2.1.1 以前で作成した「文字列ごとに置換」ロジックを含む Mapper を、DataSpider

Servista 2.2.0 以降にバージョンアップしたあと、「文字列ごとに置換」ロジックを含む Mapper のビルドをす

ると「文字列ごとに置換」ロジックの [マッチング方法] の値が [完全一致] に変更されます。

これは、DataSpider Servista 2.2.0 で、「文字列ごとに置換」の [マッチング方法] に [完全一致] が追加された

ためです。

2.2.0 以降では、[マッチング方法] のデフォルト値は [完全一致] であるため、バージョンアップ後に [マッチン

グ方法] の表示上の値が「完全一致」に設定されます。この時点では内部値は [部分一致] のままですが、ロジッ

クが配置された Mapper をビルドすることで、表示上の値が内部値に設定され、ロジックの動作が変わってしま

います。

• 対処方法

バージョンアップ後、「文字列ごとに置換」ロジックを開き、[マッチング方法] の値を [部分一致] に設定してく

ださい。

明示的に設定し直すことで、ビルド時に設定が変わらなくなります。



5.8. データベースアダプタ全般

本項では、データベース (RDB) アダプタ特有の、バージョンアップに伴う特別な設定について説明します。





• 概要

検索系SQL実行処理で SUM 関数を使用していて、かつ [スキーマ定義] に「NUMBER(int)」の型が存在する場

合、2.2.0 以降にバージョンアップして実行すると実行時に「ClassCastException」エラーが発生します。

• 対処方法

対象の検索系SQL実行処理のプロパティ設定ダイアログを開き、[SQL文を実行してスキーマを設定] を実行して

スキーマ定義を更新してください。

5.9. Accessアダプタ、ODBCアダプタ

本項では、Access アダプタおよび ODBC アダプタ特有の、バージョンアップに伴う特別な設定について説明します。





• 概要

DataSpider Servista 4.0 から、ODBC 接続は JDBC Proxy Server 経由のみをサポートします。そのた

め、DataSpider Servista 3.2 以前で [ドライバタイプ] で [ODBC] を指定しているグローバルリソースは、新

バージョンにバージョンアップ後、自動的に [ドライバタイプ] が [JDBC Proxy Server] に切り替わります。[ド

ライバタイプ] で [JDBC Proxy Server] を指定しているグローバルリソースは、そのまま使用できます。

JDBC Proxy Server は、32bit の ODBC データソースのみをサポートします。 DataSpider Servista 3.2

以前のバージョンで 64bit の ODBC データソースを使用している場合、新バージョンにバージョンアップ

後、32bit の ODBC データソースを作成してください。



詳細な動作と、対処方法を以下に記載します。

• [ドライバタイプ] で [ODBC] を指定している場合の詳細な動作

◦ 新バージョンにバージョンアップ後、自動的に [ドライバタイプ] が [JDBC Proxy Server] に切り替わり、

[Proxyサーバ] には「localhost」が、[Proxyポート番号] には「4412」(JDBC Proxy Server のデフォルト

のポート番号) が設定されます。[ODBCデータソース名]・[ユーザ名]・[パスワード] は以前の設定を引き

継ぎます。

• 対処方法

◦ DataSpiderServer 稼働OS 上に JDBC Proxy Server をデフォルトのポート番号でインストールします。グ

ローバルリソースの設定を変更することなく接続可能になります。

DataSpider Servista 3.2 以前で [ドライバタイプ] で [ODBC] を指定しているグローバルリソースでも、操作に

よっては [Proxyサーバ]・[Proxyポート番号] の設定値が残っている場合があります。その場合、新バージョンにバー

ジョンアップ後はその設定を引き継ぐため、インストールした JDBC Proxy Server の設定に合わせてグローバルリ

ソースの設定を変更してください。

5.10. Oracle 11gR2 アダプタ

本項では、Oracle 11gR2 アダプタ特有の、バージョンアップに伴う特別な設定について説明します。

5.10.1. ライブラリ (JDBCドライバ) の変更





• 概要

DataSpider Servista 3.1 から、Oracle 11gR2 アダプタで使用する JDBCドライバのバージョンが変更になりま

した。そのため、バージョンアップ後に JDBCドライバを変更する必要があります。

• ドライババージョン

◦ Oracle JDBC Driver 11.2.0



• 対象ライブラリ

◦ ojdbc6.jar

Oracleダウンロードサイトより 11.2 用の JDBCドライバをダウンロードしてください。

• 配置先

◦ $DATASPIDER_HOME/server/plugin/data_processing/modules/oracle11gr2_adapter

◦ $DATASPIDER_HOME/server/plugin/data_processing/modules/xa_oracle11gr2_adapter

• 変更手順

1. DataSpiderServer および各種クライアントアプリケーションを停止します。

2. 上記配置先にある旧バージョンで使用していた JDBCドライバを削除します。

3. ダウンロードした JDBCドライバを上記配置先にコピーします。

4. DataSpiderServerおよびDataSpider Studio を起動します。

5.11. Oracle OCI アダプタ

本項では、Oracle OCI アダプタ特有の、バージョンアップに伴う特別な設定について説明します。

5.11.1. [8iに接続] プロパティ項目にチェックありグローバルリソースの移

行方法





• 概要

DataSpider Servista 4.1 から、Oracle OCI アダプタのグローバルリソースの [8iに接続] プロパティ項目が廃止

になりました。そのため、[8iに接続] プロパティ項目にチェックが入っている DataSpider Servista 4.0 以前の

グローバルリソースを、DataSpider Servista 4.1 以降にバージョンアップすると、正常に動作しません。

• 対処方法



https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html

1. バージョンアップ後に [8iに接続] プロパティ項目にチェックが入っている既存のグローバルリソースを削除

します。削除する際には、グローバルリソース名を控えておいてください。

2. Oracle OCI アダプタがサポートしているクライアントおよびデータベースに接続するグローバルリソース

を新規に作成します。グローバルリソース名は 1. で控えておいた名前にしてください。

5.12. SQL Server 2014 / 2012 アダプタ

本項では、SQL Server 2014 / 2012 アダプタ特有の、バージョンアップに伴う特別な設定について説明します。






• 概要

DataSpider Servista 4.1 から、SQL Server 2014 / 2012 アダプタで使用している JDBCドライバのバージョン

が変更になりました。そのため、バージョンアップ後に JDBCドライバを変更する必要があります。


◦ Microsoft JDBC Driver 6.0 for SQL Server


◦ sqljdbc42.jar

◦ sqljdbc_auth.dll (Windows統合認証を使用する場合)

ドライバは Microsoftダウンロードセンターから入手してください。

• 配置先

◦ SQL Server 2014 アダプタ

▪ $DATASPIDER_HOME/server/plugin/data_processing/modules/sqlserver2014_adapter

◦ SQL Server 2012 アダプタ



https://www.microsoft.com/ja-jp/download/details.aspx?id=11774

▪ $DATASPIDER_HOME/server/plugin/data_processing/modules/sqlserver2012_adapter

• 変更手順




4. DataSpiderServer および DataSpider Studio を起動します。

5.13. SAP EICS

本項では、SAP EICS 特有の、バージョンアップに伴う特別な設定について説明します。


◦ すべて

• 概要

SAP EICS では、バージョンアップ時に以下の手順が必要となります。

• バージョンアップ手順

アップグレード元の環境に SAP EICS がすでに存在する場合、事前に 1. と 2. の手順を行ってください。

1. 旧バージョンのデータをバックアップ

詳細については、SAP EICS インストールガイドの「10. SAP EICS リポジトリのバックアップ・移

行」を参照してください。

2. 旧バージョンのアンインストール

詳細については、SAP EICS インストールガイドの「11. SAP EICSのアンインストール」を参照してく

ださい。

3. 新バージョンの SAP EICS をインストールします。

詳細については、SAP EICS インストールガイドを参照してください。

4. 旧バージョンからデータを移行します。

詳細については、SAP EICS インストールガイドの「10. SAP EICS リポジトリのバックアップ・移

行」を参照してください。



5.14. SAPテーブルクエリアダプタ

本項では、SAPテーブルクエリアダプタ特有の、バージョンアップに伴う特別な設定について説明します。


◦ すべて

• 概要

SAPテーブルクエリアダプタでは、バージョンアップ時に設定ファイルを移行する必要があります。


詳細については、SAPテーブルクエリアダプタセットアップガイドの「5. SAPテーブルクエリアダプタのア

ップグレード手順」を参照してください。

5.15. Tableau アダプタ

本項では、Tableau アダプタ特有の、バージョンアップに伴う特別な設定について説明します。

5.15.1. Hyper ファイル出力の設定




◦ DataSpider Servista 4.1 SP4 以前

• 概要

DataSpider Servista 4.1 SP5 から、Hyper ファイル出力に対応しました。TDE ファイル出力用のライブラリと

Hyper ファイル出力用のライブラリは同時に使用できません。TDE ファイル出力から Hyper ファイル出力に変

更する場合は、以下の変更手順を実施してください。

• 変更手順


2. $DATASPIDER_HOME/server/bin ディレクトリ直下の TDE ファイル出力用のライブラリ群を削除

3. Visual Studio 2013 の Visual C++ 再頒布可能パッケージをインストールします。

Visual C++ 再頒布可能パッケージは Microsoftダウンロードセンターから入手してください。



https://www.microsoft.com/ja-JP/download/details.aspx?id=40784

4. DataSpiderServer 稼働OS の環境変数「PATH」に以下を追加します。

$DATASPIDER_HOME/server/lib/tableau_adapter/windows_hyper/bin

例：$DATASPIDER_HOME が C:\Program Files\DataSpiderServista の場合、環境変数「PATH」に以下

を追加します。

C:\Program Files\DataSpiderServista\server\lib\tableau_adapter\ windows_hyper\bin


TDE ファイル出力用のライブラリ群については、DataSpider Servista ヘルプの「Tableau」-「ライブラリのイ

ンストール」ページを参照してください。

5.16. List Creator アダプタ

本項では、List Creator アダプタ特有の、バージョンアップに伴う特別な設定について説明します。

5.16.1. ライブラリのパスの区切り文字の変更


◦ DataSpider Servista 2.4.x

• 概要

DataSpiderServer.lax ファイルに追加する List Creator アダプタのライブラリパスの区切り文字が「\」の場

合、「/」に変更してください。


◦ DataSpiderServer.lax

• 配置場所

◦ $DATASPIDER_HOME/server/bin

• 変更手順


2. DataSpiderServer.lax ファイルを開きます。

3. キー「lax.class.path」に設定された List Creator アダプタの各ライブラリのパス区切り文字を「\」から

「/」に変更します。




5.17. FTP アダプタ

本項では、FTP アダプタ特有の、バージョンアップに伴う特別な設定について説明します。

5.17.1. グローバルリソースの [エンコード] の設定





• 概要

DataSpider Servista 3.0 以降から、FTP アダプタのグローバルリソースの [エンコード] に接続先 FTP サーバ

のエンコードを必ず指定する必要があります。

新バージョンにバージョンアップ後に、接続先 FTP サーバのエンコードを指定するようにしてください。

5.18. Web アダプタ

本項では、Web アダプタ特有の、バージョンアップに伴う特別な設定について説明します。

5.18.1. 「localhost」および「127.0.0.1」に対するプロキシサーバ接続

の設定





• 概要

新バージョンにバージョンアップ後、プロキシサーバを使用する設定を行っていても、「localhost」および

「127.0.0.1」に対してプロキシサーバを経由せず接続するようになります。



バージョンアップ前の動作 (「localhost」および「127.0.0.1」に対してもプロキシサーバを経由して接続する)

に変更したい場合には、system.properties にキー「http.nonProxyHosts」を追加し、値として空文字を指定し

てください。



• 配置場所


• 変更手順


2. system.properties ファイルを開きます。

3. キー「http.nonProxyHosts」を追加し、値に空文字を設定します。(例:「http.nonProxyHosts=」)


5.19. Webサービスアダプタ

本項では、Webサービスアダプタ特有の、バージョンアップに伴う特別な設定について説明します。

5.19.1. NamespaceDefinitionsGenerator の設定


◦ DataSpider Servista 2.4.5 + パッチ「DSS245_110125_10」、

または DataSpider Servista 2.4.6

• 概要

「設定が必要なアップグレード元のバージョン」の DataSpider Servista の Webサービスアダプタの Webサー

ビス実行処理で、自動生成された入出力スキーマに接頭辞が付与されている場合、バージョンアップ後、移行のた

めのツールを実行する必要があります。

• 設定手順


2. 以下の実行ファイルをエディタで開き、設定を行います。



▪ Windows 版の場合

▪ $DATASPIDER_HOME/server/lib/NamespaceDefinitionsGenerator.bat

▪ Linux 版の場合

▪ $DATASPIDER_HOME/server/lib/NamespaceDefinitionsGenerator.sh

設定が必要なカ所は以下の通りです。

▪ DS_HOME

▪ DataSpiderServer をインストールしたディレクトリを指定します。

▪ DS_HOST

▪ DataSpiderServer のホスト名または IPアドレスを指定します。

▪ DS_PORT

▪ DataSpiderServer のポート番号を指定します。

▪ DS_USER

▪ 本ツールを実行する DataSpiderServer のユーザ名を指定します。(※管理者権限を持ったユー

ザを指定してください。)

▪ DS_PASS

▪ 本ツールを実行する DataSpiderServer ユーザのパスワードを指定します。

3. DataSpiderServer を起動します。

4. 設定を行ったファイルを実行します。実行したファイルと同じディレクトリ adapter.properties が作成さ

れます。

5. DataSpiderServer を停止します。

6. 4.で作成された adapter.properties の内容をコピーし、以下のファイルに追記します。

▪ $DATASPIDER_HOME/server/plugin/data_processing/modules/webservices_adapter/META-

INF/adapter.properties


上記の手順で移行を行った場合、移行した Webサービスアダプタのグローバルリソース名は変更しないでくださ

い。



5.20. Amazon RDS for SQL Server 2012 アダプタ

本項では、Amazon RDS for SQL Server 2012 アダプタ特有の、バージョンアップに伴う特別な設定について説明し

ます。






• 概要

DataSpider Servista 4.1 から、Amazon RDS for SQL Server 2012 アダプタで使用している JDBCドライバの

バージョンが変更になりました。そのため、バージョンアップ後に JDBCドライバを変更する必要があります。




◦ sqljdbc42.jar


• 配置先

◦ Amazon RDS for SQL Server 2012 アダプタ

▪ $DATASPIDER_HOME/server/plugin/data_processing/modules/ +

amazon_rds_sqlserver2012_adapter

• 変更手順








5.21. Amazon Redshift アダプタ






• 概要

DataSpider Servista 4.1 から、Amazon Redshift アダプタで使用している JDBCドライバが変更になりまし

た。そのため、バージョンアップ後に JDBCドライバや、グローバルリソースの [URL] の値を変更する必要があ

ります。


◦ Amazon Redshift JDBC Driver 1.1.<バージョン>(JDBC 4.2 互換ドライバ)


◦ RedshiftJDBC42-1.1.<バージョン>.jar

ドライバは Amazon Redshift JDBC Driverダウンロードサイトから入手してください。

• 配置先

◦ Amazon Redshift アダプタ

▪ $DATASPIDER_HOME/server/plugin/data_processing/modules/

amazon_redshift802_adapter

• 変更手順






http://docs.aws.amazon.com/ja_jp/redshift/latest/mgmt/configure-jdbc-connection.html


5. 旧バージョンで使用していた Amazon Redshift アダプタのグローバルリソースを開きます。

6. グローバルリソースの [URL] プロパティ項目に、Amazon Redshift のコンソール画面で表示されている

Cluster Database Properties-JDBC URL を指定します。

5.22. Azure SQL Database アダプタ






• 概要

DataSpider Servista 4.1 から、Azure SQL Database アダプタで使用している JDBCドライバのバージョンが

変更になりました。そのため、バージョンアップ後に JDBCドライバを変更する必要があります。




◦ sqljdbc42.jar


• 配置先

◦ Azure SQL Database アダプタ

▪ $DATASPIDER_HOME/server/plugin/data_processing/modules/

sqlazure_adapter

• 変更手順








5.23. ScriptRunner

本項では、ScriptRunner 特有の、バージョンアップに伴う特別な設定について説明します。

5.23.1. scriptrunner.bat の配置



• 概要

旧バージョンの DataSpider Servista で scriptrunner.bat を使用している場合、別途配置が必要となります。


◦ scriptrunner.bat

• 配置場所

◦ $DATASPIDER_HOME/server/lib/

• 変更手順


2. scriptrunner.bat ファイルを $DATASPIDER_HOME/<server|client>/bin 下に配置します。


5.24. ScriptRunnerProxy

本項では、ScriptRunnerProxy 特有の、バージョンアップに伴う特別な設定について説明します。

5.24.1. dssrconnection.jar の更新




◦ すべて

• 概要

ScriptRunnerProxy では、Java プログラム実行環境の dssrconnection.jarとDataSpiderServer 内の

dssrconnection.jar が同一である必要があります。

そのため、Java プログラム実行環境に dssrconnection.jar をコピーして配置している場合には、必ず製品に同

梱されている最新の dssrconnection.jar に差し替えるようにしてください。


◦ dssrconnection.jar

• 配置場所

◦ $DATASPIDER_HOME/<server|client>/system/common/lib/

5.25. DataSpiderServer

本項では、DataSpiderServer 特有の、バージョンアップに伴う特別な設定について説明します。

5.25.1. Windows x64 版の「lax.nl.java.option.additional」設定につ

いて





• 概要

Windows x64 版の DataSpiderServer の設定ファイル (DataSpiderServer.lax) の

「lax.nl.java.option.additional」に以下のオプションを追加している場合、DataSpider Servista 4.2 にバージ

ョンアップする際には、オプションを移行しないでください。

• 配置場所

◦ $DATASPIDER_HOME/server/bin/

DataSpiderServer.lax ファイル内の「lax.nl.java.option.additional」



• 対象オプション

◦ -XXcompressedRefs=0

◦ -XnoOpt

◦ -XstrictFP

DataSpider Servista 4.1 以降では、上記オプションの設定は必要ありません。

5.26. スマートコンパイラ

本項では、スマートコンパイラ特有の、バージョンアップに伴う特別な設定について説明します。

5.26.1. バージョンアップしたスクリプトへのPSPの適用





• 概要

スマートコンパイラは、スクリプトの内容を解析し、理論上データ容量の制限がない PSP が使用可能なカ所を自

動で検出して適用する機構です。PSP を適用することにより、スクリプトのパフォーマンスを最大限に発揮する

ことができます。

PSP では、ブロック単位で分割したデータの読み取り・変換・書き込みといった一連の流れをマルチスレッドで

処理するため、大容量データを高速に処理することができます。ただし、PSP は機構の特性上すべての処理が対

応しているわけではありません。PSP に対応しているコンポーネントは主にデータモデルがテーブルモデル型の

コンポーネントに限られます。

PSP に対応するコンポーネントについては、DataSpider Servista ヘルプの「パラレルストリーミング処

理」ページを参照してください。

バージョンアップしたスクリプトは、自動では PSP が適用されません。PSP を適用したい場合は、明示的にデータフ

ローを PSP データフローに変更する必要があります。



PSP の適用方法は、以下の通りです。

1). データフローから個別変更

スクリプトキャンバスでは、データフロー単位で PSP データフローに変更することができます。

1. デザイナで、対象のスクリプトを開きます。

2. データフローの右クリックメニュー [PSPデータフローを有効化/無効化] にチェックを入れます。

2). プロジェクトエクスプローラから一括変更

プロジェクトエクスプローラでは、「プロジェクト単位」「フォルダ単位」「スクリプト単位」でそれぞれデータフ

ローをPSPデータフローに変更することができます。

1. デザイナで対象のプロジェクトを開きます。

2. プロジェクトエクスプローラで、プロジェクト / フォルダ / スクリプトの右クリックメニュー [PSPデータフロー

の操作] から [一括で有効にする] を選択します。

3. 「PSPデータフローの操作」ダイアログの [OK] ボタンを押下します。

手順 2. で [一括で解除する] を選択すると、対象のスクリプトのPSPデータフローをすべて通常のデータフローに

変更することができます。

3). マイプロジェクトから一括変更

プロジェクト内のスクリプトのデータフローをすべて PSP データフローに変更します。

1. マイプロジェクトを開きます。

2. プロジェクトの一覧で、対象のプロジェクトの右クリックメニュー [PSPデータフローの操作] から [一括で有効

にする] を選択します。



3. 「PSPデータフローの操作」ダイアログの [OK] ボタンを押下します。

4. 「PSPデータフローの一括設定変更」ダイアログの [OK] ボタンを押下します。

手順 2. で [一括で解除する] を選択すると、プロジェクト内のスクリプトの PSP データフローをすべて通常の

データフローに変更することができます。

5.27. JDBC Proxy Server

本項では、JDBC Proxy Server 特有の、バージョンアップに伴う特別な設定について説明します。


◦ すべて



• 概要

JDBC Proxy Server では、バージョンアップ時に以下の手順が必要となります。


1. 旧バージョンの JDBC Proxy Server をアンインストールします。

詳細については、JDBC Proxy Server インストールガイドの「13. JDBC Proxy Server のアンインス

トール」を参照してください。

2. 新バージョンの JDBC Proxy Server をインストールします。

詳細については、JDBC Proxy Server インストールガイドの「7. JDBC Proxy Server のインストー

ル」を参照してください。

5.28. StraForm-Xコネクタ

本項では、StraForm-Xコネクタ特有の、バージョンアップに伴う特別な設定について説明します。


◦ すべて

• 概要

StraForm-Xコネクタでは、バージョンアップ時に以下の手順が必要となります。


1. 新バージョンの StraForm-Xコネクタのモジュールを StraForm サーバベースに上書き配置します。

詳細については、StraForm-Xコネクタユーザガイドの「3.2. StraForm-Xコネクタモジュールの配

置」を参照してください。

5.29. HULFT DataSpider 接続アダプタ

本項では、HULFT DataSpider アダプタ特有の、バージョンアップに伴う特別な設定について説明します。

5.29.1. HULFT DataSpider 接続アダプタの設定情報の移行方法







• 概要

旧バージョンで使用していた HULFT DataSpider 接続アダプタの設定情報を新バージョンに移行する場合の手順

は、以下の通りです。

1). HULFT8 に接続する場合 (HULFT8 アダプタを使用する)

新バージョンにバージョンアップ後、HULFT DataSpider 接続アダプタで使用していたグローバルリソースおよびプロ

ジェクトを開き、接続先の HULFT8 に合わせて設定を変更します。

2). HULFT7 に接続する場合 (HULFT7 アダプタを使用する)

1. 新バージョンにバージョンアップ後、「HULFT7 接続設定」のグローバルリソースを新規作成します。作成する

グローバルリソースの名前は、HULFT DataSpider 接続アダプタで使用していたグローバルリソースと同名にし

ます。

移行した HULFT DataSpider 接続アダプタのグローバルリソースの名前を変更してから行ってください。同

名にすることで、スクリプトの変更をせずに移行ができます。

2. HULFT DataSpider 接続アダプタのグローバルリソースの設定情報をもとに、1.で作成したグローバルリソース

を設定します。



6. 補足事項

6.1. スキーマ読み込みの仕様変更について

DataSpider Servista 2.2.0 ではスキーマ読み込みの仕様の変更を行いました。

DataSpider Servista 2.2.0 以降では、スキーマの読み込みが可能な入力元データを持つ場合、同一のコンポーネント

からデータフローを引かれたドキュメントMapper / 変数Mapper が複数あった際に、一つのドキュメントMapper / 変

数Mapper で設定されたスキーマ構造をほかのドキュメントMapper / 変数Mapper でも自動で表示することができる

ようになります。

6.1.1. 「2.1」ツールチップが表示されるドキュメントMapper / 変

数Mapper について

DataSpider Servista 2.1.1 以前のドキュメントMapper/変数Mapper を DataSpider Servista 2.2.0 以降で読み込む

と、アイコンに以下の 2.1 ツールチップが表示される場合があります。

これはスキーマの読み込みの仕様が変更されたためで、2.1 ツールチップが表示されているドキュメントMapper / 変

数Mapper は、DataSpider Servista 2.1.1 以前のスキーマ読み込み処理を行います。

2.1 ツールチップが表示されているドキュメントMapper に引かれているすべてのデータフローを削除すると、2.1

ツールチップが消えます。

(2.1 ツールチップが消えたドキュメントMapper にデータフローが引かれると、DataSpider Servista 2.2.0 以降のス

キーマ読み込み処理となります。)

変数Mapper の場合は、一部の例外を除き 2.1 ツールチップが消えることはありません。

「2.1」ツールチップが表示されている場合でも、内部アーキテクチャは DataSpider Servista 2.2.0 以降の新

アーキテクチャとなります。

6.2. 外部アプリケーション起動処理の仕様変更について

DataSpider Servista 2.3.0 では外部アプリケーション起動処理のログレベルの仕様を変更しました。



以下の環境から DataSpider Servista 2.3.0 以降へバージョンアップすると、バージョンアップ前には出力されていた

コマンドの出力結果の一部が、バージョンアップ後には出力されません。

• DataSpider Servista 2.2.1.1 以前

• 実行時のログレベル：FINFO



7. トラブルシューティング

7.1. DataSpider Servista 2.1.1 以前からバージョンアップ後、検

索系SQL実行処理で「ClassCastException」が発生する

• 事象

DataSpider Servista 2.1.1 以前の環境で、データベースアダプタの検索系SQL実行処理で SUM 関数を使用して

いて、かつスキーマ定義に NUMBER(int) の型が存在する場合、DataSpider Servista 2.2.0 以降にバージョンア

ップして実行すると「ClassCastException」エラーが発生する。(DSS-3877)

• 考えられる原因

DataSpider Servista 2.2.0 以降では、DataSpider Servista 内部で NUMBER 型を「BigDecimal」で扱うよう

になったためです。

• 対応方法

エラーが発生するデータベースアダプタのプロパティ設定ダイアログを開き、[SQL文を実行してスキーマを設定]

プロパティアクションを実行して、スキーマ定義を更新してください。

7.2. DataSpider Servista 2.4.6 以前から DataSpider Servista

3.0 以降にバージョンアップ後、妥当性検証(XML Schema)処理でエ

ラーが発生する

• 事象

DataSpider Servista 2.4.6 以前の環境で以下の条件を満たす XML Schema ファイルを、妥当性検証(XML

Schema)処理で使用していた場合、DataSpider Servista 3.0 以降にバージョンアップするとエラーが発生す

る。（DSS-26226）

◦ タイプの異なる同名の要素が定義されている

• 考えられる原因

DataSpider Servista 3.0 以降では、W3C の仕様に従い、タイプの異なる同名の要素が定義されている XML

Schema ファイルはエラーになるようにしたためです。

• 対応方法

XML Schema ファイルを修正してください。

例: タイプの異なる同名の要素が定義されている場合、要素名を変更してください。



DataSpider Servista


第 5 版 2020.1.8

株式会社セゾン情報システムズ



4.2 アップグレードガイド...3.4.8. ライブラリのインストール . . . . . . . . . ....

Documents