MkUsers

This command line utility enables you to create the user accounts structure by giving it a formatted list of users parameters (or a formatted text file). The syntax of the list (or file) is:

 domain;username;password;real-name;homepage[NEWLINE]

where a line whose first character is '#' is treated as a comment. This utility can also be used to create a random number users (useful to test server performance).

These are MkUsers command line parameters:

-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 this message.

MkUsers creates, under the specified root directory, the given structure:

 rootdir            <dir>
   mailusers.tab    <file>
   domains          <dir>
     domainXXX      <dir>
       userXXX      <dir>
         user.tab   <file>
         mailbox    <dir>
       ...
    ...

for the mailbox structure, while:

 rootdir            <dir>
   mailusers.tab    <file>
   domains          <dir>
     domainXXX      <dir>
       userXXX      <dir>
         user.tab   <file>
         Maildir    <dir>
           tmp      <dir>
           new      <dir>
           cur      <dir>
       ...
     ...

for the Maildir structure.

If the file 'mailusers.tab' already exist in the mail root path, MkUsers exits without overwriting the existing copy. This protect you from accidentally overwriting your file when playing inside the real MAIL_ROOT directory. If you want to setup the root directory (-r ...) as MAIL_ROOT, you must delete by hand the existing file (you must know what you're doing). If you setup the root directory (-r ...) as MAIL_ROOT you MUST have AfterLogic XMail Server stopped before running MkUsers. Existing files and directories are not overwritten by MkUsers so you can keep your users db in the formatted text file (or generate it by a database dump for example) and run MkUsers to create the structure. Remember that you have to add new domains in the 'domains.tab' file by hand. MkUsers is intended as a bulk-mode utility, not to create single user; for this CtrlClnt (or other GUI/Web configuration utilities) is better suited.

[top]