导出 ALM/QC 项目

此部分说明如何将项目从 ALM/QC 导出到文件。

概述

在导出 ALM/QC 项目之前考虑以下事项:

  • 每个 ALM/QC 项目都由数据库架构和文件存储库文件夹组成。

  • 您可以将项目导出为 .qcp 格式的压缩文件，或者将项目导出为两个单独的文件，一个用于数据库架构转储或备份，另一个用于文件存储库。

  • 导出的文件将上传到专用的 AWS S3 存储桶。存储桶的位置和凭据将在迁移过程中提供。

返回页首

先决条件

在导出 ALM/QC 项目之前确保以下内容:

您的项目中没有签出实体 如果您的项目启用版本控制，请确保您的项目中没有签出实体。无法升级具有签出实体的项目。如果在升级过程中发现任何签出，请取消签出以继续。
数据库架构和文件存储库已同步 项目的数据库架构和文件存储库保持一致。最佳做法是在导出项目之前停用项目。
S3 浏览器客户端 用于访问 AWS S3 存储桶。
直接访问 ALM/QC 数据库 确保您有权直接访问 ALM/QC 数据库。
FTP 客户端 例如，如果将使用 FTP，则为 Windows FTP 命令行客户端，或最好为 FileZilla FTP 客户端。
MD5 软件

例如，md5。

如果上传后文件大小相同，则这是可选的。
ZIP 软件 例如，7-zip。
ALM/QC 实例的备份 确保对 ALM/QC 实例进行完整备份。
要导出的项目中的正常性检查

在要导出的项目中运行正常性检查:

  1. 打开 ALM 站点管理。

  2. 右键单击项目，并选择“维护项目”>“验证项目”。

  3. 如果出现错误，请通过运行“修复项目”工具来修复它。

    要运行该工具，请右键单击项目并选择“维护项目”>“修复项目”。

    如果错误无法修复，请与您的站点管理员联系。

返回页首

将项目导出到 .qcp 文件

建议将项目导出到 .qcp 文件。该文件包含数据库架构和文件存储库。如果数据库类型为 SQL Server，则此方法速度较快。

备注: 对于 ALM 12.53 及更早版本，项目大小限制为 2 GB。对于 ALM 12.55 及更高版本，没有大小限制。如果您的项目大于 2 GB，请参阅将项目导出到单独的文件。

要将项目导出到 .qcp 文件，请执行以下操作:

从站点管理手动导出 请参阅导出项目。
将自行开发的工具与 ALM REST API 一起使用

请参阅 ALM REST API。

注: 此 API 在 ALM 15.00 及更高版本中可用。

返回页首

将项目导出到单独的文件

如果您的项目大于 2 GB 的大小限制，您可以将项目数据库架构和文件存储库导出到单独的文件中。

