7:15 p.m.
--_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(a)ovirt.org</a>&gt;<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.or...
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"&g...
ts.ovirt.org/mailman/listinfo/engine-devel</a><o:p></o:p&g... </div
</blockquote </div </body
</html
--_000_D290AD8432118048947689BA3AE8A9B3E47B82SACEXCMBX04PRDhqn_--
9:46 p.m.
New subject: [Engine-devel] UI Plugins: PoC patch revision 5 is here
------=_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(a)netapp.com>=20
To: vszocs(a)redhat.com=20
Cc: "George Costea" <George.Costea(a)netapp.com>, "Dustin
Schoenbrun" <Dustin=
.Schoenbrun(a)netapp.com>, engine-devel(a)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(a)redhat.com >=20
Date: September 21, 2012 4:37:31 PM EDT=20
To: engine-devel < engine-devel(a)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(a)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"
&lt;Christopher.Morrissey(a)netapp.com&gt;<b=
r><b>To: </b>vszocs(a)redhat.com<br><b>Cc: </b>"George
Costea" <George.Cos=
tea(a)netapp.com&gt;, "Dustin Schoenbrun"
&lt;Dustin.Schoenbrun(a)netapp.com&gt=
;, engine-devel(a)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/</...
</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(a)ovirt.org</a>&gt;<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</...
</div>
</blockquote>
</div>
</div><br></div></body></html>
------=_Part_3896354_1791016925.1349203611679--
10:15 p.m.
New subject: [Engine-devel] UI Plugins: PoC patch revision 5 is here
--_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_--
1:18 p.m.
New subject: [Engine-devel] UI Plugins: PoC patch revision 5 is here
------=_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(a)netapp.com>=20
To: "Vojtech Szocs" <vszocs(a)redhat.com>=20
Cc: "George Costea" <George.Costea(a)netapp.com>, "Dustin
Schoenbrun" <Dustin=
.Schoenbrun(a)netapp.com>, engine-devel(a)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(a)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
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(a)netapp.com>=20
To: vszocs(a)redhat.com=20
Cc: "George Costea" <George.Costea(a)netapp.com>, "Dustin
Schoenbrun" <Dustin=
.Schoenbrun(a)netapp.com>, engine-devel(a)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(a)redhat.com >=20
Date: September 21, 2012 4:37:31 PM EDT=20
To: engine-devel < engine-devel(a)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(a)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=
</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=
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(a)netapp.com&gt;<br><b>To: </b>"Vojtech Szocs"
&lt;vszocs(a)redhat.com&gt=
;<br><b>Cc: </b>"George Costea"
&lt;George.Costea(a)netapp.com&gt;, "Dustin S=
choenbrun" &lt;Dustin.Schoenbrun(a)netapp.com&gt;,
engine-devel(a)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(a)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...
511.html" target=3D"_blank">
http://lists.ovirt.org/pipermail/engine-devel/2012-September/002511.html&...
<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 =
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(a)redhat.com<br>
<b>Cc: </b>"George Costea" &lt;George.Costea(a)netapp.com&gt;,
"Dustin Schoen=
brun" &lt;Dustin.Schoenbrun(a)netapp.com&gt;, engine-devel(a)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(a)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(a)ovirt.org</a>&gt;<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</...
</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--
11:24 a.m.
New subject: [Engine-devel] UI Plugins: PoC patch revision 5 is here
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(a)netapp.com>
To: vszocs(a)redhat.com
Cc: "George Costea" <George.Costea(a)netapp.com>, "Dustin
Schoenbrun" <Dustin.Schoenbrun(a)netapp.com>, engine-devel(a)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(a)redhat.com >
Date: September 21, 2012 4:37:31 PM EDT
To: engine-devel < engine-devel(a)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(a)ovirt.org
http://lists.ovirt.org/mailman/listinfo/engine-devel
</blockquote>
_______________________________________________
Engine-devel mailing list
Engine-devel(a)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.
4429
days inactive
4430
days old
4 comments
3 participants
participants (3)
-
Juan Hernandez -
Morrissey, Christopher -
Vojtech Szocs