archive-com.com » COM » E » ENFOLDSYSTEMS.COM

Total: 720

Choose link from "Titles, links and description words view":

Or switch to "Titles and links view".
  • Reporting Problems
    is WARNING meaning that all warnings and error conditions detected by EP are written to the log Many issues you encounter will be detected by EP as an error so the log level will not need to be changed just open the log file and look for any error messages Issues such as an invalid integer in the configuration are an obvious error so will be written to the log Many other problems are also obviously an error so the logs will have their information However there will sometimes be more subtle issues you need to diagnose For example if a remote server is not available EP will display an error page with details of the error but will not log a WARNING message to the log nothing is wrong with EP in this situation just with the remote server In such cases EP writes an entry to the log at level INFO Adjusting the log level to INFO will display all such conditions information which may be valuable in tracking down external problems The log level DEBUG will yield lots of information many lines for each successful and failed request While this information is designed to allow the developers to diagnose issues with EP it may be of benefit to anyone trying to diagnose strange interactions in the field The log level is adjusted in the proxy log section of the config file by setting log level to a level name eg info or number Using Logs to view Headers The Proxy log level has a special log level called HEADERS If this log level is enabled every request and response will have their headers logged as shown below HEADERS is between DEBUG and URLS if you set the log level to DEBUG you will also see HEADERS but if you set it to URLS INFO or greater you do not Obviously you shouldn t run production servers at this log level The HEADERS log level uses arrows to indicate the direction in which HTTP requests are being handled If you are using Enfold Server together with IIS and Enfold Proxy then this diagram about how requests are handled might also be helpful Headers will be shown with one of 4 prefixes means the incoming request ie from the browser but it has some extra X headers our filter adds before it is logged means the request we make to Zope means the response from Zope back to us means our response to the client browser Below is an example Incoming client request 2008 09 02 16 20 46 812 proxy HEADERS 968 160 client request VirtualHostBase http localhost 3A80 Plone VirtualHostRoot vh Plone Accept text html application xhtml xml application xml q 0 9 q 0 8 Accept Language en us en q 0 5 Connection keep alive snip some headers User Agent Mozilla 5 0 Windows U Windows NT 5 1 en US rv 1 9 0 1 Gecko 2008070208 Firefox 3 0 1 Cookie ASPSESSIONIDCQAQSDQB JBBPHNGCEPOFIHMDMKJJJIEA

    Original URL path: http://www.enfoldsystems.com/software/proxy/docs/4.0/usinglogs.html (2016-02-11)
    Open archived version from archive


  • How Caching Works
    should indicate where the responses are coming from Mainly you will be checking how often Zope Plone is handling requests the less the better To verify caching you will need to view your HTTP response headers Several browser tools let you do this Live HTTP Headers http livehttpheaders mozdev org is the recommended tool This is a Firefox plugin which lets you view http headers in real time For easier reading you can go to the Generator tab and filter out image requests Firebug http www getfirebug com Here is another Firefox plugin which not only records http headers for each item but also records other information like download speed You can view HTTP information for each HTTP request by clicking on the web resource As excellent as this tool is Live HTTP Headers is probably better at capturing data in real time Fiddler http www fiddlertool com This is a tool for Internet Explorer A good MSDN tutorial about using fiddler is here http msdn2 microsoft com en us library bb250446 VS 85 aspx Tip 1 surf with two browsers More than likely you ll be using Firefox with Live Headers to inspect your http headers Then you can use one browser specifically to simulate a logged in user where different caching rules apply and the other browser to simulate the anonymous non logged in user where the most aggressive caching rules apply Tip 2 When you are logged in as administrative user a smaller percentage of your HTTP requests will be cached As a result response time for a Plone page might seem slower than they actually would appear to an anonymous user Interpreting HTTP Headers Ultimately the most accurate way to troubleshoot caching is to look at HTTP Headers This can be a daunting task Just one web page may involve 10 15 separate HTTP requests However if you have experience and know what to look for you can spot problems quickly without becoming bogged down For example a simple URL such as http www originalfunsite com events will consist of these requests GET events GET portal javascripts Enfold 20Theme ploneScripts6490 js GET portal css Enfold 20Theme ploneStyles6499 css GET portal css Enfold 20Theme ploneStyles1162 css GET portal css Enfold 20Theme ploneStyles6975 css GET favicon ico GET info icon gif GET user gif GET rss gif GET mail icon gif GET print icon gif GET topheader png GET input background gif GET portal css Enfold 20Theme ploneStyles2247 css GET search icon gif GET logo gif GET site icon gif GET folder icon gif GET topic icon gif GET topic icon gif GET linkTransparent gif GET arrowUp gif GET favicon ico GET arrowLeft gif GET arrowRight gif GET plone powered gif GET enfold powered png GET colophon sec508 gif GET colophon wai aa gif GET colophon xhtml png GET colophon anybrowser png GET colophon css png Out of these requests only the first GET events could conceivably be a Plone request The rest of the http GETs images

    Original URL path: http://www.enfoldsystems.com/software/proxy/docs/4.0/cachetutorial.html (2016-02-11)
    Open archived version from archive

  • Caching with EP
    at the time of this writing January 2009 a browser bug in Internet Explorer prevents sysadmin users from viewing editing properties on the CachuFu Rules tab This bug does not affect users of Firefox CMFSquidTool is an open source caching product supported by Enfold which lets you purge cache As long as you set your IP address in Caching Purge Sources see Purging Cache However you may find it easier to use Enfold Proxy to purge cached items for proxy definition s Enable Cache in your Proxy Definition By default when you create a proxy definition in EP caching is enabled However you might need to change your settings to suit your hardware See a description of each cache setting Enfold Proxy will keep a lot of stale cached files inside the cache directory corresponding to a specific proxy definition These stale cache files will accumulate in the cache directory until it approaches the maximum cache size That is actually a good thing In Chasseur for example a lot of content is cached for one hour After one hour or even after five years whenever the browser requests the same resource EP will check with Plone and ask is this stale item still valid Plone will give one of two responses Either Plone will reply it s still good In this case EP will return the stale item to the browser and update its own records to indicate that this stale cache is now valid This process is called revalidating the cache The HTTP headers to the user will say X Cache HIT from www originalfunsite com Plone will reply Nope That s an outdated version In this case Enfold Server or Plone will send the updated version to Enfold Proxy which will pass it on to the browser and also replace the outdated version with the newer version X Cache MISS from www originalfunsite com Enfold Proxy now has an easy button in its interface purge cached items for proxy definition s Next Step Verify that Your Cache Settings are in Effect To verify that caching is taking place look for this line in your HTTP response header X Cache HIT from www originalfunsite com If you see X Cache HIT then yes caching is occurring If you see X Cache MISS then this particular item was NOT cached Generally HIT s indicate successful caching Keep in mind that X Cache MISS is not always a bad thing For example if logged in as an administrator many resources will not be cached on purpose It s best to test as an anonymous web surfer i e someone who is not logged in If an item contains a modification then a MISS reply is mandatory Also object based caching like XSLT caching doesn t modify these headers so EP can be properly caching XSLT pages and still be sending out X Cache MISS headers Careful When testing it s a good idea to use two different browsers In Browser A

    Original URL path: http://www.enfoldsystems.com/software/proxy/docs/4.0/epcaching.html (2016-02-11)
    Open archived version from archive

  • Purging Cache
    cache To do this select the Purge option on the left panel of EP s configuration utility By checking or unchecking each proxy definition you can delete the cache for one or multiple proxy definitions Purge a specific URL with Portal Cache Portal cache is a product that comes installed by default on Enfold Server It also comes with the CacheFu suite of products This product visible in the ZMI but not Plone lets you input a specific URL you wish to be cached Keep in mind that this URL will only cache a specific item So if you try to purge www originalfunsite com news it will not purge cache of jpegs or css files used on this web page Instead this request will purge only the contents of that page minus the css jpg gif js files To do this Confirm that the IP address of the requesting machine is explicitly listed in Enfold Proxy Settings Cache Purging Source If your IP address is not listed enter it now Go to the ZMI for your site and open the portal squid tool Located at Plone portal squid Plone Site Setup Zope Management Interface portal squid in right panel near the bottom Follow the instructions for adding a Cache URL Press Save Example http www originalfunsite com In the field for Purge URL Enter the name of the web item relative to the Plone root Example logo jpg Logo jpg is a company logo jpeg that is found on the Plone home page Press Go Here are some responses you could conceivably receive after you press the Go button 404 http www originalfunsite com logo jpg Not cached 200 http originalfunsite com logo jpg Purged 401 http originalfunsite com logo jpg Unauthorized this happens if you are trying to purge when IIS is using NTLM See note above Using cURL for purging cURL http curl haxx se docs manual html is a command line tool for making HTTP requests With cURL you can make the purge request for a specific URL rather than making a global command Just use the command curl X PURGE http host port path to url to be purged This tool is useful for testing and troubleshooting However if you are using a different machine make sure that its IP address you are using to run cURL is listed as a safe address in the Caching Purge Sources field under Settings in EP s configuration utility The PURGEALL command allows you to remove all items in the cache or all items that start with the specified string or if you specify the root of the EP site all items in the cache For example curl X PURGEALL http localhost would remove all cached items assuming vh root is set to point to the root of the IIS site Also note that specifying the v option to cURL will show more information about the response to the purge request Using a Plone product to purge cache

    Original URL path: http://www.enfoldsystems.com/software/proxy/docs/4.0/purging.html (2016-02-11)
    Open archived version from archive

  • Caching XSLT
    was received from a remote server it is an object in memory which represents the result of some XSLT processing It cannot be purged is unable to have items validated or have any setting overridden per style sheet The contents are lost when EP is stopped All options prefixed with object cache are referring to this cache Important Note XSLT caching is not currently supported on Windows Vista 64 bit Activate and Test XSLT Caching Because XSLT caching is an in memory cache instead of disk based cache the method for verifying that it works is less direct Unlike other cache hits XSLT caching will not give a X Cache HIT message in the host headers nor will it appear in the cache logs You will however be able to see a brief message confirming an xslt cache hit in the proxy log file It looks like this 2008 05 09 15 05 05 062 enfold lxml INFO 2076 3452 XSLT object cache hit for http localhost cdcatalog xsl 2008 05 09 15 05 05 108 enfold lxml INFO 2076 2460 XSLT object cache hit for http localhost cdcatalog xsl For this example you will add an XSL file into Zope so it is stored as an object and a python script which essentially outputs an XML file This example will put cdcatalog xml and cdcatalog xsl into the application root level of the ZMI Use the ZMI to add a python script which you will name cdcatalog xml Follow the same steps that you did for adding a Plone site From the Add dropdown menu in the ZMI select Script Python http localhost 8080 manage For ID type cdcatalog xml Press Save and Edit Copy this XML python script named cdcatalog xml into the edit box and press Save This python script causes a simple XML file to be outputted by Zope Note This is not actually an xml file but a python script to output XML Copy and paste the cdcatalog xsl file You can download the same file here http www w3schools com xsl cdcatalog xsl You might need to change the file extension so that it ends in xsl Use the ZMI to add this xsl file in the same directory as your python script Select File from the Add dropdown menu Give it id cdcatalog xsl and select Browse to find the file on your PC Be sure both objects are in the same directory and accessible The easiest way is to try to access http localhost cdcatalog xml and http localhost cdcatalog xsl Configure your Enfold Proxy settings by manually editing the eep ini file in your C Program Files Enfold Proxy directory Be sure to read the tips for manually editing the eep ini file Important You can enable XSLT caching only by manually editing the eep ini file Here is an example of how your eep ini settings will appear when caching XSLT xslt cache default age 6000 cache enabled True object

    Original URL path: http://www.enfoldsystems.com/software/proxy/docs/4.0/xslt.html (2016-02-11)
    Open archived version from archive

  • FAQ
    eep check utility from the Configuration Utility and receive no obvious error that is also a positive sign In general though EP is working whenever the IIS application is turned on If you think you have misconfigured EP you can make a backup copy of the eep ini file in the Enfold Proxy and start from scratch See also the Troubleshooting Checklist How much downtime is required in upgrading Enfold Proxy Generally upgrading Enfold Proxy takes very little time and entails little risk especially if you save a backup copy of eep ini file But it will involve a manual restart of IIS Read upgrading Enfold Proxy How do I disable Enfold Proxy or a proxy definition As stated above Enfold Proxy exists within IIS so it is not possible to start or stop it separately unless you decide to turn IIS off as well If you are stuck or wish to view your Plone IIS site without Enfold Proxy or your proxy definitions the easiest thing to do is to backup the configuration file eep ini to a safe place and delete the normal file That will wipe out the proxy definitions until you copy the eep ini file back Your changes will take effect after you run eep exe This is especially useful for eliminating the possibility of IIS misconfiguration problems If you just want to disable one proxy definition comment out the appropriate portion of the eep ini configuration file and restart your IIS Remember Whenever you modify the eep ini file you must run eep exe afterwards If you do not your edits may not take effect or won t be visible in the Enfold Proxy configuration utility What is a proxy definition How is that different from hosts Previous EP versions used the word host instead of proxy definition That caused confusion For this version proxy definition refers to any EP settings for one IIS site which has a unique host header See adding a proxy definition What name should I give to my proxy definition The name you choose for your proxy definition is arbitrary and only appears in the EP configuration tool If I modify a proxy definition in EP when do the changes take place Do they happen automatically It should take effect immediately But you may need to confirm that these changes are reflected in IIS In most cases whenever you save something in EP the affected IIS site will be reconfigured to have these changes Occasionally you may need to restart IIS for these changes to show up How do I back up my configuration settings The easiest way is to copy the eep ini file to a safe place Typically it is located in C Program Files Enfold Proxy directory If this file is not visible be sure you have configured Windows to allow you to see ini files Control Panel Folder Options View and be sure Show Hidden Files is checked For easy restore of your settings you can replace the entire file with your backed up copy or copy the relevant contents into the new file Is it better to use the Proxy Configuration Tool or to edit the config file manually See Configuring EP Manually Generally it is better to use Proxy Configuration tool It reduces the possibility of misconfiguration Whatever happened to the virtual plone folder which appeared in IIS after a proxy definition was created A virtual folder named plone used to appear in the IIS Management console after a proxy definition was created This no longer is the case How do proxy logs get rotated Go to EP Configuration utility and choose settings You can set backup count and the maximum file size for each log file See logging options Does EP affect the gathering of web statistics Because EP is simply a filter for IIS the IIS log files should not be affected For this reason any web statistical tool which analyzes IIS log files should provide accurate data Can I use multiple proxy definitions for the same IIS site What restrictions apply Typically an IIS site is associated with a single proxy definition in EP But EP doesn t restrict you from having multiple proxy definitions IIS itself has restrictions regarding how multiple sites can be configured see the IIS docs for details How do I force all Zope Plone logins to be Secure Sockets Layer SSL To force all web accesses for a web domain to be by SSL you need to configure IIS to require SSL login Open IIS right click Default Web Site select Directory Security Secure Communications edit Choose the option Require Secure Channel This assumes that you have already created a new SSL Certificate for the server or imported an existing one read your IIS documentation for how to do that Is EP like Virtual Hosting Monster VHM in Zope EP uses VHM to ensure Zope generates correct references in URLs But EP includes another mode Simple rewrite mode to proxy non Zope requests as well See Simple Rewrite Mode How do I verify that Load balancing is working Load balancing the server load with more than one Zope clients which are configured in Enfold Server or Plone The easiest way to verify that load balancing works is to try access webpages using its management port instead of port 80 such as http localhost 8080 or http www originalfunsite com 9090 In this case you will probably not see the Plone site but the front page to the Zope management Interface To see the actual Plone site you d have to type the path with the Plone site folder such as http localhost 8080 Plone How do I verify that my Include Exclude Rewrite rule has processed successfully Typing a specific URL in the browser would be the easiest way to see if the rule worked You can also run the command line tool eepcheck If you execute it with a show excludes argument this will

    Original URL path: http://www.enfoldsystems.com/software/proxy/docs/4.0/faq.html (2016-02-11)
    Open archived version from archive

  • EP Interface Guide
    set directly in that host section inside the eep ini file In eep ini each host section corresponds with a proxy definition All cache related configuration options are prefixed with cache User interface Configuration file Default Description Cache enabled cache enabled True Indicates if caching should be enabled Cache directory cache directory Leaving it blank will put cache directory inside Program Files Enfold Proxy cache directory If you change you must use an absolute paths i e C My Documents cache See the cache directory for more information Default age for items cache default age 0 For content without explicit expiry information how long in seconds should the page be considered fresh If this is not zero EP will cache everything for at least that duration even data that is updated frequently Maximum size of cache cache max size 100000000 The maximum size of the cache in bytes This size may temporarily be exceeded depending on the transient load factor option Maximum item size cache max item size 200000 The maximum size of an item that will be cached Items larger than this will not be stored Note that when items bound for the cache are read from the remote host they will be buffered in memory so this value will affect memory usage Transient load factor cache transient load factor 1 2 The factor by which the cache may temporarily exceed max size until the cache scavenger reduces it back This is to avoid a client connection taking the penalty of cache expiry if the cache is full Scavange delay cache scavenge delay 60 How often the cache scavenger runs The cache scavenger will reduce the cache back down to max size and flush the cache index to disk Object Cache Options These options modify the in memory cache used by the XSLT processing as described in XSLT caching You cannot enable these options with the EP Configuration Tool instead you need to add the options by manually configuring the eep ini file Configuration file Default Description object cache enabled False Is the object cache enabled object cache max len 50 Number of items in the cache object cache default age 600 10 mins Length of time these items are cached object cache log level WARNING The level of logging messages generated by this cache The log messages are currently sent to the main proxy log ZEO and Load Balancing options See also Configuring Load Balancing Enfold Proxy has the ability to balance requests between any number of hosts It is assumed that all these hosts are identical Plone installations using a common ZEO Server To configure load balancing options for your proxy definition open the EP Configuration Utility select your proxy definition then choose the Balancing tab at the top For these options to be effective the Basic Virtual Hosts must have multiple lines referring to multiple Zope clients otherwise any options set here will be ignored User interface Configuration file Default Description Scheduler scheduler leastconns Describes the

    Original URL path: http://www.enfoldsystems.com/software/proxy/docs/4.0/dialogoptions.html (2016-02-11)
    Open archived version from archive

  • Configuring EP Manually
    information will not apply Tips for Editing the eep ini file Vista Users Vista s security model is intended to prevent the user from accidentally writing editing system or configuration files The Encontrol configuration utility will automatically prompt for the necessary elevation of privileges but if you wish to edit this file by hand you will need to do so from a process that is already elevated ie started with Run as Administrator see the Vista documention about how to do that In order to use the configuration file directly go to Start Enfold Proxy Configuration File This file can be edited with any text editor and is laid out like any other Windows INI file Throughout this documentation this image is used to highlight instructions for editing the configuration file Don t forget If you edit eep ini manually you must run eep exe afterwards If you do not your edits may not take effect Most settings are insensitive to case but lines should begin in the left column i e have no leading whitespace unless they are part of a line continuation see section below Except where noted all settings can be changed without restarting IIS however the new options will not be processed until a connection is made to Enfold Proxy If you make a configuration change you should visit the proxy in your browser to ensure the changes have taken effect as expected If your site configuration is quite complex such that your INI file becomes difficult to manage be sure to read the documentation on using variables in configuration files Continuing Long Lines If you maintain the configuration file in a text editor rather than via the UI utility it is possible to split configuration values over multiple lines Simply continue the value on the next line but ensure that line begins with at least one space or tab For example host 1 includes file1 file2 file3 file4 file5 Note that the UI utility may merge the multiple lines back into one when saving Using Variables in Configuration Files Enfold s INI files have a feature that make setting up large configuration files quite simple you can define variables in the INI file and can then refer to these variables in the configuration values In the simplest example let assume you had a large number of excludes to specify One way of doing this is as follows host something jpg files foo jpg bar jpg css files logo css myapp css excludes jpg files s css files s In this example we have defined 2 variables jpg files and css files As these variable names to not match any configuration options used by EP they have no effect on EP itself excludes is an EP option and its value is defined as being the concatenation of 2 variables This is equivalent to as if the configuration file had read host something excludes foo jpg bar jpg logo css myapp css Note the format of the

    Original URL path: http://www.enfoldsystems.com/software/proxy/docs/4.0/configuringmanually.html (2016-02-11)
    Open archived version from archive



  •