Difference between revisions of "Lazy Admin Tools"

From SME Server
Jump to navigationJump to search
Line 79: Line 79:
 
* [http://forums.contribs.org/index.php/topic,46961.msg231182.html#msg231182 Usernames containing special characters may cause problems]
 
* [http://forums.contribs.org/index.php/topic,46961.msg231182.html#msg231182 Usernames containing special characters may cause problems]
 
----
 
----
 +
 +
== Known issues==
 +
 +
===Large user database===
 +
 +
it has been reported that large user imports might be really long ( 60s per user in SME server already containing 4000 users) (see http://bugs.contribs.org/show_bug.cgi?id=7545).
 +
This script is using sme internal processing. The purpose of doing so is to do everything that is included by other contribs.
 +
 +
S95ldap-update-simple is called with user-modify user-create, group-modify and group-create events. S56update-domain-group-maps is called with the same events. These events allow also the full creation of the user, but have the adverse effect to be really long during large user importation.
 +
 +
A workaround to avoid this could be to:
 +
- disable ldap in the db configuration during the import (if you have not enable ldap auth)
 +
- or temporally remove the link inside the events to this two scripts and create them back after import.
 +
 +
and revert bacj theses change after importation and then running the signal event once (user-modify)
 +
 
=== Bugs ===
 
=== Bugs ===
 
Please raise bugs under the SME-Contribs section in [http://bugs.contribs.org/enter_bug.cgi bugzilla]
 
Please raise bugs under the SME-Contribs section in [http://bugs.contribs.org/enter_bug.cgi bugzilla]

Revision as of 01:42, 25 June 2013

Description

The Lazy Administrator's Tools is a set of scripts designed to automate batch tasks and administration jobs for SME servers. Currently the following tools are available:

Important.png Note:
This HowTo is based on a version created for SME 5.5/5.6/6.0 by Michiel Blotwijk. A new version for sme7.x has been created by J Bennett and is the rpm referred to in the Installation section below.

The original version information can be found here


Available functions

Command Description
lat-users or lat-users on wiki documentation add/delete users (and their directories)
lat-groups or lat-groups on wiki documentation add/delete groups
lat-pseudonyms or lat-pseudonyms on wiki documentation add/delete e-mail pseudonyms for individual users
lat-ibays or lat-ibays on wiki documentation add/delete ibays (and its directories)
lat-quota or lat-quota on wiki documentation set the disk quota for individual users
lat-procmail or lat-procmail on wiki documentation activate or deactivate procmail for individual users
lat-hosts or lat-hosts on wiki documentation add hostnames to the server
lat-pptp or lat-pptp on wiki documentation activate or deactivate pptp access for individualusers
lat-domains or lat-domains on wiki documentation create virtual domains
lat-dump or lat-dump on wiki documentation create input files for the above, using the configuration files of the SME servers.


Warning.png Warning:
SME Server 7.x supports the use of '@' in pseudonyms, but lat-pseudonym does not by default. See this forum post for a work-around.


Installation

Smecontribs repository for SME Server 8.0

yum install --enablerepo=smecontribs smeserver-lazy_admin_tools
signal-event post-upgrade; signal-event reboot

Obsolete way to install

Download and install using the following commands:

cd /tmp
wget  http://www.sme-server.de/download/sme7/contribs/smeserver-lazy_admin_tools-0.9.1-2.noarch.rpm
yum localinstall smeserver-lazy_admin_tools-0.9.1-2.noarch.rpm

More information, examples, and source code can be downloaded from http://mirror.contribs.org/contribs/mblotwijk/Contribs/lazy-admin-tools/

Upgrade notes

1. If you are upgrading from a version prior to 0.7.0-1, don't forget to remove manually the old scripts. Yum will not be able to find and remove them for you.

2. As from version 0.7.0-1 the arguments for lat-groups have changed. Please refer to 'man lat-groups' or to the examples in /usr/doc/lazy-admin-tools for the new format.

Usage

Each tool has its own comprehensive man page. See `man lazy-admin-tools` for an overview of the tools that have been installed.

All tools follow the same concept:

1. Arguments can be specified on the command line (--command-line), or in a file (--input-file) for batch processing.

2. If the arguments are specified on the command line, the arguments must be between quotes (e.g. -c="foo | bar | baz")

3. Most tools recognize the wildcards * and ? in the first argument (e.g -c="foo* | bar | baz").

4. See the various examples in /usr/doc/lazy-admin-tools for the format of the input file.

Forum References


Known issues

Large user database

it has been reported that large user imports might be really long ( 60s per user in SME server already containing 4000 users) (see http://bugs.contribs.org/show_bug.cgi?id=7545). This script is using sme internal processing. The purpose of doing so is to do everything that is included by other contribs.

S95ldap-update-simple is called with user-modify user-create, group-modify and group-create events. S56update-domain-group-maps is called with the same events. These events allow also the full creation of the user, but have the adverse effect to be really long during large user importation.

A workaround to avoid this could be to: - disable ldap in the db configuration during the import (if you have not enable ldap auth) - or temporally remove the link inside the events to this two scripts and create them back after import.

and revert bacj theses change after importation and then running the signal event once (user-modify)

Bugs

Please raise bugs under the SME-Contribs section in bugzilla and select the e-smith-lazy_admin_tools component or use this link .