要导出数据库架构，请执行以下操作:

  1. 以数据库用户身份连接到 Oracle 数据库服务器。

  2. 运行以下命令获取每个 .dmp 文件的架构列表、表空间和大小。

    将 'SCHEMA1'、'SCHEMA2' 和 'SCHEMA3' 替换为每个转储文件的真实源架构列表。保持架构名称大写。

    Copy code 
    set pagesize 200 
    set linesize 200 
    set col Size_MB format 9999.999 
    select owner schema_name, tablespace_name, SUM(BYTES)/1024/1024 Size_MB 
    from dba_segments 
    where owner in ('SCHEMA1','SCHEMA2','SCHEMA3') 
    group by owner, tablespace_name 
    order by 1 desc; 

  3. 为要导出的每个架构运行以下命令之一:

    Copy code 
    expdp system/<密码> schemas=<schema name> dumpfile=<架构名称>_<日期>.dmp 
    logfile=<架构名称>_<日期>.log exclude=statistics directory=DATA_PUMP_DIR

    或

    Copy code 
    expdp system/<密码> schemas=<schema name> dumpfile=<架构名称>_<日期>.dmp 
    logfile=<架构名称>_<日期>.log exclude=statistics directory=DATA_PUMP_DIR

    例如，如果要导出 PROJECT_WORK 架构，请运行以下命令:

    Copy code 
    expdp dumpfile=PROJECT_WORK.dmp logfile=expdp_PROJECT_WORK.log 
    schemas=PROJECT_WORK EXCLUDE=OBJECT_GRANT EXCLUDE=PASSWORD_HISTORY

  4. 以系统用户身份连接到数据库。

    例如，sqlplus system/<密码>

  5. 运行以下选择命令以找到数据抽取目录:

    Copy code 
    SELECT directory_path FROM dba_directories WHERE directory_name = 'DATA_PUMP_DIR'; 

  6. 切换到数据抽取目录，您将看到目录中的所有转储文件。

  7. 压缩导出的转储文件，并将压缩文件与对应的日志文件一起上传。

    例如，

    Copy code 
    PROJECT_WORK.dmp.gz 
    Copy code 
    expdp_PROJECT_WORK.log

  8. (可选) 运行 md5 求和以进行大小检查。

    1. 打开命令窗口。

    2. 转到解压缩 md5.zip 的目录。

    3. 运行以下命令:

      Copy code 
      md5.exe -generate <压缩文件夹路径><压缩文件夹名称.zip>

      运行命令后，您会得到一行。例如，24BCED0C939DD7E61C6E4CCE252687BE db_schemas.zip

    4. 将输出复制到文本文件。

    5. 将以下文件上传到 AWS S3 存储桶:

      • <Db_schemas>.zip

      • <Db_schemas_md5>.txt

  1. 在 SQL Server 数据库中，通过以下选项之一备份数据库架构:

    • 通过运行以下命令备份每个数据库架构:

      Copy code 
      Backup database X to disk='<path>' 

    • 通过运行以下命令分离数据库:

      Copy code 
      Sp_detach_db 'database name'

  2. 压缩数据库架构备份。

  3. (可选) 运行 md5 求和以进行大小检查。

    1. 打开命令窗口。

    2. 转到解压缩 md5.zip 的目录。

    3. 运行以下命令:

      Copy code 
      md5.exe -generate <压缩文件夹路径><压缩文件夹名称.zip>

      运行命令后，您会得到一行。例如，24BCED0C939DD7E61C6E4CCE252687BE db_schemas.zip

    4. 将输出复制到文本文件。

    5. 将以下文件上传到 AWS S3 存储桶:

      • <Db_schemas>.zip

      • <Db_schemas_md5>.txt

要导出文件存储库，请执行以下操作:

  1. 打开 ALM 站点管理。

  2. 选择要迁移的项目。在“项目详细信息”选项卡的“项目目录”字段下，找到项目的文件存储库路径。

  3. 连接到应用程序服务器，导航到项目目录路径，然后压缩整个文件存储库文件夹。

  4. 运行 md5 求和。

    1. 打开命令窗口，导航到解压缩 md5.zip 文件的位置，然后运行以下命令:

      Copy code 
      md5.exe -generate <压缩文件夹路径><压缩文件夹名称.zip>

      例如，

      Copy code 
      md5.exe – generate C:\”Documents and Settings”\Desktop\ project1_filereposiotry.zip

      该命令返回 md5sum 输出。例如，24BCED0C939DD7E61C6E4CCE252687BE project1_filereposiotry.zip

    2. 将输出复制到文本文件。

    3. 将以下文件上传到 AWS S3 存储桶:

      • <project_filereposiotry>.zip

      • <project_filereposiotry_md5>.txt

  5. 对要迁移的每个项目重复上述步骤。

  6. 以 .zip 格式压缩每个项目的文件夹，将文件上传到 AWS S3 存储桶。

返回页首

摘要

完成项目导出后，所有项目数据都保存在以下文件中:

数据库

  • Oracle

    • 包含架构列表、表空间和每个 .dmp 文件大小的单个文件。

    • 压缩格式的所有架构转储文件。

    • 导出的所有日志文件。

  • MS SQL Server

    • 所有 .bak 文件。
存储库 压缩格式的所有文件存储库。

返回页首

另请参见：