diff --git a/docs/handbook/network-communications.md b/docs/handbook/network-communications.md index eb35f81b..f11676bf 100644 --- a/docs/handbook/network-communications.md +++ b/docs/handbook/network-communications.md @@ -295,9 +295,47 @@ You can create additional CIFS datasets using the following 4 commands. < Placeholder for introduction content > -### Hipster as a SAMBA server +### Hipster as a SMB/SAMBA server + +OpenIndiana has rich & native support through it's Zettabyte file system to drive modern SAMBA services. First, to start, ensure you have the pool you want to share created. Second, check that any other SMB service (such as one you may have installed or compiled manually) is not running as it will conflict with the native implementation. Third, start the native service as follows: + +``` +sudo svcadm enable -r smb/server +``` + +Then run the following: + +``` +sudo zfs create -o nbmand=on -o sharesmb=on poolname/setname +``` +Then, to define the share's name, use the following command: + +``` +sudo zfs set sharesmb=name=sharename poolname/setname +``` + +Afterwards, you can test your share with the following command on your OpenIndiana system. + +``` +sudo smbclient -L //192.168.1.1/ -U username +``` + +You can also verify locally that the system share parameters are to your liking: + +``` +sharemgr show +``` + +Lastly, ensure that the permissions you set agree with the user account's permissions. For instance, if you want users to be able to edit files, ensure they have the permission to do so for their user account and group. + +For instance, if the SMB user account is named "user", & in the "staff" group, ensure the folders and files they create by default have read, write, and if need be, execute permissions. If they don't, Windows users will see the Windows File Properties Menushowing restrictions for editing, viewing, (or executing) their SMB files. As always, test thoroughly as permissions on OpenIndiana's side can cause issues for Windows users. + +