**Tested on ispCP 1.0.5; running Ubuntu 9.10**

This guide will allow you to access the different tools provided with ispCP (PhpMyAdmin, Filemanager, Webmail, etc..) to be acessible using the following addresses :


  - http://panel.your_company.org (ispCP Panel)
  - http://webmail.your_company.org (Webmail)
  - http://webftp.your_company.org (Filemanager)
  - http://pma.your_company.org (PhpMyAdmin)

The standard addresses used by ispCP, such as http://your_company.org/pma (for PhpMyAdmin) or disabled by default in this tutorial.

====== Updating DNS files ======

<code>vim /etc/ispcp/bind/parts/db_e.tpl</code>

Find :

<code>; CNAME for web transfer
ftp             IN              CNAME           www</code>

Add after :

<code>*               IN              A               {DMN_IP}</code>

Save & close.

====== Updating Apache files ======

Open up the file for domain aliases :

<code>vim /etc/ispcp/apache/parts/als_entry.tpl</code>

Replace :
<code>ServerAlias     www.{ALS_NAME} {ALS_NAME} *.{ALS_NAME}</code>

By :
<code>ServerAlias     www.{ALS_NAME} ftp.{ALS_NAME}</code>

Replace :
<code>
    RedirectMatch permanent ^/ftp([\/]?)               {BASE_SERVER_VHOST_PREFIX}{BASE_SERVER_VHOST}/ftp/
    RedirectMatch permanent ^/pma([\/]?)               {BASE_SERVER_VHOST_PREFIX}{BASE_SERVER_VHOST}/pma/
    RedirectMatch permanent ^/webmail([\/]?)   {BASE_SERVER_VHOST_PREFIX}{BASE_SERVER_VHOST}/webmail/
    RedirectMatch permanent ^/ispcp([\/]?)             {BASE_SERVER_VHOST_PREFIX}{BASE_SERVER_VHOST}/
</code>

By :

<code>
    #RedirectMatch permanent ^/ftp([\/]?)               {BASE_SERVER_VHOST_PREFIX}{BASE_SERVER_VHOST}/ftp/
    #RedirectMatch permanent ^/pma([\/]?)               {BASE_SERVER_VHOST_PREFIX}{BASE_SERVER_VHOST}/pma/
    #RedirectMatch permanent ^/webmail([\/]?)   {BASE_SERVER_VHOST_PREFIX}{BASE_SERVER_VHOST}/webmail/
    #RedirectMatch permanent ^/ispcp([\/]?)             {BASE_SERVER_VHOST_PREFIX}{BASE_SERVER_VHOST}/
</code>

Save & close.

Open up the file for domains :

<code>vim /etc/ispcp/apache/parts/dmn_entry.tpl</code>

Replace :
<code>ServerAlias     www.{DMN_NAME} {DMN_NAME} *.{DMN_NAME} {SUEXEC_USER}.{BASE_SERVER_VHOST}</code>

By :
<code> ServerAlias     www.{DMN_NAME} ftp.{DMN_NAME} {SUEXEC_USER}.{BASE_SERVER_VHOST}</code>

Replace :
<code>
    RedirectMatch permanent ^/ftp([\/]?)               {BASE_SERVER_VHOST_PREFIX}{BASE_SERVER_VHOST}/ftp/
    RedirectMatch permanent ^/pma([\/]?)               {BASE_SERVER_VHOST_PREFIX}{BASE_SERVER_VHOST}/pma/
    RedirectMatch permanent ^/webmail([\/]?)   {BASE_SERVER_VHOST_PREFIX}{BASE_SERVER_VHOST}/webmail/
    RedirectMatch permanent ^/ispcp([\/]?)             {BASE_SERVER_VHOST_PREFIX}{BASE_SERVER_VHOST}/
</code>

