From 04f5f4c8bc704e83621e9c1b2c79f5f6d207168e Mon Sep 17 00:00:00 2001 From: astonhill Date: Wed, 19 Aug 2026 12:20:11 -0500 Subject: [PATCH 1/7] 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/7] 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/7] 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 From 6246ca77e4e6a1f3af8c3467ffb2a18188d989e2 Mon Sep 17 00:00:00 2001 From: astonhill Date: Thu, 20 Aug 2026 14:35:18 -0500 Subject: [PATCH 4/7] added content to FTP section, added link to Solaris info for NTP --- docs/handbook/network-communications.md | 37 ++++++++++++++++++++++--- 1 file changed, 33 insertions(+), 4 deletions(-) diff --git a/docs/handbook/network-communications.md b/docs/handbook/network-communications.md index f11676bf..f6028d0f 100644 --- a/docs/handbook/network-communications.md +++ b/docs/handbook/network-communications.md @@ -541,8 +541,38 @@ You can use the [unshare(8)](https://www.illumos.org/man/8/unshare) utility with ## Hipster as an FTP server -< Place holder for content > - +OpenIndiana has incredibly powerful FTP capabilities and support. Employing them is straightforward. + +First, check whether the FTP service is enabled or not: + +``` +svcs -a | grep ftp +``` + +You may see something like: +``` +disabled 12:13:18 svc:/network/tftp/udp6:default +disabled 12:10:38 svc:/network/proftpd:default +``` + +Second, determine the IPv4 address (and interface) you want to connect with by running: +``` +ipadm +``` +Third, edit the /etc/proftpd.conf file, with the value "DefaultAddress" defined (unless your hostname already resolves, then this setep is unneccessary). + +Afterwards, execute the FTP service as follows: +``` +sudo svcadm enable -r svc:/network/proftpd:default +``` +Optionally, if you have nmap installed, you can verify the service IP and port are open by running the IP-Address as follows: +``` +nmap IP-Address +``` +If all works, you can now connect +``` +ftp username@IP-Address +``` ## Hipster as a DNS server @@ -552,8 +582,7 @@ specifically pkg install pkg:/service/network/dns/bind ## Hipster as a NTP server -< Place holder for content > - +see https://docs.oracle.com/cd/E37838_01/html/E61003/time-4.html ## Hipster as a INETD server From d1bc85e2a5c6ff71eef278f7b239f5e75a396222 Mon Sep 17 00:00:00 2001 From: astonhill Date: Fri, 21 Aug 2026 01:34:09 -0500 Subject: [PATCH 5/7] added content to Www section, renamed to Apache HTTP, added content on config --- docs/handbook/network-communications.md | 21 ++++++++++++++++++--- 1 file changed, 18 insertions(+), 3 deletions(-) diff --git a/docs/handbook/network-communications.md b/docs/handbook/network-communications.md index f6028d0f..61ab3408 100644 --- a/docs/handbook/network-communications.md +++ b/docs/handbook/network-communications.md @@ -46,11 +46,26 @@ All Rights Reserved. (Contributor contact(s):________________[Insert hyperlink/a < Place holder for content > -## WWW server +## Apache HTTP -* Apache -* nginx +Starting a web service such as an Apache HTTP server on OpenIndiana is incredibly powerful & very simple. First, check if you have Apache running: +``` +svcs -a http +``` +By default, Apache is disabled on new installs. If by chance you have a minimal install and Apache isn't listed, install it: +``` +sudo pkg install web/server/apache-24 +``` +Second, start the service: +``` +sudo svcadm enable -r svc:/network/http:apache24 +``` +It is that straightforward! Apache HTTP will be running on port 80! You can verify this with a web browser at: +``` +http://Your-IP-Address:80 +``` +To change Apache HTTP configuration settings, edit /etc/apache2/2.4/httpd.conf. To host & add new content such as HTML files, you can do so with the default directory at /var/apache2/2.4/htdocs/. For managing and checking information on your Apache HTTP server, use apchectl which is located at /bin/apchectl. Have fun hosting with OpenIndiana! ## Firewalls From a8a122ba5e53fa393e800339ea1f0898bc6b7d7a Mon Sep 17 00:00:00 2001 From: astonhill Date: Fri, 21 Aug 2026 20:27:32 -0500 Subject: [PATCH 6/7] added content to mail section for both client and server. added postfix and thunderbird mentions. --- docs/handbook/network-communications.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/docs/handbook/network-communications.md b/docs/handbook/network-communications.md index 61ab3408..fe9f32f8 100644 --- a/docs/handbook/network-communications.md +++ b/docs/handbook/network-communications.md @@ -43,8 +43,21 @@ All Rights Reserved. (Contributor contact(s):________________[Insert hyperlink/a ## Email -< Place holder for content > +Email services are fully supported both as a client and server on OpenIndiana. To use a client, install one from the repository. A powerful client such as Mozilla Thunderbird is easily installed as follows: +``` +pkg install thunderbird +``` +Configuration of your email account is typically the same as on any other platform. Either create an account or log-in with your username and password combination. This author has personally tested with both Gmail and private e-mail services. +As a server, postfix is available to install. +``` +pkg install postfix +``` +Then, you can start the service: +``` +sudo svcadm enable -r svc:/network/smtp:postfix +``` +Your service should now be running on port 25. ## Apache HTTP From 8c90f8e4689fc61c6bf61d3a7b1d3424373e578a Mon Sep 17 00:00:00 2001 From: astonhill Date: Fri, 21 Aug 2026 21:38:17 -0500 Subject: [PATCH 7/7] added content to mail section for both client and server. added postfix and thunderbird mentions. --- docs/handbook/network-communications.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/handbook/network-communications.md b/docs/handbook/network-communications.md index fe9f32f8..36624eb1 100644 --- a/docs/handbook/network-communications.md +++ b/docs/handbook/network-communications.md @@ -45,13 +45,13 @@ All Rights Reserved. (Contributor contact(s):________________[Insert hyperlink/a Email services are fully supported both as a client and server on OpenIndiana. To use a client, install one from the repository. A powerful client such as Mozilla Thunderbird is easily installed as follows: ``` -pkg install thunderbird +sudo pkg install thunderbird ``` Configuration of your email account is typically the same as on any other platform. Either create an account or log-in with your username and password combination. This author has personally tested with both Gmail and private e-mail services. As a server, postfix is available to install. ``` -pkg install postfix +sudo pkg install postfix ``` Then, you can start the service: ```