文档

JindoCache CLI使用说明

更新时间:

本文为您介绍JindoCache相关命令。

前提条件

已完成JindoCache的配置,详情请参见JindoCache加速OSS透明缓存JindoCache加速OSS-HDFS透明缓存

用法汇总

您可以使用jindocache命令来查看支持的命令和用法。

listCacheSet

  • 功能说明:列出当前系统里所有的CacheSet信息。

  • 命令:

    jindocache -listCacheSet

refreshCacheSet

  • 功能说明:更新CacheSet策略,之前设定的但是在新的策略文件中不存在的CacheSet将被删除。

  • 命令:

    jindocache -refreshCacheSet <localPath>

    涉及以下参数。

    参数

    说明

    <localPath>

    cacheset.xml文件的路径。例如,/path/cacheset.xml。

    该路径是您创建cacheset.xml文件时指定的存储路径。

  • 示例:

    jindocache -refreshCacheSet /path/cacheset.xml

load

数据缓存命令,包括元数据缓存命令和数据缓存命令。命令格式为jindocache -load [-meta] [-data] [-s] [-m] [-R] [-replica value] <path>

  • 元数据缓存:

    • 功能说明:元数据缓存命令可以备份远端文件的元数据信息,从而后续无需从OSS等后端读取文件元数据信息。

    • 命令:

      jindocache -load -meta <options> <path>

      涉及以下参数。

      参数

      说明

      <options>

      可选参数如下:

      • -s:表示缓存过程同步执行,即缓存完成前命令不退出,日志直接打印在控制台上。推荐开启。

      • -R:递归缓存文件,当<path>是文件夹时需开启。

      <path>

      元数据缓存路径。例如,oss://emr-test/dir1。

      推荐使用以下组合命令。

      jindocache -load -meta -s -R <path>
  • 数据缓存:

    • 功能说明:数据缓存命令可以备份对应路径的数据至本集群的磁盘,以便于后续可以读取本地数据,无需读取OSS等后端上的数据。

    • 命令:

      jindocache -load -data <options> <path>

      涉及以下参数。

      参数

      说明

      <options>

      可选参数如下:

      • -s:表示缓存过程同步执行。即缓存完成前命令不退出,日志直接打印在控制台上。推荐开启。

      • -replica:缓存副本数量,默认缓存1个副本。

      • -R:递归缓存文件,当<path>是文件夹时需开启。

      • -m:加载数据到内存。

      <path>

      数据缓存路径。例如,oss://emr-test/dir1。

      推荐使用以下组合命令。

      jindocache -load -data -s -R <path>

mount

  • 功能说明:挂载后端路径到缓存系统中。可通过jindocache -mount命令来查看当前所有的挂载点。

  • 命令:

    jindocache -mount <mountpoint> <path>

    涉及以下参数。

    参数

    说明

    <mountpoint>

    待挂载的后端路径。例如,/mount/dir。

    <path>

    元数据缓存路径。例如,oss://emr-test/dir1。

  • 示例:

    jindocache -mount /mount/dir oss://emr-test/dir1

umount

  • 功能说明:取消挂载点。

  • 命令:

    jindocache -unmount <mountpoint>
  • 示例:

    jindocache -unmount /mount/dir

report

  • 功能说明:输出当前JindoCache存储加速系统信息,例如节点个数、缓存大小,缓存容量等。

  • 命令示例:

    jindocache -report

reportMetrics

  • 功能说明:输出当前JindoCache存储加速系统的部分指标信息。

  • 命令:

    jindocache -reportMetrics

unCache

  • 功能说明:删除缓存系统中的缓存文件。

  • 命令:

    jindocache -unCache oss://<bucket>/<dir>
  • 示例:

    jindocache -unCache oss://emr-test/dir1

disableCacheSet

  • 功能说明:通过CacheSet名称,删除某一个CacheSet。

  • 命令:

    jindocache -disableCacheSet <name>
  • 示例:

    jindocache -disableCacheSet name1

getCacheSet

  • 功能说明:通过路径查找所属的CacheSet。

  • 命令:

    jindocache -getCacheSet <path>
  • 示例:

    jindocache -getCacheSet oss://emr-test/dir1