Systemwalker Desktop Keeper V14g リファレンスマニュアル

1.23 SWDTK_DBCV.EXE(旧版データベースの変換)

機能説明

以下の機能を持っています。

• 管理サーバとデータベース定義がV14.0.0/V14.0.1/V14.1.0以前の場合、データベースの異常有無のチェックと、データベース使用領域/空き領域を調査します。

• 管理サーバとデータベース定義がV14.0.0/V14.0.1/V14.1.0以前の環境において、(管理サーバをV14.2.0にバージョンアップ後)データベース環境をV14.2.0に変換できるかどうかを調査します。

• 管理サーバをV14.2.0にバージョンアップした環境で、データベース定義がV14.0.0/V14.0.1/V14.1.0以前の場合、データベースの異常有無のチェックと、データベース使用領域/空き領域を調査します。

• 管理サーバをV14.2.0にバージョンアップした環境で、データベース定義がV14.0.0/V14.0.1/V14.1.0以前の場合、データベース環境をV14.2.0に変換できるかどうかを調査します。

• V14.2.0にバージョンアップした管理サーバにおいて、データベース環境をV14.0.0/V14.0.1/V14.1.0以前からV14.2.0用へ変換します。

  
  

記述形式

SWDTK_DBCV.EXE  {13.0|13.2|13.3|14.0|14.1|14.2}  {/CK|/GO|/EX}

オプション

オプションの文字列は、英大文字/英小文字が使用できます。全角文字での指定はできません。

<バージョン>:

13.0 :

データベース定義がV13.0.0のときで、かつ、オプションに /CK を指定している場合に指定します。

13.2 :

データベース定義がV13.2.0/V13.2.1のときで、かつ、オプションに /CK を指定している場合に指定します。

13.3 :

データベース定義がV13.3.0のときで、かつ、オプションに /CK を指定している場合に指定します。

14.0 :

データベース定義がV14.0.0/V14.0.1のときで、かつ、オプションに /CK を指定している場合に指定します。

14.1 :

データベース定義がV13.0.0、V13.2.0/V13.2.1、V13.3.0、V14.0.0/V14.0.1、またはV14.1.0のときで、かつ、オプションに /CK を指定している場合に指定します。

14.2 :

データベース定義がV13.0.0、V13.2.0/V13.2.1、V13.3.0、V14.0.0/V14.0.1/V14.1.0、またはV14.2.0のときで、かつ、オプションに /GO か /EX を指定している場合に指定します。

データベース定義がV13.0.0、V13.2.0/V13.2.1、V13.3.0、V14.0.0/V14.0.1/V14.1.0、またはV14.2.0のときで、かつ、オプションに /CK を指定している場合に指定します。

<動作オプション> :

/CK ：

データベースの容量チェック、アクセス禁止DSIの存在チェックを行う場合に指定します。
「V14.2」を指定した場合は、データベースをV14.2.0に移行可能かどうかの判断も実施します。

/GO ：

管理サーバをV14.2.0にバージョンアップした後、使用できるオプションです。

初めてデータベースをV14.2.0の定義環境に変更する場合に指定します。(前回/GOを指定して移行が開始され、途中でエラーとなった場合など)一部のデータベース定義でも実施されている場合は、エラーとなります。

/EX ：

管理サーバをV14.2.0にバージョンアップした後、使用できるオプションです。

データベースを、強制的にV14.2.0の定義環境に変更する場合(2回目以降のコマンド実行時)に指定します。
前回/GOを指定して移行中にエラーが発生し、再実行する場合など、一部のデータベース定義が実施されている環境でだけ実行できます。

以下に、コマンドの実行目的別に、指定するオプションの一覧を示します。

【管理サーバがV14.1.0以前の場合】

移行前のデータベース環境	コマンド実行目的
	データベースの異常有無のチェック、データベース使用領域/空き領域を調査する (1)	データベース環境をV14.2.0に変換できるかどうかを調査する (2)
