管理项目存储库

项目存储库 (位于 ProjRep 目录下) 由存储在文件系统中的物理文件和对文件进行索引的数据库表组成。您可以清理项目存储库，使用 FTP 客户端浏览和编辑项目存储库，以及重新调整项目存储库。

在本主题中︰

概述

此目录中的文件存储在允许最大存储空间的优化文件夹结构中。此外，具有相同内容的任何两个文件在 ProjRep 目录中仅存储一次。例如，如果将相同文件附加到多个记录，则该文件仅在项目存储库中存储一次。这将导致磁盘空间大幅减少、复制操作时间缩短。

将文件添加到实体时，系统会检查相同文件是否存在于项目存储库中。如果找到相同文件，则不会向此存储库添加任何物理文件。

从实体删除文件时，此文件不会从项目目录立即删除，因为它可能仍然由其他实体使用。

如果从在项目处于活动状态时执行的备份恢复项目，必须重新调整文件系统和数据库表。

返回页首

定义项目存储库清理

系统会定期对项目存储库进行扫描，以查找任何实体都不再引用的过时文件。如果文件在指定的时间段内保持未引用状态，则文件将从项目存储库中删除。

要调整项目存储库清理，请执行以下操作:

默认情况下，清理时间间隔设置为七天。您可以使用以下站点配置参数来调整项目存储库清理过程。

有关参数的详细信息，请参阅设置配置参数。

REPOSITORY_GC_PROJECT_CLEANUP_INTERVAL

定义每个项目存储库的清理过程之间的时间间隔。
REPOSITORY_GC_DELAY_CANDIDATE_TIME 定义一次扫描中检测到过时文件之后到删除过时文件之前经过的时间。
REPOSITORY_GC_JOB_PRIORITY 定义执行清理过程的速度。
SUSPEND_REPOSITORY_GC 使您能够停止项目存储库清理过程。

要加速或推迟项目存储库清理，请执行以下操作:

单击项目详细信息选项卡中的“优化存储库清理”以尽快清理项目的存储库。

单击“推迟存储库清理”以推迟清理，或停止正在进行的清理。

有关详细信息，请参阅查看和编辑项目详细信息。

返回页首

浏览和编辑项目存储库

使用 FTP 客户端可以在项目存储库中浏览和编辑文件。大多数支持 UTF-8 字符编码的标准 FTP 客户端都是兼容的。

通过 FTP 客户端编辑文件之前

在通过 FTP 客户端更改存储库文件之前，请了解以下内容。

受支持的 FTP 客户端

大多数支持 UTF-8 字符编码的标准 FTP 客户端都是兼容的。

已验证以下客户端：

  • Filezilla

  • Total Commander 内置 FTP 客户端

  • FlashFXP。
不要在 ProjRep 目录中直接进行更改 建议您不要在 ProjRep 目录中直接更改文件夹、文件或文件内容，否则会导致项目存储库的不可逆损坏。
删除文件

删除文件将导致实体中缺失内容。
重命名文件和文件夹

重命名文件夹和文件可能导致实体中缺失内容。

启用安全 FTP 连接

可以使用安全连接来连接到 FTP 服务器。

要启用安全 FTP 连接：

  1. 在服务器机器上，转到“<安装路径>\java\bin”并使用以下命令生成密钥库文件和密钥文件。

    请注意，client 和 changeit 仅用作示例。

    生成密钥库文件

    keytool -genkey -keyalg RSA -alias client -keystore client.keystore -storepass changeit -storetype jks

    生成密钥文件

    keytool -certreq -alias client -keyalg RSA -file client.csr -keystore client.keystore

  2. 创建 XML 文件，指定以下属性，并将 XML 文件保存为 sslkeystore.xml。

    • keystore file。密钥库文件的目录和文件名

    • password。您为密钥库定义的密码。

    • protocols。TSL/SSL 协议。

    • cipherSuites。TLS 连接使用的加密算法套件。

    例如：

    Copy code 
    <ssl>                          
       <keystore file="<keystore file path>" 
       password="<keystore password>"/>
       protocols="TLS1.3,TLS1.2" 
       cipherSuites="TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
    </ssl>

  3. 将 sslkeystore.xml 文件放在以下目录中：C:\ProgramData\Micro Focus\ALM\webapps\qcbin。

  4. 重新配置 FTP_PORT 站点参数。

  5. 通过重新启动服务来重新启动 FTP 服务器。

  6. 在 FTP 客户端中，选择 FTPS 或 SSL 选项。如果使用 FileZilla，则转到文件 > 站点管理器并单击新站点。对于“协议”，请选择“FTP - 文件传输协议”，而对于“加密”，则选择“要求隐式的 FTP over TLS”，并单击“连接”。

