ceph/doc/cephfs/administration.rst

   1
   2 CephFS Administrative commands
   3 ==============================
   4
   5 Filesystems
   6 -----------
   7
   8 These commands operate on the CephFS filesystems in your Ceph cluster.
   9 Note that by default only one filesystem is permitted: to enable
  10 creation of multiple filesystems use ``ceph fs flag set enable_multiple true``.
  11
  12 ::
  13
  14     fs new <filesystem name> <metadata pool name> <data pool name>
  15
  16 ::
  17
  18     fs ls
  19
  20 ::
  21
  22     fs rm <filesystem name> [--yes-i-really-mean-it]
  23
  24 ::
  25
  26     fs reset <filesystem name>
  27
  28 ::
  29
  30     fs get <filesystem name>
  31
  32 ::
  33
  34     fs set <filesystem name> <var> <val>
  35
  36 ::
  37
  38     fs add_data_pool <filesystem name> <pool name/id>
  39
  40 ::
  41
  42     fs rm_data_pool <filesystem name> <pool name/id>
  43
  44
  45 Daemons
  46 -------
  47
  48 These commands act on specific mds daemons or ranks.
  49
  50 ::
  51
  52     mds fail <gid/name/role
  53
  54 This command deactivates an MDS causing it to flush its entire journal to
  55 backing RADOS objects and close all open client sessions. Deactivating an MDS
  56 is primarily intended for bringing down a rank after reducing the number of
  57 active MDS (max_mds).
  58
  59 ::
  60
  61     mds deactivate <role>
  62
  63 ::
  64
  65     tell mds.<daemon name>
  66
  67 ::
  68
  69     mds metadata <gid/name/role>
  70
  71 ::
  72
  73     mds repaired <role>
  74
  75
  76 Global settings
  77 ---------------
  78
  79 ::
  80
  81     fs dump
  82
  83 ::
  84
  85     fs flag set <flag name> <flag val> [<confirmation string>]
  86
  87 "flag name" must be one of ['enable_multiple']
  88
  89 Some flags require you to confirm your intentions with "--yes-i-really-mean-it"
  90 or a similar string they will prompt you with. Consider these actions carefully
  91 before proceeding; they are placed on especially dangerous activities.
  92
  93
  94 Advanced
  95 --------
  96
  97 These commands are not required in normal operation, and exist
  98 for use in exceptional circumstances.  Incorrect use of these
  99 commands may cause serious problems, such as an inaccessible
 100 filesystem.
 101
 102 ::
 103
 104     mds compat rm_compat
 105
 106 ::
 107
 108     mds compat rm_incompat
 109
 110 ::
 111
 112     mds compat show
 113
 114 ::
 115
 116     mds getmap
 117
 118 ::
 119
 120     mds set_state
 121
 122 ::
 123
 124     mds rmfailed
 125
 126 Legacy
 127 ------
 128
 129 ::
 130
 131     mds stat
 132     mds dump  # replaced by "fs get"
 133     mds stop  # replaced by "mds deactivate"
 134     mds set_max_mds # replaced by "fs set max_mds"
 135     mds set # replaced by "fs set"
 136     mds cluster_down  # replaced by "fs set cluster_down"
 137     mds cluster_up  # replaced by "fs set cluster_up"
 138     mds newfs # replaced by "fs new"
 139     mds add_data_pool # replaced by "fs add_data_pool"
 140     mds remove_data_pool #replaced by "fs remove_data_pool"
 141