Xfactor973 Gluster Charm

Learn about actions >

• create-volume-quota

  Directory quotas in GlusterFS allows you to set limits on usage of the disk space by volumes.

  Params

  • path string

    The path to limit the usage on. Defaults to /

  • usage-limit integer

    The MB limit of the quota for this volume.

  • volume string

    The volume to enable this quota on

  Required

  volume, usage-limit

• delete-volume-quota

  Directory quotas in GlusterFS allows you to set limits on usage of the disk space by volumes.

  Params

  • path string

    The path to remove the limit on. Defaults to /

  • volume string

    The volume to disable this quota on

  Required

  volume

• list-volume-quotas

  Directory quotas in GlusterFS allows you to set limits on usage of the disk space by volumes.

  Params

  • volume string

    The volume to list quotas on

  Required

  volume

• rebalance-volume

  After expanding or shrinking a volume you need to rebalance the data among the servers. New directories created after expanding or shrinking of the volume will be evenly distributed automatically. For all the existing directories, the distribution can be fixed by rebalancing the layout and/or data. This action should be run in a maintenance window because client IO will be impacted.

  Params

  • volume string

    The volume to rebalance

  Required

  volume

• set-volume-options

  You can tune volume options, as needed, while the cluster is online and available.

  Params

  • auth-allow string

    IP addresses of the clients which should be allowed to access the volume. Valid IP address which includes wild card patterns including , such as 192.168.1.

  • auth-reject string

    IP addresses of the clients which should be denied to access the volume. Valid IP address which includes wild card patterns including , such as 192.168.1.

  • cluster-data-self-heal-algorithm string

    Specifies the type of self-heal. If you set the option as "full", the entire file is copied from source to destinations. If the option is set to "diff" the file blocks that are not in sync are copied to destinations. Reset uses a heuristic model. If the file does not exist on one of the subvolumes, or a zero-byte file exists (created by entry self-heal) the entire content has to be copied anyway, so there is no benefit from using the "diff" algorithm. If the file size is about the same as page size, the entire file can be read and written with a few operations, which will be faster than "diff" which has to read checksums and then read and write.

  • cluster-ensure-durability boolean

    This option makes sure the data/metadata is durable across abrupt shutdown of the brick.

  • cluster-min-free-disk integer

    Specifies the percentage of disk space that must be kept free. Might be useful for non-uniform bricks

  • cluster-self-heal-daemon boolean

    Allows you to turn-off proactive self-heal on replicated

  • cluster-self-heal-window-size integer

    Specifies the maximum number of blocks per file on which self-heal would happen simultaneously.

  • cluster-stripe-block-size integer

    Specifies the size of the stripe unit that will be read from or written to.

  • diagnostics-brick-log-level string

    Changes the log-level of the bricks.

  • diagnostics-client-log-level string

    Changes the log-level of the clients.

  • diagnostics-dump-fd-stats boolean

    Statistics related to file-operations would be tracked.

  • diagnostics-latency-measurement boolean

    Statistics related to the latency of each operation would be tracked.

  • features-lock-heal boolean

    Enables self-healing of locks when the network disconnects.

  • features-quota-timeout integer

    For performance reasons, quota caches the directory sizes on client. You can set timeout indicating the maximum duration of directory sizes in cache, from the time they are populated, during which they are considered valid

  • features-read-only boolean

    Enables you to mount the entire volume as read-only for all the clients (including NFS clients) accessing it.

  • geo-replication-indexing boolean

    Use this option to automatically sync the changes in the filesystem from Master to Slave.

  • nfs-addr-namelookup boolean

    Turn-off name lookup for incoming client connections using this option. In some setups, the name server can take too long to reply to DNS queries resulting in timeouts of mount requests. Use this option to turn off name lookups during address authentication. Note, turning this off will prevent you from using hostnames in rpc-auth.addr.* filters.

  • nfs-disable boolean

    Turn-off volume being exported by NFS

  • nfs-enable-ino32 boolean

    For 32-bit nfs clients or applications that do not support 64-bit inode numbers or large files, use this option from the CLI to make Gluster NFS return 32-bit inode numbers instead of 64-bit inode numbers.

  • nfs-export-dir string

    This option can be used to export specified comma separated subdirectories in the volume. The path must be an absolute path. Along with path allowed list of IPs/hostname can be associated with each subdirectory. If provided connection will allowed only from these IPs. Format: <dir>[(hostspec[hostspec...])][,...]. Where hostspec can be an IP address, hostname or an IP range in CIDR notation. Note: Care must be taken while configuring this option as invalid entries and/or unreachable DNS servers can introduce unwanted delay in all the mount calls.

  • nfs-export-volumes boolean

    Enable/Disable exporting entire volumes, instead if used in conjunction with nfs3.export-dir, can allow setting up only subdirectories as exports.

  • nfs-ports-insecure boolean

    Allow client connections from unprivileged ports. By default only privileged ports are allowed. This is a global setting in case insecure ports are to be enabled for all exports using a single option.

  • nfs-register-with-portmap boolean

    For systems that need to run multiple NFS servers, you need to prevent more than one from registering with portmap service. Use this option to turn off portmap registration for Gluster NFS.

  • nfs-rpc-auth-null boolean

    Enable/Disable the AUTH_NULL authentication type. It is not recommended to change the default value for this option.

  • nfs-rpc-auth-unix boolean

    Enable/Disable the AUTH_UNIX authentication type. This option is enabled by default for better interoperability. However, you can disable it if required.

  • nfs-trusted-sync boolean

    All writes and COMMIT requests are treated as async. This implies that no write requests are guaranteed to be on server disks when the write reply is received at the NFS client. Trusted sync includes trusted-write behavior.

  • nfs-trusted-write boolean

    If there is an UNSTABLE write from the client, STABLE flag will be returned to force the client to not send a COMMIT request. In some environments, combined with a replicated GlusterFS setup, this option can improve write performance. This flag allows users to trust Gluster replication logic to sync data to the disks and recover when required. COMMIT requests if received will be handled in a default manner by fsyncing. STABLE writes are still handled in a sync manner.

  • nfs-volume-access string

    Set the access type for the specified sub-volume.

  • performance-cache-max-file-size integer

    Sets the maximum file size cached by the io-cache translator. Can use the normal size descriptors of KB, MB, GB,TB or PB (for example, 6GB). Maximum size uint64.

  • performance-cache-min-file-size integer

    Sets the minimum file size cached by the io-cache translator. Values same as "max" above

  • performance-cache-refresh-timeout integer

    The cached data for a file will be retained till 'cache-refresh-timeout' seconds, after which data re-validation is performed.

  • performance-cache-size integer

    Size of the read cache in bytes

  • performance-flush-behind boolean

    If this option is set ON, instructs write-behind translator to perform flush in background, by returning success (or any errors, if any of previous writes were failed) to application even before flush is sent to backend filesystem.

  • performance-io-thread-count integer

    The number of threads in IO threads translator.

  • performance-write-behind-window-size integer

    Size of the per-file write-behind buffer.

  • server-allow-insecure boolean

    Allow client connections from unprivileged ports. By default only privileged ports are allowed. This is a global setting in case insecure ports are to be enabled for all exports using a single option.

  • server-grace-timeout integer

    Specifies the duration for the lock state to be maintained on the server after a network disconnection.

  • server-statedump-path string

    Location of the state dump file.

  • volume string

    The volume to set the option on

  Required

  volume