1
# $Source: /home/cvs/samba/examples/LDAP/smbldap-tools/README,v $
4
Latest version may be found at http://samba.idealx.org/
7
What those tools are for?
8
=-=-=-=-=-=-=-=-=-=-=-=-=
10
A collection of scripts, �over� user{add,del,mod} and group{add,del,mod}
11
system tools to manipulate users and groups stored in LDAP directory,
12
for DEN system like SAMBA-LDAP and pam/nss_ldap systems.
14
Additionnaly, some scripts are designed to ease your migration from
15
a Windows NT 4.0 PDC Server to a Samba-LDAP PDC Server (Killer?;-):
16
smbldap-populate, smbldap-migrate-groups, smbldap-migrate-accounts.
18
They are currently used with Samba 2.2.4, therefore you may (will) have
19
to make some fixes for Samba TNG and Samba 3.0. Hint: contribs welcome :)
21
In the future, some other function may come (like backup and restore,
22
Novell migration tools, samba system activity report, dealing with
23
mail functions, compliance to RFC2307...): consult TODO.
26
What do SMBLDAP-TOOLS provide?
27
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
28
Those tools provide the following functions :
29
. populate LDAP database with a basic LDIF
31
. delete a user or group
32
. modify all users or groups data (all attributes types stored in
33
posixAccount and sambaAccount object class)
35
. staying compatible with all standard system tools options
36
(user/group{add,del,mod})
37
. be extensible for future developments
38
(manipulation of shadow account options, for example)
39
. error management, in the way system tools do
41
. usage of PERL (portability)
42
. all options must be placed in an external configuration file
43
. english localization
45
The current release uses the "mkntpwd" program, in mkntpwd.tar.gz
46
in the current directory. It comes from
47
http://www.demog.berkeley.edu/~aperrin/tips/src/mkntpwd.tar.gz
48
It allows to not use smbpasswd (if $with_smbpasswd == 0 in smbldap_conf.pm)
50
What do SMBLDAP-TOOLS deliver?
51
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
54
. user documentation in pod format, included in the sources
55
(or just use the -? option)
57
These tools aim at delivering the same functionality as the corresponding
58
system tools. However they may not be all implemented yet.
61
. cannot change uid with usermod
62
. no UTF-8 support (thus ASCII-7 only)
65
How to generate documentation?
66
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
67
Just issue the following command:
68
perldoc name_of_script.pl (ex: perldoc smbldap-useradd.pl)
70
Where can I find the latest release of those scripts?
71
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
73
Just fire any web browser to http://samba.IDEALX.org/
74
and/or contact samba@IDEALX.org
76
Additionnaly, you will find an useful Webmin module
77
at http://webmin.IDEALX.org/ if interested in a graphical
78
user interface to manager user and groups accounts via Webmin
79
for your Samba+LDAP PDC.
81
Let us know if these tools helped you, or if we should enhance
82
them with some functions you want them to support.
added
removed
examples/LDAP/smbldap-tools/README