By :
<code>
    #RedirectMatch permanent ^/ftp([\/]?)               {BASE_SERVER_VHOST_PREFIX}{BASE_SERVER_VHOST}/ftp/
    #RedirectMatch permanent ^/pma([\/]?)               {BASE_SERVER_VHOST_PREFIX}{BASE_SERVER_VHOST}/pma/
    #RedirectMatch permanent ^/webmail([\/]?)   {BASE_SERVER_VHOST_PREFIX}{BASE_SERVER_VHOST}/webmail/
    #RedirectMatch permanent ^/ispcp([\/]?)             {BASE_SERVER_VHOST_PREFIX}{BASE_SERVER_VHOST}/
</code>

Save & close.

Open up the file for sub-domains :

<code>vim /etc/ispcp/apache/parts/sub_entry.tpl</code>

Replace :
<code>ServerAlias     www.{SUB_NAME} {SUB_NAME} *.{SUB_NAME}</code>

By : 
<code>ServerAlias     www.{SUB_NAME} ftp.{SUB_NAME}</code>

Replace :
<code>
    RedirectMatch permanent ^/ftp([\/]?)               {BASE_SERVER_VHOST_PREFIX}{BASE_SERVER_VHOST}/ftp/
    RedirectMatch permanent ^/pma([\/]?)               {BASE_SERVER_VHOST_PREFIX}{BASE_SERVER_VHOST}/pma/
    RedirectMatch permanent ^/webmail([\/]?)   {BASE_SERVER_VHOST_PREFIX}{BASE_SERVER_VHOST}/webmail/
    RedirectMatch permanent ^/ispcp([\/]?)             {BASE_SERVER_VHOST_PREFIX}{BASE_SERVER_VHOST}/
</code>

By :

<code>
    #RedirectMatch permanent ^/ftp([\/]?)               {BASE_SERVER_VHOST_PREFIX}{BASE_SERVER_VHOST}/ftp/
    #RedirectMatch permanent ^/pma([\/]?)               {BASE_SERVER_VHOST_PREFIX}{BASE_SERVER_VHOST}/pma/
    #RedirectMatch permanent ^/webmail([\/]?)   {BASE_SERVER_VHOST_PREFIX}{BASE_SERVER_VHOST}/webmail/
    #RedirectMatch permanent ^/ispcp([\/]?)             {BASE_SERVER_VHOST_PREFIX}{BASE_SERVER_VHOST}/
</code>

====== Creating  panel.domain.tld, webmail.domain.tld, pma.domain.tld, and ftp.domain.tld apache files ======

===== ispCP Panel =====

The default 00_master.conf file will be used to host the address panel.domain.tld.

<code>vim /etc/apache2/sites-available/00_master.conf</code>

Find :
<code>
<VirtualHost {BASE_SERVER_IP}:80></code>

Before, add :
<code><VirtualHost SERVER_IP:80>
	ServerName SERVER_VHOST
	Redirect / http://panel.DOMAIN.TLD
</VirtualHost></code>

Replace :
<code>DocumentRoot    /var/www/ispcp/gui

ServerName {BASE_SERVER_VHOST}</code>

By :
<code>DocumentRoot    /var/www/ispcp/gui

ServerName panel.DOMAIN.TLD</code>

Replace :
<code>
    Alias /pma      /var/www/ispcp/gui/tools/pma/
    Alias /webmail  /var/www/ispcp/gui/tools/webmail/
    Alias /ftp      /var/www/ispcp/gui/tools/filemanager/
</code>

By :

<code>
    #Alias /pma      /var/www/ispcp/gui/tools/pma/
    #Alias /webmail  /var/www/ispcp/gui/tools/webmail/
    #Alias /ftp      /var/www/ispcp/gui/tools/filemanager/
</code>

Save & close.

Be careful to replace ALL of the **DOMAIN.TLD** addresses by FQDN you wish to use to access the panel and its different tools, as well as **SERVER_IP** and **SERVER_VHOST** with your respective server IP address and name!

===== Webmail =====

Now we create the file used to access the webmail :

