Working with Virtual Hosts

To add a virtual host:

1. In the UI, go to the Applications | Virtual Hosts page.
2. In the Action bar, click .
   The Add Virtual Host wizard is displayed.

3. Enter the virtual host properties:
   • Virtual Host Name - The virtual host's name or IP address.
   • Listen on Port - The Web server port the virtual host listens on.

     Important!

     Before you assign a virtual host to a specific port, make sure it is listened to by your web server.

4. Click Next.
   The SSL Configuration dialog is displayed.

5. If the virtual host does not use SSL security, skip to the next step.
   To enable SSL for the virtual host, select Enable SSL security on this virtual host, and enter the following details:
   • Certificate File Path - The path to the SSL certificate file.
   • Key File Path - The path to the SSL key file.
   • Chain File Path - The path to the SSL chain path (if you are using an Intermediate SSL certificate).

   Important!

   Before adding an SSL-secured virtual host, you will need to enable SSL on your web server. For more information, see Enabling SSL for Apache.

6. Click Next.
   Zend Server validates the SSL configurations, and the Template dialog is displayed.

7. If you wish to use the default virtual host configuration template, skip to the next step.
   To edit the default configuration template, select Edit the virtual host configuration template. For a description of the variables, see Virtual Host Template Legend.

   Warning!

   Editing the virtual host template could cause problems to your Web server's configuration. Proceed with extreme caution.

   Note:

   The DocumentRoot and Directory directives must only contain ${docroot} variable, and should not be modified within the vhost template. You can still use the ${docroot}, which corresponds to the Document Root defined in the application ZPK packages, within any other directive, for example a rewrite rule.

   NginX only: virtual hosts are using the 'root' directive, not DocumentRoot + Directory.

   Note:

   If you are not using the default port, edit the template by add ing a listen directive for the port you are using. e.g. "Listen 8080".

8. Click Next.
   Zend Server validates the virtual host configuration template. Zend Server will warn you if there are any errors with the template validation (if there are no errors, skip to the next step).

• To return to the configuration template - click Back, reconfigure the template, and click Next again.
• To ignore the warning - select the check-box below ('I understand that...'), and click Continue.

  Warning!

  Storing a virtual host with errors may cause problems to your Web server's configuration.

9. The Summary dialog is displayed.

10. Review a summary of the new virtual host, and click Finish.
    The new virtual host is stored, added to the Virtual Hosts list, and can now be used for deploying applications.
11. Restart Zend Server to make the virtual host available.
    

To edit a virtual host:

1. In the UI, go to the Applications | Virtual Hosts page.
2. In the Virtual Hosts list, select or hover over the virtual host you wish to edit, and in the Actions column, click .
   The Edit Virtual Host wizard is displayed.

3. The virtual host name and port cannot be changed. Click Next.
   The SSL Configuration dialog is displayed.

Important:

The configuration options on this dialog depend on the virtual host configuration. SSL can not be added to a virtual host which is not SSL-secured. Likewise, SSL security cannot be removed from an SSL- secured virtual host.

4. If the virtual host is not SSL-secured, skip to the next step.
   If the virtual host is SSL-secured, you can configure the SSL certificate file paths:

• Certificate File Path - The path to the SSL certificate file.
• Key File Path - The path to the SSL key file.
• Chain File Path - The path to the SSL chain path (if you are using an Intermediate SSL certificate).

5. Click Next.
   The Template dialog is displayed.

6. To continue using the current template, select Use the current virtual host configuration template.
   To edit this template, select Edit the current configuration template, and apply your changes. For a description of the variables, see Virtual Host Template Legend.

   Warning!

   Editing the virtual host template could cause problems to your Web server's configuration. Proceed with extreme caution.

   Note:

   The DocumentRoot and Directory directives must only contain ${docroot} variable, and should not be modified within the vhost template. You can still use the ${docroot}, which corresponds to the Document Root defined in the application ZPK packages, within any other directive, for example a rewrite rule.

   NginX only: virtual hosts are using the 'root' directive, not DocumentRoot + Directory.

