DataSpiderServerの設定

DataSpiderServerの設定とは

DataSpiderServerの設定とは、ポート番号やセキュリティの設定、サーバ移行、DataSpiderServerの再起動・停止などのDataSpiderServerの各種設定を行うツールです。

DataSpiderServerの設定の機能

DataSpiderServerの設定では、以下の機能を提供しています。

機能の説明

機能名	タブ	説明	備考
DataSpiderServerの基本情報表示	全般	DataSpiderServerの基本情報を表示します。DataSpiderServerの設定の起動時に表示されます。
システムプロパティの表示	全般	Javaのシステムプロパティを表示します。
ポート番号の変更	ポート	ポート番号の変更を行います。	Studio for Webでのタブ名は、[ポートとセキュリティ]となります。
HTTPS通信の設定	セキュリティ	HTTPS通信の設定を行います。	Studio for Webでのタブ名は、[ポートとセキュリティ]となります。
ライセンス情報の表示	ライセンス情報	ライセンス情報を表示します。
DataSpiderログ設定	ログ設定	$DATASPIDER_HOME/server/logs/<日付ディレクトリ>下に出力されるログファイル群の圧縮・削除の設定を行います。	Studio for Webのみの項目です。
サーバの移行(エクスポート)	サーバ移行	現在の設定をほかのサーバへ移行する際に使用し、DataSpiderServerの設定をエクスポートします。
サーバの移行(インポート)	サーバ移行	エクスポートした設定を該当サーバへ移行する際に使用し、DataSpiderServerの設定をインポートします。
チーム開発機能の設定	チーム開発	チーム開発機能の設定を行います。
一時ディレクトリのクリーンアップ	その他	一時ディレクトリに保持されている一時ファイルの削除を行います。
DataSpiderServerの再起動		DataSpiderServerの再起動を行います。
DataSpiderServerのシャットダウン		DataSpiderServerのシャットダウンを行います。

DataSpiderServerの基本情報表示

項目の説明

項目名	説明	備考
ホスト名	DataSpiderServerが稼働しているOSのホスト名/IPアドレスが表示されます。	DataSpiderServerが稼働しているOSに複数のIPアドレスが割り当てられていた場合に表示するIPアドレスは、OSのネイティブAPIの仕様に依存しています。
VMID	DataSpiderServerが稼働しているJVMの一意な識別子が表示されます。	一意な識別子は、JVMのプロセスごとに割り振られます。
言語と地域	DataSpiderServerの言語と、DataSpiderServerが稼働しているOSの地域が表示されます。	言語_地域 language_REGION の形式で表示されます。言語が日本語で地域が日本の場合、ja_JP と表示されます。
プロセッサ数	DataSpiderServerが稼働しているOSが認識しているプロセッサ数が表示されます。

システムプロパティの表示

プロパティアクション

項目名	説明	備考
システムプロパティ	「システムプロパティ一覧」画面を開きます。

システムプロパティ一覧

項目の説明

項目名	説明	備考
名前	Javaのシステムプロパティ名です。	DataSpider ServistaのバージョンやDataSpiderServer稼働OSにより、システムプロパティの内容が変わる可能性があります。システムプロパティの値は、Mapperロジックを使用してスクリプトから参照することもできます。
値	プロパティキーに設定されている値です。

ポート番号の変更

管理者権限を持ったユーザのみ実行できます。

設定した内容は、DataSpiderServerの再起動後に有効になります。

Studioの設定は自動では変更されません。手動で変更する必要があります。

詳細については、「プロパティリファレンス」を参照してください。

項目の説明

項目名	説明	備考
ポート番号	StudioからDataSpiderServerへ接続する際に使用されるポート番号です。 1～65535までのポート番号が指定できます(1024以上を推奨)。	デフォルト値は「7700」です。ポート番号を変更する際には、以下の点を確認してください。変更後のポート番号がwell-knownポート以外であること変更後のポート番号がDataSpiderServer稼働OSで使用されていないこと