<code>vim /etc/apache2/sites-available/02_webmail.conf</code>

Paste the following code :
<code><VirtualHost SERVER_IP:80>

    ServerAdmin     ADMIN_EMAIL_ADDRESS
    DocumentRoot    /var/www/ispcp/gui/tools/webmail

    ServerName      webmail.DOMAIN.TLD

    ErrorLog        /var/log/apache2/users/webmail-error.log
    TransferLog     /var/log/apache2/users/webmail-access.log
    CustomLog       /var/log/apache2/webmail-traf.log traff
    CustomLog       /var/log/apache2/webmail-combined.log combined

    <IfModule suexec_module>
           SuexecUserGroup vu2000 vu2000
    </IfModule>

    <Directory /var/www/ispcp/gui/tools/webmail>
        Options -Indexes Includes FollowSymLinks MultiViews
        AllowOverride None
        Order allow,deny
        Allow from all
    </Directory>

    <IfModule mod_fcgid.c>
        <Directory /var/www/ispcp/gui/tools/webmail>
            FCGIWrapper /var/www/fcgi/master/php5-fcgi-starter .php
            Options +ExecCGI
        </Directory>
        <Directory "/var/www/fcgi/master">
            AllowOverride None
            Options +ExecCGI
            Order allow,deny
            Allow from all
        </Directory>
    </IfModule>
    <IfModule mod_fastcgi.c>
        ScriptAlias /php5/ /var/www/fcgi/master/
        <Directory "/var/www/fcgi/master">
            AllowOverride None
            Options +ExecCGI MultiViews -Indexes
            Order allow,deny
            Allow from all
        </Directory>
    </IfModule>

    <IfModule mod_php5.c>
        <Directory /var/www/ispcp/gui/tools/webmail>
            php_admin_value open_basedir "/var/www/ispcp/gui/tools/webmail/:/etc/ispcp/:/var/run/ispcp.lock:/proc/:/bin/df:/bin/mount:/var/log/rkhunter.log:/var/log/chkrootkit.log:/usr/share/php/"
            php_admin_value session.save_path "/var/www/ispcp/gui/phptmp/"
            php_admin_value upload_tmp_dir "/var/www/ispcp/gui/phptmp/"
        </Directory>
    </IfModule>

</VirtualHost>
</code>

Again, you must replace **BASE_SERVER_IP** by your server IP, **DEFAULT_ADMIN_ADDRESS** by the admin's email address, and **DOMAIN.TLD** by the FQDN you want to use.

===== PhpMyAdmin =====

Now we create the file used to access PhpMyAdmin :

<code>vim /etc/apache2/sites-available/03_pma.conf</code>

Paste the following code :

<code><VirtualHost SERVER_IP:80>

    ServerAdmin     ADMIN_EMAIL_ADDRESS
    DocumentRoot    /var/www/ispcp/gui/tools/pma

    ServerName      pma.DOMAIN.TLD

    ErrorLog        /var/log/apache2/users/pma-error.log
    TransferLog     /var/log/apache2/users/pma-access.log
    CustomLog       /var/log/apache2/pma-traf.log traff
    CustomLog       /var/log/apache2/pma-combined.log combined

    <IfModule suexec_module>
           SuexecUserGroup vu2000 vu2000
    </IfModule>

    <Directory /var/www/ispcp/gui/tools/pma>
        Options -Indexes Includes FollowSymLinks MultiViews
        AllowOverride None
        Order allow,deny
        Allow from all
    </Directory>

    <IfModule mod_fcgid.c>
        <Directory /var/www/ispcp/gui/tools/pma>
            FCGIWrapper /var/www/fcgi/master/php5-fcgi-starter .php
            Options +ExecCGI
        </Directory>
        <Directory "/var/www/fcgi/master">
            AllowOverride None
            Options +ExecCGI
            Order allow,deny
            Allow from all
        </Directory>
    </IfModule>
    <IfModule mod_fastcgi.c>
        ScriptAlias /php5/ /var/www/fcgi/master/
        <Directory "/var/www/fcgi/master">
            AllowOverride None
            Options +ExecCGI MultiViews -Indexes
            Order allow,deny
            Allow from all
        </Directory>
    </IfModule>

    <IfModule mod_php5.c>
        <Directory /var/www/ispcp/gui/tools/pma>
            php_admin_value open_basedir "/var/www/ispcp/gui/tools/pma/:/etc/ispcp/:/var/run/ispcp.lock:/proc/:/bin/df:/bin/mount:/var/log/rkhunter.log:/var/log/chkrootkit.log:/usr/share/php/"
            php_admin_value session.save_path "/var/www/ispcp/gui/phptmp/"
            php_admin_value upload_tmp_dir "/var/www/ispcp/gui/phptmp/"
        </Directory>
    </IfModule>

