Re: [Engine-devel] UI Plugins: PoC patch revision 5 is here
--_000_D290AD8432118048947689BA3AE8A9B3E47B82SACEXCMBX04PRDhqn_ Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Hi Vojtech, The patch is great and has cleared up some questions I had about the implem= entation. I've been able to get the sample plugins working and waded throug= h the code changes, so feel like I have a good understanding of what was de= livered. Thanks a lot for putting this all together. I do have a few questi= ons and suggestions for you, though. Will there eventually be a way to add one or more buttons to the context se= nsitive buttons and menus throughout the interface? For example, we'd like = to allow a button to provision a datastore when a data center, cluster, or = host is selected. When the button is clicked, it would open a dialog with a= n iframe in which we would load our interface to perform the associated act= ion. Some contexts would have several buttons, such as a storage domain (pr= ovision, resize, dedupe management, destroy) so it would probably make sens= e for a drop down menu to be available as well so that the number of button= s above the table doesn't get too cluttered. We'd also like to add these sa= me actions to the menus that popup when a contextual object is right clicke= d. If needed we can help work on an implementation for the dialog popup plugin= framework as we'd like to get it in relatively quickly so we can move forw= ard on the content side of our plugin. For the reverse proxy, would it be easier from a customer standpoint to jus= t include a reverse proxy servlet such as this one? http://sourceforge.net= /projects/j2ep/ I'm just thinking that setting up and managing a plugin for the HTTP server= may be more complex than including one internally that would be transparen= t to a customer. Thanks, Chris From: Vojtech Szocs <vszocs@redhat.com<mailto:vszocs@redhat.com>> Date: September 21, 2012 4:37:31 PM EDT To: engine-devel <engine-devel@ovirt.org<mailto:engine-devel@ovirt.org>> Subject: [Engine-devel] UI Plugins: PoC patch revision 5 is here Hi guys, it's been a while but here comes the latest revision of UI Plugins proof-of= -concept patch (please find it attached). This revision was originally meant to focus solely on server-side component= s of the plugin infrastructure. However, I ended up implementing all the ma= jor concepts and ideas as discussed on engine-devel mailing list, impacting= both client-side and server-side parts of the plugin infrastructure. As a = result, UI plugin infrastructure should be pretty much complete now, so we = can focus on specific plugin API features in upcoming PoC revisions. There's a whole bunch of changes and improvements in this revision, so I'll= try to cover all the relevant parts step by step. If you have any comments= , questions or ideas, please let me know! So here we go... (or if you just want to get the patch, find the link at th= e end of this message) ________________________________ 0. Added new Engine configuration values UI plugin data path is represented by ConfigValues.UIPluginDataPath enum op= tion ("UIPluginDataPath" in vdc_options table), and resolved relative to Co= nfigValues.DataDir if possible. Following (default) values: * UIPluginDataPath =3D ui-plugins * DataDir =3D /usr/share/ovirt-engine result in UI plugin data path: /usr/share/ovirt-engine/ui-plugins UI plugin config path is represented by ConfigValues.UIPluginConfigPath enu= m option ("UIPluginConfigPath" in vdc_options table), and resolved relative= to ConfigValues.ConfigDir if possible. Following (default) values: * UIPluginConfigPath =3D ui-plugins * ConfigDir =3D /etc/ovirt-engine result in UI plugin config path: /etc/ovirt-engine/ui-plugins 1. Processing UI plugin data on the server PluginDataManager is the class responsible for reading, validating and cach= ing UI plugin descriptor/configuration data on the server (Engine). It has = two main responsibilities: * return a snapshot of currently valid plugin data (getCurrentData meth= od) * reload plugin data from local file system if necessary (reloadData me= thod) The reloadData method doesn't modify "live" plugin data directly. Instead, = it creates a local working copy of current plugin data, updates this copy a= s it reads/validates plugin descriptor and configuration files, and attempt= s to update "live" plugin data through conditional reference re-assignment = (using java.util.concurrent.atomic.AtomicReference.compareAndSet method). In other words, reloadData method makes no attempts with regard to Java loc= k-based synchronization, in favor of dealing with "live" data through Atomi= cReference (reference that involves atomic volatile reads and writes): * In the best case, a thread will succeed in updating "live" data (Atom= icReference.compareAndSet =3D=3D true), which means that "live" data remain= ed unchanged since this thread acquired a reference of current plugin data. * In the worst case, a thread will NOT succeed in updating "live" data = (AtomicReference.compareAndSet =3D=3D false), which means that "live" data = was already changed by another thread since this thread acquired a referenc= e of current plugin data. In my opinion, when dealing with external resources like the local file sys= tem, this is a good compromise between performance and up-to-date data. Whi= le we might not get "completely-up-to-date" data at the given point in time= (reloadData + getCurrentData), we are guaranteed to get "recently-up-to-da= te" and consistent data. In other words, the requirement of "completely-up-= to-date" data would involve synchronized statements that would hurt perform= ance. In my (very humble) opinion, the benefit of having "completely-up-to-= date" data, at the cost of reduced performance, is not really worth it, esp= ecially in our case when the user can just hit refresh (F5) to reload WebAd= min and its plugin data. Plugin descriptor files are expected to be placed in UI plugin data path, f= or example: /usr/share/ovirt-engine/ui-plugins/foo.json Following descriptor file attributes are implemented and recognized by the = plugin infrastructure: * name: A name that uniquely identifies the plugin (required attribute)= . * url: URL of plugin host page that invokes the plugin code (required a= ttribute). * config: Default configuration object associated with the plugin (opti= onal attribute). * resourcePath: Path to plugin static resources, relative to UI plugin = data path (optional attribute). This is used when serving plugin files thro= ugh Engine PluginResourceServlet (more on this below). Plugin configuration files are expected to be placed in UI plugin config pa= th, for example: /etc/engine/ui-plugins/foo-config.json Note that plugin configuration files follow the "<descriptorFileName>-confi= g.json" convention. Following configuration file attributes are implemented and recognized by t= he plugin infrastructure: * config: Custom configuration object associated with the plugin (optio= nal attribute). This overrides the default plugin descriptor configuration,= if any. * enabled: Indicates whether the plugin should be loaded on WebAdmin st= artup (optional attribute). Default value is 'true'. * order: Defines the relative order in which the plugin will be loaded = on WebAdmin startup (optional attribute). Default value is Integer.MAX_VALU= E (lowest order). The concept of merging custom configuration (config attribute in foo-config= .json), if any, on top of default configuration (config attribute in foo.js= on), if any, remains unchanged. This makes the plugin configuration quite f= lexible - in my opinion, the added complexity of handling/merging such conf= iguration is definitely worth the effort. The enabled attribute is straight-forward, allowing users to turn the given= plugin off, if necessary. In future, users should still be able to load su= ch plugins through WebAdmin GUI. The order attribute controls the order in which plugins are loaded on WebAd= min startup. Since plugin resources are fetched asynchronously by the brows= er, this is basically a way of imposing some degree of determinism in the "= generally-non-deterministic" plugin environment, which is helpful when trou= bleshooting problems with multiple plugins. This attribute is also helpful = due to file listing methods in java.io.File giving no guarantees that files= would be listed in any particular order (otherwise we could just go for th= e "NN-<descriptorFileName>.json" convention, with NN being the order number= ). 2. Modified behavior of WebadminDynamicHostingServlet WebadminDynamicHostingServlet is the servlet used to serve WebAdmin applica= tion host page (HTML page that bootstraps WebAdmin JavaScript code). In addition to its former behavior, as part of handling the given request, = WebadminDynamicHostingServlet: * reloads descriptor/configuration data from local file system if neces= sary, and obtains a snapshot of currently valid plugin data (PluginDataMana= ger.reloadAndGetCurrentData) * embeds all plugin meta-data, suitable for use in client-side plugin i= nfrastructure, into WebAdmin host page as "pluginDefinitions" JavaScript ar= ray (PluginDefinitions) As a result, reloading UI plugin descriptor/configuration data is as simple= as refreshing (F5) WebAdmin application in the browser (no need to restart= Engine). 3. Added servlet for serving plugin static resources PluginResourceServlet is the servlet used to serve UI plugin static files (= plugin host page, 3rd party JavaScript, etc.) from the local file system. For example, requesting URL: * http://<EngineManagerHost>:8700/webadmin/webadmin/plugin/foo/content/= start.html<http://%3cEngineManagerHost%3e:8700/webadmin/webadmin/plugin/foo= /content/start.html> will send the content of: * /usr/share/ovirt-engine/ui-plugins/<resourcePath>/content/start.html to the client. As shown in the above example: * /webadmin/webadmin/plugin/ is the servlet root path for PluginResourc= eServlet * in the extra path beyond the servlet root path (/foo/content/start.ht= ml): * /foo represents the name of the plugin * /content/start.html represents the path to requested resource, rel= ative to "UIPluginDataPath / <resourcePath>" Note that each plugin using PluginResourceServlet to serve its static files= must declare non-empty resourcePath attribute in within the plugin descrip= tor. Also note that PluginResourceServlet, unlike WebadminDynamicHostingServlet,= does NOT reload descriptor/configuration data from local file system as pa= rt of handling the given request. In other words, it's assumed that plugin = data has already been (re)loaded when serving WebAdmin application host pag= e, with subsequent requests to PluginResourceServlet reading the current pl= ugin information. Until we solve the cross-origin issue in a clean way, PluginResourceServlet= should be used to serve all plugin resources from local file system. 4. Plugin lifecycle improved to deal with misbehaving plugins PluginState enum has been modified to deal with plugins that allow uncaught= exceptions to escape from plugin event handler functions (e.g. "UiInit"): * removed state INITIALIZED * added state INITIALIZING: The plugin is (currently) being initialized= by calling UiInit event handler function. * added state IN_USE: Plugin's UiInit event handler function has comple= ted successfully, we can now call other event handler functions as necessar= y. The plugin is in use now. * added state FAILED: An uncaught exception escaped while calling an ev= ent handler function, which indicates internal error within the plugin code= . The plugin is removed from service. I've attached a simple state diagram that illustrates different states and = transitions between them (green color is initial state, red color is end st= ate). Uncaught exceptions in plugin event handler functions will be caught and ha= ndled by the plugin infrastructure. This prevents a misbehaving plugin from= breaking WebAdmin application, since WebAdmin is the caller (initiator) of= the function call. In such case, the plugin will be removed from service. Update on cross-origin issue (consequence of same-origin policy) In order for the plugin to access WebAdmin plugin API, plugin host page (e.= g. start.html) must be served from URL on same origin as Engine origin. Oth= erwise, plugin code running in the context of an iframe'd host page will fa= il to evaluate "parent.pluginApi" expression, with "parent" being top-level= (WebAdmin) window, and "pluginApi" being the global plugin API object expo= sed by WebAdmin. This is why PluginResourceServlet, available on Engine origin, should be us= ed to serve all plugin resources from local file system. There's only one issue that remains to be solved: cross-origin "plugin vs. = remote service" communication, with "remote service" being anything other t= han Engine (REST API). In future, we'll address this with Apache reverse pr= oxy configuration, so that users can configure Apache server (placed in fro= nt of Engine JBoss AS) to put arbitrary (local or remote non-Engine) servic= es on same origin. However, this requires a change in current Apache config= uration. Until then, users can manually edit the Engine Apache configuratio= n file (/etc/httpd/conf.d/ovirt-engine.conf). ________________________________ I've attached some sample plugin files for you to experiment with. Instead = of attaching actual patch file (92 kB) to this email, I've submitted the pa= tch to oVirt Gerrit: http://gerrit.ovirt.org/8120 Let me know what you think! Cheers, Vojtech <ui-plugin-sample-files.tar.gz> <ui-plugin-lifecycle.png> _______________________________________________ Engine-devel mailing list Engine-devel@ovirt.org<mailto:Engine-devel@ovirt.org> http://lists.ovirt.org/mailman/listinfo/engine-devel --_000_D290AD8432118048947689BA3AE8A9B3E47B82SACEXCMBX04PRDhqn_ Content-Type: text/html; charset="us-ascii" Content-Transfer-Encoding: quoted-printable <html xmlns:v=3D"urn:schemas-microsoft-com:vml" xmlns:o=3D"urn:schemas-micr= osoft-com:office:office" xmlns:w=3D"urn:schemas-microsoft-com:office:word" = xmlns:m=3D"http://schemas.microsoft.com/office/2004/12/omml" xmlns=3D"http:= //www.w3.org/TR/REC-html40"> <head> <meta http-equiv=3D"Content-Type" content=3D"text/html; charset=3Dus-ascii"=
<meta name=3D"Generator" content=3D"Microsoft Word 14 (filtered medium)"> <!--[if !mso]><style>v\:* {behavior:url(#default#VML);} o\:* {behavior:url(#default#VML);} w\:* {behavior:url(#default#VML);} .shape {behavior:url(#default#VML);} </style><![endif]--><style><!-- /* Font Definitions */ @font-face {font-family:Wingdings; panose-1:5 0 0 0 0 0 0 0 0 0;} @font-face {font-family:Wingdings; panose-1:5 0 0 0 0 0 0 0 0 0;} @font-face {font-family:Calibri; panose-1:2 15 5 2 2 2 4 3 2 4;} @font-face {font-family:Tahoma; panose-1:2 11 6 4 3 5 4 4 2 4;} /* Style Definitions */ p.MsoNormal, li.MsoNormal, div.MsoNormal {margin:0in; margin-bottom:.0001pt; font-size:12.0pt; font-family:"Times New Roman","serif";} a:link, span.MsoHyperlink {mso-style-priority:99; color:blue; text-decoration:underline;} a:visited, span.MsoHyperlinkFollowed {mso-style-priority:99; color:purple; text-decoration:underline;} p {mso-style-priority:99; mso-margin-top-alt:auto; margin-right:0in; mso-margin-bottom-alt:auto; margin-left:0in; font-size:12.0pt; font-family:"Times New Roman","serif";} p.MsoAcetate, li.MsoAcetate, div.MsoAcetate {mso-style-priority:99; mso-style-link:"Balloon Text Char"; margin:0in; margin-bottom:.0001pt; font-size:8.0pt; font-family:"Tahoma","sans-serif";} span.BalloonTextChar {mso-style-name:"Balloon Text Char"; mso-style-priority:99; mso-style-link:"Balloon Text"; font-family:"Tahoma","sans-serif";} span.EmailStyle20 {mso-style-type:personal; font-family:"Calibri","sans-serif"; color:#1F497D;} span.EmailStyle23 {mso-style-type:personal-reply; font-family:"Calibri","sans-serif"; color:#1F497D;} .MsoChpDefault {mso-style-type:export-only; font-size:10.0pt;} @page WordSection1 {size:8.5in 11.0in; margin:1.0in 1.0in 1.0in 1.0in;} div.WordSection1 {page:WordSection1;} /* List Definitions */ @list l0 {mso-list-id:180434570; mso-list-template-ids:-282402880;} @list l0:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;} @list l0:level2 {mso-level-number-format:bullet; mso-level-text:o; mso-level-tab-stop:1.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:"Courier New"; mso-bidi-font-family:"Times New Roman";} @list l0:level3 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:1.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l0:level4 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:2.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l0:level5 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:2.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l0:level6 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:3.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l0:level7 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:3.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l0:level8 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:4.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l0:level9 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:4.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l1 {mso-list-id:259874230; mso-list-template-ids:-1105409970;} @list l1:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;} @list l1:level2 {mso-level-number-format:bullet; mso-level-text:o; mso-level-tab-stop:1.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:"Courier New"; mso-bidi-font-family:"Times New Roman";} @list l1:level3 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:1.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l1:level4 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:2.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l1:level5 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:2.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l1:level6 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:3.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l1:level7 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:3.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l1:level8 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:4.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l1:level9 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:4.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l2 {mso-list-id:580258439; mso-list-template-ids:-6366690;} @list l2:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;} @list l2:level2 {mso-level-number-format:bullet; mso-level-text:o; mso-level-tab-stop:1.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:"Courier New"; mso-bidi-font-family:"Times New Roman";} @list l2:level3 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:1.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l2:level4 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:2.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l2:level5 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:2.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l2:level6 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:3.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l2:level7 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:3.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l2:level8 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:4.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l2:level9 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:4.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l3 {mso-list-id:713581435; mso-list-template-ids:2069783976;} @list l3:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;} @list l3:level2 {mso-level-number-format:bullet; mso-level-text:o; mso-level-tab-stop:1.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:"Courier New"; mso-bidi-font-family:"Times New Roman";} @list l3:level3 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:1.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l3:level4 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:2.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l3:level5 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:2.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l3:level6 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:3.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l3:level7 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:3.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l3:level8 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:4.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l3:level9 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:4.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l4 {mso-list-id:765921994; mso-list-template-ids:400719310;} @list l4:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;} @list l4:level2 {mso-level-number-format:bullet; mso-level-text:o; mso-level-tab-stop:1.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:"Courier New"; mso-bidi-font-family:"Times New Roman";} @list l4:level3 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:1.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l4:level4 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:2.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l4:level5 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:2.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l4:level6 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:3.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l4:level7 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:3.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l4:level8 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:4.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l4:level9 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:4.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l5 {mso-list-id:843908114; mso-list-template-ids:-1243547606;} @list l5:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;} @list l5:level2 {mso-level-number-format:bullet; mso-level-text:o; mso-level-tab-stop:1.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:"Courier New"; mso-bidi-font-family:"Times New Roman";} @list l5:level3 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:1.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l5:level4 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:2.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l5:level5 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:2.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l5:level6 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:3.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l5:level7 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:3.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l5:level8 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:4.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l5:level9 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:4.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l6 {mso-list-id:964771435; mso-list-template-ids:-2000783132;} @list l6:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;} @list l6:level2 {mso-level-number-format:bullet; mso-level-text:o; mso-level-tab-stop:1.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:"Courier New"; mso-bidi-font-family:"Times New Roman";} @list l6:level3 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:1.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l6:level4 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:2.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l6:level5 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:2.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l6:level6 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:3.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l6:level7 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:3.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l6:level8 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:4.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l6:level9 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:4.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l7 {mso-list-id:1176848642; mso-list-template-ids:1223565722;} @list l7:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;} @list l7:level2 {mso-level-number-format:bullet; mso-level-text:o; mso-level-tab-stop:1.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:"Courier New"; mso-bidi-font-family:"Times New Roman";} @list l7:level3 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:1.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l7:level4 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:2.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l7:level5 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:2.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l7:level6 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:3.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l7:level7 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:3.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l7:level8 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:4.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l7:level9 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:4.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l8 {mso-list-id:1311206220; mso-list-template-ids:314224160;} @list l8:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;} @list l8:level2 {mso-level-number-format:bullet; mso-level-text:o; mso-level-tab-stop:1.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:"Courier New"; mso-bidi-font-family:"Times New Roman";} @list l8:level3 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:1.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l8:level4 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:2.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l8:level5 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:2.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l8:level6 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:3.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l8:level7 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:3.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l8:level8 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:4.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l8:level9 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:4.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l9 {mso-list-id:1434012829; mso-list-template-ids:-690447050;} @list l9:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;} @list l9:level2 {mso-level-number-format:bullet; mso-level-text:o; mso-level-tab-stop:1.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:"Courier New"; mso-bidi-font-family:"Times New Roman";} @list l9:level3 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:1.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l9:level4 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:2.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l9:level5 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:2.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l9:level6 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:3.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l9:level7 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:3.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l9:level8 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:4.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l9:level9 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:4.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l10 {mso-list-id:2135564416; mso-list-template-ids:728504136;} @list l10:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;} @list l10:level2 {mso-level-number-format:bullet; mso-level-text:o; mso-level-tab-stop:1.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:"Courier New"; mso-bidi-font-family:"Times New Roman";} @list l10:level3 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:1.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l10:level4 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:2.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l10:level5 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:2.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l10:level6 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:3.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l10:level7 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:3.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l10:level8 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:4.0in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} @list l10:level9 {mso-level-number-format:bullet; mso-level-text:\F0A7; mso-level-tab-stop:4.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Wingdings;} ol {margin-bottom:0in;} ul {margin-bottom:0in;} --></style><!--[if gte mso 9]><xml> <o:shapedefaults v:ext=3D"edit" spidmax=3D"1026" /> </xml><![endif]--><!--[if gte mso 9]><xml> <o:shapelayout v:ext=3D"edit"> <o:idmap v:ext=3D"edit" data=3D"1" /> </o:shapelayout></xml><![endif]--> </head> <body bgcolor=3D"white" lang=3D"EN-US" link=3D"blue" vlink=3D"purple"> <div class=3D"WordSection1"> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">Hi Vojtech,<o:p></o:p></s= pan></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D"><o:p> </o:p></span><= /p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">The patch is great and ha= s cleared up some questions I had about the implementation. I’ve been= able to get the sample plugins working and waded through the code changes, so feel like I have a good understanding of what was deliver= ed. Thanks a lot for putting this all together. I do have a few questions a= nd suggestions for you, though.<o:p></o:p></span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D"><o:p> </o:p></span><= /p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">Will there eventually be = a way to add one or more buttons to the context sensitive buttons and menus= throughout the interface? For example, we’d like to allow a button to provision a datastore when a data center, cluster, or host is = selected. When the button is clicked, it would open a dialog with an iframe= in which we would load our interface to perform the associated action. Som= e contexts would have several buttons, such as a storage domain (provision, resize, dedupe management, destroy) s= o it would probably make sense for a drop down menu to be available as well= so that the number of buttons above the table doesn’t get too clutte= red. We’d also like to add these same actions to the menus that popup when a contextual object is right clicked.= <o:p></o:p></span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D"><o:p> </o:p></span><= /p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">If needed we can help wor= k on an implementation for the dialog popup plugin framework as we’d = like to get it in relatively quickly so we can move forward on the content side of our plugin.<o:p></o:p></span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D"><o:p> </o:p></span><= /p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">For the reverse proxy, wo= uld it be easier from a customer standpoint to just include a reverse proxy= servlet such as this one? </span><a href=3D"http://sourceforge.net/p= rojects/j2ep/">http://sourceforge.net/projects/j2ep/</a> <o:p></o:p></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">I’m just thinking t= hat setting up and managing a plugin for the HTTP server may be more comple= x than including one internally that would be transparent to a customer.<o:p></o:p></span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D"><o:p> </o:p></span><= /p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">Thanks,<o:p></o:p></span>= </p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">Chris<o:p></o:p></span></= p> <blockquote style=3D"margin-top:5.0pt;margin-bottom:5.0pt"> <div> <p class=3D"MsoNormal" style=3D"margin-bottom:12.0pt"><b>From:</b> Vojtech = Szocs <<a href=3D"mailto:vszocs@redhat.com">vszocs@redhat.com</a>><br=
<b>Date:</b> September 21, 2012 4:37:31 PM EDT<br> <b>To:</b> engine-devel <<a href=3D"mailto:engine-devel@ovirt.org">engin= e-devel@ovirt.org</a>><br> <b>Subject:</b> <b>[Engine-devel] UI Plugins: PoC patch revision 5 is here<= /b><o:p></o:p></p> </div> </blockquote> <blockquote style=3D"margin-top:5.0pt;margin-bottom:5.0pt"> <div> <div> <p class=3D"MsoNormal" style=3D"margin-bottom:12.0pt"><span style=3D"color:= black">Hi guys,<br> <br> it's been a while but here comes the latest revision of UI Plugins proof-of= -concept patch (please find it attached).<br> <br> This revision was originally meant to focus solely on server-side component= s of the plugin infrastructure. However, I ended up implementing all the ma= jor concepts and ideas as discussed on engine-devel mailing list, impacting= both client-side and server-side parts of the plugin infrastructure. As a result, UI plugin infrastructure = should be pretty much complete now, so we can focus on specific plugin API = features in upcoming PoC revisions.<br> <br> There's a whole bunch of changes and improvements in this revision, so I'll= try to cover all the relevant parts step by step. If you have any comments= , questions or ideas, please let me know!<br> <br> So here we go... (or if you just want to get the patch, find the link at th= e end of this message)<o:p></o:p></span></p> <div class=3D"MsoNormal" align=3D"center" style=3D"text-align:center"><span= style=3D"color:black"> <hr size=3D"2" width=3D"100%" align=3D"center"> </span></div> <p class=3D"MsoNormal"><span style=3D"color:black"><br> <strong>0. Added new Engine configuration values</strong><b><br> </b><br> <u>UI plugin data path</u> is represented by <em>ConfigValues.UIPluginDataP= ath</em> enum option ("UIPluginDataPath" in <i>vdc_options</i> table), and resolved relative to <i>ConfigValues.DataDir= </i> if possible. Following (default) values:<o:p></o:p></span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l0 level1 lfo1"> <i>UIPluginDataPath =3D ui-plugins</i><o:p></o:p></li><li class=3D"MsoNorma= l" style=3D"color:black;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;= mso-list:l0 level1 lfo1"> <i>DataDir =3D /usr/share/ovirt-engine</i><o:p></o:p></li></ul> <p class=3D"MsoNormal"><span style=3D"color:black">result in UI plugin data= path: <i> /usr/share/ovirt-engine/ui-plugins</i><br> <br> <u>UI plugin config path</u> is represented by <i>ConfigValues.UIPluginConf= igPath</i> enum option ("UIPluginConfigPath" in <i>vdc_options</i> table), and resolved relative to <i>ConfigValues.ConfigD= ir</i> if possible. Following (default) values:<o:p></o:p></span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l3 level1 lfo2"> <i>UIPluginConfigPath =3D ui-plugins</i><o:p></o:p></li><li class=3D"MsoNor= mal" style=3D"color:black;mso-margin-top-alt:auto;mso-margin-bottom-alt:aut= o;mso-list:l3 level1 lfo2"> <i>ConfigDir =3D /etc/ovirt-engine</i><o:p></o:p></li></ul> <p><span style=3D"color:black">result in UI plugin config path: <i>/etc/ovi= rt-engine/ui-plugins</i><o:p></o:p></span></p> <p class=3D"MsoNormal"><span style=3D"color:black"><br> <b>1. Processing UI plugin data on the server<br> </b><br> <i>PluginDataManager</i> is the class responsible for reading, validating a= nd caching UI plugin descriptor/configuration data on the server (Engine). = It has two main responsibilities:<o:p></o:p></span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l2 level1 lfo3"> return a snapshot of currently valid plugin data (<i>getCurrentData</i> met= hod)<o:p></o:p></li><li class=3D"MsoNormal" style=3D"color:black;mso-margin= -top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l2 level1 lfo3"> reload plugin data from local file system if necessary (<i>reloadData</i> m= ethod)<o:p></o:p></li></ul> <p><span style=3D"color:black">The <i>reloadData</i> method doesn't modify = "live" plugin data directly. Instead, it creates a local working = copy of current plugin data, updates this copy as it reads/validates plugin= descriptor and configuration files, and attempts to update "live" plugin data through conditional reference re-as= signment (using <i> java.util.concurrent.atomic.AtomicReference.compareAndSet</i> method).<o:p>= </o:p></span></p> <p><span style=3D"color:black"><o:p> </o:p></span></p> <p><span style=3D"color:black">In other words, <i>reloadData</i> method mak= es no attempts with regard to Java lock-based synchronization, in favor of = dealing with "live" data through <i>AtomicReference</i> (reference that involves atomic <i>volatile</i> read= s and writes):<o:p></o:p></span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l4 level1 lfo4"> In the best case, a thread will succeed in updating "live" data (= <i>AtomicReference.compareAndSet</i> =3D=3D true), which means that "l= ive" data remained unchanged since this thread acquired a reference of= current plugin data.<o:p></o:p></li><li class=3D"MsoNormal" style=3D"color= :black;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l4 level= 1 lfo4"> In the worst case, a thread will NOT succeed in updating "live" d= ata (<i>AtomicReference.compareAndSet</i> =3D=3D false), which means that &= quot;live" data was already changed by another thread since this threa= d acquired a reference of current plugin data.<o:p></o:p></li></ul> <p><span style=3D"color:black">In my opinion, when dealing with external re= sources like the local file system, this is a good compromise between perfo= rmance and up-to-date data. While we might not get "completely-up-to-d= ate" data at the given point in time (<i>reloadData + getCurrentData</i>), we are guaranteed to get "recently-up-to-d= ate" and consistent data. In other words, the requirement of "com= pletely-up-to-date" data would involve <i>synchronized</i> statements that would hurt performance. In my (very hum= ble) opinion, the benefit of having "completely-up-to-date" data,= at the cost of reduced performance, is not really worth it, especially in = our case when the user can just hit refresh (F5) to reload WebAdmin and its plugin data.<o:p></o:p></span></p> <p><span style=3D"color:black"><o:p> </o:p></span></p> <p><u><span style=3D"color:black">Plugin descriptor files</span></u><span s= tyle=3D"color:black"> are expected to be placed in UI plugin data path, for= example: <i>/usr/share/ovirt-engine/ui-plugins/foo.json</i><o:p></o:p></span></p> <p><span style=3D"color:black"><o:p> </o:p></span></p> <p><span style=3D"color:black">Following descriptor file attributes are imp= lemented and recognized by the plugin infrastructure:<o:p></o:p></span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l9 level1 lfo5"> <i>name</i>: A name that uniquely identifies the plugin (required attribute= ).<o:p></o:p></li><li class=3D"MsoNormal" style=3D"color:black;mso-margin-t= op-alt:auto;mso-margin-bottom-alt:auto;mso-list:l9 level1 lfo5"> <i>url</i>: URL of plugin host page that invokes the plugin code (required = attribute).<o:p></o:p></li><li class=3D"MsoNormal" style=3D"color:black;mso= -margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l9 level1 lfo5"> <i>config</i>: Default configuration object associated with the plugin (opt= ional attribute).<o:p></o:p></li><li class=3D"MsoNormal" style=3D"color:bla= ck;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l9 level1 lf= o5"> <i>resourcePath</i>: Path to plugin static resources, relative to UI plugin= data path (optional attribute). This is used when serving plugin files thr= ough Engine <i>PluginResourceServlet</i> (more on this below).<o:p></o:p></li></ul> <p><u><span style=3D"color:black">Plugin configuration files</span></u><spa= n style=3D"color:black"> are expected to be placed in UI plugin config path= , for example: <i>/etc/engine/ui-plugins/foo-config.json</i><o:p></o:p></span></p> <p><span style=3D"color:black"><o:p> </o:p></span></p> <p><span style=3D"color:black">Note that plugin configuration files follow = the "<descriptorFileName>-config.json" convention.<o:p></o:= p></span></p> <p><span style=3D"color:black"><o:p> </o:p></span></p> <p><span style=3D"color:black">Following configuration file attributes are = implemented and recognized by the plugin infrastructure:<o:p></o:p></span><= /p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l8 level1 lfo6"> <i>config</i>: Custom configuration object associated with the plugin (opti= onal attribute). This overrides the default plugin descriptor configuration= , if any.<o:p></o:p></li><li class=3D"MsoNormal" style=3D"color:black;mso-m= argin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l8 level1 lfo6"> <i>enabled</i>: Indicates whether the plugin should be loaded on WebAdmin s= tartup (optional attribute). Default value is 'true'.<o:p></o:p></li><li cl= ass=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-margin-b= ottom-alt:auto;mso-list:l8 level1 lfo6"> <i>order</i>: Defines the relative order in which the plugin will be loaded= on WebAdmin startup (optional attribute). Default value is <i>Integer.MAX_VALUE</i> (lowest order).<o:p></o:p></li></ul> <p><span style=3D"color:black">The concept of merging custom configuration = (<i>config</i> attribute in <i>foo-config.json</i>), if any, on top of default configuration (<i>config= </i> attribute in <i>foo.json</i>), if any, remains unchanged. This makes the plugin configur= ation quite flexible - in my opinion, the added complexity of handling/merg= ing such configuration is definitely worth the effort.<o:p></o:p></span></p=
<p><span style=3D"color:black"><o:p> </o:p></span></p> <p><span style=3D"color:black">The <i>enabled</i> attribute is straight-for= ward, allowing users to turn the given plugin off, if necessary. In future,= users should still be able to load such plugins through WebAdmin GUI.<o:p>= </o:p></span></p> <p><span style=3D"color:black"><o:p> </o:p></span></p> <p><span style=3D"color:black">The <i>order</i> attribute controls the orde= r in which plugins are loaded on WebAdmin startup. Since plugin resources a= re fetched asynchronously by the browser, this is basically a way of imposi= ng some degree of determinism in the "generally-non-deterministic" plugin environment, which is helpf= ul when troubleshooting problems with multiple plugins. This attribute is a= lso helpful due to file listing methods in <i>java.io.File</i> giving no guarantees that files would be listed in any = particular order (otherwise we could just go for the "NN-<descripto= rFileName>.json" convention, with NN being the order number).<o:p><= /o:p></span></p> <p class=3D"MsoNormal"><span style=3D"color:black"><br> <b>2. Modified behavior of WebadminDynamicHostingServlet<br> </b><br> <i>WebadminDynamicHostingServlet</i> is the servlet used to serve WebAdmin = application host page (HTML page that bootstraps WebAdmin JavaScript code).= <br> <br> In addition to its former behavior, as part of handling the given request, = <i>WebadminDynamicHostingServlet</i>:<o:p></o:p></span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l7 level1 lfo7"> reloads descriptor/configuration data from local file system if necessary, = and obtains a snapshot of currently valid plugin data (<i>PluginDataManager= .reloadAndGetCurrentData</i>)<o:p></o:p></li><li class=3D"MsoNormal" style= =3D"color:black;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list= :l7 level1 lfo7"> embeds all plugin meta-data, suitable for use in client-side plugin infrast= ructure, into WebAdmin host page as "pluginDefinitions" JavaScrip= t array (<i>PluginDefinitions</i>)<o:p></o:p></li></ul> <p class=3D"MsoNormal"><span style=3D"color:black">As a result, reloading U= I plugin descriptor/configuration data is as simple as refreshing (F5) WebA= dmin application in the browser (no need to restart Engine).<br> <br> <b>3. Added servlet for serving plugin static resources<br> </b><br> <i>PluginResourceServlet</i> is the servlet used to serve UI plugin static = files (plugin host page, 3rd party JavaScript, etc.) from the local file sy= stem.<br> <br> For example, requesting URL:<o:p></o:p></span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l5 level1 lfo8"> <i><a href=3D"http://%3cEngineManagerHost%3e:8700/webadmin/webadmin/plugin/= foo/content/start.html">http://<EngineManagerHost>:8700/webadmin/weba= dmin/plugin/foo/content/start.html</a></i><o:p></o:p></li></ul> <p><span style=3D"color:black">will send the content of:<o:p></o:p></span><= /p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l1 level1 lfo9"> <i>/usr/share/ovirt-engine/ui-plugins/<resourcePath>/content/start.ht= ml</i><o:p></o:p></li></ul> <p><span style=3D"color:black">to the client.<o:p></o:p></span></p> <p><span style=3D"color:black"><o:p> </o:p></span></p> <p><span style=3D"color:black">As shown in the above example:<o:p></o:p></s= pan></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l10 level1 lfo10"> <i>/webadmin/webadmin/plugin/</i> is the servlet root path for <i>PluginRes= ourceServlet</i><o:p></o:p></li><li class=3D"MsoNormal" style=3D"color:blac= k;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l10 level1 lf= o10"> in the extra path beyond the servlet root path (<i>/foo/content/start.html<= /i>):<o:p></o:p></li></ul> <ul type=3D"disc"> <ul type=3D"circle"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l10 level2 lfo10"> <i>/foo</i> represents the name of the plugin<o:p></o:p></li><li class=3D"M= soNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-margin-bottom-al= t:auto;mso-list:l10 level2 lfo10"> <i>/content/start.html</i> represents the path to requested resource, relat= ive to "UIPluginDataPath / <resourcePath>"<o:p></o:p></li><= /ul> </ul> <p class=3D"MsoNormal"><span style=3D"color:black">Note that each plugin us= ing <i>PluginResourceServlet</i> to serve its static files must declare non= -empty <i>resourcePath</i> attribute in within the plugin descriptor.<br> <br> Also note that <i>PluginResourceServlet</i>, unlike <i>WebadminDynamicHosti= ngServlet</i>, does NOT reload descriptor/configuration data from local fil= e system as part of handling the given request. In other words, it's assume= d that plugin data has already been (re)loaded when serving WebAdmin application host page, with subsequent re= quests to <i>PluginResourceServlet</i> reading the current plugin information.<br> <br> Until we solve the cross-origin issue in a clean way, <i>PluginResourceServ= let</i> should be used to serve all plugin resources from local file system= .<br> <br> <b>4. Plugin lifecycle improved to deal with misbehaving plugins</b><br> <br> <i>PluginState</i> enum has been modified to deal with plugins that allow u= ncaught exceptions to escape from plugin event handler functions (e.g. &quo= t;UiInit"):<o:p></o:p></span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l6 level1 lfo11"> removed state <i>INITIALIZED</i><o:p></o:p></li><li class=3D"MsoNormal" sty= le=3D"color:black;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-li= st:l6 level1 lfo11"> added state <i>INITIALIZING</i>: The plugin is (currently) being initialize= d by calling UiInit event handler function.<o:p></o:p></li><li class=3D"Mso= Normal" style=3D"color:black;mso-margin-top-alt:auto;mso-margin-bottom-alt:= auto;mso-list:l6 level1 lfo11"> added state <i>IN_USE</i>: Plugin's UiInit event handler function has compl= eted successfully, we can now call other event handler functions as necessa= ry. The plugin is in use now.<o:p></o:p></li><li class=3D"MsoNormal" style= =3D"color:black;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list= :l6 level1 lfo11"> added state <i>FAILED</i>: An uncaught exception escaped while calling an e= vent handler function, which indicates internal error within the plugin cod= e. The plugin is removed from service.<o:p></o:p></li></ul> <p class=3D"MsoNormal" style=3D"margin-bottom:12.0pt"><span style=3D"color:= black">I've attached a simple state diagram that illustrates different stat= es and transitions between them (green color is initial state, red color is= end state).<br> <br> Uncaught exceptions in plugin event handler functions will be caught and ha= ndled by the plugin infrastructure. This prevents a misbehaving plugin from= breaking WebAdmin application, since WebAdmin is the caller (initiator) of= the function call. In such case, the plugin will be removed from service.<br> <br> <b>Update on cross-origin issue (consequence of same-origin policy)</b><br> <br> In order for the plugin to access WebAdmin plugin API, plugin host page (e.= g. <i> start.html</i>) must be served from URL on same origin as Engine origin. Ot= herwise, plugin code running in the context of an iframe'd host page will f= ail to evaluate "parent.pluginApi" expression, with "parent&= quot; being top-level (WebAdmin) window, and "pluginApi" being the global plugin API object exposed by WebAdmin.<br> <br> This is why <i>PluginResourceServlet</i>, available on Engine origin, shoul= d be used to serve all plugin resources from local file system.<br> <br> There's only one issue that remains to be solved: cross-origin "plugin= vs. remote service" communication, with "remote service" be= ing anything other than Engine (REST API). In future, we'll address this wi= th Apache reverse proxy configuration, so that users can configure Apache server (placed in front of Engine JBoss AS) to put ar= bitrary (local or remote non-Engine) services on same origin. However, this= requires a change in current Apache configuration. Until then, users can m= anually edit the Engine Apache configuration file (<i>/etc/httpd/conf.d/ovirt-engine.conf</i>).<o:p></o:p></span></p> <div class=3D"MsoNormal" align=3D"center" style=3D"text-align:center"><span= style=3D"color:black"> <hr size=3D"2" width=3D"100%" align=3D"center"> </span></div> <p class=3D"MsoNormal" style=3D"margin-bottom:12.0pt"><span style=3D"color:= black"><br> I've attached some sample plugin files for you to experiment with. Instead = of attaching actual patch file (92 kB) to this email, I've submitted the pa= tch to oVirt Gerrit: <a href=3D"http://gerrit.ovirt.org/8120">http://gerrit.ovirt.org/8120</a><b= r> <br> Let me know what you think!<br> <br> Cheers,<br> Vojtech<o:p></o:p></span></p> </div> </div> </blockquote> <blockquote style=3D"margin-top:5.0pt;margin-bottom:5.0pt"> <div> <p class=3D"MsoNormal"><ui-plugin-sample-files.tar.gz><o:p></o:p></p> </div> </blockquote> <blockquote style=3D"margin-top:5.0pt;margin-bottom:5.0pt"> <div> <p class=3D"MsoNormal"><ui-plugin-lifecycle.png><o:p></o:p></p> </div> </blockquote> <blockquote style=3D"margin-top:5.0pt;margin-bottom:5.0pt"> <div> <p class=3D"MsoNormal">_______________________________________________<br> Engine-devel mailing list<br> <a href=3D"mailto:Engine-devel@ovirt.org">Engine-devel@ovirt.org</a><br> <a href=3D"http://lists.ovirt.org/mailman/listinfo/engine-devel">http://lis= ts.ovirt.org/mailman/listinfo/engine-devel</a><o:p></o:p></p> </div> </blockquote> </div> </body> </html> --_000_D290AD8432118048947689BA3AE8A9B3E47B82SACEXCMBX04PRDhqn_--
------=_Part_3896354_1791016925.1349203611679 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Hi Chris,=20 many thanks for your feedback and suggestions :)=20 Adding context-sensitive button with corresponding menu item sounds good! I= n fact, this is the proper way how context menu items should be handled, si= nce WebAdmin data grids work with context-sensitive "action buttons" which = are reflected within the context menu. I agree that this is a very useful f= eature to have in plugin API, it should be implemented as part of next majo= r PoC revision.=20 I have a question though: when the user clicks the custom button or corresp= onding context menu item, will your plugin handle common dialog UI (everyth= ing except actual content) on its own, or do you prefer to have some kind o= f "dialog UI" API to create the standard-looking dialog frame for you? I li= ke the idea of using iframe to present custom content though :)=20 As for grouping multiple context-sensitive buttons and corresponding contex= t menu items, this makes sense and we have something like this already impl= emented in WebAdmin (in Host main tab, Power Management drop-down group but= ton, but this is defined not to appear in context menu though). I think thi= s should be part of "custom context-sensitive button / menu item" plugin AP= I feature.=20
If needed we can help work on an implementation for the dialog popup plug= in framework as we=E2=80=99d like to get it in relatively quickly so we can= move forward on the content side of our plugin.=20
If I understand correctly, this is about providing "dialog UI" API to creat= e the standard-looking dialog frame + custom content iframe. I'd like to he= lp with this as well, but you can play with the code and propose a patch on= top of PoC rev.5 [http://gerrit.ovirt.org/8120].=20
For the reverse proxy, would it be easier from a customer standpoint to j= ust include a reverse proxy servlet such as this one?=20
Actually, I was under the impression that oVirt Engine (3.1) package (ovirt= -engine) takes care of setting up Apache web server, which redirects all tr= affic to Engine JBoss AS by default (but maybe I am wrong here). However, i= f this is the case, an efficient way to work around same-origin policy (cro= ss-origin issues) is to configure Apache's reverese proxy module (mod_proxy= ), as discussed in another thread on engine-devel: http://lists.ovirt.org/p= ipermail/engine-devel/2012-September/002511.html=20 This way, you could use Apache to bring Engine and arbitrary (local or remo= te) web services on same origin. What do you think?=20 On the other hand, using a special-purpose reverse proxy servlet directly i= n Engine, not sure if that's a good idea though.. (I'd prefer configuring "= front-end" web server, such as Apache, for this purpose)=20 I'm also sending a couple of updates:=20 UI Plugins Follow-Up Meeting: scheduled for Tuesday, October 9 at 4pm GMT+1= (I'll send a meeting invitation soon, also planning to re-write oVirt UI P= lugins wiki soon after that)=20 PoC rev.5 patch update: many thanks to Juan and Doron for reviewing the rec= ent patch [http://gerrit.ovirt.org/8120]! I'll update the patch accordingly= as revision 5.1=20 Planned items to be included in PoC revision 6:=20 * adding custom context-sensitive button (either separately or within a= button group), along with corresponding context menu item representation= =20 * update custom main tab to show the actual content (iframe) from the g= iven URL=20 * adding custom sub tab that shows content from the given URL=20 More items to consider having in PoC revision 6:=20 * "dialog UI" API to create the standard-looking dialog frame + custom = content iframe=20 * Engine REST API exposed through plugin API=20 * integration with Tasks pane to provide visual feedback on custom oper= ations=20 * extending existing dialogs (e.g. Edit Cluster Policy - custom propert= ies)=20 Let me know what you think.=20 Regards,=20 Vojtech=20 ----- Original Message ----- From: "Christopher Morrissey" <Christopher.Morrissey@netapp.com>=20 To: vszocs@redhat.com=20 Cc: "George Costea" <George.Costea@netapp.com>, "Dustin Schoenbrun" <Dustin= .Schoenbrun@netapp.com>, engine-devel@ovirt.org=20 Sent: Tuesday, October 2, 2012 6:15:34 PM=20 Subject: RE: [Engine-devel] UI Plugins: PoC patch revision 5 is here=20 Hi Vojtech,=20 The patch is great and has cleared up some questions I had about the implem= entation. I=E2=80=99ve been able to get the sample plugins working and wade= d through the code changes, so feel like I have a good understanding of wha= t was delivered. Thanks a lot for putting this all together. I do have a fe= w questions and suggestions for you, though.=20 Will there eventually be a way to add one or more buttons to the context se= nsitive buttons and menus throughout the interface? For example, we=E2=80= =99d like to allow a button to provision a datastore when a data center, cl= uster, or host is selected. When the button is clicked, it would open a dia= log with an iframe in which we would load our interface to perform the asso= ciated action. Some contexts would have several buttons, such as a storage = domain (provision, resize, dedupe management, destroy) so it would probably= make sense for a drop down menu to be available as well so that the number= of buttons above the table doesn=E2=80=99t get too cluttered. We=E2=80=99d= also like to add these same actions to the menus that popup when a context= ual object is right clicked.=20 If needed we can help work on an implementation for the dialog popup plugin= framework as we=E2=80=99d like to get it in relatively quickly so we can m= ove forward on the content side of our plugin.=20 For the reverse proxy, would it be easier from a customer standpoint to jus= t include a reverse proxy servlet such as this one? http://sourceforge.net/= projects/j2ep/=20 I=E2=80=99m just thinking that setting up and managing a plugin for the HTT= P server may be more complex than including one internally that would be tr= ansparent to a customer.=20 Thanks,=20 Chris=20 From: Vojtech Szocs < vszocs@redhat.com >=20 Date: September 21, 2012 4:37:31 PM EDT=20 To: engine-devel < engine-devel@ovirt.org >=20 Subject: [Engine-devel] UI Plugins: PoC patch revision 5 is here=20 <blockquote> Hi guys,=20 it's been a while but here comes the latest revision of UI Plugins proof-of= -concept patch (please find it attached).=20 This revision was originally meant to focus solely on server-side component= s of the plugin infrastructure. However, I ended up implementing all the ma= jor concepts and ideas as discussed on engine-devel mailing list, impacting= both client-side and server-side parts of the plugin infrastructure. As a = result, UI plugin infrastructure should be pretty much complete now, so we = can focus on specific plugin API features in upcoming PoC revisions.=20 There's a whole bunch of changes and improvements in this revision, so I'll= try to cover all the relevant parts step by step. If you have any comments= , questions or ideas, please let me know!=20 So here we go... (or if you just want to get the patch, find the link at th= e end of this message)=20 0. Added new Engine configuration values=20 UI plugin data path is represented by ConfigValues.UIPluginDataPath enum op= tion ("UIPluginDataPath" in vdc_options table), and resolved relative to Co= nfigValues.DataDir if possible. Following (default) values:=20 * UIPluginDataPath =3D ui-plugins=20 * DataDir =3D /usr/share/ovirt-engine=20 result in UI plugin data path: /usr/share/ovirt-engine/ui-plugins=20 UI plugin config path is represented by ConfigValues.UIPluginConfigPath enu= m option ("UIPluginConfigPath" in vdc_options table), and resolved relative= to ConfigValues.ConfigDir if possible. Following (default) values:=20 * UIPluginConfigPath =3D ui-plugins=20 * ConfigDir =3D /etc/ovirt-engine=20 result in UI plugin config path: /etc/ovirt-engine/ui-plugins=20 1. Processing UI plugin data on the server=20 PluginDataManager is the class responsible for reading, validating and cach= ing UI plugin descriptor/configuration data on the server (Engine). It has = two main responsibilities:=20 * return a snapshot of currently valid plugin data ( getCurrentData met= hod)=20 * reload plugin data from local file system if necessary ( reloadData m= ethod)=20 The reloadData method doesn't modify "live" plugin data directly. Instead, = it creates a local working copy of current plugin data, updates this copy a= s it reads/validates plugin descriptor and configuration files, and attempt= s to update "live" plugin data through conditional reference re-assignment = (using java.util.concurrent.atomic.AtomicReference.compareAndSet method).= =20 In other words, reloadData method makes no attempts with regard to Java loc= k-based synchronization, in favor of dealing with "live" data through Atomi= cReference (reference that involves atomic volatile reads and writes):=20 * In the best case, a thread will succeed in updating "live" data ( Ato= micReference.compareAndSet =3D=3D true), which means that "live" data remai= ned unchanged since this thread acquired a reference of current plugin data= .=20 * In the worst case, a thread will NOT succeed in updating "live" data = ( AtomicReference.compareAndSet =3D=3D false), which means that "live" data= was already changed by another thread since this thread acquired a referen= ce of current plugin data.=20 In my opinion, when dealing with external resources like the local file sys= tem, this is a good compromise between performance and up-to-date data. Whi= le we might not get "completely-up-to-date" data at the given point in time= ( reloadData + getCurrentData ), we are guaranteed to get "recently-up-to-= date" and consistent data. In other words, the requirement of "completely-u= p-to-date" data would involve synchronized statements that would hurt perfo= rmance. In my (very humble) opinion, the benefit of having "completely-up-t= o-date" data, at the cost of reduced performance, is not really worth it, e= specially in our case when the user can just hit refresh (F5) to reload Web= Admin and its plugin data.=20 Plugin descriptor files are expected to be placed in UI plugin data path, f= or example: /usr/share/ovirt-engine/ui-plugins/foo.json=20 Following descriptor file attributes are implemented and recognized by the = plugin infrastructure:=20 * name : A name that uniquely identifies the plugin (required attribute= ).=20 * url : URL of plugin host page that invokes the plugin code (required = attribute).=20 * config : Default configuration object associated with the plugin (opt= ional attribute).=20 * resourcePath : Path to plugin static resources, relative to UI plugin= data path (optional attribute). This is used when serving plugin files thr= ough Engine PluginResourceServlet (more on this below).=20 Plugin configuration files are expected to be placed in UI plugin config pa= th, for example: /etc/engine/ui-plugins/foo-config.json=20 Note that plugin configuration files follow the "<descriptorFileName>-confi= g.json" convention.=20 Following configuration file attributes are implemented and recognized by t= he plugin infrastructure:=20 * config : Custom configuration object associated with the plugin (opti= onal attribute). This overrides the default plugin descriptor configuration= , if any.=20 * enabled : Indicates whether the plugin should be loaded on WebAdmin s= tartup (optional attribute). Default value is 'true'.=20 * order : Defines the relative order in which the plugin will be loaded= on WebAdmin startup (optional attribute). Default value is Integer.MAX_VAL= UE (lowest order).=20 The concept of merging custom configuration ( config attribute in foo-confi= g.json ), if any, on top of default configuration ( config attribute in foo= .json ), if any, remains unchanged. This makes the plugin configuration qui= te flexible - in my opinion, the added complexity of handling/merging such = configuration is definitely worth the effort.=20 The enabled attribute is straight-forward, allowing users to turn the given= plugin off, if necessary. In future, users should still be able to load su= ch plugins through WebAdmin GUI.=20 The order attribute controls the order in which plugins are loaded on WebAd= min startup. Since plugin resources are fetched asynchronously by the brows= er, this is basically a way of imposing some degree of determinism in the "= generally-non-deterministic" plugin environment, which is helpful when trou= bleshooting problems with multiple plugins. This attribute is also helpful = due to file listing methods in java.io.File giving no guarantees that files= would be listed in any particular order (otherwise we could just go for th= e "NN-<descriptorFileName>.json" convention, with NN being the order number= ).=20 2. Modified behavior of WebadminDynamicHostingServlet=20 WebadminDynamicHostingServlet is the servlet used to serve WebAdmin applica= tion host page (HTML page that bootstraps WebAdmin JavaScript code).=20 In addition to its former behavior, as part of handling the given request, = WebadminDynamicHostingServlet :=20 * reloads descriptor/configuration data from local file system if neces= sary, and obtains a snapshot of currently valid plugin data ( PluginDataMan= ager.reloadAndGetCurrentData )=20 * embeds all plugin meta-data, suitable for use in client-side plugin i= nfrastructure, into WebAdmin host page as "pluginDefinitions" JavaScript ar= ray ( PluginDefinitions )=20 As a result, reloading UI plugin descriptor/configuration data is as simple= as refreshing (F5) WebAdmin application in the browser (no need to restart= Engine).=20 3. Added servlet for serving plugin static resources=20 PluginResourceServlet is the servlet used to serve UI plugin static files (= plugin host page, 3rd party JavaScript, etc.) from the local file system.= =20 For example, requesting URL:=20 * http://<EngineManagerHost>:8700/webadmin/webadmin/plugin/foo/content/= start.html=20 will send the content of:=20 * /usr/share/ovirt-engine/ui-plugins/<resourcePath>/content/start.html= =20 to the client.=20 As shown in the above example:=20 * /webadmin/webadmin/plugin/ is the servlet root path for PluginResourc= eServlet=20 * in the extra path beyond the servlet root path ( /foo/content/start.h= tml ):=20 * /foo represents the name of the plugin=20 * /content/start.html represents the path to requested resource, re= lative to "UIPluginDataPath / <resourcePath>"=20 Note that each plugin using PluginResourceServlet to serve its static files= must declare non-empty resourcePath attribute in within the plugin descrip= tor.=20 Also note that PluginResourceServlet , unlike WebadminDynamicHostingServlet= , does NOT reload descriptor/configuration data from local file system as = part of handling the given request. In other words, it's assumed that plugi= n data has already been (re)loaded when serving WebAdmin application host p= age, with subsequent requests to PluginResourceServlet reading the current = plugin information.=20 Until we solve the cross-origin issue in a clean way, PluginResourceServlet= should be used to serve all plugin resources from local file system.=20 4. Plugin lifecycle improved to deal with misbehaving plugins=20 PluginState enum has been modified to deal with plugins that allow uncaught= exceptions to escape from plugin event handler functions (e.g. "UiInit"):= =20 * removed state INITIALIZED=20 * added state INITIALIZING : The plugin is (currently) being initialize= d by calling UiInit event handler function.=20 * added state IN_USE : Plugin's UiInit event handler function has compl= eted successfully, we can now call other event handler functions as necessa= ry. The plugin is in use now.=20 * added state FAILED : An uncaught exception escaped while calling an e= vent handler function, which indicates internal error within the plugin cod= e. The plugin is removed from service.=20 I've attached a simple state diagram that illustrates different states and = transitions between them (green color is initial state, red color is end st= ate).=20 Uncaught exceptions in plugin event handler functions will be caught and ha= ndled by the plugin infrastructure. This prevents a misbehaving plugin from= breaking WebAdmin application, since WebAdmin is the caller (initiator) of= the function call. In such case, the plugin will be removed from service.= =20 Update on cross-origin issue (consequence of same-origin policy)=20 In order for the plugin to access WebAdmin plugin API, plugin host page (e.= g. start.html ) must be served from URL on same origin as Engine origin. Ot= herwise, plugin code running in the context of an iframe'd host page will f= ail to evaluate "parent.pluginApi" expression, with "parent" being top-leve= l (WebAdmin) window, and "pluginApi" being the global plugin API object exp= osed by WebAdmin.=20 This is why PluginResourceServlet , available on Engine origin, should be u= sed to serve all plugin resources from local file system.=20 There's only one issue that remains to be solved: cross-origin "plugin vs. = remote service" communication, with "remote service" being anything other t= han Engine (REST API). In future, we'll address this with Apache reverse pr= oxy configuration, so that users can configure Apache server (placed in fro= nt of Engine JBoss AS) to put arbitrary (local or remote non-Engine) servic= es on same origin. However, this requires a change in current Apache config= uration. Until then, users can manually edit the Engine Apache configuratio= n file ( /etc/httpd/conf.d/ovirt-engine.conf ).=20 I've attached some sample plugin files for you to experiment with. Instead = of attaching actual patch file (92 kB) to this email, I've submitted the pa= tch to oVirt Gerrit: http://gerrit.ovirt.org/8120=20 Let me know what you think!=20 Cheers,=20 Vojtech=20 </blockquote> <blockquote> <ui-plugin-sample-files.tar.gz>=20 </blockquote> <blockquote> <ui-plugin-lifecycle.png>=20 </blockquote> <blockquote> _______________________________________________=20 Engine-devel mailing list=20 Engine-devel@ovirt.org=20 http://lists.ovirt.org/mailman/listinfo/engine-devel=20 </blockquote> ------=_Part_3896354_1791016925.1349203611679 Content-Type: text/html; charset=utf-8 Content-Transfer-Encoding: quoted-printable <html><head><style type=3D'text/css'>p { margin: 0; }</style></head><body><= div style=3D'font-family: times new roman,new york,times,serif; font-size: = 12pt; color: #000000'>Hi Chris,<br><br>many thanks for your feedback and su= ggestions :)<br><br>Adding context-sensitive button with corresponding menu= item sounds good! In fact, this is the proper way how context menu items s= hould be handled, since WebAdmin data grids work with context-sensitive "ac= tion buttons" which are reflected within the context menu. I agree that thi= s is a very useful feature to have in plugin API, it should be implemented = as part of next major PoC revision.<br><br>I have a question though: when t= he user clicks the custom button or corresponding context menu item, will y= our plugin handle common dialog UI (everything except actual content) on it= s own, or do you prefer to have some kind of "dialog UI" API to create the = standard-looking dialog frame for you? I like the idea of using iframe to p= resent custom content though :)<br><br>As for grouping multiple context-sen= sitive buttons and corresponding context menu items, this makes sense and w= e have something like this already implemented in WebAdmin (in Host main ta= b, Power Management drop-down group button, but this is defined not to appe= ar in context menu though). I think this should be part of "custom context-= sensitive button / menu item" plugin API feature.<br><br>> <span style= =3D"font-size:11.0pt;font-family:"Calibri","sans-serif"= ;color:#1F497D">If needed we can help work on an implementation for the dialog popup=20 plugin framework as we=E2=80=99d like to get it in relatively quickly so we= can=20 move forward on the content side of our plugin.</span><br><br>If I understand correctly, t= his is about providing "dialog UI" API to create the standard-looking dialo= g frame + custom content iframe. I'd like to help with this as well, = but you can play with the code and propose a patch on top of PoC rev.5 [htt= p://gerrit.ovirt.org/8120].<br><br>> <span style=3D"font-size:11.0pt;fon= t-family:"Calibri","sans-serif";color:#1F497D">For the = reverse proxy, would it be easier from a customer standpoint to just includ= e a reverse proxy servlet such as this one?<br></span><br>Actually, I was u= nder the impression that oVirt Engine (3.1) package (ovirt-engine) takes ca= re of setting up Apache web server, which redirects all traffic to Engine J= Boss AS by default (but maybe I am wrong here). However, if this is the cas= e, an efficient way to work around same-origin policy (cross-origin issues)= is to configure Apache's reverese proxy module (mod_proxy), as discussed i= n another thread on engine-devel: http://lists.ovirt.org/pipermail/engine-d= evel/2012-September/002511.html<br><br>This way, you could use Apache to br= ing Engine and arbitrary (local or remote) web services on same origin. Wha= t do you think?<br><br>On the other hand, using a special-purpose reverse p= roxy servlet directly in Engine, not sure if that's a good idea though.. (I= 'd prefer configuring "front-end" web server, such as Apache, for this purp= ose)<br><br>I'm also sending a couple of updates:<br><br><strong>UI Plugins= Follow-Up Meeting:</strong> scheduled for Tuesday, October 9 at 4pm GMT+1 = (I'll send a meeting invitation soon, also planning to re-write oVirt UI Pl= ugins wiki soon after that)<br><br><span style=3D"font-weight: bold;">PoC r= ev.5 patch update:</span> many thanks to Juan and Doron for reviewing the r= ecent patch [http://gerrit.ovirt.org/8120]! I'll update the patch according= ly as revision 5.1<br><br><span style=3D"font-weight: bold;">Planned items = to be included in PoC revision 6:</span><br><ul><li>adding custom context-s= ensitive button (either separately or within a button group), along with co= rresponding context menu item representation</li><li>update custom main tab= to show the actual content (iframe) from the given URL</li><li>adding cust= om sub tab that shows content from the given URL</li></ul><p><br></p><p><sp= an style=3D"font-weight: bold;">More items to consider having in PoC revisi= on 6:</span><br></p><ul><li>"dialog UI" API to create the standard-looking = dialog frame + custom content iframe</li><li>Engine REST API exposed throug= h plugin API</li><li>integration with Tasks pane to provide visual feedback= on custom operations</li><li>extending existing dialogs (e.g. Edit Cluster= Policy - custom properties)<br></li></ul><p><br></p><p>Let me know what yo= u think.<br></p><p><br></p><p></p>Regards,<br>Vojtech<br><br><br><hr id=3D"= zwchr"><div style=3D"color:#000;font-weight:normal;font-style:normal;text-d= ecoration:none;font-family:Helvetica,Arial,sans-serif;font-size:12pt;"><b>F= rom: </b>"Christopher Morrissey" <Christopher.Morrissey@netapp.com><b= r><b>To: </b>vszocs@redhat.com<br><b>Cc: </b>"George Costea" <George.Cos= tea@netapp.com>, "Dustin Schoenbrun" <Dustin.Schoenbrun@netapp.com>= ;, engine-devel@ovirt.org<br><b>Sent: </b>Tuesday, October 2, 2012 6:15:34 = PM<br><b>Subject: </b>RE: [Engine-devel] UI Plugins: PoC patch revision 5 i= s here<br><br> <style><!-- @font-face =09{font-family:Wingdings; =09panose-1:5 0 0 0 0 0 0 0 0 0;} @font-face =09{font-family:Wingdings; =09panose-1:5 0 0 0 0 0 0 0 0 0;} @font-face =09{font-family:Calibri; =09panose-1:2 15 5 2 2 2 4 3 2 4;} @font-face =09{font-family:Tahoma; =09panose-1:2 11 6 4 3 5 4 4 2 4;} p.MsoNormal, li.MsoNormal, div.MsoNormal =09{margin:0in; =09margin-bottom:.0001pt; =09font-size:12.0pt; =09font-family:"Times New Roman","serif";} a:link, span.MsoHyperlink =09{mso-style-priority:99; =09color:blue; =09text-decoration:underline;} a:visited, span.MsoHyperlinkFollowed =09{mso-style-priority:99; =09color:purple; =09text-decoration:underline;} p =09{mso-style-priority:99; =09mso-margin-top-alt:auto; =09margin-right:0in; =09mso-margin-bottom-alt:auto; =09margin-left:0in; =09font-size:12.0pt; =09font-family:"Times New Roman","serif";} p.MsoAcetate, li.MsoAcetate, div.MsoAcetate =09{mso-style-priority:99; =09mso-style-link:"Balloon Text Char"; =09margin:0in; =09margin-bottom:.0001pt; =09font-size:8.0pt; =09font-family:"Tahoma","sans-serif";} span.BalloonTextChar =09{mso-style-name:"Balloon Text Char"; =09mso-style-priority:99; =09mso-style-link:"Balloon Text"; =09font-family:"Tahoma","sans-serif";} span.EmailStyle20 =09{mso-style-type:personal; =09font-family:"Calibri","sans-serif"; =09color:#1F497D;} span.EmailStyle23 =09{mso-style-type:personal-reply; =09font-family:"Calibri","sans-serif"; =09color:#1F497D;} .MsoChpDefault =09{mso-style-type:export-only; =09font-size:10.0pt;} @page WordSection1 =09{size:8.5in 11.0in; =09margin:1.0in 1.0in 1.0in 1.0in;} div.WordSection1 =09{page:WordSection1;} @list l0 =09{mso-list-id:180434570; =09mso-list-template-ids:-282402880;} @list l0:level1 =09{mso-level-number-format:bullet; =09mso-level-text:\F0B7; =09mso-level-tab-stop:.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Symbol;} @list l0:level2 =09{mso-level-number-format:bullet; =09mso-level-text:o; =09mso-level-tab-stop:1.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:"Courier New"; =09mso-bidi-font-family:"Times New Roman";} @list l0:level3 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:1.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l0:level4 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:2.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l0:level5 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:2.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l0:level6 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:3.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l0:level7 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:3.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l0:level8 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:4.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l0:level9 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:4.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l1 =09{mso-list-id:259874230; =09mso-list-template-ids:-1105409970;} @list l1:level1 =09{mso-level-number-format:bullet; =09mso-level-text:\F0B7; =09mso-level-tab-stop:.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Symbol;} @list l1:level2 =09{mso-level-number-format:bullet; =09mso-level-text:o; =09mso-level-tab-stop:1.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:"Courier New"; =09mso-bidi-font-family:"Times New Roman";} @list l1:level3 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:1.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l1:level4 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:2.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l1:level5 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:2.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l1:level6 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:3.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l1:level7 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:3.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l1:level8 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:4.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l1:level9 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:4.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l2 =09{mso-list-id:580258439; =09mso-list-template-ids:-6366690;} @list l2:level1 =09{mso-level-number-format:bullet; =09mso-level-text:\F0B7; =09mso-level-tab-stop:.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Symbol;} @list l2:level2 =09{mso-level-number-format:bullet; =09mso-level-text:o; =09mso-level-tab-stop:1.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:"Courier New"; =09mso-bidi-font-family:"Times New Roman";} @list l2:level3 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:1.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l2:level4 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:2.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l2:level5 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:2.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l2:level6 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:3.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l2:level7 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:3.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l2:level8 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:4.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l2:level9 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:4.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l3 =09{mso-list-id:713581435; =09mso-list-template-ids:2069783976;} @list l3:level1 =09{mso-level-number-format:bullet; =09mso-level-text:\F0B7; =09mso-level-tab-stop:.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Symbol;} @list l3:level2 =09{mso-level-number-format:bullet; =09mso-level-text:o; =09mso-level-tab-stop:1.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:"Courier New"; =09mso-bidi-font-family:"Times New Roman";} @list l3:level3 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:1.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l3:level4 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:2.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l3:level5 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:2.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l3:level6 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:3.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l3:level7 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:3.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l3:level8 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:4.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l3:level9 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:4.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l4 =09{mso-list-id:765921994; =09mso-list-template-ids:400719310;} @list l4:level1 =09{mso-level-number-format:bullet; =09mso-level-text:\F0B7; =09mso-level-tab-stop:.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Symbol;} @list l4:level2 =09{mso-level-number-format:bullet; =09mso-level-text:o; =09mso-level-tab-stop:1.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:"Courier New"; =09mso-bidi-font-family:"Times New Roman";} @list l4:level3 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:1.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l4:level4 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:2.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l4:level5 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:2.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l4:level6 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:3.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l4:level7 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:3.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l4:level8 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:4.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l4:level9 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:4.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l5 =09{mso-list-id:843908114; =09mso-list-template-ids:-1243547606;} @list l5:level1 =09{mso-level-number-format:bullet; =09mso-level-text:\F0B7; =09mso-level-tab-stop:.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Symbol;} @list l5:level2 =09{mso-level-number-format:bullet; =09mso-level-text:o; =09mso-level-tab-stop:1.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:"Courier New"; =09mso-bidi-font-family:"Times New Roman";} @list l5:level3 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:1.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l5:level4 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:2.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l5:level5 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:2.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l5:level6 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:3.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l5:level7 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:3.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l5:level8 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:4.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l5:level9 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:4.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l6 =09{mso-list-id:964771435; =09mso-list-template-ids:-2000783132;} @list l6:level1 =09{mso-level-number-format:bullet; =09mso-level-text:\F0B7; =09mso-level-tab-stop:.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Symbol;} @list l6:level2 =09{mso-level-number-format:bullet; =09mso-level-text:o; =09mso-level-tab-stop:1.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:"Courier New"; =09mso-bidi-font-family:"Times New Roman";} @list l6:level3 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:1.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l6:level4 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:2.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l6:level5 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:2.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l6:level6 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:3.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l6:level7 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:3.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l6:level8 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:4.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l6:level9 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:4.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l7 =09{mso-list-id:1176848642; =09mso-list-template-ids:1223565722;} @list l7:level1 =09{mso-level-number-format:bullet; =09mso-level-text:\F0B7; =09mso-level-tab-stop:.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Symbol;} @list l7:level2 =09{mso-level-number-format:bullet; =09mso-level-text:o; =09mso-level-tab-stop:1.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:"Courier New"; =09mso-bidi-font-family:"Times New Roman";} @list l7:level3 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:1.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l7:level4 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:2.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l7:level5 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:2.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l7:level6 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:3.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l7:level7 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:3.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l7:level8 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:4.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l7:level9 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:4.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l8 =09{mso-list-id:1311206220; =09mso-list-template-ids:314224160;} @list l8:level1 =09{mso-level-number-format:bullet; =09mso-level-text:\F0B7; =09mso-level-tab-stop:.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Symbol;} @list l8:level2 =09{mso-level-number-format:bullet; =09mso-level-text:o; =09mso-level-tab-stop:1.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:"Courier New"; =09mso-bidi-font-family:"Times New Roman";} @list l8:level3 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:1.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l8:level4 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:2.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l8:level5 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:2.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l8:level6 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:3.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l8:level7 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:3.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l8:level8 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:4.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l8:level9 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:4.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l9 =09{mso-list-id:1434012829; =09mso-list-template-ids:-690447050;} @list l9:level1 =09{mso-level-number-format:bullet; =09mso-level-text:\F0B7; =09mso-level-tab-stop:.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Symbol;} @list l9:level2 =09{mso-level-number-format:bullet; =09mso-level-text:o; =09mso-level-tab-stop:1.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:"Courier New"; =09mso-bidi-font-family:"Times New Roman";} @list l9:level3 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:1.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l9:level4 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:2.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l9:level5 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:2.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l9:level6 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:3.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l9:level7 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:3.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l9:level8 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:4.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l9:level9 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:4.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l10 =09{mso-list-id:2135564416; =09mso-list-template-ids:728504136;} @list l10:level1 =09{mso-level-number-format:bullet; =09mso-level-text:\F0B7; =09mso-level-tab-stop:.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Symbol;} @list l10:level2 =09{mso-level-number-format:bullet; =09mso-level-text:o; =09mso-level-tab-stop:1.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:"Courier New"; =09mso-bidi-font-family:"Times New Roman";} @list l10:level3 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:1.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l10:level4 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:2.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l10:level5 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:2.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l10:level6 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:3.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l10:level7 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:3.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l10:level8 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:4.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l10:level9 =09{mso-level-number-format:bullet; =09mso-level-text:\F0A7; =09mso-level-tab-stop:4.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} ol =09{margin-bottom:0in;} ul =09{margin-bottom:0in;} --></style> <div class=3D"WordSection1"> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">Hi Vojtech,</span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D"> </span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">The patch is great and ha= s cleared up some questions I had about the implementation. I=E2=80=99ve be= en able to get the sample plugins working and waded through the code changes, so feel like I have a good understanding of what was deliver= ed. Thanks a lot for putting this all together. I do have a few questions a= nd suggestions for you, though.</span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D"> </span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">Will there eventually be = a way to add one or more buttons to the context sensitive buttons and menus= throughout the interface? For example, we=E2=80=99d like to allow a button to provision a datastore when a data center, cluster, or host is = selected. When the button is clicked, it would open a dialog with an iframe= in which we would load our interface to perform the associated action. Som= e contexts would have several buttons, such as a storage domain (provision, resize, dedupe management, destroy) s= o it would probably make sense for a drop down menu to be available as well= so that the number of buttons above the table doesn=E2=80=99t get too clut= tered. We=E2=80=99d also like to add these same actions to the menus that popup when a contextual object is right clicked.= </span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D"> </span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">If needed we can help wor= k on an implementation for the dialog popup plugin framework as we=E2=80=99= d like to get it in relatively quickly so we can move forward on the content side of our plugin.</span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D"> </span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">For the reverse proxy, wo= uld it be easier from a customer standpoint to just include a reverse proxy= servlet such as this one? </span><a href=3D"http://sourceforge.net/p= rojects/j2ep/" target=3D"_blank">http://sourceforge.net/projects/j2ep/</a> </p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">I=E2=80=99m just thinking= that setting up and managing a plugin for the HTTP server may be more comp= lex than including one internally that would be transparent to a customer.</span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D"> </span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">Thanks,</span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">Chris</span></p> <blockquote style=3D"margin-top:5.0pt;margin-bottom:5.0pt"> <div> <p class=3D"MsoNormal" style=3D"margin-bottom:12.0pt"><b>From:</b> Vojtech = Szocs <<a href=3D"mailto:vszocs@redhat.com" target=3D"_blank">vszocs@red= hat.com</a>><br> <b>Date:</b> September 21, 2012 4:37:31 PM EDT<br> <b>To:</b> engine-devel <<a href=3D"mailto:engine-devel@ovirt.org" targe= t=3D"_blank">engine-devel@ovirt.org</a>><br> <b>Subject:</b> <b>[Engine-devel] UI Plugins: PoC patch revision 5 is here<= /b></p> </div> </blockquote> <blockquote style=3D"margin-top:5.0pt;margin-bottom:5.0pt"> <div> <div> <p class=3D"MsoNormal" style=3D"margin-bottom:12.0pt"><span style=3D"color:= black">Hi guys,<br> <br> it's been a while but here comes the latest revision of UI Plugins proof-of= -concept patch (please find it attached).<br> <br> This revision was originally meant to focus solely on server-side component= s of the plugin infrastructure. However, I ended up implementing all the ma= jor concepts and ideas as discussed on engine-devel mailing list, impacting= both client-side and server-side parts of the plugin infrastructure. As a result, UI plugin infrastructure = should be pretty much complete now, so we can focus on specific plugin API = features in upcoming PoC revisions.<br> <br> There's a whole bunch of changes and improvements in this revision, so I'll= try to cover all the relevant parts step by step. If you have any comments= , questions or ideas, please let me know!<br> <br> So here we go... (or if you just want to get the patch, find the link at th= e end of this message)</span></p> <div class=3D"MsoNormal" style=3D"text-align:center" align=3D"center"><span= style=3D"color:black"> <hr align=3D"center" size=3D"2" width=3D"100%"> </span></div> <p class=3D"MsoNormal"><span style=3D"color:black"><br> <strong>0. Added new Engine configuration values</strong><b><br> </b><br> <u>UI plugin data path</u> is represented by <em>ConfigValues.UIPluginDataP= ath</em> enum option ("UIPluginDataPath" in <i>vdc_options</i> table), and resolved relative to <i>ConfigValues.DataDir= </i> if possible. Following (default) values:</span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l0 level1 lfo1"> <i>UIPluginDataPath =3D ui-plugins</i></li><li class=3D"MsoNormal" style=3D= "color:black;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l0= level1 lfo1"> <i>DataDir =3D /usr/share/ovirt-engine</i></li></ul> <p class=3D"MsoNormal"><span style=3D"color:black">result in UI plugin data= path: <i> /usr/share/ovirt-engine/ui-plugins</i><br> <br> <u>UI plugin config path</u> is represented by <i>ConfigValues.UIPluginConf= igPath</i> enum option ("UIPluginConfigPath" in <i>vdc_options</i> table), and resolved relative to <i>ConfigValues.ConfigD= ir</i> if possible. Following (default) values:</span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l3 level1 lfo2"> <i>UIPluginConfigPath =3D ui-plugins</i></li><li class=3D"MsoNormal" style= =3D"color:black;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list= :l3 level1 lfo2"> <i>ConfigDir =3D /etc/ovirt-engine</i></li></ul> <p><span style=3D"color:black">result in UI plugin config path: <i>/etc/ovi= rt-engine/ui-plugins</i></span></p> <p class=3D"MsoNormal"><span style=3D"color:black"><br> <b>1. Processing UI plugin data on the server<br> </b><br> <i>PluginDataManager</i> is the class responsible for reading, validating a= nd caching UI plugin descriptor/configuration data on the server (Engine). = It has two main responsibilities:</span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l2 level1 lfo3"> return a snapshot of currently valid plugin data (<i>getCurrentData</i> met= hod)</li><li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:au= to;mso-margin-bottom-alt:auto;mso-list:l2 level1 lfo3"> reload plugin data from local file system if necessary (<i>reloadData</i> m= ethod)</li></ul> <p><span style=3D"color:black">The <i>reloadData</i> method doesn't modify = "live" plugin data directly. Instead, it creates a local working copy of cu= rrent plugin data, updates this copy as it reads/validates plugin descripto= r and configuration files, and attempts to update "live" plugin data through conditional reference re-assignment (= using <i> java.util.concurrent.atomic.AtomicReference.compareAndSet</i> method).</spa= n></p> <p><span style=3D"color:black"> </span></p> <p><span style=3D"color:black">In other words, <i>reloadData</i> method mak= es no attempts with regard to Java lock-based synchronization, in favor of = dealing with "live" data through <i>AtomicReference</i> (reference that involves atomic <i>volatile</i> read= s and writes):</span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l4 level1 lfo4"> In the best case, a thread will succeed in updating "live" data (<i>AtomicR= eference.compareAndSet</i> =3D=3D true), which means that "live" data remai= ned unchanged since this thread acquired a reference of current plugin data= .</li><li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;= mso-margin-bottom-alt:auto;mso-list:l4 level1 lfo4"> In the worst case, a thread will NOT succeed in updating "live" data (<i>At= omicReference.compareAndSet</i> =3D=3D false), which means that "live" data= was already changed by another thread since this thread acquired a referen= ce of current plugin data.</li></ul> <p><span style=3D"color:black">In my opinion, when dealing with external re= sources like the local file system, this is a good compromise between perfo= rmance and up-to-date data. While we might not get "completely-up-to-date" = data at the given point in time (<i>reloadData + getCurrentData</i>), we are guaranteed to get "recently-up-to-date" and = consistent data. In other words, the requirement of "completely-up-to-date"= data would involve <i>synchronized</i> statements that would hurt performance. In my (very hum= ble) opinion, the benefit of having "completely-up-to-date" data, at the co= st of reduced performance, is not really worth it, especially in our case w= hen the user can just hit refresh (F5) to reload WebAdmin and its plugin data.</span></p> <p><span style=3D"color:black"> </span></p> <p><u><span style=3D"color:black">Plugin descriptor files</span></u><span s= tyle=3D"color:black"> are expected to be placed in UI plugin data path, for= example: <i>/usr/share/ovirt-engine/ui-plugins/foo.json</i></span></p> <p><span style=3D"color:black"> </span></p> <p><span style=3D"color:black">Following descriptor file attributes are imp= lemented and recognized by the plugin infrastructure:</span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l9 level1 lfo5"> <i>name</i>: A name that uniquely identifies the plugin (required attribute= ).</li><li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto= ;mso-margin-bottom-alt:auto;mso-list:l9 level1 lfo5"> <i>url</i>: URL of plugin host page that invokes the plugin code (required = attribute).</li><li class=3D"MsoNormal" style=3D"color:black;mso-margin-top= -alt:auto;mso-margin-bottom-alt:auto;mso-list:l9 level1 lfo5"> <i>config</i>: Default configuration object associated with the plugin (opt= ional attribute).</li><li class=3D"MsoNormal" style=3D"color:black;mso-marg= in-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l9 level1 lfo5"> <i>resourcePath</i>: Path to plugin static resources, relative to UI plugin= data path (optional attribute). This is used when serving plugin files thr= ough Engine <i>PluginResourceServlet</i> (more on this below).</li></ul> <p><u><span style=3D"color:black">Plugin configuration files</span></u><spa= n style=3D"color:black"> are expected to be placed in UI plugin config path= , for example: <i>/etc/engine/ui-plugins/foo-config.json</i></span></p> <p><span style=3D"color:black"> </span></p> <p><span style=3D"color:black">Note that plugin configuration files follow = the "<descriptorFileName>-config.json" convention.</span></p> <p><span style=3D"color:black"> </span></p> <p><span style=3D"color:black">Following configuration file attributes are = implemented and recognized by the plugin infrastructure:</span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l8 level1 lfo6"> <i>config</i>: Custom configuration object associated with the plugin (opti= onal attribute). This overrides the default plugin descriptor configuration= , if any.</li><li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-a= lt:auto;mso-margin-bottom-alt:auto;mso-list:l8 level1 lfo6"> <i>enabled</i>: Indicates whether the plugin should be loaded on WebAdmin s= tartup (optional attribute). Default value is 'true'.</li><li class=3D"MsoN= ormal" style=3D"color:black;mso-margin-top-alt:auto;mso-margin-bottom-alt:a= uto;mso-list:l8 level1 lfo6"> <i>order</i>: Defines the relative order in which the plugin will be loaded= on WebAdmin startup (optional attribute). Default value is <i>Integer.MAX_VALUE</i> (lowest order).</li></ul> <p><span style=3D"color:black">The concept of merging custom configuration = (<i>config</i> attribute in <i>foo-config.json</i>), if any, on top of default configuration (<i>config= </i> attribute in <i>foo.json</i>), if any, remains unchanged. This makes the plugin configur= ation quite flexible - in my opinion, the added complexity of handling/merg= ing such configuration is definitely worth the effort.</span></p> <p><span style=3D"color:black"> </span></p> <p><span style=3D"color:black">The <i>enabled</i> attribute is straight-for= ward, allowing users to turn the given plugin off, if necessary. In future,= users should still be able to load such plugins through WebAdmin GUI.</spa= n></p> <p><span style=3D"color:black"> </span></p> <p><span style=3D"color:black">The <i>order</i> attribute controls the orde= r in which plugins are loaded on WebAdmin startup. Since plugin resources a= re fetched asynchronously by the browser, this is basically a way of imposi= ng some degree of determinism in the "generally-non-deterministic" plugin environment, which is helpful when tr= oubleshooting problems with multiple plugins. This attribute is also helpfu= l due to file listing methods in <i>java.io.File</i> giving no guarantees that files would be listed in any = particular order (otherwise we could just go for the "NN-<descriptorFile= Name>.json" convention, with NN being the order number).</span></p> <p class=3D"MsoNormal"><span style=3D"color:black"><br> <b>2. Modified behavior of WebadminDynamicHostingServlet<br> </b><br> <i>WebadminDynamicHostingServlet</i> is the servlet used to serve WebAdmin = application host page (HTML page that bootstraps WebAdmin JavaScript code).= <br> <br> In addition to its former behavior, as part of handling the given request, = <i>WebadminDynamicHostingServlet</i>:</span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l7 level1 lfo7"> reloads descriptor/configuration data from local file system if necessary, = and obtains a snapshot of currently valid plugin data (<i>PluginDataManager= .reloadAndGetCurrentData</i>)</li><li class=3D"MsoNormal" style=3D"color:bl= ack;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l7 level1 l= fo7"> embeds all plugin meta-data, suitable for use in client-side plugin infrast= ructure, into WebAdmin host page as "pluginDefinitions" JavaScript array (<= i>PluginDefinitions</i>)</li></ul> <p class=3D"MsoNormal"><span style=3D"color:black">As a result, reloading U= I plugin descriptor/configuration data is as simple as refreshing (F5) WebA= dmin application in the browser (no need to restart Engine).<br> <br> <b>3. Added servlet for serving plugin static resources<br> </b><br> <i>PluginResourceServlet</i> is the servlet used to serve UI plugin static = files (plugin host page, 3rd party JavaScript, etc.) from the local file sy= stem.<br> <br> For example, requesting URL:</span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l5 level1 lfo8"> <i><a>http://<EngineManagerHost>:8700/webadmin/webadmin/plugin/foo/co= ntent/start.html</a></i></li></ul> <p><span style=3D"color:black">will send the content of:</span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l1 level1 lfo9"> <i>/usr/share/ovirt-engine/ui-plugins/<resourcePath>/content/start.ht= ml</i></li></ul> <p><span style=3D"color:black">to the client.</span></p> <p><span style=3D"color:black"> </span></p> <p><span style=3D"color:black">As shown in the above example:</span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l10 level1 lfo10"> <i>/webadmin/webadmin/plugin/</i> is the servlet root path for <i>PluginRes= ourceServlet</i></li><li class=3D"MsoNormal" style=3D"color:black;mso-margi= n-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l10 level1 lfo10"> in the extra path beyond the servlet root path (<i>/foo/content/start.html<= /i>):</li></ul> <ul type=3D"disc"> <ul type=3D"circle"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l10 level2 lfo10"> <i>/foo</i> represents the name of the plugin</li><li class=3D"MsoNormal" s= tyle=3D"color:black;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-= list:l10 level2 lfo10"> <i>/content/start.html</i> represents the path to requested resource, relat= ive to "UIPluginDataPath / <resourcePath>"</li></ul> </ul> <p class=3D"MsoNormal"><span style=3D"color:black">Note that each plugin us= ing <i>PluginResourceServlet</i> to serve its static files must declare non= -empty <i>resourcePath</i> attribute in within the plugin descriptor.<br> <br> Also note that <i>PluginResourceServlet</i>, unlike <i>WebadminDynamicHosti= ngServlet</i>, does NOT reload descriptor/configuration data from local fil= e system as part of handling the given request. In other words, it's assume= d that plugin data has already been (re)loaded when serving WebAdmin application host page, with subsequent re= quests to <i>PluginResourceServlet</i> reading the current plugin information.<br> <br> Until we solve the cross-origin issue in a clean way, <i>PluginResourceServ= let</i> should be used to serve all plugin resources from local file system= .<br> <br> <b>4. Plugin lifecycle improved to deal with misbehaving plugins</b><br> <br> <i>PluginState</i> enum has been modified to deal with plugins that allow u= ncaught exceptions to escape from plugin event handler functions (e.g. "UiI= nit"):</span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l6 level1 lfo11"> removed state <i>INITIALIZED</i></li><li class=3D"MsoNormal" style=3D"color= :black;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l6 level= 1 lfo11"> added state <i>INITIALIZING</i>: The plugin is (currently) being initialize= d by calling UiInit event handler function.</li><li class=3D"MsoNormal" sty= le=3D"color:black;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-li= st:l6 level1 lfo11"> added state <i>IN_USE</i>: Plugin's UiInit event handler function has compl= eted successfully, we can now call other event handler functions as necessa= ry. The plugin is in use now.</li><li class=3D"MsoNormal" style=3D"color:bl= ack;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l6 level1 l= fo11"> added state <i>FAILED</i>: An uncaught exception escaped while calling an e= vent handler function, which indicates internal error within the plugin cod= e. The plugin is removed from service.</li></ul> <p class=3D"MsoNormal" style=3D"margin-bottom:12.0pt"><span style=3D"color:= black">I've attached a simple state diagram that illustrates different stat= es and transitions between them (green color is initial state, red color is= end state).<br> <br> Uncaught exceptions in plugin event handler functions will be caught and ha= ndled by the plugin infrastructure. This prevents a misbehaving plugin from= breaking WebAdmin application, since WebAdmin is the caller (initiator) of= the function call. In such case, the plugin will be removed from service.<br> <br> <b>Update on cross-origin issue (consequence of same-origin policy)</b><br> <br> In order for the plugin to access WebAdmin plugin API, plugin host page (e.= g. <i> start.html</i>) must be served from URL on same origin as Engine origin. Ot= herwise, plugin code running in the context of an iframe'd host page will f= ail to evaluate "parent.pluginApi" expression, with "parent" being top-leve= l (WebAdmin) window, and "pluginApi" being the global plugin API object exposed by WebAdmin.<br> <br> This is why <i>PluginResourceServlet</i>, available on Engine origin, shoul= d be used to serve all plugin resources from local file system.<br> <br> There's only one issue that remains to be solved: cross-origin "plugin vs. = remote service" communication, with "remote service" being anything other t= han Engine (REST API). In future, we'll address this with Apache reverse pr= oxy configuration, so that users can configure Apache server (placed in front of Engine JBoss AS) to put ar= bitrary (local or remote non-Engine) services on same origin. However, this= requires a change in current Apache configuration. Until then, users can m= anually edit the Engine Apache configuration file (<i>/etc/httpd/conf.d/ovirt-engine.conf</i>).</span></p> <div class=3D"MsoNormal" style=3D"text-align:center" align=3D"center"><span= style=3D"color:black"> <hr align=3D"center" size=3D"2" width=3D"100%"> </span></div> <p class=3D"MsoNormal" style=3D"margin-bottom:12.0pt"><span style=3D"color:= black"><br> I've attached some sample plugin files for you to experiment with. Instead = of attaching actual patch file (92 kB) to this email, I've submitted the pa= tch to oVirt Gerrit: <a href=3D"http://gerrit.ovirt.org/8120" target=3D"_blank">http://gerrit.ov= irt.org/8120</a><br> <br> Let me know what you think!<br> <br> Cheers,<br> Vojtech</span></p> </div> </div> </blockquote> <blockquote style=3D"margin-top:5.0pt;margin-bottom:5.0pt"> <div> <p class=3D"MsoNormal"><ui-plugin-sample-files.tar.gz></p> </div> </blockquote> <blockquote style=3D"margin-top:5.0pt;margin-bottom:5.0pt"> <div> <p class=3D"MsoNormal"><ui-plugin-lifecycle.png></p> </div> </blockquote> <blockquote style=3D"margin-top:5.0pt;margin-bottom:5.0pt"> <div> <p class=3D"MsoNormal">_______________________________________________<br> Engine-devel mailing list<br> <a href=3D"mailto:Engine-devel@ovirt.org" target=3D"_blank">Engine-devel@ov= irt.org</a><br> <a href=3D"http://lists.ovirt.org/mailman/listinfo/engine-devel" target=3D"= _blank">http://lists.ovirt.org/mailman/listinfo/engine-devel</a></p> </div> </blockquote> </div> </div><br></div></body></html> ------=_Part_3896354_1791016925.1349203611679--
--_000_D290AD8432118048947689BA3AE8A9B3E47C3DSACEXCMBX04PRDhqn_ Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 SGkgVm9qdGVjaCwNCg0KVGhhbmtzIGZvciB0aGUgcmVwbHkuIFRoZSBwbHVnaW4gZnJhbWV3b3Jr IGZvciBhZGRpbmcgYSBjdXN0b20gY29udGV4dCBzZW5zaXRpdmUgYnV0dG9uL21lbnUgaXRlbSBh bmQgdGhlIGlmcmFtZSBsb2FkaW5nIHN1cHBvcnQgZm9yIHRoZSBtYWluIHRhYiBwbHVnaW4gd2ls bCBiZSB3ZWxjb21lIGFkZGl0aW9ucy4NCg0KRm9yIHRoZSBjdXN0b20gVUkgZGlhbG9nLCB3ZeKA mXJlIGxvb2tpbmcgZm9yIHNvbWV0aGluZyB0aGF0IHdvcmtzIHNpbWlsYXIgdG8gdGhlIHRhYiBp biB0aGF0IGl0IHdpbGwgc2hvdyBhIHBhcnRpY3VsYXIgVVJMIGluIGFuIGlGcmFtZSBpbiBhIGRp YWxvZy4gT3IgcG90ZW50aWFsbHkgc2luY2UgaXQgaXMgYSBkaWFsb2csIGl0IGNvdWxkIGp1c3Qg c2hvdyBpdCBpbiBzZXBhcmF0ZSB3aW5kb3cgYWx0b2dldGhlci4gVGhlIGRpYWxvZyB3b3VsZCBi ZSBvcGVuZWQgd2hlbiB0aGUgY29udGV4dCBzZW5zaXRpdmUgYnV0dG9uIG9yIG1lbnUgaXRlbSBp cyBhY3RpdmF0ZWQuIFNvIGl0IHdvdWxkIGJlIG5pY2UgaWYgdGhlIHBsdWdpbiBmcmFtZXdvcmsg d291bGQgYWxsb3cgYSBwbHVnZ2VkIGluIGJ1dHRvbiBkZWZpbml0aW9uIHRvIGRlZmluZSBhIFVS TCB0byBsb2FkIGluIGEgZGlhbG9nIHdoZW4gaXQgaXMgYWN0aXZhdGVkLg0KDQpJ4oCZbGwgc3Rh cnQgbG9va2luZyBhdCBhZGRpbmcgdGhlIGFiaWxpdHkgdG8gbGF1bmNoIGEgZGlhbG9nIHdpdGgg Y29udGV4dCB0aHJvdWdoIHRoZSBwbHVnaW4gQVBJIGFuZCBsZXQgeW91IGtub3cgaG93IHRoYXQg Z29lcyBpbiBhIGZldyBkYXlzIChNYXliZSBzb29uZXIgaWYgSSBoYXZlIHF1ZXN0aW9ucyBhYm91 dCBpdC4gOykNCg0KRmluYWxseSwgd291bGQgaXQgYmUgcG9zc2libGUgdG8gZ2l2ZSBhbiBlc3Rp bWF0ZSBvbiB3aGVuIHlvdSB0aGluayB0aGUgUG9DIHJldiA2IHdpbGwgYmUgYXZhaWxhYmxlPyBX ZeKAmXZlIGdvdCBzY2hlZHVsZWQgZGVsaXZlcmllcyBpbnRlcm5hbGx5IGJhc2VkIG9uIHRoaXMg Y29kZSBhbmQgaXQgd291bGQgYmUgYmV0dGVyIHRvIG1ha2Ugc3VyZSBldmVyeXRoaW5nIGxpbmVz IHVwIG5vdy4NCg0KVGhhbmtzIQ0KDQpDaHJpcw0KDQpGcm9tOiBWb2p0ZWNoIFN6b2NzIFttYWls dG86dnN6b2NzQHJlZGhhdC5jb21dDQpTZW50OiBUdWVzZGF5LCBPY3RvYmVyIDAyLCAyMDEyIDI6 NDcgUE0NClRvOiBNb3JyaXNzZXksIENocmlzdG9waGVyDQpDYzogQ29zdGVhLCBHZW9yZ2U7IFNj aG9lbmJydW4sIER1c3RpbjsgZW5naW5lLWRldmVsQG92aXJ0Lm9yZw0KU3ViamVjdDogUmU6IFtF bmdpbmUtZGV2ZWxdIFVJIFBsdWdpbnM6IFBvQyBwYXRjaCByZXZpc2lvbiA1IGlzIGhlcmUNCg0K SGkgQ2hyaXMsDQoNCm1hbnkgdGhhbmtzIGZvciB5b3VyIGZlZWRiYWNrIGFuZCBzdWdnZXN0aW9u cyA6KQ0KDQpBZGRpbmcgY29udGV4dC1zZW5zaXRpdmUgYnV0dG9uIHdpdGggY29ycmVzcG9uZGlu ZyBtZW51IGl0ZW0gc291bmRzIGdvb2QhIEluIGZhY3QsIHRoaXMgaXMgdGhlIHByb3BlciB3YXkg aG93IGNvbnRleHQgbWVudSBpdGVtcyBzaG91bGQgYmUgaGFuZGxlZCwgc2luY2UgV2ViQWRtaW4g ZGF0YSBncmlkcyB3b3JrIHdpdGggY29udGV4dC1zZW5zaXRpdmUgImFjdGlvbiBidXR0b25zIiB3 aGljaCBhcmUgcmVmbGVjdGVkIHdpdGhpbiB0aGUgY29udGV4dCBtZW51LiBJIGFncmVlIHRoYXQg dGhpcyBpcyBhIHZlcnkgdXNlZnVsIGZlYXR1cmUgdG8gaGF2ZSBpbiBwbHVnaW4gQVBJLCBpdCBz aG91bGQgYmUgaW1wbGVtZW50ZWQgYXMgcGFydCBvZiBuZXh0IG1ham9yIFBvQyByZXZpc2lvbi4N Cg0KSSBoYXZlIGEgcXVlc3Rpb24gdGhvdWdoOiB3aGVuIHRoZSB1c2VyIGNsaWNrcyB0aGUgY3Vz dG9tIGJ1dHRvbiBvciBjb3JyZXNwb25kaW5nIGNvbnRleHQgbWVudSBpdGVtLCB3aWxsIHlvdXIg cGx1Z2luIGhhbmRsZSBjb21tb24gZGlhbG9nIFVJIChldmVyeXRoaW5nIGV4Y2VwdCBhY3R1YWwg Y29udGVudCkgb24gaXRzIG93biwgb3IgZG8geW91IHByZWZlciB0byBoYXZlIHNvbWUga2luZCBv ZiAiZGlhbG9nIFVJIiBBUEkgdG8gY3JlYXRlIHRoZSBzdGFuZGFyZC1sb29raW5nIGRpYWxvZyBm cmFtZSBmb3IgeW91PyBJIGxpa2UgdGhlIGlkZWEgb2YgdXNpbmcgaWZyYW1lIHRvIHByZXNlbnQg Y3VzdG9tIGNvbnRlbnQgdGhvdWdoIDopDQoNCkFzIGZvciBncm91cGluZyBtdWx0aXBsZSBjb250 ZXh0LXNlbnNpdGl2ZSBidXR0b25zIGFuZCBjb3JyZXNwb25kaW5nIGNvbnRleHQgbWVudSBpdGVt cywgdGhpcyBtYWtlcyBzZW5zZSBhbmQgd2UgaGF2ZSBzb21ldGhpbmcgbGlrZSB0aGlzIGFscmVh ZHkgaW1wbGVtZW50ZWQgaW4gV2ViQWRtaW4gKGluIEhvc3QgbWFpbiB0YWIsIFBvd2VyIE1hbmFn ZW1lbnQgZHJvcC1kb3duIGdyb3VwIGJ1dHRvbiwgYnV0IHRoaXMgaXMgZGVmaW5lZCBub3QgdG8g YXBwZWFyIGluIGNvbnRleHQgbWVudSB0aG91Z2gpLiBJIHRoaW5rIHRoaXMgc2hvdWxkIGJlIHBh cnQgb2YgImN1c3RvbSBjb250ZXh0LXNlbnNpdGl2ZSBidXR0b24gLyBtZW51IGl0ZW0iIHBsdWdp biBBUEkgZmVhdHVyZS4NCg0KPiBJZiBuZWVkZWQgd2UgY2FuIGhlbHAgd29yayBvbiBhbiBpbXBs ZW1lbnRhdGlvbiBmb3IgdGhlIGRpYWxvZyBwb3B1cCBwbHVnaW4gZnJhbWV3b3JrIGFzIHdl4oCZ ZCBsaWtlIHRvIGdldCBpdCBpbiByZWxhdGl2ZWx5IHF1aWNrbHkgc28gd2UgY2FuIG1vdmUgZm9y d2FyZCBvbiB0aGUgY29udGVudCBzaWRlIG9mIG91ciBwbHVnaW4uDQoNCklmIEkgdW5kZXJzdGFu ZCBjb3JyZWN0bHksIHRoaXMgaXMgYWJvdXQgcHJvdmlkaW5nICJkaWFsb2cgVUkiIEFQSSB0byBj cmVhdGUgdGhlIHN0YW5kYXJkLWxvb2tpbmcgZGlhbG9nIGZyYW1lICsgY3VzdG9tIGNvbnRlbnQg aWZyYW1lLiBJJ2QgbGlrZSB0byBoZWxwIHdpdGggdGhpcyBhcyB3ZWxsLCAgYnV0IHlvdSBjYW4g cGxheSB3aXRoIHRoZSBjb2RlIGFuZCBwcm9wb3NlIGEgcGF0Y2ggb24gdG9wIG9mIFBvQyByZXYu NSBbaHR0cDovL2dlcnJpdC5vdmlydC5vcmcvODEyMF0uDQoNCj4gRm9yIHRoZSByZXZlcnNlIHBy b3h5LCB3b3VsZCBpdCBiZSBlYXNpZXIgZnJvbSBhIGN1c3RvbWVyIHN0YW5kcG9pbnQgdG8ganVz dCBpbmNsdWRlIGEgcmV2ZXJzZSBwcm94eSBzZXJ2bGV0IHN1Y2ggYXMgdGhpcyBvbmU/DQoNCkFj dHVhbGx5LCBJIHdhcyB1bmRlciB0aGUgaW1wcmVzc2lvbiB0aGF0IG9WaXJ0IEVuZ2luZSAoMy4x KSBwYWNrYWdlIChvdmlydC1lbmdpbmUpIHRha2VzIGNhcmUgb2Ygc2V0dGluZyB1cCBBcGFjaGUg d2ViIHNlcnZlciwgd2hpY2ggcmVkaXJlY3RzIGFsbCB0cmFmZmljIHRvIEVuZ2luZSBKQm9zcyBB UyBieSBkZWZhdWx0IChidXQgbWF5YmUgSSBhbSB3cm9uZyBoZXJlKS4gSG93ZXZlciwgaWYgdGhp cyBpcyB0aGUgY2FzZSwgYW4gZWZmaWNpZW50IHdheSB0byB3b3JrIGFyb3VuZCBzYW1lLW9yaWdp biBwb2xpY3kgKGNyb3NzLW9yaWdpbiBpc3N1ZXMpIGlzIHRvIGNvbmZpZ3VyZSBBcGFjaGUncyBy ZXZlcmVzZSBwcm94eSBtb2R1bGUgKG1vZF9wcm94eSksIGFzIGRpc2N1c3NlZCBpbiBhbm90aGVy IHRocmVhZCBvbiBlbmdpbmUtZGV2ZWw6IGh0dHA6Ly9saXN0cy5vdmlydC5vcmcvcGlwZXJtYWls L2VuZ2luZS1kZXZlbC8yMDEyLVNlcHRlbWJlci8wMDI1MTEuaHRtbA0KDQpUaGlzIHdheSwgeW91 IGNvdWxkIHVzZSBBcGFjaGUgdG8gYnJpbmcgRW5naW5lIGFuZCBhcmJpdHJhcnkgKGxvY2FsIG9y IHJlbW90ZSkgd2ViIHNlcnZpY2VzIG9uIHNhbWUgb3JpZ2luLiBXaGF0IGRvIHlvdSB0aGluaz8N Cg0KT24gdGhlIG90aGVyIGhhbmQsIHVzaW5nIGEgc3BlY2lhbC1wdXJwb3NlIHJldmVyc2UgcHJv eHkgc2VydmxldCBkaXJlY3RseSBpbiBFbmdpbmUsIG5vdCBzdXJlIGlmIHRoYXQncyBhIGdvb2Qg aWRlYSB0aG91Z2guLiAoSSdkIHByZWZlciBjb25maWd1cmluZyAiZnJvbnQtZW5kIiB3ZWIgc2Vy dmVyLCBzdWNoIGFzIEFwYWNoZSwgZm9yIHRoaXMgcHVycG9zZSkNCg0KSSdtIGFsc28gc2VuZGlu ZyBhIGNvdXBsZSBvZiB1cGRhdGVzOg0KDQpVSSBQbHVnaW5zIEZvbGxvdy1VcCBNZWV0aW5nOiBz Y2hlZHVsZWQgZm9yIFR1ZXNkYXksIE9jdG9iZXIgOSBhdCA0cG0gR01UKzEgKEknbGwgc2VuZCBh IG1lZXRpbmcgaW52aXRhdGlvbiBzb29uLCBhbHNvIHBsYW5uaW5nIHRvIHJlLXdyaXRlIG9WaXJ0 IFVJIFBsdWdpbnMgd2lraSBzb29uIGFmdGVyIHRoYXQpDQoNClBvQyByZXYuNSBwYXRjaCB1cGRh dGU6IG1hbnkgdGhhbmtzIHRvIEp1YW4gYW5kIERvcm9uIGZvciByZXZpZXdpbmcgdGhlIHJlY2Vu dCBwYXRjaCBbaHR0cDovL2dlcnJpdC5vdmlydC5vcmcvODEyMF0hIEknbGwgdXBkYXRlIHRoZSBw YXRjaCBhY2NvcmRpbmdseSBhcyByZXZpc2lvbiA1LjENCg0KUGxhbm5lZCBpdGVtcyB0byBiZSBp bmNsdWRlZCBpbiBQb0MgcmV2aXNpb24gNjoNCg0KICAqICAgYWRkaW5nIGN1c3RvbSBjb250ZXh0 LXNlbnNpdGl2ZSBidXR0b24gKGVpdGhlciBzZXBhcmF0ZWx5IG9yIHdpdGhpbiBhIGJ1dHRvbiBn cm91cCksIGFsb25nIHdpdGggY29ycmVzcG9uZGluZyBjb250ZXh0IG1lbnUgaXRlbSByZXByZXNl bnRhdGlvbg0KICAqICAgdXBkYXRlIGN1c3RvbSBtYWluIHRhYiB0byBzaG93IHRoZSBhY3R1YWwg Y29udGVudCAoaWZyYW1lKSBmcm9tIHRoZSBnaXZlbiBVUkwNCiAgKiAgIGFkZGluZyBjdXN0b20g c3ViIHRhYiB0aGF0IHNob3dzIGNvbnRlbnQgZnJvbSB0aGUgZ2l2ZW4gVVJMDQoNCg0KDQpNb3Jl IGl0ZW1zIHRvIGNvbnNpZGVyIGhhdmluZyBpbiBQb0MgcmV2aXNpb24gNjoNCg0KICAqICAgImRp YWxvZyBVSSIgQVBJIHRvIGNyZWF0ZSB0aGUgc3RhbmRhcmQtbG9va2luZyBkaWFsb2cgZnJhbWUg KyBjdXN0b20gY29udGVudCBpZnJhbWUNCiAgKiAgIEVuZ2luZSBSRVNUIEFQSSBleHBvc2VkIHRo cm91Z2ggcGx1Z2luIEFQSQ0KICAqICAgaW50ZWdyYXRpb24gd2l0aCBUYXNrcyBwYW5lIHRvIHBy b3ZpZGUgdmlzdWFsIGZlZWRiYWNrIG9uIGN1c3RvbSBvcGVyYXRpb25zDQogICogICBleHRlbmRp bmcgZXhpc3RpbmcgZGlhbG9ncyAoZS5nLiBFZGl0IENsdXN0ZXIgUG9saWN5IC0gY3VzdG9tIHBy b3BlcnRpZXMpDQoNCg0KDQpMZXQgbWUga25vdyB3aGF0IHlvdSB0aGluay4NCg0KDQpSZWdhcmRz LA0KVm9qdGVjaA0KDQpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fXw0KRnJvbTogIkNo cmlzdG9waGVyIE1vcnJpc3NleSIgPENocmlzdG9waGVyLk1vcnJpc3NleUBuZXRhcHAuY29tPg0K VG86IHZzem9jc0ByZWRoYXQuY29tDQpDYzogIkdlb3JnZSBDb3N0ZWEiIDxHZW9yZ2UuQ29zdGVh QG5ldGFwcC5jb20+LCAiRHVzdGluIFNjaG9lbmJydW4iIDxEdXN0aW4uU2Nob2VuYnJ1bkBuZXRh cHAuY29tPiwgZW5naW5lLWRldmVsQG92aXJ0Lm9yZw0KU2VudDogVHVlc2RheSwgT2N0b2JlciAy LCAyMDEyIDY6MTU6MzQgUE0NClN1YmplY3Q6IFJFOiBbRW5naW5lLWRldmVsXSBVSSBQbHVnaW5z OiBQb0MgcGF0Y2ggcmV2aXNpb24gNSBpcyBoZXJlDQpIaSBWb2p0ZWNoLA0KDQpUaGUgcGF0Y2gg aXMgZ3JlYXQgYW5kIGhhcyBjbGVhcmVkIHVwIHNvbWUgcXVlc3Rpb25zIEkgaGFkIGFib3V0IHRo ZSBpbXBsZW1lbnRhdGlvbi4gSeKAmXZlIGJlZW4gYWJsZSB0byBnZXQgdGhlIHNhbXBsZSBwbHVn aW5zIHdvcmtpbmcgYW5kIHdhZGVkIHRocm91Z2ggdGhlIGNvZGUgY2hhbmdlcywgc28gZmVlbCBs aWtlIEkgaGF2ZSBhIGdvb2QgdW5kZXJzdGFuZGluZyBvZiB3aGF0IHdhcyBkZWxpdmVyZWQuIFRo YW5rcyBhIGxvdCBmb3IgcHV0dGluZyB0aGlzIGFsbCB0b2dldGhlci4gSSBkbyBoYXZlIGEgZmV3 IHF1ZXN0aW9ucyBhbmQgc3VnZ2VzdGlvbnMgZm9yIHlvdSwgdGhvdWdoLg0KDQpXaWxsIHRoZXJl IGV2ZW50dWFsbHkgYmUgYSB3YXkgdG8gYWRkIG9uZSBvciBtb3JlIGJ1dHRvbnMgdG8gdGhlIGNv bnRleHQgc2Vuc2l0aXZlIGJ1dHRvbnMgYW5kIG1lbnVzIHRocm91Z2hvdXQgdGhlIGludGVyZmFj ZT8gRm9yIGV4YW1wbGUsIHdl4oCZZCBsaWtlIHRvIGFsbG93IGEgYnV0dG9uIHRvIHByb3Zpc2lv biBhIGRhdGFzdG9yZSB3aGVuIGEgZGF0YSBjZW50ZXIsIGNsdXN0ZXIsIG9yIGhvc3QgaXMgc2Vs ZWN0ZWQuIFdoZW4gdGhlIGJ1dHRvbiBpcyBjbGlja2VkLCBpdCB3b3VsZCBvcGVuIGEgZGlhbG9n IHdpdGggYW4gaWZyYW1lIGluIHdoaWNoIHdlIHdvdWxkIGxvYWQgb3VyIGludGVyZmFjZSB0byBw ZXJmb3JtIHRoZSBhc3NvY2lhdGVkIGFjdGlvbi4gU29tZSBjb250ZXh0cyB3b3VsZCBoYXZlIHNl dmVyYWwgYnV0dG9ucywgc3VjaCBhcyBhIHN0b3JhZ2UgZG9tYWluIChwcm92aXNpb24sIHJlc2l6 ZSwgZGVkdXBlIG1hbmFnZW1lbnQsIGRlc3Ryb3kpIHNvIGl0IHdvdWxkIHByb2JhYmx5IG1ha2Ug c2Vuc2UgZm9yIGEgZHJvcCBkb3duIG1lbnUgdG8gYmUgYXZhaWxhYmxlIGFzIHdlbGwgc28gdGhh dCB0aGUgbnVtYmVyIG9mIGJ1dHRvbnMgYWJvdmUgdGhlIHRhYmxlIGRvZXNu4oCZdCBnZXQgdG9v IGNsdXR0ZXJlZC4gV2XigJlkIGFsc28gbGlrZSB0byBhZGQgdGhlc2Ugc2FtZSBhY3Rpb25zIHRv IHRoZSBtZW51cyB0aGF0IHBvcHVwIHdoZW4gYSBjb250ZXh0dWFsIG9iamVjdCBpcyByaWdodCBj bGlja2VkLg0KDQpJZiBuZWVkZWQgd2UgY2FuIGhlbHAgd29yayBvbiBhbiBpbXBsZW1lbnRhdGlv biBmb3IgdGhlIGRpYWxvZyBwb3B1cCBwbHVnaW4gZnJhbWV3b3JrIGFzIHdl4oCZZCBsaWtlIHRv IGdldCBpdCBpbiByZWxhdGl2ZWx5IHF1aWNrbHkgc28gd2UgY2FuIG1vdmUgZm9yd2FyZCBvbiB0 aGUgY29udGVudCBzaWRlIG9mIG91ciBwbHVnaW4uDQoNCkZvciB0aGUgcmV2ZXJzZSBwcm94eSwg d291bGQgaXQgYmUgZWFzaWVyIGZyb20gYSBjdXN0b21lciBzdGFuZHBvaW50IHRvIGp1c3QgaW5j bHVkZSBhIHJldmVyc2UgcHJveHkgc2VydmxldCBzdWNoIGFzIHRoaXMgb25lPyAgaHR0cDovL3Nv dXJjZWZvcmdlLm5ldC9wcm9qZWN0cy9qMmVwLw0KSeKAmW0ganVzdCB0aGlua2luZyB0aGF0IHNl dHRpbmcgdXAgYW5kIG1hbmFnaW5nIGEgcGx1Z2luIGZvciB0aGUgSFRUUCBzZXJ2ZXIgbWF5IGJl IG1vcmUgY29tcGxleCB0aGFuIGluY2x1ZGluZyBvbmUgaW50ZXJuYWxseSB0aGF0IHdvdWxkIGJl IHRyYW5zcGFyZW50IHRvIGEgY3VzdG9tZXIuDQoNClRoYW5rcywNCkNocmlzDQpGcm9tOiBWb2p0 ZWNoIFN6b2NzIDx2c3pvY3NAcmVkaGF0LmNvbTxtYWlsdG86dnN6b2NzQHJlZGhhdC5jb20+Pg0K RGF0ZTogU2VwdGVtYmVyIDIxLCAyMDEyIDQ6Mzc6MzEgUE0gRURUDQpUbzogZW5naW5lLWRldmVs IDxlbmdpbmUtZGV2ZWxAb3ZpcnQub3JnPG1haWx0bzplbmdpbmUtZGV2ZWxAb3ZpcnQub3JnPj4N ClN1YmplY3Q6IFtFbmdpbmUtZGV2ZWxdIFVJIFBsdWdpbnM6IFBvQyBwYXRjaCByZXZpc2lvbiA1 IGlzIGhlcmUNCkhpIGd1eXMsDQoNCml0J3MgYmVlbiBhIHdoaWxlIGJ1dCBoZXJlIGNvbWVzIHRo ZSBsYXRlc3QgcmV2aXNpb24gb2YgVUkgUGx1Z2lucyBwcm9vZi1vZi1jb25jZXB0IHBhdGNoIChw bGVhc2UgZmluZCBpdCBhdHRhY2hlZCkuDQoNClRoaXMgcmV2aXNpb24gd2FzIG9yaWdpbmFsbHkg bWVhbnQgdG8gZm9jdXMgc29sZWx5IG9uIHNlcnZlci1zaWRlIGNvbXBvbmVudHMgb2YgdGhlIHBs dWdpbiBpbmZyYXN0cnVjdHVyZS4gSG93ZXZlciwgSSBlbmRlZCB1cCBpbXBsZW1lbnRpbmcgYWxs IHRoZSBtYWpvciBjb25jZXB0cyBhbmQgaWRlYXMgYXMgZGlzY3Vzc2VkIG9uIGVuZ2luZS1kZXZl bCBtYWlsaW5nIGxpc3QsIGltcGFjdGluZyBib3RoIGNsaWVudC1zaWRlIGFuZCBzZXJ2ZXItc2lk ZSBwYXJ0cyBvZiB0aGUgcGx1Z2luIGluZnJhc3RydWN0dXJlLiBBcyBhIHJlc3VsdCwgVUkgcGx1 Z2luIGluZnJhc3RydWN0dXJlIHNob3VsZCBiZSBwcmV0dHkgbXVjaCBjb21wbGV0ZSBub3csIHNv IHdlIGNhbiBmb2N1cyBvbiBzcGVjaWZpYyBwbHVnaW4gQVBJIGZlYXR1cmVzIGluIHVwY29taW5n IFBvQyByZXZpc2lvbnMuDQoNClRoZXJlJ3MgYSB3aG9sZSBidW5jaCBvZiBjaGFuZ2VzIGFuZCBp bXByb3ZlbWVudHMgaW4gdGhpcyByZXZpc2lvbiwgc28gSSdsbCB0cnkgdG8gY292ZXIgYWxsIHRo ZSByZWxldmFudCBwYXJ0cyBzdGVwIGJ5IHN0ZXAuIElmIHlvdSBoYXZlIGFueSBjb21tZW50cywg cXVlc3Rpb25zIG9yIGlkZWFzLCBwbGVhc2UgbGV0IG1lIGtub3chDQoNClNvIGhlcmUgd2UgZ28u Li4gKG9yIGlmIHlvdSBqdXN0IHdhbnQgdG8gZ2V0IHRoZSBwYXRjaCwgZmluZCB0aGUgbGluayBh dCB0aGUgZW5kIG9mIHRoaXMgbWVzc2FnZSkNCl9fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fDQoNCjAuIEFkZGVkIG5ldyBFbmdpbmUgY29uZmlndXJhdGlvbiB2YWx1ZXMNCg0KVUkgcGx1 Z2luIGRhdGEgcGF0aCBpcyByZXByZXNlbnRlZCBieSBDb25maWdWYWx1ZXMuVUlQbHVnaW5EYXRh UGF0aCBlbnVtIG9wdGlvbiAoIlVJUGx1Z2luRGF0YVBhdGgiIGluIHZkY19vcHRpb25zIHRhYmxl KSwgYW5kIHJlc29sdmVkIHJlbGF0aXZlIHRvIENvbmZpZ1ZhbHVlcy5EYXRhRGlyIGlmIHBvc3Np YmxlLiBGb2xsb3dpbmcgKGRlZmF1bHQpIHZhbHVlczoNCg0KICAqICAgVUlQbHVnaW5EYXRhUGF0 aCA9IHVpLXBsdWdpbnMNCiAgKiAgIERhdGFEaXIgPSAvdXNyL3NoYXJlL292aXJ0LWVuZ2luZQ0K cmVzdWx0IGluIFVJIHBsdWdpbiBkYXRhIHBhdGg6IC91c3Ivc2hhcmUvb3ZpcnQtZW5naW5lL3Vp LXBsdWdpbnMNCg0KVUkgcGx1Z2luIGNvbmZpZyBwYXRoIGlzIHJlcHJlc2VudGVkIGJ5IENvbmZp Z1ZhbHVlcy5VSVBsdWdpbkNvbmZpZ1BhdGggZW51bSBvcHRpb24gKCJVSVBsdWdpbkNvbmZpZ1Bh dGgiIGluIHZkY19vcHRpb25zIHRhYmxlKSwgYW5kIHJlc29sdmVkIHJlbGF0aXZlIHRvIENvbmZp Z1ZhbHVlcy5Db25maWdEaXIgaWYgcG9zc2libGUuIEZvbGxvd2luZyAoZGVmYXVsdCkgdmFsdWVz Og0KDQogICogICBVSVBsdWdpbkNvbmZpZ1BhdGggPSB1aS1wbHVnaW5zDQogICogICBDb25maWdE aXIgPSAvZXRjL292aXJ0LWVuZ2luZQ0KDQpyZXN1bHQgaW4gVUkgcGx1Z2luIGNvbmZpZyBwYXRo OiAvZXRjL292aXJ0LWVuZ2luZS91aS1wbHVnaW5zDQoNCjEuIFByb2Nlc3NpbmcgVUkgcGx1Z2lu IGRhdGEgb24gdGhlIHNlcnZlcg0KDQpQbHVnaW5EYXRhTWFuYWdlciBpcyB0aGUgY2xhc3MgcmVz cG9uc2libGUgZm9yIHJlYWRpbmcsIHZhbGlkYXRpbmcgYW5kIGNhY2hpbmcgVUkgcGx1Z2luIGRl c2NyaXB0b3IvY29uZmlndXJhdGlvbiBkYXRhIG9uIHRoZSBzZXJ2ZXIgKEVuZ2luZSkuIEl0IGhh cyB0d28gbWFpbiByZXNwb25zaWJpbGl0aWVzOg0KDQogICogICByZXR1cm4gYSBzbmFwc2hvdCBv ZiBjdXJyZW50bHkgdmFsaWQgcGx1Z2luIGRhdGEgKGdldEN1cnJlbnREYXRhIG1ldGhvZCkNCiAg KiAgIHJlbG9hZCBwbHVnaW4gZGF0YSBmcm9tIGxvY2FsIGZpbGUgc3lzdGVtIGlmIG5lY2Vzc2Fy eSAocmVsb2FkRGF0YSBtZXRob2QpDQoNClRoZSByZWxvYWREYXRhIG1ldGhvZCBkb2Vzbid0IG1v ZGlmeSAibGl2ZSIgcGx1Z2luIGRhdGEgZGlyZWN0bHkuIEluc3RlYWQsIGl0IGNyZWF0ZXMgYSBs b2NhbCB3b3JraW5nIGNvcHkgb2YgY3VycmVudCBwbHVnaW4gZGF0YSwgdXBkYXRlcyB0aGlzIGNv cHkgYXMgaXQgcmVhZHMvdmFsaWRhdGVzIHBsdWdpbiBkZXNjcmlwdG9yIGFuZCBjb25maWd1cmF0 aW9uIGZpbGVzLCBhbmQgYXR0ZW1wdHMgdG8gdXBkYXRlICJsaXZlIiBwbHVnaW4gZGF0YSB0aHJv dWdoIGNvbmRpdGlvbmFsIHJlZmVyZW5jZSByZS1hc3NpZ25tZW50ICh1c2luZyBqYXZhLnV0aWwu Y29uY3VycmVudC5hdG9taWMuQXRvbWljUmVmZXJlbmNlLmNvbXBhcmVBbmRTZXQgbWV0aG9kKS4N Cg0KDQoNCkluIG90aGVyIHdvcmRzLCByZWxvYWREYXRhIG1ldGhvZCBtYWtlcyBubyBhdHRlbXB0 cyB3aXRoIHJlZ2FyZCB0byBKYXZhIGxvY2stYmFzZWQgc3luY2hyb25pemF0aW9uLCBpbiBmYXZv ciBvZiBkZWFsaW5nIHdpdGggImxpdmUiIGRhdGEgdGhyb3VnaCBBdG9taWNSZWZlcmVuY2UgKHJl ZmVyZW5jZSB0aGF0IGludm9sdmVzIGF0b21pYyB2b2xhdGlsZSByZWFkcyBhbmQgd3JpdGVzKToN Cg0KICAqICAgSW4gdGhlIGJlc3QgY2FzZSwgYSB0aHJlYWQgd2lsbCBzdWNjZWVkIGluIHVwZGF0 aW5nICJsaXZlIiBkYXRhIChBdG9taWNSZWZlcmVuY2UuY29tcGFyZUFuZFNldCA9PSB0cnVlKSwg d2hpY2ggbWVhbnMgdGhhdCAibGl2ZSIgZGF0YSByZW1haW5lZCB1bmNoYW5nZWQgc2luY2UgdGhp cyB0aHJlYWQgYWNxdWlyZWQgYSByZWZlcmVuY2Ugb2YgY3VycmVudCBwbHVnaW4gZGF0YS4NCiAg KiAgIEluIHRoZSB3b3JzdCBjYXNlLCBhIHRocmVhZCB3aWxsIE5PVCBzdWNjZWVkIGluIHVwZGF0 aW5nICJsaXZlIiBkYXRhIChBdG9taWNSZWZlcmVuY2UuY29tcGFyZUFuZFNldCA9PSBmYWxzZSks IHdoaWNoIG1lYW5zIHRoYXQgImxpdmUiIGRhdGEgd2FzIGFscmVhZHkgY2hhbmdlZCBieSBhbm90 aGVyIHRocmVhZCBzaW5jZSB0aGlzIHRocmVhZCBhY3F1aXJlZCBhIHJlZmVyZW5jZSBvZiBjdXJy ZW50IHBsdWdpbiBkYXRhLg0KDQpJbiBteSBvcGluaW9uLCB3aGVuIGRlYWxpbmcgd2l0aCBleHRl cm5hbCByZXNvdXJjZXMgbGlrZSB0aGUgbG9jYWwgZmlsZSBzeXN0ZW0sIHRoaXMgaXMgYSBnb29k IGNvbXByb21pc2UgYmV0d2VlbiBwZXJmb3JtYW5jZSBhbmQgdXAtdG8tZGF0ZSBkYXRhLiBXaGls ZSB3ZSBtaWdodCBub3QgZ2V0ICJjb21wbGV0ZWx5LXVwLXRvLWRhdGUiIGRhdGEgYXQgdGhlIGdp dmVuIHBvaW50IGluIHRpbWUgKHJlbG9hZERhdGEgKyBnZXRDdXJyZW50RGF0YSksIHdlIGFyZSBn dWFyYW50ZWVkIHRvIGdldCAicmVjZW50bHktdXAtdG8tZGF0ZSIgYW5kIGNvbnNpc3RlbnQgZGF0 YS4gSW4gb3RoZXIgd29yZHMsIHRoZSByZXF1aXJlbWVudCBvZiAiY29tcGxldGVseS11cC10by1k YXRlIiBkYXRhIHdvdWxkIGludm9sdmUgc3luY2hyb25pemVkIHN0YXRlbWVudHMgdGhhdCB3b3Vs ZCBodXJ0IHBlcmZvcm1hbmNlLiBJbiBteSAodmVyeSBodW1ibGUpIG9waW5pb24sIHRoZSBiZW5l Zml0IG9mIGhhdmluZyAiY29tcGxldGVseS11cC10by1kYXRlIiBkYXRhLCBhdCB0aGUgY29zdCBv ZiByZWR1Y2VkIHBlcmZvcm1hbmNlLCBpcyBub3QgcmVhbGx5IHdvcnRoIGl0LCBlc3BlY2lhbGx5 IGluIG91ciBjYXNlIHdoZW4gdGhlIHVzZXIgY2FuIGp1c3QgaGl0IHJlZnJlc2ggKEY1KSB0byBy ZWxvYWQgV2ViQWRtaW4gYW5kIGl0cyBwbHVnaW4gZGF0YS4NCg0KDQoNClBsdWdpbiBkZXNjcmlw dG9yIGZpbGVzIGFyZSBleHBlY3RlZCB0byBiZSBwbGFjZWQgaW4gVUkgcGx1Z2luIGRhdGEgcGF0 aCwgZm9yIGV4YW1wbGU6IC91c3Ivc2hhcmUvb3ZpcnQtZW5naW5lL3VpLXBsdWdpbnMvZm9vLmpz b24NCg0KDQoNCkZvbGxvd2luZyBkZXNjcmlwdG9yIGZpbGUgYXR0cmlidXRlcyBhcmUgaW1wbGVt ZW50ZWQgYW5kIHJlY29nbml6ZWQgYnkgdGhlIHBsdWdpbiBpbmZyYXN0cnVjdHVyZToNCg0KICAq ICAgbmFtZTogQSBuYW1lIHRoYXQgdW5pcXVlbHkgaWRlbnRpZmllcyB0aGUgcGx1Z2luIChyZXF1 aXJlZCBhdHRyaWJ1dGUpLg0KICAqICAgdXJsOiBVUkwgb2YgcGx1Z2luIGhvc3QgcGFnZSB0aGF0 IGludm9rZXMgdGhlIHBsdWdpbiBjb2RlIChyZXF1aXJlZCBhdHRyaWJ1dGUpLg0KICAqICAgY29u ZmlnOiBEZWZhdWx0IGNvbmZpZ3VyYXRpb24gb2JqZWN0IGFzc29jaWF0ZWQgd2l0aCB0aGUgcGx1 Z2luIChvcHRpb25hbCBhdHRyaWJ1dGUpLg0KICAqICAgcmVzb3VyY2VQYXRoOiBQYXRoIHRvIHBs dWdpbiBzdGF0aWMgcmVzb3VyY2VzLCByZWxhdGl2ZSB0byBVSSBwbHVnaW4gZGF0YSBwYXRoIChv cHRpb25hbCBhdHRyaWJ1dGUpLiBUaGlzIGlzIHVzZWQgd2hlbiBzZXJ2aW5nIHBsdWdpbiBmaWxl cyB0aHJvdWdoIEVuZ2luZSBQbHVnaW5SZXNvdXJjZVNlcnZsZXQgKG1vcmUgb24gdGhpcyBiZWxv dykuDQoNClBsdWdpbiBjb25maWd1cmF0aW9uIGZpbGVzIGFyZSBleHBlY3RlZCB0byBiZSBwbGFj ZWQgaW4gVUkgcGx1Z2luIGNvbmZpZyBwYXRoLCBmb3IgZXhhbXBsZTogL2V0Yy9lbmdpbmUvdWkt cGx1Z2lucy9mb28tY29uZmlnLmpzb24NCg0KDQoNCk5vdGUgdGhhdCBwbHVnaW4gY29uZmlndXJh dGlvbiBmaWxlcyBmb2xsb3cgdGhlICI8ZGVzY3JpcHRvckZpbGVOYW1lPi1jb25maWcuanNvbiIg Y29udmVudGlvbi4NCg0KDQoNCkZvbGxvd2luZyBjb25maWd1cmF0aW9uIGZpbGUgYXR0cmlidXRl cyBhcmUgaW1wbGVtZW50ZWQgYW5kIHJlY29nbml6ZWQgYnkgdGhlIHBsdWdpbiBpbmZyYXN0cnVj dHVyZToNCg0KICAqICAgY29uZmlnOiBDdXN0b20gY29uZmlndXJhdGlvbiBvYmplY3QgYXNzb2Np YXRlZCB3aXRoIHRoZSBwbHVnaW4gKG9wdGlvbmFsIGF0dHJpYnV0ZSkuIFRoaXMgb3ZlcnJpZGVz IHRoZSBkZWZhdWx0IHBsdWdpbiBkZXNjcmlwdG9yIGNvbmZpZ3VyYXRpb24sIGlmIGFueS4NCiAg KiAgIGVuYWJsZWQ6IEluZGljYXRlcyB3aGV0aGVyIHRoZSBwbHVnaW4gc2hvdWxkIGJlIGxvYWRl ZCBvbiBXZWJBZG1pbiBzdGFydHVwIChvcHRpb25hbCBhdHRyaWJ1dGUpLiBEZWZhdWx0IHZhbHVl IGlzICd0cnVlJy4NCiAgKiAgIG9yZGVyOiBEZWZpbmVzIHRoZSByZWxhdGl2ZSBvcmRlciBpbiB3 aGljaCB0aGUgcGx1Z2luIHdpbGwgYmUgbG9hZGVkIG9uIFdlYkFkbWluIHN0YXJ0dXAgKG9wdGlv bmFsIGF0dHJpYnV0ZSkuIERlZmF1bHQgdmFsdWUgaXMgSW50ZWdlci5NQVhfVkFMVUUgKGxvd2Vz dCBvcmRlcikuDQoNClRoZSBjb25jZXB0IG9mIG1lcmdpbmcgY3VzdG9tIGNvbmZpZ3VyYXRpb24g KGNvbmZpZyBhdHRyaWJ1dGUgaW4gZm9vLWNvbmZpZy5qc29uKSwgaWYgYW55LCBvbiB0b3Agb2Yg ZGVmYXVsdCBjb25maWd1cmF0aW9uIChjb25maWcgYXR0cmlidXRlIGluIGZvby5qc29uKSwgaWYg YW55LCByZW1haW5zIHVuY2hhbmdlZC4gVGhpcyBtYWtlcyB0aGUgcGx1Z2luIGNvbmZpZ3VyYXRp b24gcXVpdGUgZmxleGlibGUgLSBpbiBteSBvcGluaW9uLCB0aGUgYWRkZWQgY29tcGxleGl0eSBv ZiBoYW5kbGluZy9tZXJnaW5nIHN1Y2ggY29uZmlndXJhdGlvbiBpcyBkZWZpbml0ZWx5IHdvcnRo IHRoZSBlZmZvcnQuDQoNCg0KDQpUaGUgZW5hYmxlZCBhdHRyaWJ1dGUgaXMgc3RyYWlnaHQtZm9y d2FyZCwgYWxsb3dpbmcgdXNlcnMgdG8gdHVybiB0aGUgZ2l2ZW4gcGx1Z2luIG9mZiwgaWYgbmVj ZXNzYXJ5LiBJbiBmdXR1cmUsIHVzZXJzIHNob3VsZCBzdGlsbCBiZSBhYmxlIHRvIGxvYWQgc3Vj aCBwbHVnaW5zIHRocm91Z2ggV2ViQWRtaW4gR1VJLg0KDQoNCg0KVGhlIG9yZGVyIGF0dHJpYnV0 ZSBjb250cm9scyB0aGUgb3JkZXIgaW4gd2hpY2ggcGx1Z2lucyBhcmUgbG9hZGVkIG9uIFdlYkFk bWluIHN0YXJ0dXAuIFNpbmNlIHBsdWdpbiByZXNvdXJjZXMgYXJlIGZldGNoZWQgYXN5bmNocm9u b3VzbHkgYnkgdGhlIGJyb3dzZXIsIHRoaXMgaXMgYmFzaWNhbGx5IGEgd2F5IG9mIGltcG9zaW5n IHNvbWUgZGVncmVlIG9mIGRldGVybWluaXNtIGluIHRoZSAiZ2VuZXJhbGx5LW5vbi1kZXRlcm1p bmlzdGljIiBwbHVnaW4gZW52aXJvbm1lbnQsIHdoaWNoIGlzIGhlbHBmdWwgd2hlbiB0cm91Ymxl c2hvb3RpbmcgcHJvYmxlbXMgd2l0aCBtdWx0aXBsZSBwbHVnaW5zLiBUaGlzIGF0dHJpYnV0ZSBp cyBhbHNvIGhlbHBmdWwgZHVlIHRvIGZpbGUgbGlzdGluZyBtZXRob2RzIGluIGphdmEuaW8uRmls ZSBnaXZpbmcgbm8gZ3VhcmFudGVlcyB0aGF0IGZpbGVzIHdvdWxkIGJlIGxpc3RlZCBpbiBhbnkg cGFydGljdWxhciBvcmRlciAob3RoZXJ3aXNlIHdlIGNvdWxkIGp1c3QgZ28gZm9yIHRoZSAiTk4t PGRlc2NyaXB0b3JGaWxlTmFtZT4uanNvbiIgY29udmVudGlvbiwgd2l0aCBOTiBiZWluZyB0aGUg b3JkZXIgbnVtYmVyKS4NCg0KMi4gTW9kaWZpZWQgYmVoYXZpb3Igb2YgV2ViYWRtaW5EeW5hbWlj SG9zdGluZ1NlcnZsZXQNCg0KV2ViYWRtaW5EeW5hbWljSG9zdGluZ1NlcnZsZXQgaXMgdGhlIHNl cnZsZXQgdXNlZCB0byBzZXJ2ZSBXZWJBZG1pbiBhcHBsaWNhdGlvbiBob3N0IHBhZ2UgKEhUTUwg cGFnZSB0aGF0IGJvb3RzdHJhcHMgV2ViQWRtaW4gSmF2YVNjcmlwdCBjb2RlKS4NCg0KSW4gYWRk aXRpb24gdG8gaXRzIGZvcm1lciBiZWhhdmlvciwgYXMgcGFydCBvZiBoYW5kbGluZyB0aGUgZ2l2 ZW4gcmVxdWVzdCwgV2ViYWRtaW5EeW5hbWljSG9zdGluZ1NlcnZsZXQ6DQoNCiAgKiAgIHJlbG9h ZHMgZGVzY3JpcHRvci9jb25maWd1cmF0aW9uIGRhdGEgZnJvbSBsb2NhbCBmaWxlIHN5c3RlbSBp ZiBuZWNlc3NhcnksIGFuZCBvYnRhaW5zIGEgc25hcHNob3Qgb2YgY3VycmVudGx5IHZhbGlkIHBs dWdpbiBkYXRhIChQbHVnaW5EYXRhTWFuYWdlci5yZWxvYWRBbmRHZXRDdXJyZW50RGF0YSkNCiAg KiAgIGVtYmVkcyBhbGwgcGx1Z2luIG1ldGEtZGF0YSwgc3VpdGFibGUgZm9yIHVzZSBpbiBjbGll bnQtc2lkZSBwbHVnaW4gaW5mcmFzdHJ1Y3R1cmUsIGludG8gV2ViQWRtaW4gaG9zdCBwYWdlIGFz ICJwbHVnaW5EZWZpbml0aW9ucyIgSmF2YVNjcmlwdCBhcnJheSAoUGx1Z2luRGVmaW5pdGlvbnMp DQpBcyBhIHJlc3VsdCwgcmVsb2FkaW5nIFVJIHBsdWdpbiBkZXNjcmlwdG9yL2NvbmZpZ3VyYXRp b24gZGF0YSBpcyBhcyBzaW1wbGUgYXMgcmVmcmVzaGluZyAoRjUpIFdlYkFkbWluIGFwcGxpY2F0 aW9uIGluIHRoZSBicm93c2VyIChubyBuZWVkIHRvIHJlc3RhcnQgRW5naW5lKS4NCg0KMy4gQWRk ZWQgc2VydmxldCBmb3Igc2VydmluZyBwbHVnaW4gc3RhdGljIHJlc291cmNlcw0KDQpQbHVnaW5S ZXNvdXJjZVNlcnZsZXQgaXMgdGhlIHNlcnZsZXQgdXNlZCB0byBzZXJ2ZSBVSSBwbHVnaW4gc3Rh dGljIGZpbGVzIChwbHVnaW4gaG9zdCBwYWdlLCAzcmQgcGFydHkgSmF2YVNjcmlwdCwgZXRjLikg ZnJvbSB0aGUgbG9jYWwgZmlsZSBzeXN0ZW0uDQoNCkZvciBleGFtcGxlLCByZXF1ZXN0aW5nIFVS TDoNCg0KICAqICAgaHR0cDovLzxFbmdpbmVNYW5hZ2VySG9zdD46ODcwMC93ZWJhZG1pbi93ZWJh ZG1pbi9wbHVnaW4vZm9vL2NvbnRlbnQvc3RhcnQuaHRtbDxodHRwOi8vJTNjRW5naW5lTWFuYWdl ckhvc3QlM2U6ODcwMC93ZWJhZG1pbi93ZWJhZG1pbi9wbHVnaW4vZm9vL2NvbnRlbnQvc3RhcnQu aHRtbD4NCg0Kd2lsbCBzZW5kIHRoZSBjb250ZW50IG9mOg0KDQogICogICAvdXNyL3NoYXJlL292 aXJ0LWVuZ2luZS91aS1wbHVnaW5zLzxyZXNvdXJjZVBhdGg+L2NvbnRlbnQvc3RhcnQuaHRtbA0K DQp0byB0aGUgY2xpZW50Lg0KDQoNCg0KQXMgc2hvd24gaW4gdGhlIGFib3ZlIGV4YW1wbGU6DQoN CiAgKiAgIC93ZWJhZG1pbi93ZWJhZG1pbi9wbHVnaW4vIGlzIHRoZSBzZXJ2bGV0IHJvb3QgcGF0 aCBmb3IgUGx1Z2luUmVzb3VyY2VTZXJ2bGV0DQogICogICBpbiB0aGUgZXh0cmEgcGF0aCBiZXlv bmQgdGhlIHNlcnZsZXQgcm9vdCBwYXRoICgvZm9vL2NvbnRlbnQvc3RhcnQuaHRtbCk6DQoNCiAg ICAgKiAgIC9mb28gcmVwcmVzZW50cyB0aGUgbmFtZSBvZiB0aGUgcGx1Z2luDQogICAgICogICAv Y29udGVudC9zdGFydC5odG1sIHJlcHJlc2VudHMgdGhlIHBhdGggdG8gcmVxdWVzdGVkIHJlc291 cmNlLCByZWxhdGl2ZSB0byAiVUlQbHVnaW5EYXRhUGF0aCAvIDxyZXNvdXJjZVBhdGg+Ig0KTm90 ZSB0aGF0IGVhY2ggcGx1Z2luIHVzaW5nIFBsdWdpblJlc291cmNlU2VydmxldCB0byBzZXJ2ZSBp dHMgc3RhdGljIGZpbGVzIG11c3QgZGVjbGFyZSBub24tZW1wdHkgcmVzb3VyY2VQYXRoIGF0dHJp YnV0ZSBpbiB3aXRoaW4gdGhlIHBsdWdpbiBkZXNjcmlwdG9yLg0KDQpBbHNvIG5vdGUgdGhhdCBQ bHVnaW5SZXNvdXJjZVNlcnZsZXQsIHVubGlrZSBXZWJhZG1pbkR5bmFtaWNIb3N0aW5nU2Vydmxl dCwgZG9lcyBOT1QgcmVsb2FkIGRlc2NyaXB0b3IvY29uZmlndXJhdGlvbiBkYXRhIGZyb20gbG9j YWwgZmlsZSBzeXN0ZW0gYXMgcGFydCBvZiBoYW5kbGluZyB0aGUgZ2l2ZW4gcmVxdWVzdC4gSW4g b3RoZXIgd29yZHMsIGl0J3MgYXNzdW1lZCB0aGF0IHBsdWdpbiBkYXRhIGhhcyBhbHJlYWR5IGJl ZW4gKHJlKWxvYWRlZCB3aGVuIHNlcnZpbmcgV2ViQWRtaW4gYXBwbGljYXRpb24gaG9zdCBwYWdl LCB3aXRoIHN1YnNlcXVlbnQgcmVxdWVzdHMgdG8gUGx1Z2luUmVzb3VyY2VTZXJ2bGV0IHJlYWRp bmcgdGhlIGN1cnJlbnQgcGx1Z2luIGluZm9ybWF0aW9uLg0KDQpVbnRpbCB3ZSBzb2x2ZSB0aGUg Y3Jvc3Mtb3JpZ2luIGlzc3VlIGluIGEgY2xlYW4gd2F5LCBQbHVnaW5SZXNvdXJjZVNlcnZsZXQg c2hvdWxkIGJlIHVzZWQgdG8gc2VydmUgYWxsIHBsdWdpbiByZXNvdXJjZXMgZnJvbSBsb2NhbCBm aWxlIHN5c3RlbS4NCg0KNC4gUGx1Z2luIGxpZmVjeWNsZSBpbXByb3ZlZCB0byBkZWFsIHdpdGgg bWlzYmVoYXZpbmcgcGx1Z2lucw0KDQpQbHVnaW5TdGF0ZSBlbnVtIGhhcyBiZWVuIG1vZGlmaWVk IHRvIGRlYWwgd2l0aCBwbHVnaW5zIHRoYXQgYWxsb3cgdW5jYXVnaHQgZXhjZXB0aW9ucyB0byBl c2NhcGUgZnJvbSBwbHVnaW4gZXZlbnQgaGFuZGxlciBmdW5jdGlvbnMgKGUuZy4gIlVpSW5pdCIp Og0KDQogICogICByZW1vdmVkIHN0YXRlIElOSVRJQUxJWkVEDQogICogICBhZGRlZCBzdGF0ZSBJ TklUSUFMSVpJTkc6IFRoZSBwbHVnaW4gaXMgKGN1cnJlbnRseSkgYmVpbmcgaW5pdGlhbGl6ZWQg YnkgY2FsbGluZyBVaUluaXQgZXZlbnQgaGFuZGxlciBmdW5jdGlvbi4NCiAgKiAgIGFkZGVkIHN0 YXRlIElOX1VTRTogUGx1Z2luJ3MgVWlJbml0IGV2ZW50IGhhbmRsZXIgZnVuY3Rpb24gaGFzIGNv bXBsZXRlZCBzdWNjZXNzZnVsbHksIHdlIGNhbiBub3cgY2FsbCBvdGhlciBldmVudCBoYW5kbGVy IGZ1bmN0aW9ucyBhcyBuZWNlc3NhcnkuIFRoZSBwbHVnaW4gaXMgaW4gdXNlIG5vdy4NCiAgKiAg IGFkZGVkIHN0YXRlIEZBSUxFRDogQW4gdW5jYXVnaHQgZXhjZXB0aW9uIGVzY2FwZWQgd2hpbGUg Y2FsbGluZyBhbiBldmVudCBoYW5kbGVyIGZ1bmN0aW9uLCB3aGljaCBpbmRpY2F0ZXMgaW50ZXJu YWwgZXJyb3Igd2l0aGluIHRoZSBwbHVnaW4gY29kZS4gVGhlIHBsdWdpbiBpcyByZW1vdmVkIGZy b20gc2VydmljZS4NCkkndmUgYXR0YWNoZWQgYSBzaW1wbGUgc3RhdGUgZGlhZ3JhbSB0aGF0IGls bHVzdHJhdGVzIGRpZmZlcmVudCBzdGF0ZXMgYW5kIHRyYW5zaXRpb25zIGJldHdlZW4gdGhlbSAo Z3JlZW4gY29sb3IgaXMgaW5pdGlhbCBzdGF0ZSwgcmVkIGNvbG9yIGlzIGVuZCBzdGF0ZSkuDQoN ClVuY2F1Z2h0IGV4Y2VwdGlvbnMgaW4gcGx1Z2luIGV2ZW50IGhhbmRsZXIgZnVuY3Rpb25zIHdp bGwgYmUgY2F1Z2h0IGFuZCBoYW5kbGVkIGJ5IHRoZSBwbHVnaW4gaW5mcmFzdHJ1Y3R1cmUuIFRo aXMgcHJldmVudHMgYSBtaXNiZWhhdmluZyBwbHVnaW4gZnJvbSBicmVha2luZyBXZWJBZG1pbiBh cHBsaWNhdGlvbiwgc2luY2UgV2ViQWRtaW4gaXMgdGhlIGNhbGxlciAoaW5pdGlhdG9yKSBvZiB0 aGUgZnVuY3Rpb24gY2FsbC4gSW4gc3VjaCBjYXNlLCB0aGUgcGx1Z2luIHdpbGwgYmUgcmVtb3Zl ZCBmcm9tIHNlcnZpY2UuDQoNClVwZGF0ZSBvbiBjcm9zcy1vcmlnaW4gaXNzdWUgKGNvbnNlcXVl bmNlIG9mIHNhbWUtb3JpZ2luIHBvbGljeSkNCg0KSW4gb3JkZXIgZm9yIHRoZSBwbHVnaW4gdG8g YWNjZXNzIFdlYkFkbWluIHBsdWdpbiBBUEksIHBsdWdpbiBob3N0IHBhZ2UgKGUuZy4gc3RhcnQu aHRtbCkgbXVzdCBiZSBzZXJ2ZWQgZnJvbSBVUkwgb24gc2FtZSBvcmlnaW4gYXMgRW5naW5lIG9y aWdpbi4gT3RoZXJ3aXNlLCBwbHVnaW4gY29kZSBydW5uaW5nIGluIHRoZSBjb250ZXh0IG9mIGFu IGlmcmFtZSdkIGhvc3QgcGFnZSB3aWxsIGZhaWwgdG8gZXZhbHVhdGUgInBhcmVudC5wbHVnaW5B cGkiIGV4cHJlc3Npb24sIHdpdGggInBhcmVudCIgYmVpbmcgdG9wLWxldmVsIChXZWJBZG1pbikg d2luZG93LCBhbmQgInBsdWdpbkFwaSIgYmVpbmcgdGhlIGdsb2JhbCBwbHVnaW4gQVBJIG9iamVj dCBleHBvc2VkIGJ5IFdlYkFkbWluLg0KDQpUaGlzIGlzIHdoeSBQbHVnaW5SZXNvdXJjZVNlcnZs ZXQsIGF2YWlsYWJsZSBvbiBFbmdpbmUgb3JpZ2luLCBzaG91bGQgYmUgdXNlZCB0byBzZXJ2ZSBh bGwgcGx1Z2luIHJlc291cmNlcyBmcm9tIGxvY2FsIGZpbGUgc3lzdGVtLg0KDQpUaGVyZSdzIG9u bHkgb25lIGlzc3VlIHRoYXQgcmVtYWlucyB0byBiZSBzb2x2ZWQ6IGNyb3NzLW9yaWdpbiAicGx1 Z2luIHZzLiByZW1vdGUgc2VydmljZSIgY29tbXVuaWNhdGlvbiwgd2l0aCAicmVtb3RlIHNlcnZp Y2UiIGJlaW5nIGFueXRoaW5nIG90aGVyIHRoYW4gRW5naW5lIChSRVNUIEFQSSkuIEluIGZ1dHVy ZSwgd2UnbGwgYWRkcmVzcyB0aGlzIHdpdGggQXBhY2hlIHJldmVyc2UgcHJveHkgY29uZmlndXJh dGlvbiwgc28gdGhhdCB1c2VycyBjYW4gY29uZmlndXJlIEFwYWNoZSBzZXJ2ZXIgKHBsYWNlZCBp biBmcm9udCBvZiBFbmdpbmUgSkJvc3MgQVMpIHRvIHB1dCBhcmJpdHJhcnkgKGxvY2FsIG9yIHJl bW90ZSBub24tRW5naW5lKSBzZXJ2aWNlcyBvbiBzYW1lIG9yaWdpbi4gSG93ZXZlciwgdGhpcyBy ZXF1aXJlcyBhIGNoYW5nZSBpbiBjdXJyZW50IEFwYWNoZSBjb25maWd1cmF0aW9uLiBVbnRpbCB0 aGVuLCB1c2VycyBjYW4gbWFudWFsbHkgZWRpdCB0aGUgRW5naW5lIEFwYWNoZSBjb25maWd1cmF0 aW9uIGZpbGUgKC9ldGMvaHR0cGQvY29uZi5kL292aXJ0LWVuZ2luZS5jb25mKS4NCl9fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fDQoNCkkndmUgYXR0YWNoZWQgc29tZSBzYW1wbGUgcGx1 Z2luIGZpbGVzIGZvciB5b3UgdG8gZXhwZXJpbWVudCB3aXRoLiBJbnN0ZWFkIG9mIGF0dGFjaGlu ZyBhY3R1YWwgcGF0Y2ggZmlsZSAoOTIga0IpIHRvIHRoaXMgZW1haWwsIEkndmUgc3VibWl0dGVk IHRoZSBwYXRjaCB0byBvVmlydCBHZXJyaXQ6IGh0dHA6Ly9nZXJyaXQub3ZpcnQub3JnLzgxMjAN Cg0KTGV0IG1lIGtub3cgd2hhdCB5b3UgdGhpbmshDQoNCkNoZWVycywNClZvanRlY2gNCjx1aS1w bHVnaW4tc2FtcGxlLWZpbGVzLnRhci5nej4NCjx1aS1wbHVnaW4tbGlmZWN5Y2xlLnBuZz4NCl9f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fDQpFbmdpbmUtZGV2 ZWwgbWFpbGluZyBsaXN0DQpFbmdpbmUtZGV2ZWxAb3ZpcnQub3JnPG1haWx0bzpFbmdpbmUtZGV2 ZWxAb3ZpcnQub3JnPg0KaHR0cDovL2xpc3RzLm92aXJ0Lm9yZy9tYWlsbWFuL2xpc3RpbmZvL2Vu Z2luZS1kZXZlbA0KDQo= --_000_D290AD8432118048947689BA3AE8A9B3E47C3DSACEXCMBX04PRDhqn_ Content-Type: text/html; charset="utf-8" Content-Transfer-Encoding: base64 PGh0bWwgeG1sbnM6dj0idXJuOnNjaGVtYXMtbWljcm9zb2Z0LWNvbTp2bWwiIHhtbG5zOm89InVy bjpzY2hlbWFzLW1pY3Jvc29mdC1jb206b2ZmaWNlOm9mZmljZSIgeG1sbnM6dz0idXJuOnNjaGVt YXMtbWljcm9zb2Z0LWNvbTpvZmZpY2U6d29yZCIgeG1sbnM6bT0iaHR0cDovL3NjaGVtYXMubWlj cm9zb2Z0LmNvbS9vZmZpY2UvMjAwNC8xMi9vbW1sIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcv VFIvUkVDLWh0bWw0MCI+DQo8aGVhZD4NCjxtZXRhIGh0dHAtZXF1aXY9IkNvbnRlbnQtVHlwZSIg Y29udGVudD0idGV4dC9odG1sOyBjaGFyc2V0PXV0Zi04Ij4NCjxtZXRhIG5hbWU9IkdlbmVyYXRv ciIgY29udGVudD0iTWljcm9zb2Z0IFdvcmQgMTQgKGZpbHRlcmVkIG1lZGl1bSkiPg0KPCEtLVtp ZiAhbXNvXT48c3R5bGU+dlw6KiB7YmVoYXZpb3I6dXJsKCNkZWZhdWx0I1ZNTCk7fQ0Kb1w6KiB7 YmVoYXZpb3I6dXJsKCNkZWZhdWx0I1ZNTCk7fQ0Kd1w6KiB7YmVoYXZpb3I6dXJsKCNkZWZhdWx0 I1ZNTCk7fQ0KLnNoYXBlIHtiZWhhdmlvcjp1cmwoI2RlZmF1bHQjVk1MKTt9DQo8L3N0eWxlPjwh W2VuZGlmXS0tPjxzdHlsZT48IS0tDQovKiBGb250IERlZmluaXRpb25zICovDQpAZm9udC1mYWNl DQoJe2ZvbnQtZmFtaWx5OkhlbHZldGljYTsNCglwYW5vc2UtMToyIDExIDYgNCAyIDIgMiAyIDIg NDt9DQpAZm9udC1mYWNlDQoJe2ZvbnQtZmFtaWx5OldpbmdkaW5nczsNCglwYW5vc2UtMTo1IDAg MCAwIDAgMCAwIDAgMCAwO30NCkBmb250LWZhY2UNCgl7Zm9udC1mYW1pbHk6V2luZ2RpbmdzOw0K CXBhbm9zZS0xOjUgMCAwIDAgMCAwIDAgMCAwIDA7fQ0KQGZvbnQtZmFjZQ0KCXtmb250LWZhbWls eTpDYWxpYnJpOw0KCXBhbm9zZS0xOjIgMTUgNSAyIDIgMiA0IDMgMiA0O30NCkBmb250LWZhY2UN Cgl7Zm9udC1mYW1pbHk6VGFob21hOw0KCXBhbm9zZS0xOjIgMTEgNiA0IDMgNSA0IDQgMiA0O30N Ci8qIFN0eWxlIERlZmluaXRpb25zICovDQpwLk1zb05vcm1hbCwgbGkuTXNvTm9ybWFsLCBkaXYu TXNvTm9ybWFsDQoJe21hcmdpbjowaW47DQoJbWFyZ2luLWJvdHRvbTouMDAwMXB0Ow0KCWZvbnQt c2l6ZToxMi4wcHQ7DQoJZm9udC1mYW1pbHk6IlRpbWVzIE5ldyBSb21hbiIsInNlcmlmIjt9DQph OmxpbmssIHNwYW4uTXNvSHlwZXJsaW5rDQoJe21zby1zdHlsZS1wcmlvcml0eTo5OTsNCgljb2xv cjpibHVlOw0KCXRleHQtZGVjb3JhdGlvbjp1bmRlcmxpbmU7fQ0KYTp2aXNpdGVkLCBzcGFuLk1z b0h5cGVybGlua0ZvbGxvd2VkDQoJe21zby1zdHlsZS1wcmlvcml0eTo5OTsNCgljb2xvcjpwdXJw bGU7DQoJdGV4dC1kZWNvcmF0aW9uOnVuZGVybGluZTt9DQpwDQoJe21zby1zdHlsZS1wcmlvcml0 eTo5OTsNCgltc28tbWFyZ2luLXRvcC1hbHQ6YXV0bzsNCgltYXJnaW4tcmlnaHQ6MGluOw0KCW1z by1tYXJnaW4tYm90dG9tLWFsdDphdXRvOw0KCW1hcmdpbi1sZWZ0OjBpbjsNCglmb250LXNpemU6 MTIuMHB0Ow0KCWZvbnQtZmFtaWx5OiJUaW1lcyBOZXcgUm9tYW4iLCJzZXJpZiI7fQ0KcC5Nc29B Y2V0YXRlLCBsaS5Nc29BY2V0YXRlLCBkaXYuTXNvQWNldGF0ZQ0KCXttc28tc3R5bGUtcHJpb3Jp dHk6OTk7DQoJbXNvLXN0eWxlLWxpbms6IkJhbGxvb24gVGV4dCBDaGFyIjsNCgltYXJnaW46MGlu Ow0KCW1hcmdpbi1ib3R0b206LjAwMDFwdDsNCglmb250LXNpemU6OC4wcHQ7DQoJZm9udC1mYW1p bHk6IlRhaG9tYSIsInNhbnMtc2VyaWYiO30NCnNwYW4uQmFsbG9vblRleHRDaGFyDQoJe21zby1z dHlsZS1uYW1lOiJCYWxsb29uIFRleHQgQ2hhciI7DQoJbXNvLXN0eWxlLXByaW9yaXR5Ojk5Ow0K CW1zby1zdHlsZS1saW5rOiJCYWxsb29uIFRleHQiOw0KCWZvbnQtZmFtaWx5OiJUYWhvbWEiLCJz YW5zLXNlcmlmIjt9DQpzcGFuLkVtYWlsU3R5bGUyMQ0KCXttc28tc3R5bGUtdHlwZTpwZXJzb25h bDsNCglmb250LWZhbWlseToiQ2FsaWJyaSIsInNhbnMtc2VyaWYiOw0KCWNvbG9yOiMxRjQ5N0Q7 fQ0Kc3Bhbi5FbWFpbFN0eWxlMjINCgl7bXNvLXN0eWxlLXR5cGU6cGVyc29uYWw7DQoJZm9udC1m YW1pbHk6IkNhbGlicmkiLCJzYW5zLXNlcmlmIjsNCgljb2xvcjojMUY0OTdEO30NCnNwYW4uRW1h aWxTdHlsZTI0DQoJe21zby1zdHlsZS10eXBlOnBlcnNvbmFsLXJlcGx5Ow0KCWZvbnQtZmFtaWx5 OiJDYWxpYnJpIiwic2Fucy1zZXJpZiI7DQoJY29sb3I6IzFGNDk3RDt9DQouTXNvQ2hwRGVmYXVs dA0KCXttc28tc3R5bGUtdHlwZTpleHBvcnQtb25seTsNCglmb250LXNpemU6MTAuMHB0O30NCkBw YWdlIFdvcmRTZWN0aW9uMQ0KCXtzaXplOjguNWluIDExLjBpbjsNCgltYXJnaW46MS4waW4gMS4w aW4gMS4waW4gMS4waW47fQ0KZGl2LldvcmRTZWN0aW9uMQ0KCXtwYWdlOldvcmRTZWN0aW9uMTt9 DQovKiBMaXN0IERlZmluaXRpb25zICovDQpAbGlzdCBsMA0KCXttc28tbGlzdC1pZDoxODA0MzQ1 NzA7DQoJbXNvLWxpc3QtdGVtcGxhdGUtaWRzOi0yODI0MDI4ODA7fQ0KQGxpc3QgbDA6bGV2ZWwx DQoJe21zby1sZXZlbC1udW1iZXItZm9ybWF0OmJ1bGxldDsNCgltc28tbGV2ZWwtdGV4dDrvgrc7 DQoJbXNvLWxldmVsLXRhYi1zdG9wOi41aW47DQoJbXNvLWxldmVsLW51bWJlci1wb3NpdGlvbjps ZWZ0Ow0KCXRleHQtaW5kZW50Oi0uMjVpbjsNCgltc28tYW5zaS1mb250LXNpemU6MTAuMHB0Ow0K CWZvbnQtZmFtaWx5OlN5bWJvbDt9DQpAbGlzdCBsMDpsZXZlbDINCgl7bXNvLWxldmVsLW51bWJl ci1mb3JtYXQ6YnVsbGV0Ow0KCW1zby1sZXZlbC10ZXh0Om87DQoJbXNvLWxldmVsLXRhYi1zdG9w OjEuMGluOw0KCW1zby1sZXZlbC1udW1iZXItcG9zaXRpb246bGVmdDsNCgl0ZXh0LWluZGVudDot LjI1aW47DQoJbXNvLWFuc2ktZm9udC1zaXplOjEwLjBwdDsNCglmb250LWZhbWlseToiQ291cmll ciBOZXciOw0KCW1zby1iaWRpLWZvbnQtZmFtaWx5OiJUaW1lcyBOZXcgUm9tYW4iO30NCkBsaXN0 IGwwOmxldmVsMw0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVs LXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDoxLjVpbjsNCgltc28tbGV2ZWwtbnVtYmVy LXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6 ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGwwOmxldmVsNA0KCXtt c28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1z by1sZXZlbC10YWItc3RvcDoyLjBpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7 DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9u dC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGwwOmxldmVsNQ0KCXttc28tbGV2ZWwtbnVtYmVy LWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3Rv cDoyLjVpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6 LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2Rp bmdzO30NCkBsaXN0IGwwOmxldmVsNg0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7 DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDozLjBpbjsNCgltc28t bGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1h bnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGww OmxldmVsNw0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRl eHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDozLjVpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBv c2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZTox MC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGwwOmxldmVsOA0KCXttc28t bGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1s ZXZlbC10YWItc3RvcDo0LjBpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJ dGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1m YW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGwwOmxldmVsOQ0KCXttc28tbGV2ZWwtbnVtYmVyLWZv cm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDo0 LjVpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4y NWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2Rpbmdz O30NCkBsaXN0IGwxDQoJe21zby1saXN0LWlkOjI1OTg3NDIzMDsNCgltc28tbGlzdC10ZW1wbGF0 ZS1pZHM6LTExMDU0MDk5NzA7fQ0KQGxpc3QgbDE6bGV2ZWwxDQoJe21zby1sZXZlbC1udW1iZXIt Zm9ybWF0OmJ1bGxldDsNCgltc28tbGV2ZWwtdGV4dDrvgrc7DQoJbXNvLWxldmVsLXRhYi1zdG9w Oi41aW47DQoJbXNvLWxldmVsLW51bWJlci1wb3NpdGlvbjpsZWZ0Ow0KCXRleHQtaW5kZW50Oi0u MjVpbjsNCgltc28tYW5zaS1mb250LXNpemU6MTAuMHB0Ow0KCWZvbnQtZmFtaWx5OlN5bWJvbDt9 DQpAbGlzdCBsMTpsZXZlbDINCgl7bXNvLWxldmVsLW51bWJlci1mb3JtYXQ6YnVsbGV0Ow0KCW1z by1sZXZlbC10ZXh0Om87DQoJbXNvLWxldmVsLXRhYi1zdG9wOjEuMGluOw0KCW1zby1sZXZlbC1u dW1iZXItcG9zaXRpb246bGVmdDsNCgl0ZXh0LWluZGVudDotLjI1aW47DQoJbXNvLWFuc2ktZm9u dC1zaXplOjEwLjBwdDsNCglmb250LWZhbWlseToiQ291cmllciBOZXciOw0KCW1zby1iaWRpLWZv bnQtZmFtaWx5OiJUaW1lcyBOZXcgUm9tYW4iO30NCkBsaXN0IGwxOmxldmVsMw0KCXttc28tbGV2 ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZl bC10YWItc3RvcDoxLjVpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4 dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1p bHk6V2luZ2RpbmdzO30NCkBsaXN0IGwxOmxldmVsNA0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1h dDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDoyLjBp bjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWlu Ow0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30N CkBsaXN0IGwxOmxldmVsNQ0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNv LWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDoyLjVpbjsNCgltc28tbGV2ZWwt bnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZv bnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGwxOmxldmVs Ng0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674Kn Ow0KCW1zby1sZXZlbC10YWItc3RvcDozLjBpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9u OmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7 DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGwxOmxldmVsNw0KCXttc28tbGV2ZWwt bnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10 YWItc3RvcDozLjVpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1p bmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6 V2luZ2RpbmdzO30NCkBsaXN0IGwxOmxldmVsOA0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpi dWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDo0LjBpbjsN Cgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0K CW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBs aXN0IGwxOmxldmVsOQ0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxl dmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDo0LjVpbjsNCgltc28tbGV2ZWwtbnVt YmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQt c2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGwyDQoJe21zby1s aXN0LWlkOjU4MDI1ODQzOTsNCgltc28tbGlzdC10ZW1wbGF0ZS1pZHM6LTYzNjY2OTA7fQ0KQGxp c3QgbDI6bGV2ZWwxDQoJe21zby1sZXZlbC1udW1iZXItZm9ybWF0OmJ1bGxldDsNCgltc28tbGV2 ZWwtdGV4dDrvgrc7DQoJbXNvLWxldmVsLXRhYi1zdG9wOi41aW47DQoJbXNvLWxldmVsLW51bWJl ci1wb3NpdGlvbjpsZWZ0Ow0KCXRleHQtaW5kZW50Oi0uMjVpbjsNCgltc28tYW5zaS1mb250LXNp emU6MTAuMHB0Ow0KCWZvbnQtZmFtaWx5OlN5bWJvbDt9DQpAbGlzdCBsMjpsZXZlbDINCgl7bXNv LWxldmVsLW51bWJlci1mb3JtYXQ6YnVsbGV0Ow0KCW1zby1sZXZlbC10ZXh0Om87DQoJbXNvLWxl dmVsLXRhYi1zdG9wOjEuMGluOw0KCW1zby1sZXZlbC1udW1iZXItcG9zaXRpb246bGVmdDsNCgl0 ZXh0LWluZGVudDotLjI1aW47DQoJbXNvLWFuc2ktZm9udC1zaXplOjEwLjBwdDsNCglmb250LWZh bWlseToiQ291cmllciBOZXciOw0KCW1zby1iaWRpLWZvbnQtZmFtaWx5OiJUaW1lcyBOZXcgUm9t YW4iO30NCkBsaXN0IGwyOmxldmVsMw0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7 DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDoxLjVpbjsNCgltc28t bGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1h bnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGwy OmxldmVsNA0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRl eHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDoyLjBpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBv c2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZTox MC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGwyOmxldmVsNQ0KCXttc28t bGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1s ZXZlbC10YWItc3RvcDoyLjVpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJ dGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1m YW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGwyOmxldmVsNg0KCXttc28tbGV2ZWwtbnVtYmVyLWZv cm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDoz LjBpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4y NWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2Rpbmdz O30NCkBsaXN0IGwyOmxldmVsNw0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJ bXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDozLjVpbjsNCgltc28tbGV2 ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNp LWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGwyOmxl dmVsOA0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ6 74KnOw0KCW1zby1sZXZlbC10YWItc3RvcDo0LjBpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0 aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4w cHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGwyOmxldmVsOQ0KCXttc28tbGV2 ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZl bC10YWItc3RvcDo0LjVpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4 dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1p bHk6V2luZ2RpbmdzO30NCkBsaXN0IGwzDQoJe21zby1saXN0LWlkOjcxMzU4MTQzNTsNCgltc28t bGlzdC10ZW1wbGF0ZS1pZHM6MjA2OTc4Mzk3Njt9DQpAbGlzdCBsMzpsZXZlbDENCgl7bXNvLWxl dmVsLW51bWJlci1mb3JtYXQ6YnVsbGV0Ow0KCW1zby1sZXZlbC10ZXh0Ou+CtzsNCgltc28tbGV2 ZWwtdGFiLXN0b3A6LjVpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4 dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1p bHk6U3ltYm9sO30NCkBsaXN0IGwzOmxldmVsMg0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpi dWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ6bzsNCgltc28tbGV2ZWwtdGFiLXN0b3A6MS4waW47DQoJ bXNvLWxldmVsLW51bWJlci1wb3NpdGlvbjpsZWZ0Ow0KCXRleHQtaW5kZW50Oi0uMjVpbjsNCglt c28tYW5zaS1mb250LXNpemU6MTAuMHB0Ow0KCWZvbnQtZmFtaWx5OiJDb3VyaWVyIE5ldyI7DQoJ bXNvLWJpZGktZm9udC1mYW1pbHk6IlRpbWVzIE5ldyBSb21hbiI7fQ0KQGxpc3QgbDM6bGV2ZWwz DQoJe21zby1sZXZlbC1udW1iZXItZm9ybWF0OmJ1bGxldDsNCgltc28tbGV2ZWwtdGV4dDrvgqc7 DQoJbXNvLWxldmVsLXRhYi1zdG9wOjEuNWluOw0KCW1zby1sZXZlbC1udW1iZXItcG9zaXRpb246 bGVmdDsNCgl0ZXh0LWluZGVudDotLjI1aW47DQoJbXNvLWFuc2ktZm9udC1zaXplOjEwLjBwdDsN Cglmb250LWZhbWlseTpXaW5nZGluZ3M7fQ0KQGxpc3QgbDM6bGV2ZWw0DQoJe21zby1sZXZlbC1u dW1iZXItZm9ybWF0OmJ1bGxldDsNCgltc28tbGV2ZWwtdGV4dDrvgqc7DQoJbXNvLWxldmVsLXRh Yi1zdG9wOjIuMGluOw0KCW1zby1sZXZlbC1udW1iZXItcG9zaXRpb246bGVmdDsNCgl0ZXh0LWlu ZGVudDotLjI1aW47DQoJbXNvLWFuc2ktZm9udC1zaXplOjEwLjBwdDsNCglmb250LWZhbWlseTpX aW5nZGluZ3M7fQ0KQGxpc3QgbDM6bGV2ZWw1DQoJe21zby1sZXZlbC1udW1iZXItZm9ybWF0OmJ1 bGxldDsNCgltc28tbGV2ZWwtdGV4dDrvgqc7DQoJbXNvLWxldmVsLXRhYi1zdG9wOjIuNWluOw0K CW1zby1sZXZlbC1udW1iZXItcG9zaXRpb246bGVmdDsNCgl0ZXh0LWluZGVudDotLjI1aW47DQoJ bXNvLWFuc2ktZm9udC1zaXplOjEwLjBwdDsNCglmb250LWZhbWlseTpXaW5nZGluZ3M7fQ0KQGxp c3QgbDM6bGV2ZWw2DQoJe21zby1sZXZlbC1udW1iZXItZm9ybWF0OmJ1bGxldDsNCgltc28tbGV2 ZWwtdGV4dDrvgqc7DQoJbXNvLWxldmVsLXRhYi1zdG9wOjMuMGluOw0KCW1zby1sZXZlbC1udW1i ZXItcG9zaXRpb246bGVmdDsNCgl0ZXh0LWluZGVudDotLjI1aW47DQoJbXNvLWFuc2ktZm9udC1z aXplOjEwLjBwdDsNCglmb250LWZhbWlseTpXaW5nZGluZ3M7fQ0KQGxpc3QgbDM6bGV2ZWw3DQoJ e21zby1sZXZlbC1udW1iZXItZm9ybWF0OmJ1bGxldDsNCgltc28tbGV2ZWwtdGV4dDrvgqc7DQoJ bXNvLWxldmVsLXRhYi1zdG9wOjMuNWluOw0KCW1zby1sZXZlbC1udW1iZXItcG9zaXRpb246bGVm dDsNCgl0ZXh0LWluZGVudDotLjI1aW47DQoJbXNvLWFuc2ktZm9udC1zaXplOjEwLjBwdDsNCglm b250LWZhbWlseTpXaW5nZGluZ3M7fQ0KQGxpc3QgbDM6bGV2ZWw4DQoJe21zby1sZXZlbC1udW1i ZXItZm9ybWF0OmJ1bGxldDsNCgltc28tbGV2ZWwtdGV4dDrvgqc7DQoJbXNvLWxldmVsLXRhYi1z dG9wOjQuMGluOw0KCW1zby1sZXZlbC1udW1iZXItcG9zaXRpb246bGVmdDsNCgl0ZXh0LWluZGVu dDotLjI1aW47DQoJbXNvLWFuc2ktZm9udC1zaXplOjEwLjBwdDsNCglmb250LWZhbWlseTpXaW5n ZGluZ3M7fQ0KQGxpc3QgbDM6bGV2ZWw5DQoJe21zby1sZXZlbC1udW1iZXItZm9ybWF0OmJ1bGxl dDsNCgltc28tbGV2ZWwtdGV4dDrvgqc7DQoJbXNvLWxldmVsLXRhYi1zdG9wOjQuNWluOw0KCW1z by1sZXZlbC1udW1iZXItcG9zaXRpb246bGVmdDsNCgl0ZXh0LWluZGVudDotLjI1aW47DQoJbXNv LWFuc2ktZm9udC1zaXplOjEwLjBwdDsNCglmb250LWZhbWlseTpXaW5nZGluZ3M7fQ0KQGxpc3Qg bDQNCgl7bXNvLWxpc3QtaWQ6NzY1OTIxOTk0Ow0KCW1zby1saXN0LXRlbXBsYXRlLWlkczo0MDA3 MTkzMTA7fQ0KQGxpc3QgbDQ6bGV2ZWwxDQoJe21zby1sZXZlbC1udW1iZXItZm9ybWF0OmJ1bGxl dDsNCgltc28tbGV2ZWwtdGV4dDrvgrc7DQoJbXNvLWxldmVsLXRhYi1zdG9wOi41aW47DQoJbXNv LWxldmVsLW51bWJlci1wb3NpdGlvbjpsZWZ0Ow0KCXRleHQtaW5kZW50Oi0uMjVpbjsNCgltc28t YW5zaS1mb250LXNpemU6MTAuMHB0Ow0KCWZvbnQtZmFtaWx5OlN5bWJvbDt9DQpAbGlzdCBsNDps ZXZlbDINCgl7bXNvLWxldmVsLW51bWJlci1mb3JtYXQ6YnVsbGV0Ow0KCW1zby1sZXZlbC10ZXh0 Om87DQoJbXNvLWxldmVsLXRhYi1zdG9wOjEuMGluOw0KCW1zby1sZXZlbC1udW1iZXItcG9zaXRp b246bGVmdDsNCgl0ZXh0LWluZGVudDotLjI1aW47DQoJbXNvLWFuc2ktZm9udC1zaXplOjEwLjBw dDsNCglmb250LWZhbWlseToiQ291cmllciBOZXciOw0KCW1zby1iaWRpLWZvbnQtZmFtaWx5OiJU aW1lcyBOZXcgUm9tYW4iO30NCkBsaXN0IGw0OmxldmVsMw0KCXttc28tbGV2ZWwtbnVtYmVyLWZv cm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDox LjVpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4y NWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2Rpbmdz O30NCkBsaXN0IGw0OmxldmVsNA0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJ bXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDoyLjBpbjsNCgltc28tbGV2 ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNp LWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGw0Omxl dmVsNQ0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ6 74KnOw0KCW1zby1sZXZlbC10YWItc3RvcDoyLjVpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0 aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4w cHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGw0OmxldmVsNg0KCXttc28tbGV2 ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZl bC10YWItc3RvcDozLjBpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4 dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1p bHk6V2luZ2RpbmdzO30NCkBsaXN0IGw0OmxldmVsNw0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1h dDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDozLjVp bjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWlu Ow0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30N CkBsaXN0IGw0OmxldmVsOA0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNv LWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDo0LjBpbjsNCgltc28tbGV2ZWwt bnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZv bnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGw0OmxldmVs OQ0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674Kn Ow0KCW1zby1sZXZlbC10YWItc3RvcDo0LjVpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9u OmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7 DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGw1DQoJe21zby1saXN0LWlkOjg0Mzkw ODExNDsNCgltc28tbGlzdC10ZW1wbGF0ZS1pZHM6LTEyNDM1NDc2MDY7fQ0KQGxpc3QgbDU6bGV2 ZWwxDQoJe21zby1sZXZlbC1udW1iZXItZm9ybWF0OmJ1bGxldDsNCgltc28tbGV2ZWwtdGV4dDrv grc7DQoJbXNvLWxldmVsLXRhYi1zdG9wOi41aW47DQoJbXNvLWxldmVsLW51bWJlci1wb3NpdGlv bjpsZWZ0Ow0KCXRleHQtaW5kZW50Oi0uMjVpbjsNCgltc28tYW5zaS1mb250LXNpemU6MTAuMHB0 Ow0KCWZvbnQtZmFtaWx5OlN5bWJvbDt9DQpAbGlzdCBsNTpsZXZlbDINCgl7bXNvLWxldmVsLW51 bWJlci1mb3JtYXQ6YnVsbGV0Ow0KCW1zby1sZXZlbC10ZXh0Om87DQoJbXNvLWxldmVsLXRhYi1z dG9wOjEuMGluOw0KCW1zby1sZXZlbC1udW1iZXItcG9zaXRpb246bGVmdDsNCgl0ZXh0LWluZGVu dDotLjI1aW47DQoJbXNvLWFuc2ktZm9udC1zaXplOjEwLjBwdDsNCglmb250LWZhbWlseToiQ291 cmllciBOZXciOw0KCW1zby1iaWRpLWZvbnQtZmFtaWx5OiJUaW1lcyBOZXcgUm9tYW4iO30NCkBs aXN0IGw1OmxldmVsMw0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxl dmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDoxLjVpbjsNCgltc28tbGV2ZWwtbnVt YmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQt c2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGw1OmxldmVsNA0K CXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0K CW1zby1sZXZlbC10YWItc3RvcDoyLjBpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxl ZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJ Zm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGw1OmxldmVsNQ0KCXttc28tbGV2ZWwtbnVt YmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWIt c3RvcDoyLjVpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRl bnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2lu Z2RpbmdzO30NCkBsaXN0IGw1OmxldmVsNg0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxs ZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDozLjBpbjsNCglt c28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1z by1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0 IGw1OmxldmVsNw0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVs LXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDozLjVpbjsNCgltc28tbGV2ZWwtbnVtYmVy LXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6 ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGw1OmxldmVsOA0KCXtt c28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1z by1sZXZlbC10YWItc3RvcDo0LjBpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7 DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9u dC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGw1OmxldmVsOQ0KCXttc28tbGV2ZWwtbnVtYmVy LWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3Rv cDo0LjVpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6 LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2Rp bmdzO30NCkBsaXN0IGw2DQoJe21zby1saXN0LWlkOjk2NDc3MTQzNTsNCgltc28tbGlzdC10ZW1w bGF0ZS1pZHM6LTIwMDA3ODMxMzI7fQ0KQGxpc3QgbDY6bGV2ZWwxDQoJe21zby1sZXZlbC1udW1i ZXItZm9ybWF0OmJ1bGxldDsNCgltc28tbGV2ZWwtdGV4dDrvgrc7DQoJbXNvLWxldmVsLXRhYi1z dG9wOi41aW47DQoJbXNvLWxldmVsLW51bWJlci1wb3NpdGlvbjpsZWZ0Ow0KCXRleHQtaW5kZW50 Oi0uMjVpbjsNCgltc28tYW5zaS1mb250LXNpemU6MTAuMHB0Ow0KCWZvbnQtZmFtaWx5OlN5bWJv bDt9DQpAbGlzdCBsNjpsZXZlbDINCgl7bXNvLWxldmVsLW51bWJlci1mb3JtYXQ6YnVsbGV0Ow0K CW1zby1sZXZlbC10ZXh0Om87DQoJbXNvLWxldmVsLXRhYi1zdG9wOjEuMGluOw0KCW1zby1sZXZl bC1udW1iZXItcG9zaXRpb246bGVmdDsNCgl0ZXh0LWluZGVudDotLjI1aW47DQoJbXNvLWFuc2kt Zm9udC1zaXplOjEwLjBwdDsNCglmb250LWZhbWlseToiQ291cmllciBOZXciOw0KCW1zby1iaWRp LWZvbnQtZmFtaWx5OiJUaW1lcyBOZXcgUm9tYW4iO30NCkBsaXN0IGw2OmxldmVsMw0KCXttc28t bGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1s ZXZlbC10YWItc3RvcDoxLjVpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJ dGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1m YW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGw2OmxldmVsNA0KCXttc28tbGV2ZWwtbnVtYmVyLWZv cm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDoy LjBpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4y NWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2Rpbmdz O30NCkBsaXN0IGw2OmxldmVsNQ0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJ bXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDoyLjVpbjsNCgltc28tbGV2 ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNp LWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGw2Omxl dmVsNg0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ6 74KnOw0KCW1zby1sZXZlbC10YWItc3RvcDozLjBpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0 aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4w cHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGw2OmxldmVsNw0KCXttc28tbGV2 ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZl bC10YWItc3RvcDozLjVpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4 dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1p bHk6V2luZ2RpbmdzO30NCkBsaXN0IGw2OmxldmVsOA0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1h dDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDo0LjBp bjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWlu Ow0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30N CkBsaXN0IGw2OmxldmVsOQ0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNv LWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDo0LjVpbjsNCgltc28tbGV2ZWwt bnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZv bnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGw3DQoJe21z by1saXN0LWlkOjExNDU4NTI0MTA7DQoJbXNvLWxpc3QtdGVtcGxhdGUtaWRzOjE5NTcyMjg4NjQ7 fQ0KQGxpc3QgbDc6bGV2ZWwxDQoJe21zby1sZXZlbC1udW1iZXItZm9ybWF0OmJ1bGxldDsNCglt c28tbGV2ZWwtdGV4dDrvgrc7DQoJbXNvLWxldmVsLXRhYi1zdG9wOi41aW47DQoJbXNvLWxldmVs LW51bWJlci1wb3NpdGlvbjpsZWZ0Ow0KCXRleHQtaW5kZW50Oi0uMjVpbjsNCgltc28tYW5zaS1m b250LXNpemU6MTAuMHB0Ow0KCWZvbnQtZmFtaWx5OlN5bWJvbDt9DQpAbGlzdCBsNzpsZXZlbDIN Cgl7bXNvLWxldmVsLW51bWJlci1mb3JtYXQ6YnVsbGV0Ow0KCW1zby1sZXZlbC10ZXh0Om87DQoJ bXNvLWxldmVsLXRhYi1zdG9wOjEuMGluOw0KCW1zby1sZXZlbC1udW1iZXItcG9zaXRpb246bGVm dDsNCgl0ZXh0LWluZGVudDotLjI1aW47DQoJbXNvLWFuc2ktZm9udC1zaXplOjEwLjBwdDsNCglm b250LWZhbWlseToiQ291cmllciBOZXciOw0KCW1zby1iaWRpLWZvbnQtZmFtaWx5OiJUaW1lcyBO ZXcgUm9tYW4iO30NCkBsaXN0IGw3OmxldmVsMw0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpi dWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDoxLjVpbjsN Cgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0K CW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBs aXN0IGw3OmxldmVsNA0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxl dmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDoyLjBpbjsNCgltc28tbGV2ZWwtbnVt YmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQt c2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGw3OmxldmVsNQ0K CXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0K CW1zby1sZXZlbC10YWItc3RvcDoyLjVpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxl ZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJ Zm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGw3OmxldmVsNg0KCXttc28tbGV2ZWwtbnVt YmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWIt c3RvcDozLjBpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRl bnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2lu Z2RpbmdzO30NCkBsaXN0IGw3OmxldmVsNw0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxs ZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDozLjVpbjsNCglt c28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1z by1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0 IGw3OmxldmVsOA0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVs LXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDo0LjBpbjsNCgltc28tbGV2ZWwtbnVtYmVy LXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6 ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGw3OmxldmVsOQ0KCXtt c28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1z by1sZXZlbC10YWItc3RvcDo0LjVpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7 DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9u dC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGw4DQoJe21zby1saXN0LWlkOjExNzY4NDg2NDI7 DQoJbXNvLWxpc3QtdGVtcGxhdGUtaWRzOjEyMjM1NjU3MjI7fQ0KQGxpc3QgbDg6bGV2ZWwxDQoJ e21zby1sZXZlbC1udW1iZXItZm9ybWF0OmJ1bGxldDsNCgltc28tbGV2ZWwtdGV4dDrvgrc7DQoJ bXNvLWxldmVsLXRhYi1zdG9wOi41aW47DQoJbXNvLWxldmVsLW51bWJlci1wb3NpdGlvbjpsZWZ0 Ow0KCXRleHQtaW5kZW50Oi0uMjVpbjsNCgltc28tYW5zaS1mb250LXNpemU6MTAuMHB0Ow0KCWZv bnQtZmFtaWx5OlN5bWJvbDt9DQpAbGlzdCBsODpsZXZlbDINCgl7bXNvLWxldmVsLW51bWJlci1m b3JtYXQ6YnVsbGV0Ow0KCW1zby1sZXZlbC10ZXh0Om87DQoJbXNvLWxldmVsLXRhYi1zdG9wOjEu MGluOw0KCW1zby1sZXZlbC1udW1iZXItcG9zaXRpb246bGVmdDsNCgl0ZXh0LWluZGVudDotLjI1 aW47DQoJbXNvLWFuc2ktZm9udC1zaXplOjEwLjBwdDsNCglmb250LWZhbWlseToiQ291cmllciBO ZXciOw0KCW1zby1iaWRpLWZvbnQtZmFtaWx5OiJUaW1lcyBOZXcgUm9tYW4iO30NCkBsaXN0IGw4 OmxldmVsMw0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRl eHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDoxLjVpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBv c2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZTox MC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGw4OmxldmVsNA0KCXttc28t bGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1s ZXZlbC10YWItc3RvcDoyLjBpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJ dGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1m YW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGw4OmxldmVsNQ0KCXttc28tbGV2ZWwtbnVtYmVyLWZv cm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDoy LjVpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4y NWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2Rpbmdz O30NCkBsaXN0IGw4OmxldmVsNg0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJ bXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDozLjBpbjsNCgltc28tbGV2 ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNp LWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGw4Omxl dmVsNw0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ6 74KnOw0KCW1zby1sZXZlbC10YWItc3RvcDozLjVpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0 aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4w cHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGw4OmxldmVsOA0KCXttc28tbGV2 ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZl bC10YWItc3RvcDo0LjBpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4 dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1p bHk6V2luZ2RpbmdzO30NCkBsaXN0IGw4OmxldmVsOQ0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1h dDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDo0LjVp bjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWlu Ow0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30N CkBsaXN0IGw5DQoJe21zby1saXN0LWlkOjEzMTEyMDYyMjA7DQoJbXNvLWxpc3QtdGVtcGxhdGUt aWRzOjMxNDIyNDE2MDt9DQpAbGlzdCBsOTpsZXZlbDENCgl7bXNvLWxldmVsLW51bWJlci1mb3Jt YXQ6YnVsbGV0Ow0KCW1zby1sZXZlbC10ZXh0Ou+CtzsNCgltc28tbGV2ZWwtdGFiLXN0b3A6LjVp bjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWlu Ow0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6U3ltYm9sO30NCkBs aXN0IGw5OmxldmVsMg0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxl dmVsLXRleHQ6bzsNCgltc28tbGV2ZWwtdGFiLXN0b3A6MS4waW47DQoJbXNvLWxldmVsLW51bWJl ci1wb3NpdGlvbjpsZWZ0Ow0KCXRleHQtaW5kZW50Oi0uMjVpbjsNCgltc28tYW5zaS1mb250LXNp emU6MTAuMHB0Ow0KCWZvbnQtZmFtaWx5OiJDb3VyaWVyIE5ldyI7DQoJbXNvLWJpZGktZm9udC1m YW1pbHk6IlRpbWVzIE5ldyBSb21hbiI7fQ0KQGxpc3QgbDk6bGV2ZWwzDQoJe21zby1sZXZlbC1u dW1iZXItZm9ybWF0OmJ1bGxldDsNCgltc28tbGV2ZWwtdGV4dDrvgqc7DQoJbXNvLWxldmVsLXRh Yi1zdG9wOjEuNWluOw0KCW1zby1sZXZlbC1udW1iZXItcG9zaXRpb246bGVmdDsNCgl0ZXh0LWlu ZGVudDotLjI1aW47DQoJbXNvLWFuc2ktZm9udC1zaXplOjEwLjBwdDsNCglmb250LWZhbWlseTpX aW5nZGluZ3M7fQ0KQGxpc3QgbDk6bGV2ZWw0DQoJe21zby1sZXZlbC1udW1iZXItZm9ybWF0OmJ1 bGxldDsNCgltc28tbGV2ZWwtdGV4dDrvgqc7DQoJbXNvLWxldmVsLXRhYi1zdG9wOjIuMGluOw0K CW1zby1sZXZlbC1udW1iZXItcG9zaXRpb246bGVmdDsNCgl0ZXh0LWluZGVudDotLjI1aW47DQoJ bXNvLWFuc2ktZm9udC1zaXplOjEwLjBwdDsNCglmb250LWZhbWlseTpXaW5nZGluZ3M7fQ0KQGxp c3QgbDk6bGV2ZWw1DQoJe21zby1sZXZlbC1udW1iZXItZm9ybWF0OmJ1bGxldDsNCgltc28tbGV2 ZWwtdGV4dDrvgqc7DQoJbXNvLWxldmVsLXRhYi1zdG9wOjIuNWluOw0KCW1zby1sZXZlbC1udW1i ZXItcG9zaXRpb246bGVmdDsNCgl0ZXh0LWluZGVudDotLjI1aW47DQoJbXNvLWFuc2ktZm9udC1z aXplOjEwLjBwdDsNCglmb250LWZhbWlseTpXaW5nZGluZ3M7fQ0KQGxpc3QgbDk6bGV2ZWw2DQoJ e21zby1sZXZlbC1udW1iZXItZm9ybWF0OmJ1bGxldDsNCgltc28tbGV2ZWwtdGV4dDrvgqc7DQoJ bXNvLWxldmVsLXRhYi1zdG9wOjMuMGluOw0KCW1zby1sZXZlbC1udW1iZXItcG9zaXRpb246bGVm dDsNCgl0ZXh0LWluZGVudDotLjI1aW47DQoJbXNvLWFuc2ktZm9udC1zaXplOjEwLjBwdDsNCglm b250LWZhbWlseTpXaW5nZGluZ3M7fQ0KQGxpc3QgbDk6bGV2ZWw3DQoJe21zby1sZXZlbC1udW1i ZXItZm9ybWF0OmJ1bGxldDsNCgltc28tbGV2ZWwtdGV4dDrvgqc7DQoJbXNvLWxldmVsLXRhYi1z dG9wOjMuNWluOw0KCW1zby1sZXZlbC1udW1iZXItcG9zaXRpb246bGVmdDsNCgl0ZXh0LWluZGVu dDotLjI1aW47DQoJbXNvLWFuc2ktZm9udC1zaXplOjEwLjBwdDsNCglmb250LWZhbWlseTpXaW5n ZGluZ3M7fQ0KQGxpc3QgbDk6bGV2ZWw4DQoJe21zby1sZXZlbC1udW1iZXItZm9ybWF0OmJ1bGxl dDsNCgltc28tbGV2ZWwtdGV4dDrvgqc7DQoJbXNvLWxldmVsLXRhYi1zdG9wOjQuMGluOw0KCW1z by1sZXZlbC1udW1iZXItcG9zaXRpb246bGVmdDsNCgl0ZXh0LWluZGVudDotLjI1aW47DQoJbXNv LWFuc2ktZm9udC1zaXplOjEwLjBwdDsNCglmb250LWZhbWlseTpXaW5nZGluZ3M7fQ0KQGxpc3Qg bDk6bGV2ZWw5DQoJe21zby1sZXZlbC1udW1iZXItZm9ybWF0OmJ1bGxldDsNCgltc28tbGV2ZWwt dGV4dDrvgqc7DQoJbXNvLWxldmVsLXRhYi1zdG9wOjQuNWluOw0KCW1zby1sZXZlbC1udW1iZXIt cG9zaXRpb246bGVmdDsNCgl0ZXh0LWluZGVudDotLjI1aW47DQoJbXNvLWFuc2ktZm9udC1zaXpl OjEwLjBwdDsNCglmb250LWZhbWlseTpXaW5nZGluZ3M7fQ0KQGxpc3QgbDEwDQoJe21zby1saXN0 LWlkOjE0MzQwMTI4Mjk7DQoJbXNvLWxpc3QtdGVtcGxhdGUtaWRzOi02OTA0NDcwNTA7fQ0KQGxp c3QgbDEwOmxldmVsMQ0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxl dmVsLXRleHQ674K3Ow0KCW1zby1sZXZlbC10YWItc3RvcDouNWluOw0KCW1zby1sZXZlbC1udW1i ZXItcG9zaXRpb246bGVmdDsNCgl0ZXh0LWluZGVudDotLjI1aW47DQoJbXNvLWFuc2ktZm9udC1z aXplOjEwLjBwdDsNCglmb250LWZhbWlseTpTeW1ib2w7fQ0KQGxpc3QgbDEwOmxldmVsMg0KCXtt c28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ6bzsNCgltc28t bGV2ZWwtdGFiLXN0b3A6MS4waW47DQoJbXNvLWxldmVsLW51bWJlci1wb3NpdGlvbjpsZWZ0Ow0K CXRleHQtaW5kZW50Oi0uMjVpbjsNCgltc28tYW5zaS1mb250LXNpemU6MTAuMHB0Ow0KCWZvbnQt ZmFtaWx5OiJDb3VyaWVyIE5ldyI7DQoJbXNvLWJpZGktZm9udC1mYW1pbHk6IlRpbWVzIE5ldyBS b21hbiI7fQ0KQGxpc3QgbDEwOmxldmVsMw0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxs ZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDoxLjVpbjsNCglt c28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1z by1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0 IGwxMDpsZXZlbDQNCgl7bXNvLWxldmVsLW51bWJlci1mb3JtYXQ6YnVsbGV0Ow0KCW1zby1sZXZl bC10ZXh0Ou+CpzsNCgltc28tbGV2ZWwtdGFiLXN0b3A6Mi4waW47DQoJbXNvLWxldmVsLW51bWJl ci1wb3NpdGlvbjpsZWZ0Ow0KCXRleHQtaW5kZW50Oi0uMjVpbjsNCgltc28tYW5zaS1mb250LXNp emU6MTAuMHB0Ow0KCWZvbnQtZmFtaWx5OldpbmdkaW5nczt9DQpAbGlzdCBsMTA6bGV2ZWw1DQoJ e21zby1sZXZlbC1udW1iZXItZm9ybWF0OmJ1bGxldDsNCgltc28tbGV2ZWwtdGV4dDrvgqc7DQoJ bXNvLWxldmVsLXRhYi1zdG9wOjIuNWluOw0KCW1zby1sZXZlbC1udW1iZXItcG9zaXRpb246bGVm dDsNCgl0ZXh0LWluZGVudDotLjI1aW47DQoJbXNvLWFuc2ktZm9udC1zaXplOjEwLjBwdDsNCglm b250LWZhbWlseTpXaW5nZGluZ3M7fQ0KQGxpc3QgbDEwOmxldmVsNg0KCXttc28tbGV2ZWwtbnVt YmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWIt c3RvcDozLjBpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRl bnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2lu Z2RpbmdzO30NCkBsaXN0IGwxMDpsZXZlbDcNCgl7bXNvLWxldmVsLW51bWJlci1mb3JtYXQ6YnVs bGV0Ow0KCW1zby1sZXZlbC10ZXh0Ou+CpzsNCgltc28tbGV2ZWwtdGFiLXN0b3A6My41aW47DQoJ bXNvLWxldmVsLW51bWJlci1wb3NpdGlvbjpsZWZ0Ow0KCXRleHQtaW5kZW50Oi0uMjVpbjsNCglt c28tYW5zaS1mb250LXNpemU6MTAuMHB0Ow0KCWZvbnQtZmFtaWx5OldpbmdkaW5nczt9DQpAbGlz dCBsMTA6bGV2ZWw4DQoJe21zby1sZXZlbC1udW1iZXItZm9ybWF0OmJ1bGxldDsNCgltc28tbGV2 ZWwtdGV4dDrvgqc7DQoJbXNvLWxldmVsLXRhYi1zdG9wOjQuMGluOw0KCW1zby1sZXZlbC1udW1i ZXItcG9zaXRpb246bGVmdDsNCgl0ZXh0LWluZGVudDotLjI1aW47DQoJbXNvLWFuc2ktZm9udC1z aXplOjEwLjBwdDsNCglmb250LWZhbWlseTpXaW5nZGluZ3M7fQ0KQGxpc3QgbDEwOmxldmVsOQ0K CXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0K CW1zby1sZXZlbC10YWItc3RvcDo0LjVpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxl ZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJ Zm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGwxMQ0KCXttc28tbGlzdC1pZDoxNTQ2ODY1 MjQ3Ow0KCW1zby1saXN0LXRlbXBsYXRlLWlkczotMTMwNjM3MzQ5NDt9DQpAbGlzdCBsMTE6bGV2 ZWwxDQoJe21zby1sZXZlbC1udW1iZXItZm9ybWF0OmJ1bGxldDsNCgltc28tbGV2ZWwtdGV4dDrv grc7DQoJbXNvLWxldmVsLXRhYi1zdG9wOi41aW47DQoJbXNvLWxldmVsLW51bWJlci1wb3NpdGlv bjpsZWZ0Ow0KCXRleHQtaW5kZW50Oi0uMjVpbjsNCgltc28tYW5zaS1mb250LXNpemU6MTAuMHB0 Ow0KCWZvbnQtZmFtaWx5OlN5bWJvbDt9DQpAbGlzdCBsMTE6bGV2ZWwyDQoJe21zby1sZXZlbC1u dW1iZXItZm9ybWF0OmJ1bGxldDsNCgltc28tbGV2ZWwtdGV4dDpvOw0KCW1zby1sZXZlbC10YWIt c3RvcDoxLjBpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRl bnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6IkNv dXJpZXIgTmV3IjsNCgltc28tYmlkaS1mb250LWZhbWlseToiVGltZXMgTmV3IFJvbWFuIjt9DQpA bGlzdCBsMTE6bGV2ZWwzDQoJe21zby1sZXZlbC1udW1iZXItZm9ybWF0OmJ1bGxldDsNCgltc28t bGV2ZWwtdGV4dDrvgqc7DQoJbXNvLWxldmVsLXRhYi1zdG9wOjEuNWluOw0KCW1zby1sZXZlbC1u dW1iZXItcG9zaXRpb246bGVmdDsNCgl0ZXh0LWluZGVudDotLjI1aW47DQoJbXNvLWFuc2ktZm9u dC1zaXplOjEwLjBwdDsNCglmb250LWZhbWlseTpXaW5nZGluZ3M7fQ0KQGxpc3QgbDExOmxldmVs NA0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674Kn Ow0KCW1zby1sZXZlbC10YWItc3RvcDoyLjBpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9u OmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7 DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGwxMTpsZXZlbDUNCgl7bXNvLWxldmVs LW51bWJlci1mb3JtYXQ6YnVsbGV0Ow0KCW1zby1sZXZlbC10ZXh0Ou+CpzsNCgltc28tbGV2ZWwt dGFiLXN0b3A6Mi41aW47DQoJbXNvLWxldmVsLW51bWJlci1wb3NpdGlvbjpsZWZ0Ow0KCXRleHQt aW5kZW50Oi0uMjVpbjsNCgltc28tYW5zaS1mb250LXNpemU6MTAuMHB0Ow0KCWZvbnQtZmFtaWx5 OldpbmdkaW5nczt9DQpAbGlzdCBsMTE6bGV2ZWw2DQoJe21zby1sZXZlbC1udW1iZXItZm9ybWF0 OmJ1bGxldDsNCgltc28tbGV2ZWwtdGV4dDrvgqc7DQoJbXNvLWxldmVsLXRhYi1zdG9wOjMuMGlu Ow0KCW1zby1sZXZlbC1udW1iZXItcG9zaXRpb246bGVmdDsNCgl0ZXh0LWluZGVudDotLjI1aW47 DQoJbXNvLWFuc2ktZm9udC1zaXplOjEwLjBwdDsNCglmb250LWZhbWlseTpXaW5nZGluZ3M7fQ0K QGxpc3QgbDExOmxldmVsNw0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNv LWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZlbC10YWItc3RvcDozLjVpbjsNCgltc28tbGV2ZWwt bnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZv bnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGwxMTpsZXZl bDgNCgl7bXNvLWxldmVsLW51bWJlci1mb3JtYXQ6YnVsbGV0Ow0KCW1zby1sZXZlbC10ZXh0Ou+C pzsNCgltc28tbGV2ZWwtdGFiLXN0b3A6NC4waW47DQoJbXNvLWxldmVsLW51bWJlci1wb3NpdGlv bjpsZWZ0Ow0KCXRleHQtaW5kZW50Oi0uMjVpbjsNCgltc28tYW5zaS1mb250LXNpemU6MTAuMHB0 Ow0KCWZvbnQtZmFtaWx5OldpbmdkaW5nczt9DQpAbGlzdCBsMTE6bGV2ZWw5DQoJe21zby1sZXZl bC1udW1iZXItZm9ybWF0OmJ1bGxldDsNCgltc28tbGV2ZWwtdGV4dDrvgqc7DQoJbXNvLWxldmVs LXRhYi1zdG9wOjQuNWluOw0KCW1zby1sZXZlbC1udW1iZXItcG9zaXRpb246bGVmdDsNCgl0ZXh0 LWluZGVudDotLjI1aW47DQoJbXNvLWFuc2ktZm9udC1zaXplOjEwLjBwdDsNCglmb250LWZhbWls eTpXaW5nZGluZ3M7fQ0KQGxpc3QgbDEyDQoJe21zby1saXN0LWlkOjIxMzU1NjQ0MTY7DQoJbXNv LWxpc3QtdGVtcGxhdGUtaWRzOjcyODUwNDEzNjt9DQpAbGlzdCBsMTI6bGV2ZWwxDQoJe21zby1s ZXZlbC1udW1iZXItZm9ybWF0OmJ1bGxldDsNCgltc28tbGV2ZWwtdGV4dDrvgrc7DQoJbXNvLWxl dmVsLXRhYi1zdG9wOi41aW47DQoJbXNvLWxldmVsLW51bWJlci1wb3NpdGlvbjpsZWZ0Ow0KCXRl eHQtaW5kZW50Oi0uMjVpbjsNCgltc28tYW5zaS1mb250LXNpemU6MTAuMHB0Ow0KCWZvbnQtZmFt aWx5OlN5bWJvbDt9DQpAbGlzdCBsMTI6bGV2ZWwyDQoJe21zby1sZXZlbC1udW1iZXItZm9ybWF0 OmJ1bGxldDsNCgltc28tbGV2ZWwtdGV4dDpvOw0KCW1zby1sZXZlbC10YWItc3RvcDoxLjBpbjsN Cgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0K CW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1pbHk6IkNvdXJpZXIgTmV3IjsN Cgltc28tYmlkaS1mb250LWZhbWlseToiVGltZXMgTmV3IFJvbWFuIjt9DQpAbGlzdCBsMTI6bGV2 ZWwzDQoJe21zby1sZXZlbC1udW1iZXItZm9ybWF0OmJ1bGxldDsNCgltc28tbGV2ZWwtdGV4dDrv gqc7DQoJbXNvLWxldmVsLXRhYi1zdG9wOjEuNWluOw0KCW1zby1sZXZlbC1udW1iZXItcG9zaXRp b246bGVmdDsNCgl0ZXh0LWluZGVudDotLjI1aW47DQoJbXNvLWFuc2ktZm9udC1zaXplOjEwLjBw dDsNCglmb250LWZhbWlseTpXaW5nZGluZ3M7fQ0KQGxpc3QgbDEyOmxldmVsNA0KCXttc28tbGV2 ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ674KnOw0KCW1zby1sZXZl bC10YWItc3RvcDoyLjBpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0aW9uOmxlZnQ7DQoJdGV4 dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4wcHQ7DQoJZm9udC1mYW1p bHk6V2luZ2RpbmdzO30NCkBsaXN0IGwxMjpsZXZlbDUNCgl7bXNvLWxldmVsLW51bWJlci1mb3Jt YXQ6YnVsbGV0Ow0KCW1zby1sZXZlbC10ZXh0Ou+CpzsNCgltc28tbGV2ZWwtdGFiLXN0b3A6Mi41 aW47DQoJbXNvLWxldmVsLW51bWJlci1wb3NpdGlvbjpsZWZ0Ow0KCXRleHQtaW5kZW50Oi0uMjVp bjsNCgltc28tYW5zaS1mb250LXNpemU6MTAuMHB0Ow0KCWZvbnQtZmFtaWx5OldpbmdkaW5nczt9 DQpAbGlzdCBsMTI6bGV2ZWw2DQoJe21zby1sZXZlbC1udW1iZXItZm9ybWF0OmJ1bGxldDsNCglt c28tbGV2ZWwtdGV4dDrvgqc7DQoJbXNvLWxldmVsLXRhYi1zdG9wOjMuMGluOw0KCW1zby1sZXZl bC1udW1iZXItcG9zaXRpb246bGVmdDsNCgl0ZXh0LWluZGVudDotLjI1aW47DQoJbXNvLWFuc2kt Zm9udC1zaXplOjEwLjBwdDsNCglmb250LWZhbWlseTpXaW5nZGluZ3M7fQ0KQGxpc3QgbDEyOmxl dmVsNw0KCXttc28tbGV2ZWwtbnVtYmVyLWZvcm1hdDpidWxsZXQ7DQoJbXNvLWxldmVsLXRleHQ6 74KnOw0KCW1zby1sZXZlbC10YWItc3RvcDozLjVpbjsNCgltc28tbGV2ZWwtbnVtYmVyLXBvc2l0 aW9uOmxlZnQ7DQoJdGV4dC1pbmRlbnQ6LS4yNWluOw0KCW1zby1hbnNpLWZvbnQtc2l6ZToxMC4w cHQ7DQoJZm9udC1mYW1pbHk6V2luZ2RpbmdzO30NCkBsaXN0IGwxMjpsZXZlbDgNCgl7bXNvLWxl dmVsLW51bWJlci1mb3JtYXQ6YnVsbGV0Ow0KCW1zby1sZXZlbC10ZXh0Ou+CpzsNCgltc28tbGV2 ZWwtdGFiLXN0b3A6NC4waW47DQoJbXNvLWxldmVsLW51bWJlci1wb3NpdGlvbjpsZWZ0Ow0KCXRl eHQtaW5kZW50Oi0uMjVpbjsNCgltc28tYW5zaS1mb250LXNpemU6MTAuMHB0Ow0KCWZvbnQtZmFt aWx5OldpbmdkaW5nczt9DQpAbGlzdCBsMTI6bGV2ZWw5DQoJe21zby1sZXZlbC1udW1iZXItZm9y bWF0OmJ1bGxldDsNCgltc28tbGV2ZWwtdGV4dDrvgqc7DQoJbXNvLWxldmVsLXRhYi1zdG9wOjQu NWluOw0KCW1zby1sZXZlbC1udW1iZXItcG9zaXRpb246bGVmdDsNCgl0ZXh0LWluZGVudDotLjI1 aW47DQoJbXNvLWFuc2ktZm9udC1zaXplOjEwLjBwdDsNCglmb250LWZhbWlseTpXaW5nZGluZ3M7 fQ0Kb2wNCgl7bWFyZ2luLWJvdHRvbTowaW47fQ0KdWwNCgl7bWFyZ2luLWJvdHRvbTowaW47fQ0K LS0+PC9zdHlsZT48IS0tW2lmIGd0ZSBtc28gOV0+PHhtbD4NCjxvOnNoYXBlZGVmYXVsdHMgdjpl eHQ9ImVkaXQiIHNwaWRtYXg9IjEwMjYiIC8+DQo8L3htbD48IVtlbmRpZl0tLT48IS0tW2lmIGd0 ZSBtc28gOV0+PHhtbD4NCjxvOnNoYXBlbGF5b3V0IHY6ZXh0PSJlZGl0Ij4NCjxvOmlkbWFwIHY6 ZXh0PSJlZGl0IiBkYXRhPSIxIiAvPg0KPC9vOnNoYXBlbGF5b3V0PjwveG1sPjwhW2VuZGlmXS0t Pg0KPC9oZWFkPg0KPGJvZHkgbGFuZz0iRU4tVVMiIGxpbms9ImJsdWUiIHZsaW5rPSJwdXJwbGUi Pg0KPGRpdiBjbGFzcz0iV29yZFNlY3Rpb24xIj4NCjxwIGNsYXNzPSJNc29Ob3JtYWwiPjxzcGFu IHN0eWxlPSJmb250LXNpemU6MTEuMHB0O2ZvbnQtZmFtaWx5OiZxdW90O0NhbGlicmkmcXVvdDss JnF1b3Q7c2Fucy1zZXJpZiZxdW90Oztjb2xvcjojMUY0OTdEIj5IaSBWb2p0ZWNoLDxvOnA+PC9v OnA+PC9zcGFuPjwvcD4NCjxwIGNsYXNzPSJNc29Ob3JtYWwiPjxzcGFuIHN0eWxlPSJmb250LXNp emU6MTEuMHB0O2ZvbnQtZmFtaWx5OiZxdW90O0NhbGlicmkmcXVvdDssJnF1b3Q7c2Fucy1zZXJp ZiZxdW90Oztjb2xvcjojMUY0OTdEIj48bzpwPiZuYnNwOzwvbzpwPjwvc3Bhbj48L3A+DQo8cCBj bGFzcz0iTXNvTm9ybWFsIj48c3BhbiBzdHlsZT0iZm9udC1zaXplOjExLjBwdDtmb250LWZhbWls eTomcXVvdDtDYWxpYnJpJnF1b3Q7LCZxdW90O3NhbnMtc2VyaWYmcXVvdDs7Y29sb3I6IzFGNDk3 RCI+VGhhbmtzIGZvciB0aGUgcmVwbHkuIFRoZSBwbHVnaW4gZnJhbWV3b3JrIGZvciBhZGRpbmcg YSBjdXN0b20gY29udGV4dCBzZW5zaXRpdmUgYnV0dG9uL21lbnUgaXRlbSBhbmQgdGhlIGlmcmFt ZSBsb2FkaW5nIHN1cHBvcnQgZm9yIHRoZSBtYWluIHRhYiBwbHVnaW4gd2lsbA0KIGJlIHdlbGNv bWUgYWRkaXRpb25zLiA8bzpwPjwvbzpwPjwvc3Bhbj48L3A+DQo8cCBjbGFzcz0iTXNvTm9ybWFs Ij48c3BhbiBzdHlsZT0iZm9udC1zaXplOjExLjBwdDtmb250LWZhbWlseTomcXVvdDtDYWxpYnJp JnF1b3Q7LCZxdW90O3NhbnMtc2VyaWYmcXVvdDs7Y29sb3I6IzFGNDk3RCI+PG86cD4mbmJzcDs8 L286cD48L3NwYW4+PC9wPg0KPHAgY2xhc3M9Ik1zb05vcm1hbCI+PHNwYW4gc3R5bGU9ImZvbnQt c2l6ZToxMS4wcHQ7Zm9udC1mYW1pbHk6JnF1b3Q7Q2FsaWJyaSZxdW90OywmcXVvdDtzYW5zLXNl cmlmJnF1b3Q7O2NvbG9yOiMxRjQ5N0QiPkZvciB0aGUgY3VzdG9tIFVJIGRpYWxvZywgd2XigJly ZSBsb29raW5nIGZvciBzb21ldGhpbmcgdGhhdCB3b3JrcyBzaW1pbGFyIHRvIHRoZSB0YWIgaW4g dGhhdCBpdCB3aWxsIHNob3cgYSBwYXJ0aWN1bGFyIFVSTCBpbiBhbiBpRnJhbWUgaW4gYSBkaWFs b2cuIE9yIHBvdGVudGlhbGx5DQogc2luY2UgaXQgaXMgYSBkaWFsb2csIGl0IGNvdWxkIGp1c3Qg c2hvdyBpdCBpbiBzZXBhcmF0ZSB3aW5kb3cgYWx0b2dldGhlci4gVGhlIGRpYWxvZyB3b3VsZCBi ZSBvcGVuZWQgd2hlbiB0aGUgY29udGV4dCBzZW5zaXRpdmUgYnV0dG9uIG9yIG1lbnUgaXRlbSBp cyBhY3RpdmF0ZWQuIFNvIGl0IHdvdWxkIGJlIG5pY2UgaWYgdGhlIHBsdWdpbiBmcmFtZXdvcmsg d291bGQgYWxsb3cgYSBwbHVnZ2VkIGluIGJ1dHRvbiBkZWZpbml0aW9uIHRvIGRlZmluZQ0KIGEg VVJMIHRvIGxvYWQgaW4gYSBkaWFsb2cgd2hlbiBpdCBpcyBhY3RpdmF0ZWQuPG86cD48L286cD48 L3NwYW4+PC9wPg0KPHAgY2xhc3M9Ik1zb05vcm1hbCI+PHNwYW4gc3R5bGU9ImZvbnQtc2l6ZTox MS4wcHQ7Zm9udC1mYW1pbHk6JnF1b3Q7Q2FsaWJyaSZxdW90OywmcXVvdDtzYW5zLXNlcmlmJnF1 b3Q7O2NvbG9yOiMxRjQ5N0QiPjxvOnA+Jm5ic3A7PC9vOnA+PC9zcGFuPjwvcD4NCjxwIGNsYXNz PSJNc29Ob3JtYWwiPjxzcGFuIHN0eWxlPSJmb250LXNpemU6MTEuMHB0O2ZvbnQtZmFtaWx5OiZx dW90O0NhbGlicmkmcXVvdDssJnF1b3Q7c2Fucy1zZXJpZiZxdW90Oztjb2xvcjojMUY0OTdEIj5J 4oCZbGwgc3RhcnQgbG9va2luZyBhdCBhZGRpbmcgdGhlIGFiaWxpdHkgdG8gbGF1bmNoIGEgZGlh bG9nIHdpdGggY29udGV4dCB0aHJvdWdoIHRoZSBwbHVnaW4gQVBJIGFuZCBsZXQgeW91IGtub3cg aG93IHRoYXQgZ29lcyBpbiBhIGZldyBkYXlzIChNYXliZSBzb29uZXIgaWYNCiBJIGhhdmUgcXVl c3Rpb25zIGFib3V0IGl0LiA7KTxvOnA+PC9vOnA+PC9zcGFuPjwvcD4NCjxwIGNsYXNzPSJNc29O b3JtYWwiPjxzcGFuIHN0eWxlPSJmb250LXNpemU6MTEuMHB0O2ZvbnQtZmFtaWx5OiZxdW90O0Nh bGlicmkmcXVvdDssJnF1b3Q7c2Fucy1zZXJpZiZxdW90Oztjb2xvcjojMUY0OTdEIj48bzpwPiZu YnNwOzwvbzpwPjwvc3Bhbj48L3A+DQo8cCBjbGFzcz0iTXNvTm9ybWFsIj48c3BhbiBzdHlsZT0i Zm9udC1zaXplOjExLjBwdDtmb250LWZhbWlseTomcXVvdDtDYWxpYnJpJnF1b3Q7LCZxdW90O3Nh bnMtc2VyaWYmcXVvdDs7Y29sb3I6IzFGNDk3RCI+RmluYWxseSwgd291bGQgaXQgYmUgcG9zc2li bGUgdG8gZ2l2ZSBhbiBlc3RpbWF0ZSBvbiB3aGVuIHlvdSB0aGluayB0aGUgUG9DIHJldiA2IHdp bGwgYmUgYXZhaWxhYmxlPyBXZeKAmXZlIGdvdCBzY2hlZHVsZWQgZGVsaXZlcmllcyBpbnRlcm5h bGx5IGJhc2VkIG9uIHRoaXMNCiBjb2RlIGFuZCBpdCB3b3VsZCBiZSBiZXR0ZXIgdG8gbWFrZSBz dXJlIGV2ZXJ5dGhpbmcgbGluZXMgdXAgbm93LjxvOnA+PC9vOnA+PC9zcGFuPjwvcD4NCjxwIGNs YXNzPSJNc29Ob3JtYWwiPjxzcGFuIHN0eWxlPSJmb250LXNpemU6MTEuMHB0O2ZvbnQtZmFtaWx5 OiZxdW90O0NhbGlicmkmcXVvdDssJnF1b3Q7c2Fucy1zZXJpZiZxdW90Oztjb2xvcjojMUY0OTdE Ij48bzpwPiZuYnNwOzwvbzpwPjwvc3Bhbj48L3A+DQo8cCBjbGFzcz0iTXNvTm9ybWFsIj48c3Bh biBzdHlsZT0iZm9udC1zaXplOjExLjBwdDtmb250LWZhbWlseTomcXVvdDtDYWxpYnJpJnF1b3Q7 LCZxdW90O3NhbnMtc2VyaWYmcXVvdDs7Y29sb3I6IzFGNDk3RCI+VGhhbmtzITxvOnA+PC9vOnA+ PC9zcGFuPjwvcD4NCjxwIGNsYXNzPSJNc29Ob3JtYWwiPjxzcGFuIHN0eWxlPSJmb250LXNpemU6 MTEuMHB0O2ZvbnQtZmFtaWx5OiZxdW90O0NhbGlicmkmcXVvdDssJnF1b3Q7c2Fucy1zZXJpZiZx dW90Oztjb2xvcjojMUY0OTdEIj48bzpwPiZuYnNwOzwvbzpwPjwvc3Bhbj48L3A+DQo8cCBjbGFz cz0iTXNvTm9ybWFsIj48c3BhbiBzdHlsZT0iZm9udC1zaXplOjExLjBwdDtmb250LWZhbWlseTom cXVvdDtDYWxpYnJpJnF1b3Q7LCZxdW90O3NhbnMtc2VyaWYmcXVvdDs7Y29sb3I6IzFGNDk3RCI+ Q2hyaXM8bzpwPjwvbzpwPjwvc3Bhbj48L3A+DQo8cCBjbGFzcz0iTXNvTm9ybWFsIj48c3BhbiBz dHlsZT0iZm9udC1zaXplOjExLjBwdDtmb250LWZhbWlseTomcXVvdDtDYWxpYnJpJnF1b3Q7LCZx dW90O3NhbnMtc2VyaWYmcXVvdDs7Y29sb3I6IzFGNDk3RCI+PG86cD4mbmJzcDs8L286cD48L3Nw YW4+PC9wPg0KPGRpdj4NCjxkaXYgc3R5bGU9ImJvcmRlcjpub25lO2JvcmRlci10b3A6c29saWQg I0I1QzRERiAxLjBwdDtwYWRkaW5nOjMuMHB0IDBpbiAwaW4gMGluIj4NCjxwIGNsYXNzPSJNc29O b3JtYWwiPjxiPjxzcGFuIHN0eWxlPSJmb250LXNpemU6MTAuMHB0O2ZvbnQtZmFtaWx5OiZxdW90 O1RhaG9tYSZxdW90OywmcXVvdDtzYW5zLXNlcmlmJnF1b3Q7Ij5Gcm9tOjwvc3Bhbj48L2I+PHNw YW4gc3R5bGU9ImZvbnQtc2l6ZToxMC4wcHQ7Zm9udC1mYW1pbHk6JnF1b3Q7VGFob21hJnF1b3Q7 LCZxdW90O3NhbnMtc2VyaWYmcXVvdDsiPiBWb2p0ZWNoIFN6b2NzIFttYWlsdG86dnN6b2NzQHJl ZGhhdC5jb21dDQo8YnI+DQo8Yj5TZW50OjwvYj4gVHVlc2RheSwgT2N0b2JlciAwMiwgMjAxMiAy OjQ3IFBNPGJyPg0KPGI+VG86PC9iPiBNb3JyaXNzZXksIENocmlzdG9waGVyPGJyPg0KPGI+Q2M6 PC9iPiBDb3N0ZWEsIEdlb3JnZTsgU2Nob2VuYnJ1biwgRHVzdGluOyBlbmdpbmUtZGV2ZWxAb3Zp cnQub3JnPGJyPg0KPGI+U3ViamVjdDo8L2I+IFJlOiBbRW5naW5lLWRldmVsXSBVSSBQbHVnaW5z OiBQb0MgcGF0Y2ggcmV2aXNpb24gNSBpcyBoZXJlPG86cD48L286cD48L3NwYW4+PC9wPg0KPC9k aXY+DQo8L2Rpdj4NCjxwIGNsYXNzPSJNc29Ob3JtYWwiPjxvOnA+Jm5ic3A7PC9vOnA+PC9wPg0K PGRpdj4NCjxwIGNsYXNzPSJNc29Ob3JtYWwiPjxzcGFuIHN0eWxlPSJjb2xvcjpibGFjayI+SGkg Q2hyaXMsPGJyPg0KPGJyPg0KbWFueSB0aGFua3MgZm9yIHlvdXIgZmVlZGJhY2sgYW5kIHN1Z2dl c3Rpb25zIDopPGJyPg0KPGJyPg0KQWRkaW5nIGNvbnRleHQtc2Vuc2l0aXZlIGJ1dHRvbiB3aXRo IGNvcnJlc3BvbmRpbmcgbWVudSBpdGVtIHNvdW5kcyBnb29kISBJbiBmYWN0LCB0aGlzIGlzIHRo ZSBwcm9wZXIgd2F5IGhvdyBjb250ZXh0IG1lbnUgaXRlbXMgc2hvdWxkIGJlIGhhbmRsZWQsIHNp bmNlIFdlYkFkbWluIGRhdGEgZ3JpZHMgd29yayB3aXRoIGNvbnRleHQtc2Vuc2l0aXZlICZxdW90 O2FjdGlvbiBidXR0b25zJnF1b3Q7IHdoaWNoIGFyZSByZWZsZWN0ZWQgd2l0aGluIHRoZSBjb250 ZXh0DQogbWVudS4gSSBhZ3JlZSB0aGF0IHRoaXMgaXMgYSB2ZXJ5IHVzZWZ1bCBmZWF0dXJlIHRv IGhhdmUgaW4gcGx1Z2luIEFQSSwgaXQgc2hvdWxkIGJlIGltcGxlbWVudGVkIGFzIHBhcnQgb2Yg bmV4dCBtYWpvciBQb0MgcmV2aXNpb24uPGJyPg0KPGJyPg0KSSBoYXZlIGEgcXVlc3Rpb24gdGhv dWdoOiB3aGVuIHRoZSB1c2VyIGNsaWNrcyB0aGUgY3VzdG9tIGJ1dHRvbiBvciBjb3JyZXNwb25k aW5nIGNvbnRleHQgbWVudSBpdGVtLCB3aWxsIHlvdXIgcGx1Z2luIGhhbmRsZSBjb21tb24gZGlh bG9nIFVJIChldmVyeXRoaW5nIGV4Y2VwdCBhY3R1YWwgY29udGVudCkgb24gaXRzIG93biwgb3Ig ZG8geW91IHByZWZlciB0byBoYXZlIHNvbWUga2luZCBvZiAmcXVvdDtkaWFsb2cgVUkmcXVvdDsg QVBJIHRvIGNyZWF0ZSB0aGUNCiBzdGFuZGFyZC1sb29raW5nIGRpYWxvZyBmcmFtZSBmb3IgeW91 PyBJIGxpa2UgdGhlIGlkZWEgb2YgdXNpbmcgaWZyYW1lIHRvIHByZXNlbnQgY3VzdG9tIGNvbnRl bnQgdGhvdWdoIDopPGJyPg0KPGJyPg0KQXMgZm9yIGdyb3VwaW5nIG11bHRpcGxlIGNvbnRleHQt c2Vuc2l0aXZlIGJ1dHRvbnMgYW5kIGNvcnJlc3BvbmRpbmcgY29udGV4dCBtZW51IGl0ZW1zLCB0 aGlzIG1ha2VzIHNlbnNlIGFuZCB3ZSBoYXZlIHNvbWV0aGluZyBsaWtlIHRoaXMgYWxyZWFkeSBp bXBsZW1lbnRlZCBpbiBXZWJBZG1pbiAoaW4gSG9zdCBtYWluIHRhYiwgUG93ZXIgTWFuYWdlbWVu dCBkcm9wLWRvd24gZ3JvdXAgYnV0dG9uLCBidXQgdGhpcyBpcyBkZWZpbmVkIG5vdCB0bw0KIGFw cGVhciBpbiBjb250ZXh0IG1lbnUgdGhvdWdoKS4gSSB0aGluayB0aGlzIHNob3VsZCBiZSBwYXJ0 IG9mICZxdW90O2N1c3RvbSBjb250ZXh0LXNlbnNpdGl2ZSBidXR0b24gLyBtZW51IGl0ZW0mcXVv dDsgcGx1Z2luIEFQSSBmZWF0dXJlLjxicj4NCjxicj4NCiZndDsgPC9zcGFuPjxzcGFuIHN0eWxl PSJmb250LXNpemU6MTEuMHB0O2ZvbnQtZmFtaWx5OiZxdW90O0NhbGlicmkmcXVvdDssJnF1b3Q7 c2Fucy1zZXJpZiZxdW90Oztjb2xvcjojMUY0OTdEIj5JZiBuZWVkZWQgd2UgY2FuIGhlbHAgd29y ayBvbiBhbiBpbXBsZW1lbnRhdGlvbiBmb3IgdGhlIGRpYWxvZyBwb3B1cCBwbHVnaW4gZnJhbWV3 b3JrIGFzIHdl4oCZZCBsaWtlIHRvIGdldCBpdCBpbiByZWxhdGl2ZWx5IHF1aWNrbHkgc28gd2Ug Y2FuIG1vdmUgZm9yd2FyZCBvbiB0aGUgY29udGVudA0KIHNpZGUgb2Ygb3VyIHBsdWdpbi48L3Nw YW4+PHNwYW4gc3R5bGU9ImNvbG9yOmJsYWNrIj48YnI+DQo8YnI+DQpJZiBJIHVuZGVyc3RhbmQg Y29ycmVjdGx5LCB0aGlzIGlzIGFib3V0IHByb3ZpZGluZyAmcXVvdDtkaWFsb2cgVUkmcXVvdDsg QVBJIHRvIGNyZWF0ZSB0aGUgc3RhbmRhcmQtbG9va2luZyBkaWFsb2cgZnJhbWUgJiM0MzsgY3Vz dG9tIGNvbnRlbnQgaWZyYW1lLiBJJ2QgbGlrZSB0byBoZWxwIHdpdGggdGhpcyBhcyB3ZWxsLCZu YnNwOyBidXQgeW91IGNhbiBwbGF5IHdpdGggdGhlIGNvZGUgYW5kIHByb3Bvc2UgYSBwYXRjaCBv biB0b3Agb2YgUG9DIHJldi41IFtodHRwOi8vZ2Vycml0Lm92aXJ0Lm9yZy84MTIwXS48YnI+DQo8 YnI+DQomZ3Q7IDwvc3Bhbj48c3BhbiBzdHlsZT0iZm9udC1zaXplOjExLjBwdDtmb250LWZhbWls eTomcXVvdDtDYWxpYnJpJnF1b3Q7LCZxdW90O3NhbnMtc2VyaWYmcXVvdDs7Y29sb3I6IzFGNDk3 RCI+Rm9yIHRoZSByZXZlcnNlIHByb3h5LCB3b3VsZCBpdCBiZSBlYXNpZXIgZnJvbSBhIGN1c3Rv bWVyIHN0YW5kcG9pbnQgdG8ganVzdCBpbmNsdWRlIGEgcmV2ZXJzZSBwcm94eSBzZXJ2bGV0IHN1 Y2ggYXMgdGhpcyBvbmU/PGJyPg0KPC9zcGFuPjxzcGFuIHN0eWxlPSJjb2xvcjpibGFjayI+PGJy Pg0KQWN0dWFsbHksIEkgd2FzIHVuZGVyIHRoZSBpbXByZXNzaW9uIHRoYXQgb1ZpcnQgRW5naW5l ICgzLjEpIHBhY2thZ2UgKG92aXJ0LWVuZ2luZSkgdGFrZXMgY2FyZSBvZiBzZXR0aW5nIHVwIEFw YWNoZSB3ZWIgc2VydmVyLCB3aGljaCByZWRpcmVjdHMgYWxsIHRyYWZmaWMgdG8gRW5naW5lIEpC b3NzIEFTIGJ5IGRlZmF1bHQgKGJ1dCBtYXliZSBJIGFtIHdyb25nIGhlcmUpLiBIb3dldmVyLCBp ZiB0aGlzIGlzIHRoZSBjYXNlLCBhbiBlZmZpY2llbnQNCiB3YXkgdG8gd29yayBhcm91bmQgc2Ft ZS1vcmlnaW4gcG9saWN5IChjcm9zcy1vcmlnaW4gaXNzdWVzKSBpcyB0byBjb25maWd1cmUgQXBh Y2hlJ3MgcmV2ZXJlc2UgcHJveHkgbW9kdWxlIChtb2RfcHJveHkpLCBhcyBkaXNjdXNzZWQgaW4g YW5vdGhlciB0aHJlYWQgb24gZW5naW5lLWRldmVsOg0KPGEgaHJlZj0iaHR0cDovL2xpc3RzLm92 aXJ0Lm9yZy9waXBlcm1haWwvZW5naW5lLWRldmVsLzIwMTItU2VwdGVtYmVyLzAwMjUxMS5odG1s Ij4NCmh0dHA6Ly9saXN0cy5vdmlydC5vcmcvcGlwZXJtYWlsL2VuZ2luZS1kZXZlbC8yMDEyLVNl cHRlbWJlci8wMDI1MTEuaHRtbDwvYT48YnI+DQo8YnI+DQpUaGlzIHdheSwgeW91IGNvdWxkIHVz ZSBBcGFjaGUgdG8gYnJpbmcgRW5naW5lIGFuZCBhcmJpdHJhcnkgKGxvY2FsIG9yIHJlbW90ZSkg d2ViIHNlcnZpY2VzIG9uIHNhbWUgb3JpZ2luLiBXaGF0IGRvIHlvdSB0aGluaz88YnI+DQo8YnI+ DQpPbiB0aGUgb3RoZXIgaGFuZCwgdXNpbmcgYSBzcGVjaWFsLXB1cnBvc2UgcmV2ZXJzZSBwcm94 eSBzZXJ2bGV0IGRpcmVjdGx5IGluIEVuZ2luZSwgbm90IHN1cmUgaWYgdGhhdCdzIGEgZ29vZCBp ZGVhIHRob3VnaC4uIChJJ2QgcHJlZmVyIGNvbmZpZ3VyaW5nICZxdW90O2Zyb250LWVuZCZxdW90 OyB3ZWIgc2VydmVyLCBzdWNoIGFzIEFwYWNoZSwgZm9yIHRoaXMgcHVycG9zZSk8YnI+DQo8YnI+ DQpJJ20gYWxzbyBzZW5kaW5nIGEgY291cGxlIG9mIHVwZGF0ZXM6PGJyPg0KPGJyPg0KPHN0cm9u Zz5VSSBQbHVnaW5zIEZvbGxvdy1VcCBNZWV0aW5nOjwvc3Ryb25nPiBzY2hlZHVsZWQgZm9yIFR1 ZXNkYXksIE9jdG9iZXIgOSBhdCA0cG0gR01UJiM0MzsxIChJJ2xsIHNlbmQgYSBtZWV0aW5nIGlu dml0YXRpb24gc29vbiwgYWxzbyBwbGFubmluZyB0byByZS13cml0ZSBvVmlydCBVSSBQbHVnaW5z IHdpa2kgc29vbiBhZnRlciB0aGF0KTxicj4NCjxicj4NCjxiPlBvQyByZXYuNSBwYXRjaCB1cGRh dGU6PC9iPiBtYW55IHRoYW5rcyB0byBKdWFuIGFuZCBEb3JvbiBmb3IgcmV2aWV3aW5nIHRoZSBy ZWNlbnQgcGF0Y2ggW2h0dHA6Ly9nZXJyaXQub3ZpcnQub3JnLzgxMjBdISBJJ2xsIHVwZGF0ZSB0 aGUgcGF0Y2ggYWNjb3JkaW5nbHkgYXMgcmV2aXNpb24gNS4xPGJyPg0KPGJyPg0KPGI+UGxhbm5l ZCBpdGVtcyB0byBiZSBpbmNsdWRlZCBpbiBQb0MgcmV2aXNpb24gNjo8L2I+PG86cD48L286cD48 L3NwYW4+PC9wPg0KPHVsIHR5cGU9ImRpc2MiPg0KPGxpIGNsYXNzPSJNc29Ob3JtYWwiIHN0eWxl PSJjb2xvcjpibGFjazttc28tbWFyZ2luLXRvcC1hbHQ6YXV0bzttc28tbWFyZ2luLWJvdHRvbS1h bHQ6YXV0bzttc28tbGlzdDpsNyBsZXZlbDEgbGZvMSI+DQphZGRpbmcgY3VzdG9tIGNvbnRleHQt c2Vuc2l0aXZlIGJ1dHRvbiAoZWl0aGVyIHNlcGFyYXRlbHkgb3Igd2l0aGluIGEgYnV0dG9uIGdy b3VwKSwgYWxvbmcgd2l0aCBjb3JyZXNwb25kaW5nIGNvbnRleHQgbWVudSBpdGVtIHJlcHJlc2Vu dGF0aW9uPG86cD48L286cD48L2xpPjxsaSBjbGFzcz0iTXNvTm9ybWFsIiBzdHlsZT0iY29sb3I6 YmxhY2s7bXNvLW1hcmdpbi10b3AtYWx0OmF1dG87bXNvLW1hcmdpbi1ib3R0b20tYWx0OmF1dG87 bXNvLWxpc3Q6bDcgbGV2ZWwxIGxmbzEiPg0KdXBkYXRlIGN1c3RvbSBtYWluIHRhYiB0byBzaG93 IHRoZSBhY3R1YWwgY29udGVudCAoaWZyYW1lKSBmcm9tIHRoZSBnaXZlbiBVUkw8bzpwPjwvbzpw PjwvbGk+PGxpIGNsYXNzPSJNc29Ob3JtYWwiIHN0eWxlPSJjb2xvcjpibGFjazttc28tbWFyZ2lu LXRvcC1hbHQ6YXV0bzttc28tbWFyZ2luLWJvdHRvbS1hbHQ6YXV0bzttc28tbGlzdDpsNyBsZXZl bDEgbGZvMSI+DQphZGRpbmcgY3VzdG9tIHN1YiB0YWIgdGhhdCBzaG93cyBjb250ZW50IGZyb20g dGhlIGdpdmVuIFVSTDxvOnA+PC9vOnA+PC9saT48L3VsPg0KPHA+PHNwYW4gc3R5bGU9ImNvbG9y OmJsYWNrIj48bzpwPiZuYnNwOzwvbzpwPjwvc3Bhbj48L3A+DQo8cD48Yj48c3BhbiBzdHlsZT0i Y29sb3I6YmxhY2siPk1vcmUgaXRlbXMgdG8gY29uc2lkZXIgaGF2aW5nIGluIFBvQyByZXZpc2lv biA2Ojwvc3Bhbj48L2I+PHNwYW4gc3R5bGU9ImNvbG9yOmJsYWNrIj48bzpwPjwvbzpwPjwvc3Bh bj48L3A+DQo8dWwgdHlwZT0iZGlzYyI+DQo8bGkgY2xhc3M9Ik1zb05vcm1hbCIgc3R5bGU9ImNv bG9yOmJsYWNrO21zby1tYXJnaW4tdG9wLWFsdDphdXRvO21zby1tYXJnaW4tYm90dG9tLWFsdDph dXRvO21zby1saXN0OmwxMSBsZXZlbDEgbGZvMiI+DQomcXVvdDtkaWFsb2cgVUkmcXVvdDsgQVBJ IHRvIGNyZWF0ZSB0aGUgc3RhbmRhcmQtbG9va2luZyBkaWFsb2cgZnJhbWUgJiM0MzsgY3VzdG9t IGNvbnRlbnQgaWZyYW1lPG86cD48L286cD48L2xpPjxsaSBjbGFzcz0iTXNvTm9ybWFsIiBzdHls ZT0iY29sb3I6YmxhY2s7bXNvLW1hcmdpbi10b3AtYWx0OmF1dG87bXNvLW1hcmdpbi1ib3R0b20t YWx0OmF1dG87bXNvLWxpc3Q6bDExIGxldmVsMSBsZm8yIj4NCkVuZ2luZSBSRVNUIEFQSSBleHBv c2VkIHRocm91Z2ggcGx1Z2luIEFQSTxvOnA+PC9vOnA+PC9saT48bGkgY2xhc3M9Ik1zb05vcm1h bCIgc3R5bGU9ImNvbG9yOmJsYWNrO21zby1tYXJnaW4tdG9wLWFsdDphdXRvO21zby1tYXJnaW4t Ym90dG9tLWFsdDphdXRvO21zby1saXN0OmwxMSBsZXZlbDEgbGZvMiI+DQppbnRlZ3JhdGlvbiB3 aXRoIFRhc2tzIHBhbmUgdG8gcHJvdmlkZSB2aXN1YWwgZmVlZGJhY2sgb24gY3VzdG9tIG9wZXJh dGlvbnM8bzpwPjwvbzpwPjwvbGk+PGxpIGNsYXNzPSJNc29Ob3JtYWwiIHN0eWxlPSJjb2xvcjpi bGFjazttc28tbWFyZ2luLXRvcC1hbHQ6YXV0bzttc28tbWFyZ2luLWJvdHRvbS1hbHQ6YXV0bztt c28tbGlzdDpsMTEgbGV2ZWwxIGxmbzIiPg0KZXh0ZW5kaW5nIGV4aXN0aW5nIGRpYWxvZ3MgKGUu Zy4gRWRpdCBDbHVzdGVyIFBvbGljeSAtIGN1c3RvbSBwcm9wZXJ0aWVzKTxvOnA+PC9vOnA+PC9s aT48L3VsPg0KPHA+PHNwYW4gc3R5bGU9ImNvbG9yOmJsYWNrIj48bzpwPiZuYnNwOzwvbzpwPjwv c3Bhbj48L3A+DQo8cD48c3BhbiBzdHlsZT0iY29sb3I6YmxhY2siPkxldCBtZSBrbm93IHdoYXQg eW91IHRoaW5rLjxvOnA+PC9vOnA+PC9zcGFuPjwvcD4NCjxwPjxzcGFuIHN0eWxlPSJjb2xvcjpi bGFjayI+PG86cD4mbmJzcDs8L286cD48L3NwYW4+PC9wPg0KPHAgY2xhc3M9Ik1zb05vcm1hbCIg c3R5bGU9Im1hcmdpbi1ib3R0b206MTIuMHB0Ij48c3BhbiBzdHlsZT0iY29sb3I6YmxhY2siPlJl Z2FyZHMsPGJyPg0KVm9qdGVjaDxicj4NCjxicj4NCjxvOnA+PC9vOnA+PC9zcGFuPjwvcD4NCjxk aXYgY2xhc3M9Ik1zb05vcm1hbCIgYWxpZ249ImNlbnRlciIgc3R5bGU9InRleHQtYWxpZ246Y2Vu dGVyIj48c3BhbiBzdHlsZT0iY29sb3I6YmxhY2siPg0KPGhyIHNpemU9IjIiIHdpZHRoPSIxMDAl IiBhbGlnbj0iY2VudGVyIiBpZD0iendjaHIiPg0KPC9zcGFuPjwvZGl2Pg0KPGRpdj4NCjxwIGNs YXNzPSJNc29Ob3JtYWwiIHN0eWxlPSJtYXJnaW4tYm90dG9tOjEyLjBwdCI+PGI+PHNwYW4gc3R5 bGU9ImZvbnQtZmFtaWx5OiZxdW90O0hlbHZldGljYSZxdW90OywmcXVvdDtzYW5zLXNlcmlmJnF1 b3Q7O2NvbG9yOmJsYWNrIj5Gcm9tOg0KPC9zcGFuPjwvYj48c3BhbiBzdHlsZT0iZm9udC1mYW1p bHk6JnF1b3Q7SGVsdmV0aWNhJnF1b3Q7LCZxdW90O3NhbnMtc2VyaWYmcXVvdDs7Y29sb3I6Ymxh Y2siPiZxdW90O0NocmlzdG9waGVyIE1vcnJpc3NleSZxdW90OyAmbHQ7Q2hyaXN0b3BoZXIuTW9y cmlzc2V5QG5ldGFwcC5jb20mZ3Q7PGJyPg0KPGI+VG86IDwvYj52c3pvY3NAcmVkaGF0LmNvbTxi cj4NCjxiPkNjOiA8L2I+JnF1b3Q7R2VvcmdlIENvc3RlYSZxdW90OyAmbHQ7R2VvcmdlLkNvc3Rl YUBuZXRhcHAuY29tJmd0OywgJnF1b3Q7RHVzdGluIFNjaG9lbmJydW4mcXVvdDsgJmx0O0R1c3Rp bi5TY2hvZW5icnVuQG5ldGFwcC5jb20mZ3Q7LCBlbmdpbmUtZGV2ZWxAb3ZpcnQub3JnPGJyPg0K PGI+U2VudDogPC9iPlR1ZXNkYXksIE9jdG9iZXIgMiwgMjAxMiA2OjE1OjM0IFBNPGJyPg0KPGI+ U3ViamVjdDogPC9iPlJFOiBbRW5naW5lLWRldmVsXSBVSSBQbHVnaW5zOiBQb0MgcGF0Y2ggcmV2 aXNpb24gNSBpcyBoZXJlPG86cD48L286cD48L3NwYW4+PC9wPg0KPHAgY2xhc3M9Ik1zb05vcm1h bCI+PHNwYW4gc3R5bGU9ImZvbnQtc2l6ZToxMS4wcHQ7Zm9udC1mYW1pbHk6JnF1b3Q7Q2FsaWJy aSZxdW90OywmcXVvdDtzYW5zLXNlcmlmJnF1b3Q7O2NvbG9yOiMxRjQ5N0QiPkhpIFZvanRlY2gs PC9zcGFuPjxzcGFuIHN0eWxlPSJjb2xvcjpibGFjayI+PG86cD48L286cD48L3NwYW4+PC9wPg0K PHAgY2xhc3M9Ik1zb05vcm1hbCI+PHNwYW4gc3R5bGU9ImZvbnQtc2l6ZToxMS4wcHQ7Zm9udC1m YW1pbHk6JnF1b3Q7Q2FsaWJyaSZxdW90OywmcXVvdDtzYW5zLXNlcmlmJnF1b3Q7O2NvbG9yOiMx RjQ5N0QiPiZuYnNwOzwvc3Bhbj48c3BhbiBzdHlsZT0iY29sb3I6YmxhY2siPjxvOnA+PC9vOnA+ PC9zcGFuPjwvcD4NCjxwIGNsYXNzPSJNc29Ob3JtYWwiPjxzcGFuIHN0eWxlPSJmb250LXNpemU6 MTEuMHB0O2ZvbnQtZmFtaWx5OiZxdW90O0NhbGlicmkmcXVvdDssJnF1b3Q7c2Fucy1zZXJpZiZx dW90Oztjb2xvcjojMUY0OTdEIj5UaGUgcGF0Y2ggaXMgZ3JlYXQgYW5kIGhhcyBjbGVhcmVkIHVw IHNvbWUgcXVlc3Rpb25zIEkgaGFkIGFib3V0IHRoZSBpbXBsZW1lbnRhdGlvbi4gSeKAmXZlIGJl ZW4gYWJsZSB0byBnZXQgdGhlIHNhbXBsZSBwbHVnaW5zIHdvcmtpbmcgYW5kIHdhZGVkIHRocm91 Z2ggdGhlDQogY29kZSBjaGFuZ2VzLCBzbyBmZWVsIGxpa2UgSSBoYXZlIGEgZ29vZCB1bmRlcnN0 YW5kaW5nIG9mIHdoYXQgd2FzIGRlbGl2ZXJlZC4gVGhhbmtzIGEgbG90IGZvciBwdXR0aW5nIHRo aXMgYWxsIHRvZ2V0aGVyLiBJIGRvIGhhdmUgYSBmZXcgcXVlc3Rpb25zIGFuZCBzdWdnZXN0aW9u cyBmb3IgeW91LCB0aG91Z2guPC9zcGFuPjxzcGFuIHN0eWxlPSJjb2xvcjpibGFjayI+PG86cD48 L286cD48L3NwYW4+PC9wPg0KPHAgY2xhc3M9Ik1zb05vcm1hbCI+PHNwYW4gc3R5bGU9ImZvbnQt c2l6ZToxMS4wcHQ7Zm9udC1mYW1pbHk6JnF1b3Q7Q2FsaWJyaSZxdW90OywmcXVvdDtzYW5zLXNl cmlmJnF1b3Q7O2NvbG9yOiMxRjQ5N0QiPiZuYnNwOzwvc3Bhbj48c3BhbiBzdHlsZT0iY29sb3I6 YmxhY2siPjxvOnA+PC9vOnA+PC9zcGFuPjwvcD4NCjxwIGNsYXNzPSJNc29Ob3JtYWwiPjxzcGFu IHN0eWxlPSJmb250LXNpemU6MTEuMHB0O2ZvbnQtZmFtaWx5OiZxdW90O0NhbGlicmkmcXVvdDss JnF1b3Q7c2Fucy1zZXJpZiZxdW90Oztjb2xvcjojMUY0OTdEIj5XaWxsIHRoZXJlIGV2ZW50dWFs bHkgYmUgYSB3YXkgdG8gYWRkIG9uZSBvciBtb3JlIGJ1dHRvbnMgdG8gdGhlIGNvbnRleHQgc2Vu c2l0aXZlIGJ1dHRvbnMgYW5kIG1lbnVzIHRocm91Z2hvdXQgdGhlIGludGVyZmFjZT8gRm9yIGV4 YW1wbGUsIHdl4oCZZCBsaWtlIHRvIGFsbG93DQogYSBidXR0b24gdG8gcHJvdmlzaW9uIGEgZGF0 YXN0b3JlIHdoZW4gYSBkYXRhIGNlbnRlciwgY2x1c3Rlciwgb3IgaG9zdCBpcyBzZWxlY3RlZC4g V2hlbiB0aGUgYnV0dG9uIGlzIGNsaWNrZWQsIGl0IHdvdWxkIG9wZW4gYSBkaWFsb2cgd2l0aCBh biBpZnJhbWUgaW4gd2hpY2ggd2Ugd291bGQgbG9hZCBvdXIgaW50ZXJmYWNlIHRvIHBlcmZvcm0g dGhlIGFzc29jaWF0ZWQgYWN0aW9uLiBTb21lIGNvbnRleHRzIHdvdWxkIGhhdmUgc2V2ZXJhbCBi dXR0b25zLA0KIHN1Y2ggYXMgYSBzdG9yYWdlIGRvbWFpbiAocHJvdmlzaW9uLCByZXNpemUsIGRl ZHVwZSBtYW5hZ2VtZW50LCBkZXN0cm95KSBzbyBpdCB3b3VsZCBwcm9iYWJseSBtYWtlIHNlbnNl IGZvciBhIGRyb3AgZG93biBtZW51IHRvIGJlIGF2YWlsYWJsZSBhcyB3ZWxsIHNvIHRoYXQgdGhl IG51bWJlciBvZiBidXR0b25zIGFib3ZlIHRoZSB0YWJsZSBkb2VzbuKAmXQgZ2V0IHRvbyBjbHV0 dGVyZWQuIFdl4oCZZCBhbHNvIGxpa2UgdG8gYWRkIHRoZXNlIHNhbWUNCiBhY3Rpb25zIHRvIHRo ZSBtZW51cyB0aGF0IHBvcHVwIHdoZW4gYSBjb250ZXh0dWFsIG9iamVjdCBpcyByaWdodCBjbGlj a2VkLjwvc3Bhbj48c3BhbiBzdHlsZT0iY29sb3I6YmxhY2siPjxvOnA+PC9vOnA+PC9zcGFuPjwv cD4NCjxwIGNsYXNzPSJNc29Ob3JtYWwiPjxzcGFuIHN0eWxlPSJmb250LXNpemU6MTEuMHB0O2Zv bnQtZmFtaWx5OiZxdW90O0NhbGlicmkmcXVvdDssJnF1b3Q7c2Fucy1zZXJpZiZxdW90Oztjb2xv cjojMUY0OTdEIj4mbmJzcDs8L3NwYW4+PHNwYW4gc3R5bGU9ImNvbG9yOmJsYWNrIj48bzpwPjwv bzpwPjwvc3Bhbj48L3A+DQo8cCBjbGFzcz0iTXNvTm9ybWFsIj48c3BhbiBzdHlsZT0iZm9udC1z aXplOjExLjBwdDtmb250LWZhbWlseTomcXVvdDtDYWxpYnJpJnF1b3Q7LCZxdW90O3NhbnMtc2Vy aWYmcXVvdDs7Y29sb3I6IzFGNDk3RCI+SWYgbmVlZGVkIHdlIGNhbiBoZWxwIHdvcmsgb24gYW4g aW1wbGVtZW50YXRpb24gZm9yIHRoZSBkaWFsb2cgcG9wdXAgcGx1Z2luIGZyYW1ld29yayBhcyB3 ZeKAmWQgbGlrZSB0byBnZXQgaXQgaW4gcmVsYXRpdmVseSBxdWlja2x5IHNvIHdlIGNhbiBtb3Zl IGZvcndhcmQgb24NCiB0aGUgY29udGVudCBzaWRlIG9mIG91ciBwbHVnaW4uPC9zcGFuPjxzcGFu IHN0eWxlPSJjb2xvcjpibGFjayI+PG86cD48L286cD48L3NwYW4+PC9wPg0KPHAgY2xhc3M9Ik1z b05vcm1hbCI+PHNwYW4gc3R5bGU9ImZvbnQtc2l6ZToxMS4wcHQ7Zm9udC1mYW1pbHk6JnF1b3Q7 Q2FsaWJyaSZxdW90OywmcXVvdDtzYW5zLXNlcmlmJnF1b3Q7O2NvbG9yOiMxRjQ5N0QiPiZuYnNw Ozwvc3Bhbj48c3BhbiBzdHlsZT0iY29sb3I6YmxhY2siPjxvOnA+PC9vOnA+PC9zcGFuPjwvcD4N CjxwIGNsYXNzPSJNc29Ob3JtYWwiPjxzcGFuIHN0eWxlPSJmb250LXNpemU6MTEuMHB0O2ZvbnQt ZmFtaWx5OiZxdW90O0NhbGlicmkmcXVvdDssJnF1b3Q7c2Fucy1zZXJpZiZxdW90Oztjb2xvcjoj MUY0OTdEIj5Gb3IgdGhlIHJldmVyc2UgcHJveHksIHdvdWxkIGl0IGJlIGVhc2llciBmcm9tIGEg Y3VzdG9tZXIgc3RhbmRwb2ludCB0byBqdXN0IGluY2x1ZGUgYSByZXZlcnNlIHByb3h5IHNlcnZs ZXQgc3VjaCBhcyB0aGlzIG9uZT8gJm5ic3A7PC9zcGFuPjxzcGFuIHN0eWxlPSJjb2xvcjpibGFj ayI+PGEgaHJlZj0iaHR0cDovL3NvdXJjZWZvcmdlLm5ldC9wcm9qZWN0cy9qMmVwLyIgdGFyZ2V0 PSJfYmxhbmsiPmh0dHA6Ly9zb3VyY2Vmb3JnZS5uZXQvcHJvamVjdHMvajJlcC88L2E+DQo8bzpw PjwvbzpwPjwvc3Bhbj48L3A+DQo8cCBjbGFzcz0iTXNvTm9ybWFsIj48c3BhbiBzdHlsZT0iZm9u dC1zaXplOjExLjBwdDtmb250LWZhbWlseTomcXVvdDtDYWxpYnJpJnF1b3Q7LCZxdW90O3NhbnMt c2VyaWYmcXVvdDs7Y29sb3I6IzFGNDk3RCI+SeKAmW0ganVzdCB0aGlua2luZyB0aGF0IHNldHRp bmcgdXAgYW5kIG1hbmFnaW5nIGEgcGx1Z2luIGZvciB0aGUgSFRUUCBzZXJ2ZXIgbWF5IGJlIG1v cmUgY29tcGxleCB0aGFuIGluY2x1ZGluZyBvbmUgaW50ZXJuYWxseSB0aGF0IHdvdWxkIGJlIHRy YW5zcGFyZW50IHRvIGENCiBjdXN0b21lci48L3NwYW4+PHNwYW4gc3R5bGU9ImNvbG9yOmJsYWNr Ij48bzpwPjwvbzpwPjwvc3Bhbj48L3A+DQo8cCBjbGFzcz0iTXNvTm9ybWFsIj48c3BhbiBzdHls ZT0iZm9udC1zaXplOjExLjBwdDtmb250LWZhbWlseTomcXVvdDtDYWxpYnJpJnF1b3Q7LCZxdW90 O3NhbnMtc2VyaWYmcXVvdDs7Y29sb3I6IzFGNDk3RCI+Jm5ic3A7PC9zcGFuPjxzcGFuIHN0eWxl PSJjb2xvcjpibGFjayI+PG86cD48L286cD48L3NwYW4+PC9wPg0KPHAgY2xhc3M9Ik1zb05vcm1h bCI+PHNwYW4gc3R5bGU9ImZvbnQtc2l6ZToxMS4wcHQ7Zm9udC1mYW1pbHk6JnF1b3Q7Q2FsaWJy aSZxdW90OywmcXVvdDtzYW5zLXNlcmlmJnF1b3Q7O2NvbG9yOiMxRjQ5N0QiPlRoYW5rcyw8L3Nw YW4+PHNwYW4gc3R5bGU9ImNvbG9yOmJsYWNrIj48bzpwPjwvbzpwPjwvc3Bhbj48L3A+DQo8cCBj bGFzcz0iTXNvTm9ybWFsIj48c3BhbiBzdHlsZT0iZm9udC1zaXplOjExLjBwdDtmb250LWZhbWls eTomcXVvdDtDYWxpYnJpJnF1b3Q7LCZxdW90O3NhbnMtc2VyaWYmcXVvdDs7Y29sb3I6IzFGNDk3 RCI+Q2hyaXM8L3NwYW4+PHNwYW4gc3R5bGU9ImNvbG9yOmJsYWNrIj48bzpwPjwvbzpwPjwvc3Bh bj48L3A+DQo8YmxvY2txdW90ZSBzdHlsZT0ibWFyZ2luLXRvcDo1LjBwdDttYXJnaW4tYm90dG9t OjUuMHB0Ij4NCjxkaXY+DQo8cCBjbGFzcz0iTXNvTm9ybWFsIiBzdHlsZT0ibWFyZ2luLWJvdHRv bToxMi4wcHQiPjxiPjxzcGFuIHN0eWxlPSJjb2xvcjpibGFjayI+RnJvbTo8L3NwYW4+PC9iPjxz cGFuIHN0eWxlPSJjb2xvcjpibGFjayI+IFZvanRlY2ggU3pvY3MgJmx0OzxhIGhyZWY9Im1haWx0 bzp2c3pvY3NAcmVkaGF0LmNvbSIgdGFyZ2V0PSJfYmxhbmsiPnZzem9jc0ByZWRoYXQuY29tPC9h PiZndDs8YnI+DQo8Yj5EYXRlOjwvYj4gU2VwdGVtYmVyIDIxLCAyMDEyIDQ6Mzc6MzEgUE0gRURU PGJyPg0KPGI+VG86PC9iPiBlbmdpbmUtZGV2ZWwgJmx0OzxhIGhyZWY9Im1haWx0bzplbmdpbmUt ZGV2ZWxAb3ZpcnQub3JnIiB0YXJnZXQ9Il9ibGFuayI+ZW5naW5lLWRldmVsQG92aXJ0Lm9yZzwv YT4mZ3Q7PGJyPg0KPGI+U3ViamVjdDo8L2I+IDxiPltFbmdpbmUtZGV2ZWxdIFVJIFBsdWdpbnM6 IFBvQyBwYXRjaCByZXZpc2lvbiA1IGlzIGhlcmU8L2I+PG86cD48L286cD48L3NwYW4+PC9wPg0K PC9kaXY+DQo8L2Jsb2NrcXVvdGU+DQo8YmxvY2txdW90ZSBzdHlsZT0ibWFyZ2luLXRvcDo1LjBw dDttYXJnaW4tYm90dG9tOjUuMHB0Ij4NCjxkaXY+DQo8ZGl2Pg0KPHAgY2xhc3M9Ik1zb05vcm1h bCIgc3R5bGU9Im1hcmdpbi1ib3R0b206MTIuMHB0Ij48c3BhbiBzdHlsZT0iY29sb3I6YmxhY2si PkhpIGd1eXMsPGJyPg0KPGJyPg0KaXQncyBiZWVuIGEgd2hpbGUgYnV0IGhlcmUgY29tZXMgdGhl IGxhdGVzdCByZXZpc2lvbiBvZiBVSSBQbHVnaW5zIHByb29mLW9mLWNvbmNlcHQgcGF0Y2ggKHBs ZWFzZSBmaW5kIGl0IGF0dGFjaGVkKS48YnI+DQo8YnI+DQpUaGlzIHJldmlzaW9uIHdhcyBvcmln aW5hbGx5IG1lYW50IHRvIGZvY3VzIHNvbGVseSBvbiBzZXJ2ZXItc2lkZSBjb21wb25lbnRzIG9m IHRoZSBwbHVnaW4gaW5mcmFzdHJ1Y3R1cmUuIEhvd2V2ZXIsIEkgZW5kZWQgdXAgaW1wbGVtZW50 aW5nIGFsbCB0aGUgbWFqb3IgY29uY2VwdHMgYW5kIGlkZWFzIGFzIGRpc2N1c3NlZCBvbiBlbmdp bmUtZGV2ZWwgbWFpbGluZyBsaXN0LCBpbXBhY3RpbmcgYm90aCBjbGllbnQtc2lkZSBhbmQgc2Vy dmVyLXNpZGUNCiBwYXJ0cyBvZiB0aGUgcGx1Z2luIGluZnJhc3RydWN0dXJlLiBBcyBhIHJlc3Vs dCwgVUkgcGx1Z2luIGluZnJhc3RydWN0dXJlIHNob3VsZCBiZSBwcmV0dHkgbXVjaCBjb21wbGV0 ZSBub3csIHNvIHdlIGNhbiBmb2N1cyBvbiBzcGVjaWZpYyBwbHVnaW4gQVBJIGZlYXR1cmVzIGlu IHVwY29taW5nIFBvQyByZXZpc2lvbnMuPGJyPg0KPGJyPg0KVGhlcmUncyBhIHdob2xlIGJ1bmNo IG9mIGNoYW5nZXMgYW5kIGltcHJvdmVtZW50cyBpbiB0aGlzIHJldmlzaW9uLCBzbyBJJ2xsIHRy eSB0byBjb3ZlciBhbGwgdGhlIHJlbGV2YW50IHBhcnRzIHN0ZXAgYnkgc3RlcC4gSWYgeW91IGhh dmUgYW55IGNvbW1lbnRzLCBxdWVzdGlvbnMgb3IgaWRlYXMsIHBsZWFzZSBsZXQgbWUga25vdyE8 YnI+DQo8YnI+DQpTbyBoZXJlIHdlIGdvLi4uIChvciBpZiB5b3UganVzdCB3YW50IHRvIGdldCB0 aGUgcGF0Y2gsIGZpbmQgdGhlIGxpbmsgYXQgdGhlIGVuZCBvZiB0aGlzIG1lc3NhZ2UpPG86cD48 L286cD48L3NwYW4+PC9wPg0KPGRpdiBjbGFzcz0iTXNvTm9ybWFsIiBhbGlnbj0iY2VudGVyIiBz dHlsZT0idGV4dC1hbGlnbjpjZW50ZXIiPjxzcGFuIHN0eWxlPSJjb2xvcjpibGFjayI+DQo8aHIg c2l6ZT0iMiIgd2lkdGg9IjEwMCUiIGFsaWduPSJjZW50ZXIiPg0KPC9zcGFuPjwvZGl2Pg0KPHAg Y2xhc3M9Ik1zb05vcm1hbCI+PHNwYW4gc3R5bGU9ImNvbG9yOmJsYWNrIj48YnI+DQo8c3Ryb25n PjAuIEFkZGVkIG5ldyBFbmdpbmUgY29uZmlndXJhdGlvbiB2YWx1ZXM8L3N0cm9uZz48Yj48YnI+ DQo8L2I+PGJyPg0KPHU+VUkgcGx1Z2luIGRhdGEgcGF0aDwvdT4gaXMgcmVwcmVzZW50ZWQgYnkg PGVtPkNvbmZpZ1ZhbHVlcy5VSVBsdWdpbkRhdGFQYXRoPC9lbT4gZW51bSBvcHRpb24gKCZxdW90 O1VJUGx1Z2luRGF0YVBhdGgmcXVvdDsgaW4NCjxpPnZkY19vcHRpb25zPC9pPiB0YWJsZSksIGFu ZCByZXNvbHZlZCByZWxhdGl2ZSB0byA8aT5Db25maWdWYWx1ZXMuRGF0YURpcjwvaT4gaWYgcG9z c2libGUuIEZvbGxvd2luZyAoZGVmYXVsdCkgdmFsdWVzOjxvOnA+PC9vOnA+PC9zcGFuPjwvcD4N Cjx1bCB0eXBlPSJkaXNjIj4NCjxsaSBjbGFzcz0iTXNvTm9ybWFsIiBzdHlsZT0iY29sb3I6Ymxh Y2s7bXNvLW1hcmdpbi10b3AtYWx0OmF1dG87bXNvLW1hcmdpbi1ib3R0b20tYWx0OmF1dG87bXNv LWxpc3Q6bDAgbGV2ZWwxIGxmbzMiPg0KPGk+VUlQbHVnaW5EYXRhUGF0aCA9IHVpLXBsdWdpbnM8 L2k+PG86cD48L286cD48L2xpPjxsaSBjbGFzcz0iTXNvTm9ybWFsIiBzdHlsZT0iY29sb3I6Ymxh Y2s7bXNvLW1hcmdpbi10b3AtYWx0OmF1dG87bXNvLW1hcmdpbi1ib3R0b20tYWx0OmF1dG87bXNv LWxpc3Q6bDAgbGV2ZWwxIGxmbzMiPg0KPGk+RGF0YURpciA9IC91c3Ivc2hhcmUvb3ZpcnQtZW5n aW5lPC9pPjxvOnA+PC9vOnA+PC9saT48L3VsPg0KPHAgY2xhc3M9Ik1zb05vcm1hbCI+PHNwYW4g c3R5bGU9ImNvbG9yOmJsYWNrIj5yZXN1bHQgaW4gVUkgcGx1Z2luIGRhdGEgcGF0aDogPGk+DQov dXNyL3NoYXJlL292aXJ0LWVuZ2luZS91aS1wbHVnaW5zPC9pPjxicj4NCjxicj4NCjx1PlVJIHBs dWdpbiBjb25maWcgcGF0aDwvdT4gaXMgcmVwcmVzZW50ZWQgYnkgPGk+Q29uZmlnVmFsdWVzLlVJ UGx1Z2luQ29uZmlnUGF0aDwvaT4gZW51bSBvcHRpb24gKCZxdW90O1VJUGx1Z2luQ29uZmlnUGF0 aCZxdW90OyBpbg0KPGk+dmRjX29wdGlvbnM8L2k+IHRhYmxlKSwgYW5kIHJlc29sdmVkIHJlbGF0 aXZlIHRvIDxpPkNvbmZpZ1ZhbHVlcy5Db25maWdEaXI8L2k+IGlmIHBvc3NpYmxlLiBGb2xsb3dp bmcgKGRlZmF1bHQpIHZhbHVlczo8bzpwPjwvbzpwPjwvc3Bhbj48L3A+DQo8dWwgdHlwZT0iZGlz YyI+DQo8bGkgY2xhc3M9Ik1zb05vcm1hbCIgc3R5bGU9ImNvbG9yOmJsYWNrO21zby1tYXJnaW4t dG9wLWFsdDphdXRvO21zby1tYXJnaW4tYm90dG9tLWFsdDphdXRvO21zby1saXN0OmwzIGxldmVs MSBsZm80Ij4NCjxpPlVJUGx1Z2luQ29uZmlnUGF0aCA9IHVpLXBsdWdpbnM8L2k+PG86cD48L286 cD48L2xpPjxsaSBjbGFzcz0iTXNvTm9ybWFsIiBzdHlsZT0iY29sb3I6YmxhY2s7bXNvLW1hcmdp bi10b3AtYWx0OmF1dG87bXNvLW1hcmdpbi1ib3R0b20tYWx0OmF1dG87bXNvLWxpc3Q6bDMgbGV2 ZWwxIGxmbzQiPg0KPGk+Q29uZmlnRGlyID0gL2V0Yy9vdmlydC1lbmdpbmU8L2k+PG86cD48L286 cD48L2xpPjwvdWw+DQo8cD48c3BhbiBzdHlsZT0iY29sb3I6YmxhY2siPnJlc3VsdCBpbiBVSSBw bHVnaW4gY29uZmlnIHBhdGg6IDxpPi9ldGMvb3ZpcnQtZW5naW5lL3VpLXBsdWdpbnM8L2k+PG86 cD48L286cD48L3NwYW4+PC9wPg0KPHAgY2xhc3M9Ik1zb05vcm1hbCI+PHNwYW4gc3R5bGU9ImNv bG9yOmJsYWNrIj48YnI+DQo8Yj4xLiBQcm9jZXNzaW5nIFVJIHBsdWdpbiBkYXRhIG9uIHRoZSBz ZXJ2ZXI8YnI+DQo8L2I+PGJyPg0KPGk+UGx1Z2luRGF0YU1hbmFnZXI8L2k+IGlzIHRoZSBjbGFz cyByZXNwb25zaWJsZSBmb3IgcmVhZGluZywgdmFsaWRhdGluZyBhbmQgY2FjaGluZyBVSSBwbHVn aW4gZGVzY3JpcHRvci9jb25maWd1cmF0aW9uIGRhdGEgb24gdGhlIHNlcnZlciAoRW5naW5lKS4g SXQgaGFzIHR3byBtYWluIHJlc3BvbnNpYmlsaXRpZXM6PG86cD48L286cD48L3NwYW4+PC9wPg0K PHVsIHR5cGU9ImRpc2MiPg0KPGxpIGNsYXNzPSJNc29Ob3JtYWwiIHN0eWxlPSJjb2xvcjpibGFj azttc28tbWFyZ2luLXRvcC1hbHQ6YXV0bzttc28tbWFyZ2luLWJvdHRvbS1hbHQ6YXV0bzttc28t bGlzdDpsMiBsZXZlbDEgbGZvNSI+DQpyZXR1cm4gYSBzbmFwc2hvdCBvZiBjdXJyZW50bHkgdmFs aWQgcGx1Z2luIGRhdGEgKDxpPmdldEN1cnJlbnREYXRhPC9pPiBtZXRob2QpPG86cD48L286cD48 L2xpPjxsaSBjbGFzcz0iTXNvTm9ybWFsIiBzdHlsZT0iY29sb3I6YmxhY2s7bXNvLW1hcmdpbi10 b3AtYWx0OmF1dG87bXNvLW1hcmdpbi1ib3R0b20tYWx0OmF1dG87bXNvLWxpc3Q6bDIgbGV2ZWwx IGxmbzUiPg0KcmVsb2FkIHBsdWdpbiBkYXRhIGZyb20gbG9jYWwgZmlsZSBzeXN0ZW0gaWYgbmVj ZXNzYXJ5ICg8aT5yZWxvYWREYXRhPC9pPiBtZXRob2QpPG86cD48L286cD48L2xpPjwvdWw+DQo8 cD48c3BhbiBzdHlsZT0iY29sb3I6YmxhY2siPlRoZSA8aT5yZWxvYWREYXRhPC9pPiBtZXRob2Qg ZG9lc24ndCBtb2RpZnkgJnF1b3Q7bGl2ZSZxdW90OyBwbHVnaW4gZGF0YSBkaXJlY3RseS4gSW5z dGVhZCwgaXQgY3JlYXRlcyBhIGxvY2FsIHdvcmtpbmcgY29weSBvZiBjdXJyZW50IHBsdWdpbiBk YXRhLCB1cGRhdGVzIHRoaXMgY29weSBhcyBpdCByZWFkcy92YWxpZGF0ZXMgcGx1Z2luIGRlc2Ny aXB0b3IgYW5kIGNvbmZpZ3VyYXRpb24gZmlsZXMsIGFuZCBhdHRlbXB0cw0KIHRvIHVwZGF0ZSAm cXVvdDtsaXZlJnF1b3Q7IHBsdWdpbiBkYXRhIHRocm91Z2ggY29uZGl0aW9uYWwgcmVmZXJlbmNl IHJlLWFzc2lnbm1lbnQgKHVzaW5nIDxpPg0KamF2YS51dGlsLmNvbmN1cnJlbnQuYXRvbWljLkF0 b21pY1JlZmVyZW5jZS5jb21wYXJlQW5kU2V0PC9pPiBtZXRob2QpLjxvOnA+PC9vOnA+PC9zcGFu PjwvcD4NCjxwPjxzcGFuIHN0eWxlPSJjb2xvcjpibGFjayI+Jm5ic3A7PG86cD48L286cD48L3Nw YW4+PC9wPg0KPHA+PHNwYW4gc3R5bGU9ImNvbG9yOmJsYWNrIj5JbiBvdGhlciB3b3JkcywgPGk+ cmVsb2FkRGF0YTwvaT4gbWV0aG9kIG1ha2VzIG5vIGF0dGVtcHRzIHdpdGggcmVnYXJkIHRvIEph dmEgbG9jay1iYXNlZCBzeW5jaHJvbml6YXRpb24sIGluIGZhdm9yIG9mIGRlYWxpbmcgd2l0aCAm cXVvdDtsaXZlJnF1b3Q7IGRhdGEgdGhyb3VnaA0KPGk+QXRvbWljUmVmZXJlbmNlPC9pPiAocmVm ZXJlbmNlIHRoYXQgaW52b2x2ZXMgYXRvbWljIDxpPnZvbGF0aWxlPC9pPiByZWFkcyBhbmQgd3Jp dGVzKTo8bzpwPjwvbzpwPjwvc3Bhbj48L3A+DQo8dWwgdHlwZT0iZGlzYyI+DQo8bGkgY2xhc3M9 Ik1zb05vcm1hbCIgc3R5bGU9ImNvbG9yOmJsYWNrO21zby1tYXJnaW4tdG9wLWFsdDphdXRvO21z by1tYXJnaW4tYm90dG9tLWFsdDphdXRvO21zby1saXN0Omw0IGxldmVsMSBsZm82Ij4NCkluIHRo ZSBiZXN0IGNhc2UsIGEgdGhyZWFkIHdpbGwgc3VjY2VlZCBpbiB1cGRhdGluZyAmcXVvdDtsaXZl JnF1b3Q7IGRhdGEgKDxpPkF0b21pY1JlZmVyZW5jZS5jb21wYXJlQW5kU2V0PC9pPiA9PSB0cnVl KSwgd2hpY2ggbWVhbnMgdGhhdCAmcXVvdDtsaXZlJnF1b3Q7IGRhdGEgcmVtYWluZWQgdW5jaGFu Z2VkIHNpbmNlIHRoaXMgdGhyZWFkIGFjcXVpcmVkIGEgcmVmZXJlbmNlIG9mIGN1cnJlbnQgcGx1 Z2luIGRhdGEuPG86cD48L286cD48L2xpPjxsaSBjbGFzcz0iTXNvTm9ybWFsIiBzdHlsZT0iY29s b3I6YmxhY2s7bXNvLW1hcmdpbi10b3AtYWx0OmF1dG87bXNvLW1hcmdpbi1ib3R0b20tYWx0OmF1 dG87bXNvLWxpc3Q6bDQgbGV2ZWwxIGxmbzYiPg0KSW4gdGhlIHdvcnN0IGNhc2UsIGEgdGhyZWFk IHdpbGwgTk9UIHN1Y2NlZWQgaW4gdXBkYXRpbmcgJnF1b3Q7bGl2ZSZxdW90OyBkYXRhICg8aT5B dG9taWNSZWZlcmVuY2UuY29tcGFyZUFuZFNldDwvaT4gPT0gZmFsc2UpLCB3aGljaCBtZWFucyB0 aGF0ICZxdW90O2xpdmUmcXVvdDsgZGF0YSB3YXMgYWxyZWFkeSBjaGFuZ2VkIGJ5IGFub3RoZXIg dGhyZWFkIHNpbmNlIHRoaXMgdGhyZWFkIGFjcXVpcmVkIGEgcmVmZXJlbmNlIG9mIGN1cnJlbnQg cGx1Z2luIGRhdGEuPG86cD48L286cD48L2xpPjwvdWw+DQo8cD48c3BhbiBzdHlsZT0iY29sb3I6 YmxhY2siPkluIG15IG9waW5pb24sIHdoZW4gZGVhbGluZyB3aXRoIGV4dGVybmFsIHJlc291cmNl cyBsaWtlIHRoZSBsb2NhbCBmaWxlIHN5c3RlbSwgdGhpcyBpcyBhIGdvb2QgY29tcHJvbWlzZSBi ZXR3ZWVuIHBlcmZvcm1hbmNlIGFuZCB1cC10by1kYXRlIGRhdGEuIFdoaWxlIHdlIG1pZ2h0IG5v dCBnZXQgJnF1b3Q7Y29tcGxldGVseS11cC10by1kYXRlJnF1b3Q7IGRhdGEgYXQgdGhlIGdpdmVu IHBvaW50IGluIHRpbWUgKDxpPnJlbG9hZERhdGENCiAmIzQzOyBnZXRDdXJyZW50RGF0YTwvaT4p LCB3ZSBhcmUgZ3VhcmFudGVlZCB0byBnZXQgJnF1b3Q7cmVjZW50bHktdXAtdG8tZGF0ZSZxdW90 OyBhbmQgY29uc2lzdGVudCBkYXRhLiBJbiBvdGhlciB3b3JkcywgdGhlIHJlcXVpcmVtZW50IG9m ICZxdW90O2NvbXBsZXRlbHktdXAtdG8tZGF0ZSZxdW90OyBkYXRhIHdvdWxkIGludm9sdmUNCjxp PnN5bmNocm9uaXplZDwvaT4gc3RhdGVtZW50cyB0aGF0IHdvdWxkIGh1cnQgcGVyZm9ybWFuY2Uu IEluIG15ICh2ZXJ5IGh1bWJsZSkgb3BpbmlvbiwgdGhlIGJlbmVmaXQgb2YgaGF2aW5nICZxdW90 O2NvbXBsZXRlbHktdXAtdG8tZGF0ZSZxdW90OyBkYXRhLCBhdCB0aGUgY29zdCBvZiByZWR1Y2Vk IHBlcmZvcm1hbmNlLCBpcyBub3QgcmVhbGx5IHdvcnRoIGl0LCBlc3BlY2lhbGx5IGluIG91ciBj YXNlIHdoZW4gdGhlIHVzZXIgY2FuIGp1c3QgaGl0IHJlZnJlc2gNCiAoRjUpIHRvIHJlbG9hZCBX ZWJBZG1pbiBhbmQgaXRzIHBsdWdpbiBkYXRhLjxvOnA+PC9vOnA+PC9zcGFuPjwvcD4NCjxwPjxz cGFuIHN0eWxlPSJjb2xvcjpibGFjayI+Jm5ic3A7PG86cD48L286cD48L3NwYW4+PC9wPg0KPHA+ PHU+PHNwYW4gc3R5bGU9ImNvbG9yOmJsYWNrIj5QbHVnaW4gZGVzY3JpcHRvciBmaWxlczwvc3Bh bj48L3U+PHNwYW4gc3R5bGU9ImNvbG9yOmJsYWNrIj4gYXJlIGV4cGVjdGVkIHRvIGJlIHBsYWNl ZCBpbiBVSSBwbHVnaW4gZGF0YSBwYXRoLCBmb3IgZXhhbXBsZToNCjxpPi91c3Ivc2hhcmUvb3Zp cnQtZW5naW5lL3VpLXBsdWdpbnMvZm9vLmpzb248L2k+PG86cD48L286cD48L3NwYW4+PC9wPg0K PHA+PHNwYW4gc3R5bGU9ImNvbG9yOmJsYWNrIj4mbmJzcDs8bzpwPjwvbzpwPjwvc3Bhbj48L3A+ DQo8cD48c3BhbiBzdHlsZT0iY29sb3I6YmxhY2siPkZvbGxvd2luZyBkZXNjcmlwdG9yIGZpbGUg YXR0cmlidXRlcyBhcmUgaW1wbGVtZW50ZWQgYW5kIHJlY29nbml6ZWQgYnkgdGhlIHBsdWdpbiBp bmZyYXN0cnVjdHVyZTo8bzpwPjwvbzpwPjwvc3Bhbj48L3A+DQo8dWwgdHlwZT0iZGlzYyI+DQo8 bGkgY2xhc3M9Ik1zb05vcm1hbCIgc3R5bGU9ImNvbG9yOmJsYWNrO21zby1tYXJnaW4tdG9wLWFs dDphdXRvO21zby1tYXJnaW4tYm90dG9tLWFsdDphdXRvO21zby1saXN0OmwxMCBsZXZlbDEgbGZv NyI+DQo8aT5uYW1lPC9pPjogQSBuYW1lIHRoYXQgdW5pcXVlbHkgaWRlbnRpZmllcyB0aGUgcGx1 Z2luIChyZXF1aXJlZCBhdHRyaWJ1dGUpLjxvOnA+PC9vOnA+PC9saT48bGkgY2xhc3M9Ik1zb05v cm1hbCIgc3R5bGU9ImNvbG9yOmJsYWNrO21zby1tYXJnaW4tdG9wLWFsdDphdXRvO21zby1tYXJn aW4tYm90dG9tLWFsdDphdXRvO21zby1saXN0OmwxMCBsZXZlbDEgbGZvNyI+DQo8aT51cmw8L2k+ OiBVUkwgb2YgcGx1Z2luIGhvc3QgcGFnZSB0aGF0IGludm9rZXMgdGhlIHBsdWdpbiBjb2RlIChy ZXF1aXJlZCBhdHRyaWJ1dGUpLjxvOnA+PC9vOnA+PC9saT48bGkgY2xhc3M9Ik1zb05vcm1hbCIg c3R5bGU9ImNvbG9yOmJsYWNrO21zby1tYXJnaW4tdG9wLWFsdDphdXRvO21zby1tYXJnaW4tYm90 dG9tLWFsdDphdXRvO21zby1saXN0OmwxMCBsZXZlbDEgbGZvNyI+DQo8aT5jb25maWc8L2k+OiBE ZWZhdWx0IGNvbmZpZ3VyYXRpb24gb2JqZWN0IGFzc29jaWF0ZWQgd2l0aCB0aGUgcGx1Z2luIChv cHRpb25hbCBhdHRyaWJ1dGUpLjxvOnA+PC9vOnA+PC9saT48bGkgY2xhc3M9Ik1zb05vcm1hbCIg c3R5bGU9ImNvbG9yOmJsYWNrO21zby1tYXJnaW4tdG9wLWFsdDphdXRvO21zby1tYXJnaW4tYm90 dG9tLWFsdDphdXRvO21zby1saXN0OmwxMCBsZXZlbDEgbGZvNyI+DQo8aT5yZXNvdXJjZVBhdGg8 L2k+OiBQYXRoIHRvIHBsdWdpbiBzdGF0aWMgcmVzb3VyY2VzLCByZWxhdGl2ZSB0byBVSSBwbHVn aW4gZGF0YSBwYXRoIChvcHRpb25hbCBhdHRyaWJ1dGUpLiBUaGlzIGlzIHVzZWQgd2hlbiBzZXJ2 aW5nIHBsdWdpbiBmaWxlcyB0aHJvdWdoIEVuZ2luZQ0KPGk+UGx1Z2luUmVzb3VyY2VTZXJ2bGV0 PC9pPiAobW9yZSBvbiB0aGlzIGJlbG93KS48bzpwPjwvbzpwPjwvbGk+PC91bD4NCjxwPjx1Pjxz cGFuIHN0eWxlPSJjb2xvcjpibGFjayI+UGx1Z2luIGNvbmZpZ3VyYXRpb24gZmlsZXM8L3NwYW4+ PC91PjxzcGFuIHN0eWxlPSJjb2xvcjpibGFjayI+IGFyZSBleHBlY3RlZCB0byBiZSBwbGFjZWQg aW4gVUkgcGx1Z2luIGNvbmZpZyBwYXRoLCBmb3IgZXhhbXBsZToNCjxpPi9ldGMvZW5naW5lL3Vp LXBsdWdpbnMvZm9vLWNvbmZpZy5qc29uPC9pPjxvOnA+PC9vOnA+PC9zcGFuPjwvcD4NCjxwPjxz cGFuIHN0eWxlPSJjb2xvcjpibGFjayI+Jm5ic3A7PG86cD48L286cD48L3NwYW4+PC9wPg0KPHA+ PHNwYW4gc3R5bGU9ImNvbG9yOmJsYWNrIj5Ob3RlIHRoYXQgcGx1Z2luIGNvbmZpZ3VyYXRpb24g ZmlsZXMgZm9sbG93IHRoZSAmcXVvdDsmbHQ7ZGVzY3JpcHRvckZpbGVOYW1lJmd0Oy1jb25maWcu anNvbiZxdW90OyBjb252ZW50aW9uLjxvOnA+PC9vOnA+PC9zcGFuPjwvcD4NCjxwPjxzcGFuIHN0 eWxlPSJjb2xvcjpibGFjayI+Jm5ic3A7PG86cD48L286cD48L3NwYW4+PC9wPg0KPHA+PHNwYW4g c3R5bGU9ImNvbG9yOmJsYWNrIj5Gb2xsb3dpbmcgY29uZmlndXJhdGlvbiBmaWxlIGF0dHJpYnV0 ZXMgYXJlIGltcGxlbWVudGVkIGFuZCByZWNvZ25pemVkIGJ5IHRoZSBwbHVnaW4gaW5mcmFzdHJ1 Y3R1cmU6PG86cD48L286cD48L3NwYW4+PC9wPg0KPHVsIHR5cGU9ImRpc2MiPg0KPGxpIGNsYXNz PSJNc29Ob3JtYWwiIHN0eWxlPSJjb2xvcjpibGFjazttc28tbWFyZ2luLXRvcC1hbHQ6YXV0bztt c28tbWFyZ2luLWJvdHRvbS1hbHQ6YXV0bzttc28tbGlzdDpsOSBsZXZlbDEgbGZvOCI+DQo8aT5j b25maWc8L2k+OiBDdXN0b20gY29uZmlndXJhdGlvbiBvYmplY3QgYXNzb2NpYXRlZCB3aXRoIHRo ZSBwbHVnaW4gKG9wdGlvbmFsIGF0dHJpYnV0ZSkuIFRoaXMgb3ZlcnJpZGVzIHRoZSBkZWZhdWx0 IHBsdWdpbiBkZXNjcmlwdG9yIGNvbmZpZ3VyYXRpb24sIGlmIGFueS48bzpwPjwvbzpwPjwvbGk+ PGxpIGNsYXNzPSJNc29Ob3JtYWwiIHN0eWxlPSJjb2xvcjpibGFjazttc28tbWFyZ2luLXRvcC1h bHQ6YXV0bzttc28tbWFyZ2luLWJvdHRvbS1hbHQ6YXV0bzttc28tbGlzdDpsOSBsZXZlbDEgbGZv OCI+DQo8aT5lbmFibGVkPC9pPjogSW5kaWNhdGVzIHdoZXRoZXIgdGhlIHBsdWdpbiBzaG91bGQg YmUgbG9hZGVkIG9uIFdlYkFkbWluIHN0YXJ0dXAgKG9wdGlvbmFsIGF0dHJpYnV0ZSkuIERlZmF1 bHQgdmFsdWUgaXMgJ3RydWUnLjxvOnA+PC9vOnA+PC9saT48bGkgY2xhc3M9Ik1zb05vcm1hbCIg c3R5bGU9ImNvbG9yOmJsYWNrO21zby1tYXJnaW4tdG9wLWFsdDphdXRvO21zby1tYXJnaW4tYm90 dG9tLWFsdDphdXRvO21zby1saXN0Omw5IGxldmVsMSBsZm84Ij4NCjxpPm9yZGVyPC9pPjogRGVm aW5lcyB0aGUgcmVsYXRpdmUgb3JkZXIgaW4gd2hpY2ggdGhlIHBsdWdpbiB3aWxsIGJlIGxvYWRl ZCBvbiBXZWJBZG1pbiBzdGFydHVwIChvcHRpb25hbCBhdHRyaWJ1dGUpLiBEZWZhdWx0IHZhbHVl IGlzDQo8aT5JbnRlZ2VyLk1BWF9WQUxVRTwvaT4gKGxvd2VzdCBvcmRlcikuPG86cD48L286cD48 L2xpPjwvdWw+DQo8cD48c3BhbiBzdHlsZT0iY29sb3I6YmxhY2siPlRoZSBjb25jZXB0IG9mIG1l cmdpbmcgY3VzdG9tIGNvbmZpZ3VyYXRpb24gKDxpPmNvbmZpZzwvaT4gYXR0cmlidXRlIGluDQo8 aT5mb28tY29uZmlnLmpzb248L2k+KSwgaWYgYW55LCBvbiB0b3Agb2YgZGVmYXVsdCBjb25maWd1 cmF0aW9uICg8aT5jb25maWc8L2k+IGF0dHJpYnV0ZSBpbg0KPGk+Zm9vLmpzb248L2k+KSwgaWYg YW55LCByZW1haW5zIHVuY2hhbmdlZC4gVGhpcyBtYWtlcyB0aGUgcGx1Z2luIGNvbmZpZ3VyYXRp b24gcXVpdGUgZmxleGlibGUgLSBpbiBteSBvcGluaW9uLCB0aGUgYWRkZWQgY29tcGxleGl0eSBv ZiBoYW5kbGluZy9tZXJnaW5nIHN1Y2ggY29uZmlndXJhdGlvbiBpcyBkZWZpbml0ZWx5IHdvcnRo IHRoZSBlZmZvcnQuPG86cD48L286cD48L3NwYW4+PC9wPg0KPHA+PHNwYW4gc3R5bGU9ImNvbG9y OmJsYWNrIj4mbmJzcDs8bzpwPjwvbzpwPjwvc3Bhbj48L3A+DQo8cD48c3BhbiBzdHlsZT0iY29s b3I6YmxhY2siPlRoZSA8aT5lbmFibGVkPC9pPiBhdHRyaWJ1dGUgaXMgc3RyYWlnaHQtZm9yd2Fy ZCwgYWxsb3dpbmcgdXNlcnMgdG8gdHVybiB0aGUgZ2l2ZW4gcGx1Z2luIG9mZiwgaWYgbmVjZXNz YXJ5LiBJbiBmdXR1cmUsIHVzZXJzIHNob3VsZCBzdGlsbCBiZSBhYmxlIHRvIGxvYWQgc3VjaCBw bHVnaW5zIHRocm91Z2ggV2ViQWRtaW4gR1VJLjxvOnA+PC9vOnA+PC9zcGFuPjwvcD4NCjxwPjxz cGFuIHN0eWxlPSJjb2xvcjpibGFjayI+Jm5ic3A7PG86cD48L286cD48L3NwYW4+PC9wPg0KPHA+ PHNwYW4gc3R5bGU9ImNvbG9yOmJsYWNrIj5UaGUgPGk+b3JkZXI8L2k+IGF0dHJpYnV0ZSBjb250 cm9scyB0aGUgb3JkZXIgaW4gd2hpY2ggcGx1Z2lucyBhcmUgbG9hZGVkIG9uIFdlYkFkbWluIHN0 YXJ0dXAuIFNpbmNlIHBsdWdpbiByZXNvdXJjZXMgYXJlIGZldGNoZWQgYXN5bmNocm9ub3VzbHkg YnkgdGhlIGJyb3dzZXIsIHRoaXMgaXMgYmFzaWNhbGx5IGEgd2F5IG9mIGltcG9zaW5nIHNvbWUg ZGVncmVlIG9mIGRldGVybWluaXNtIGluIHRoZQ0KICZxdW90O2dlbmVyYWxseS1ub24tZGV0ZXJt aW5pc3RpYyZxdW90OyBwbHVnaW4gZW52aXJvbm1lbnQsIHdoaWNoIGlzIGhlbHBmdWwgd2hlbiB0 cm91Ymxlc2hvb3RpbmcgcHJvYmxlbXMgd2l0aCBtdWx0aXBsZSBwbHVnaW5zLiBUaGlzIGF0dHJp YnV0ZSBpcyBhbHNvIGhlbHBmdWwgZHVlIHRvIGZpbGUgbGlzdGluZyBtZXRob2RzIGluDQo8aT5q YXZhLmlvLkZpbGU8L2k+IGdpdmluZyBubyBndWFyYW50ZWVzIHRoYXQgZmlsZXMgd291bGQgYmUg bGlzdGVkIGluIGFueSBwYXJ0aWN1bGFyIG9yZGVyIChvdGhlcndpc2Ugd2UgY291bGQganVzdCBn byBmb3IgdGhlICZxdW90O05OLSZsdDtkZXNjcmlwdG9yRmlsZU5hbWUmZ3Q7Lmpzb24mcXVvdDsg Y29udmVudGlvbiwgd2l0aCBOTiBiZWluZyB0aGUgb3JkZXIgbnVtYmVyKS48bzpwPjwvbzpwPjwv c3Bhbj48L3A+DQo8cCBjbGFzcz0iTXNvTm9ybWFsIj48c3BhbiBzdHlsZT0iY29sb3I6YmxhY2si Pjxicj4NCjxiPjIuIE1vZGlmaWVkIGJlaGF2aW9yIG9mIFdlYmFkbWluRHluYW1pY0hvc3RpbmdT ZXJ2bGV0PGJyPg0KPC9iPjxicj4NCjxpPldlYmFkbWluRHluYW1pY0hvc3RpbmdTZXJ2bGV0PC9p PiBpcyB0aGUgc2VydmxldCB1c2VkIHRvIHNlcnZlIFdlYkFkbWluIGFwcGxpY2F0aW9uIGhvc3Qg cGFnZSAoSFRNTCBwYWdlIHRoYXQgYm9vdHN0cmFwcyBXZWJBZG1pbiBKYXZhU2NyaXB0IGNvZGUp Ljxicj4NCjxicj4NCkluIGFkZGl0aW9uIHRvIGl0cyBmb3JtZXIgYmVoYXZpb3IsIGFzIHBhcnQg b2YgaGFuZGxpbmcgdGhlIGdpdmVuIHJlcXVlc3QsIDxpPldlYmFkbWluRHluYW1pY0hvc3RpbmdT ZXJ2bGV0PC9pPjo8bzpwPjwvbzpwPjwvc3Bhbj48L3A+DQo8dWwgdHlwZT0iZGlzYyI+DQo8bGkg Y2xhc3M9Ik1zb05vcm1hbCIgc3R5bGU9ImNvbG9yOmJsYWNrO21zby1tYXJnaW4tdG9wLWFsdDph dXRvO21zby1tYXJnaW4tYm90dG9tLWFsdDphdXRvO21zby1saXN0Omw4IGxldmVsMSBsZm85Ij4N CnJlbG9hZHMgZGVzY3JpcHRvci9jb25maWd1cmF0aW9uIGRhdGEgZnJvbSBsb2NhbCBmaWxlIHN5 c3RlbSBpZiBuZWNlc3NhcnksIGFuZCBvYnRhaW5zIGEgc25hcHNob3Qgb2YgY3VycmVudGx5IHZh bGlkIHBsdWdpbiBkYXRhICg8aT5QbHVnaW5EYXRhTWFuYWdlci5yZWxvYWRBbmRHZXRDdXJyZW50 RGF0YTwvaT4pPG86cD48L286cD48L2xpPjxsaSBjbGFzcz0iTXNvTm9ybWFsIiBzdHlsZT0iY29s b3I6YmxhY2s7bXNvLW1hcmdpbi10b3AtYWx0OmF1dG87bXNvLW1hcmdpbi1ib3R0b20tYWx0OmF1 dG87bXNvLWxpc3Q6bDggbGV2ZWwxIGxmbzkiPg0KZW1iZWRzIGFsbCBwbHVnaW4gbWV0YS1kYXRh LCBzdWl0YWJsZSBmb3IgdXNlIGluIGNsaWVudC1zaWRlIHBsdWdpbiBpbmZyYXN0cnVjdHVyZSwg aW50byBXZWJBZG1pbiBob3N0IHBhZ2UgYXMgJnF1b3Q7cGx1Z2luRGVmaW5pdGlvbnMmcXVvdDsg SmF2YVNjcmlwdCBhcnJheSAoPGk+UGx1Z2luRGVmaW5pdGlvbnM8L2k+KTxvOnA+PC9vOnA+PC9s aT48L3VsPg0KPHAgY2xhc3M9Ik1zb05vcm1hbCI+PHNwYW4gc3R5bGU9ImNvbG9yOmJsYWNrIj5B cyBhIHJlc3VsdCwgcmVsb2FkaW5nIFVJIHBsdWdpbiBkZXNjcmlwdG9yL2NvbmZpZ3VyYXRpb24g ZGF0YSBpcyBhcyBzaW1wbGUgYXMgcmVmcmVzaGluZyAoRjUpIFdlYkFkbWluIGFwcGxpY2F0aW9u IGluIHRoZSBicm93c2VyIChubyBuZWVkIHRvIHJlc3RhcnQgRW5naW5lKS48YnI+DQo8YnI+DQo8 Yj4zLiBBZGRlZCBzZXJ2bGV0IGZvciBzZXJ2aW5nIHBsdWdpbiBzdGF0aWMgcmVzb3VyY2VzPGJy Pg0KPC9iPjxicj4NCjxpPlBsdWdpblJlc291cmNlU2VydmxldDwvaT4gaXMgdGhlIHNlcnZsZXQg dXNlZCB0byBzZXJ2ZSBVSSBwbHVnaW4gc3RhdGljIGZpbGVzIChwbHVnaW4gaG9zdCBwYWdlLCAz cmQgcGFydHkgSmF2YVNjcmlwdCwgZXRjLikgZnJvbSB0aGUgbG9jYWwgZmlsZSBzeXN0ZW0uPGJy Pg0KPGJyPg0KRm9yIGV4YW1wbGUsIHJlcXVlc3RpbmcgVVJMOjxvOnA+PC9vOnA+PC9zcGFuPjwv cD4NCjx1bCB0eXBlPSJkaXNjIj4NCjxsaSBjbGFzcz0iTXNvTm9ybWFsIiBzdHlsZT0iY29sb3I6 YmxhY2s7bXNvLW1hcmdpbi10b3AtYWx0OmF1dG87bXNvLW1hcmdpbi1ib3R0b20tYWx0OmF1dG87 bXNvLWxpc3Q6bDUgbGV2ZWwxIGxmbzEwIj4NCjxpPjxhIGhyZWY9Imh0dHA6Ly8lM2NFbmdpbmVN YW5hZ2VySG9zdCUzZTo4NzAwL3dlYmFkbWluL3dlYmFkbWluL3BsdWdpbi9mb28vY29udGVudC9z dGFydC5odG1sIj5odHRwOi8vJmx0O0VuZ2luZU1hbmFnZXJIb3N0Jmd0Ozo4NzAwL3dlYmFkbWlu L3dlYmFkbWluL3BsdWdpbi9mb28vY29udGVudC9zdGFydC5odG1sPC9hPjwvaT48bzpwPjwvbzpw PjwvbGk+PC91bD4NCjxwPjxzcGFuIHN0eWxlPSJjb2xvcjpibGFjayI+d2lsbCBzZW5kIHRoZSBj b250ZW50IG9mOjxvOnA+PC9vOnA+PC9zcGFuPjwvcD4NCjx1bCB0eXBlPSJkaXNjIj4NCjxsaSBj bGFzcz0iTXNvTm9ybWFsIiBzdHlsZT0iY29sb3I6YmxhY2s7bXNvLW1hcmdpbi10b3AtYWx0OmF1 dG87bXNvLW1hcmdpbi1ib3R0b20tYWx0OmF1dG87bXNvLWxpc3Q6bDEgbGV2ZWwxIGxmbzExIj4N CjxpPi91c3Ivc2hhcmUvb3ZpcnQtZW5naW5lL3VpLXBsdWdpbnMvJmx0O3Jlc291cmNlUGF0aCZn dDsvY29udGVudC9zdGFydC5odG1sPC9pPjxvOnA+PC9vOnA+PC9saT48L3VsPg0KPHA+PHNwYW4g c3R5bGU9ImNvbG9yOmJsYWNrIj50byB0aGUgY2xpZW50LjxvOnA+PC9vOnA+PC9zcGFuPjwvcD4N CjxwPjxzcGFuIHN0eWxlPSJjb2xvcjpibGFjayI+Jm5ic3A7PG86cD48L286cD48L3NwYW4+PC9w Pg0KPHA+PHNwYW4gc3R5bGU9ImNvbG9yOmJsYWNrIj5BcyBzaG93biBpbiB0aGUgYWJvdmUgZXhh bXBsZTo8bzpwPjwvbzpwPjwvc3Bhbj48L3A+DQo8dWwgdHlwZT0iZGlzYyI+DQo8bGkgY2xhc3M9 Ik1zb05vcm1hbCIgc3R5bGU9ImNvbG9yOmJsYWNrO21zby1tYXJnaW4tdG9wLWFsdDphdXRvO21z by1tYXJnaW4tYm90dG9tLWFsdDphdXRvO21zby1saXN0OmwxMiBsZXZlbDEgbGZvMTIiPg0KPGk+ L3dlYmFkbWluL3dlYmFkbWluL3BsdWdpbi88L2k+IGlzIHRoZSBzZXJ2bGV0IHJvb3QgcGF0aCBm b3IgPGk+UGx1Z2luUmVzb3VyY2VTZXJ2bGV0PC9pPjxvOnA+PC9vOnA+PC9saT48bGkgY2xhc3M9 Ik1zb05vcm1hbCIgc3R5bGU9ImNvbG9yOmJsYWNrO21zby1tYXJnaW4tdG9wLWFsdDphdXRvO21z by1tYXJnaW4tYm90dG9tLWFsdDphdXRvO21zby1saXN0OmwxMiBsZXZlbDEgbGZvMTIiPg0KaW4g dGhlIGV4dHJhIHBhdGggYmV5b25kIHRoZSBzZXJ2bGV0IHJvb3QgcGF0aCAoPGk+L2Zvby9jb250 ZW50L3N0YXJ0Lmh0bWw8L2k+KTo8bzpwPjwvbzpwPjwvbGk+PC91bD4NCjx1bCB0eXBlPSJkaXNj Ij4NCjx1bCB0eXBlPSJjaXJjbGUiPg0KPGxpIGNsYXNzPSJNc29Ob3JtYWwiIHN0eWxlPSJjb2xv cjpibGFjazttc28tbWFyZ2luLXRvcC1hbHQ6YXV0bzttc28tbWFyZ2luLWJvdHRvbS1hbHQ6YXV0 bzttc28tbGlzdDpsMTIgbGV2ZWwyIGxmbzEyIj4NCjxpPi9mb288L2k+IHJlcHJlc2VudHMgdGhl IG5hbWUgb2YgdGhlIHBsdWdpbjxvOnA+PC9vOnA+PC9saT48bGkgY2xhc3M9Ik1zb05vcm1hbCIg c3R5bGU9ImNvbG9yOmJsYWNrO21zby1tYXJnaW4tdG9wLWFsdDphdXRvO21zby1tYXJnaW4tYm90 dG9tLWFsdDphdXRvO21zby1saXN0OmwxMiBsZXZlbDIgbGZvMTIiPg0KPGk+L2NvbnRlbnQvc3Rh cnQuaHRtbDwvaT4gcmVwcmVzZW50cyB0aGUgcGF0aCB0byByZXF1ZXN0ZWQgcmVzb3VyY2UsIHJl bGF0aXZlIHRvICZxdW90O1VJUGx1Z2luRGF0YVBhdGggLyAmbHQ7cmVzb3VyY2VQYXRoJmd0OyZx dW90OzxvOnA+PC9vOnA+PC9saT48L3VsPg0KPC91bD4NCjxwIGNsYXNzPSJNc29Ob3JtYWwiPjxz cGFuIHN0eWxlPSJjb2xvcjpibGFjayI+Tm90ZSB0aGF0IGVhY2ggcGx1Z2luIHVzaW5nIDxpPlBs dWdpblJlc291cmNlU2VydmxldDwvaT4gdG8gc2VydmUgaXRzIHN0YXRpYyBmaWxlcyBtdXN0IGRl Y2xhcmUgbm9uLWVtcHR5DQo8aT5yZXNvdXJjZVBhdGg8L2k+IGF0dHJpYnV0ZSBpbiB3aXRoaW4g dGhlIHBsdWdpbiBkZXNjcmlwdG9yLjxicj4NCjxicj4NCkFsc28gbm90ZSB0aGF0IDxpPlBsdWdp blJlc291cmNlU2VydmxldDwvaT4sIHVubGlrZSA8aT5XZWJhZG1pbkR5bmFtaWNIb3N0aW5nU2Vy dmxldDwvaT4sIGRvZXMgTk9UIHJlbG9hZCBkZXNjcmlwdG9yL2NvbmZpZ3VyYXRpb24gZGF0YSBm cm9tIGxvY2FsIGZpbGUgc3lzdGVtIGFzIHBhcnQgb2YgaGFuZGxpbmcgdGhlIGdpdmVuIHJlcXVl c3QuIEluIG90aGVyIHdvcmRzLCBpdCdzIGFzc3VtZWQgdGhhdCBwbHVnaW4gZGF0YSBoYXMgYWxy ZWFkeSBiZWVuDQogKHJlKWxvYWRlZCB3aGVuIHNlcnZpbmcgV2ViQWRtaW4gYXBwbGljYXRpb24g aG9zdCBwYWdlLCB3aXRoIHN1YnNlcXVlbnQgcmVxdWVzdHMgdG8NCjxpPlBsdWdpblJlc291cmNl U2VydmxldDwvaT4gcmVhZGluZyB0aGUgY3VycmVudCBwbHVnaW4gaW5mb3JtYXRpb24uPGJyPg0K PGJyPg0KVW50aWwgd2Ugc29sdmUgdGhlIGNyb3NzLW9yaWdpbiBpc3N1ZSBpbiBhIGNsZWFuIHdh eSwgPGk+UGx1Z2luUmVzb3VyY2VTZXJ2bGV0PC9pPiBzaG91bGQgYmUgdXNlZCB0byBzZXJ2ZSBh bGwgcGx1Z2luIHJlc291cmNlcyBmcm9tIGxvY2FsIGZpbGUgc3lzdGVtLjxicj4NCjxicj4NCjxi PjQuIFBsdWdpbiBsaWZlY3ljbGUgaW1wcm92ZWQgdG8gZGVhbCB3aXRoIG1pc2JlaGF2aW5nIHBs dWdpbnM8L2I+PGJyPg0KPGJyPg0KPGk+UGx1Z2luU3RhdGU8L2k+IGVudW0gaGFzIGJlZW4gbW9k aWZpZWQgdG8gZGVhbCB3aXRoIHBsdWdpbnMgdGhhdCBhbGxvdyB1bmNhdWdodCBleGNlcHRpb25z IHRvIGVzY2FwZSBmcm9tIHBsdWdpbiBldmVudCBoYW5kbGVyIGZ1bmN0aW9ucyAoZS5nLiAmcXVv dDtVaUluaXQmcXVvdDspOjxvOnA+PC9vOnA+PC9zcGFuPjwvcD4NCjx1bCB0eXBlPSJkaXNjIj4N CjxsaSBjbGFzcz0iTXNvTm9ybWFsIiBzdHlsZT0iY29sb3I6YmxhY2s7bXNvLW1hcmdpbi10b3At YWx0OmF1dG87bXNvLW1hcmdpbi1ib3R0b20tYWx0OmF1dG87bXNvLWxpc3Q6bDYgbGV2ZWwxIGxm bzEzIj4NCnJlbW92ZWQgc3RhdGUgPGk+SU5JVElBTElaRUQ8L2k+PG86cD48L286cD48L2xpPjxs aSBjbGFzcz0iTXNvTm9ybWFsIiBzdHlsZT0iY29sb3I6YmxhY2s7bXNvLW1hcmdpbi10b3AtYWx0 OmF1dG87bXNvLW1hcmdpbi1ib3R0b20tYWx0OmF1dG87bXNvLWxpc3Q6bDYgbGV2ZWwxIGxmbzEz Ij4NCmFkZGVkIHN0YXRlIDxpPklOSVRJQUxJWklORzwvaT46IFRoZSBwbHVnaW4gaXMgKGN1cnJl bnRseSkgYmVpbmcgaW5pdGlhbGl6ZWQgYnkgY2FsbGluZyBVaUluaXQgZXZlbnQgaGFuZGxlciBm dW5jdGlvbi48bzpwPjwvbzpwPjwvbGk+PGxpIGNsYXNzPSJNc29Ob3JtYWwiIHN0eWxlPSJjb2xv cjpibGFjazttc28tbWFyZ2luLXRvcC1hbHQ6YXV0bzttc28tbWFyZ2luLWJvdHRvbS1hbHQ6YXV0 bzttc28tbGlzdDpsNiBsZXZlbDEgbGZvMTMiPg0KYWRkZWQgc3RhdGUgPGk+SU5fVVNFPC9pPjog UGx1Z2luJ3MgVWlJbml0IGV2ZW50IGhhbmRsZXIgZnVuY3Rpb24gaGFzIGNvbXBsZXRlZCBzdWNj ZXNzZnVsbHksIHdlIGNhbiBub3cgY2FsbCBvdGhlciBldmVudCBoYW5kbGVyIGZ1bmN0aW9ucyBh cyBuZWNlc3NhcnkuIFRoZSBwbHVnaW4gaXMgaW4gdXNlIG5vdy48bzpwPjwvbzpwPjwvbGk+PGxp IGNsYXNzPSJNc29Ob3JtYWwiIHN0eWxlPSJjb2xvcjpibGFjazttc28tbWFyZ2luLXRvcC1hbHQ6 YXV0bzttc28tbWFyZ2luLWJvdHRvbS1hbHQ6YXV0bzttc28tbGlzdDpsNiBsZXZlbDEgbGZvMTMi Pg0KYWRkZWQgc3RhdGUgPGk+RkFJTEVEPC9pPjogQW4gdW5jYXVnaHQgZXhjZXB0aW9uIGVzY2Fw ZWQgd2hpbGUgY2FsbGluZyBhbiBldmVudCBoYW5kbGVyIGZ1bmN0aW9uLCB3aGljaCBpbmRpY2F0 ZXMgaW50ZXJuYWwgZXJyb3Igd2l0aGluIHRoZSBwbHVnaW4gY29kZS4gVGhlIHBsdWdpbiBpcyBy ZW1vdmVkIGZyb20gc2VydmljZS48bzpwPjwvbzpwPjwvbGk+PC91bD4NCjxwIGNsYXNzPSJNc29O b3JtYWwiIHN0eWxlPSJtYXJnaW4tYm90dG9tOjEyLjBwdCI+PHNwYW4gc3R5bGU9ImNvbG9yOmJs YWNrIj5JJ3ZlIGF0dGFjaGVkIGEgc2ltcGxlIHN0YXRlIGRpYWdyYW0gdGhhdCBpbGx1c3RyYXRl cyBkaWZmZXJlbnQgc3RhdGVzIGFuZCB0cmFuc2l0aW9ucyBiZXR3ZWVuIHRoZW0gKGdyZWVuIGNv bG9yIGlzIGluaXRpYWwgc3RhdGUsIHJlZCBjb2xvciBpcyBlbmQgc3RhdGUpLjxicj4NCjxicj4N ClVuY2F1Z2h0IGV4Y2VwdGlvbnMgaW4gcGx1Z2luIGV2ZW50IGhhbmRsZXIgZnVuY3Rpb25zIHdp bGwgYmUgY2F1Z2h0IGFuZCBoYW5kbGVkIGJ5IHRoZSBwbHVnaW4gaW5mcmFzdHJ1Y3R1cmUuIFRo aXMgcHJldmVudHMgYSBtaXNiZWhhdmluZyBwbHVnaW4gZnJvbSBicmVha2luZyBXZWJBZG1pbiBh cHBsaWNhdGlvbiwgc2luY2UgV2ViQWRtaW4gaXMgdGhlIGNhbGxlciAoaW5pdGlhdG9yKSBvZiB0 aGUgZnVuY3Rpb24gY2FsbC4gSW4gc3VjaCBjYXNlLA0KIHRoZSBwbHVnaW4gd2lsbCBiZSByZW1v dmVkIGZyb20gc2VydmljZS48YnI+DQo8YnI+DQo8Yj5VcGRhdGUgb24gY3Jvc3Mtb3JpZ2luIGlz c3VlIChjb25zZXF1ZW5jZSBvZiBzYW1lLW9yaWdpbiBwb2xpY3kpPC9iPjxicj4NCjxicj4NCklu IG9yZGVyIGZvciB0aGUgcGx1Z2luIHRvIGFjY2VzcyBXZWJBZG1pbiBwbHVnaW4gQVBJLCBwbHVn aW4gaG9zdCBwYWdlIChlLmcuIDxpPg0Kc3RhcnQuaHRtbDwvaT4pIG11c3QgYmUgc2VydmVkIGZy b20gVVJMIG9uIHNhbWUgb3JpZ2luIGFzIEVuZ2luZSBvcmlnaW4uIE90aGVyd2lzZSwgcGx1Z2lu IGNvZGUgcnVubmluZyBpbiB0aGUgY29udGV4dCBvZiBhbiBpZnJhbWUnZCBob3N0IHBhZ2Ugd2ls bCBmYWlsIHRvIGV2YWx1YXRlICZxdW90O3BhcmVudC5wbHVnaW5BcGkmcXVvdDsgZXhwcmVzc2lv biwgd2l0aCAmcXVvdDtwYXJlbnQmcXVvdDsgYmVpbmcgdG9wLWxldmVsIChXZWJBZG1pbikgd2lu ZG93LCBhbmQgJnF1b3Q7cGx1Z2luQXBpJnF1b3Q7DQogYmVpbmcgdGhlIGdsb2JhbCBwbHVnaW4g QVBJIG9iamVjdCBleHBvc2VkIGJ5IFdlYkFkbWluLjxicj4NCjxicj4NClRoaXMgaXMgd2h5IDxp PlBsdWdpblJlc291cmNlU2VydmxldDwvaT4sIGF2YWlsYWJsZSBvbiBFbmdpbmUgb3JpZ2luLCBz aG91bGQgYmUgdXNlZCB0byBzZXJ2ZSBhbGwgcGx1Z2luIHJlc291cmNlcyBmcm9tIGxvY2FsIGZp bGUgc3lzdGVtLjxicj4NCjxicj4NClRoZXJlJ3Mgb25seSBvbmUgaXNzdWUgdGhhdCByZW1haW5z IHRvIGJlIHNvbHZlZDogY3Jvc3Mtb3JpZ2luICZxdW90O3BsdWdpbiB2cy4gcmVtb3RlIHNlcnZp Y2UmcXVvdDsgY29tbXVuaWNhdGlvbiwgd2l0aCAmcXVvdDtyZW1vdGUgc2VydmljZSZxdW90OyBi ZWluZyBhbnl0aGluZyBvdGhlciB0aGFuIEVuZ2luZSAoUkVTVCBBUEkpLiBJbiBmdXR1cmUsIHdl J2xsIGFkZHJlc3MgdGhpcyB3aXRoIEFwYWNoZSByZXZlcnNlIHByb3h5IGNvbmZpZ3VyYXRpb24s IHNvIHRoYXQgdXNlcnMNCiBjYW4gY29uZmlndXJlIEFwYWNoZSBzZXJ2ZXIgKHBsYWNlZCBpbiBm cm9udCBvZiBFbmdpbmUgSkJvc3MgQVMpIHRvIHB1dCBhcmJpdHJhcnkgKGxvY2FsIG9yIHJlbW90 ZSBub24tRW5naW5lKSBzZXJ2aWNlcyBvbiBzYW1lIG9yaWdpbi4gSG93ZXZlciwgdGhpcyByZXF1 aXJlcyBhIGNoYW5nZSBpbiBjdXJyZW50IEFwYWNoZSBjb25maWd1cmF0aW9uLiBVbnRpbCB0aGVu LCB1c2VycyBjYW4gbWFudWFsbHkgZWRpdCB0aGUgRW5naW5lIEFwYWNoZSBjb25maWd1cmF0aW9u DQogZmlsZSAoPGk+L2V0Yy9odHRwZC9jb25mLmQvb3ZpcnQtZW5naW5lLmNvbmY8L2k+KS48bzpw PjwvbzpwPjwvc3Bhbj48L3A+DQo8ZGl2IGNsYXNzPSJNc29Ob3JtYWwiIGFsaWduPSJjZW50ZXIi IHN0eWxlPSJ0ZXh0LWFsaWduOmNlbnRlciI+PHNwYW4gc3R5bGU9ImNvbG9yOmJsYWNrIj4NCjxo ciBzaXplPSIyIiB3aWR0aD0iMTAwJSIgYWxpZ249ImNlbnRlciI+DQo8L3NwYW4+PC9kaXY+DQo8 cCBjbGFzcz0iTXNvTm9ybWFsIiBzdHlsZT0ibWFyZ2luLWJvdHRvbToxMi4wcHQiPjxzcGFuIHN0 eWxlPSJjb2xvcjpibGFjayI+PGJyPg0KSSd2ZSBhdHRhY2hlZCBzb21lIHNhbXBsZSBwbHVnaW4g ZmlsZXMgZm9yIHlvdSB0byBleHBlcmltZW50IHdpdGguIEluc3RlYWQgb2YgYXR0YWNoaW5nIGFj dHVhbCBwYXRjaCBmaWxlICg5MiBrQikgdG8gdGhpcyBlbWFpbCwgSSd2ZSBzdWJtaXR0ZWQgdGhl IHBhdGNoIHRvIG9WaXJ0IEdlcnJpdDoNCjxhIGhyZWY9Imh0dHA6Ly9nZXJyaXQub3ZpcnQub3Jn LzgxMjAiIHRhcmdldD0iX2JsYW5rIj5odHRwOi8vZ2Vycml0Lm92aXJ0Lm9yZy84MTIwPC9hPjxi cj4NCjxicj4NCkxldCBtZSBrbm93IHdoYXQgeW91IHRoaW5rITxicj4NCjxicj4NCkNoZWVycyw8 YnI+DQpWb2p0ZWNoPG86cD48L286cD48L3NwYW4+PC9wPg0KPC9kaXY+DQo8L2Rpdj4NCjwvYmxv Y2txdW90ZT4NCjxibG9ja3F1b3RlIHN0eWxlPSJtYXJnaW4tdG9wOjUuMHB0O21hcmdpbi1ib3R0 b206NS4wcHQiPg0KPGRpdj4NCjxwIGNsYXNzPSJNc29Ob3JtYWwiPjxzcGFuIHN0eWxlPSJjb2xv cjpibGFjayI+Jmx0O3VpLXBsdWdpbi1zYW1wbGUtZmlsZXMudGFyLmd6Jmd0OzxvOnA+PC9vOnA+ PC9zcGFuPjwvcD4NCjwvZGl2Pg0KPC9ibG9ja3F1b3RlPg0KPGJsb2NrcXVvdGUgc3R5bGU9Im1h cmdpbi10b3A6NS4wcHQ7bWFyZ2luLWJvdHRvbTo1LjBwdCI+DQo8ZGl2Pg0KPHAgY2xhc3M9Ik1z b05vcm1hbCI+PHNwYW4gc3R5bGU9ImNvbG9yOmJsYWNrIj4mbHQ7dWktcGx1Z2luLWxpZmVjeWNs ZS5wbmcmZ3Q7PG86cD48L286cD48L3NwYW4+PC9wPg0KPC9kaXY+DQo8L2Jsb2NrcXVvdGU+DQo8 YmxvY2txdW90ZSBzdHlsZT0ibWFyZ2luLXRvcDo1LjBwdDttYXJnaW4tYm90dG9tOjUuMHB0Ij4N CjxkaXY+DQo8cCBjbGFzcz0iTXNvTm9ybWFsIj48c3BhbiBzdHlsZT0iY29sb3I6YmxhY2siPl9f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fPGJyPg0KRW5naW5l LWRldmVsIG1haWxpbmcgbGlzdDxicj4NCjxhIGhyZWY9Im1haWx0bzpFbmdpbmUtZGV2ZWxAb3Zp cnQub3JnIiB0YXJnZXQ9Il9ibGFuayI+RW5naW5lLWRldmVsQG92aXJ0Lm9yZzwvYT48YnI+DQo8 YSBocmVmPSJodHRwOi8vbGlzdHMub3ZpcnQub3JnL21haWxtYW4vbGlzdGluZm8vZW5naW5lLWRl dmVsIiB0YXJnZXQ9Il9ibGFuayI+aHR0cDovL2xpc3RzLm92aXJ0Lm9yZy9tYWlsbWFuL2xpc3Rp bmZvL2VuZ2luZS1kZXZlbDwvYT48bzpwPjwvbzpwPjwvc3Bhbj48L3A+DQo8L2Rpdj4NCjwvYmxv Y2txdW90ZT4NCjwvZGl2Pg0KPHAgY2xhc3M9Ik1zb05vcm1hbCI+PHNwYW4gc3R5bGU9ImNvbG9y OmJsYWNrIj48bzpwPiZuYnNwOzwvbzpwPjwvc3Bhbj48L3A+DQo8L2Rpdj4NCjwvZGl2Pg0KPC9i b2R5Pg0KPC9odG1sPg0K --_000_D290AD8432118048947689BA3AE8A9B3E47C3DSACEXCMBX04PRDhqn_--
------=_Part_4133380_10286535.1349259508244 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Hey Chris,=20 my idea of implementing context-sensitive buttons (menu items) and related = dialogs was to de-couple button registration from actual dialog handling, l= ike so:=20 * add custom button to specific data grid as part of UiInit event, prov= iding callback that represents the "button/menu clicked" action, e.g. "plug= inApi.addActionButton(title, callback)"=20 * within the above mentioned callback, show the custom dialog using " p= luginApi. showDialog(title, contentUrl, buttons?)" [note: this is the "dial= og UI API" I meant in my previous email]=20 This basically splits your use-case into two distinct API features (addActi= onButton, showDialog). For example, one button could show a custom dialog, = another one could perform other (non-dialog) actions. What do you think?=20
Or potentially since it is a dialog, it could just show it in separate wi= ndow altogether.=20
Good idea for initial implementation! This could be easily added to PoC rev= .6. Ultimately, I'd prefer a "dialog UI API", so that custom dialogs will h= ave same "look and feel" as standard ones (can be done later on though).=20
I=E2=80=99ll start looking at adding the ability to launch a dialog with = context through the plugin API and let you know how that goes in a few days= (Maybe sooner if I have questions about it. ;)=20
Great, I think you could start with the above mentioned initial implementat= ion, here are some tips:=20 * add "showDialog(title, contentUrl)" function to plugin API within Plu= ginManager. exposePluginApi () method=20 * use GWT JSNI to delegate the call to PluginUiFunctions, e.g. PluginUi= Functions.showDialog() method=20 * implement showDialog() method using GWT Window.open (), or WebUtils.o= penUrlInNewWindow()=20 (The above mentioned steps are basically the recipe for adding/implementing= new plugin API function.)=20
Finally, would it be possible to give an estimate on when you think the P= oC rev 6 will be available? We=E2=80=99ve got scheduled deliveries internal= ly based on this code and it would be better to make sure everything lines = up now.=20
Well, I'm planning to revisit rev.5 according to review comments, and prepa= re for UI Plugins Follow-Up Meeting (October 9). I will start working on re= v.6 patch right after that.=20 Finalizing custom (URL-based iframe'd) main tab, plus API for adding same k= ind of custom sub tab, should be quite easy - couple of days.=20 Custom context-sensitive buttons (menu items), should be easy as well, but = there is some UiCommon integration necessary - 3-4 days.=20 Maybe we can split these two in separate rev.6 releases, what do you think?= If you prefer to have both implemented as part of rev.6 patch, my rough es= timate is around October 19.=20 Regards,=20 Vojtech=20 ----- Original Message ----- From: "Christopher Morrissey" <Christopher.Morrissey@netapp.com>=20 To: "Vojtech Szocs" <vszocs@redhat.com>=20 Cc: "George Costea" <George.Costea@netapp.com>, "Dustin Schoenbrun" <Dustin= .Schoenbrun@netapp.com>, engine-devel@ovirt.org=20 Sent: Tuesday, October 2, 2012 9:15:45 PM=20 Subject: RE: [Engine-devel] UI Plugins: PoC patch revision 5 is here=20 Hi Vojtech,=20 Thanks for the reply. The plugin framework for adding a custom context sens= itive button/menu item and the iframe loading support for the main tab plug= in will be welcome additions.=20 For the custom UI dialog, we=E2=80=99re looking for something that works si= milar to the tab in that it will show a particular URL in an iFrame in a di= alog. Or potentially since it is a dialog, it could just show it in separat= e window altogether. The dialog would be opened when the context sensitive = button or menu item is activated. So it would be nice if the plugin framewo= rk would allow a plugged in button definition to define a URL to load in a = dialog when it is activated.=20 I=E2=80=99ll start looking at adding the ability to launch a dialog with co= ntext through the plugin API and let you know how that goes in a few days (= Maybe sooner if I have questions about it. ;)=20 Finally, would it be possible to give an estimate on when you think the PoC= rev 6 will be available? We=E2=80=99ve got scheduled deliveries internally= based on this code and it would be better to make sure everything lines up= now.=20 Thanks!=20 Chris=20 From: Vojtech Szocs [mailto:vszocs@redhat.com]=20 Sent: Tuesday, October 02, 2012 2:47 PM=20 To: Morrissey, Christopher=20 Cc: Costea, George; Schoenbrun, Dustin; engine-devel@ovirt.org=20 Subject: Re: [Engine-devel] UI Plugins: PoC patch revision 5 is here=20 Hi Chris,=20 many thanks for your feedback and suggestions :)=20 Adding context-sensitive button with corresponding menu item sounds good! I= n fact, this is the proper way how context menu items should be handled, si= nce WebAdmin data grids work with context-sensitive "action buttons" which = are reflected within the context menu. I agree that this is a very useful f= eature to have in plugin API, it should be implemented as part of next majo= r PoC revision.=20 I have a question though: when the user clicks the custom button or corresp= onding context menu item, will your plugin handle common dialog UI (everyth= ing except actual content) on its own, or do you prefer to have some kind o= f "dialog UI" API to create the standard-looking dialog frame for you? I li= ke the idea of using iframe to present custom content though :)=20 As for grouping multiple context-sensitive buttons and corresponding contex= t menu items, this makes sense and we have something like this already impl= emented in WebAdmin (in Host main tab, Power Management drop-down group but= ton, but this is defined not to appear in context menu though). I think thi= s should be part of "custom context-sensitive button / menu item" plugin AP= I feature.=20
If needed we can help work on an implementation for the dialog popup plug= in framework as we=E2=80=99d like to get it in relatively quickly so we can= move forward on the content side of our plugin.=20
If I understand correctly, this is about providing "dialog UI" API to creat= e the standard-looking dialog frame + custom content iframe. I'd like to he= lp with this as well, but you can play with the code and propose a patch on= top of PoC rev.5 [http://gerrit.ovirt.org/8120].=20
For the reverse proxy, would it be easier from a customer standpoint to j= ust include a reverse proxy servlet such as this one?=20
</li><li><span class=3D"gwt-InlineLabel">implement showDialog() method usi= ng GWT Window.open(), or WebUtils.openUrlInNewWindow()</span></li></ul><p><= br></p>(The above mentioned steps are basically the recipe for adding/imple= menting new plugin API function.)<br><br>> <span style=3D"font-size:11.0=
<br> <br> This way, you could use Apache to bring Engine and arbitrary (local or remo= te) web services on same origin. What do you think?<br> <br> On the other hand, using a special-purpose reverse proxy servlet directly i= n Engine, not sure if that's a good idea though.. (I'd prefer configuring "= front-end" web server, such as Apache, for this purpose)<br> <br> I'm also sending a couple of updates:<br> <br> <strong>UI Plugins Follow-Up Meeting:</strong> scheduled for Tuesday, Octob= er 9 at 4pm GMT+1 (I'll send a meeting invitation soon, also planning to re= -write oVirt UI Plugins wiki soon after that)<br> <br> <b>PoC rev.5 patch update:</b> many thanks to Juan and Doron for reviewing =
Actually, I was under the impression that oVirt Engine (3.1) package (ovirt= -engine) takes care of setting up Apache web server, which redirects all tr= affic to Engine JBoss AS by default (but maybe I am wrong here). However, i= f this is the case, an efficient way to work around same-origin policy (cro= ss-origin issues) is to configure Apache's reverese proxy module (mod_proxy= ), as discussed in another thread on engine-devel: http://lists.ovirt.org/p= ipermail/engine-devel/2012-September/002511.html=20 This way, you could use Apache to bring Engine and arbitrary (local or remo= te) web services on same origin. What do you think?=20 On the other hand, using a special-purpose reverse proxy servlet directly i= n Engine, not sure if that's a good idea though.. (I'd prefer configuring "= front-end" web server, such as Apache, for this purpose)=20 I'm also sending a couple of updates:=20 UI Plugins Follow-Up Meeting: scheduled for Tuesday, October 9 at 4pm GMT+1= (I'll send a meeting invitation soon, also planning to re-write oVirt UI P= lugins wiki soon after that)=20 PoC rev.5 patch update: many thanks to Juan and Doron for reviewing the rec= ent patch [http://gerrit.ovirt.org/8120]! I'll update the patch accordingly= as revision 5.1=20 Planned items to be included in PoC revision 6:=20 * adding custom context-sensitive button (either separately or within a= button group), along with corresponding context menu item representation= =20 * update custom main tab to show the actual content (iframe) from the g= iven URL=20 * adding custom sub tab that shows content from the given URL=20 More items to consider having in PoC revision 6:=20 * "dialog UI" API to create the standard-looking dialog frame + custom = content iframe=20 * Engine REST API exposed through plugin API=20 * integration with Tasks pane to provide visual feedback on custom oper= ations=20 * extending existing dialogs (e.g. Edit Cluster Policy - custom propert= ies)=20 Let me know what you think.=20 Regards,=20 Vojtech=20 ----- Original Message ----- From: "Christopher Morrissey" <Christopher.Morrissey@netapp.com>=20 To: vszocs@redhat.com=20 Cc: "George Costea" <George.Costea@netapp.com>, "Dustin Schoenbrun" <Dustin= .Schoenbrun@netapp.com>, engine-devel@ovirt.org=20 Sent: Tuesday, October 2, 2012 6:15:34 PM=20 Subject: RE: [Engine-devel] UI Plugins: PoC patch revision 5 is here=20 Hi Vojtech,=20 The patch is great and has cleared up some questions I had about the implem= entation. I=E2=80=99ve been able to get the sample plugins working and wade= d through the code changes, so feel like I have a good understanding of wha= t was delivered. Thanks a lot for putting this all together. I do have a fe= w questions and suggestions for you, though.=20 Will there eventually be a way to add one or more buttons to the context se= nsitive buttons and menus throughout the interface? For example, we=E2=80= =99d like to allow a button to provision a datastore when a data center, cl= uster, or host is selected. When the button is clicked, it would open a dia= log with an iframe in which we would load our interface to perform the asso= ciated action. Some contexts would have several buttons, such as a storage = domain (provision, resize, dedupe management, destroy) so it would probably= make sense for a drop down menu to be available as well so that the number= of buttons above the table doesn=E2=80=99t get too cluttered. We=E2=80=99d= also like to add these same actions to the menus that popup when a context= ual object is right clicked.=20 If needed we can help work on an implementation for the dialog popup plugin= framework as we=E2=80=99d like to get it in relatively quickly so we can m= ove forward on the content side of our plugin.=20 For the reverse proxy, would it be easier from a customer standpoint to jus= t include a reverse proxy servlet such as this one? http://sourceforge.net/= projects/j2ep/=20 I=E2=80=99m just thinking that setting up and managing a plugin for the HTT= P server may be more complex than including one internally that would be tr= ansparent to a customer.=20 Thanks,=20 Chris=20 From: Vojtech Szocs < vszocs@redhat.com >=20 Date: September 21, 2012 4:37:31 PM EDT=20 To: engine-devel < engine-devel@ovirt.org >=20 Subject: [Engine-devel] UI Plugins: PoC patch revision 5 is here=20 <blockquote> Hi guys,=20 it's been a while but here comes the latest revision of UI Plugins proof-of= -concept patch (please find it attached).=20 This revision was originally meant to focus solely on server-side component= s of the plugin infrastructure. However, I ended up implementing all the ma= jor concepts and ideas as discussed on engine-devel mailing list, impacting= both client-side and server-side parts of the plugin infrastructure. As a = result, UI plugin infrastructure should be pretty much complete now, so we = can focus on specific plugin API features in upcoming PoC revisions.=20 There's a whole bunch of changes and improvements in this revision, so I'll= try to cover all the relevant parts step by step. If you have any comments= , questions or ideas, please let me know!=20 So here we go... (or if you just want to get the patch, find the link at th= e end of this message)=20 0. Added new Engine configuration values=20 UI plugin data path is represented by ConfigValues.UIPluginDataPath enum op= tion ("UIPluginDataPath" in vdc_options table), and resolved relative to Co= nfigValues.DataDir if possible. Following (default) values:=20 * UIPluginDataPath =3D ui-plugins=20 * DataDir =3D /usr/share/ovirt-engine=20 result in UI plugin data path: /usr/share/ovirt-engine/ui-plugins=20 UI plugin config path is represented by ConfigValues.UIPluginConfigPath enu= m option ("UIPluginConfigPath" in vdc_options table), and resolved relative= to ConfigValues.ConfigDir if possible. Following (default) values:=20 * UIPluginConfigPath =3D ui-plugins=20 * ConfigDir =3D /etc/ovirt-engine=20 result in UI plugin config path: /etc/ovirt-engine/ui-plugins=20 1. Processing UI plugin data on the server=20 PluginDataManager is the class responsible for reading, validating and cach= ing UI plugin descriptor/configuration data on the server (Engine). It has = two main responsibilities:=20 * return a snapshot of currently valid plugin data ( getCurrentData met= hod)=20 * reload plugin data from local file system if necessary ( reloadData m= ethod)=20 The reloadData method doesn't modify "live" plugin data directly. Instead, = it creates a local working copy of current plugin data, updates this copy a= s it reads/validates plugin descriptor and configuration files, and attempt= s to update "live" plugin data through conditional reference re-assignment = (using java.util.concurrent.atomic.AtomicReference.compareAndSet method).= =20 In other words, reloadData method makes no attempts with regard to Java loc= k-based synchronization, in favor of dealing with "live" data through Atomi= cReference (reference that involves atomic volatile reads and writes):=20 * In the best case, a thread will succeed in updating "live" data ( Ato= micReference.compareAndSet =3D=3D true), which means that "live" data remai= ned unchanged since this thread acquired a reference of current plugin data= .=20 * In the worst case, a thread will NOT succeed in updating "live" data = ( AtomicReference.compareAndSet =3D=3D false), which means that "live" data= was already changed by another thread since this thread acquired a referen= ce of current plugin data.=20 In my opinion, when dealing with external resources like the local file sys= tem, this is a good compromise between performance and up-to-date data. Whi= le we might not get "completely-up-to-date" data at the given point in time= ( reloadData + getCurrentData ), we are guaranteed to get "recently-up-to-= date" and consistent data. In other words, the requirement of "completely-u= p-to-date" data would involve synchronized statements that would hurt perfo= rmance. In my (very humble) opinion, the benefit of having "completely-up-t= o-date" data, at the cost of reduced performance, is not really worth it, e= specially in our case when the user can just hit refresh (F5) to reload Web= Admin and its plugin data.=20 Plugin descriptor files are expected to be placed in UI plugin data path, f= or example: /usr/share/ovirt-engine/ui-plugins/foo.json=20 Following descriptor file attributes are implemented and recognized by the = plugin infrastructure:=20 * name : A name that uniquely identifies the plugin (required attribute= ).=20 * url : URL of plugin host page that invokes the plugin code (required = attribute).=20 * config : Default configuration object associated with the plugin (opt= ional attribute).=20 * resourcePath : Path to plugin static resources, relative to UI plugin= data path (optional attribute). This is used when serving plugin files thr= ough Engine PluginResourceServlet (more on this below).=20 Plugin configuration files are expected to be placed in UI plugin config pa= th, for example: /etc/engine/ui-plugins/foo-config.json=20 Note that plugin configuration files follow the "<descriptorFileName>-confi= g.json" convention.=20 Following configuration file attributes are implemented and recognized by t= he plugin infrastructure:=20 * config : Custom configuration object associated with the plugin (opti= onal attribute). This overrides the default plugin descriptor configuration= , if any.=20 * enabled : Indicates whether the plugin should be loaded on WebAdmin s= tartup (optional attribute). Default value is 'true'.=20 * order : Defines the relative order in which the plugin will be loaded= on WebAdmin startup (optional attribute). Default value is Integer.MAX_VAL= UE (lowest order).=20 The concept of merging custom configuration ( config attribute in foo-confi= g.json ), if any, on top of default configuration ( config attribute in foo= .json ), if any, remains unchanged. This makes the plugin configuration qui= te flexible - in my opinion, the added complexity of handling/merging such = configuration is definitely worth the effort.=20 The enabled attribute is straight-forward, allowing users to turn the given= plugin off, if necessary. In future, users should still be able to load su= ch plugins through WebAdmin GUI.=20 The order attribute controls the order in which plugins are loaded on WebAd= min startup. Since plugin resources are fetched asynchronously by the brows= er, this is basically a way of imposing some degree of determinism in the "= generally-non-deterministic" plugin environment, which is helpful when trou= bleshooting problems with multiple plugins. This attribute is also helpful = due to file listing methods in java.io.File giving no guarantees that files= would be listed in any particular order (otherwise we could just go for th= e "NN-<descriptorFileName>.json" convention, with NN being the order number= ).=20 2. Modified behavior of WebadminDynamicHostingServlet=20 WebadminDynamicHostingServlet is the servlet used to serve WebAdmin applica= tion host page (HTML page that bootstraps WebAdmin JavaScript code).=20 In addition to its former behavior, as part of handling the given request, = WebadminDynamicHostingServlet :=20 * reloads descriptor/configuration data from local file system if neces= sary, and obtains a snapshot of currently valid plugin data ( PluginDataMan= ager.reloadAndGetCurrentData )=20 * embeds all plugin meta-data, suitable for use in client-side plugin i= nfrastructure, into WebAdmin host page as "pluginDefinitions" JavaScript ar= ray ( PluginDefinitions )=20 As a result, reloading UI plugin descriptor/configuration data is as simple= as refreshing (F5) WebAdmin application in the browser (no need to restart= Engine).=20 3. Added servlet for serving plugin static resources=20 PluginResourceServlet is the servlet used to serve UI plugin static files (= plugin host page, 3rd party JavaScript, etc.) from the local file system.= =20 For example, requesting URL:=20 * http://<EngineManagerHost>:8700/webadmin/webadmin/plugin/foo/content/= start.html=20 will send the content of:=20 * /usr/share/ovirt-engine/ui-plugins/<resourcePath>/content/start.html= =20 to the client.=20 As shown in the above example:=20 * /webadmin/webadmin/plugin/ is the servlet root path for PluginResourc= eServlet=20 * in the extra path beyond the servlet root path ( /foo/content/start.h= tml ):=20 * /foo represents the name of the plugin=20 * /content/start.html represents the path to requested resource, re= lative to "UIPluginDataPath / <resourcePath>"=20 Note that each plugin using PluginResourceServlet to serve its static files= must declare non-empty resourcePath attribute in within the plugin descrip= tor.=20 Also note that PluginResourceServlet , unlike WebadminDynamicHostingServlet= , does NOT reload descriptor/configuration data from local file system as = part of handling the given request. In other words, it's assumed that plugi= n data has already been (re)loaded when serving WebAdmin application host p= age, with subsequent requests to PluginResourceServlet reading the current = plugin information.=20 Until we solve the cross-origin issue in a clean way, PluginResourceServlet= should be used to serve all plugin resources from local file system.=20 4. Plugin lifecycle improved to deal with misbehaving plugins=20 PluginState enum has been modified to deal with plugins that allow uncaught= exceptions to escape from plugin event handler functions (e.g. "UiInit"):= =20 * removed state INITIALIZED=20 * added state INITIALIZING : The plugin is (currently) being initialize= d by calling UiInit event handler function.=20 * added state IN_USE : Plugin's UiInit event handler function has compl= eted successfully, we can now call other event handler functions as necessa= ry. The plugin is in use now.=20 * added state FAILED : An uncaught exception escaped while calling an e= vent handler function, which indicates internal error within the plugin cod= e. The plugin is removed from service.=20 I've attached a simple state diagram that illustrates different states and = transitions between them (green color is initial state, red color is end st= ate).=20 Uncaught exceptions in plugin event handler functions will be caught and ha= ndled by the plugin infrastructure. This prevents a misbehaving plugin from= breaking WebAdmin application, since WebAdmin is the caller (initiator) of= the function call. In such case, the plugin will be removed from service.= =20 Update on cross-origin issue (consequence of same-origin policy)=20 In order for the plugin to access WebAdmin plugin API, plugin host page (e.= g. start.html ) must be served from URL on same origin as Engine origin. Ot= herwise, plugin code running in the context of an iframe'd host page will f= ail to evaluate "parent.pluginApi" expression, with "parent" being top-leve= l (WebAdmin) window, and "pluginApi" being the global plugin API object exp= osed by WebAdmin.=20 This is why PluginResourceServlet , available on Engine origin, should be u= sed to serve all plugin resources from local file system.=20 There's only one issue that remains to be solved: cross-origin "plugin vs. = remote service" communication, with "remote service" being anything other t= han Engine (REST API). In future, we'll address this with Apache reverse pr= oxy configuration, so that users can configure Apache server (placed in fro= nt of Engine JBoss AS) to put arbitrary (local or remote non-Engine) servic= es on same origin. However, this requires a change in current Apache config= uration. Until then, users can manually edit the Engine Apache configuratio= n file ( /etc/httpd/conf.d/ovirt-engine.conf ).=20 I've attached some sample plugin files for you to experiment with. Instead = of attaching actual patch file (92 kB) to this email, I've submitted the pa= tch to oVirt Gerrit: http://gerrit.ovirt.org/8120=20 Let me know what you think!=20 Cheers,=20 Vojtech=20 </blockquote> <blockquote> <ui-plugin-sample-files.tar.gz>=20 </blockquote> <blockquote> <ui-plugin-lifecycle.png>=20 </blockquote> <blockquote> _______________________________________________=20 Engine-devel mailing list=20 Engine-devel@ovirt.org=20 http://lists.ovirt.org/mailman/listinfo/engine-devel=20 </blockquote> ------=_Part_4133380_10286535.1349259508244 Content-Type: text/html; charset=utf-8 Content-Transfer-Encoding: quoted-printable <html><head><style type=3D'text/css'>p { margin: 0; }</style></head><body><= div style=3D'font-family: times new roman,new york,times,serif; font-size: = 12pt; color: #000000'>Hey Chris,<br><br>my idea of implementing context-sen= sitive buttons (menu items) and related dialogs was to de-couple button reg= istration from actual dialog handling, like so:<br><ul><li>add custom butto= n to specific data grid as part of UiInit event, providing callback that re= presents the "button/menu clicked" action, e.g. "pluginApi.addActionButton(= title, callback)"<br></li><li>within the above mentioned callback, show the= custom dialog using "pluginApi.showDialog(title, contentUrl, buttons?)" [n= ote: this is the <span style=3D"color:black">"dialog UI API" I meant in my = previous email]<br></span></li></ul><br>This basically splits your use-case= into two distinct API features (addActionButton, showDialog). For example,= one button could show a custom dialog, another one could perform other (no= n-dialog) actions. What do you think?<br><br>> <span style=3D"font-size:= 11.0pt;font-family:"Calibri","sans-serif";color:#1F497D= ">Or potentially since it is a dialog, it could just show it in separate window altogether.= <br></span><br>Good idea for initial implementation! This could be easily = added to PoC rev.6. Ultimately, I'd prefer a <span style=3D"color:black">"d= ialog UI API", so that custom dialogs will have same "look and feel" as sta= ndard ones (can be done later on though).</span><br><br>> <span style=3D= "font-size:11.0pt;font-family:"Calibri","sans-serif";co= lor:#1F497D">I=E2=80=99ll start looking at adding the ability to launch a dialog with context=20 through the plugin API and let you know how that goes in a few days=20 (Maybe sooner if I have questions about it. ;)</span><br><br>Great, I think you could start= with the above mentioned initial implementation, here are some tips:<br><u= l><li>add "showDialog(title, contentUrl)" function to plugin API within Plu= ginManager.<span class=3D"pln">exposePluginApi</span><span class=3D"pun">()= method</span></li><li><span class=3D"pun">use GWT JSNI to delegate the cal= l to </span><span class=3D"gwt-InlineLabel">PluginUiFunctions, e.g. </span>= <span class=3D"gwt-InlineLabel">PluginUiFunctions.showDialog() method</span= pt;font-family:"Calibri","sans-serif";color:#1F497D">Fi= nally, would it be possible to give an estimate on when you think the PoC rev 6 will be available? We=E2=80=99ve got scheduled deliveries internally based= on=20 this code and it would be better to make sure everything lines up now.</span><b= r><br>Well, I'm planning to revisit rev.5 according to review comments, and= prepare for UI Plugins Follow-Up Meeting (October 9). I will start working= on rev.6 patch right after that.<br><br>Finalizing custom (URL-based ifram= e'd) main tab, plus API for adding same kind of custom sub tab, should be q= uite easy - couple of days.<br>Custom context-sensitive buttons (menu items= ), should be easy as well, but there is some UiCommon integration necessary= - 3-4 days.<br><br>Maybe we can split these two in separate rev.6 releases= , what do you think? If you prefer to have both implemented as part of rev.= 6 patch, my rough estimate is around October 19.<br><br>Regards,<br>Vojtech= <br><br><br><hr id=3D"zwchr"><div style=3D"color:#000;font-weight:normal;fo= nt-style:normal;text-decoration:none;font-family:Helvetica,Arial,sans-serif= ;font-size:12pt;"><b>From: </b>"Christopher Morrissey" <Christopher.Morr= issey@netapp.com><br><b>To: </b>"Vojtech Szocs" <vszocs@redhat.com>= ;<br><b>Cc: </b>"George Costea" <George.Costea@netapp.com>, "Dustin S= choenbrun" <Dustin.Schoenbrun@netapp.com>, engine-devel@ovirt.org<br>= <b>Sent: </b>Tuesday, October 2, 2012 9:15:45 PM<br><b>Subject: </b>RE: [En= gine-devel] UI Plugins: PoC patch revision 5 is here<br><br> <style><!-- @font-face =09{font-family:Helvetica; =09panose-1:2 11 6 4 2 2 2 2 2 4;} @font-face =09{font-family:Wingdings; =09panose-1:5 0 0 0 0 0 0 0 0 0;} @font-face =09{font-family:Wingdings; =09panose-1:5 0 0 0 0 0 0 0 0 0;} @font-face =09{font-family:Calibri; =09panose-1:2 15 5 2 2 2 4 3 2 4;} @font-face =09{font-family:Tahoma; =09panose-1:2 11 6 4 3 5 4 4 2 4;} p.MsoNormal, li.MsoNormal, div.MsoNormal =09{margin:0in; =09margin-bottom:.0001pt; =09font-size:12.0pt; =09font-family:"Times New Roman","serif";} a:link, span.MsoHyperlink =09{mso-style-priority:99; =09color:blue; =09text-decoration:underline;} a:visited, span.MsoHyperlinkFollowed =09{mso-style-priority:99; =09color:purple; =09text-decoration:underline;} p =09{mso-style-priority:99; =09mso-margin-top-alt:auto; =09margin-right:0in; =09mso-margin-bottom-alt:auto; =09margin-left:0in; =09font-size:12.0pt; =09font-family:"Times New Roman","serif";} p.MsoAcetate, li.MsoAcetate, div.MsoAcetate =09{mso-style-priority:99; =09mso-style-link:"Balloon Text Char"; =09margin:0in; =09margin-bottom:.0001pt; =09font-size:8.0pt; =09font-family:"Tahoma","sans-serif";} span.BalloonTextChar =09{mso-style-name:"Balloon Text Char"; =09mso-style-priority:99; =09mso-style-link:"Balloon Text"; =09font-family:"Tahoma","sans-serif";} span.EmailStyle21 =09{mso-style-type:personal; =09font-family:"Calibri","sans-serif"; =09color:#1F497D;} span.EmailStyle22 =09{mso-style-type:personal; =09font-family:"Calibri","sans-serif"; =09color:#1F497D;} span.EmailStyle24 =09{mso-style-type:personal-reply; =09font-family:"Calibri","sans-serif"; =09color:#1F497D;} .MsoChpDefault =09{mso-style-type:export-only; =09font-size:10.0pt;} @page WordSection1 =09{size:8.5in 11.0in; =09margin:1.0in 1.0in 1.0in 1.0in;} div.WordSection1 =09{page:WordSection1;} @list l0 =09{mso-list-id:180434570; =09mso-list-template-ids:-282402880;} @list l0:level1 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=B7; =09mso-level-tab-stop:.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Symbol;} @list l0:level2 =09{mso-level-number-format:bullet; =09mso-level-text:o; =09mso-level-tab-stop:1.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:"Courier New"; =09mso-bidi-font-family:"Times New Roman";} @list l0:level3 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:1.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l0:level4 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:2.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l0:level5 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:2.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l0:level6 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:3.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l0:level7 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:3.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l0:level8 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:4.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l0:level9 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:4.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l1 =09{mso-list-id:259874230; =09mso-list-template-ids:-1105409970;} @list l1:level1 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=B7; =09mso-level-tab-stop:.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Symbol;} @list l1:level2 =09{mso-level-number-format:bullet; =09mso-level-text:o; =09mso-level-tab-stop:1.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:"Courier New"; =09mso-bidi-font-family:"Times New Roman";} @list l1:level3 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:1.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l1:level4 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:2.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l1:level5 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:2.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l1:level6 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:3.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l1:level7 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:3.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l1:level8 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:4.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l1:level9 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:4.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l2 =09{mso-list-id:580258439; =09mso-list-template-ids:-6366690;} @list l2:level1 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=B7; =09mso-level-tab-stop:.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Symbol;} @list l2:level2 =09{mso-level-number-format:bullet; =09mso-level-text:o; =09mso-level-tab-stop:1.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:"Courier New"; =09mso-bidi-font-family:"Times New Roman";} @list l2:level3 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:1.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l2:level4 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:2.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l2:level5 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:2.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l2:level6 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:3.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l2:level7 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:3.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l2:level8 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:4.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l2:level9 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:4.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l3 =09{mso-list-id:713581435; =09mso-list-template-ids:2069783976;} @list l3:level1 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=B7; =09mso-level-tab-stop:.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Symbol;} @list l3:level2 =09{mso-level-number-format:bullet; =09mso-level-text:o; =09mso-level-tab-stop:1.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:"Courier New"; =09mso-bidi-font-family:"Times New Roman";} @list l3:level3 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:1.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l3:level4 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:2.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l3:level5 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:2.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l3:level6 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:3.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l3:level7 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:3.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l3:level8 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:4.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l3:level9 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:4.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l4 =09{mso-list-id:765921994; =09mso-list-template-ids:400719310;} @list l4:level1 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=B7; =09mso-level-tab-stop:.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Symbol;} @list l4:level2 =09{mso-level-number-format:bullet; =09mso-level-text:o; =09mso-level-tab-stop:1.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:"Courier New"; =09mso-bidi-font-family:"Times New Roman";} @list l4:level3 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:1.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l4:level4 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:2.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l4:level5 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:2.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l4:level6 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:3.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l4:level7 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:3.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l4:level8 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:4.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l4:level9 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:4.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l5 =09{mso-list-id:843908114; =09mso-list-template-ids:-1243547606;} @list l5:level1 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=B7; =09mso-level-tab-stop:.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Symbol;} @list l5:level2 =09{mso-level-number-format:bullet; =09mso-level-text:o; =09mso-level-tab-stop:1.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:"Courier New"; =09mso-bidi-font-family:"Times New Roman";} @list l5:level3 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:1.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l5:level4 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:2.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l5:level5 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:2.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l5:level6 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:3.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l5:level7 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:3.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l5:level8 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:4.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l5:level9 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:4.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l6 =09{mso-list-id:964771435; =09mso-list-template-ids:-2000783132;} @list l6:level1 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=B7; =09mso-level-tab-stop:.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Symbol;} @list l6:level2 =09{mso-level-number-format:bullet; =09mso-level-text:o; =09mso-level-tab-stop:1.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:"Courier New"; =09mso-bidi-font-family:"Times New Roman";} @list l6:level3 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:1.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l6:level4 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:2.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l6:level5 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:2.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l6:level6 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:3.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l6:level7 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:3.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l6:level8 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:4.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l6:level9 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:4.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l7 =09{mso-list-id:1145852410; =09mso-list-template-ids:1957228864;} @list l7:level1 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=B7; =09mso-level-tab-stop:.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Symbol;} @list l7:level2 =09{mso-level-number-format:bullet; =09mso-level-text:o; =09mso-level-tab-stop:1.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:"Courier New"; =09mso-bidi-font-family:"Times New Roman";} @list l7:level3 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:1.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l7:level4 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:2.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l7:level5 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:2.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l7:level6 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:3.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l7:level7 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:3.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l7:level8 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:4.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l7:level9 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:4.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l8 =09{mso-list-id:1176848642; =09mso-list-template-ids:1223565722;} @list l8:level1 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=B7; =09mso-level-tab-stop:.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Symbol;} @list l8:level2 =09{mso-level-number-format:bullet; =09mso-level-text:o; =09mso-level-tab-stop:1.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:"Courier New"; =09mso-bidi-font-family:"Times New Roman";} @list l8:level3 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:1.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l8:level4 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:2.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l8:level5 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:2.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l8:level6 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:3.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l8:level7 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:3.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l8:level8 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:4.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l8:level9 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:4.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l9 =09{mso-list-id:1311206220; =09mso-list-template-ids:314224160;} @list l9:level1 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=B7; =09mso-level-tab-stop:.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Symbol;} @list l9:level2 =09{mso-level-number-format:bullet; =09mso-level-text:o; =09mso-level-tab-stop:1.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:"Courier New"; =09mso-bidi-font-family:"Times New Roman";} @list l9:level3 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:1.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l9:level4 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:2.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l9:level5 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:2.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l9:level6 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:3.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l9:level7 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:3.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l9:level8 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:4.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l9:level9 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:4.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l10 =09{mso-list-id:1434012829; =09mso-list-template-ids:-690447050;} @list l10:level1 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=B7; =09mso-level-tab-stop:.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Symbol;} @list l10:level2 =09{mso-level-number-format:bullet; =09mso-level-text:o; =09mso-level-tab-stop:1.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:"Courier New"; =09mso-bidi-font-family:"Times New Roman";} @list l10:level3 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:1.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l10:level4 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:2.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l10:level5 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:2.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l10:level6 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:3.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l10:level7 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:3.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l10:level8 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:4.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l10:level9 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:4.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l11 =09{mso-list-id:1546865247; =09mso-list-template-ids:-1306373494;} @list l11:level1 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=B7; =09mso-level-tab-stop:.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Symbol;} @list l11:level2 =09{mso-level-number-format:bullet; =09mso-level-text:o; =09mso-level-tab-stop:1.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:"Courier New"; =09mso-bidi-font-family:"Times New Roman";} @list l11:level3 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:1.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l11:level4 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:2.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l11:level5 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:2.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l11:level6 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:3.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l11:level7 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:3.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l11:level8 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:4.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l11:level9 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:4.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l12 =09{mso-list-id:2135564416; =09mso-list-template-ids:728504136;} @list l12:level1 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=B7; =09mso-level-tab-stop:.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Symbol;} @list l12:level2 =09{mso-level-number-format:bullet; =09mso-level-text:o; =09mso-level-tab-stop:1.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:"Courier New"; =09mso-bidi-font-family:"Times New Roman";} @list l12:level3 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:1.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l12:level4 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:2.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l12:level5 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:2.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l12:level6 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:3.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l12:level7 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:3.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l12:level8 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:4.0in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} @list l12:level9 =09{mso-level-number-format:bullet; =09mso-level-text:=EF=82=A7; =09mso-level-tab-stop:4.5in; =09mso-level-number-position:left; =09text-indent:-.25in; =09mso-ansi-font-size:10.0pt; =09font-family:Wingdings;} ol =09{margin-bottom:0in;} ul =09{margin-bottom:0in;} --></style> <div class=3D"WordSection1"> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">Hi Vojtech,</span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D"> </span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">Thanks for the reply. The= plugin framework for adding a custom context sensitive button/menu item an= d the iframe loading support for the main tab plugin will be welcome additions. </span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D"> </span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">For the custom UI dialog,= we=E2=80=99re looking for something that works similar to the tab in that = it will show a particular URL in an iFrame in a dialog. Or potentially since it is a dialog, it could just show it in separate window altogether.= The dialog would be opened when the context sensitive button or menu item = is activated. So it would be nice if the plugin framework would allow a plu= gged in button definition to define a URL to load in a dialog when it is activated.</span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D"> </span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">I=E2=80=99ll start lookin= g at adding the ability to launch a dialog with context through the plugin = API and let you know how that goes in a few days (Maybe sooner if I have questions about it. ;)</span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D"> </span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">Finally, would it be poss= ible to give an estimate on when you think the PoC rev 6 will be available?= We=E2=80=99ve got scheduled deliveries internally based on this code and it would be better to make sure everything lines up now.</span></= p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D"> </span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">Thanks!</span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D"> </span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">Chris</span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D"> </span></p> <div> <div style=3D"border:none;border-top:solid #B5C4DF 1.0pt;padding:3.0pt 0in = 0in 0in"> <p class=3D"MsoNormal"><b><span style=3D"font-size:10.0pt;font-family:"= ;Tahoma","sans-serif"">From:</span></b><span style=3D"font-s= ize:10.0pt;font-family:"Tahoma","sans-serif""> Vojtech = Szocs [mailto:vszocs@redhat.com] <br> <b>Sent:</b> Tuesday, October 02, 2012 2:47 PM<br> <b>To:</b> Morrissey, Christopher<br> <b>Cc:</b> Costea, George; Schoenbrun, Dustin; engine-devel@ovirt.org<br> <b>Subject:</b> Re: [Engine-devel] UI Plugins: PoC patch revision 5 is here= </span></p> </div> </div> <p class=3D"MsoNormal"> </p> <div> <p class=3D"MsoNormal"><span style=3D"color:black">Hi Chris,<br> <br> many thanks for your feedback and suggestions :)<br> <br> Adding context-sensitive button with corresponding menu item sounds good! I= n fact, this is the proper way how context menu items should be handled, si= nce WebAdmin data grids work with context-sensitive "action buttons" which = are reflected within the context menu. I agree that this is a very useful feature to have in plugin API, it= should be implemented as part of next major PoC revision.<br> <br> I have a question though: when the user clicks the custom button or corresp= onding context menu item, will your plugin handle common dialog UI (everyth= ing except actual content) on its own, or do you prefer to have some kind o= f "dialog UI" API to create the standard-looking dialog frame for you? I like the idea of using iframe to = present custom content though :)<br> <br> As for grouping multiple context-sensitive buttons and corresponding contex= t menu items, this makes sense and we have something like this already impl= emented in WebAdmin (in Host main tab, Power Management drop-down group but= ton, but this is defined not to appear in context menu though). I think this should be part of "custom con= text-sensitive button / menu item" plugin API feature.<br> <br> > </span><span style=3D"font-size:11.0pt;font-family:"Calibri"= ,"sans-serif";color:#1F497D">If needed we can help work on an imp= lementation for the dialog popup plugin framework as we=E2=80=99d like to g= et it in relatively quickly so we can move forward on the content side of our plugin.</span><span style=3D"color:black"><br> <br> If I understand correctly, this is about providing "dialog UI" API to creat= e the standard-looking dialog frame + custom content iframe. I'd like to he= lp with this as well, but you can play with the code and propose a pa= tch on top of PoC rev.5 [http://gerrit.ovirt.org/8120].<br> <br> > </span><span style=3D"font-size:11.0pt;font-family:"Calibri"= ,"sans-serif";color:#1F497D">For the reverse proxy, would it be e= asier from a customer standpoint to just include a reverse proxy servlet su= ch as this one?<br> </span><span style=3D"color:black"><br> Actually, I was under the impression that oVirt Engine (3.1) package (ovirt= -engine) takes care of setting up Apache web server, which redirects all tr= affic to Engine JBoss AS by default (but maybe I am wrong here). However, i= f this is the case, an efficient way to work around same-origin policy (cross-origin issues) is to configur= e Apache's reverese proxy module (mod_proxy), as discussed in another threa= d on engine-devel: <a href=3D"http://lists.ovirt.org/pipermail/engine-devel/2012-September/002= 511.html" target=3D"_blank"> http://lists.ovirt.org/pipermail/engine-devel/2012-September/002511.html</a= the recent patch [http://gerrit.ovirt.org/8120]! I'll update the patch acco= rdingly as revision 5.1<br> <br> <b>Planned items to be included in PoC revision 6:</b></span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l7 level1 lfo1"> adding custom context-sensitive button (either separately or within a butto= n group), along with corresponding context menu item representation</li><li= class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-margi= n-bottom-alt:auto;mso-list:l7 level1 lfo1"> update custom main tab to show the actual content (iframe) from the given U= RL</li><li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto= ;mso-margin-bottom-alt:auto;mso-list:l7 level1 lfo1"> adding custom sub tab that shows content from the given URL</li></ul> <p><span style=3D"color:black"> </span></p> <p><b><span style=3D"color:black">More items to consider having in PoC revi= sion 6:</span></b><span style=3D"color:black"></span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l11 level1 lfo2"> "dialog UI" API to create the standard-looking dialog frame + custom conten= t iframe</li><li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-al= t:auto;mso-margin-bottom-alt:auto;mso-list:l11 level1 lfo2"> Engine REST API exposed through plugin API</li><li class=3D"MsoNormal" styl= e=3D"color:black;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-lis= t:l11 level1 lfo2"> integration with Tasks pane to provide visual feedback on custom operations= </li><li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;m= so-margin-bottom-alt:auto;mso-list:l11 level1 lfo2"> extending existing dialogs (e.g. Edit Cluster Policy - custom properties)</= li></ul> <p><span style=3D"color:black"> </span></p> <p><span style=3D"color:black">Let me know what you think.</span></p> <p><span style=3D"color:black"> </span></p> <p class=3D"MsoNormal" style=3D"margin-bottom:12.0pt"><span style=3D"color:= black">Regards,<br> Vojtech<br> <br> </span></p> <div class=3D"MsoNormal" style=3D"text-align:center" align=3D"center"><span= style=3D"color:black"> <hr id=3D"zwchr" size=3D"2" width=3D"100%" align=3D"center"> </span></div> <div> <p class=3D"MsoNormal" style=3D"margin-bottom:12.0pt"><b><span style=3D"fon= t-family:"Helvetica","sans-serif";color:black">From: </span></b><span style=3D"font-family:"Helvetica","sans-seri= f";color:black">"Christopher Morrissey" <Christopher.Morrissey@neta= pp.com><br> <b>To: </b>vszocs@redhat.com<br> <b>Cc: </b>"George Costea" <George.Costea@netapp.com>, "Dustin Schoen= brun" <Dustin.Schoenbrun@netapp.com>, engine-devel@ovirt.org<br> <b>Sent: </b>Tuesday, October 2, 2012 6:15:34 PM<br> <b>Subject: </b>RE: [Engine-devel] UI Plugins: PoC patch revision 5 is here= </span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">Hi Vojtech,</span><span s= tyle=3D"color:black"></span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D"> </span><span style= =3D"color:black"></span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">The patch is great and ha= s cleared up some questions I had about the implementation. I=E2=80=99ve be= en able to get the sample plugins working and waded through the code changes, so feel like I have a good understanding of what was deliver= ed. Thanks a lot for putting this all together. I do have a few questions a= nd suggestions for you, though.</span><span style=3D"color:black"></span></= p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D"> </span><span style= =3D"color:black"></span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">Will there eventually be = a way to add one or more buttons to the context sensitive buttons and menus= throughout the interface? For example, we=E2=80=99d like to allow a button to provision a datastore when a data center, cluster, or host is = selected. When the button is clicked, it would open a dialog with an iframe= in which we would load our interface to perform the associated action. Som= e contexts would have several buttons, such as a storage domain (provision, resize, dedupe management, destroy) s= o it would probably make sense for a drop down menu to be available as well= so that the number of buttons above the table doesn=E2=80=99t get too clut= tered. We=E2=80=99d also like to add these same actions to the menus that popup when a contextual object is right clicked.= </span><span style=3D"color:black"></span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D"> </span><span style= =3D"color:black"></span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">If needed we can help wor= k on an implementation for the dialog popup plugin framework as we=E2=80=99= d like to get it in relatively quickly so we can move forward on the content side of our plugin.</span><span style=3D"color:black"></span><= /p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D"> </span><span style= =3D"color:black"></span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">For the reverse proxy, wo= uld it be easier from a customer standpoint to just include a reverse proxy= servlet such as this one? </span><span style=3D"color:black"><a href= =3D"http://sourceforge.net/projects/j2ep/" target=3D"_blank">http://sourcef= orge.net/projects/j2ep/</a> </span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">I=E2=80=99m just thinking= that setting up and managing a plugin for the HTTP server may be more comp= lex than including one internally that would be transparent to a customer.</span><span style=3D"color:black"></span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D"> </span><span style= =3D"color:black"></span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">Thanks,</span><span style= =3D"color:black"></span></p> <p class=3D"MsoNormal"><span style=3D"font-size:11.0pt;font-family:"Ca= libri","sans-serif";color:#1F497D">Chris</span><span style= =3D"color:black"></span></p> <blockquote style=3D"margin-top:5.0pt;margin-bottom:5.0pt"> <div> <p class=3D"MsoNormal" style=3D"margin-bottom:12.0pt"><b><span style=3D"col= or:black">From:</span></b><span style=3D"color:black"> Vojtech Szocs <<a= href=3D"mailto:vszocs@redhat.com" target=3D"_blank">vszocs@redhat.com</a>&= gt;<br> <b>Date:</b> September 21, 2012 4:37:31 PM EDT<br> <b>To:</b> engine-devel <<a href=3D"mailto:engine-devel@ovirt.org" targe= t=3D"_blank">engine-devel@ovirt.org</a>><br> <b>Subject:</b> <b>[Engine-devel] UI Plugins: PoC patch revision 5 is here<= /b></span></p> </div> </blockquote> <blockquote style=3D"margin-top:5.0pt;margin-bottom:5.0pt"> <div> <div> <p class=3D"MsoNormal" style=3D"margin-bottom:12.0pt"><span style=3D"color:= black">Hi guys,<br> <br> it's been a while but here comes the latest revision of UI Plugins proof-of= -concept patch (please find it attached).<br> <br> This revision was originally meant to focus solely on server-side component= s of the plugin infrastructure. However, I ended up implementing all the ma= jor concepts and ideas as discussed on engine-devel mailing list, impacting= both client-side and server-side parts of the plugin infrastructure. As a result, UI plugin infrastructure = should be pretty much complete now, so we can focus on specific plugin API = features in upcoming PoC revisions.<br> <br> There's a whole bunch of changes and improvements in this revision, so I'll= try to cover all the relevant parts step by step. If you have any comments= , questions or ideas, please let me know!<br> <br> So here we go... (or if you just want to get the patch, find the link at th= e end of this message)</span></p> <div class=3D"MsoNormal" style=3D"text-align:center" align=3D"center"><span= style=3D"color:black"> <hr size=3D"2" width=3D"100%" align=3D"center"> </span></div> <p class=3D"MsoNormal"><span style=3D"color:black"><br> <strong>0. Added new Engine configuration values</strong><b><br> </b><br> <u>UI plugin data path</u> is represented by <em>ConfigValues.UIPluginDataP= ath</em> enum option ("UIPluginDataPath" in <i>vdc_options</i> table), and resolved relative to <i>ConfigValues.DataDir= </i> if possible. Following (default) values:</span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l0 level1 lfo3"> <i>UIPluginDataPath =3D ui-plugins</i></li><li class=3D"MsoNormal" style=3D= "color:black;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l0= level1 lfo3"> <i>DataDir =3D /usr/share/ovirt-engine</i></li></ul> <p class=3D"MsoNormal"><span style=3D"color:black">result in UI plugin data= path: <i> /usr/share/ovirt-engine/ui-plugins</i><br> <br> <u>UI plugin config path</u> is represented by <i>ConfigValues.UIPluginConf= igPath</i> enum option ("UIPluginConfigPath" in <i>vdc_options</i> table), and resolved relative to <i>ConfigValues.ConfigD= ir</i> if possible. Following (default) values:</span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l3 level1 lfo4"> <i>UIPluginConfigPath =3D ui-plugins</i></li><li class=3D"MsoNormal" style= =3D"color:black;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list= :l3 level1 lfo4"> <i>ConfigDir =3D /etc/ovirt-engine</i></li></ul> <p><span style=3D"color:black">result in UI plugin config path: <i>/etc/ovi= rt-engine/ui-plugins</i></span></p> <p class=3D"MsoNormal"><span style=3D"color:black"><br> <b>1. Processing UI plugin data on the server<br> </b><br> <i>PluginDataManager</i> is the class responsible for reading, validating a= nd caching UI plugin descriptor/configuration data on the server (Engine). = It has two main responsibilities:</span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l2 level1 lfo5"> return a snapshot of currently valid plugin data (<i>getCurrentData</i> met= hod)</li><li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:au= to;mso-margin-bottom-alt:auto;mso-list:l2 level1 lfo5"> reload plugin data from local file system if necessary (<i>reloadData</i> m= ethod)</li></ul> <p><span style=3D"color:black">The <i>reloadData</i> method doesn't modify = "live" plugin data directly. Instead, it creates a local working copy of cu= rrent plugin data, updates this copy as it reads/validates plugin descripto= r and configuration files, and attempts to update "live" plugin data through conditional reference re-assignment (= using <i> java.util.concurrent.atomic.AtomicReference.compareAndSet</i> method).</spa= n></p> <p><span style=3D"color:black"> </span></p> <p><span style=3D"color:black">In other words, <i>reloadData</i> method mak= es no attempts with regard to Java lock-based synchronization, in favor of = dealing with "live" data through <i>AtomicReference</i> (reference that involves atomic <i>volatile</i> read= s and writes):</span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l4 level1 lfo6"> In the best case, a thread will succeed in updating "live" data (<i>AtomicR= eference.compareAndSet</i> =3D=3D true), which means that "live" data remai= ned unchanged since this thread acquired a reference of current plugin data= .</li><li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;= mso-margin-bottom-alt:auto;mso-list:l4 level1 lfo6"> In the worst case, a thread will NOT succeed in updating "live" data (<i>At= omicReference.compareAndSet</i> =3D=3D false), which means that "live" data= was already changed by another thread since this thread acquired a referen= ce of current plugin data.</li></ul> <p><span style=3D"color:black">In my opinion, when dealing with external re= sources like the local file system, this is a good compromise between perfo= rmance and up-to-date data. While we might not get "completely-up-to-date" = data at the given point in time (<i>reloadData + getCurrentData</i>), we are guaranteed to get "recently-up-to-date" and = consistent data. In other words, the requirement of "completely-up-to-date"= data would involve <i>synchronized</i> statements that would hurt performance. In my (very hum= ble) opinion, the benefit of having "completely-up-to-date" data, at the co= st of reduced performance, is not really worth it, especially in our case w= hen the user can just hit refresh (F5) to reload WebAdmin and its plugin data.</span></p> <p><span style=3D"color:black"> </span></p> <p><u><span style=3D"color:black">Plugin descriptor files</span></u><span s= tyle=3D"color:black"> are expected to be placed in UI plugin data path, for= example: <i>/usr/share/ovirt-engine/ui-plugins/foo.json</i></span></p> <p><span style=3D"color:black"> </span></p> <p><span style=3D"color:black">Following descriptor file attributes are imp= lemented and recognized by the plugin infrastructure:</span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l10 level1 lfo7"> <i>name</i>: A name that uniquely identifies the plugin (required attribute= ).</li><li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto= ;mso-margin-bottom-alt:auto;mso-list:l10 level1 lfo7"> <i>url</i>: URL of plugin host page that invokes the plugin code (required = attribute).</li><li class=3D"MsoNormal" style=3D"color:black;mso-margin-top= -alt:auto;mso-margin-bottom-alt:auto;mso-list:l10 level1 lfo7"> <i>config</i>: Default configuration object associated with the plugin (opt= ional attribute).</li><li class=3D"MsoNormal" style=3D"color:black;mso-marg= in-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l10 level1 lfo7"> <i>resourcePath</i>: Path to plugin static resources, relative to UI plugin= data path (optional attribute). This is used when serving plugin files thr= ough Engine <i>PluginResourceServlet</i> (more on this below).</li></ul> <p><u><span style=3D"color:black">Plugin configuration files</span></u><spa= n style=3D"color:black"> are expected to be placed in UI plugin config path= , for example: <i>/etc/engine/ui-plugins/foo-config.json</i></span></p> <p><span style=3D"color:black"> </span></p> <p><span style=3D"color:black">Note that plugin configuration files follow = the "<descriptorFileName>-config.json" convention.</span></p> <p><span style=3D"color:black"> </span></p> <p><span style=3D"color:black">Following configuration file attributes are = implemented and recognized by the plugin infrastructure:</span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l9 level1 lfo8"> <i>config</i>: Custom configuration object associated with the plugin (opti= onal attribute). This overrides the default plugin descriptor configuration= , if any.</li><li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-a= lt:auto;mso-margin-bottom-alt:auto;mso-list:l9 level1 lfo8"> <i>enabled</i>: Indicates whether the plugin should be loaded on WebAdmin s= tartup (optional attribute). Default value is 'true'.</li><li class=3D"MsoN= ormal" style=3D"color:black;mso-margin-top-alt:auto;mso-margin-bottom-alt:a= uto;mso-list:l9 level1 lfo8"> <i>order</i>: Defines the relative order in which the plugin will be loaded= on WebAdmin startup (optional attribute). Default value is <i>Integer.MAX_VALUE</i> (lowest order).</li></ul> <p><span style=3D"color:black">The concept of merging custom configuration = (<i>config</i> attribute in <i>foo-config.json</i>), if any, on top of default configuration (<i>config= </i> attribute in <i>foo.json</i>), if any, remains unchanged. This makes the plugin configur= ation quite flexible - in my opinion, the added complexity of handling/merg= ing such configuration is definitely worth the effort.</span></p> <p><span style=3D"color:black"> </span></p> <p><span style=3D"color:black">The <i>enabled</i> attribute is straight-for= ward, allowing users to turn the given plugin off, if necessary. In future,= users should still be able to load such plugins through WebAdmin GUI.</spa= n></p> <p><span style=3D"color:black"> </span></p> <p><span style=3D"color:black">The <i>order</i> attribute controls the orde= r in which plugins are loaded on WebAdmin startup. Since plugin resources a= re fetched asynchronously by the browser, this is basically a way of imposi= ng some degree of determinism in the "generally-non-deterministic" plugin environment, which is helpful when tr= oubleshooting problems with multiple plugins. This attribute is also helpfu= l due to file listing methods in <i>java.io.File</i> giving no guarantees that files would be listed in any = particular order (otherwise we could just go for the "NN-<descriptorFile= Name>.json" convention, with NN being the order number).</span></p> <p class=3D"MsoNormal"><span style=3D"color:black"><br> <b>2. Modified behavior of WebadminDynamicHostingServlet<br> </b><br> <i>WebadminDynamicHostingServlet</i> is the servlet used to serve WebAdmin = application host page (HTML page that bootstraps WebAdmin JavaScript code).= <br> <br> In addition to its former behavior, as part of handling the given request, = <i>WebadminDynamicHostingServlet</i>:</span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l8 level1 lfo9"> reloads descriptor/configuration data from local file system if necessary, = and obtains a snapshot of currently valid plugin data (<i>PluginDataManager= .reloadAndGetCurrentData</i>)</li><li class=3D"MsoNormal" style=3D"color:bl= ack;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l8 level1 l= fo9"> embeds all plugin meta-data, suitable for use in client-side plugin infrast= ructure, into WebAdmin host page as "pluginDefinitions" JavaScript array (<= i>PluginDefinitions</i>)</li></ul> <p class=3D"MsoNormal"><span style=3D"color:black">As a result, reloading U= I plugin descriptor/configuration data is as simple as refreshing (F5) WebA= dmin application in the browser (no need to restart Engine).<br> <br> <b>3. Added servlet for serving plugin static resources<br> </b><br> <i>PluginResourceServlet</i> is the servlet used to serve UI plugin static = files (plugin host page, 3rd party JavaScript, etc.) from the local file sy= stem.<br> <br> For example, requesting URL:</span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l5 level1 lfo10"> <i><a>http://<EngineManagerHost>:8700/webadmin/webadmin/plugin/foo/co= ntent/start.html</a></i></li></ul> <p><span style=3D"color:black">will send the content of:</span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l1 level1 lfo11"> <i>/usr/share/ovirt-engine/ui-plugins/<resourcePath>/content/start.ht= ml</i></li></ul> <p><span style=3D"color:black">to the client.</span></p> <p><span style=3D"color:black"> </span></p> <p><span style=3D"color:black">As shown in the above example:</span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l12 level1 lfo12"> <i>/webadmin/webadmin/plugin/</i> is the servlet root path for <i>PluginRes= ourceServlet</i></li><li class=3D"MsoNormal" style=3D"color:black;mso-margi= n-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l12 level1 lfo12"> in the extra path beyond the servlet root path (<i>/foo/content/start.html<= /i>):</li></ul> <ul type=3D"disc"> <ul type=3D"circle"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l12 level2 lfo12"> <i>/foo</i> represents the name of the plugin</li><li class=3D"MsoNormal" s= tyle=3D"color:black;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-= list:l12 level2 lfo12"> <i>/content/start.html</i> represents the path to requested resource, relat= ive to "UIPluginDataPath / <resourcePath>"</li></ul> </ul> <p class=3D"MsoNormal"><span style=3D"color:black">Note that each plugin us= ing <i>PluginResourceServlet</i> to serve its static files must declare non= -empty <i>resourcePath</i> attribute in within the plugin descriptor.<br> <br> Also note that <i>PluginResourceServlet</i>, unlike <i>WebadminDynamicHosti= ngServlet</i>, does NOT reload descriptor/configuration data from local fil= e system as part of handling the given request. In other words, it's assume= d that plugin data has already been (re)loaded when serving WebAdmin application host page, with subsequent re= quests to <i>PluginResourceServlet</i> reading the current plugin information.<br> <br> Until we solve the cross-origin issue in a clean way, <i>PluginResourceServ= let</i> should be used to serve all plugin resources from local file system= .<br> <br> <b>4. Plugin lifecycle improved to deal with misbehaving plugins</b><br> <br> <i>PluginState</i> enum has been modified to deal with plugins that allow u= ncaught exceptions to escape from plugin event handler functions (e.g. "UiI= nit"):</span></p> <ul type=3D"disc"> <li class=3D"MsoNormal" style=3D"color:black;mso-margin-top-alt:auto;mso-ma= rgin-bottom-alt:auto;mso-list:l6 level1 lfo13"> removed state <i>INITIALIZED</i></li><li class=3D"MsoNormal" style=3D"color= :black;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l6 level= 1 lfo13"> added state <i>INITIALIZING</i>: The plugin is (currently) being initialize= d by calling UiInit event handler function.</li><li class=3D"MsoNormal" sty= le=3D"color:black;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-li= st:l6 level1 lfo13"> added state <i>IN_USE</i>: Plugin's UiInit event handler function has compl= eted successfully, we can now call other event handler functions as necessa= ry. The plugin is in use now.</li><li class=3D"MsoNormal" style=3D"color:bl= ack;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l6 level1 l= fo13"> added state <i>FAILED</i>: An uncaught exception escaped while calling an e= vent handler function, which indicates internal error within the plugin cod= e. The plugin is removed from service.</li></ul> <p class=3D"MsoNormal" style=3D"margin-bottom:12.0pt"><span style=3D"color:= black">I've attached a simple state diagram that illustrates different stat= es and transitions between them (green color is initial state, red color is= end state).<br> <br> Uncaught exceptions in plugin event handler functions will be caught and ha= ndled by the plugin infrastructure. This prevents a misbehaving plugin from= breaking WebAdmin application, since WebAdmin is the caller (initiator) of= the function call. In such case, the plugin will be removed from service.<br> <br> <b>Update on cross-origin issue (consequence of same-origin policy)</b><br> <br> In order for the plugin to access WebAdmin plugin API, plugin host page (e.= g. <i> start.html</i>) must be served from URL on same origin as Engine origin. Ot= herwise, plugin code running in the context of an iframe'd host page will f= ail to evaluate "parent.pluginApi" expression, with "parent" being top-leve= l (WebAdmin) window, and "pluginApi" being the global plugin API object exposed by WebAdmin.<br> <br> This is why <i>PluginResourceServlet</i>, available on Engine origin, shoul= d be used to serve all plugin resources from local file system.<br> <br> There's only one issue that remains to be solved: cross-origin "plugin vs. = remote service" communication, with "remote service" being anything other t= han Engine (REST API). In future, we'll address this with Apache reverse pr= oxy configuration, so that users can configure Apache server (placed in front of Engine JBoss AS) to put ar= bitrary (local or remote non-Engine) services on same origin. However, this= requires a change in current Apache configuration. Until then, users can m= anually edit the Engine Apache configuration file (<i>/etc/httpd/conf.d/ovirt-engine.conf</i>).</span></p> <div class=3D"MsoNormal" style=3D"text-align:center" align=3D"center"><span= style=3D"color:black"> <hr size=3D"2" width=3D"100%" align=3D"center"> </span></div> <p class=3D"MsoNormal" style=3D"margin-bottom:12.0pt"><span style=3D"color:= black"><br> I've attached some sample plugin files for you to experiment with. Instead = of attaching actual patch file (92 kB) to this email, I've submitted the pa= tch to oVirt Gerrit: <a href=3D"http://gerrit.ovirt.org/8120" target=3D"_blank">http://gerrit.ov= irt.org/8120</a><br> <br> Let me know what you think!<br> <br> Cheers,<br> Vojtech</span></p> </div> </div> </blockquote> <blockquote style=3D"margin-top:5.0pt;margin-bottom:5.0pt"> <div> <p class=3D"MsoNormal"><span style=3D"color:black"><ui-plugin-sample-fil= es.tar.gz></span></p> </div> </blockquote> <blockquote style=3D"margin-top:5.0pt;margin-bottom:5.0pt"> <div> <p class=3D"MsoNormal"><span style=3D"color:black"><ui-plugin-lifecycle.= png></span></p> </div> </blockquote> <blockquote style=3D"margin-top:5.0pt;margin-bottom:5.0pt"> <div> <p class=3D"MsoNormal"><span style=3D"color:black">________________________= _______________________<br> Engine-devel mailing list<br> <a href=3D"mailto:Engine-devel@ovirt.org" target=3D"_blank">Engine-devel@ov= irt.org</a><br> <a href=3D"http://lists.ovirt.org/mailman/listinfo/engine-devel" target=3D"= _blank">http://lists.ovirt.org/mailman/listinfo/engine-devel</a></span></p> </div> </blockquote> </div> <p class=3D"MsoNormal"><span style=3D"color:black"> </span></p> </div> </div> </div><br></div></body></html> ------=_Part_4133380_10286535.1349259508244--
On 10/02/2012 08:46 PM, Vojtech Szocs wrote:
Hi Chris,
many thanks for your feedback and suggestions :)
Adding context-sensitive button with corresponding menu item sounds good! In fact, this is the proper way how context menu items should be handled, since WebAdmin data grids work with context-sensitive "action buttons" which are reflected within the context menu. I agree that this is a very useful feature to have in plugin API, it should be implemented as part of next major PoC revision.
I have a question though: when the user clicks the custom button or corresponding context menu item, will your plugin handle common dialog UI (everything except actual content) on its own, or do you prefer to have some kind of "dialog UI" API to create the standard-looking dialog frame for you? I like the idea of using iframe to present custom content though :)
As for grouping multiple context-sensitive buttons and corresponding context menu items, this makes sense and we have something like this already implemented in WebAdmin (in Host main tab, Power Management drop-down group button, but this is defined not to appear in context menu though). I think this should be part of "custom context-sensitive button / menu item" plugin API feature.
If needed we can help work on an implementation for the dialog popup plugin framework as we’d like to get it in relatively quickly so we can move forward on the content side of our plugin.
If I understand correctly, this is about providing "dialog UI" API to create the standard-looking dialog frame + custom content iframe. I'd like to help with this as well, but you can play with the code and propose a patch on top of PoC rev.5 [http://gerrit.ovirt.org/8120].
For the reverse proxy, would it be easier from a customer standpoint to just include a reverse proxy servlet such as this one?
Actually, I was under the impression that oVirt Engine (3.1) package (ovirt-engine) takes care of setting up Apache web server, which redirects all traffic to Engine JBoss AS by default (but maybe I am wrong here). However, if this is the case, an efficient way to work around same-origin policy (cross-origin issues) is to configure Apache's reverese proxy module (mod_proxy), as discussed in another thread on engine-devel: http://lists.ovirt.org/pipermail/engine-devel/2012-September/002511.html
This way, you could use Apache to bring Engine and arbitrary (local or remote) web services on same origin. What do you think?
On the other hand, using a special-purpose reverse proxy servlet directly in Engine, not sure if that's a good idea though.. (I'd prefer configuring "front-end" web server, such as Apache, for this purpose)
Chris, adding the proxy servlet brings a new dependency that can be difficult to package. The one that you propose in particular is not included in many distributions, including Fedora. On the other hand using the web server doesn't bring any additional dependency, as mod_proxy is already part of almost any installation of Apache. We already use it by default to redirect requests to the application server as Vojtech said. Imagine for example that the engine is running in ovirt.example.com and that you need to access from your UI plugin a web service running in netapp.example.com. All what will be needed is dropping a new netapp-plugin.conf file in the /etc/httpd/conf.d directory with a content similar to this one: ProxyPass /myservice http://netapp.example.com/myservice This can be easily done in the package of your plugin. There are some things that we need to solve to make this work (currently we send *all* the requests to the application server), but we want to solve them anyway.
I'm also sending a couple of updates:
UI Plugins Follow-Up Meeting: scheduled for Tuesday, October 9 at 4pm GMT+1 (I'll send a meeting invitation soon, also planning to re-write oVirt UI Plugins wiki soon after that)
PoC rev.5 patch update: many thanks to Juan and Doron for reviewing the recent patch [http://gerrit.ovirt.org/8120]! I'll update the patch accordingly as revision 5.1
Planned items to be included in PoC revision 6:
* adding custom context-sensitive button (either separately or within a button group), along with corresponding context menu item representation * update custom main tab to show the actual content (iframe) from the given URL * adding custom sub tab that shows content from the given URL
More items to consider having in PoC revision 6:
* "dialog UI" API to create the standard-looking dialog frame + custom content iframe * Engine REST API exposed through plugin API * integration with Tasks pane to provide visual feedback on custom operations * extending existing dialogs (e.g. Edit Cluster Policy - custom properties)
Let me know what you think.
Regards, Vojtech
----- Original Message -----
From: "Christopher Morrissey" <Christopher.Morrissey@netapp.com> To: vszocs@redhat.com Cc: "George Costea" <George.Costea@netapp.com>, "Dustin Schoenbrun" <Dustin.Schoenbrun@netapp.com>, engine-devel@ovirt.org Sent: Tuesday, October 2, 2012 6:15:34 PM Subject: RE: [Engine-devel] UI Plugins: PoC patch revision 5 is here
Hi Vojtech,
The patch is great and has cleared up some questions I had about the implementation. I’ve been able to get the sample plugins working and waded through the code changes, so feel like I have a good understanding of what was delivered. Thanks a lot for putting this all together. I do have a few questions and suggestions for you, though.
Will there eventually be a way to add one or more buttons to the context sensitive buttons and menus throughout the interface? For example, we’d like to allow a button to provision a datastore when a data center, cluster, or host is selected. When the button is clicked, it would open a dialog with an iframe in which we would load our interface to perform the associated action. Some contexts would have several buttons, such as a storage domain (provision, resize, dedupe management, destroy) so it would probably make sense for a drop down menu to be available as well so that the number of buttons above the table doesn’t get too cluttered. We’d also like to add these same actions to the menus that popup when a contextual object is right clicked.
If needed we can help work on an implementation for the dialog popup plugin framework as we’d like to get it in relatively quickly so we can move forward on the content side of our plugin.
For the reverse proxy, would it be easier from a customer standpoint to just include a reverse proxy servlet such as this one? http://sourceforge.net/projects/j2ep/ I’m just thinking that setting up and managing a plugin for the HTTP server may be more complex than including one internally that would be transparent to a customer.
Thanks, Chris
From: Vojtech Szocs < vszocs@redhat.com > Date: September 21, 2012 4:37:31 PM EDT To: engine-devel < engine-devel@ovirt.org > Subject: [Engine-devel] UI Plugins: PoC patch revision 5 is here
<blockquote>
Hi guys,
it's been a while but here comes the latest revision of UI Plugins proof-of-concept patch (please find it attached).
This revision was originally meant to focus solely on server-side components of the plugin infrastructure. However, I ended up implementing all the major concepts and ideas as discussed on engine-devel mailing list, impacting both client-side and server-side parts of the plugin infrastructure. As a result, UI plugin infrastructure should be pretty much complete now, so we can focus on specific plugin API features in upcoming PoC revisions.
There's a whole bunch of changes and improvements in this revision, so I'll try to cover all the relevant parts step by step. If you have any comments, questions or ideas, please let me know!
So here we go... (or if you just want to get the patch, find the link at the end of this message)
0. Added new Engine configuration values
UI plugin data path is represented by ConfigValues.UIPluginDataPath enum option ("UIPluginDataPath" in vdc_options table), and resolved relative to ConfigValues.DataDir if possible. Following (default) values:
* UIPluginDataPath = ui-plugins * DataDir = /usr/share/ovirt-engine
result in UI plugin data path: /usr/share/ovirt-engine/ui-plugins
UI plugin config path is represented by ConfigValues.UIPluginConfigPath enum option ("UIPluginConfigPath" in vdc_options table), and resolved relative to ConfigValues.ConfigDir if possible. Following (default) values:
* UIPluginConfigPath = ui-plugins * ConfigDir = /etc/ovirt-engine
result in UI plugin config path: /etc/ovirt-engine/ui-plugins
1. Processing UI plugin data on the server
PluginDataManager is the class responsible for reading, validating and caching UI plugin descriptor/configuration data on the server (Engine). It has two main responsibilities:
* return a snapshot of currently valid plugin data ( getCurrentData method) * reload plugin data from local file system if necessary ( reloadData method)
The reloadData method doesn't modify "live" plugin data directly. Instead, it creates a local working copy of current plugin data, updates this copy as it reads/validates plugin descriptor and configuration files, and attempts to update "live" plugin data through conditional reference re-assignment (using java.util.concurrent.atomic.AtomicReference.compareAndSet method).
In other words, reloadData method makes no attempts with regard to Java lock-based synchronization, in favor of dealing with "live" data through AtomicReference (reference that involves atomic volatile reads and writes):
* In the best case, a thread will succeed in updating "live" data ( AtomicReference.compareAndSet == true), which means that "live" data remained unchanged since this thread acquired a reference of current plugin data. * In the worst case, a thread will NOT succeed in updating "live" data ( AtomicReference.compareAndSet == false), which means that "live" data was already changed by another thread since this thread acquired a reference of current plugin data.
In my opinion, when dealing with external resources like the local file system, this is a good compromise between performance and up-to-date data. While we might not get "completely-up-to-date" data at the given point in time ( reloadData + getCurrentData ), we are guaranteed to get "recently-up-to-date" and consistent data. In other words, the requirement of "completely-up-to-date" data would involve synchronized statements that would hurt performance. In my (very humble) opinion, the benefit of having "completely-up-to-date" data, at the cost of reduced performance, is not really worth it, especially in our case when the user can just hit refresh (F5) to reload WebAdmin and its plugin data.
Plugin descriptor files are expected to be placed in UI plugin data path, for example: /usr/share/ovirt-engine/ui-plugins/foo.json
Following descriptor file attributes are implemented and recognized by the plugin infrastructure:
* name : A name that uniquely identifies the plugin (required attribute). * url : URL of plugin host page that invokes the plugin code (required attribute). * config : Default configuration object associated with the plugin (optional attribute). * resourcePath : Path to plugin static resources, relative to UI plugin data path (optional attribute). This is used when serving plugin files through Engine PluginResourceServlet (more on this below).
Plugin configuration files are expected to be placed in UI plugin config path, for example: /etc/engine/ui-plugins/foo-config.json
Note that plugin configuration files follow the "<descriptorFileName>-config.json" convention.
Following configuration file attributes are implemented and recognized by the plugin infrastructure:
* config : Custom configuration object associated with the plugin (optional attribute). This overrides the default plugin descriptor configuration, if any. * enabled : Indicates whether the plugin should be loaded on WebAdmin startup (optional attribute). Default value is 'true'. * order : Defines the relative order in which the plugin will be loaded on WebAdmin startup (optional attribute). Default value is Integer.MAX_VALUE (lowest order).
The concept of merging custom configuration ( config attribute in foo-config.json ), if any, on top of default configuration ( config attribute in foo.json ), if any, remains unchanged. This makes the plugin configuration quite flexible - in my opinion, the added complexity of handling/merging such configuration is definitely worth the effort.
The enabled attribute is straight-forward, allowing users to turn the given plugin off, if necessary. In future, users should still be able to load such plugins through WebAdmin GUI.
The order attribute controls the order in which plugins are loaded on WebAdmin startup. Since plugin resources are fetched asynchronously by the browser, this is basically a way of imposing some degree of determinism in the "generally-non-deterministic" plugin environment, which is helpful when troubleshooting problems with multiple plugins. This attribute is also helpful due to file listing methods in java.io.File giving no guarantees that files would be listed in any particular order (otherwise we could just go for the "NN-<descriptorFileName>.json" convention, with NN being the order number).
2. Modified behavior of WebadminDynamicHostingServlet
WebadminDynamicHostingServlet is the servlet used to serve WebAdmin application host page (HTML page that bootstraps WebAdmin JavaScript code).
In addition to its former behavior, as part of handling the given request, WebadminDynamicHostingServlet :
* reloads descriptor/configuration data from local file system if necessary, and obtains a snapshot of currently valid plugin data ( PluginDataManager.reloadAndGetCurrentData ) * embeds all plugin meta-data, suitable for use in client-side plugin infrastructure, into WebAdmin host page as "pluginDefinitions" JavaScript array ( PluginDefinitions )
As a result, reloading UI plugin descriptor/configuration data is as simple as refreshing (F5) WebAdmin application in the browser (no need to restart Engine).
3. Added servlet for serving plugin static resources
PluginResourceServlet is the servlet used to serve UI plugin static files (plugin host page, 3rd party JavaScript, etc.) from the local file system.
For example, requesting URL:
* http://<EngineManagerHost>:8700/webadmin/webadmin/plugin/foo/content/start.html
will send the content of:
* /usr/share/ovirt-engine/ui-plugins/<resourcePath>/content/start.html
to the client.
As shown in the above example:
* /webadmin/webadmin/plugin/ is the servlet root path for PluginResourceServlet * in the extra path beyond the servlet root path ( /foo/content/start.html ):
* /foo represents the name of the plugin * /content/start.html represents the path to requested resource, relative to "UIPluginDataPath / <resourcePath>"
Note that each plugin using PluginResourceServlet to serve its static files must declare non-empty resourcePath attribute in within the plugin descriptor.
Also note that PluginResourceServlet , unlike WebadminDynamicHostingServlet , does NOT reload descriptor/configuration data from local file system as part of handling the given request. In other words, it's assumed that plugin data has already been (re)loaded when serving WebAdmin application host page, with subsequent requests to PluginResourceServlet reading the current plugin information.
Until we solve the cross-origin issue in a clean way, PluginResourceServlet should be used to serve all plugin resources from local file system.
4. Plugin lifecycle improved to deal with misbehaving plugins
PluginState enum has been modified to deal with plugins that allow uncaught exceptions to escape from plugin event handler functions (e.g. "UiInit"):
* removed state INITIALIZED * added state INITIALIZING : The plugin is (currently) being initialized by calling UiInit event handler function. * added state IN_USE : Plugin's UiInit event handler function has completed successfully, we can now call other event handler functions as necessary. The plugin is in use now. * added state FAILED : An uncaught exception escaped while calling an event handler function, which indicates internal error within the plugin code. The plugin is removed from service.
I've attached a simple state diagram that illustrates different states and transitions between them (green color is initial state, red color is end state).
Uncaught exceptions in plugin event handler functions will be caught and handled by the plugin infrastructure. This prevents a misbehaving plugin from breaking WebAdmin application, since WebAdmin is the caller (initiator) of the function call. In such case, the plugin will be removed from service.
Update on cross-origin issue (consequence of same-origin policy)
In order for the plugin to access WebAdmin plugin API, plugin host page (e.g. start.html ) must be served from URL on same origin as Engine origin. Otherwise, plugin code running in the context of an iframe'd host page will fail to evaluate "parent.pluginApi" expression, with "parent" being top-level (WebAdmin) window, and "pluginApi" being the global plugin API object exposed by WebAdmin.
This is why PluginResourceServlet , available on Engine origin, should be used to serve all plugin resources from local file system.
There's only one issue that remains to be solved: cross-origin "plugin vs. remote service" communication, with "remote service" being anything other than Engine (REST API). In future, we'll address this with Apache reverse proxy configuration, so that users can configure Apache server (placed in front of Engine JBoss AS) to put arbitrary (local or remote non-Engine) services on same origin. However, this requires a change in current Apache configuration. Until then, users can manually edit the Engine Apache configuration file ( /etc/httpd/conf.d/ovirt-engine.conf ).
I've attached some sample plugin files for you to experiment with. Instead of attaching actual patch file (92 kB) to this email, I've submitted the patch to oVirt Gerrit: http://gerrit.ovirt.org/8120
Let me know what you think!
Cheers, Vojtech </blockquote>
<blockquote>
<ui-plugin-sample-files.tar.gz> </blockquote>
<blockquote>
<ui-plugin-lifecycle.png> </blockquote>
<blockquote>
_______________________________________________ Engine-devel mailing list Engine-devel@ovirt.org http://lists.ovirt.org/mailman/listinfo/engine-devel </blockquote>
_______________________________________________ Engine-devel mailing list Engine-devel@ovirt.org http://lists.ovirt.org/mailman/listinfo/engine-devel
-- Dirección Comercial: C/Jose Bardasano Baos, 9, Edif. Gorbea 3, planta 3ºD, 28016 Madrid, Spain Inscrita en el Reg. Mercantil de Madrid – C.I.F. B82657941 - Red Hat S.L.
participants (3)
-
Juan Hernandez -
Morrissey, Christopher -
Vojtech Szocs