By proxy Definition

Adding a Proxy Definition — Enfold Systems, the Plone Experts
Munchausen by Proxy and Factitious Disorder Imposed on Another

After you have verified that your host or domain resolves correctly within a browser, you can now add a proxy definition to link this host to a Plone site.

  1. Open the Enfold Server Configuration Utility to do this. (Start -> All Programs -> Enfold Server -> Enfold Server Configuration Utility). Modify/write down the management port number for this Zope client. (Note: Each Zope client must have a unique management port number. If not, then the Check Utility will show an error).
  2. Disable the HTTP port (usually port 80) for the Zope client. Your ultimate goal is for Enfold Proxy to listen to port 80 requests to this IIS site and to communicate with the Zope client via port 8080. Here is a screenshot of typical settings for your Zope client in Enfold Server.
  1. Restart any Zope client(s) you have modified by choosing the Start|Stop option on the left panel.
  2. Open the EP Configuration Tool. Click the folder on the left panel Proxies. Choose Add a Proxy Definition . Give your proxy definition any name you want.
  3. Adjust the basic settings if necessary. By default, the new host comes with the most common defaults:

Local host= / Virtual host root = /Plone

These settings will cause the root (/) of your URL to go to the Plone site automatically created within your Zope client. The Plone site object should be visible inside the Zope Management Interface (ZMI). Change these values when necessary. You can verify the value for Virtual host root by logging into the ZMI application root and verifying that a folder corresponds to this value already exists. For more, see Using the ZMI.

  1. Add the Virtual Host that corresponds to your management port of your Zope client. The virtual host can be an IP address or a resolvable host. Examples:,, localhost:8080
  2. In your Proxy Definition, select the Site tab on the top. When you come to that screen, you will see a dropdown screen for the Site screen. Choose the IIS site which is serving the host/domain you will be using. For this, we shall use Default Web Site (which uses the host headers).
  1. After you press save for the last time, you will be able to see a "virtual folder" appear under the IIS which this proxy definition will be matched with.

Note: This proxy definition you created or edited in Enfold Proxy will not take effect until you see the _plone folder. EP will automatically make sure this virtual folder exists in the IIS whenever you save or update your Proxy Definition. If you do not see the folder which says _plone, make sure to try these things:

  • refresh the web site by typing F5 or using the Refresh icon the toolbar (in most cases this is sufficient).
  • restart the specific IIS site
  • restart the IIS server entirely.
  • make a minor edit to the proxy definition and press Save again (you can undo this later).

If the result is not what you expect, run Check Utility to troubleshoot. Also, see the Troubleshooting Checklist.

If you become stuck or wish to start from scratch, you can start over by deleting the host sections by using the GUI. Before you do so, you might wish to save a backup copy of your settings. Your settings are stored in the eep.ini file

It is usually not necessary to restart Zope or IIS when you do this, but when testing, make sure to clear your browser cache.


Related posts:

  1. Proxy Votes Definition
  2. Proxy data Definition
  3. Proxy bid Definition