Use JindoCache CLI commands - E-MapReduce

Use the jindocache command to manage caching policies, load data into cache, monitor cache state, and remove cached data. Run jindocache with no flags to list all supported commands and their syntax.

Prerequisites

Before you begin, make sure you have:

JindoCache configured. See Use the transparent caching feature of JindoCache to accelerate access to OSS-HDFS and Use the transparent caching feature of JindoCache to accelerate access to OSS

Command reference

listCacheSet

Lists all CacheSets in the current system. Use this command to audit which paths are under an active cache policy before making changes.

jindocache -listCacheSet

refreshCacheSet

Updates a CacheSet policy from a local configuration file. CacheSets that do not exist in the new policy file are deleted.

jindocache -refreshCacheSet <localPath>

Parameter	Description	Example
`<localPath>`	Path to the `cacheset.xml` file — the storage path you specified when creating the file	`/path/cacheset.xml`

Example:

jindocache -refreshCacheSet /path/cacheset.xml

load

Caches remote files (metadata or data) to local disks, so subsequent reads are served from local disk instead of backend storage such as OSS.

The full command format is:

jindocache -load [-meta] [-data] [-s] [-m] [-R] [-replica <value>] <path>

Metadata caching

Caches file metadata to local disks. Use this before running compute jobs to eliminate metadata round-trips to OSS.

jindocache -load -meta <options> <path>

Parameter	Description
`-s`	Run in synchronous mode — the command stays open until caching is complete and streams the log to the console. Recommended for monitoring progress.
`-R`	Recursively cache all files in a folder. Required when `<path>` is a directory.
`<path>`	The path whose metadata to cache. Example: `oss://emr-test/dir1`

For directories, use the recommended form:

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

Data caching

Caches file data to local disks. Use this to warm the cache before running data-intensive workloads.

jindocache -load -data <options> <path>

Parameter	Description
`-s`	Run in synchronous mode — the command stays open until caching is complete and streams the log to the console. Recommended for monitoring progress.
`-replica <value>`	Number of replicas to cache. Default: `1`.
`-R`	Recursively cache all files in a folder. Required when `<path>` is a directory.
`-m`	Load data into memory instead of disk.
`<path>`	The path whose data to cache. Example: `oss://emr-test/dir1`

For directories, use the recommended form:

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

mount

Mounts a backend storage path to the caching system. Run jindocache -mount with no arguments to list all current mount points.

jindocache -mount <mountpoint> <path>

Parameter	Description	Example
`<mountpoint>`	The local mount point path	`/mount/dir`
`<path>`	The backend storage path to mount	`oss://emr-test/dir1`

Example:

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

umount

Unmounts a mount point from the caching system.

jindocache -unmount <mountpoint>

Example:

jindocache -unmount /mount/dir

report

Queries system-level information about the JindoCache storage acceleration system, including the number of nodes, cache size, and cache capacity.

jindocache -report

reportMetrics

Queries some of the metrics of the JindoCache storage acceleration system.

jindocache -reportMetrics

unCache

Removes cached files from the caching system.

jindocache -unCache oss://<bucket>/<dir>

Example:

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

disableCacheSet

Deletes a CacheSet by name. Use this to remove a cache policy that is no longer needed.

jindocache -disableCacheSet <name>

Example:

jindocache -disableCacheSet name1

getCacheSet

Looks up the CacheSet that governs a given path. Use this to confirm which cache policy applies before loading or evicting data.

jindocache -getCacheSet <path>

Example:

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