IMail Server added new columns to the IMail ODBC User database table for the new Password Expiration feature. If IMail Server v12.2 or later is installed over a previous version that has one or more domains configured to use a custom external user database the following changes will need to be added to the existing user database columns.
Note: If a custom ODBC driver was used with an earlier version of IMail, the driver must be modified to accommodate the new columns. Source code for the basic ODBCUser.dll driver (tailored for SQL Server and Access) may be obtained by download from the IMail Support Center: http://ipswitchmsg.force.com/kb/articles/FAQ/How-do-I-use-the-ODBC-connector-1307739583175
Column Name |
Data Type |
Default Value |
PASSWORDNEVEREXPIRES |
Int |
Null |
PASSWORDEXPIRED |
Int |
Null |
PASSWORDLASTCHANGED |
Int |
Null |
PASSWORDEXPIREWARNINGLASTSENT |
Int |
Null |
IMail Server added new columns to the "Appointments", "Tasks" and "Recurrences" Tables for IMail Collaboration (WorkgroupShare) to handle meeting requests. If IMail Server v12 or later is installed over a previous version that has one or more domains configured to use a custom database the following column names will need to be added to the the following existing tables.
Appointments Table - Add Columns
Database Column Name |
Original Type |
Default Value |
Globalld |
Memo |
|
SequenceNumber |
INT |
Zero |
Importance |
INT |
Zero |
FlagDueBy |
DateTime |
Null |
Tasks Table - Add Columns
Database Column Name |
Original Type |
Default Value |
Reminder |
BIT |
Null |
RemindTime |
Datetime |
Null |
FlagDueBy |
DateTime |
Null |
Recurrences Table - Add Columns
Database Column Name |
Original Type |
Default Value |
EndType |
INT |
Zero |
Appointments Table - Add Columns
Database Column Name |
Original Type |
Default Value |
Globalld |
MEMO |
|
SequenceNumber |
INT |
Zero |
Importance |
INT |
Zero |
FlagDueBy |
DateTime |
Null |
Tasks Table - Add Columns
Database Column Name |
Original Type |
Default Value |
Reminder |
BIT |
Null |
RemindTime |
Datetime |
Null |
FlagDueBy |
DateTime |
Null |
Recurrences Table - Add Columns
Database Column Name |
Original Type |
Default Value |
EndType |
INT |
Zero |
IMail Server now supports user level Archiving and Full Name encoding for international users. If IMail Server v11.03 or later is installed over a previous version that has one or more domains configured to use a custom external user database the following changes will need to be added to the existing user database columns.
IMail Server v11.03 Altered Column
Database Column Name |
Original Type |
Default Value |
ENABLEARCHIVING |
Integer |
Null |
FULLNAMEENCODING |
Varchar(20) |
Null |
IMail Server now supports mailboxes that are larger than 2GB. If IMail Server v11.02 or later is installed over a previous version that has one or more domains configured to use a custom external user database, some changes will need to be made to the existing user database columns. Any column containing a user's Max Mailbox Size (MaxSize in the standard odbcuser.dll) will need to be altered to handle 64-bit values. This can be accomplished by changing the column's type to one that can hold a value up to and including the maximum value of an unsigned 64 bit integer. Example types would be a BIGINT, a DOUBLE, or a NUMERIC(20,0) – the exact type to use may vary depending on which database engine is being used.
IMail Server v11.02 Altered Column
Database Column Name |
Original Type |
Altered Type |
MAXSIZE |
INTEGER |
|
IMail supports multiple database connections. Enabling this feature will improve performance when using an external database. This can be enabled by creating and setting two registry keys:
HKEY_LOCAL_MACHINE\SOFTWARE\Ipswitch\IMail\Global\UseMultiConnect
HKEY_LOCAL_MACHINE\SOFTWARE\Ipswitch\IMail\Global\MaxConnect
"UseMultiConnect"
should be set to "1"
to enable multiple database connections. "MaxConnect"
should be set to the maximum number of connections allowed; "10"
is recommended.When installing IMail v8.2 or later over any version earlier than 7.1 in which one or more hosts are configured to use an external user database, new columns must be added to the database tables. This is due to additional user-level data which must be stored for use with the new Web Messaging features and for Web Calendaring. These new columns must be added to the user table for each IMail host configured to use an external database.
Notes:
If a custom ODBC driver was used with an earlier version of IMail, the driver must be modified to accommodate the new columns. Source code for the basic ODBCUser.dll driver (tailored for SQL Server and Access) may be obtained by download from the IMail Support Center:
ftp://ftp.ipswitch.com/Ipswitch/Product_Support/IMail/odbcuser.dll
These database column additions must be made before installing IMail v8.2. Also, if a custom ODBC database driver will be used with IMail, it must be created and ready for use. New columns and their types are as follows:
IMail Server 2006.1 New Columns
Database Column Name |
Type |
Default Value |
ENABLEALTWGSID |
INTEGER |
Null |
ALTWGSID |
VARCHAR(255) |
Null |
IMail Server v7.1 New Columns
Database Column Name |
Type |
Default Value |
NUMNOTIFY |
Integer |
Null |
LASTNOTIFY |
Integer |
Null |
IMail Server v7.0 New Columns
Database Column Name |
Type |
Default Value |
NUMTRIES |
Integer |
0 |
LASTNOTIFY |
Integer |
0 |
ATTEMPTTIME |
Integer |
0 |
NUMTIMESSUSP |
Integer |
0 |
SPNDUSRACCT |
Integer |
0 |
IWOPTIONS |
Integer |
0 |
SPELLCHKG |
Integer |
0 |
ICALENBL |
Integer |
-1 |
SPELLENBL |
Integer |
-1 |
NUMSGSTNS |
Integer |
-1 |
IWDEPTH |
Integer |
-1 |
PRVWSIZE |
Integer |
-1 |
STRTDAY |
Integer |
-1 |
ENTRYGRNL |
Integer |
-1 |
STARTTIME |
Integer |
-1 |
ENDTIME |
Integer |
-1 |
MAXEVNTDISP |
Integer |
-1 |
MAXTSKDISP |
Integer |
-1 |
MAXNOTEDISP |
Integer |
-1 |
MAXDLYRCURCNT |
Integer |
-1 |
MAXWKLYRCURCNT |
Integer |
-1 |
MAXMONRCURCNT |
Integer |
-1 |
MAXRLYRCURCNT |
Integer |
-1 |
DISPCMPLTDTSKS |
Integer |
-1 |
HOURSCLOCK |
Integer |
-1 |
MAXSRCHRESPPG |
Integer |
-1 |
CONFIRMONDELETE |
Integer |
-1 |
TIMEZONE |
Varchar (255) |
"" (empty string) |
DEFVIEW |
Varchar (255) |
"" (empty string) |
DEFCALNM |
Varchar (255) |
"" (empty string) |
For all existing user records, these columns should be set to the default values shown in the table.