Adding a Virtual Host (adddomain.exe)

AddDomain.exe is a utility for adding virtual domains. It can be used to simply add a single domain, but is especially useful in a batch file to add multiple domains.

Basic Command Syntax and Example

Usage:

adddomain -h Hostname -i IPAddress -t TopDir  

[-a Aliases -u IM | NT | External -x MaxMBXSize -s MaxMBXMsgs -r MaxUsers]

adddomain -h Hostname -m

[-t TopDir -a Aliases -x MaxMBXSize -s MaxMBXMsgs -r MaxUsers]

adddomain -h Hostname -i IPAddress -t TopDir -u External

[-e DLLFilename -o ODBC_DSN -n TableName]

adddomain -h Hostname -delete

adddomain -f Filename

Examples:

  1. In the following example, since the -e, -o,or -n options are not specified, the external database relies on the default "values %"Imail_top dir"%odbcuser.dll , IMAILSECDB, and [default] accordingly:

    adddomain -h newhost1 -i virtual -u external

  2. The following command populates an external database with settings of C:\mydll.dll, IMAILSECDB, and [default]:

    adddomain -h newhost2 -i virtual -u external -e C:\mydll.dll

  3. The following example changes an existing host (notice the -m for modify) to use an ODBC Data Source Name (DSN) of MyNewDSN. If the other fields of -e and -n were previously set, they will be preserved. If the other fields of -e and -n were not previously set, they will be set with the default values:

    adddomain -h ExistingHost -m -u external -o MyNewDSN

    Note: The -e, -o, and -n commands must be used in conjunction with -u EXTERNAL.

  4. If you need to specify a DSN other than 'IMailSecDB,' or you need to specify a userID and password (required when setting up a DSN to connect to an SQL database), use the -o switch :

    adddomain -h ExistingHost -m -u external -o IMailSecDB;UID=MyUser;

    PWD=MyPassword

  5. The following example shows how to add a new virtual host (or virtual host with an IP ) using an external database:

    adddomain -u external -t C:\IMail\newdomain_com -i virtual

    -o IMailSecDB;UID=sqluser;PWD=sqlpassword -n table_name

  6. Adddomain.exe supports the following command line options:

    Command

    Function

    -h

    Fully qualified host name; must match the IMail official host name

    -i

    IP address or virtual IP address for an IP-less host

    -t

    Path (full or relative) to the top directory for the domain

    -m

    Command to modify existing settings instead of creating new ones

    -a

    Alias list for a host

    -u

    User data base to use (IMail, NT, or external)

    -e

    Path to external database implementation DLL

    -o

    External database ODBC system Data Source Name (DSN )

    -n

    External database table name

    -x

    Default max mailbox size (in kbytes).

    -s

    Default max number of messages for mailbox.

    -f

    Path to the file containing the settings to modify

    -r

    Maximum number of users allowed on this host.

    -delete

    Removes the virtual host.

Note:  AddDomain.exe does not warn when assigning already claimed IP addresses to new hosts. Assigning an already used IP address to another host will orphan the original host without warning.