| 1 | # $Source: /opt/cvs/samba/smbldap-tools/README,v $
|
|---|
| 2 | #
|
|---|
| 3 |
|
|---|
| 4 | Latest version may be found at http://samba.idealx.org/
|
|---|
| 5 |
|
|---|
| 6 |
|
|---|
| 7 | What those tools are for?
|
|---|
| 8 | =-=-=-=-=-=-=-=-=-=-=-=-=
|
|---|
| 9 |
|
|---|
| 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.
|
|---|
| 13 |
|
|---|
| 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.
|
|---|
| 17 |
|
|---|
| 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 :)
|
|---|
| 20 |
|
|---|
| 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.
|
|---|
| 24 |
|
|---|
| 25 |
|
|---|
| 26 | What do SMBLDAP-TOOLS provide?
|
|---|
| 27 | =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
|
|---|
| 28 | Those 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)
|
|---|
| 34 | Taking 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
|
|---|
| 40 | Constraints :
|
|---|
| 41 | . usage of PERL (portability)
|
|---|
| 42 | . all options must be placed in an external configuration file
|
|---|
| 43 | . english localization
|
|---|
| 44 |
|
|---|
| 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)
|
|---|
| 49 |
|
|---|
| 50 | What do SMBLDAP-TOOLS deliver?
|
|---|
| 51 | =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
|
|---|
| 52 | Contents :
|
|---|
| 53 | . scripts (see FILES)
|
|---|
| 54 | . user documentation in pod format, included in the sources
|
|---|
| 55 | (or just use the -? option)
|
|---|
| 56 |
|
|---|
| 57 | These tools aim at delivering the same functionality as the corresponding
|
|---|
| 58 | system tools. However they may not be all implemented yet.
|
|---|
| 59 | Current limitations :
|
|---|
| 60 | . no shadow support
|
|---|
| 61 | . cannot change uid with usermod
|
|---|
| 62 | . no UTF-8 support (thus ASCII-7 only)
|
|---|
| 63 |
|
|---|
| 64 |
|
|---|
| 65 | How to generate documentation?
|
|---|
| 66 | =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
|
|---|
| 67 | Just issue the following command:
|
|---|
| 68 | perldoc name_of_script.pl (ex: perldoc smbldap-useradd.pl)
|
|---|
| 69 |
|
|---|
| 70 | Where can I find the latest release of those scripts?
|
|---|
| 71 | =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
|
|---|
| 72 |
|
|---|
| 73 | Just fire any web browser to http://samba.IDEALX.org/
|
|---|
| 74 | and/or contact samba@IDEALX.org
|
|---|
| 75 |
|
|---|
| 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.
|
|---|
| 80 |
|
|---|
| 81 | Let us know if these tools helped you, or if we should enhance
|
|---|
| 82 | them with some functions you want them to support.
|
|---|
| 83 |
|
|---|
| 84 | Sincerly,
|
|---|
| 85 | LEM
|
|---|
| 86 |
|
|---|
| 87 | # - The End
|
|---|
