Copyright © tutorialspoint.com

# log4j - Installation

Log4j API package is distributed under the Apache Software License, a fully-fledged open source license certified by the open source initiative.

The latest log4j version, including full-source code, class files and documentation can be found at http://logging.apache.org/log4j/.

Once downloaded apache-log4j-x.x.x.tar.gz do the following:

## Step 1:

Unzip and untar the downloaded file in /usr/local/ directory as follows:

    $ gunzip apache-log4j-1.2.15.tar.gz
    $ tar -xvf apache-log4j-1.2.15.tar
    apache-log4j-1.2.15/tests/input/
    apache-log4j-1.2.15/tests/input/xml/
    apache-log4j-1.2.15/tests/src/
    apache-log4j-1.2.15/tests/src/java/
    apache-log4j-1.2.15/tests/src/java/org/
    .......................................

While untarring, it would create a directory hierarchy with a name apache-log4j-x.x.x as follows:

    -rw-r--r--  1 root root   3565 2007-08-25 00:09 BUILD-INFO.txt
    -rw-r--r--  1 root root   2607 2007-08-25 00:09 build.properties.sample
    -rw-r--r--  1 root root  32619 2007-08-25 00:09 build.xml
    drwxr-xr-x 14 root root   4096 2010-02-04 14:09 contribs
    drwxr-xr-x  5 root root   4096 2010-02-04 14:09 examples
    -rw-r--r--  1 root root   2752 2007-08-25 00:09 INSTALL
    -rw-r--r--  1 root root   4787 2007-08-25 00:09 KEYS
    -rw-r--r--  1 root root  11366 2007-08-25 00:09 LICENSE
    -rw-r--r--  1 root root 391834 2007-08-25 00:29 log4j-1.2.15.jar
    -rw-r--r--  1 root root    160 2007-08-25 00:09 NOTICE
    -rwxr-xr-x  1 root root  10240 2007-08-25 00:27 NTEventLogAppender.dll
    -rw-r--r--  1 root root  17780 2007-08-25 00:09 pom.xml
    drwxr-xr-x  7 root root   4096 2007-08-25 00:13 site
    drwxr-xr-x  8 root root   4096 2010-02-04 14:08 src
    drwxr-xr-x  6 root root   4096 2010-02-04 14:09 tests

## Step 2:

This step is optional and depends on what features you are going to use from log4j framework. If you already have following packages installed on your machine then its fine, otherwise you would need to install them to make log4j work.

- JavaMail API: The e-mail.based logging feature in log4j requires the Java Mail API (mail.jar) to be installed on your machine from https://glassfish.dev.java.net/javaee5/mail/.

- JavaBeans Activation Framework: The Java Mail API will also require that the JavaBeans Activation Framework (activation.jar) be installed on your machine from http://java.sun.com/products/javabeans/jaf/index.jsp.

- Java Message Service: The JMS-compatible features of log4j will require that both JMS and JNDI (Java Naming and Directory Interface) be installed on your machine from http://java.sun.com/products/jms.

- XML Parser: You need a JAXP-compatible XML parser to use log4j. Make sure you have Xerces.jar installed on your machine from http://xerces.apache.org/xerces-j/install.html.

## Step 3:

This step is very important which needs to setup CLASSPATH and PATH variables appropriately. Here I'm going to set it just for log4j.x.x.x.jar file.

    $ pwd
    /usr/local/apache-log4j-1.2.15
    $ export CLASSPATH= \
          $CLASSPATH:/usr/local/apache-log4j-1.2.15/log4j-1.2.15.jar
    $ export PATH=$PATH:/usr/local/apache-log4j-1.2.15/

Copyright © tutorialspoint.com