VPS v2 Support Documentation

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.

1. If you have configured a user account for your Virtual Subhost customers, then they can access iManager using the Virtual Private Server IP address or hostname, like this:

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

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

   The users would simply use their user account login and password in order to authenticate.

2. An easy 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/apache/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/apache/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.