iManager for Virtual Subhosts

iManager empowers your Virtual Subhost customers to manage their own accounts using the comfortable, easy-to-use iManager environment. Available features include:

• Changing their password and viewing their quota and usage

• Uploading and editing files to their home directory

• Sending and receiving e-mail through the web-based Mail Manager

Additionally, iManager will help you successfully manage the configuration of Virtual Subhost E-Mail accounts.

Configuration

iManager authenticates a user by looking in the ~/etc/passwd file. Hence, any user with a valid Virtual Private Server User Account can access iManager with their login and password. Access will be granted only to the user's home directory. If you have configured a user account for your Virtual Subhost customers, then they can access iManager using the Virtual Private Server hostname, like this:

http://YOUR.IP.ADD.RESS/imanager/

The users would simply use their user account login and password in order to authenticate. It is also possible to configure your Virtual Private Server so that a user can also access iManager using their own domain name, like this:

http://SUBHOST-DOMAIN.NAME/imanager/

or something more generic like mail instead of imanager, for example:

http://SUBHOST-DOMAIN.NAME/mail/

To use either one of the above urls, you would add one of the following Alias directives to your web server configuration file (~/www/conf/httpd.conf).

Alias /imanager/ /usr/local/etc/httpd/htdocs/imanager/
Alias /mail/ /usr/local/etc/httpd/htdocs/imanager/

Of course, you can choose any alias name that strikes your fancy. You would simply need to replace /imanager/ or /mail/ in one of the previous Alias directives to be whatever you wish.

An alternative way to configure your Virtual Private Server so that a subhosted domain name can access iManager is to use a canonical domain name such as imanager or mail. Consider the following examples:

http://imanager.SUBHOST-DOMAIN.NAME/
http://mail.SUBHOST-DOMAIN.NAME/

To enable access to iManager in this way, complete the following steps.

1. Add a CNAME record in the zone file for the Virtual Subhost's domain name. We suggest using imanager or mail for the CNAME record (for example, imanager.SUBHOST-DOMAIN.NAME or mail.SUBHOST-DOMAIN.NAME), but you can specify any name you want.

2. Add the following <VirtualHost...> directive to your web server configuration file (~/www/conf/httpd.conf).

   <VirtualHost imanager.SUBHOST-DOMAIN.NAME>
   ServerName imanager.SUBHOST-DOMAIN.NAME
   ServerAdmin webmaster@SUBHOST-DOMAIN.NAME
   DocumentRoot /usr/local/etc/httpd/htdocs/imanager
   TransferLog /dev/null
   </VirtualHost>

   or alternatively:

   <VirtualHost mail.SUBHOST-DOMAIN.NAME>
   ServerName mail.SUBHOST-DOMAIN.NAME
   ServerAdmin webmaster@SUBHOST-DOMAIN.NAME
   DocumentRoot /usr/local/etc/httpd/htdocs/imanager
   TransferLog /dev/null
   </VirtualHost>

   NOTE: If you would like to use a different canonical name, then substitute the CNAME record you created for imanager or mail above in the VirtualHost and ServerName directives. Do not change the DocumentRoot directive.