Merak 强大的命令行工具tool

dirone

tool作为merak中唯一的命令行工具,被赋予了强大的功能,您基本可以认为tool能完成Merak服务器管理员所需要的一切工作,本贴专用于关于tool的日常管理应用的讨论. 请各位网友有这方面的问题在本帖提出



Merak系统中的"从文件中导入帐号"主要是用于在merak系统间进行用户的导入\导出,导入其它系统的帐号文件并不适用,因为我们有专门的帐户文本格式.
我们推荐您使用merak系统中的强大的命令行工具tool.exe完成其它系统的帐户导入工作.
tool.exe可以用于管理merak系统中包括域和用户在内的所有系统参数和变量.基本结构如下:
tool [命令] [类型] [参数列表]
命令指tool将要进行的操作
create(新建)
delete(删除)
Modify(修改)
Display(显示)
Export(导出)
Import(导入)
File(文件)
类型指tool将要进行操作的对象类型
Accout(帐户)
Domain(域)
system(系统)
Batch batchfile(批处理文件)
参数列表指tool对所操作对象的具体哪些属性进行操作,并可在需要的时候进行赋值<Merak系统中所有的参数变量都位于Merak\API\Delphi\APIconst.pas文件中>.
常用的用户参数
U_EmailAlias 帐户别名
U_PhoneAlias SIP电话
U_Mailbox 帐户名称
U_Name 帐户全名
U_Password 帐户密码
U_AuthMode 帐户登陆模式 0
// 0 标准
// 1 NT域
// 2 活动目录
// 3 任意密码
U_Comment 帐户注释
U_AccountType 帐户接收协议 // 0 - POP3
// 1 - IMAP & POP3
// 2 - IMAP
所以如果有一个文本文件中包含Md帐户信息如下:
email username fullname password
admin@icewarp.cn admin administrator admin
user@icewarp.cn user user for icewarp bbs0755
manger@icewarp.cn manger manger.sz 1manger

则将其转换成如下格式的文本文件a.txt
admin@icewarp.cn,admin,administrator,admin
user@icewarp.cn,user,user for icewarp,bbs0755
manger@icewarp.cn,manger,manger.sz,1manger

然后使用如下tool命令构造完成导入工作
tool import account a.txt u_mailbox u_name u_password

dirone

用tool导出本服务器中所有帐号(包括邮件列表等帐号).

tool export account * U_mailbox U_name u_password
导出所有帐号的邮箱地址,用户名,用户全名以及密码.

tool export account * U_mailbox U_name u_password > a.txt
将导出的所有帐号的邮箱地址,用户名,用户全名以及密码存入到a.txt中.

dirone

tool命令在linux下同样适用，不过命令结构需要少许改变
1、命令前应该加路径  ./tool
2、linux下不支持全服务器通配符模式，只支持域通配符，所以应使用*@域名来指代本域的所有帐户

所以楼上的命令结构在linux下应改为 ./tool export account *@icewarp.cn  U_mailbox U_name u_password

[ 本帖最后由 dirone 于 2007-9-27 10:25 编辑 ]

dirone

系统提供一个全新的命令行工具，您不仅可以使用它来管理域和帐户，还可以管理所有系统变量。该工具被称为 tool.exe，您可以直接在 <merak> 文件夹中找到它。它使用简单，您只需要了解 API 常量。API 常量的完整列表位于 APIconst.pas 文件中，而该文件位于 <merak>\API\Delphi\ 文件夹中。
请注意，使用 tool.exe 执行大型操作可能导致服务临时不可用。这是由于配置中发生某些更改，服务有时候需要重新启动。对于具有多个域且每个用户均处于高负荷下的服务器，该重新启动可能需要一些时间。我们建议您在负荷最低的时段（例如晚上）执行该操作。

