From owner-svn-doc-all@FreeBSD.ORG Sat Mar 9 10:55:32 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 8E04BA72; Sat, 9 Mar 2013 10:55:32 +0000 (UTC) (envelope-from linimon@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 753E69DE; Sat, 9 Mar 2013 10:55:32 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.6/8.14.6) with ESMTP id r29AtWo6019672; Sat, 9 Mar 2013 10:55:32 GMT (envelope-from linimon@svn.freebsd.org) Received: (from linimon@localhost) by svn.freebsd.org (8.14.6/8.14.5/Submit) id r29AtWMg019671; Sat, 9 Mar 2013 10:55:32 GMT (envelope-from linimon@svn.freebsd.org) Message-Id: <201303091055.r29AtWMg019671@svn.freebsd.org> From: Mark Linimon Date: Sat, 9 Mar 2013 10:55:32 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r41143 - head/en_US.ISO8859-1/articles/portbuild X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 09 Mar 2013 10:55:32 -0000 Author: linimon Date: Sat Mar 9 10:55:31 2013 New Revision: 41143 URL: http://svnweb.freebsd.org/changeset/doc/41143 Log: Make it clear that squid can either be run on the clients (as it was in the old days), or on the server. The latter is more efficient. Factor out the ganglia instructions as being optional. While here, remove some more cruft. Modified: head/en_US.ISO8859-1/articles/portbuild/article.xml Modified: head/en_US.ISO8859-1/articles/portbuild/article.xml ============================================================================== --- head/en_US.ISO8859-1/articles/portbuild/article.xml Fri Mar 8 17:30:08 2013 (r41142) +++ head/en_US.ISO8859-1/articles/portbuild/article.xml Sat Mar 9 10:55:31 2013 (r41143) @@ -1501,6 +1501,13 @@ umount: Cleanup of /x/tmp/8-exp/chroot/5 command is no longer used. + + + Decide if you will be using a local + squid cache on the client, + instead of the server. It is more efficient to run it + on the server. If you are doing that, skip the "squid" + steps below.) @@ -1627,12 +1634,21 @@ options NFSSERVER - Also add the following users: + If you are using ganglia + for monitoring, add the following user: - squid:*:100:100::0:0:User &:/usr/local/squid:/bin/sh -ganglia:*:102:102::0:0:User &:/usr/local/ganglia:/bin/sh + ganglia:*:102:102::0:0:User &:/usr/local/ganglia:/bin/sh - Add them to etc/group as well. + Add it to etc/group as well. + + + + If you are using a local squid + cache on the client, add the following user: + + squid:*:100:100::0:0:User &:/usr/local/squid:/bin/sh + + Add it to etc/group as well. @@ -1682,13 +1698,19 @@ nfs_client_enable="YES" ntpd_enable="YES" sendmail_enable="NONE" sshd_enable="YES" -sshd_program="/usr/local/sbin/sshd" +sshd_program="/usr/local/sbin/sshd" -gmond_enable="YES" -squid_enable="YES" + If you are using ganglia + for monitoring, add the following + + gmond_enable="YES" + + If you are using a local squid + cache on the client, add the following + + squid_enable="YES" squid_chdir="/usr2/squid/logs" squid_pidfile="/usr2/squid/logs/squid.pid" - Required entries for VMWare-based nodes: vmware_guest_vmmemctl_enable="YES" @@ -1774,13 +1796,21 @@ squid_pidfile="/u Install the following ports: net/rsync -security/openssh-portable (with HPN on) -security/sudo -sysutils/ganglia-monitor-core (with GMETAD off) -www/squid (with SQUID_AUFS on) +security/sudo + + You may also wish to install: + + security/openssh-portable (with HPN on) + + If you are using ganglia + for monitoring, install the following: + + sysutils/ganglia-monitor-core (with GMETAD off) - There is a WIP to create a meta-port, but it is not yet - complete. + If you are using a local squid + cache on the client, install the following + + www/squid (with SQUID_AUFS on) @@ -1801,7 +1831,8 @@ www/squid (with SQUID_AUFS on) - Modify + If you are using ganglia, + modify usr/local/etc/gmond.conf: 21,22c21,22 @@ -1849,7 +1880,8 @@ touch /tmp/.boot_finished - Modify + If you are using a local squid + cache, modify, usr/local/etc/squid/squid.conf: 288,290c288,290 @@ -1924,8 +1956,12 @@ portbuild ALL=(ALL) NOPASSWD: ALL

