Creating an SMB cluster using the CLI

Content Software for File CLI Reference

Version
4.2.x
Audience
anonymous
Part Number
MK-HCSF001-03

Command

weka smb cluster create

Use the following command line to create a new SMB cluster to be managed by the Content Software for File system:

weka smb cluster create <name> <domain> [--samba-hosts samba-hosts]... [--smb-ips-pool smb-ips-pool]... [--smb-ips-range smb-ips-range]...
Table. Parameters
Name Type Value Limitations Mandatory Default
name String NetBIOS name for the SMB cluster Must be a valid name (ASCII) Yes  
domain String The domain which the SMB cluster is to join Must be a valid name (ASCII) Yes  
samba-hosts Comma-separated strings List of 3-8 Content Software for File system hosts to participate in the SMB cluster, based on the host IDs in Content Software for File Must be valid host IDs Yes  
smb-ips-pool Comma-separated IP addresses The public IPs used as floating IPs for the SMB cluster to serve the SMB over and thereby provide HA; should not be assigned to any host on the network Must be valid IP addresses No  
smb-ips-range IP address range The public IPs used as floating IPs for the SMB cluster to serve the SMB over and thereby provide HA; should not be assigned to any host on the network Format: A.B.C.D-E for example, 10.10.0.1-100 No  
domain-netbios-name String Domain NetBIOS name Must be a valid name (ASCII) No First part of domain parameter
Note: Content Software for File
  • All IPs must reside on the same subnet, in order to enable HA through IP takeover.
  • The IPs must be configured but MUST NOT be in use by any other application/host in the subnet, including Content Software for File system management nodes, Content Software for File system IO nodes, or Content Software for File system NFS floating IPs. In AWS environments, this is not supported and these IPs should not be provided.
  • The --smb-ips parameter is supposed to accept the public IPs that the SMB cluster will expose. To mount the SMB cluster in an HA manner, they should be mounted via one of the exposed public IPs, thereby ensuring that they will not lose connection if one of the SMB hosts fails.
  • If it is necessary to set global options to the SMB library, contact customer support.
For example:
weka smb cluster create wekaSMB mydomain --samba-hosts 0,1,2,3,4 --smb-ips-pool 1.1.1.1,1.1.1.2 --smb-ips-range 1.1.1.3-5

In this example of a full command, an SMB cluster is configured over the Content Software for File system hosts 0-4. The SMB cluster is called wekaSMB, the domain name is called mydomain, and is directed to use public IPs 1.1.1.1 to 1.1.1.5.