{{{
#!div style="border: 1pt solid; float:right; padding:10px; background-color: #E6E6FA; margin-left:30px;"
'''Menu'''[[BR]]
[[BR]]
[wiki:Download Download Instructions][[BR]]
[wiki:TocDoc Documentation][[BR]]
[wiki:Help][[BR]]
[wiki:TocSupport Device Support][[BR]]
[wiki:TocDeveloper Developers Area][[BR]]
[wiki:Links]
}}}
= Smartmontools Download and Installation =
[[PageOutline(2-3,Table of Contents, inline)]]
----
Smartmontools 5.40 was released 2010-10-16, see [source:tags/RELEASE_5_40/smartmontools/NEWS NEWS], [source:tags/RELEASE_5_40/smartmontools/CHANGELOG CHANGELOG] and [http://sourceforge.net/query?group=status&milestone=Release+5.40 tickets] for details.
----
After installation or booting from a [#ListofbootableCDs Live-CD], you can read smartmontools man pages and try out the commands:
{{{
man smartd.conf
man smartctl
man smartd
# Only root can do this
/usr/sbin/smartctl -s on -o on -S on /dev/hda
/usr/sbin/smartctl -a /dev/hda
}}}
Note that the default location for the manual pages are
{{{/usr/share/man/man5}}} and {{{/usr/share/man/man8}}}.
If '{{{man}}}' doesn't find them, then you may need to add
{{{/usr/share/man}}} to your {{{MANPATH}}} environment variable.
The [#Windows-InstalltheWindowspackage Windows package] provides
preformatted man pages in {{{*.html}}} and {{{*.txt}}} format.
----
== Install precompiled package ==
Precompiled packages are available for many distributions.
The following table provides links to info and/or download
locations:
{{{
#!html
}}}
----
=== Debian Linux - Install the Debian package ===
All versions of the smartmontools package in ''.deb'' format are available at the [http://packages.debian.org/search?keywords=smartmontools&searchon=names&suite=all§ion=all Debian package search page]. You can then install the package using:
{{{
# you need to be root to do this:
dpkg -i smartmontools_5.39-1_i386.deb
}}}
----
=== Red Hat Enterprise Linux, CentOS and Fedora Linux distributions ===
The smartmontools package is part of the official repositories and can be installed using the {{{yum}}} command:
{{{
# you need to be root to do this:
yum install smartmontools
}}}
----
=== Other distributions providing RPM packages ===
Download the latest binary RPM file ({{{smartmontools*.rpm}}}) for your
distribution. Don't get the SRPM file ({{{*.src.rpm}}}).
Install it using RPM.
{{{
# you need to be root to do this:
rpm -ivh smartmontools_5.39-1_i386.deb
}}}
If you want to remove the package ({{{rpm -e smartmontools}}})
and your system does not have {{{chkconfig}}} installed, you may need
to use:
{{{
rpm -e --noscripts smartmontools
}}}
----
=== Windows - Install the Windows package ===
Download and run the latest smartmontools [http://nsis.sourceforge.net/Main_Page NSIS]-installer ({{{*.win32-setup.exe}}}) from [http://sourceforge.net/projects/smartmontools/files/ here].
More recent Windows test releases build from SVN snapshots are available [http://smartmontools-win32.dyndns.org/smartmontools/ here].
The default install type "Full" creates start menu shortcuts including an uninstaller, and adds the install directory to the PATH variable. Select install type "Extract files only" to disable these extra components. If the [http://www.ubcd4win.com/ UBCD4Win]-builder is installed, the extra option "UBCD4Win plugin" can be used to add smartmontools to UBCD4Win.
Virus scanners occasionally produce false positive virus reports for NSIS-installers, see the [http://nsis.sourceforge.net/NSIS_False_Positives NSIS False Positives page]. If this is the case for the smartmontools installer, please send a report to the [mailto:smartmontools-support@lists.sourceforge.net smartmontools-support mailing list].
Starting with smartmontools release 5.37, the Windows package is no longer provided as a ZIP archive ({{{*.win32.zip}}}). If the self extracting installer cannot be used for some reason, the files may also be unpacked by a recent version of [http://www.7-zip.org/ 7-Zip].
To use the smartd warning mail feature, download and install the [http://www.blat.net/ Blat] mail utility. See the [http://wpkg.org/Smartmontools WPKG-Wiki] for info about automated deployment of smartmontools and Blat.
----
== Install from the source tarball ==
Download the latest source tarball from [http://sourceforge.net/projects/smartmontools/files/ here].
Uncompress the tarball:
{{{
tar zxvf smartmontools-5.40.tar.gz
}}}
The previous step created a directory called {{{smartmontools-5.40}}}
containing the code. Go to that directory, build, and install:
{{{
cd smartmontools-5.40
./configure
make
# you need to be root to do this:
make install
}}}
These optional arguments of {{{./configure}}} are fully explained in the
[source:/trunk/smartmontools/INSTALL INSTALL] file.
The most important one is {{{--prefix}}} to change the default installation directories.
If you don't pass any arguments to {{{./configure}}} all files will reside under
{{{/usr/local}}} to not interfere with files from your distribution.
To compile from another directory (avoids overwriting virgin files from the smartmontools package)
replace {{{./configure [options]}}} by:
{{{
mkdir objdir
cd objdir
../configure [options]
}}}
To install to another destination (useful for testing and to avoid overwriting an existing smartmontools installation)
replace {{{make install}}} by:
{{{
make DESTDIR=/home/myself/smartmontools-test install
}}}
Use a full path: {{{~/smartmontools-test}}} would work but {{{./smartmontools-test}}} won't.
The smartmontools binaries for Windows can also be build from the source tarball (or from SVN)
using the [http://www.mingw.org/ MinGW] or the [http://mingw-w64.sourceforge.net/ MinGW-w64]
compiler. Build environments may be [http://cygwin.com Cygwin] or [http://www.mingw.org/wiki/MSYS MSYS],
cross-compilation under Linux is also supported.
Extra {{{./configure}}} arguments {{{--host=...}}} and {{{--build=...}}} may be required.
The {{{make install}}} command does not work for Windows.
See [source:/trunk/smartmontools/INSTALL INSTALL] file for details.
----
== Install latest unreleased code from SVN repository ==
We moved from CVS to a Subversion (SVN) repository.
The new address for our repository is
[https://smartmontools.svn.sourceforge.net/svnroot/smartmontools].
Two repository browsers are available:
[http://smartmontools.svn.sourceforge.net/viewvc/smartmontools ViewVC] and [source:/ Trac].
For those, who don't already have a Subversion client installed,
here is a [http://subversion.apache.org/packages.html list of SVN Packages] and a
[http://en.wikipedia.org/wiki/Comparison_of_Subversion_clients comparison of SVN clients]
for different operating systems and in all colors and flavours. (Stand-alone clients,
Desktop-integrated clients, IDE plug-in clients, ..)
All you need to do to get the latest development code is
(but note that the development code may be unstable, and that the
documentation and code may be inconsistent):
{{{
svn co https://smartmontools.svn.sourceforge.net/svnroot/smartmontools/trunk/smartmontools smartmontools
}}}
This will create a subdirectory called {{{smartmontools/}}} containing the
code. Go to that directory, build, and install:
{{{
cd smartmontools
./autogen.sh
./configure
make
# you need to be root to do this:
make install
}}}
See notes under [#Installfromthesourcetarball Install from source tarball] for different options to {{{./configure}}}
and other useful remarks.
To update your sources from trunk (development version):
{{{
cd smartmontools
svn update
}}}
One of the really cool things about version control systems is that you can get
''any'' version of the code you want, from the first release up the
the most current development version. And it's trivial, because
each release is __tagged__ with a name. Look at the
[source:/tags/ tags in our SVN repository] to see what the different names are.
E.g. run the following command to fetch the RELEASE_5_38 release:
{{{
svn co https://smartmontools.svn.sourceforge.net/svnroot/smartmontools/tags/RELEASE_5_38/sm5 smartmontools
}}}
Note that the directory with the smartmontools sourcefiles is named '''{{{sm5}}}''' in
releases <= 5.39.
The rest of the build procedure is the same like described above.
----
== Update the drive database ==
Starting with smartmontools 5.40 the drive database file {{{drivedb.h}}} can be updated separately with the following command:
{{{
# /usr/sbin/update-smart-drivedb
}}}
This command uses [http://curl.haxx.se/ curl], [http://www.gnu.org/software/wget/ wget] or [http://lynx.isc.org/ lynx] for download. A proxy server can be specified by the environment variable {{{http_proxy}}} (lower case only), see the man pages of the above commands.
This does not work on Windows. Download the file {{{drivedb.h}}} from [http://smartmontools.svn.sourceforge.net/viewvc/smartmontools/trunk/smartmontools/drivedb.h?revision=HEAD SVN trunk] instead and copy it into the directory where the exe files are installed.
Smartmontools releases 5.39 and 5.39.1 also support drive database update if the build was configured with {{{--enable-drivedb}}}.
The {{{drivedb.h}}} file from the SVN trunk is not compatible with these releases.
A compatible version of drivedb.h is maintained on branch [source:/branches/RELEASE_5_39_DRIVEDB RELEASE_5_39_DRIVEDB].
Download this version of {{{drivedb.h}}} from
[http://smartmontools.svn.sourceforge.net/viewvc/smartmontools/branches/RELEASE_5_39_DRIVEDB/smartmontools/drivedb.h?revision=HEAD here]
and copy it into the configured directory (typically {{{/usr/share/smartmontools}}} or {{{/usr/local/share/smartmontools}}}).
----
== Run smartmontools from Live-system ==
If you have a system that is showing signs of disk trouble (for
example, it's unbootable and the console is full of disk error
messages) it can be handy to have a version of smartmontools that can
be run off of a bootable medium to examine the disk's SMART data and run
self-tests. This is also useful if you want to run Captive Self-Tests
(the '''{{{-C}}}''' option of {{{smartctl}}} ) on disks that can not easily be unmounted,
such as those hosting the Operating System files. Or you can use
this to run {{{smartctl}}} on computers that don't use Linux as the
day-to-day operating system.
=== List of bootable CDs ===
{{{
#!html
}}}
Please let us know if there are others, and we will add them to this list.
[http://docs.fedoraproject.org/en-US/Fedora/14/html/Fedora_Live_Images/index.html Fedora Live CD] is no longer included in the list because recent releases no longer contain smartmontools.
----
'''License'''[[BR]]
All content in this wiki is published under [http://www.gnu.org/licenses/gpl-2.0.html#SEC1 GNU GPL].