V13.0.0	13.0 /CK	14.2 /CK
V13.2.0/V13.2.1	13.2 /CK	14.2 /CK
V13.3.0	13.3 /CK	14.2 /CK
V14.0.0/V14.0.1	14.0 /CK	14.2 /CK
V14.1.0	14.1 /CK	14.2 /CK

【管理サーバがV14.2.0の場合】

移行前のデータベース環境	コマンド実行目的
	データベースの異常有無のチェック、データベース使用領域/空き領域を調査する (3)	データベース環境をV14.2.0に変換できるかどうかを調査する (4)	データベースをV14.2.0にバージョンアップする
			初回のコマンド実行時 (5)	2回目以降のコマンド実行時 (6)
V13.0.0	13.0 /CK	14.2 /CK	14.2 /GO	14.2 /EX
V13.2.0/V13.2.1	13.2 /CK	14.2 /CK	14.2 /GO	14.2 /EX
V13.3.0	13.3 /CK	14.2 /CK	14.2 /GO	14.2 /EX
V14.0.0/V14.0.1	14.0 /CK	14.2 /CK	14.2 /GO	14.2 /EX
V14.1.0	14.1 /CK	14.2 /CK	14.2 /GO	14.2 /EX

備考. データベースをV14.2.0にバージョンアップ後、データベースの異常有無のチェックやデータベース使用領域/空き領域を調査する場合は、オプションに“14.2 /CK”を指定します。(7)

復帰値

管理サーバのバージョンおよびコマンド実行時のオプションにより、復帰値が異なります。
以下に関係を示します。

復帰値	復帰値の意味	管理サーバがV14.1.0以前	管理サーバがV14.2.0
		オプションに/CKを指定した場合 (1)(2)	データベース移行前に、オプションに/CKを指定した場合 (3)(4)	オプションに/GOを指定した場合 (5)	オプションに/EXを指定した場合 (6)	データベース移行後に、オプションに/CKを指定した場合 (7)
1	パラメーターエラー	○	○	○	○	○
13	Systemwalker Desktop Keeperのデータベースが構築されていない	○	○	○	○	○
14	Systemwalker Desktop Keeperのサービスが起動していない	○	○	○	○	○
20	データベース状態チェックエラー終了	○	○	○	○	○
30	容量不足で移行不可と判断	○	○	○	－	－
40	移行動作中断エラー	－	－	○	○	－
41	その他エラー	○	○	○	○	○
50	データベース状態チェック正常終了(エラーなし)	－	○ (バージョンに14.1以前を指定時)	－	－	○
60	移行可能と判断	○	○ (バージョンに14.2を指定時)	－	－	－
70	正常移行完了	－	－	○	○	－

○：復帰値があります。
―：復帰値はありません。

コマンド格納場所

データベース関連ファイルのインストールフォルダ\DBEnv\SWDTK_DBCV.EXE

実行に必要な権限/実行環境

• ローカルコンピュータのAdministratorsグループに所属するユーザーまたは、ドメインのDomain Adminsグループに所属するユーザーで行ってください。

• 管理サーバ、または統合管理サーバ上で実行してください。

• 管理サーバのサービスやバックアップ機能、リストア機能、Active Directory連携機能、Systemwalker Desktop Patrol構成情報取り込み機能など、他にデータベースをアクセスするプログラムをすべて停止してから実行してください。

• データベース構築時のユーザーでログオンし、実行する必要があります。

  
  

注意事項

• V13.0.0以降からV14.2.0に変換する場合に使用できます(V12からの変換には使用できません)。

• データベースの変換を行う場合には、必ず移行前に、移行前のバージョンの機能を使用して管理情報、ログ情報のバックアップを行ってください。

  
  

使用例/実行結果/出力形式

【例.1】V14.2.0の管理サーバにおいて、移行前(V14.1.0)のデータベース環境のチェックを実施します。

