diff --git a/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml b/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml index 6e49771a52..a66bd77f53 100644 --- a/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml +++ b/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml @@ -5,6 +5,17 @@ --> + + + + Murray + Stokely + Reorganized by + + + + + Network Servers @@ -50,6 +61,11 @@ How to set up a File Transfer Protocol (FTP) Server. + + How to set up a file and print server for Windows + clients using Samba. + + How to synchronize the time and date, and set up a time server, with the NTP protocol. @@ -330,7 +346,7 @@ server-program-arguments seqpacket. stream must be used for connection-based, TCP daemons, while dgram is used for daemons utilizing - the UDP transport protocol. + the UDP transport protocol. @@ -606,6 +622,11 @@ server-program-arguments NFS server + + file server + unix clients + + portmap @@ -1009,7 +1030,7 @@ Exports list on foobar: sometimes mistaken for this one, when the NFS servers and clients are on different networks. If that is the case, make certain that your routers are routing the - necessary UDP information, or you will not get anywhere, no + necessary UDP information, or you will not get anywhere, no matter what else you are doing. In the following examples, fastws is the host @@ -1788,7 +1809,7 @@ nis_client_enable="YES" - &nis Security + NIS Security In general, any remote user can issue an RPC to &man.ypserv.8; and retrieve the contents of your NIS maps, @@ -4351,6 +4372,249 @@ Log file format --> + + + + + Murray + Stokely + Contributed by + + + + File and Print Services for µsoft.windows; clients (Samba) + + Samba server + Microsoft Windows + + file server + Windows clients + + + print server + Windows clients + + + + Overview + + Samba is a popular open source + software package that provides file and print services for + µsoft.windows; clients. Such clients can connect to and + use FreeBSD filespace as if it was a local disk drive, or + FreeBSD printers as if they were local printers. + + Samba software packages should + be included on your FreeBSD installation media. If you did + not install Samba when you first + installed FreeBSD, then you can install it from the net/samba3 port or package. + + + + + + + Configuration + + A default Samba configuration + file is installed as + /usr/local/etc/smb.conf.default. This + file must be copied to + /usr/local/etc/smb.conf and customized + before Samba can be used. + + The smb.conf file contains runtime + configuration information for + Samba, such as definitions of the + printers and filesystem shares that you would + like to share with Windows clients. The + Samba package includes a web based + tool called swat which provides a + simple way of configuring the smb.conf + file. + + + Using the Samba Web Administration Tool (SWAT) + + The Samba Web Administration Tool (SWAT) runs as a + daemon from inetd. Therefore, the + following line in /etc/inetd.conf + should be uncommented before swat can be + used to configure Samba: + + swat stream tcp nowait/400 root /usr/local/sbin/swat + As explained in , a + HangUP Signal must be sent to + inetd after this configuration + file is changed. + + Once swat has been enabled in + inetd.conf, you can use a browser to + connect to http://localhost:901. You will + first have to log on with the system root account. + + + + Once you have successfully logged on to the main + Samba configuration page, you can + browse the system documentation, or begin by clicking on the + 'Globals' tab. The Globals section corresponds to the + variables that are set in the [global] + section of + /usr/local/etc/smb.conf. + + + + Global Settings + + Whether you are using swat or + editing /usr/local/etc/smb.conf + directly, the first directives you are likely to encounter + when configuring Samba + are: + + + + workgroup + + + NT Domain-Name or Workgroup-Name for the computers + that will be accessing this server. + + + + + netbios name + NetBIOS + + + This sets the NetBIOS name by which a Samba server + is known. By default it is the same as the first + component of the host's DNS name. + + + + + server string + + + This sets the string that will be displayed with + the net view command and some other + networking tools that seek to display descriptive text + about the server. + + + + + + + Security Settings + + Two of the most important settings in + /usr/local/etc/smb.conf are the + security model chosen, and the backend password format for + client users. The following directives control these + options: + + + + security + + + The two most common options here are + and . If your clients use usernames that + are the same as their usernames on your &os; machine + then you will want to use user level security. This + is the default security policy and it requires clients + to first log on before they can access shared + resources. + + In share level security, client do not need to log + onto the server with a valid username and password + before attempting to connect to a shared resource. + This was the default security model for older versions + of Samba. + + + + + passdb backend + + NIS+ + LDAP + SQL database + + + Samba has several + different backend authentication models. You can + authenticate clients with LDAP, NIS+, a SQL database, + or a modified password file. The default + authentication method is , + and that is all that will be covered here. + + + + + Assuming that the default + backend is used, the + /usr/local/private/smbpasswd file must + be created to allow Samba to + authenticate clients. If you would like to give all of + your Unix user accounts access from Windows clients, use the + following command: + + &prompt.root; cat /etc/passwd | grep -v "^#" | make_smbpasswd > /usr/local/private/smbpasswd +&prompt.root; chmod 600 /usr/local/private/smbpasswd + + Please see the Samba + documentation for additional information about configuration + options. With the basics outlined here, you should have + everything you need to start running + Samba. + + + + + Starting <application>Samba</application> + + To enable Samba when your + system boots, add the following line to + /etc/rc.conf: + + samba_enable="YES" + + You can then start Samba at any + time by typing: + + &prompt.root; /usr/local/etc/rc.d/samba.sh start +Starting SAMBA: removing stale tdbs : +Starting nmbd. +Starting smbd. + + Samba actually consists of + three separate daemons. You should see that both the + nmbd and smbd daemons + are started by the samba.sh script. If + you enabled winbind name resolution services in + smb.conf, then you will also see that + the winbindd daemon is started. + + You can stop Samba at any time + by typing : + + &prompt.root; /usr/local/etc/rc.d/samba.sh stop + + Samba is a complex software + suite with functionality that allows broad integration with + µsoft.windows; networks. For more information about + functionality beyond the basic installation described here, + please see . + + + +