命令	描述
CREATE	新建一个对象。此命令后面是要创建的对象类型（域或帐户）和变量列表，以及要分配给这些变量的值。
DELETE	删除一个对象。此命令后面是要删除的对象类型（域或帐户）和对象的唯一名称。
MODIFY	修改对象的任何变量（属性）。此命令后面是对象类型和变量列表，以及要分配给这些变量的值。
DISPLAY	显示对象的所有变量（属性）。此命令后面是要显示的对象类型（域、帐户或系统）和变量列表。
EXPORT	与“DISPLAY”命令的效果相同，但该命令会在屏幕上显示任何内容，中间以逗号分隔。（CSV 格式）
FILE	调用文件功能。随后出现用户统计及其所有参数（如下所示）。

参数	描述
ACCOUNT [变量]	处理服务器上的任何帐户。
DOMAIN [变量]	处理服务器上的任何域。
SYSTEM [变量]	处理任何系统变量，例如 c_version、c_name 等，以及 APIConst.pas 中的列表
BATCH [批处理文件]	允许您运行包含一组命令的批处理文件。参见以下示例。 批处理文件就是带命令的普通文本文件。每个文件单独成行。这些命令的开头一定不能包括“tool”。只有命令和参数。
USERSTATISTICS fromdate todate filterstring outputfile	将所有满足过滤器字符串条件的用户从开始日期到结束日期的用户统计保存到特定的输出文件。 开始日期和结束日期为 yyyy/mm/dd（年/月/日）格式 过滤器字符串还支持星号和问号，以指定更多帐户。如果它不包含 @ 符号，则可视作域名。 如果您没有指定输出文件的完整路径，它将保存至 <merak> 文件夹。

如何创建其他类型的帐户
要创建其他类型的帐户，您要使用 u_type 属性。其值仍写在 APIConst.pas 文件中。例如，邮件列表该属性的值是 1。因此，如果您要创建邮件列表 I，需要使用以下命令：
tool create account mailing@merakdemo.com u_type 1 m_owneraddress "admin@merakdemo.com"
用法
tool create account new@merakdemo.com u_name "New Account" u_password "pass" u_accounttype 2
§
在“全称”字段输入“New Account”以创建一个帐户，其密码为“pass”。
tool display account new@merakdemo.com u_mailbox u_accounttype
§
同时显示 new@merakdemo.com 帐户的变量 u_mailbox 和 u_accounttype 的值。
tool delete domain oldone.net
§
从您的服务器上删除 oldone.net 域。
tool modify account *@merakdemo.com u_accounttype 2
§
将 merakdemo.com 中的所有帐户更改为 IMAP 帐户。
tool file userstatistics 2004/12/25 2004/12/31 merakdemo.com statistics.txt
§
将 merakdemo.com 域内所有帐户中在 2004/12/25 和 2004/12/31 之间的用户统计均保存到 statistics.txt 文件。该文件可以从 <merak> 文件夹中找到。
tool export domain * d_description d_postmaster
§
它将以 CSV 格式在屏幕上显示所有域的 d_description 和 d_postmaster 变量 - 每个值之间以逗号分隔。
tool export account *@* u_mailbox u_name u_password > accounts.txt
§
除了导出以上 3 个字段以外，它还会将用户的完整邮件地址放入第一栏。
tool import account contas.txt u_mailbox u_name u_password
§
从 CSV 导入这 3 个字段
tool display system c_config_services_pop3_port
§
显示包含 POP3 服务端口的系统变量。
tool file batch create_mailing.txt
§
其中，create_mailing.txt 类似于：
tool create account mailing@merakdemo.com u_type 1 m_owneraddress "admin@merakdemo.com"
tool create account mailing@merakdemo.com u_type 2 m_owneraddress "admin@merakdemo.com"
tool create account mailing@merakdemo.com u_type 3 m_owneraddress "admin@merakdemo.com"
§
它将创建在 create_mailing.txt 文件中定义的三个邮件列表。

[ 本帖最后由 dirone 于 2007-9-27 10:36 编辑 ]