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".
  • XDV Tutorial
    But what you have just set up is a very powerful way to theme Plone sites that makes it possible to use any pre existing design with a Plone back end The reason that this is exciting is that you re using your own HTML and CSS not modifying Plone s HTML and CSS How it Works A high level overview of what is going on in XDV The way XDV works is simple but since it might take a little adjustment of the mental model that you re used to if you have done theming in Plone or any other system it s worth an explanation The main difference is that you re not touching the templates and HTML from Plone itself at all Instead you create the layout and design you want in standalone HTML and CSS files and map parts of the content that comes out of Plone into your existing HTML This means that you can create as complex or simple designs as you want and let Plone supply the content This also means that you can write your own from scratch HTML and CSS but also map various Plone elements to wherever you want in your own design Plone knows nothing about what happens on the way out it just renders a page as it usually does A more visual way to look at it here you can see how the Plone output is mapped into a totally different template and design This makes for a much more robust approach to theming because as long as Plone keeps its HTML classes and IDs the same from one version to the next your theme will automatically work even in a new version of Plone And if it has changed it s a relatively simple operation to update the theme just locate the new name and replace it in the rule file The Rule File Central to the way that content makes its way from your Plone site into your theme is the rule file Let s look at your simple rule file again rules xmlns http namespaces plone org xdv Copy over the contents of the page body replace content id content theme id my content area rules Ignoring the preamble rules and the comment there s one single instruction here replace content id content theme id my content area So what does it do It looks at the Plone side of things content and locates the part of the HTML that has id content It then replaces the part of your theme s HTML that has id my content area with the content it got from Plone The syntax inside the content and theme attributes can be a bit intimidating luckily we have great tools to make it very easy to get this right The syntax is called XPath and is a standard for addressing nodes in the DOM and it s also directly supported in Firebug A full treatment of how Firebug works is

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

  • Load Balancing
    machines which are running Zope Plone regardless of whether they are running Linux Windows OS X etc Note Before you can load balance you should verify that your Zope clients can be load balanced Adding or Subtracting Load Balancing Clients After you create a proxy definition for your host you can add load balancing clients with one step add another entry in the Virtual host field This Virtual host field is located on the Basic tab of your proxy definition The balancing tab of your proxy definition contains additional options related to load balancing Here are examples of Virtual Hosts to include in your proxy definition on the Basic tab All formats listed here are acceptable localhost 8080 localhost 8090 192 168 1 150 8080 192 168 1 151 8080 www enfoldsystems com 8080 Notes In most cases these URLs will be a Zope client Omit the http prefix Always include the port number You can use IP addresses and or host names Load balancing will not work unless you have 2 or more Virtual hosts listed here After you push save load balancing should work immediately To remove a client from load balancing delete the appropriate line in the Virtual Host field Even though load balancing provides a kind of insurance policy against failures you still need a monitoring tool like Big Brother to make sure individual machines are online A load balanced cluster might have four virtual hosts Zope clients and still work if three of them go offline But if you are never notified about this occurrence you would be at risk if the fourth goes offline also Configure Load Balancing Options The Balancing tab of your proxy definition contains several options to configure for load balancing Verify that your Zope Clients can be load balanced Enfold Proxy has the ability to balance requests from multiple Zope clients These Zope clients can exist on the same machine or be spread out among several machines However load balancing assumes that each Zope client is using the same Zope object database ZODB and the same Zope mount point That means that the zope conf file for each Zope client must be configured to reference the same ZEO server and file storage location regardless of whether the Zope clients are located on one machine or several machines Before you add a Zope client to load balancing you must verify two things First verify that the Zope client can be accessed directly by typing the IP address management port If you can type http localhost 8080 in your browser or the equivalent that is sufficient You should also verify that all Zope clients have identical ZEO servers mount point s and ZODB file By default all Zope clients installed by Enfold server use one mount point and the same file storage location Here s some basic steps for doing this verification Compare Zope conf files and make sure that the mount directive is identical to the other Zope client s If

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

  • Security Concerns
    VPN software to log in remotely to their office machine and access the ZMI from there by typing a private host or I P address along with the management port number http mymachine 8080 Setting up ZMI Access on a Separate Host It is theoretically possible to configure a separate proxy definition and separate IIS site to allow public access to the Zope Management Interface ZMI login screen on port 80 But it is not recommended The best way to login to Plone is to login directly to port 8080 i e http 192 168 1 150 8080 instead of proxying it to port 80 Setting up HTTPS Login for Login Only Setting up HTTPS for your entire site is not practical because it slows IIS performance However you could set up HTTPS to manage initial user login That requires three things First you need to set HTTPS and SSL certificates for your specific IIS site This task lies outside the scope of this document but here is an excellent tutorial for how to configure SSL for IIS http www petri co il configure ssl on your website with iis htm Second you need to verify that the IIS site handles both port 80 and port 443 See the same tutorial Third you need to set up a mechanism in Plone to switch to SSL when logging in and back to non SSL after receiving an authenticated cookie To do this see the Plone how to guide about secure logins http plone org documentation how to secure login without plain text passwords Using NTLM LDAP for User Login One benefit of using Enfold Server and Enfold Proxy on a Windows platform is having the ability to authenticate automatically with Windows domains with the NTLM authentication protocol Once again Enfold Proxy

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

  • Monitoring EP
    the EP configuration tool select Check option on the left panel and choose the Check button Using eep check command line utility eep check exe is the command line version of the Check utility It is located in the Enfold Proxy installation directory Note that this is a console program so you should execute this program from a command prompt rather than by double clicking in explorer The command line version of this utility eep check utility is identical to the utility in the GUI If you run this command via command line you can append a show excludes argument to the command If you do that the print will print not only the normal output but also a list of all items found by this auto exclude processing See Using Excludes The eep check utility can be executed with a show config argument which will print the current configuration values being used by EP The values printed are after any default values and variable substitutions have been applied it shows exactly how configuration file appears to EP For example assuming your configuration file is the complex example above eep check would print eep check show config Effective eep ini configuration options virtualdir plone lines omitted host 1 vh hosts localhost 8080 vh root PloneSite1 lh root PloneSite1 lh server 192 168 0 1 lh port includes lines omitted Worthy of note All configuration sections and values are printed even when they do not appear in the INI file as seen by the options section Although the DEFAULT section is not shown the entries specified in it are reflected in our proxy definition Using and Customizing Your Logs See Using logs to analyze common problems Tip Use a free log monitoring tool like Bare Tail http baremetalsoft com baretail to

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

  • 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 For an explanation about what the various cache control and HTTP headers mean check the Cache Headers Reference 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

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

  • How Caching Works
    you see below but generally the syntax should be similar Also the directional arrows in the header logs 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 Live HTTP Headers is probably better at capturing data in real time But Firebug shows graphically which resources on a web page are taking the longest time to load It is commonly assumed that dynamically generated server content accounts takes longer to load than images or scripts In fact Firebug reveals how often images and scripts are the culprits not the html content 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

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

  • Caching with EP
    Important you need to enable a caching policy for CacheFu to work in EP On the first tab you need to choose Enable CacheFu Under Active Cache Policy choose Default Cache Policy or choose another policy You can create one from scratch or clone an existing one by going to the Policy tab On the first tab you will also need to choose a Proxy Cache Purge Configuration choose No Purge zope only or zope behind apache CacheFu will use cache headers different from Chasseur But EP is able to process both of them in fact after you enable CacheFu Chasseur will deactivate all cache profile previously enabled You can specify caching behavior in Plone by deciding which header to use when returning a particular Plone content type To do that go to the Rule tab and select the content type you want Each rule will let you specify a header for anonymous users and a rule for authenticated users Presumably you d want a reduced amount of caching for authenticated users The label for each header Do not Cache Cache in proxy cache for 1 hour Cache in browser for 1 hour etc should be self explanatory Keep in mind that you can also edit properties for each header on the Headers tab 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 As a result the hyperlinks on the CacheFu configuration page won t work properly you may need to open these hyperlinks in a new browser tab or browser window 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 List of HTTP Headers supported by Enfold Proxy See the HTTP Header Reference Guide 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 to purge cached items for proxy definition s Next Step Verify that Your Cache Settings are in Effect The easiest way to verify your cache settings is to view the Enfold Proxy logs themselves That allows you to see the responses from Plone and also prevents browser issues from misleading you When viewing the Enfold Proxy logs be sure to activate the new Headers log level which is easier to read than typical HTTP headers To verify that caching is taking place from the browser look for this line in your HTTP response header X Cache HIT from www originalfunsite com If you see X Cache HIT then yes Enfold Proxy has sent you a cached version of this content item If you see X Cache MISS then no Enfold Proxy has sent you this content which was not in its cache 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 such as Internet Explorer log in as Admin In Browser B i e Firefox log in as anonymous or as a logged in user It s also important to clear cache the right way and even to close the browser entirely if you don t the http headers you see won t be accurate Consult the troubleshooting checklist for caching To see the HTTP headers directly see Tools for Viewing Headers You should probably pick two or three sample items to check for headers Anything will do but at least one should be a graphic and one should be a Zope page such as http www originalfunsite com events In Chasseur the maximum age is Cache Control max age 3600 X Cache HIT from www originalfunsite com Optimize Cache Settings and Measure Caching Performance See also Caching Goals and Strategies Many of your cache settings can be tweaked in whatever Plone product you are using to cache web items The CacheFu Plone product for example

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

  • Purging Cache
    from within a Plone caching product like CacheFu or CMFSquidTool include a Python script to purge cache content when an item is republished This topic will discuss the advantages and disadvantages of each method Purge Cache within Enfold Proxy Recommended Enfold Proxy includes a way to purge 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

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