Difference between revisions of "Custom Unmanaged NFS/CIFS Shares"

From OSNEXUS Online Documentation Site
Jump to: navigation, search
m (Custom NFS Exports)
m (Custom NFS Exports)
Line 24: Line 24:
 
</pre>
 
</pre>
  
The new custom export will appear at the bottom of the /etc/exports irectory.
+
The new custom export will appear at the bottom of the /etc/exports directory.
  
 
=== Custom SMB Shares ===
 
=== Custom SMB Shares ===
  
 
The smb.conf file can be edited to include custom share entries.  Note that any share with a path entry containing /mnt/storage-pools or /mnt/gluster-volumes will be managed by QuantaStor and may be removed automatically.  Hence all custom SMB share entries must not use that in the 'path' specifier.  To access a sub-path of an existing network share be sure to reference it under its bind point which is under /export/SHARENAME.
 
The smb.conf file can be edited to include custom share entries.  Note that any share with a path entry containing /mnt/storage-pools or /mnt/gluster-volumes will be managed by QuantaStor and may be removed automatically.  Hence all custom SMB share entries must not use that in the 'path' specifier.  To access a sub-path of an existing network share be sure to reference it under its bind point which is under /export/SHARENAME.

Revision as of 19:14, 14 June 2016

Some specialized deployments may require the creation of special NFS and CIFS share entries that are ignored by QuantaStor. These unmanaged network shares will not appear in the QuantaStor web UI but can be setup manually to provide special access to a QuantaStor appliances. This is usually done for integration with special 3rd party applications or to share out sub-paths of an existing share or Gluster Volume.

Custom NFS Exports

All custom NFS exports should be specified in the /etc/exports.custom file. The contents of this file are appended to the /etc/exports file automatically by the QuantaStor service. After making changes you can force the /etc/exports to update with a restart of the management service using 'service quantastor restart'.

An example of adding a custom NFS export to a custom sub-share called 'customshare' running on a Gluster Volume called 'gvol1' is detailed below:

First Make the custom directory you are looking to export:

mkdir /export/gvol1/customshare

Second, add an NFS exports entry such as the example below to the /etc/exports.custom file using nano or vim:

/export/gvol1/customshare *(rw,insecure,sync,no_subtree_check)

Finally, restart the QuantaStor management service using the command below have QuantaStor apply the custom export to the exports file.

sudo service quantastor restart

The new custom export will appear at the bottom of the /etc/exports directory.

Custom SMB Shares

The smb.conf file can be edited to include custom share entries. Note that any share with a path entry containing /mnt/storage-pools or /mnt/gluster-volumes will be managed by QuantaStor and may be removed automatically. Hence all custom SMB share entries must not use that in the 'path' specifier. To access a sub-path of an existing network share be sure to reference it under its bind point which is under /export/SHARENAME.