XMail server guía de inicio rápido 

¿Cómo arrancar el servidor XMail ?
Agregar un nuevo administrador para el servidor XMail
Crear el dominio principal
Agregar un dominio
Listar los dominios existentes
Eliminar un dominio
Crear un nuevo usuario
Eliminar un usuario
Listar los usuarios de un dominio
Cambiar el password de un usuario
Obtener las estadísticas de un usuario

¿Cómo arrancar el servidor XMail ?
Para arrancar el servidor XMail siga el procedimiento :

Windows : 
Ejecute el servidor XMail como un servicio, manual o automático de acuerdo a la opción seleccionada durante la instalación.

Linux/Solaris/FreeBSD/OpenBSD :
Después de instalar correctamente el servidor siguiendo las instrucciones del archivo Readme.html, simplemente reinicie el sistema. Si desea arrancar el servidor XMail sin reiniciar el sistema puede ejecutar el siguiente comando :

#/etc/rc.d/init.d/xmail start 

Para más detalles sobre este tema consulte el archivo Readme.html.


Agregar un nuevo administrador para el servidor XMail
Para agregar un nuevo administrador para el servidor XMail, se puede utilizar el editor de administradores "xmail_administrators"  o editar el archivo "ctrlaccounts.tab" manualmente.

Para utilizar el editor de administradores, simplemente ejecútelo desde "{sysfile}\MailRoot\bin" en sistemas Windows o "/var/MailRoot/bin" en sistemas Unix (si "xmail_administrators" no está instalado entonces usted tiene que compilarlo y instalarlo manualmente en "/var/MailRoot/bin" para poder hacer esto consulte el archivo "install_xmail_administrators.txt" incluido con el código fuente de "xmail_administrators".
 


Para editar el archivo "ctrlaccounts.tab" usted debe abrirlo con un editor de textos y agregar un nombre de administrador entre comillas un carater TAB(Ascii #9)  un password entre comillas previamente encriptado con XMCrypt, y un retorno de carro por ejemplo :

XMCrypt 123456789 

545756515053525d5c

El password 123456789 se convierte en el valor encriptado 545756515053525d5c que se debe escribir junto con el nombre del administrador dentro del archivo "ctrlaccounts.tab", por ejemplo :

"xmail_admin" "545756515053525d5c"

Para más detalles sobre este tema consulte el archivo Readme.html.


Crear el dominio principal
Para crear el dominio principal se tiene que editar manualmente el archivo "server.tab" que contiene las variables principales del servidor. 

Por ejemplo para crear el dominio "first.domain.com" tenemos que seguir los pasos siguientes :

1)Parar el servidor XMail
2)Editar el archivo "server.tab" y modificar las variables de configuración
3)Arrancar el servidor XMail 

En este caso las variables de configuración deben ser editadas del siguiente modo :

#
# Example configuration file.
# Note : remember to use _REAL_ TABs and " to format this file
#
"RootDomain" "first.domain.com"
"SmtpServerDomain" "first.domain.com"
"POP3Domain" "first.domain.com"
"HeloDomain" "first.domain.com"
"PostMaster" "root@first.domain.com"
"ErrorsAdmin" "root@first.domain.com"
#"TempErrorsAdmin" "send-failures@xmailserver.test"
#"DefaultSMTPGateways" "192.168.1.2,192.168.1.15"
"RemoveSpoolErrors" "0"
#"NoSenderBounce" "1"
#"DisableEmitAuthUser" "1"
#"NotifyMsgLinesExtra" "8"
#"NotifySendLogToSender" "0"
#"NotifyTryPattern" "1"
"MaxMTAOps" "16"
"ReceivedHdrType" "0"
"FetchHdrTags" "+X-Deliver-To,+Received,To,Cc"
#"SMTP-TLS" "0"
#"EnableCTRL-TLS" "1"
#"EnableSMTP-TLS" "1"
#"EnablePOP3-TLS" "1"
#"SmtpMsgIPBanSpammers" "550 Denied due inclusion of your IP in our spam lists"
#"SmtpMsgIPBanSpamAddress" "550 Denied due inclusion of your email address in our spam lists"
#"SmtpMsgIPBanMaps" "550 Denied due inclusion of your IP in the following map"
#"CustomSMTPMessage" "Please open http://www.xmailserver.test/smtp_errors.html to get more information about this error"
#"MaxMessageSize" "20000"
#"EnableAuthSMTP-POP3" "0"
#"Pop3SyncErrorAccount" "psync-errors@xmailserver.test"
#"AllowNullSender" "1"
#"AllowSmtpVRFY" "1"
#"AllowSmtpETRN" "1"
#"SMTP-MaxErrors" "4"
#"SmtpMinDiskSpace" "100000"
#"SmtpMinVirtMemSpace" "64000"
#"Pop3MinVirtMemSpace" "64000"
#"CustMapsList" "list.dsbl.org.:1,blackholes.mail-abuse.org.:1,dialups.mail-abuse.org.:0"
#"SMTP-RDNSCheck" "1"
#"CheckMailerDomain" "1"
#"SmartDNSHost" "dns.home.bogus.net:tcp,192.168.1.1:udp"
#"DynDnsSetup" "www.dns4ever.com,80,/sys/u.cgi?d=MYDOMAIN&u=MYUSERNAME&p=MYPASSWORD&i=%s"
#"DynDnsSetup" "members.dyndns.org,80,/nic/dyndns?action=edit&started=1&hostname=YES&host_id=yourhost.
ourdomain.ext&myip=%s&wildcard=OFF&mx=mail.exchanger.ext&backmx=NO,foouser,foopasswd"
#"SmtpConfig" "mail-auth"
#"SmtpConfig-192.168.0.1" "mail-auth"
"DefaultSmtpPerms" "MRVZ"