HTTPS通信の設定

管理者権限を持ったユーザのみ実行できます。
DataSpiderServerが参照するキーストアに、サーバ証明書と通信データを暗号化/復号化するための公開鍵および秘密鍵を格納します。

サーバ証明書および鍵の生成方法については、「HTTPS設定」を参照してください。

設定した内容は、DataSpiderServerの再起動後に有効になります。

項目の説明

項目名	説明	備考
HTTPSを有効にする	HTTPS通信を有効にします。 [チェックあり]: DataSpiderServerとコンポーネント間で行っているHTTP通信をHTTPSで通信します。 [チェックなし]:(デフォルト) DataSpiderServerとコンポーネント間で行っているHTTP通信はHTTPで通信します。	DataSpiderServerとHTTP通信を行っているコンポーネントは以下の通りです。 CLI Console () Studio for Web Studio () HTTPトリガー Webサービストリガー SAP BCトリガー ScriptRunner ScriptRunnerProxy (*)HTTPS通信を有効にしてもHTTPで通信します。
ポート番号	StudioからDataSpiderServerへHTTPS通信で接続する際に使用されるポート番号です。 1～65535までのポート番号が指定できます(1024以上を推奨)。	デフォルト値は「8443」です。ポート番号を変更する際には、以下の点を確認してください。変更後のポート番号がwell-knownポート以外であること変更後のポート番号が[ポート]タブの[ポート番号]で使用されていないこと変更後のポート番号がDataSpiderServer稼働OSで使用されていないこと不正な値(マイナス値や「65535」以上の値)を設定した場合、DataSpiderServerの起動ができません。
パスワード	HTTPSの暗号化で使用する鍵、証明書が保存されているキーストアのパスワードです。	デフォルト値は「changeit」です。

キーストアパスワード不正時のエラー

入力したキーストアパスワードが不正である場合は、以下のメッセージが表示されます。

エラーメッセージの説明

メッセージ	原因
keystore was tampered with, or password is incorrect.	パスワードが改ざんされたか、もしくは不正です。
$DATASPIDER_HOME/server/system/common/classes/.keystore (指定されたファイルが見つかりません。)	$DATASPIDER_HOME/server/system/common/classes/.keystore が存在しません。
Invalid keystore format.	キーストアタイプが「JKS」ではありません。DataSpiderServerの扱えるキーストアタイプは「JKS」のみです。

ライセンス情報の表示

サーバコンポーネント/オプションコンポーネントの一覧

項目の説明

項目名		説明
パッケージタイプ		パッケージの種類です。以下のいずれかが表示されます。「Advanced Server」「Basic Server」「Select」
サーバコンポーネント	コンポーネント	サーバコンポーネントの名前です。「DataSpiderServer」が表示されます。
	バージョン	サーバコンポーネントのバージョン番号です。
	タイプ	ライセンスの種類です。「製品」が表示されます。
オプションコンポーネント	コンポーネント	オプションコンポーネントの名前です。
	バージョン	オプションコンポーネントのバージョン番号です。
	タイプ	ライセンスの種類です。「製品」が表示されます。

ライセンス詳細

項目の説明

項目名		説明	備考
コンポーネント		コンポーネントの名前です。
バージョン		コンポーネントのバージョン番号です。
タイプ		コンポーネントのライセンス種類です。「製品」が表示されます。
ライセンス発行者	組織	ライセンス発行者の組織名です。
	部署	ライセンス発行者の部署名です。
	氏名	ライセンス発行者の氏名です。
ライセンス所有者	組織	ライセンス所有者の組織名です。
	部署	ライセンス所有者の部署名です。
	氏名	ライセンス所有者の氏名です。
