GeneXus Server Storage Migrator Utility は、GeneXus Server インスタンス間でナレッジベースを移行するためのコマンドラインツールです。移行には、ナレッジベースに関連するすべてのアクティビティが含まれます。つまり、移行元のナレッジベースで行われたすべてのコミット、更新、変更適用に関するあらゆる情報が対象になります。
ファイル名は
gxssm.exe で、次のディレクトリーにあります:
C:\<GeneXus Server のインストールパス>\VDir\Bin
注: このツールは、
GeneXus Server の SQL 設定がローカルかリモートかに関係なく利用できます。
推奨事項: コマンドプロンプトは管理者権限で実行してください ( [ 管理者として実行 ] )。
/h パラメーターを指定してユーティリティを実行すると、ヘルプが表示されます:
C:\<GeneXus Server のインストールパス>\VDir\Bin>gxssm.exe /h
gxssm v15.0.3.109723
Input:/h
gxssm.exe v11.0.0.0
Copyright © 1988-2016 GeneXus.All Rights Reserved
Usage: gxssm.exe [ @argfile ] [ /DataFilesLocation|d:<値> ]
[ /SQLDataAbsolutePath|sa:<値> ] [ /ExitOnError|error ] [ /Version1|v1 ]
[ /KBAlias|kb:<値> ] [ /Clean|c ] [ /Export|e ] [ /JustJSon|j ] [ /Import|i:<値> ]
[ /IgnoreGAM:<値> ] [ /BCPExport:<値> ] [ /OutputPath|out:<値> ]
[ /<DataFilesLocation>:<値> ]
[ /<SQLDataAbsolutePath>:<値> ] [ /help|?|h ] [ /version|v ]
| @argfile |
ファイルから引数を読み取ります。 |
| /DataFilesLocation:<値> |
データファイルの取得元/保存先となるディレクトリー (ローカルまたはネットワーク共有) のフルパスです。 |
| /SQLDataAbsolutePath:<値> |
データベース接続のために SQL Server によって認識されるフルパスです。 |
| /ExitOnError |
最初にエラーが発生したときにプログラムを終了します。 |
| /Version1 |
v1 を強制的に再編成します。 |
| /KBAlias:<値> |
移行対象のナレッジベースです。 |
| /Clean |
テーブルの既存のデータをすべて削除します。 |
| /Export |
ナレッジベースと、関連するすべての GXserver データをエクスポートします。 |
| /JustJSon |
GAM データベースから JSON ファイルのみをエクスポートします。 |
| /Import:<値> |
ナレッジベースが格納されたエクスポート済み zip ファイルのパスです (ディレクトリーの場合、ナレッジベースが格納されたすべての zip ファイルがエクスポートされます)。 |
| /IgnoreGAM:<値> |
エクスポートまたはインポート時に、GeneXus Access Manager データを無視するように指示します (既定値は False です)。 |
| /BCPExport:<値> |
エクスポート時に、MDF ファイルをコピーするのではなく、BCP を通じてエクスポートするように指示します。これは、リモート SQL Server を使用している場合に役立ちます(GeneXus 15 Upgrade 9 以上では既定値は True です)。 |
| /OutputPath:<値> |
生成された出力ファイルの保存先ディレクトリーのフルパスです。 |
| /help |
使用方法を表示します。 |
| /version |
バージョンを表示します。 |
| /BatchImport |
多数の zip が含まれているインポートフォルダを指定します。 |
| /verbose |
インポートコマンドの実行時に JSON で全出力を表示します。 |
| /ReplicateKBActivity |
ナレッジベースのアクティビティを複製します。 |
| /RunKbConversions |
GeneXus Server でホストされているナレッジベースの変換を実行します。 |
このオプションでは、ナレッジベースに関するすべての情報を格納した zip ファイルが生成されます。
ナレッジベースをエクスポートするには、
/e、
/kb、および
/out パラメーターを使用します。コマンド全体は次のようになります:
C:\<GeneXus Server のインストールパス>\VDir\Bin>gxssm.exe /e /kb:"<ナレッジベース名>" /out:"C:\<エクスポート先のパス>"
入力値の説明
- /e は、エクスポート操作であることを示します。
- /kb:"<ナレッジベース名>" は、エクスポートするナレッジベースの名前を示します。
- /out:"C:\<エクスポート先のパス>" は、zip ファイルの保存先のパスを示します。
注: エクスポート処理中は、サーバーのナレッジベースのデータベースはオフラインになり、処理が完了したら再びオンラインになります。
使用例
C:\GeneXusServer15\VDir\Bin\gxssm.exe /e /kb:"TravelAgency" /out:"C:\Export"
gxssm v15.0.3.109723
Input:/e /kb:TravelAgency /out:C:\Export
=== Section Exporting GAM data started ===
Parameters OK.
============ Export of data started ============
SysPar export OK.
* 2 record(s) exported from Table SysPar
Browser export OK.
* 0 record(s) exported from Table Browser
AuditoryAction export OK.
* 0 record(s) exported from Table AuditoryAction
OperatingSystem export OK.
* 0 record(s) exported from Table OperatingSystem
Repository export OK.
* 1 record(s) exported from Table Repository
RepositoryConnection export OK.
* 1 record(s) exported from Table RepositoryConnection
RepositoryCountry export OK.
* 0 record(s) exported from Table RepositoryCountry
AuthenticationType export OK.
* 2 record(s) exported from Table AuthenticationType
SecurityPolicy export OK.
* 1 record(s) exported from Table SecurityPolicy
Application export OK.
* 1 record(s) exported from Table Application
AppEnvironment export OK.
* 0 record(s) exported from Table AppEnvironment
AppPrmTokenType export OK.
* 0 record(s) exported from Table AppPrmTokenType
AppRole export OK.
* 0 record(s) exported from Table AppRole
AppMenu export OK.
* 0 record(s) exported from Table AppMenu
AppPermission export OK.
* 0 record(s) exported from Table AppPermission
AppPrmMemPrm export OK.
* 0 record(s) exported from Table AppPrmMemPrm
RoleAppPrm export OK.
* 0 record(s) exported from Table RoleAppPrm
UserMemRoles export OK.
* 0 record(s) exported from Table UserMemRole
UserMemAppRole export OK.
* 0 record(s) exported from Table UserMemAppRole
UserAppPrm export OK.
* 0 record(s) exported from Table UserAppPrm
UserMemRoles export OK.
* 1 record(s) exported from Table UserMemRole
UserMemAppRole export OK.
* 1 record(s) exported from Table UserMemAppRole
UserAppPrm export OK.
* 1 record(s) exported from Table UserAppPrm
User export OK.
* 2 record(s) exported from Table User
UserRepository export OK.
* 2 record(s) exported from Table UserRepository
RepositoryQuestionUser export OK.
* 2 record(s) exported from Table RepositoryQuestionUser
Role export OK.
* 4 record(s) exported from Table Role
RoleMemRole export OK.
* 0 record(s) exported from Table RoleMemRole
Country export OK.
* 5 record(s) exported from Table Country
City export OK.
* 8 record(s) exported from Table City
Attraction export OK.
* 15 record(s) exported from Table Attraction
============ Export of data ended ============
>>> Success
=== Section Exporting GAM data ended successfully ===
Taking DB 'GXS_TravelAgency_1600b0cd-d835-49ca-9b70-7317bff98681' offline...
Zipping files...
Bringing DB 'GXS_TravelAgency_1600b0cd-d835-49ca-9b70-7317bff98681' online...
KB 'TravelAgency' exported to 'C:\Export\TravelAgency.zip'
このオプションでは、エクスポート操作によって生成された zip ファイルの圧縮が解除されます。また、すべての情報が新しい GeneXus Server インスタンスにアタッチされます。
ナレッジベースをインポートするには、
/i および
/kb パラメーターを使用します。コマンド全体は次のようになります:
C:\<GeneXus Server のインストールパス>\VDir\Bin>gxssm.exe /i:"<zip ファイルのロケーション\ファイル.zip>" /kb:"<新しいナレッジベース名>"
入力値の説明
- /i は、インポート操作であることを示します。
- "<zip ファイルの場所\ファイル.zip>" は、zip ファイルのフルパスまたは相対パス、あるいはフォルダ名と zip ファイル名を示します。解凍ファイル、MDF と LDF、または MDF のみを含むフォルダも指定できます。
注: パスがフォルダパスに対応する場合、フォルダ内の全 zip ファイルを GeneXus Server インスタンスにインポートするには、パラメーター
/batchImport が必要です。
上記の例で、"C:\Export\TravelAgency.zip" ではなく "C:\Export" を使用した場合、"C:\Export" フォルダ内の (エクスポートオプションで生成された) 全 zip ファイルがインポートされます。
- /kb:"<新しいナレッジベース名>" は、新しい GeneXus Server インスタンスでのナレッジベースの名前を示します。
注: 移行先の GeneXus Server インスタンスに既に存在する名前を使用することはできません。
注: アクティビティの複製を防ぐには、パラメーター
/AvoidActivityReplication を追加します。
使用例
この例では、
/ignoregam: true パラメーターを使用して、セキュリティに関連するすべての情報 (ユーザー、グループ、権限など) の処理を回避しています。ただし、このコマンドはこのパラメーターなしでも実行できます。
C:\GeneXusServer15_2\VDir\Bin\gxssm.exe /i:"C:\Export\TravelAgency.zip" /kb:"TravelAgencyNewServer" /ignoregam:true
gxssm v15.0.3.109723
Input:/i:C:\Export\TravelAgency.zip /kb:TravelAgencyNewServer /ignoregam:true
=== Section Import KB started ===
Extracting file to tmp folder 'C:\Users\<ユーザー名>\AppData\Local\Temp\ATT201701021144'
Loading GeneXus Server defaults...
Renaming database files...
Attaching database...
Starting BL...
Processing Knowledgebase 'TravelAgencyNewServer' @ 'C:\GeneXusServer15\Catalog\TravelAgencyNewServer-7bc9c176-ac4d-4c71-bec4-465449b74c06'
Adding 'TravelAgencyNewServer' to the catalog table
Processing commits for version 'TravelAgency...'
3 commits were migrated.
Processing updates for version 'TravelAgency'
2 updates were migrated.
Processing checkouts for version 'TravelAgency'
4 checkouts were migrated.
Ignoring GAM data
Knowledge base 'TravelAgencyNewServer' saved at 'C:\GeneXusServer\Catalog\TravelAgencyNewServer-7bc9c176-ac4d-4c71-bec4-465449b74c06'
=== Section Import KB ended successfully ===
このオプションでは、ナレッジベースの全アクティビティが生成されます。
アクティビティを複製するには、
/ReplicateKBActivity および
/KBAlias パラメーターを使用します。コマンド全体は次のようになります:
C:\<GeneXus Server のインストールパス>\VDir\Bin>gxssm.exe /ReplicateKBActivity /KBAlias:"<ナレッジベース名>"
入力値の説明
- /ReplicateKBActivity は、実行する処理です。
- "<ナレッジベース名>" は、アクティビティを複製するナレッジベース名です。
注: ナレッジベースの 1 バージョンのアクティビティのみを複製するには、
/VersionName:"<バージョン名>" パラメーターを指定する必要があります。
使用例
C:\GeneXusServer15\VDir\Bin>gxssm.exe /replicatekbactivity /kbalias:TravelAgencyNewServer
gxssm v15.0.10.122440
Input:/replicatekbactivity /kbalias:TravelAgencyNewServer
=== Section Replicating Activity for KB 'TravelAgencyNewServer' started ===
Starting BL...
Generating publish activity...
Publish activity succesfully registered.
Processing commits for version 'TravelAgencyNewServer...'
3 commits were migrated successfully.
Processing updates for version 'TravelAgencyNewServer'
2 updates were migrated successfully.
Processing checkouts for version 'TravelAgencyNewServer'
0 checkouts were migrated successfully.
=== Section Replicating Activity for KB 'TravelAgencyNewServer' ended successfully ===
管理者として実行
管理者権限なしでこのツールをコマンドプロンプトで実行すると、エクスポートやインポートの処理が突然終了し、エラーになることがあります。この場合、次のエラーが表示されます:
...
=== Section Exporting GAM data ended successfully ===
Taking DB 'GXS dl portal d0128365-f2f1-448b-8c00-85097c5da3a5' offline...
Zipping files...
Bringing DB 'GXS dl portal d0128365-f2f1-448b-8c00-85097c5da3a5' online...
Error: Error exporting data
Error: Could not zip files
Error: en GenexusServer.StorageMigrator.Reorgs.Export.ExportKB(GXS KBCatalog kb)
en GenexusServer.StorageMigrator.Reorgs.Export.ExecuteOperation()
詳細については、「
SAC #3627」を参照してください。
アクセスが拒否される
Unable to open the physical file "C:\<GeneXus Server のインストールパス>\Catalog\<MDF ファイル名>.mdf" operating system 5: "5 (アクセスが拒否されました。)".
OR
Error: the database 'GXS_XXX' couldn`t be updated because it is read only
GeneXus Server で使用する SQL Server ユーザーまたは Windows ユーザーに、
Catalog ディレクトリー (ナレッジベースを格納する場所) に対するアクセス許可がない場合、インポート処理でこのエラーが発生することがあります。
この問題を解決するには、SQL Server 認証を使用している場合は
NETWORK SERVICE1 ユーザーに、それ以外の場合は Windows ユーザーに、
Catalog ディレクトリー (既定では GeneXus Server のインストールディレクトリー内に存在するディレクトリー) に対するフルコントロールのアクセス許可を与えます。このディレクトリーが存在しない場合は、ディレクトリーを作成して、NETWORK SERVICE ユーザーまたは Windows ユーザーにフルコントロールのアクセス許可を与えてください。
詳細については、「
SAC #34486」を参照してください。
注1: SQL Server を実行しているサービスアカウントは、 [ サービス ] を開いて [ SQL Server ] を探し、 [ ログオン ] 列で確認できます:
