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.