将现有修订版本迁移至文件保管库
您可以从 PTC RV&S 数据库中提取符合条件的修订版本,并在单次批量操作中将这些修订版本移至配置管理文件保管库中。符合条件的修订版本包括:
• 二进制存档的修订版本
• 文本存档的修订版本 (存档的存储格式设置为“按参考存储”)
将修订版本从数据库迁移至保管库时,修订版本的存储位置仅由规范存档位置决定。请考虑以下示例:
项目 A 配置为在文件保管库中存储修订版本。项目 B 配置为在数据库中存储修订版本。项目 A 中一个的子项目被共享至项目 B 作为共享子项目。
由于共享子项目的规范位置位于项目 A 的层次结构中,因此该共享子项目成员的规范存档位置也位于项目 A 下。所以,共享子项目的修订版本存储在文件保管库中。
将现有修订版本迁移至文件保管库
要在 CLI 中将现有修订版本迁移至文件保管库中:
|
|
管理员需要 AdminServer 权限才可将现有修订版本迁移至文件保管库。
|
|
|
这个一次性的可选迁移步骤并非双向,执行时可能会影响系统性能。将 PTC RV&S 修订版本存储到配置管理文件保管库后,就无法再将其移回数据库。
PTC 建议您在开始迁移之前备份数据。
|
1. 确保文件保管库已正确配置,并且文件保管库目录存在于
PTC RV&S 的服务器文件系统中。有关详细信息,请参阅
配置文件保管库。
2. 运行文件保管库迁移命令,将存储库中所有符合条件的修订版本迁移至文件保管库: si diag --diag="migrateRevisionsFromDBToFileVaultAsPerPolicy"。
migrateRevisionsFromDBToFileVaultAsPerPolicy 诊断命令的选项如下:
• path 用于指定要迁移至文件保管库的配置管理项目路径。如果指定此参数,则仅迁移指定项目路径中符合条件的修订版本。您可以使用此参数仅指定单个项目。如果未指定此参数,则所有符合条件的配置管理项目都在迁移的考虑范围内。
|
|
对于此路径参数中指定的项目,必须已设置“使用文件保管库进行存储 (按参考成员修订版本)”配置管理策略。如果在项目级别禁用该策略,则不会迁移项目中符合条件的修订版本。有关设置配置管理策略的详细信息,请参阅主题“要设置常规策略”。
必须将此参数中的项目路径指定为项目的规范路径。例如,要迁移位置为 ProjectDirectory/demoMigrate/project.pj 的 demoMigrate 项目,请在 CLI 中排除 /project.pj,在命令语法中仅指定规范项目路径。有关使用规范路径指定项目的详细信息,请参阅 CLI 手册页。
|
• count 用于指定要处理并迁移至文件保管库的最大存档数目。迁移操作会尝试移动存档的所有修订版本,迁移过程中最旧的修订版本优先级最高。
• before 用于指定服务器日期和时间,不迁移此时间之后的修订版本。
例如,要将存储库中 100 个最旧的 demoMigrate 修订版本迁移至文件保管库,请运行以下命令:
si diag --diag="migrateRevisionsFromDBToFileVaultAsPerPolicy"
--param=path="/demoMigrate" --param=count=100
要迁移创建时间戳在 2015 年 1 月 1 日 中午之前的所有 demoMigrate 修订版本,请运行以下命令:
si diag --diag="migrateRevisionsFromDBToFileVaultAsPerPolicy"
--param=path="/demoMigrate" --param=before="2015/01/01 12:00:00"
|
|
如果未指定任何参数,则系统中所有符合条件的修订版本都会从数据库永久迁移至文件保管库。
|
运行迁移命令后,迁移摘要显示如下:
--------Archives Statistics--------
Migrated= , Skipped=
--------Revision Statistics--------
Migrated= , Failed= , Skipped=
包括修订版本统计信息在内的其他详细信息记录至位于 PTCRV&SServerinstalldir/log 下的 DB_to_FileVault_Migration.log 文件中。
将较旧的修订版本迁移至文件保管库
您可以从数据库中移出较旧的修订版本,同时在数据库中保留新的修订版本。此特殊配置模式需要将文件保管库特性保持为禁用状态,并配置一个有效的文件保管库位置。然后再运行迁移,将符合条件的修订版本迁移至保管库。所有新创建的修订版本均存储在数据库中。
要仅将旧修订版本迁移至文件保管库:
1. 停止 PTC RV&S 服务器。
2. 在 PTCRV&SServerinstalldir/config/properties 下的 si.properties 文件中,使用 si.vault.location= 指定保管库位置,并以此内容确认保管库支持已被禁用:si.vault.enable=false。
3. 启动 PTC RV&S
服务器。
4. 在 PTC RV&S 管理客户端 中,为全局或某一特定项目启用“使用文件保管库进行存储 (按参考成员修订版本)”配置管理策略。
5. 运行文件保管库迁移命令 si diag migrateRevisionsFromDBToFileVaultAsPerPolicy。若要存储特定项目,可包括 path 选项,您还可以根据需要包括其他受支持的选项,如 before 选项。
将旧修订版本迁移至文件保管库后,如果您不打算继续迁移其他修订版本,则可移除“使用文件保管库进行存储 (按参考成员修订版本)”策略。
|
|
若要在文件保管库已启用的情况下迁移较旧的修订版本数据,请暂时禁用文件保管库,并为要存储的项目启用“使用文件保管库进行存储 (按参考成员修订版本)”策略。然后,请为该项目运行迁移命令。迁移完成后,移除该策略,并重新启用文件保管库以恢复新修订版本的存储。
|
|
|
要回收先前被迁移至文件保管库的数据所占用的空间,需要进行数据库收缩。如需更多帮助,请联系您的数据库管理员。
|
相关主题