VPDisk Application Note http013102

HTTProtect ISP Setup Examples

1. It is the intention for this application note as a reference for evaluation as well as example to bring up this product. There are many ways that ISP will do differently from this note.

2. There are several files need to be ready prior the installation of HTTProtect, namely:

  • Web Server files setup. An Apache configuration might contain the following directives:
    NameVirtualHost 74.176.172.76
<VirtualHost 74.176.172.76>
DocumentRoot /usr/local/apache/htdocs
ServerName apricot
ScriptAlias /cgi-bin/ "/usr/local/apache/cgi-bin/"
ErrorLog /usr/local/apache/logs/apricot-error_log
</VirtualHost>

<Directory "/usr/local/apache/cgi-bin">
AllowOverride None
Options None
Order allow,deny
Allow from all
</Directory>

# Host 1 (Add similar lines below for new Hosts):

NameVirtualHost 74.176.172.77
<VirtualHost 74.176.172.77>
DocumentRoot /export/www/example/htdocs
ServerName www.example.com
ScriptAlias /cgi-bin/ "/export/www/example/cgi-bin/"
ErrorLog /usr/local/apache/logs/example-error_log
</VirtualHost>
  • Hosts file setup, /etc/hosts file need to have correct IP, sample:
    127.0.0.1 localhost
74.176.172.76 apricot
74.176.172.77 www.example.com
  • VirtualHost Name file setup:
    sample /etc/hostname.hme0 contains "apricot"
    sample /etc/hostname.hme0:1 contains "www.example.com"
    (Add /etc/hostname.hme0:xx for new Host where xx is incremental number, with new VirtualHost Web Server Name in it)
  • Setup Virtual Host account, the Virtual Host home is set as /export/www/example in this sample.
  • Check "ifconfig -a" to see if the IP is appropriately set for each interfaces), If not, do:
    # ifconfig hme0:xx yyy
    where yyy is a new IP address.
  • Reboot the system.
  • After system come back, check "ifconfig -a" again to make sure all IPs are appropriately set with correct interfaces.

Now, you should have correct setup to start installing the HTTProtect ISP Edition product. You just need to refer to the HTTProtect ISP Edition User Manual for installation.

To add a new Host while your system is up and running with HTTProtect, here is the general procedure:

  • IT Adm. add new host account (Host home directory, login/passwd ...)
  • identify IP address and Web Server Name
  • update /etc/hosts
  • update /etc/hostname.hme0:xx
  • update /usr/local/apache/conf/httpd.conf.
  • check correct interface
  • manually bring up apache if needed: /usr/local/apache/bin/apachectl restart
  • "Add Host" through HTTProtect web GUI (require license key-pair here)
  • Inform new host: account login/passwd and host confirmation URL.

All the above procedures require to be root user, some updates require omnish privilege.