C:\DTKDB\DBEnv>SWDTK_DBCV.exe 14.2 /CK
2011/06/21 12:00:11 Systemwalker Desktop Keeper DB移行処理・開始
2011/06/21 12:00:11 オプション:14.2
2011/06/21 12:00:11 オプション:CK
2011/06/21 12:00:11
2011/06/21 12:00:11 ■ DSI閉塞状態確認
2011/06/21 12:00:11
2011/06/21 12:00:11 チェック対象のDSI数  115件
2011/06/21 12:00:21 チェック完了、全てのDSIは正常です。
2011/06/21 12:00:21
2011/06/21 12:00:21 ■ 現在のデータベース空き容量のチェック
2011/06/21 12:00:21
2011/06/21 12:00:21 現在のデータベースの使用状況は以下となっています。
2011/06/21 12:00:21 データベースの総容量        : 2610176K
2011/06/21 12:00:21 最初に確保したテーブルの容量: 660531K
2011/06/21 12:00:21 追加で確保したテーブルの容量: 0K
2011/06/21 12:00:21 空き容量                    : 1949645K
2011/06/21 12:00:21
2011/06/21 12:00:21 ■ 移行処理に必要なデータベース空き容量のチェック
2011/06/21 12:00:21
2011/06/21 12:00:21 このシステムの場合、V14.2に移行する時の空き容量は 42386KB 必要です。
2011/06/21 12:00:21
2011/06/21 12:00:21 ■ 移行対象テーブル定義チェック
2011/06/21 12:00:21
2011/06/21 12:00:21 LEVELOBJECT                                       現在の項目数:160 (V14.1の定義)
2011/06/21 12:00:21 USERPOLICYINFO                                    現在の項目数: 96 (V14.1の定義)
2011/06/21 12:00:21 OBJECT_CONTROL                                    現在の項目数:  6 (V14.1の定義)
2011/06/21 12:00:21 LOGONUSER_CONTROL                                 現在の項目数:  6 (V14.1の定義)
2011/06/21 12:00:21 USBMASTER                                         現在の項目数: 23 (V14.1の定義)
2011/06/21 12:00:21 POLICYTABLE                                       現在の項目数: 25 (V14.1の定義)
2011/06/21 12:00:21 SESSIONMANAGE                                     テーブル未定義 (V14.1の定義)
2011/06/21 12:00:21 DTK_PRINTER_OBJECTMASTER                          テーブル未定義 (V14.1の定義)
2011/06/21 12:00:21 DTK_PRINTER_PRINTUSERMASTER                       テーブル未定義 (V14.1の定義)
2011/06/21 12:00:21 DTK_PRINTER_PAPERNUM_BASIC                        テーブル未定義 (V14.1の定義)
2011/06/21 12:00:21 PHYSICALNODELIST                                  現在の項目数:  6 (V14.1の定義)
2011/06/21 12:00:21 全ての移行対象テーブルが、V14.1の状態です。
2011/06/21 12:00:21
2011/06/21 12:00:21 正常終了しました。
2011/06/21 12:00:21 Systemwalker Desktop Keeper DB移行処理・終了

【例.2】V14.2.0の管理サーバにおいて、データベース環境を、V14.1.0からV14.2.0に移行します