制限	有効期限開始日	ライセンスの有効開始日です。	サーバコンポーネント固有の情報です。
	有効期限終了日	ライセンスの有効終了日です。	サーバコンポーネント固有の情報です。
	開発用クライアント数	サーバに同時接続可能な開発用クライアントの最大数です。	サーバコンポーネント、Studio for Web固有の情報です。
	CPU数	サーバの使用可能なCPU数です。	サーバコンポーネント固有の情報です。
オペレーション		オプションコンポーネントの機能制限内容です。 [READ]:読み取り処理のみを提供します。 [WRITE]:書き込み処理のみを提供します。 [READ/WRITE]:読み取り処理および書き込み処理の両方を提供します。 [制限なし]:機能制限がないコンポーネントです。	オプションコンポーネント固有の情報です。

サーバの移行(エクスポート)

DataSpiderServerの各種設定をZIPファイルとして「クライアントOSローカルファイルシステム」に出力します。
このZIPファイルは、以下の情報が記載されたファイルを含みます。

エクスポートされた設定の項目一覧
エクスポートされた設定情報
処理結果のログ

エクスポートしたファイルは編集しないでください。

管理者権限を持ったユーザのみ実行できます。

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

サーバ移行は、バージョン・サービスパック・単体パッチ適用のすべてが同一のDataSpiderServer間で使用することができます。

エクスポート項目に存在する設定以外は、エクスポートの対象外となります。必要に応じて、インポート先のDataSpiderServerに設定を行うようにしてください。

プロパティアクション

項目名	説明	備考
設定のエクスポート	設定のエクスポートを開始します。

エクスポート項目の選択

「エクスポート項目の選択」画面では、左ペインで各項目を選択状態にすると、右ペインで個別選択をすることができます。

項目の説明

項目	説明	備考
全て選択	全項目にチェックを入れます。
全て解除	全項目のチェックを外します。
ユーザアカウント/グループ	グループをエクスポートします。
ユーザアカウント/ユーザ	ユーザをエクスポートします。
サービス	サービスをエクスポートします。
グローバルリソース	グローバルリソースをエクスポートします。
環境変数	環境変数をエクスポートします。
トリガー	トリガーをエクスポートします。
休日設定カレンダー	休日設定カレンダーをエクスポートします。
プロジェクトファイル	プロジェクトファイルをエクスポートします。	ローカル保存されたプロジェクトはエクスポートされません。
アプリケーションログ出力設定	アプリケーションログ出力設定をエクスポートします。
マウント設定	マウント設定をエクスポートします。
グローバルスキーマ	グローバルスキーマをエクスポートします。
グローバルユーザ定義ロジック	グローバルユーザ定義ロジックをエクスポートします。	グループはすべてエクスポート対象となります。

エクスポートのオプション設定

項目の説明

項目	説明	備考
トリガーを次の状態としてエクスポート	チェックを入れた場合、エクスポートするトリガーの状態を指定できます。チェックを入れない場合にはエクスポート元と同じ状態のままトリガーがエクスポートされます。	「エクスポート項目の選択」画面でトリガーを選択した場合、表示されます。デフォルトは「チェックなし」です。
有効	トリガーを有効な状態でエクスポートします。	[トリガーを次の状態としてエクスポート]にチェックを入れた場合、有効になります。
無効	トリガーを無効な状態でエクスポートします。	[トリガーを次の状態としてエクスポート]にチェックを入れた場合、有効になります。
プロジェクトファイルを次の状態でエクスポート	[全バージョン]:(デフォルト) プロジェクトファイルの全バージョンをエクスポートします。 [最新バージョンのみ]: プロジェクトファイルの最新バージョンのみをエクスポートします。	「エクスポート項目の選択」画面でプロジェクトファイルを選択した場合、表示されます。

エクスポート先の選択

項目の説明

項目	説明	備考
エクスポート先	エクスポート先のディレクトリパスを指定します。	Studio for Webでは、エクスポートファイル名を指定する必要があります。

