• Edit /etc/mail/sendmail.cf:
  • Fw-o /etc/mail/local-host-names -- comment in if not already
  • Kvirtuser hash /etc/mail/virtusertable -- comment in if not already
  • search for "virtual users" -- down near end of file comment in rules
• Create empty /etc/mail/local-host-names -- format below
• Create empty /etc/mail/virtusertable -- format below
• Create generic /etc/namedb/generic.hosts -- format below

• /etc/mail/local-host-names -- add new domain name all by itself on one line (# in leftmost column works as comment)
• /etc/mail/virtusertable -- add any new mail forwarding rules:
  format is:
  • "user1@domaina user2@domainb" -- redirects mail for given user to another place
  • "@domainc user3@domaind" -- redirects ALL mail for domainc to other user
• /etc/namedb/named.conf -- Add "primary newdomainname generic.hosts"
• adduser. I'm using group "customer" for customers, and "staff" for more empowered.
• I'm adding the user to the "customer" group in /etc/group, I don't remember if this is necessary or even appropriate. (Note 10-Nov-2001: no need to do this.)
• Edit /usr/local/etc/apache/http.conf. Jump down to the end, and copy a virtualhost block of an existing domain. (If you have multiple virtualhost blocks for a given domain, you're doing it wrong -- see my apache hints page.)
• mkdir /web/domain. In that dir make 'data', 'html' and 'logs' dirs. In the html dir, you may wish to add a hard link to central cgi-bin (Note 10-Nov-2001: don't do this).
• Make their new home/web dir. Be sure to set the permissions -- copy an existing domain. Basically 755 for dirs, 644 for files. Optionally, make them the owner and set the group (I use "customer"). You may not want to do this as if they delete either of these dirs, apache will refuse to re/start. Obviously however, they do need add/write access in at least the html dir.
• Add their new directory to the backup script list.
• Add them to main vintners.net index list.
• copy /etc/mail/local-host-names over to your email secondary(s). wrong! don't do this! (12-Jul-04)
• Add new domain to /etc/mail/mailertable on mail secondary. wrong! don't do this! (20-Sep-2006)
• FYI: Don't add new domain to /etc/mail/local-host-names on mail secondary. (20-Sep-2006)
• Add new domain to /etc/mail/virtuser-domains on mail secondary.
  (If you forget this, dnsreport will show everything fine except that abuse and postmaster will not be accepted as they should.) wrong! don't do this! use MAIL_HUB decl instead (20-Sep-2006)
• Add new domain name to /etc/namedb/named.conf on your DNS secondary(s).
• email friends to add secondarying for them on their boxes.
• Add their webmaster email addr to your customer list.
• Go to http://www.DNSsy.com/ to check your work.
• Do a   tail /var/log/messages   and check for any errors.

• Update mail deamon
  • newaliases -- if you've changed anything in the aliases file (probably not necessary here)
  • makemap -v hash /etc/mail/virtusertable</etc/mail/virtusertable -- update virtuser db
  • kill -HUP `head -1 /var/run/sendmail.pid` -- restart sendmail deamon
• kill -HUP `cat /var/run/named.pid`
• apachectl restart

• In older FreeBSD flavors (pre-3.0?), the "local-host-names" file was named "sendmail.cw" by default.
• In older FreeBSD flavors (pre-3.0?), the "named.conf" file was named "named.boot".
• In older FreeBSD flavors (pre-3.0?), the "http.conf" file was named "apache.conf".

;
; generic.hosts - created 13-Jul-2003
; use this for all "generic" customer domains.
;

$TTL 43200

@		IN	SOA	ns2.vintners.net. hostmaster.vintners.net.  (
				200312190	; Serial yyyymmddx
				21600	; Refresh	6hrs
				900	; Retry		15min
				3600000	; Expire
				43200 )	; Minimum
;
		IN	NS	ns2.vintners.net.
		IN	NS	ns1.example.com.
		IN	MX	10 mail.vintners.net.
		IN	MX	20 ns1.example.com.

		IN	A	0.0.0.4

ftp		IN	A	0.0.0.4
www		IN	A	0.0.0.4
smtp		IN	A	0.0.0.4
pop3		IN	A	0.0.0.4
mail		IN	A	0.0.0.4
imap		IN	A	0.0.0.4
brix		IN	A	0.0.0.4
oechsle		IN	A	0.0.0.5
ns2		IN	A	0.0.0.4
ns1		IN	A	0.0.0.5