From 04f5f4c8bc704e83621e9c1b2c79f5f6d207168e Mon Sep 17 00:00:00 2001 From: astonhill Date: Wed, 19 Aug 2026 12:20:11 -0500 Subject: [PATCH 1/3] updated section on SMB services for OI --- docs/handbook/network-communications.md | 33 ++++++++++++++++++++++--- 1 file changed, 29 insertions(+), 4 deletions(-) diff --git a/docs/handbook/network-communications.md b/docs/handbook/network-communications.md index eb35f81b..499ebd1b 100644 --- a/docs/handbook/network-communications.md +++ b/docs/handbook/network-communications.md @@ -295,13 +295,38 @@ 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 -< Place holder for content > +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. -### Configuring NFS client connectivity +``` +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 +``` -OpenIndiana has built in NFS client support and automatic mounting capabilities for using remote NFS shares. +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 "chmod" permission to do so for their user account and group. If they don't, Windows users will be restricted from editing, viewing, or changing their files. Always test thoroughly as permissions on OpenIndiana's side can cause issues for Windows users. Note for Windows 11: consider having your Windows 11 users authenticate with a username/password as opposed to a guest account, as Windows 11 has many roadblocks that make this difficult otherwise with passwordless guest accounts. This author personally has spent hours with this, and does not recommend it either! #### Manually mounting remote NFS shares From fae3333298a1e438a631f39027ad41c69bf51cbc Mon Sep 17 00:00:00 2001 From: astonhill Date: Wed, 19 Aug 2026 13:30:12 -0500 Subject: [PATCH 2/3] revised title section format --- docs/handbook/network-communications.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/handbook/network-communications.md b/docs/handbook/network-communications.md index 499ebd1b..2ac81c42 100644 --- a/docs/handbook/network-communications.md +++ b/docs/handbook/network-communications.md @@ -328,6 +328,10 @@ 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 "chmod" permission to do so for their user account and group. If they don't, Windows users will be restricted from editing, viewing, or changing their files. Always test thoroughly as permissions on OpenIndiana's side can cause issues for Windows users. Note for Windows 11: consider having your Windows 11 users authenticate with a username/password as opposed to a guest account, as Windows 11 has many roadblocks that make this difficult otherwise with passwordless guest accounts. This author personally has spent hours with this, and does not recommend it either! +### Configuring NFS client connectivity + +OpenIndiana has built in NFS client support and automatic mounting capabilities for using remote NFS shares. + #### Manually mounting remote NFS shares The [`mount -F nfs`](https://illumos.org/man/8/mount_nfs) command is used to manually mount a remote share to a specified location. From 59ebdf7f3b02bae78a0ccc2461b0a69b95f180d5 Mon Sep 17 00:00:00 2001 From: astonhill Date: Wed, 19 Aug 2026 17:30:58 -0500 Subject: [PATCH 3/3] revised again to restructure paragraph and add note headers --- docs/handbook/network-communications.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/docs/handbook/network-communications.md b/docs/handbook/network-communications.md index 2ac81c42..f11676bf 100644 --- a/docs/handbook/network-communications.md +++ b/docs/handbook/network-communications.md @@ -326,7 +326,16 @@ 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 "chmod" permission to do so for their user account and group. If they don't, Windows users will be restricted from editing, viewing, or changing their files. Always test thoroughly as permissions on OpenIndiana's side can cause issues for Windows users. Note for Windows 11: consider having your Windows 11 users authenticate with a username/password as opposed to a guest account, as Windows 11 has many roadblocks that make this difficult otherwise with passwordless guest accounts. This author personally has spent hours with this, and does not recommend it either! +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. + +
+!!! note + For Microsoft Windows 11: consider having your Windows 11 users authenticate with a username/password as opposed to a guest account, as Windows 11 has many roadblocks that make this difficult otherwise with passwordless guest accounts. This author personally has spent hours with this, and does not recommend it either! + +
+ ### Configuring NFS client connectivity