# Quick start tutorial

This tutorial will guide you into a minimal installation and configuration procedure. You need some prerequisites:

- A computer with a GNU/Linux or recent UNIX system
- A web browser launched from the computer (to access localhost)
- A cup of coffee (or tea, we are open minded)

## Installation

You can install Lemonldap::NG using packages (rpm or deb) or by hand as described below.

LemonLDAP::NG is written in Perl and requires a lot of Perl dependencies. You must install them first.

Get the tarball on download page and follow next steps (or install using RPM or Debian packages):

### Extract

    tar zxvf lemonldap-ng-*.tar.gz
    cd lemonldap-ng-*

### Build

    make
    make test

### Install

    sudo make install

## Configuration

### System

Update your /etc/hosts to map SSO URLs to localhost:

    sudo make postconf

### Apache

Include LemonLDAP::NG configuration in your main Apache configuration:

    include /usr/local/lemonldap-ng/etc/portal-apache2.conf
    include /usr/local/lemonldap-ng/etc/handler-apache2.conf
    include /usr/local/lemonldap-ng/etc/manager-apache2.conf
    include /usr/local/lemonldap-ng/etc/test-apache2.conf

Restart Apache:

    sudo apachectl configtest
    sudo apachectl restart

## Run

Since LemonLDAP::NG 1.2, the demonstration backend is configured by default. Demonstration backend has hard coded user accounts:

Login | Password | Role
--- | --- | ---
rtyler | rtyler | user
msmith | msmith | user
dwho | dwho | administrator

### Open SSO session

Go on http://auth.example.com and log with one of the demonstration account.

### Access protected application

Try http://test1.example.com or http://test2.example.com

### Edit configuration

Log with the dwho account and go on http://manager.example.com