7. Click Next.
   The Summary dialog is displayed.

8. Review a summary of your changes to the virtual host, and click Finish. .
   Zend Server will apply the changes and store the virtual host.
9. Restart Zend Server to make the virtual host available.

To redeploy a virtual host:

1. In the UI, go to the Applications | Virtual Hosts page.
2. In the Virtual Hosts list, select or hover over the virtual host you wish to edit, and in the Actions column, click .
3. When prompted, click OK.
   The virtual host is redeployed.

4. In the toolbar, the restart icon lights up , indicating a restart is needed to apply changes. Click to restart server and apply changes.
   For information on restarting in Zend Server, see Server Restart.

To remove a virtual host:

1. In the UI, go to the Applications | Virtual Hosts page.
2. In the Virtual Hosts list, select or hover over the virtual host you wish to edit, and in the Actions column, click .
3. When prompted, click OK to remove the virtual host.
   The virtual host is removed from Zend Server.

   Note:

   If an application is deployed on the virtual host you are attempting to remove, you will be asked to approve the removal of the application as well.

To enable deployment:

1. In the UI, go to the Applications | Virtual Hosts page.
2. In the Virtual Hosts list, select or hover over the system-defined virtual host you wish Zend Server to manage, and in the Actions column, click .
   The Enable Deployment dialog is displayed.

3. Add the specified line of code to the virtual host section in the Web server's configuration file (e.g., C:\Program Files (x86)\Zend\Apache2\conf\httpd.conf) as follows:

# minimal directives + any IP + specified port
#L Listen 80
#L NameVirtualHost *:80
<VirtualHost *:80>
DocumentRoot /tmp/www/2013-11-03-14-22-45-80
ServerName 2013-11-03-14-22-45
DirectoryIndex index.php index.html index.htm gonzo.html
<Directory "/tmp/www/2013-11-03-14-22-45-80">
Allow from all
</Directory>
Include "/usr/local/zend/etc/sites.d/zend_managed_virtual host_96.conf"
</VirtualHost>

4. Click Close.

   The Properties column will now display the Deployment Enabled icon . Applications can now be deployed using this virtual host. See Deploying Applications for more information.

Important!

To enable deployment to a virtual host in a cluster, repeat this process for each server in the cluster.

To disable deployment:

1. In the UI, go to the Applications | Virtual Hosts page.
2. In the Virtual Hosts list, select or hover over the virtual host you wish Zend Server to manage, and in the Actions column, click .
   The Disable Deployment Notice is displayed.
3. Click Close.
4. To disable deployment to a virtual host in a cluster, repeat this process for each server in the cluster.
   

Note:

Disabling deployment will not revert the changes made to the virtual host template when enabling deployment. You can either manually revert these changes or keep them in place - they do not disrupt the operation of your server.

To filter virtual hosts:

1. In the UI, go to the Applications | Virtual Hosts page.

2. In the Filters area, click the Filter-Set drop-down menu, and select a filter-set (Default filter set: All Virtual Hosts).
   The included filters are displayed in the Filter By area, and the Virtual Hosts list is filtered accordingly.
3. To further filter virtual hosts, in the top-left corner of the Filters area , click Show Filters.
   The Filter Action bar, and filter categories are displayed.

4. Click on a filter to add it.
   Each time a different filter is added, an additional selection area will appear in the Filter By area. You can add as many filters you like.
   All selected filters are displayed in the Filter By area, and the Virtual Hosts list is filtered accordingly.
5. To remove a specific filter from the filter-set, click the filter's delete button (X) in the Filter By area.
6. To save the selected filters as a new filter-set, click , and enter a name in the Name field.
   The new filter-set is saved and added to the Filter-Set list.
7. To configure an existing filter-set, select it from the Filter-Set list:
   1. To rename it, click and enter a new name.
   2. To create a new filter-set based on the selected set, add or remove filters according to your personal preferences, and repeat step a.
   3. To delete it, select it from the Filter-Set list, and click .

To clear all selected filters from the Filter By area, click .