Admin Command Line Interface

Slack Docker Pulls GitHub edit source

Alluxio’s admin command line interface provides admins with operations to manage the Alluxio filesystem. You can invoke the following command line utility to get all the subcommands:

  1. ./bin/alluxio fsadmin
  2. Usage: alluxio fsadmin [generic options]
  3.        [backup]
  4.        [doctor]
  5.        [report]
  6.        [ufs --mode <noAccess/readOnly/readWrite> <ufsPath>]
  7.        ...

Operations

backup

The backup command creates a backup of Alluxio metadata.

Back up to the default backup folder (configured by alluxio.master.backup.directory)

  1. ./bin/alluxio fsadmin backup
  2. Successfully backed up journal to hdfs://mycluster/opt/alluxio/backups/alluxio-backup-2018-5-29-1527644810.gz

Back up to a specific directory in the under storage.

  1. ./bin/alluxio fsadmin backup /alluxio/special_backups
  2. Successfully backed up journal to hdfs://mycluster/opt/alluxio/backups/alluxio-backup-2018-5-29-1527644810.gz

Back up to a specific directory on the leading master’s local filesystem.

  1. ./bin/alluxio fsadmin backup /opt/alluxio/backups/ --local
  2. Successfully backed up journal to file:///opt/alluxio/backups/alluxio-backup-2018-5-29-1527644810.gz on master Master2

doctor

The doctor command shows Alluxio errors and warnings.

  1. # shows server-side configuration errors and warnings
  2. ./bin/alluxio fsadmin doctor configuration

getBlockInfo

The getBlockInfo command provides the block information and file path of a block id. It is primarily intended to assist power users in debugging their system.

  1. ./bin/alluxio fsadmin getBlockInfo <block_id>

report

The report command provides Alluxio running cluster information.

If no argument is passed in, report will report the leading master, worker number, and capacity information.

  1. ./bin/alluxio fsadmin report
  2. Alluxio cluster summary:
  3.     Master Address: localhost:19998
  4.     Zookeeper Enabled: false
  5.     Live Workers: 1
  6.     Lost Workers: 0
  7.     Total Capacity: 10.45GB
  8.     Used Capacity: 0B
  9.     (only a subset of the results is shown)

report capacity will report Alluxio cluster capacity information for different subsets of workers:

  • -live Live workers
  • -lost Lost workers
  • -workers <worker_names> Specified workers, host names or ip addresses separated by ,.
  1. # Capacity information of all workers
  2. ./bin/alluxio fsadmin report capacity
  3. # Capacity information of live workers
  4. ./bin/alluxio fsadmin report capacity -live
  5. # Capacity information of specified workers
  6. ./bin/alluxio fsadmin report capacity -workers AlluxioWorker1,127.0.0.1

report metrics will report the metrics information of Alluxio cluster.

  1. ./bin/alluxio fsadmin report metrics

report ufs will report all the mounted under storage system information of Alluxio cluster.

  1. ./bin/alluxio fsadmin report ufs
  2. Alluxio under storage system information:
  3. hdfs://localhost:9000/ on / (hdfs, capacity=-1B, used=-1B, not read-only, not shared, properties={})

ufs

The ufs command provides options to update attributes of a mounted under storage. The option mode can be used to put an under storage in maintenance mode. Certain operations can be restricted at this moment.

For example, an under storage can enter readOnly mode to disallow write operations. Alluxio will not attempt any write operations on the under storage.

  1. ./bin/alluxio fsadmin ufs --mode readOnly hdfs://ns

The fsadmin ufs subcommand takes a UFS URI as an argument. The argument should be a root UFS URI like hdfs://<name-service>/, and not hdfs://<name-service>/<folder>.