diff --git a/docs/handbook/network-communications.md b/docs/handbook/network-communications.md index eb35f81b..36624eb1 100644 --- a/docs/handbook/network-communications.md +++ b/docs/handbook/network-communications.md @@ -43,14 +43,42 @@ All Rights Reserved. (Contributor contact(s):________________[Insert hyperlink/a ## Email -< Place holder for content > - - -## WWW server - -* Apache -* nginx +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: +``` +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. +``` +sudo 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 + +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 @@ -295,9 +323,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. + +
+!!! 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! + +
-< Place holder for content > ### Configuring NFS client connectivity @@ -503,8 +569,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 @@ -514,8 +610,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