gkrellm/INSTALL

Debian package installation:
============================
GKrellM is in the Debian archives, you can install using apt-get:

  apt-get update
  apt-get install gkrellm



RedHat package installation:
============================
Fresh install:
  rpm -i gkrellm-X.Y.Z-1.i386.rpm
or, upgrade
  rpm -U gkrellm-X.Y.Z-1.i386.rpm



Installation from source:
=========================
First untar the tarball:
------------------------
  tar -xvjf gkrellm-X.Y.Z.tar.bz2
  cd gkrellm-X.Y.Z

Next compile and install GKrellM for your target system.
BSD systems need to use gmake (GNU make) instead of the BSD make.
See below for custom gkrellmd server installs and for installs
into specific directories.
--------------------------------------------------------

Linux
-----
  make
  make install


FreeBSD 2.x
-----------
  make freebsd2
  make install_freebsd


FreeBSD 3.x and 4.x or later
----------------------------
  make freebsd
  make install_freebsd


NetBSD 2.X, 3.X and later
---------------------------------
  make netbsd2
  make install_netbsd


NetBSD 1.5 - 1.6.X
---------------------------------
  make netbsd1
  make install_netbsd


OpenBSD
---------------------------------
  make openbsd
  make install_openbsd

Note: install_openbsd makes gkrellm setgid kmem so it can be run non-root, ie:
  chgrp kmem /usr/local/bin/gkrellm
  chmod g+sx /usr/local/bin/gkrellm


Solaris 2.x (8 tested so far)
-----------------------------
  make solaris
  make install_solaris

Note: install_solaris makes gkrellm setgid sys so it can be run non-root, ie:
  chgrp sys /usr/local/bin/gkrellm
  chmod g+s /usr/local/bin/gkrellm
  (see below for additional Solaris install notes)


Windows 2000/XP (Vista is untested)
-----------------------------
  make windows
  make INSTALLROOT=C:\gkrellm install_windows