要浏览和编辑项目存储库，请执行以下操作:

  1. 定义 FTP_PORT 参数以在指定端口上启动 FTP 服务。

    有关详细信息，请参阅设置配置参数。

  2. 连接到 FTP 服务器。

    在 FTP 客户端中，使用以下连接值：

    字段

    值

    主机

    要连接的 OpenText Application Quality Management 服务器的名称或 IP。

    端口

    FTP 端口。这应当与用作 FTP_PORT 站点参数的值相同。

    用户

    OpenText Application Quality Management 站点管理员的用户名或 API 密钥。

    在 SSO 模式下，只能输入 API 密钥。

    密码

    如果在“用户”字段中使用用户名，请输入站点管理员的密码。

    如果在“用户”字段中使用 API 密钥，请输入站点管理员的 API 密钥。

  3. 浏览和编辑存储库文件。

    在连接到 FTP 服务之后，将显示站点域的列表。选择域，然后选择项目。FTP 客户端会显示项目存储库目录。

返回页首

重新调整存储库

如果在项目处于活动状态时创建项目的备份，数据库和文件系统备份之间的时间差可能会造成数据库文件索引和物理文件之间的差异。如果从备份中恢复项目，则必须重新调整文件系统和数据库表。

权限:

要重新调整存储库，您应该是站点管理员。

重新调整存储库之前

在重新调整存储库之前了解以下内容。

启用项目重新调整

要启用项目重新调整，请将 SHOW_REALIGNMENT 参数设置为 Y。

有关详细信息，请参阅设置配置参数。
重新调整过程

重新调整过程会执行以下操作:

  • 如果文件在数据库中进行索引，但没有位于文件系统中，则将从数据库中删除此文件的索引。

  • 如果文件存储在文件系统中，但未在数据库中进行索引，则将从文件系统中删除此文件。

  • 验证逻辑数据库表和物理数据库表之间的关系的完整性。
项目激活/停用

重新调整正在进行时停用项目，重新调整完成后再次激活项目。

要重新调整单个项目的存储库，请执行以下操作:

  1. 打开“站点管理”>“项目”选项卡。

  2. 从项目列表中选择项目，然后单击“维护项目”>“恢复工具”>“重新调整存储库”。

  3. 要运行重新调整过程而不进行任何用户干预，请选择“以静默模式运行”。

  4. 要启动该过程，请单击“重新调整项目”。

    如果项目仍处于活动状态，将提示您先停用它。

    运行过程时如果出错，将打开消息框。相应地单击“中止”或“重试”按钮。

    要中止验证过程，请单击“中止”并在确认对话框中单击“是”。

    要暂停验证过程，请单击“暂停”。要继续，请单击“继续”。

  5. 等到修复过程完成。

    要将修复日志导出到文本文件，请单击“导出日志”。

    要清除修复日志，请单击“清除日志”。

要重新调整域中所有或多个项目的存储库，请执行以下操作:

  1. 打开“站点管理”>“项目”选项卡。

  2. 从项目列表中选择目标域，然后单击“维护域”>“恢复工具”>“重新调整存储库”。

  3. 配置修复设置。

    重新调整模式

    选择以下选项：

    • 以静默模式运行。无任何用户交互的情况下运行过程。

    • 失败时继续下一个项目。如果过程失败，则继续下一个项目。这是默认选项。
    重新调整后

    选择以下选项之一：

    • 使所有项目保持停用状态。在过程完成后使所有项目保持停用状态。

    • 激活所有项目。在过程完成后，激活所有项目。

  4. 选择目标项目或单击“项目名称”列中的复选框以选择所有项目。

  5. 单击“重新调整存储库”。

    如果任何选定的项目仍处于活动状态，将提示您先停用它们。

    运行过程时如果出错，将打开消息框。相应地单击“中止”或“重试”按钮。

    要中止修复过程，请单击“中止”并在确认对话框中单击“是”。

    要暂停修复过程，请单击“暂停”。要继续，请单击“继续”。

  6. 等到修复过程完成。

    要将修复日志导出到文本文件，请单击“导出日志”。

    要清除修复日志，请单击“清除日志”。

返回页首

另请参阅：