C:\DTKDB\DBEnv>SWDTK_DBCV.exe 14.2 /GO
2011/06/30 09:25:35 Systemwalker Desktop Keeper DB移行処理・開始
2011/06/30 09:25:35 オプション:14.2
2011/06/30 09:25:35 オプション:GO
2011/06/30 09:25:36
2011/06/30 09:25:36 ■ DSI閉塞状態確認
2011/06/30 09:25:36
2011/06/30 09:25:36 チェック対象のDSI数  115件
2011/06/30 09:25:48 チェック完了、全てのDSIは正常です。
2011/06/30 09:25:48
2011/06/30 09:25:48 ■ 現在のデータベース空き容量のチェック
2011/06/30 09:25:48
2011/06/30 09:25:48 現在のデータベースの使用状況は以下となっています。
2011/06/30 09:25:48 データベースの総容量        : 2610176K
2011/06/30 09:25:48 最初に確保したテーブルの容量: 671273K
2011/06/30 09:25:48 追加で確保したテーブルの容量: 0K
2011/06/30 09:25:48 空き容量                    : 1938903K
2011/06/30 09:25:48
2011/06/30 09:25:48 ■ 移行処理に必要なデータベース空き容量のチェック
2011/06/30 09:25:48
2011/06/30 09:25:48 このシステムの場合、V14.2に移行する時の空き容量は 49216KB 必要です。
2011/06/30 09:25:48
2011/06/30 09:25:48 ■ 移行対象テーブル定義チェック
2011/06/30 09:25:48
2011/06/30 09:25:48 LEVELOBJECT                                       現在の項目数:160 (V14.1の定義)
2011/06/30 09:25:48 USERPOLICYINFO                                    現在の項目数: 96 (V14.1の定義)
2011/06/30 09:25:48 OBJECT_CONTROL                                    現在の項目数:  6 (V14.1の定義)
2011/06/30 09:25:48 LOGONUSER_CONTROL                                 現在の項目数:  6 (V14.1の定義)
2011/06/30 09:25:48 USBMASTER                                         現在の項目数: 23 (V14.1の定義)
2011/06/30 09:25:48 POLICYTABLE                                       現在の項目数: 25 (V14.1の定義)
2011/06/30 09:25:48 SESSIONMANAGE                                     テーブル未定義 (V14.1の定義)
2011/06/30 09:25:48 DTK_PRINTER_OBJECTMASTER                          テーブル未定義 (V14.1の定義)
2011/06/30 09:25:48 DTK_PRINTER_PRINTUSERMASTER                       テーブル未定義 (V14.1の定義)
2011/06/30 09:25:48 DTK_PRINTER_PAPERNUM_BASIC                        テーブル未定義 (V14.1の定義)
2011/06/30 09:25:48 PHYSICALNODELIST                                  現在の項目数:  6 (V14.1の定義)
2011/06/30 09:25:48 全ての移行対象テーブルが、V14.1の状態です。
2011/06/30 09:25:48
2011/06/30 09:25:48 ■ 移行処理実施
2011/06/30 09:25:48
2011/06/30 09:25:48   ○  不完全なテーブルの削除
2011/06/30 09:25:48       該当なし
2011/06/30 09:25:49
2011/06/30 09:25:49   ○  新規テーブルの定義体作成
2011/06/30 09:25:49       SESSIONMANAGE                  (成功)
2011/06/30 09:25:49       DTK_PRINTER_OBJECTMASTER       (成功)
2011/06/30 09:25:49       DTK_PRINTER_PRINTUSERMASTER    (成功)
2011/06/30 09:25:49       DTK_PRINTER_PAPERNUM_BASIC     (成功)
2011/06/30 09:25:49       USBMASTER                      (成功)
2011/06/30 09:25:49       POLICYTABLE                    (成功)
2011/06/30 09:25:49
2011/06/30 09:25:49   ○  テーブルの項目追加
2011/06/30 09:25:58       LEVELOBJECT                    (成功)
2011/06/30 09:25:59       USERPOLICYINFO                 (成功)
2011/06/30 09:25:59       OBJECT_CONTROL                 (成功)
2011/06/30 09:26:00       LOGONUSER_CONTROL              (成功)
2011/06/30 09:26:00       USBMASTER                      (成功)
2011/06/30 09:26:01       PHYSICALNODELIST               (成功)
2011/06/30 09:26:03
2011/06/30 09:26:03   ○  新規テーブルの定義
2011/06/30 09:26:05       SESSIONMANAGE                  (成功)
2011/06/30 09:26:06       DTK_PRINTER_OBJECTMASTER       (成功)
2011/06/30 09:26:07       DTK_PRINTER_PRINTUSERMASTER    (成功)
2011/06/30 09:26:08       DTK_PRINTER_PAPERNUM_BASIC     (成功)
2011/06/30 09:26:08
2011/06/30 09:26:08   ○  データ追加
2011/06/30 09:26:09       EXCLUSIONCONTROL               (成功)
2011/06/30 09:26:09       DOMAINSETTINGS                 (成功)
2011/06/30 09:26:09       SETTINGS                       (成功)
2011/06/30 09:26:09       USERINFO                       (成功)
2011/06/30 09:26:09
2011/06/30 09:26:09   ○  SETTINGSテーブルにDBSTRUCTUREの値を更新する
2011/06/30 09:26:10       LEVELOBJECT                    (成功)
2011/06/30 09:26:10       USERPOLICYINFO                 (成功)
2011/06/30 09:26:10       SETTINGS                       (成功)
2011/06/30 09:26:10
2011/06/30 09:26:10 正常終了しました。
2011/06/30 09:26:10 Systemwalker Desktop Keeper DB移行処理・終了

