• Increase font size
  • Default font size
  • Decrease font size
Home Projects Managelogs managelogs Install Guide

managelogs Install Guide

E-mail Print
Read : 100 times
(0 votes, average 0 out of 5)



1. Installing a binary package
2. Installing from sources
     2.1. Prerequisites
     2.2. Building an RPM package
     2.3. Using configure/make
          2.3.1. Download
          2.3.2. Configure
          2.3.3. Compile
          2.3.4. Run self-tests
          2.3.5. Install
          2.3.6. Run
     2.4. Supported architectures

 


1 - Installing a binary package

Several binary packages are available :

Before installing a binary package, you need the following libraries to be present on the host (listed here with some usual package names) :

  • APR (Apache Portable Runtime) library (apr, libapr, libapr1)
  • Zlib library (zlib, zlib1g)
  • Bzip2 library (bzip2-libs, libbz2)

2 - Installing from sources

If you don't find a binary distribution corresponding to your environment, or if you prefer building the software by yourself, you will compile and install it from the sources.

There are two methods to compile the software : via the rpm build system, or through a more 'traditional' configure/make process. We'll start with the prerequisites, common to both methods and, then, detail each process.

2.1 - Prerequisites

Here is a list of software you need to compile managelogs, along with the corresponding package names on Redhat and Debian Linux distributions, and the location where you can get the sources if you need to compile them.

  Linux packages Sources
RedHat Debian
A C compiler (I personaly use and recommend gcc, but any ANSI-compliant C compiler should work) gcc http://gcc.gnu.org
the make utility make http://www.gnu.org/software/make/
the APR library, include files, and the apr configuration script. apr-devel libapr1-dev http://apr.apache.org
the Zlib library and include files zlib-devel zlib1g-dev http://www.zlib.net
the Bzip2 library and include files bzip2-devel libbz2-dev http://www.bzip.org

As far as I know, there is no requirement on the versions of these tools and libraries. I personaly built and tested managelogs with the following versions :

  • APR version 0.9 (distributed with Apache 2.0.x) and 1.3 (distributed with Apache 2.2.x)
  • Zlib version 1.2.3
  • Bzip2 version 1.0.1

2.2 - Building an RPM package

If your system supports the RPM package system, this may be the easiest way to compile and install managelogs. You will also prefer building a binary RPM package if you want to easily deploy managelogs to a set of hosts without having to compile it on each of them.

Here are the steps to follow :

  • Ensure the rpm-build package is installed on your system
  • Download the source RPM package from Github (choose the file with the '.src.rpm' suffix),
  • cd to the directory where you downloaded the file and run :
        rpmbuild --rebuild managelogs-*.src.rpm
       
    (replace '*' with your version of managelogs)
  • This will build a binary RPM package. By looking in the last lines displayed by the rpmbuild command, you will see a message saying 'Wrote: /usr/src/xxx/RPMS/xxx/managelogs-xxx.xxx.rpm'. This is the place where your resulting binary RPM package was created.
  • You can then distribute and install this package file the same as you would do with any other RPM package.
  • If the rpmbuild command failed, there may be a lot of causes. If you can't fix it, you should probably try the 'configure/make' method described below.

2.3 - Using configure/make

This is the 'manual' method.

Please note that this method builds and installs the software on a host, but, unlike the RPM-based method, does not create a package ready to be installed on other hosts.

2.3.1 - Download

Download the source package (the file ending in '.tar.gz') from Github and run :
    gunzip <managelogs-xxx.tar.gz | tar xvpf -

2.3.2 - Configure

Then, cd to the managelogs-x.x.x directory you just untared and run './configure'.

This will, by default, configure the software to be installed in /usr/local. If this is not what you want, set the '--prefix=' option. A lot of other options are available, run './configure --help' to list them.

Options specific to managelogs are :

  • --with-apr=<dir> : Find APR in <dir>
  • --with-zlib=<dir> : Find zlib in <dir> (or '--without-zlib' to suppress the zlib compression feature)
  • --with-bz2=<dir> : Find bzip2 in <dir> (or '--without-bz2' to suppress the bzip2 compression feature)

The configure script checks for the needed libraries and include files, and create the Makefiles.

2.3.3 - Compile

Run 'make'

2.3.4 - Run self-tests

Run 'make check'

2.3.5 - Install

Run 'make install'. This will install :

  • the managelogs executable
  • the logmanager.h include file
  • the logmanager library
  • the managelogs.8 man page

2.3.6 - Run

If you just want to run managelogs on this host, without deploying it on other systems, the easiest solution is to keep the library packages you installed to compile it, as they include the runtime pre-requisites.

Of course, the build tree can (and should) be removed after the installation phase, as the runtime never uses it.

2.4 - Supported architectures

managelogs should compile and run on any POSIX-compliant system without modifications. If this is not the case, consider it as a bug and report it.

Windows users: Sorry, no Windows version at the moment...

Mac users : According to Softpedia, managelogs compiles and works without modification on Mac OS X. Unfortunately, I cannot try it by myself as I don't even know anybody owning a Mac. So, if you run managelogs on a Mac, I'd appreciate your feedback.

 

Please login or register to add a comment