source: postlfs/filesystems/smartmontools.xml@ 5a38f35

10.1 11.0 ken/refactor-virt lazarus qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 5a38f35 was 5a38f35, checked in by Douglas R. Reno <renodr@…>, 11 months ago

smartmontools: Add the smartd systemd unit provided by the package
cifs-utils: Remove unnecessary autoreconf

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@24076 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 7.8 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY smartmontools-download-http "&sourceforge-dl;/smartmontools/smartmontools-&smartmontools-version;.tar.gz">
8 <!ENTITY smartmontools-download-ftp " ">
9 <!ENTITY smartmontools-md5sum "e8d134c69ae4959a05cb56b31172ffb1">
10 <!ENTITY smartmontools-size "972 KB">
11 <!ENTITY smartmontools-buildsize "24 MB">
12 <!ENTITY smartmontools-time "0.2 SBU">
13]>
14
15<sect1 id="smartmontools" xreflabel="smartmontools-&smartmontools-version;">
16 <?dbhtml filename="smartmontools.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>smartmontools-&smartmontools-version;</title>
24
25 <indexterm zone="smartmontools">
26 <primary sortas="a-smartmontools">smartmontools</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to smartmontools</title>
31
32 <para>
33 The <application>smartmontools</application> package contains utility
34 programs (smartctl, smartd) to control/monitor storage systems using the
35 Self-Monitoring, Analysis and Reporting Technology System (S.M.A.R.T.)
36 built into most modern ATA and SCSI disks.
37 </para>
38
39 &lfs10_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&smartmontools-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download (FTP): <ulink url="&smartmontools-download-ftp;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download MD5 sum: &smartmontools-md5sum;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download size: &smartmontools-size;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated disk space required: &smartmontools-buildsize;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated build time: &smartmontools-time;
71 </para>
72 </listitem>
73 </itemizedlist>
74
75 <bridgehead renderas="sect3">smartmontools Dependencies</bridgehead>
76
77 <bridgehead renderas="sect4">Optional (runtime)</bridgehead>
78 <para role="optional">
79 <xref role="runtime" linkend="curl"/> or
80 <xref role="runtime" linkend="lynx"/> or
81 <xref role="runtime" linkend="wget"/> (download tools), and
82 <xref role="runtime" linkend="gnupg2"/> (encrypted hard disks)
83 </para>
84
85 <para condition="html" role="usernotes">
86 User Notes: <ulink url="&blfs-wiki;/smartmontools"/>
87 </para>
88 </sect2>
89
90 <sect2 role="installation">
91 <title>Installation of smartmontools</title>
92
93 <para>
94 Install <application>smartmontools</application> by running the
95 following commands:
96 </para>
97
98<screen revision="sysv"><userinput>./configure --prefix=/usr \
99 --sysconfdir=/etc \
100 --with-initscriptdir=no \
101 --with-libsystemd=no \
102 --docdir=/usr/share/doc/smartmontools-&smartmontools-version; &amp;&amp;
103make</userinput></screen>
104
105<screen revision="systemd"><userinput>./configure --prefix=/usr \
106 --sysconfdir=/etc \
107 --docdir=/usr/share/doc/smartmontools-&smartmontools-version; &amp;&amp;
108make</userinput></screen>
109
110 <para>
111 This package does not come with a test suite.
112 </para>
113
114 <para>
115 Now, as the <systemitem class="username">root</systemitem> user:
116 </para>
117
118<screen role="root"><userinput>make install</userinput></screen>
119
120 </sect2>
121
122 <sect2 role="commands" revision="sysv">
123 <title>Command Explanations</title>
124
125 <para>
126 <parameter>--with-initscriptdir=no</parameter>: This switch suppresses
127 the default initialization script. See below for the BLFS script.
128 </para>
129
130 <para>
131 <parameter>--with-libsystemd=no</parameter>: This switch disables support
132 for the sd-notify notification system provided by systemd.
133 </para>
134
135 </sect2>
136
137 <sect2 role="configuration">
138 <title>Configuring smartmontools</title>
139
140 <sect3 id="smartmontools-config">
141 <title>Config File</title>
142 <para>
143 <filename>/etc/smartd.conf</filename>
144 </para>
145
146 <indexterm zone="smartmontools smartmontools-config">
147 <primary sortas="e-etc-smartd.conf">/etc/smartd.conf</primary>
148 </indexterm>
149 </sect3>
150
151 <sect3>
152 <title>Configuration Information</title>
153
154 <para>
155 See the embedded comments in <filename>/etc/smartd.conf</filename>
156 for detailed instructions on customizing the
157 <application>smartd</application> darmon.
158 </para>
159
160 </sect3>
161
162 <sect3 id="smartmontoools-init">
163 <title><phrase revision="sysv">Boot Script</phrase>
164 <phrase revision="systemd">Systemd Unit</phrase></title>
165
166 <para revision="sysv">
167 If you want the <application>smartd</application> daemon to
168 start automatically when the system is booted, install the
169 <filename>/etc/rc.d/init.d/smartd</filename> init script included
170 in the <xref linkend="bootscripts"/> package.
171 </para>
172
173
174 <para revision="systemd">
175 If you want the <application>smartd</application> daemon to
176 start automatically when the system is booted, enable the
177 systemd unit provided by the package by executing the
178 following command as the
179 <systemitem class="username">root</systemitem> user:
180 </para>
181
182 <indexterm zone="smartmontools smartmontoools-init">
183 <primary sortas="f-smartd">smartd</primary>
184 </indexterm>
185
186<screen role="root" revision="sysv"><userinput>make install-smartd</userinput></screen>
187
188<screen role="root" revision="systemd"><userinput>systemctl enable smartd</userinput></screen>
189 </sect3>
190
191 </sect2>
192
193 <sect2 role="content">
194 <title>Contents</title>
195
196 <segmentedlist>
197 <segtitle>Installed Programs</segtitle>
198 <segtitle>Installed Libraries</segtitle>
199 <segtitle>Installed Directories</segtitle>
200
201 <seglistitem>
202 <seg>
203 smartctl, smartd, and update-smart-drivedb
204 </seg>
205
206 <seg>
207 None
208 </seg>
209
210 <seg>
211 /usr/share/smartmontools, /usr/share/doc/smartmontools-6.4, and
212 /etc/smartd_warning.d
213 </seg>
214
215 </seglistitem>
216 </segmentedlist>
217
218 <variablelist>
219 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
220 <?dbfo list-presentation="list"?>
221 <?dbhtml list-presentation="table"?>
222
223 <varlistentry id="smartctl">
224 <term><command>smartctl</command></term>
225 <listitem>
226 <para>
227 is the control and monitor utility for SMART Disks.
228 </para>
229 <indexterm zone="smartmontools smartctl">
230 <primary sortas="b-smartctl">smartctl</primary>
231 </indexterm>
232 </listitem>
233 </varlistentry>
234
235 <varlistentry id="smartd">
236 <term><command>smartd</command></term>
237 <listitem>
238 <para>
239 is the SMART disk monitoring daemon.
240 </para>
241 <indexterm zone="smartmontools smartd">
242 <primary sortas="b-smartd">smartd</primary>
243 </indexterm>
244 </listitem>
245 </varlistentry>
246
247 <varlistentry id="update-smart-drivedb">
248 <term><command>update-smart-drivedb</command></term>
249 <listitem>
250 <para>
251 is the update tool for the smartmontools drive database.
252 </para>
253 <indexterm zone="smartmontools update-smart-drivedb">
254 <primary sortas="b-update-smart-drivedb">update-smart-drivedb</primary>
255 </indexterm>
256 </listitem>
257 </varlistentry>
258
259 </variablelist>
260 </sect2>
261</sect1>
Note: See TracBrowser for help on using the repository browser.