【例.3】V14.2.0の管理サーバにおいて、データベース環境のV14.1.0からV14.2.0への移行に一度失敗し、移行を再実行します。

C:\DTKDB\DBEnv>SWDTK_DBCV.exe 14.2 /EX
2011/06/29 09:13:59 Systemwalker Desktop Keeper DB移行処理・開始
2011/06/29 09:13:59 オプション:14.2
2011/06/29 09:13:59 オプション:EX
2011/06/29 09:13:59
2011/06/29 09:13:59 ■ DSI閉塞状態確認
2011/06/29 09:13:59
2011/06/29 09:13:59 チェック対象のDSI数  129件
2011/06/29 09:14:06 USBMASTER_IX2DSI                                  :異常  DSIが定義されていません
2011/06/29 09:14:06 USBMASTER_IX3DSI                                  :異常  DSIが定義されていません
2011/06/29 09:14:07 SESSIONMANAGE_DSI                                 :異常  DSIが定義されていません
2011/06/29 09:14:07 SESSIONMANAGE_IXPDSI                              :異常  DSIが定義されていません
2011/06/29 09:14:07 SESSIONMANAGE_IX2DSI                              :異常  DSIが定義されていません
2011/06/29 09:14:07 SESSIONMANAGE_IX3DSI                              :異常  DSIが定義されていません
2011/06/29 09:14:07 DTK_PRINTER_OBJECTMASTER_DSI                      :異常  DSIが定義されていません
2011/06/29 09:14:07 DTK_PRINTER_OBJECTMASTER_IXPDSI                   :異常  DSIが定義されていません
2011/06/29 09:14:07 DTK_PRINTER_PRINTUSERMASTER_DSI                   :異常  DSIが定義されていません
2011/06/29 09:14:07 DTK_PRINTER_PRINTUSERMASTER_IXPDSI                :異常  DSIが定義されていません
2011/06/29 09:14:07 DTK_PRINTER_PAPERNUM_BASIC_DSI                    :異常  DSIが定義されていません
2011/06/29 09:14:07 DTK_PRINTER_PAPERNUM_BASIC_IXPDSI                 :異常  DSIが定義されていません
2011/06/29 09:14:07 DTK_PRINTER_PAPERNUM_BASIC_IX1DSI                 :異常  DSIが定義されていません
2011/06/29 09:14:07 POLICYTABLE_IX2DSI                                :異常  DSIが定義されていません
2011/06/29 09:14:07 チェック完了、異常なDSIが  14件あります。
2011/06/29 09:14:07
2011/06/29 09:14:07 ■ 現在のデータベース空き容量のチェック
2011/06/29 09:14:07
2011/06/29 09:14:07 現在のデータベースの使用状況は以下となっています。
2011/06/29 09:14:07 データベースの総容量        : 2610176K
2011/06/29 09:14:07 最初に確保したテーブルの容量: 671273K
2011/06/29 09:14:07 追加で確保したテーブルの容量: 0K
2011/06/29 09:14:07 空き容量                    : 1938903K
2011/06/29 09:14:07
2011/06/29 09:14:07 ■ 移行対象テーブル定義チェック
2011/06/29 09:14:07
2011/06/29 09:14:07 LEVELOBJECT                                       現在の項目数:217 (V14.2の定義)
2011/06/29 09:14:07 USERPOLICYINFO                                    現在の項目数: 96 (V14.1の定義)
2011/06/29 09:14:07 OBJECT_CONTROL                                    現在の項目数:  6 (V14.1の定義)
2011/06/29 09:14:07 LOGONUSER_CONTROL                                 現在の項目数:  6 (V14.1の定義)
2011/06/29 09:14:07 USBMASTER                                         現在の項目数: 23 (V14.1の定義)
2011/06/29 09:14:07 POLICYTABLE                                       現在の項目数: 25 (V14.2の定義)
2011/06/29 09:14:07 POLICYTABLE_DSI                                   DSI定義済 (V14.2の定義)
2011/06/29 09:14:07 POLICYTABLE_IXPDSI                                DSI定義済 (V14.2の定義)
2011/06/29 09:14:07 POLICYTABLE_IX2DSI                                エラー。DSIが定義されていません
2011/06/29 09:14:07 SESSIONMANAGE                                     エラー。テーブルが定義されていません
2011/06/29 09:14:07 DTK_PRINTER_OBJECTMASTER                          エラー。テーブルが定義されていません
2011/06/29 09:14:07 DTK_PRINTER_PRINTUSERMASTER                       エラー。テーブルが定義されていません
2011/06/29 09:14:07 DTK_PRINTER_PAPERNUM_BASIC                        エラー。テーブルが定義されていません
2011/06/29 09:14:07 PHYSICALNODELIST                                  現在の項目数:  6 (V14.1の定義)
2011/06/29 09:14:07 前回、移行処理途中で終了しています。
2011/06/29 09:14:07
2011/06/29 09:14:07 ■ 移行処理実施
2011/06/29 09:14:07
2011/06/29 09:14:07   ○  不完全なテーブルの削除
2011/06/29 09:14:07       該当なし
2011/06/29 09:14:08
2011/06/29 09:14:08   ○  新規テーブルの定義体作成
2011/06/29 09:14:08       SESSIONMANAGE                  (成功)
2011/06/29 09:14:08       DTK_PRINTER_OBJECTMASTER       (成功)
2011/06/29 09:14:08       DTK_PRINTER_PRINTUSERMASTER    (成功)
2011/06/29 09:14:08       DTK_PRINTER_PAPERNUM_BASIC     (成功)
2011/06/29 09:14:08       USBMASTER                      (成功)
2011/06/29 09:14:08       POLICYTABLE                    (成功)
2011/06/29 09:14:08
2011/06/29 09:14:08   ○  テーブルの項目追加
2011/06/29 09:14:08       LEVELOBJECT                    (成功)
2011/06/29 09:14:08       USERPOLICYINFO                 (成功)
2011/06/29 09:14:09       OBJECT_CONTROL                 (成功)
2011/06/29 09:14:09       LOGONUSER_CONTROL              (成功)
2011/06/29 09:14:09       USBMASTER                      (成功)
2011/06/29 09:14:09       PHYSICALNODELIST               (成功)
2011/06/29 09:14:10
2011/06/29 09:14:10   ○  新規テーブルの定義
2011/06/29 09:14:11       SESSIONMANAGE                  (成功)
2011/06/29 09:14:12       DTK_PRINTER_OBJECTMASTER       (成功)
2011/06/29 09:14:12       DTK_PRINTER_PRINTUSERMASTER    (成功)
2011/06/29 09:14:13       DTK_PRINTER_PAPERNUM_BASIC     (成功)
2011/06/29 09:14:13
2011/06/29 09:14:13   ○  データ追加
2011/06/29 09:14:13       EXCLUSIONCONTROL               (成功)
2011/06/29 09:14:13       DOMAINSETTINGS                 (成功)
2011/06/29 09:14:14       SETTINGS                       (成功)
2011/06/29 09:14:14       USERINFO                       (成功)
2011/06/29 09:14:14
2011/06/29 09:14:14   ○  SETTINGSテーブルにDBSTRUCTUREの値を更新する
2011/06/29 09:14:14       LEVELOBJECT                    (成功)
2011/06/29 09:14:14       USERPOLICYINFO                 (成功)
2011/06/29 09:14:14       SETTINGS                       (成功)
2011/06/29 09:14:14
2011/06/29 09:14:14 正常終了しました。
2011/06/29 09:14:14 Systemwalker Desktop Keeper DB移行処理・終了