&prompt.root; mkdir portbuild &prompt.root; chown portbuild:portbuild portbuild &prompt.root; mkdir pkgbuild -&prompt.root; chown portbuild:portbuild pkgbuild -&prompt.root; mkdir squid +&prompt.root; chown portbuild:portbuild pkgbuild + + If you are using a local squid + cache: + + &prompt.root; mkdir squid &prompt.root; mkdir squid/cache &prompt.root; mkdir squid/logs &prompt.root; chown -R squid:squid squid @@ -1946,7 +1982,8 @@ portbuild ALL=(ALL) NOPASSWD: ALL

- As root, initialize the squid + If you are using a local squid + cache, as root, initialize the squid directories: squid -z @@ -2033,8 +2070,6 @@ MASTER_SITE_OVERRIDE= \ Suggested values: disconnected=1 -http_proxy="http://localhost:3128/" -squid_dir=/usr2/squid scratchdir=/usr2/pkgbuild client_user=portbuild sudo_cmd="sudo -H" @@ -2043,6 +2078,18 @@ rsync_gzip=-z infoseek_host=localhost infoseek_port=${tunelled-tcp-port} + If you will be using squid + on the client: + + http_proxy="http://localhost:3128/" +squid_dir=/usr2/squid + + If, instead, you will be using squid + on the server: + + +http_proxy="http://servername:3128/" + Possible other values: use_md_swap=1 @@ -2064,7 +2111,8 @@ ssh_cmd="/usr/local/bin/ssh" - Add an appropriate data_source entry to + If you are using ganglia, + add an appropriate data_source entry to /usr/local/etc/gmetad.conf: data_source "arch/location Package Build Cluster" 30 hostname @@ -2480,9 +2528,6 @@ zfs destroy -r a/snap/src-o How to configure a new head node (pointyhat instance) - Please talk to Mark Linimon before making any changes - to this section. - Basic installation @@ -2537,8 +2582,6 @@ fsck_y_enable="YES" apache22_enable="YES" apache_flags="" apache_pidfile="/var/run/httpd.pid" -gmetad_enable="YES" -gmond_enable="YES" inetd_enable="YES" inetd_flags="-l -w" mountd_enable="YES" @@ -2551,6 +2594,17 @@ rpc_lockd_enable="NO" rpc_statd_enable="YES" sendmail_enable="NONE" smartd_enable="YES" + + If you are using ganglia, + add: + + gmetad_enable="YES" +gmond_enable="YES" + + If you will be using a squid + cache on the server, rather than the clients: + + squid_enable="YES" @@ -2603,8 +2657,6 @@ devel/py-setuptools devel/subversion net/nc net/rsync -sysutils/ganglia-monitor-core (with GMETAD off) -sysutils/ganglia-webfrontend (compile with -DWITHOUT_X11) www/apache22 (with EXT_FILTER) Expect those to bring in, among others: @@ -2613,6 +2665,17 @@ www/apache22 (with EXT_FILTER) + If you are using ganglia, + add: + + sysutils/ganglia-monitor-core (with GMETAD off) +sysutils/ganglia-webfrontend (compile with -DWITHOUT_X11) + + If you will be using a squid + cache on the server, rather than the clients: + + www/squid (with SQUID_AUFS on) + The following ports (or their latest successors) are strongly suggested: devel/ccache