[[PageOutline(1-4,Table of Contents)]]
= Smartmontools Download and Installation =
Smartmontools 5.38 (stable) was released 2008/03/10, see [http://smartmontools.svn.sourceforge.net/viewvc/smartmontools/tags/RELEASE_5_38/sm5/NEWS?view=markup NEWS] and [http://smartmontools.svn.sourceforge.net/viewvc/smartmontools/tags/RELEASE_5_38/sm5/CHANGELOG?view=markup CHANGELOG] 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.
----
== 1. Install precompiled package ==
Starting with smartmontools release 5.37, RPM files
are no longer available at the smartmontools project download page.
Refer to the package download location of your distribution.
{{{
#!html
-
Distribution |
Package |
Version |
Repository |
Download-URL |
Debian |
smartmontools |
5.38-2+lenny1 |
stable |
Download |
Debian |
smartmontools |
5.38-3 |
testing |
Download |
Fink |
gsmartcontrol |
0.8.4-1002 |
|
Download |
Fink |
smartmontools |
5.38-1 |
|
Download |
Fink |
smartmontools-daemon |
5.38-1 |
|
Download |
FreeBSD |
gsmartcontrol |
0.8.4 |
sysutils |
Download |
FreeBSD |
smartmontools |
5.38_6 |
sysutils |
Download |
Gentoo |
smartmontools |
5.36-r1 |
|
Download |
Gentoo |
smartmontools |
5.37 |
|
Download |
Gentoo |
smartmontools |
5.37-r1 |
|
Download |
Gentoo |
smartmontools |
5.38 |
|
Download |
MacPorts |
smartmontools |
5.38 |
|
Download |
Mandriva |
smartmontools |
5.38-3 |
|
Download |
Mandriva |
smartmontools-debug |
5.38-3 |
|
Download |
NetBSD |
smartmontools |
5.38 |
sysutils |
Download |
OpenBSD |
smartmontools |
5.38 |
|
Download |
openSUSE |
smartmontools |
5.38.0.20090603 |
sbrabec |
Download |
openSUSE |
smartmontools |
5.38.0.20081027 |
suse/oss |
Download |
Slackware |
smartmontools-5.38-i486-1.txz |
5.38 |
|
Download |
Ubuntu |
smartmontools |
5.38-1ubuntu2 |
|
Download |
}}}
----
==== 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].
If you're running Debian [http://www.debian.org/releases/stable/ stable] please download a backport to stable [http://www.backports.org/debian/pool/main/s/smartmontools/ here]. These packages are provided by [http://www.backports.org/dokuwiki/doku.php www.backports.org].
You can then install the package using:
{{{
dpkg -i smartmontools_5.36-1_i386.deb
}}}
If you prefer to fetch the packages using apt, please read the instructions at [http://www.backports.org/dokuwiki/doku.php?id=instructions backports.org].
----
==== Red Hat Enterprise Linux, CentOS^1^ 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
}}}
^1^ For CentOS in versions 5 and newer
----
==== 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 must be {{{root}}} to do this!''
{{{
su root # -> enter root password
rpm -ivh smartmontools-5.33-6.i586.rpm
For most users, this is all that is needed.
}}}
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
}}}
----
==== Install the Cygwin package - Windows with [http://cygwin.com/ Cygwin] installed ====
Starting with CVS snapshot 2005-11-15, smartmontools is part of the [http://cygwin.com/packages/ Cygwin distribution].
A list of available smartmontools packages and their contents is
[http://cygwin.com/packages/smartmontools/ here].
To update your installation, click on the "Install or update now!"
link on the [http://cygwin.com/ Cygwin web page].
This downloads {{{setup.exe}}} to your system.
Then, run setup and answer all of the questions.
Select smartmontools package in the "Utils" category.
The optional source package ({{{smartmontools-*-src.tar.bz2}}})
can be used to build both the Cygwin and the Windows binary packages
on Cygwin. Refer to the file {{{/usr/share/doc/Cygwin/smartmontools-*.README}}}
for details.
----
==== 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].
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.
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].
More recent (and probably unstable) Windows test releases build from CVS snapshots are available [http://smartmontools-win32.dyndns.org/smartmontools/ here].
----
== 2. Install from the source tarball ==
For operating systems: Linux/Solaris/FreeBSD/NetBSD/OpenBSD/Cygwin
Download the latest source tarball from [http://sourceforge.net/projects/smartmontools/files/ here].
Note: you probably want the most recent stable release. Stable releases have
even-numbered extensions, and unstable experimental releases have
odd-numbered extensions.
Uncompress the tarball:
{{{
tar zxvf smartmontools-5.38.tar.gz
}}}
The previous step created a directory called {{{smartmontools-5.38}}}
containing the code. Go to that directory, build, and install:
{{{
cd smartmontools-5.38
./configure
make
make install
}}}
For releases >=5.19, {{{./configure}}} can take optional arguments. These optional arguments are fully explained in the
[http://smartmontools.svn.sourceforge.net/viewvc/smartmontools/trunk/smartmontools/INSTALL?view=markup INSTALL]
file. The most important one is {{{--prefix}}} to change the default installation directories.
''Please note that the default installation location changed in versions >=5.31''.
If you don't pass any arguments to {{{./configure}}} all files will reside under
{{{/usr/local}}} to not interfere with files from your distribution. For more detailed
information please also refer to the
[http://smartmontools.svn.sourceforge.net/viewvc/smartmontools/trunk/smartmontools/INSTALL?view=markup INSTALL] document.
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}}} won't work.
Unless the destination directory is your home directory (or a location that you have write permission)
{{{
# only root can do that:
make install
}}}
----
== 3. Install latest unreleased code from SVN repository ==
We moved from CVS to a Subversion (SVN) repository.
The new address for our repository is
[http://smartmontools.svn.sourceforge.net/viewvc/smartmontools https://smartmontools.svn.sourceforge.net/svnroot/smartmontools]
For those, who don't already have a Subversion client installed,
here is a [http://subversion.tigris.org/links.html#clients list 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
make install
}}}
See notes under [#a2.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
[http://smartmontools.svn.sourceforge.net/viewvc/smartmontools/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.38.
The rest of the build procedure is the same like described above, with one exception:
- Skip {{{./autogen.sh}}} and {{{./configure}}} for tagged releases
<= 5.1-18 (RELEASE_5_X_Y, where X = 0 or 1 and Y = 0 to 18).
----
== 4. 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 CD or floppy 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 ====
[http://www.finnix.org/ Finnix Live Bootable CD][[BR]]
[http://docs.fedoraproject.org/release-notes/f7/en_US/sn-Live.html Fedora Core 7 Live Bootable CD][[BR]]
[http://www.lnx-bbc.com/ LNX-BBC Bootable CD][[BR]]
[http://www.stresslinux.org/ Stresslinux Bootable CD][[BR]]
[http://www.tux.org/pub/people/kent-robotti/looplinux/rip/ RIP (Recovery Is Possible) Bootable CD][[BR]]
[http://www.sysresccd.org/Main_Page SystemRescueCd][[BR]]
[http://www.gpstudio.com/stux/ STUX Bootable CD][[BR]]
[http://partedmagic.com/ Parted Magic] (also contains [http://gsmartcontrol.berlios.de/ GSmartControl])[[BR]]
[http://www.knopper.net/knoppix/index-en.html Knoppix][[BR]]
[http://packages.debian.org/testing/utils/smartmontools Debian/testing] based CD)[[BR]]
[http://www.gentoo.org/ Gentoo Installer LiveCD][[BR]]
[http://grml.org/ grml Linux Live-CD] ([http://packages.debian.org/unstable/utils/smartmontools Debian/unstable] based CD, smartmontools is also included in [http://grml.org/faq/#whatissmall grml-small])[[BR]]
[http://ubuntu-rescue-remix.org/ Ubuntu Rescue Remix][[BR]]
[http://smartlinux.sourceforge.net/ S.M.A.R.T. Linux] (a bootable FLOPPY containing smartmontools!)[[BR]]
[http://www.inside-security.de/insert_en.html INSERT (Inside Security Rescue Toolkit)] (Knoppix based CD)[[BR]]
[http://www.911cd.net/forums/index.php?showtopic=13459 Smartctl Plugin] for [http://www.nu2.nu/pebuilder/ BartPE bootable live windows CD][[BR]]
A plugin for the [http://www.ubcd4win.com/] UBCD4Win] can be created by the [#Windows-InstalltheWindowspackage smartmontools windows installer][[BR]]
The [http://www.ultimatebootcd.com/ UBCD] 5.0 beta contains PartedMagic (above), see also note about UBCD [http://smartmontools.sourceforge.net/faq.html#UBCD in the FAQ]
Please let us know if there are others, and we will add them to this list.
----
'''License'''[[BR]]
All content in this wiki is published under [http://www.gnu.org/licenses/gpl-2.0.html#SEC1 GNU GPL].