エクスポートが完了すると、エクスポート結果が表示されます。エラーが発生した場合には、エラー情報も出力されます。

DataSpiderファイルシステムに「不正な状態のグローバルリソース」が存在した場合、グローバルリソースをエクスポートするとエクスポートに失敗します。

エクスポートの注意事項

リポジトリDB有りの環境で、大文字小文字を区別したプロジェクトをエクスポートした場合、小文字のプロジェクトのみエクスポートします。

サーバの移行(インポート)

エクスポートしたDataSpiderServerの各種設定をインポートします。

管理者権限を持ったユーザのみ実行できます。
以下の設定をインポートする場合は、DataSpiderServerの再起動が必要になります。

HULFT Scriptトリガー
SAPトリガー
SAP BCトリガー

インポート後に再起動を求められた場合は、DataSpiderServerの再起動を行ってください。
DataSpiderServerをクラスタ構成で運用し、インポートする設定やデータを共有している場合、インポート後にパッシブノードの再起動が必要です。クラスタ構成については、PDFドキュメントの「DataSpider Servistaクラスタ構成ガイド」を参照してください。

サーバ移行を実行する前に、以下を確認してください。

スクリプトが実行されていないこと
サービスが実行されていないこと
デザイナが起動していないこと
ほかのユーザがDataSpiderServerを使用していないこと

プロパティアクション

項目名	説明	備考
設定のインポート	設定のインポートを開始します。

項目の説明

項目	説明	備考
インポートするファイル(ZIP形式)	インポートするZIPファイルを、クライアントOSローカルファイルシステム上のファイルパスで入力します。 [参照]ボタンを押下するとファイルチューザが起動し、ファイルの選択ができます。	クライアントOSローカルファイルシステムについては、「OSローカルファイルシステム」を参照してください。
プロジェクトの差分インポート	プロジェクトの差分インポートを行います。 [チェックあり]:(デフォルト) インポートの動作は、「差分インポート」です。 [チェックなし]: インポートの動作は、「上書き」です。
環境変数の差分更新	環境変数の差分更新を行います。 [チェックあり]:(デフォルト) インポートの動作は、「差分更新」です。 [チェックなし]: インポートの動作は、「上書き」です。
トリガーを次の状態としてインポート	インポートするトリガーの状態を指定します。 [チェックあり]: トリガーの状態を[有効]または[無効]で選択します。 [チェックなし]:(デフォルト) トリガーの状態を選択できません。 ZIPファイル内のトリガーの状態でインポートします。	[チェックあり]の場合は、[有効]または[無効]を選択します。 [有効]:(デフォルト) ZIPファイル内のトリガーの状態に関わらず、すべてのトリガーを有効状態でインポートします。 [無効]: ZIPファイル内のトリガーの状態に関わらず、すべてのトリガーを無効状態でインポートします。

インポートが完了すると、インポート結果が表示されます。エラーが発生した場合には、エラー情報も出力されます。

インポートの動作

インポートの動作は、以下の3種類があります。

差分更新:インポート先に設定されている内容を更新し、設定されていない内容は追加
上書き:インポート先に設定されている内容を削除し、新規に登録
差分インポート:インポート先に登録されているプロジェクトは保持し、登録されていないプロジェクトを追加

各設定とその設定が対象となるインポートの動作は以下の通りです。

設定名	インポートの動作
設定名	差分更新	上書き	差分インポート
グループ	○	-	-
ユーザ	○	-	-
サービス	○	-	-
グローバルリソース	○	-	-
環境変数	○	○	-
トリガー	○	-	-
休日設定カレンダー	○	-	-
プロジェクトファイル	-	○	○
アプリケーションログ出力設定	○	-	-
マウント設定	○	-	-
グローバルスキーマ	○	-	-
グローバルユーザ定義ロジック (※)	○	-	-

