• Seafile GC
    • 4.1.1 及之后的版本
      • Dry-run 模式
      • 删除垃圾数据块
      • 多线程模式GC
    • 3.1.2及之后版本
    • 3.1.2 及之前版本

    Seafile GC

    Seafile 利用存储去重技术来减少存储资源的利用。简单来说,这包含如下两层含义:

    • 不同版本的文件或许会共享一些数据块。
    • 不同的资料库也或许会共享一些数据块。
      运用这项技术之后,在你删除一个资料库时,会导致底层数据块不会被立即删除,因此 Seafile 服务器端没用的数据块将会增多。

    通过运行垃圾回收程序,可以清理无用的数据块,释放无用数据块所占用的存储空间。

    垃圾回收程序将会清理如下两种无用数据块:

    • 未被资料库所引用的数据块即数据块属于被删除的资料库。
    • 设置了历史长度限制的资料库的过期数据块。
      如果使用社区版服务器,运行垃圾回收程序之前,请先在服务器端停掉 Seafile 程序。这是因为垃圾回收程序,会错误的删除刚刚写入 Seafile 的新的数据块。对于专业版,3.1.11 及之后的版本,支持在线垃圾回收即如果使用 MySQL 或 PostgreSQL 数据库,你不需要暂停 Seafile 程序来进行垃圾回收。

    4.1.1 及之后的版本

    从社区版 4.1.1 和 专业版 4.1.0开始, 我们改善了垃圾回收的命令参数和执行结果输出。

    Dry-run 模式

    如果仅为了查看有多少垃圾可以回收而不进行删除操作,用 dry-run 选项:

    1. seaf-gc.sh --dry-run [repo-id1] [repo-id2] ...

    运行输出如下所示:

    1. [03/19/15 19:41:49] seafserv-gc.c(115): GC version 1 repo My Library(ffa57d93)
    2. [03/19/15 19:41:49] gc-core.c(394): GC started. Total block number is 265.
    3. [03/19/15 19:41:49] gc-core.c(75): GC index size is 1024 Byte.
    4. [03/19/15 19:41:49] gc-core.c(408): Populating index.
    5. [03/19/15 19:41:49] gc-core.c(262): Populating index for repo ffa57d93.
    6. [03/19/15 19:41:49] gc-core.c(308): Traversed 5 commits, 265 blocks.
    7. [03/19/15 19:41:49] gc-core.c(440): Scanning unused blocks.
    8. [03/19/15 19:41:49] gc-core.c(472): GC finished. 265 blocks total, about 265 reachable blocks, 0 blocks can be removed.
    9. [03/19/15 19:41:49] seafserv-gc.c(115): GC version 1 repo aa(f3d0a8d0)
    10. [03/19/15 19:41:49] gc-core.c(394): GC started. Total block number is 5.
    11. [03/19/15 19:41:49] gc-core.c(75): GC index size is 1024 Byte.
    12. [03/19/15 19:41:49] gc-core.c(408): Populating index.
    13. [03/19/15 19:41:49] gc-core.c(262): Populating index for repo f3d0a8d0.
    14. [03/19/15 19:41:49] gc-core.c(308): Traversed 8 commits, 5 blocks.
    15. [03/19/15 19:41:49] gc-core.c(264): Populating index for sub-repo 9217622a.
    16. [03/19/15 19:41:49] gc-core.c(308): Traversed 4 commits, 4 blocks.
    17. [03/19/15 19:41:49] gc-core.c(440): Scanning unused blocks.
    18. [03/19/15 19:41:49] gc-core.c(472): GC finished. 5 blocks total, about 9 reachable blocks, 0 blocks can be removed.
    19. [03/19/15 19:41:49] seafserv-gc.c(115): GC version 1 repo test2(e7d26d93)
    20. [03/19/15 19:41:49] gc-core.c(394): GC started. Total block number is 507.
    21. [03/19/15 19:41:49] gc-core.c(75): GC index size is 1024 Byte.
    22. [03/19/15 19:41:49] gc-core.c(408): Populating index.
    23. [03/19/15 19:41:49] gc-core.c(262): Populating index for repo e7d26d93.
    24. [03/19/15 19:41:49] gc-core.c(308): Traversed 577 commits, 507 blocks.
    25. [03/19/15 19:41:49] gc-core.c(440): Scanning unused blocks.
    26. [03/19/15 19:41:49] gc-core.c(472): GC finished. 507 blocks total, about 507 reachable blocks, 0 blocks can be removed.
    27. [03/19/15 19:41:50] seafserv-gc.c(124): === Repos deleted by users ===
    28. [03/19/15 19:41:50] seafserv-gc.c(145): === GC is finished ===
    29. [03/19/15 19:41:50] Following repos have blocks to be removed:
    30. repo-id1
    31. repo-id2
    32. repo-id3

    如果在参数中指定资料库 ID,则程序只检查指定的资料库,否则所有的资料库将会被检查。

    在程序输出的结尾,你会看到 "repos have blocks to be removed" 部分,这部分内容会列出含有可回收垃圾块的资料库的 ID,后续你可以运行程序不加 —dry-run 选项来回收这些资料库的垃圾数据块。

    删除垃圾数据块

    运行垃圾回收程序,不加 —dry-run 选项来删除垃圾数据块:

    1. seaf-gc.sh [repo-id1] [repo-id2] ...

    如果在参数中指定资料库 ID, 则程序只检查和删除指定的资料库。

    正如前面所说,有两种类型的垃圾数据块可被回收,有时仅删除第一类无用数据块(属于删除的资料库)便可达到回收的目的,这种情况下,垃圾回收程序将不会检查未被删除的资料库,加入 “-r” 选项便可实现这个功能:

    1. seaf-gc.sh -r

    Seafile 4.1.1 及之后的版本,被用户删除的资料库不会直接从系统中删除,它们会被转移到系统管理员界面的垃圾箱。垃圾箱中的资料库,只有在从垃圾箱中清除以后,它们的数据块才可被回收。

    多线程模式GC

    在专业版(Pro) 5.1.0 之后,您可以在GC中指定线程数。默认:

    • 如果存储后端是S3/Swift/Ceph,则启动10个线程进行GC工作。
    • 如果存储后端是文件系统,则只启动1个线程。
      您可以使用 "-t" 选项指定线程数。"-t" 选项可以与所有的其他选项一起使用。每个线程都会在一个资料库中执行GC。例如,以下命令将使用20个线程来GC所有库:
    1. seaf-gc.sh -t 20

    由于线程是并发的,每个线程的输出可能会互相混合。在每行输出中会打印库ID。

    3.1.2及之后版本

    运行垃圾回收程序

    1. ./seaf-gc.sh run

    程序结束之后,运行以下命令,检查是否误删了还在使用的数据块,如果误删,会显示警告信息。

    1. ./seaf-gc.sh verify

    可以通过 dry-run 选项,设置在运行垃圾回收程序前,进行完整性检查

    程序将会显示 所有的数据块数量将要被删除的数据块数量

    1. ./seaf-gc.sh dry-run

    如果资料库已损坏,因为无法判断数据块是否还在被其他资料库使用,所以垃圾回收程序将会停止运行。

    可以通过 force 选项,强制删除已损坏资料库的数据。通过将已损坏资料库的数据块标记为“未使用”,来将其删除。

    1. ./seaf-gc.sh force

    3.1.2 及之前版本

    运行垃圾回收程序

    1. cd seafile-server-{version}/seafile
    2. export LD_LIBRARY_PATH=./lib:${LD_LIBRARY_PATH}
    3. ./bin/seafserv-gc -c ../../ccnet -d ../../seafile-data

    如果你源码编译安装 Seafile 服务器,仅仅运行

    1. seafserv-gc -c ../../ccnet -d ../../seafile-data

    当垃圾回收程序结束后,你也可以检查是否一些有用的数据块被错误的删除:

    1. seafserv-gc -c ../../ccnet -d ../../seafile-data --verify

    如果一些有用的数据块丢失,它将会打印一些警告信息。

    如果你想在真正删除一些数据块之前,做一些常规检查,可以使用—dry-run选项

    1. seafserv-gc -c ../../ccnet -d ../../seafile-data --dry-run

    这将会向你展示数据块总数量和将被删除数据块数量。

    如果在服务器端一些库的元数据被毁坏,垃圾回收程序将会停止处理,因为它无法识别是否一个数据块被一些毁坏的资料库所使用。如果你不想保留毁坏库的数据块,可以运行垃圾回收程序并使用—ignore-errors或-i选项。

    1. seafserv-gc -c ../../ccnet -d ../../seafile-data --ignore-errors

    这将会屏蔽毁坏资料库的数据块为无用状态并删除掉它们。

    原文: https://manual-cn.seafile.com/maintain/seafile_gc.html