1# $Source: /ramdisk/repositories/20_cvs_clean_up/2011-02-11_sj/src/router/samba/samba-3.0.25b/examples/LDAP/smbldap-tools-0.9.2/README,v $ 2# 3 4Latest version may be found at http://samba.idealx.org/ 5 6 7What those tools are for? 8=-=-=-=-=-=-=-=-=-=-=-=-= 9 10A collection of scripts, �over� user{add,del,mod} and group{add,del,mod} 11system tools to manipulate users and groups stored in LDAP directory, 12for DEN system like SAMBA-LDAP and pam/nss_ldap systems. 13 14Additionnaly, some scripts are designed to ease your migration from 15a Windows NT 4.0 PDC Server to a Samba-LDAP PDC Server (Killer?;-): 16smbldap-populate, smbldap-migrate-groups, smbldap-migrate-accounts. 17 18They are currently used with Samba 2.2.4, therefore you may (will) have 19to make some fixes for Samba TNG and Samba 3.0. Hint: contribs welcome :) 20 21In the future, some other function may come (like backup and restore, 22Novell migration tools, samba system activity report, dealing with 23mail functions, compliance to RFC2307...): consult TODO. 24 25 26What do SMBLDAP-TOOLS provide? 27=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= 28Those tools provide the following functions : 29 . populate LDAP database with a basic LDIF 30 . add a user or group 31 . delete a user or group 32 . modify all users or groups data (all attributes types stored in 33 posixAccount and sambaAccount object class) 34Taking care of : 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 40Constraints : 41 . usage of PERL (portability) 42 . all options must be placed in an external configuration file 43 . english localization 44 45The current release uses the "mkntpwd" program, in mkntpwd.tar.gz 46in the current directory. It comes from 47http://www.demog.berkeley.edu/~aperrin/tips/src/mkntpwd.tar.gz 48It allows to not use smbpasswd (if $with_smbpasswd == 0 in smbldap_conf.pm) 49 50What do SMBLDAP-TOOLS deliver? 51=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- 52Contents : 53 . scripts (see FILES) 54 . user documentation in pod format, included in the sources 55 (or just use the -? option) 56 57These tools aim at delivering the same functionality as the corresponding 58system tools. However they may not be all implemented yet. 59Current limitations : 60 . no shadow support 61 . cannot change uid with usermod 62 . no UTF-8 support (thus ASCII-7 only) 63 64 65How to generate documentation? 66=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= 67Just issue the following command: 68 perldoc name_of_script.pl (ex: perldoc smbldap-useradd.pl) 69 70Where can I find the latest release of those scripts? 71=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= 72 73Just fire any web browser to http://samba.IDEALX.org/ 74and/or contact samba@IDEALX.org 75 76Additionnaly, you will find an useful Webmin module 77at http://webmin.IDEALX.org/ if interested in a graphical 78user interface to manager user and groups accounts via Webmin 79for your Samba+LDAP PDC. 80 81Let us know if these tools helped you, or if we should enhance 82them with some functions you want them to support. 83 84Sincerly, 85 LEM 86 87# - The End 88