From owner-svn-doc-projects@FreeBSD.ORG Sat May 18 19:56:00 2013 Return-Path: Delivered-To: svn-doc-projects@freebsd.org Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id B1F808DF; Sat, 18 May 2013 19:56:00 +0000 (UTC) (envelope-from trhodes@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 944EB9D; Sat, 18 May 2013 19:56:00 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.6/8.14.6) with ESMTP id r4IJu0Xi001538; Sat, 18 May 2013 19:56:00 GMT (envelope-from trhodes@svn.freebsd.org) Received: (from trhodes@localhost) by svn.freebsd.org (8.14.6/8.14.5/Submit) id r4IJu0kK001534; Sat, 18 May 2013 19:56:00 GMT (envelope-from trhodes@svn.freebsd.org) Message-Id: <201305181956.r4IJu0kK001534@svn.freebsd.org> From: Tom Rhodes Date: Sat, 18 May 2013 19:56:00 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-projects@freebsd.org Subject: svn commit: r41664 - in projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook: config network-servers X-SVN-Group: doc-projects MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-projects@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for doc projects trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 18 May 2013 19:56:00 -0000 Author: trhodes Date: Sat May 18 19:55:59 2013 New Revision: 41664 URL: http://svnweb.freebsd.org/changeset/doc/41664 Log: Mark up syslogd and newsyslogd in tags in the section titles. Add an introduction to the tuning disks chapter. Modified: projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook/config/chapter.xml projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml Modified: projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook/config/chapter.xml ============================================================================== --- projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook/config/chapter.xml Sat May 18 18:24:11 2013 (r41663) +++ projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook/config/chapter.xml Sat May 18 19:55:59 2013 (r41664) @@ -1362,7 +1362,7 @@ ifconfig_fxp0_alias7="inet 202.0.75.20 n Configuring the System Logger, - &man.syslogd.8; + syslogd system logging syslog @@ -1383,7 +1383,7 @@ ifconfig_fxp0_alias7="inet 202.0.75.20 n linkend="network-syslogd"/>. - Using &man.syslogd.8; + Using <command>syslogd</command> In the default &os; configuration, &man.syslogd.8; is started at boot. This is controlled by the variable @@ -1401,7 +1401,7 @@ ifconfig_fxp0_alias7="inet 202.0.75.20 n - Configuring &man.syslogd.8; + Configuring <command>syslogd</command> syslog.conf @@ -1541,7 +1541,7 @@ cron.* Log Management and Rotation with - &man.newsyslog.8; + newsyslog newsyslog newsyslog.conf @@ -1563,7 +1563,7 @@ cron.* Configuring - &man.newsyslog.8; + newsyslog To know which actions to take, &man.newsyslog.8; reads its configuration file, by default @@ -1959,6 +1959,19 @@ device_probe_and_attach: cbb0 attach ret Tuning Disks + The following section will discuss various tuning + mechanisms and options which may be applied to disk + devices. In many cases, disks with mechanical parts, + such as SCSI drives, will be the bottle + neck driving down the overall system performance. While + a solution is to install a drive without mechanical parts, + such as a solid state drive, mechanical drives are not + going away anytime in the near future. When tuning disks, + it is advisable to utilize the features of the &man.iostat.8; + command to test various changes to the system. This + command will allow the user to obtain valuable information + on system IO. + Sysctl Variables Modified: projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml ============================================================================== --- projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml Sat May 18 18:24:11 2013 (r41663) +++ projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml Sat May 18 19:55:59 2013 (r41664) @@ -5682,7 +5682,7 @@ driftfile /var/db/ntp.driftCentralized logging to a specific logging host can reduce some of the administrative burden of log file administration. - Log file aggregation, merging and rotation can be configured in + Log file aggregation, merging and rotation may be configured in one location, using the native tools of &os;, such as &man.syslogd.8; and &man.newsyslog.8;. In the following example configuration, host A, named - syslogd has been configured to accept remote messages - from client machines; + syslogd has been configured to + accept remote messages from client machines; - The syslogd server and all client machines must have - valid entries for both forward and reverse - DNS, or be properly configured in - /etc/hosts. + The syslogd server and all client + machines must have valid entries for both forward and + reverse DNS, or be properly configured + in /etc/hosts. @@ -5770,13 +5770,14 @@ syslogd_flags="-a logclient.example.com does not matter, but &man.touch.1; works great for situations such as this: - &prompt.root; touch /var/log/logclient.log + &prompt.root; touch + /var/log/logclient.log At this point, the syslogd daemon should be restarted and verified: - &prompt.root; service syslogd restart -&prompt.root; pgrep syslog + &prompt.root; service syslogd restart +&prompt.root; pgrep syslog If a PID is returned, the server has been restarted successfully, and client configuration may @@ -5851,13 +5852,14 @@ syslogd_flags="-s -v -v"Once added, syslogd must be restarted for the changes to take effect: - &prompt.root; service syslogd restart + &prompt.root; service syslogd restart To test that log messages are being sent across the network, use &man.logger.1; on the client to send a message to syslogd: - &prompt.root; logger "Test message from logclient" + &prompt.root; logger + "Test message from logclient" This message should now exist both in /var/log/messages on the client, and @@ -5888,7 +5890,7 @@ syslogd_flags="-s -v -v"syslogd_flags="-d -a logclien.example.com -v -v" - &prompt.root; service syslogd restart + &prompt.root; service syslogd restart Debugging data similar to the following will flash on the screen immediately after the restart: @@ -5913,7 +5915,7 @@ rejected in rule 0 due to name mismatch. logclien. After the proper alterations are made, a restart is issued with expected results: - &prompt.root; service syslogd restart + &prompt.root; service syslogd restart logmsg: pri 56, flags 4, from logserv.example.com, msg syslogd: restart syslogd: restarted logmsg: pri 6, flags 4, from logserv.example.com, msg syslogd: kernel boot file is /boot/kernel/kernel