## 2 Installation

- Requirements
- Installation

### 2.1 Requirements

The main requirement for using smbldap-tools are the two perl module: Net::LDAP and Crypt::SmbHash. In most cases, you'll also need the IO-Socket-SSL Perl module to use TLS functionnality.
If you want samba to call the scripts so that you can use the User Manager (or any other) under MS-Windows (to add, delete modify users and groups), Samba must be installed on the same computer. Finally, OpenLDAP can be installed on any computer. Please check that it can be contacted by a standard LDAP client software.
Samba and OpenLDAP installations will not be discussed here. You can consult the howto also available on the project page (`http://samba.IDEALX.org`). Altought is has been written for Samba2, most of its content still apply to Samba3. The main difference stands in LDAP schema's definitions.

### 2.2 Installation

An archive of the smbldap-tools scripts can be downloaded on our project page `http://samba.IDEALX.org/`. Archive and RedHat packages are available.
If you are upgrading, look at the `INSTALL` file or read the link 6.13.

#### 2.2.1 Installing from rpm

To install the scripts on a RedHat system, download the RPM package and run the following command:

    rpm -Uvh smbldap-tools-0.8.5-1.i386.rpm

#### 2.2.2 Installing from a tarball

On non RedHat system, download a source archive of the scripts. The current archive is `smbldap-tools-0.8.5.tar.gz`. Uncompress it and copy all of the Perl scripts in `/usr/local/sbin` directory, and the two configuration files in `/etc/opt/IDEALX/smbldap-tools/` directory:

    mkdir /etc/opt/IDEALX/smbldap-tools/
    cp *.conf /etc/opt/IDEALX/smbldap-tools/
    cp smbldap-* /usr/local/sbin/

The configuration is now based on two differents files:

- `smbldap.conf`: define global parameter
- `smbldap_bind.conf`: define an administrative account to bind to the directory

The second file must be readable only for 'root', as it contains credentials allowing modifications on all the directory. Make sure the files are protected by running the following commands:

    chmod 644 /etc/opt/IDEALX/smbldap-tools/smbldap.conf
    chmod 600 /etc/opt/IDEALX/smbldap-tools/smbldap_bind.conf