bionic (8) sxadm-node.8.gz

Provided by: sx_2.0+ds-4build2_amd64 bug

NAME

       sxadm-node - create a node and manage a local storage

SYNOPSIS

       sxadm node [OPTIONS]... <MODE> <STORAGE_PATH>

DESCRIPTION

       sxadm  node can be used to create a new node and its storage and manage existing ones. All operations are
       performed locally and only on one node.

OPTIONS

       -h, --help
              Print help and exit

       --full-help
              Print help, including hidden options, and exit

       -V, --version
              Print version and exit

   Operation modes:
       -N, --new
              Create a new SX node in STORAGE_PATH. Once a  node  is  created  and  sx.fcgi  is  configured  and
              running, it should be joined to a cluster with sxadm cluster.

       -I, --info
              Print  details  about  the node and the storage in STORAGE_PATH. This includes information such as
              the current disk usage, protocol settings and the list of nodes in the  cluster,  which  the  node
              discovered  while  being  part  of the cluster. The current node is marked with an asterisk on the
              list.

       -C, --check
              Perform sanity check on the local storage in STORAGE_PATH. In order to  run  the  check  the  node
              needs to be offline or the cluster must be set read-only with sxadm cluster.

       -E, --extract=DESTDIR
              Extract  all  files  from  the  local  storage  in  STORAGE_PATH  to  DESTDIR. This option doesn't
              communicate with other nodes and in most cases it will only  be  possible  to  extract  data  from
              volumes with replica 2 and higher.

       --rename-cluster=NEWNAME
              Set  a new name for an SX cluster. This option is useful when a new certificate is deployed on all
              nodes and the cluster must match the name it was issued for. The operation should be performed  on
              all nodes.

       --upgrade
              Upgrade  the  node's  database  and  storage  format to the latest version. sxadm will check if an
              update is required and perform any needed changes.

       --compact
              Compact the node data returning allocated but unused space to the system. It is recommended to run
              the garbage collector before compacting the node. Depending on the storage size, the operation may
              take more time.

       --get-definition
              Print the definition of the node in STORAGE_PATH in the format used by cluster --mod.

   New node options:
       -k, --cluster-key=FILE
              This option should be used when creating a new node, which is going to join an existing cluster or
              when  re-creating  a cluster, which should use the same configuration as the previous one. It will
              read the cluster key from a file or stdin if  "-"  is  given.  The  default  is  to  automatically
              generate  the  key,  which  should  be  used for the first node in a new cluster. All nodes in the
              cluster must use the same cluster key.

       -u, --cluster-uuid=UUID
              This option should be used when creating a new node, which is going to join an existing cluster or
              when  re-creating  a  cluster,  which  should  use the same configuration as the previous one. The
              default is to automatically generate the cluster's UUID, which should be used for the  first  node
              in a new cluster. All nodes in the cluster must use the same cluster UUID.

       -b, --batch-mode
              This option turns off interactive confirmations and assumes "yes" for all questions.

       --owner=user[:group]
              Set ownership to user[:group] when creating the local storage structure on disk.

   Common options:
       -H, --human-readable
              Print human readable sizes  (default=off)

       -D, --debug
              Enable debug messages  (default=off)

FURTHER DOCUMENTATION

       Full documentation with additional examples available at: <http://www.skylable.com/docs/>

SEE ALSO

       sxadm(8), sxadm-cluster(8), sx.fcgi(8)