※インポート先に同名で実体が異なるグローバルユーザ定義ロジックが存在した場合、
インポートするファイルのグローバルユーザ定義ロジックはリネームされます。
グローバルユーザ定義ロジックの名前の末尾に、半角アンダースコアと番号を付与してインポートします。

インポートの動作の例

インポートの動作の違いについて、例を元に説明します。

インポート前の状態

インポート先の設定	A	B	- (対象の項目なし)
インポートするファイルの内容	A' (インポート先の設定から変更あり)	- (対象の項目なし)	C

インポート後の状態

「差分更新」の場合	A'	B	C
「上書き」の場合	A'	- (※1)	C
「差分インポート」の場合	A (※2)	B	C

※1 インポート先の設定を削除します。
※2 インポート先に登録されているプロジェクトは保持します。

インポート時の注意事項

インポート先に該当ユーザが存在しない場合にはプロジェクトファイルのインポートは行われません。
該当ユーザとグループのエクスポートを行うか、あらかじめインポート先のDataSpiderServerに該当ユーザを作成してください。
サーバ移行では、サービス・グローバルリソース・トリガー・アプリケーションログ出力設定・マウント設定・グローバルスキーマのユーザ権限情報も移行されます。
インポート先のDataSpiderServerに該当ユーザが存在しない場合には、インポートを実行したユーザがこれら設定のオーナーとなります。
インポートしたトリガーやスクリプトを実行する際には、参照している設定(トリガーであればサービスやグローバルリソース・休日設定など、スクリプトであればグローバルリソースや環境変数など)がインポート先に存在する必要があります。トリガーやスクリプトの実行前にインポートしてください。
プロジェクトの上書きインポートの場合、インポートするファイルに含まれないプロジェクトはマイプロジェクトの一覧から削除されますが、/home/<ユーザ名>/projects/下のプロジェクトファイルは残ります。
インポート前に、インポートするファイルに含まれないプロジェクトをマイプロジェクトで削除してください。

チーム開発機能の設定

管理者権限を持ったユーザのみ実行できます。

設定した内容は、クライアントの再ログイン後に有効になります。

項目の説明

項目名	説明	備考
チーム開発機能を有効にする	チーム開発機能を有効にします。 [チェックあり]: チーム開発に関連する機能が使用できるようになります。 [チェックなし]:(デフォルト) チーム開発に関連する機能は使用できません。	関連する機能は以下の通りです。マイプロジェクトデザイナ

一時ディレクトリのクリーンアップ

管理者権限を持ったユーザのみ実行できます。

一時ディレクトリのクリーンアップは、サービスが実行中ではないこと、およびほかのユーザがクライアントの操作を行っていないことを確認の上、実行するようにしてください。

プロパティアクション

項目名	説明	備考
一時ディレクトリ削除	一時ディレクトリ($DATASPIDER_HOME/server/tmpディレクトリ)に保持されている一時ファイルを削除します。

DataSpiderServerの再起動

管理者権限を持ったユーザのみ実行できます。

DataSpiderServerの再起動中は、クライアントの操作を行うことはできません。

プロパティアクション

項目名	説明	備考
DataSpiderServer再起動	DataSpiderServerに再起動要求を送ります。	DataSpiderServerの再起動後は、Studioメニューの[サーバへ再接続]を実行し、DataSpiderServerに再接続してください。 DataSpiderServerの再起動後は、再ログインを行ってください。

DataSpiderServerのシャットダウン

管理者権限を持ったユーザのみ実行できます。

プロパティアクション

項目名	説明	備考
DataSpiderServer停止	DataSpiderServerに停止要求を送ります。	停止要求後は、クライアントの終了処理を行ってください。

仕様制限

Windows-UNIX/Linux間のサーバ移行では、設定名に2バイト文字が含まれていた場合、移行後に文字化けが発生します。
ファイル名のエンコードはOSに準拠するため、ファイル名エンコードが異なるプラットフォーム間のサーバ移行はエンコードに注意してください。