Basic Commands on TOOL.EXE
Posted by Gary Garber, Last modified by Valentin   on 04 August 2014 10:54 AM

TOOL.EXE

 

SUMMARY

TOOL is directly accessing application to API. So you can set everything and more than in Icewarp Administration console through that. In many cases it's quicker to use TOOL or it's necessary due to function or variable absence in console.

 

WHERE?

TOOL is stored in Icewarp root folder\tool.exe
run it in CMD

first and most helpful command, which will display you right order of commands and many other types of commands, could be
tool tutorial

 

 

EXAMPLES OF USAGE

 

New account creation

tool create account toolusage@domain.com u_name "Tool Usage" u_password "toolpwd"
--> new account "toolusage" will be in "domain.com" created with password "toolpwd"

 

 

Existing account modification

tool modify account toolusage@domain.com u_password "changedpwd"
--> existing account "toolusage" will be modified to password "changedpwd"

 

 

Existing accounts modifications

tool modify account *@domain.com u_comment "Modified account"
--> all existing accounts in domain "domain.com" will have modified comments to "Modified account"

 

Deleting accounts in specified domain

tool delete account e*@domain
--> this command will delete all account beginning by "e" in domain "domain.com"

 

Import accounts from the file

tool import account importfile.txt u_name u_password
--> this will import all accounts stored in file "importfile.txt" with their names and passwords similar to order in text file

lukas@domain.com, Lukas Pibol, lukaspwd
tomas@domain.com, Tomas Newman, tomaspwd

If this text shown above will be saved in mentioned txt file, account lukas@domain.com will be created with name "Lukas Pibol" and password "lukaspwd".

 

Export accounts from database to BASE64 encoded file

tool export account *@domain.com u_backup > users-domain-com.csv
--> will export information about all accounts stored in domain.com to file "users-domain-com.csv" in BASE64 encrypted form.

 

TOOL and APIconst.pas

File apiconst.pas is one of most important file when using TOOL. You can find that in Icewarp\api\delphi\apiconst.pas. All constants of API are displayed and explained here, but don't forget, that all levels have to be typed when commands creating.

Example:
want to know where Icewarp installation folder is

tool display system C_InstallPath
--> this will send you back installation path of Icewarp Mail server, but you can define anything from mentioned apiconst.pas to display or modify by TOOL.

 

Updated 04.08.2014, by Valentin