Algo muy importante es que despues de editar el archivo "server.tab", se debe agregar el dominio "first.domain.com" usando el mismo procedimiento que se usa para agregar cualquier dominio :

CtrlClnt -s localhost -u xmail_admin -p 123456789 domainadd first.domain.com

Para saber más sobre como agregar dominios consulte el tema "Agregar un dominio", para más detalles sobre este tema consulte el archivo Readme.html.


Agregar un dominio
Por ejemplo para agregar un dominio que tenga el nombre "additional.domain.com" se debe seguir el siguiente procedimiento :

1)Arranque el servidor XMail si es que está detenido
2)Desde una ventana de terminal con privilegios de administrador, use la herramienta CtrlClnt,  una cuenta de administrador, y la dirección donde el servidor está instalado para agregar el nuevo dominio del siguiente modo :

CtrlClnt -s localhost -u xmail_admin -p 123456789 domainadd additional.domain.com

La herramienta CtrlClnt se encuentra en "{sysfile}\MailRoot\bin" en sistemas Windows o "/var/MailRoot/bin" en sistemas Unix, para más detalles sobre este tema consulte el archivo Readme.html.


Listar los dominios existentes
Para obtener la lista de los dominios existentes en el servidor, debemos realizar los siguientes pasos :

1)Arrancar el servidor XMail si es que está detenido
2)Desde una ventana de terminal con privilegios de administrador, use la herramienta CtrlClnt,  una cuenta de administrador, y la dirección donde el servidor está instalado para obtener la lista de dominios existentes del siguiente modo :

CtrlClnt -s localhost -u xmail_admin -p 123456789 domainlist

"xmailserver.test"
"additional.domain.com"
"first.domain.com"

Para más detalles sobre este tema consulte el archivo Readme.html.


Eliminar un dominio
Para eliminar cualquier dominio se tiene que seguir el siguiente procedimiento :

1)Arrancar el servidor XMail si es que está detenido
2)Desde una ventana de terminal con privilegios de administrador, use la herramienta CtrlClnt,  una cuenta de administrador, y la dirección donde el servidor está instalado para eliminar un dominio del siguiente modo :

CtrlClnt -s localhost -u xmail_admin -p 123456789 domaindel xmailserver.test

En este ejemplo se elimina el dominio "xmailserver.test", como este dominio es solo un ejemplo no hay problema. Se debe tener una gran precaución al borrar dominios, antes de borrar cualquier dominio se debe consultar con los de más administradores del servidor XMail. 

Para más detalles sobre este tema consulte el archivo Readme.html.


Crear un nuevo usuario
Para crear un usuario se tienen que seguir los pasos siguientes :

1)Arrancar el servidor XMail si es que está detenido
2)Desde una ventana de terminal con privilegios de administrador, use la herramienta CtrlClnt,  una cuenta de administrador,  la dirección donde el servidor está instalado y  el dominio donde sera creado el usuario del siguiente modo :

CtrlClnt -s localhost -u xmail_admin -p 123456789 useradd first.domain.com paco 01020304 U