</VirtualHost></code>

Don't forget, you must replace **BASE_SERVER_IP** by your server IP, **DEFAULT_ADMIN_ADDRESS** by the admin's email address, and **DOMAIN.TLD** by the FQDN you want to use.

===== Webftp =====

Finally, we create the file that will be used to access the Filemanager.

<code>vim /etc/apache2/sites-available/04_webftp.conf</code>

Paste the following code :
<code><VirtualHost SERVER_IP:80>

    ServerAdmin     ADMIN_EMAIL_ADDRESS
    DocumentRoot    /var/www/ispcp/gui/tools/filemanager

    ServerName      webftp.DOMAIN.TLD

    ErrorLog        /var/log/apache2/users/webftp-error.log
    TransferLog     /var/log/apache2/users/webftp-access.log
    CustomLog       /var/log/apache2/webftp-traf.log traff
    CustomLog       /var/log/apache2/webftp-combined.log combined

    <IfModule suexec_module>
           SuexecUserGroup vu2000 vu2000
    </IfModule>

    <Directory /var/www/ispcp/gui/tools/filemanager>
        Options -Indexes Includes FollowSymLinks MultiViews
        AllowOverride None
        Order allow,deny
        Allow from all
    </Directory>

    <IfModule mod_fcgid.c>
        <Directory /var/www/ispcp/gui/tools/filemanager>
            FCGIWrapper /var/www/fcgi/master/php5-fcgi-starter .php
            Options +ExecCGI
        </Directory>
        <Directory "/var/www/fcgi/master">
            AllowOverride None
            Options +ExecCGI
            Order allow,deny
            Allow from all
        </Directory>
    </IfModule>
    <IfModule mod_fastcgi.c>
        ScriptAlias /php5/ /var/www/fcgi/master/
        <Directory "/var/www/fcgi/master">
            AllowOverride None
            Options +ExecCGI MultiViews -Indexes
            Order allow,deny
            Allow from all
        </Directory>
    </IfModule>

    <IfModule mod_php5.c>
        <Directory /var/www/ispcp/gui/tools/filemanager>
            php_admin_value open_basedir "/var/www/ispcp/gui/tools/filemanager/:/etc/ispcp/:/var/run/ispcp.lock:/proc/:/bin/df:/bin/mount:/var/log/rkhunter.log:/var/log/chkrootkit.log:/usr/share/php/"
            php_admin_value session.save_path "/var/www/ispcp/gui/phptmp/"
            php_admin_value upload_tmp_dir "/var/www/ispcp/gui/phptmp/"
        </Directory>
    </IfModule>

</VirtualHost>
</code>

As always, you must replace **BASE_SERVER_IP** by your server IP, **DEFAULT_ADMIN_ADDRESS** by the admin's email address, and **DOMAIN.TLD** by the FQDN you want to use.

===== Activating the new virtual hosts =====

Placing ourselves in the correct directory :

<code>cd /etc/apache2/sites-available</code>

Activating virtual hosts :

