MKUSERS(8) System Manager's Manual MKUSERS(8)NAME
MkUsers - Batch creating multiple XMail accounts
SYNOPSIS
MkUsers [options]
DESCRIPTION
This command line utility enable You to create user accounts structure by giving it a formatted list of users parameters or a formatted
text file. This utility can be also used to create a random number users, that is useful for me for testing the server performance.
OPTIONS -a numusers
Number of users to create in auto-mode.
-d domain
Domain name in auto-mode.
-f inputFile
Input file name {stdin}.
-u username
Radix user name in auto-mode.
-r rootdir
Mail root path {./}.
-s mboxsize
Mailbox maximum size {10000}.
-i useridbase
Base user id {1}.
-m Create Maildir boxes.
-h show help message.
USAGE
Input file format is
domain;username;password;real-name;homepage[NEWLINE]
where a character # as the very first one in a line is used to comment the entire line.
If a file mailusers.tab already exist in mail root path MkUsers exit without overwriting the existing copy. This protect You by accidental
overwriting of Your file when playing inside the real MAIL_ROOT directory. So if You want to setup the root directory ( -r ... ) as
MAIL_ROOT You must delete by hand the existing file. If You setup the root directory ( -r ... ) as MAIL_ROOT You MUST have XMail stopped
before running MkUsers. Existing files and directories will be not overwrited by MkUsers so You can keep Your users db into the formatted
text file ( or generate it by a database dump for example ) and run MkUsers to create the structure. Remeber that You've to add new domains
in domains.tab file by hand.
NOTES
MkUsers is intended as a bulk-mode utility, not to create single users coz for this need CtrlClnt ( or other GUI/Web configuration utili-
ties ) is better suited.
SEE ALSO CtrlClnt(1), XMail(8).
AUTHOR
XMail program was written by Davide Libenzi <davidel@xmailserver.org>. This manual page was written by Radim Kolar <hsn@cybermail.net>,
for the Debian GNU/Linux system (but may be used by others).
March 12, 2002 MKUSERS(8)
Check Out this Related Man Page
asadmin-create-domain(1AS) User Commands asadmin-create-domain(1AS)NAME
asadmin-create-domain, create-domain - creates a domain with the given name
SYNOPSIS
create-domain [--domaindir install_dir/domains] [--passwordfile filename] [--terse=false] [--echo=false] [--interactive=false] --adminport
port_number --adminuser admin_user [--adminpassword password] [--instanceport 8080] [--domainproperties (name=value)[:name=value]*]
domain_name
create-domain creates a domain with the specified administration port number, administration user, administration password, and domain
name. By creating a domain, an administration server is created in a directory named as the domain name. This command is supported in local
mode only.
If a user creates a domain in a non-default directory, the domain will not be automatically shutdown during uninstallation.
OPTIONS --domaindir directory where the domain is to be created. If specified, path must be accessible in the filesystem. If not speci-
fied, the domain is created in the default install_dir/domains directory.
--passwordfile file containing the domain application server password in the following form: AS_ADMIN_PASSWORD=password. Where
password is the actual administrator password for the domain.
--terse indicates that any output data must be very concise, typically avoiding human-friendly sentences and favoring well-
formatted data for consumption by a script. Default is false.
--echo setting to true will echo the command line statement on to the standard output. Default is false.
--interactive if set to true (default), only the required options are prompted.
--adminport port number of the domain application server listening for the administration requests.
--adminuser administrative username for the specified domain.
--adminpassword password to administer the domain application server.
--instanceport port number of the http listener. The port number cannot be currently in use.
--domainproperties list of the property name/value pairs for the domain to be created separated by the ":" character. The property
value assignment character is =. Valid property names are: jms.port, orb.listener.port, http.ssl.port,
orb.ssl.port, orb.mutualauth.port. Valid values are: http.ssl.port=1043:orb.ssl.port=1060:orb.mutu-
alauth.port=1061:jms.port=7676.
OPERANDS
domain_name name of the domain. Must be a unique name.
Example 1: Using create-domain
asadmin> create-domain --domaindir /export/domains
--adminport 7070 --adminuser admin --adminpassword adminadmin
--instanceport 7071 sampleDomain
created domain sampleDomain successfully
Where: the sampleDomain domain is created in the /export/domains directory.
EXIT STATUS
0 command executed successfully
1 error in executing the command
asadmin-delete-domain(1AS), asadmin-start-domain(1AS), asadmin-stop-domain(1AS), , asadmin-list-domains(1AS)J2EE 1.4 SDK March 2004 asadmin-create-domain(1AS)