En este caso estamos agregando una nueva cuenta (el parámetro "U" nos indica que es una cuenta de usuario) al dominio "first.domain.com", el nombre de la cuenta es "paco" y el password es 01020304 en este caso el password se introduce sin encriptar y "CtrlClnt" lo encripta automáticamente la cuenta creada quedaría de la siguiente forma : 

Nombre de la cuenta : paco@first.domain.com
Nombre de usuario   : paco
Password            : 01020304

Algo muy importante es que el nombre de usuario se debe escribir con todo y la arroba más el nombre del dominio, si es que el usuario que estamos creando no forma parte del dominio principal. Por ejemplo si creamos al usuario "paco" en otro dominio que no es el dominio principal como en "additional.domain.com" entonces los datos de la cuenta quedarían del siguiente modo :

Nombre de la cuenta : paco@additional.domain.com
Nombre de usuario   : paco@additional.domain.com
Password            : 01020304

Es muy importante recordar este detalle cuando configuramos un cliente de correo como Microsoft Outlook o Evolution. Para más detalles sobre este tema consulte el archivo Readme.html.


Eliminar un usuario
Para eliminar un usuario se tiene que seguir el siguiente procedimiento :

1)Arrancar el servidor XMail si es que está detenido
2)Desde una ventana de terminal con privilegios de administrador, use la herramienta CtrlClnt,  una cuenta de administrador,  la dirección donde el servidor está instalado y  el dominio en el cual eliminar un usuario del siguiente modo :

CtrlClnt -s localhost -u xmail_admin -p 123456789 userdel first.domain.com paco

En este ejemplo se elimina la cuenta "paco@first.domain.com",  se debe tener una gran precaución al eliminar usuarios, antes de eliminar a cualquier usuario se debe consultar con los de más administradores del servidor XMail. 

Para más detalles sobre este tema consulte el archivo Readme.html.


Listar los usuarios de un dominio
Para obtener la lista de usuarios de un dominio debemos realizar los siguientes pasos :

1)Arrancar el servidor XMail si es que está detenido
2)Desde una ventana de terminal con privilegios de administrador, use la herramienta CtrlClnt,  una cuenta de administrador, y la dirección donde el servidor está instalado para obtener la lista de usuarios de un dominio del siguiente modo :

CtrlClnt -s localhost -u xmail_admin -p 123456789 userlist first.domain.com

"first.domain.com"      "paco"  "01020304"      "U"

El resultado es la lista de usuarios del dominio seleccionado. Para más detalles sobre este tema consulte el archivo Readme.html.


Cambiar el password de un usuario
Para cambiar el password de un usuario debemos realizar el siguiente procedimiento :

1)Arrancar el servidor XMail si es que está detenido
2)Desde una ventana de terminal con privilegios de administrador, use la herramienta CtrlClnt,  una cuenta de administrador,  la dirección donde el servidor está instalado, el nobre de usuario, dominio y el nuevo password para realizar el cambio de la siguiente forma  :

CtrlClnt -s localhost -u xmail_admin -p 123456789 userpasswd first.domain.com paco 11121314

En este caso le asignamos a la cuenta "paco@first.domain.com" el nuevo password 11121314. Es muy importante que al cambiar el password, le informemos al usuario afectado inmediatamente o de lo contrario no podra acceder a sus mensajes de correo electrónico. 

Para más detalles sobre este tema consulte el archivo Readme.html.


Obtener las estadísticas de un usuario
Las estadísticas del usuario es un conjunto de información que sirve de referencia acerca de las actividades realizadas por el usuario. Para obtener las estadísticas de un usuario se deben seguir los siguientes pasos :

1)Arrancar el servidor XMail si es que está detenido
2)Desde una ventana de terminal con privilegios de administrador, use la herramienta CtrlClnt,  una cuenta de administrador,  la dirección donde el servidor está instalado, el nombre de usuario y dominio para obtener las estadísticas de la siguiente forma  :

CtrlClnt -s localhost -u xmail_admin -p 123456789 userstat first.domain.com paco

"RealAddress"   "paco@first.domain.com"
"MailboxSize"   "0"
"MailboxMessages"       "0"
"LastLoginTimeDate"     "Fri, 15 Oct 2010 11:10:32 -0600"
"LastLoginIP"   "0.0.0.0"

Entre la información retornada se encuentra el nombre de la cuenta, el tamaño y la última dirección desde donde el usuario accedío a la cuenta, esta información generalmente es útil para fines administrativos. 

Para más detalles sobre este tema consulte el archivo Readme.html.