Needed software for building gkrellm on win32 systems:
  - MinGW
  - MSYS (gkrellm Makefiles are NOT compatible with cmd.exe)
  - GTK >= 2.4 Development files (see http://www.gimp.org/~tml/gimp/win32/)
  - OpenSSL (optional), GnuTLS is not recommended on win32

Note: Installing gkrellm on windows needs INSTALLROOT set, the default path
      (/usr/local) probably won't work


BSD make Problems
-----------------
On BSD systems, errors like:
    "Makefile", line 21: Missing dependency operator
result from using BSD make.  You need to use gmake.

If you get the error:
    ld: invalid command option `-E'
re-run the make without any link flags, eg:
    gmake openbsd LINK_FLAGS=


==========================================================================
Customizing the install directory locations
-------------------------------------------
The default install is under the INSTALLROOT /usr/local, and this is the
default directory install tree:

/usr/local                        INSTALLROOT
          /bin/                    both gkrellm and gkrellmd
          /include/gkrellm2/       development include files
          /share/locale/XX/        LC_MESSAGES/gkrellm.mo (XX is cs, de, ...)
          /man/man1/               gkrellm.1 and gkrellmd.1
          /lib/pkgconfig/          gkrellm.pc

The INSTALLROOT and/or individual install directory locations may be changed.
For example, use INSTALLROOT to install everything under /usr:

    make install INSTALLROOT=/usr

For package maintainers convenience, INSTALLROOT may be constructed from
DESTDIR and PREFIX.  So if INSTALLROOT is not specified, you can then
set either or both of DESTDIR and PREFIX to construct your effective
INSTALLROOT.  For example, a /foo/usr INSTALLROOT would result from:

    make install DESTDIR=/foo PREFIX=/usr

For finer grained control of individual install directories, use INSTALLDIR
(for gkrellm), INCLUDEDIR, MANDIR (for gkrellm.1), LOCALEDIR, SINSTALLDIR
(for gkrellmd), and SMANDIR (for gkrellmd.1).  When a DIR variable is given,
INSTALLROOT is ignored for that directory and the complete directory path
must be given.

For example, this command installs under /usr for all except the gkrellmd
server which is put in /opt/sbin:

    make install INSTALLROOT=/usr SINSTALLDIR=/opt/sbin

The install of i18n translation files is additionally sensitive to the
environment variable LOCALEDIR if it set.  A command line LOCALEDIR takes
precedence over an environment variable LOCALEDIR. See the po/README file
for examples.  Also, the install of translation files may be omitted with:

    make install enable_nls=0


==========================================================================
Custom gkrellmd server installs:
--------------------------------
1) The default top level make will compile a gkrellmd server using glib2.
   However, a gkrellmd server using glib-1.2 can be compiled for systems
   without the glib2 version with:

      make glib12=1

2) If the target server has glib installed but no gtk or Xlibs, then gkrellmd
   may be built on the target server by working in the gkrellmd server
   directory:

      cd gkrellm-2.x.y/server

      make
   or
      make glib12=1

      make install

   If not on Linux, remember to specify a make target as for a top level
   make.  That is, use "make freebsd", etc and "make install_freebsd", etc.
   This installs gkrellmd into /usr/local/bin and gkrellmd.1 into
   /usr/local/share/man/man1, but if you want to install somewhere else,
   do for example:

      make SMANDIR=/usr/share/man/man1 SINSTALLDIR=/usr/bin install
or
      make INSTALLROOT=/usr install


==========================================================================
Other make flags:
-----------------
To compile a binary with debugging symbols (-g compiler option):

	make debug=1



============================================================================
Making a RPM package from the source tarball:
---------------------------------------------

Copy the gkrellm.spec file from inside the tarball to:

    /usr/src/RPM_DIR/SPECS

where you should substitute for "RPM_DIR" something like "redhat", "RPMS", or
whatever is appropriate for your distribution.
Make this "RPM_DIR" substitution in the steps below.
Also, it's possible some distributions will require an edit of the
gkrellm.spec "Requires" line.  For example, on Mandrake you may have
to change it to:
Requires:	gtk+2.0 >= 2.0, glib2 >= 2.0

If your rpm can't handle tar.bz2 files, you need to convert the source tarball
gkrellm-X.Y.Z.tar.bz2 into a gkrellm-X.Y.Z.tar.gz with an untar and tar.

Copy the gkrellm source tarball to:

    /usr/src/RPM_DIR/SOURCES

Then make the RPMs:

    cd /usr/src/RPM_DIR/SPECS
    rpm -ba --clean gkrellm.spec

Then you should have for a GKrellM version X.Y.Z the RPM packages:

    /usr/src/RPM_DIR/RPMS/$ARCH/gkrellm-X.Y.Z-1.rpm
    /usr/src/RPM_DIR/SRPMS/gkrellm-X.Y.Z-1.src.rpm




==========================================================================
==========================================================================
Solaris install notes:
----------------------
Tested to be built as 32bit application with gcc on UltraSPARC only.
It should work on both 32bit and 64bit kernel. The Solaris port currently
utilizes kvm to get a value for proc.n_forks. It imposes a few restrictions: 

1) gkrellm for Solaris should be setgid sys as mentioned above. 

2) On Solaris, 32bit binary of gkrellm cannot run on 64bit kernel while 
   maintaining its full functionality and vice versa. 

   a) It cannot acquire "number of forks" on a different data model of 
      the kernel image from its own origin (i.e. binary incompatibility 
      between 32bit and 64bit). This is caused by restriction of kvm just
      as mentioned above. For more details, refer to kvm_open(3kvm).
   b) Since a single driver called 'sd' takes control over both hard drives 
      and cdroms, "Disks" monitor includes not just i/o activity of hard 
      drives but of CDROM or CD-RW's. I don't like this, so a function 
      called isharddisk() is implemented in order to exclude i/o activity 
      of removable media. If you don't use "composite disk" for monitoring 
      and pick drives of your interest, this wouldn't bother you anyway.

   Failure of these functions is silently ignored and it proceeds without
   the failed functionalities. Separate executable should be built for each 
   data models (32bit and 64bit kernel) to enjoy full functionality 
   including ones described above. 

Functionalities not supported currently are: Battery, CPU/Motherboard 
sensor, Net Timer (PPP) and swap in/out chart.


==========================================================================
libgtop install notes:
----------------------
If you have libgtop (plus development libs) installed, you can make
a version that uses libgtop to read system data.   A libgtop version
will not have a disk, internet, or battery monitor because libgtop does not
report these stats.

--If you have gnome (plus libgnome-dev) and either libgtop 1.1.x or 1.0.x:
	make gnome-gtop
	make install

--If you have libgtop 1.1.x:
	make gtop
	make install

--If you have libgtop 1.0.x edit the top level Makefile to uncomment GTOP lines
	make gtop1.0
	make install