<code>a2ensite 02_webmail.conf</code>
<code>a2ensite 03_pma.conf</code>
<code>a2ensite 04_webftp.conf</code>

Reload Apache 2 :
<code>/etc/init.d/apache2 reload</code>

If you get no warnings/errors, you're good to go! If you do, double check your files, something is wrong!

====== Updating ispCP configuration ======

This modification will allow for all dependent files to have the correct link to the different tools used by ispCP.

<code>vim /etc/ispcp/ispcp.conf</code>

Replace :
<code>BASE_SERVER_VHOST = old-address.net</code>

By :
<code>BASE_SERVER_VHOST = panel.DOMAIN.TLD</code>

Replace :
<code>WEBMAIL_PATH = ../tools/webmail/</code>

By :
<code>WEBMAIL_PATH = http://webmail.DOMAIN.TLD</code>

Replace :
<code>PMA_PATH = ../tools/pma/</code>

By :
<code>PMA_PATH = http://pma.DOMAIN.TLD</code>

Replace :
<code>FILEMANAGER_PATH = ../tools/filemanager/</code>

By :
<code>FILEMANAGER_PATH = http://webftp.DOMAIN.TLD</code>

Save & close.

Open :
<code>vim /var/www/ispcp/gui/index.php</code>

Replace :
<code>
'TR_WEBMAIL_SSL_LINK'       => "webmail",
'TR_FTP_SSL_LINK'           => "ftp",
'TR_PMA_SSL_LINK'           => "pma",
</code>

By :
<code>'TR_WEBMAIL_SSL_LINK'       => isset($_SERVER['HTTPS']) ? 'https://webmail.DOMAIN.TLD' : 'http://webmail.DOMAIN.TLD',
'TR_FTP_SSL_LINK'           => isset($_SERVER['HTTPS']) ? 'https://webftp.DOMAIN.TLD' : 'http://webftp.DOMAIN.TLD',
'TR_PMA_SSL_LINK'           => isset($_SERVER['HTTPS']) ? 'https://pma.DOMAIN.TLD' : 'http://pma.DOMAIN.TLD',
</code>


====== Regenerating ispCP files ======

First, we remove the old copies of ispcp.conf :

<code>rm /etc/apache2/sites-available/ispcp.conf
rm /etc/ispcp/apache/working/ispcp.conf</code>

We regenerate the files now :

<code>cp /etc/ispcp/apache/parts/ispcp_base.tpl /etc/apache2/sites-available/ispcp.conf
cp /etc/ispcp/apache/parts/ispcp_base.tpl /etc/ispcp/apache/working/ispcp.conf</code>

Stopping ispCP :
<code>/etc/init.d/ispcp_daemon stop</code>

Logon to MySQL :
<code> mysql -u root -p</code>

In MySQL command prompt type :
<code>USE ispcp;</code>
<code>UPDATE `domain` SET `domain_status` = 'change' WHERE `domain_status` = 'ok';</code>
<code>UPDATE `subdomain` SET `subdomain_status` = 'change' WHERE `subdomain_status` = 'ok';</code>
<code>UPDATE `domain_aliasses` SET `alias_status` = 'change' WHERE `alias_status` = 'ok';</code>
<code>UPDATE `mail_users` SET `status` = 'change' WHERE `status` = 'ok';</code>

Quit MySQL :
<code>quit</code>

Process the request :
<code>/var/www/ispcp/engine/ispcp-rqst-mngr</code>

Start ispCP daemon :
<code>/etc/init.d/ispcp_daemon start</code>

There, you're done! Now you can access ispCP and its various tools (PhpMyAdmin, Filemanager, Webmail, etc..) at the following addresses :

  - http://panel.your_company.org (ispCP Panel)
  - http://webmail.your_company.org (Webmail)
  - http://webftp.your_company.org (Filemanager)
  - http://pma.your_company.org (PhpMyAdmin)

Credits go to : http://nuxwin.com/articles/view.php/42; Kommius