1.1. About This Guide¶

This guide serves two purposes:

• If you manage Storage via the web-based management panel, this guide complements the Storage Administrator’s Guide. Read it to find out how to use the command-line tools to perform tasks that are safe for Storage with the management panel. However, skip the chapters Setting Up a Storage Cluster and Configuring Storage Clusters as those console commands are unsafe for Storage with the management panel.

• If you manage Storage via the command line (i.e. the management panel is not installed), this guide is the primary documentation on Storage. Read it to find out how to perform every task related to managing Storage clusters, from initial setup to monitoring, optimization, and troubleshooting.

In general, it is recommended to manage Storage via the management panel. If you have it installed, consider the command-line tools secondary and use them with caution.

If you have the management panel installed, do not do the following via the command-line tools:

• Set custom paths for Storage services, in particular:

  • Create S3 clusters only in /mnt/vstorage/vols/s3.

  • Create iSCSI targets only in /mnt/vstorage/vols/iscsi.

• Mount clusters or change cluster mount options.

• Configure firewall with firewall-cmd.

• Rename network connections.

• Manage MDS/CS.

• Manage partitions, LVMs, or software RAID.

• Modify files in /mnt/vstorage/vols and /mnt/vstorage/webcp/backup directories.

• Set encoding or replication of cluster root.