10:03 a.m.
Hi guys,
I wrote a wiki page describing UI Plugins, a feature planned for oVirt web administration
(WebAdmin) application:
http://www.ovirt.org/wiki/Features/UIPlugins
Feature design is finished and ready for review. Please feel free to add comments, ask
questions or reach me directly on #ovirt channel.
Cheers,
Vojtech
8:09 a.m.
Hi Vojtech,
I have a few questions on this feature.
1) Are the plugins hosted by the same jboss server that hosts the engine? It would appear
the answer is yes and that no separate container is required for the plugins.
2) Does each plugin map to a unique extension within WebAdmin? Your example shows that I
can extend the VM table to have a "Show VM name and edit VM" context-sensitive
extension. This is named pluginApi.plugins.myPlugin. Can I safely assume that this is
per extension? I would have pluginApi.plugins.myPlugin2 for extending a storage domain?
3) Instead of launching a jQuery dialog, can I point to a compiled GWT html file to
display a dialog that fits my needs?
4) Is session info passed into the plugin so that I can invoke APIs into the engine? To
power on a VM for instance? Or to mount a new NFS storage domain?
BTW, the link to the original design notes on the wiki doesn't work.
Thanks,
George
-----Original Message-----
From: Vojtech Szocs [mailto:vszocs@redhat.com]
Sent: Thursday, June 21, 2012 11:03 AM
To: engine-devel(a)ovirt.org
Cc: Schoenbrun, Dustin; Costea, George; Hopper, Ricky
Subject: oVirt UI Plugins feature: Ready for review
Hi guys,
I wrote a wiki page describing UI Plugins, a feature planned for oVirt web administration
(WebAdmin) application:
http://www.ovirt.org/wiki/Features/UIPlugins
Feature design is finished and ready for review. Please feel free to add comments, ask
questions or reach me directly on #ovirt channel.
Cheers,
Vojtech
12:11 p.m.
Hi George,
thanks for your feedback. Please find my answers below.
1) Are the plugins hosted by the same jboss server that hosts the
engine? It would appear the answer is yes and that no separate container is required for
the plugins.
In short, yes.
Plugins, along with their configuration and 3rd party dependencies, are meant to be
embedded into final WebAdmin HTML page, see
[http://www.ovirt.org/wiki/Features/UIPlugins#Plugin_lifecycle] step #5.
JBoss AS instance serves WebAdmin HTML page (WebadminDynamicHostingServlet), along with
providing GWT RPC and REST endpoints that delegate to Engine business logic through EJB
BackendLocal interface.
However, plugins are not 'hosted' in a typical sense -
WebadminDynamicHostingServlet reads and embeds all plugin data directly into final
WebAdmin HTML page.
2) Does each plugin map to a unique extension within WebAdmin? Your
example shows that I can extend the VM table to have a "Show VM name and edit
VM" context-sensitive extension. This is named pluginApi.plugins.myPlugin. Can I
safely assume that this is per extension? I would have pluginApi.plugins.myPlugin2 for
extending a storage domain?
Extension points are represented by application events, triggered by WebAdmin and consumed
by plugins. For example, 'tableContextMenu' event gets triggered when a table
context menu is about to be shown to the user, which gives plugins the ability to do
something custom with the context menu before it's shown.
There can be multiple plugins handling the same event (extension point). You can have two
plugins, say 'pluginApi.plugins.One' and 'pluginApi.plugins.Two', each
providing 'tableContextMenu' function for handling the above mentioned event.
WebAdmin will invoke all plugins for the given event.
To answer your question, in order to handle X events (extension points), you don't
need to write X plugins. You can write one plugin that handles X events.
3) Instead of launching a jQuery dialog, can I point to a compiled
GWT html file to display a dialog that fits my needs?
You can do anything you want in your plugin event handler function. Show a jQuery UI
dialog, make oVirt REST API request, call arbitrary remote server using cross-domain
technique like JSONP [1] or CORS [2], etc. Plugin authors are free to decide if they want
to rely on 3rd party JavaScript libraries, or if they want to write entire plugin code by
themselves.
In my opinion, tools like jQuery are far more elegant for handling simple things such as
UI dialogs. But if you really want to use GWT for this purpose, I suggest following
approach:
a, develop a 'plugin support application' in GWT, which implements the necessary
dialog functionality
b, export its main (e.g. dialog handling) classes for use in native JavaScript through
gwt-exporter [3]
c, have your oVirt UI plugin depend on your compiled 'plugin support application'
(this will cause your 'plugin support application' to be called during WebAdmin
startup)
d, in your oVirt UI plugin, invoke 'plugin support application' functionality
through exported classes (plugin -> GWT delegate pattern)
4) Is session info passed into the plugin so that I can invoke APIs
into the engine? To power on a VM for instance? Or to mount a new NFS storage domain?
Yes, this should be part of
[http://www.ovirt.org/wiki/Features/UIPlugins#Global_API_functions] "Plugin utility
functions" (global API).
Your plugin might access user session information in the following way:
pluginApi.util().userInfo().* (replace * with id(), name(), domain(), etc.)
As you pointed out, this could be used to authenticate oVirt REST API requests made from
your plugin code.
BTW, the link to the original design notes on the wiki doesn't
work.
This is strange, [http://rhevmf.pad.engineering.redhat.com/68] has its visibility set to
"Public (Allow Internet guests)" ... Does anybody know why this doesn't
work?
Vojtech
[1] http://en.wikipedia.org/wiki/JSONP
[2] http://en.wikipedia.org/wiki/Cross-origin_resource_sharing
[3] http://code.google.com/p/gwt-exporter/
----- Original Message -----
From: "George Costea" <George.Costea(a)netapp.com>
To: "Vojtech Szocs" <vszocs(a)redhat.com>, engine-devel(a)ovirt.org
Cc: "Dustin Schoenbrun" <Dustin.Schoenbrun(a)netapp.com>, "Ricky
Hopper" <Ricky.Hopper(a)netapp.com>
Sent: Monday, June 25, 2012 3:09:43 PM
Subject: RE: oVirt UI Plugins feature: Ready for review
Hi Vojtech,
I have a few questions on this feature.
1) Are the plugins hosted by the same jboss server that hosts the engine? It would appear
the answer is yes and that no separate container is required for the plugins.
2) Does each plugin map to a unique extension within WebAdmin? Your example shows that I
can extend the VM table to have a "Show VM name and edit VM" context-sensitive
extension. This is named pluginApi.plugins.myPlugin. Can I safely assume that this is
per extension? I would have pluginApi.plugins.myPlugin2 for extending a storage domain?
3) Instead of launching a jQuery dialog, can I point to a compiled GWT html file to
display a dialog that fits my needs?
4) Is session info passed into the plugin so that I can invoke APIs into the engine? To
power on a VM for instance? Or to mount a new NFS storage domain?
BTW, the link to the original design notes on the wiki doesn't work.
Thanks,
George
-----Original Message-----
From: Vojtech Szocs [mailto:vszocs@redhat.com]
Sent: Thursday, June 21, 2012 11:03 AM
To: engine-devel(a)ovirt.org
Cc: Schoenbrun, Dustin; Costea, George; Hopper, Ricky
Subject: oVirt UI Plugins feature: Ready for review
Hi guys,
I wrote a wiki page describing UI Plugins, a feature planned for oVirt web administration
(WebAdmin) application:
http://www.ovirt.org/wiki/Features/UIPlugins
Feature design is finished and ready for review. Please feel free to add comments, ask
questions or reach me directly on #ovirt channel.
Cheers,
Vojtech
2:11 p.m.
Thanks Vojtech.
Since the plugins are embedded into the WebAdmin HTML page, that seems to simplify things;
no external web service is needed. This approach ties into the issue over the freedom to
decide which technology to use when developing a plugin. While I agree that jQuery is
best for simple dialogs, a wizard-driven workflow is easier to develop in GWT.
For example, if I want to step a user through the process of creating a new storage domain
I would like to provide a workflow to select a storage array, provide credentials, and
configure the details of the NFS export. This workflow could presumably have a GWT-RPC
mechanism that relies on some additional libraries on the backend (libraries that allow me
to communicate with the storage array). Using the GWT-Exporter, I could export the
classes that would display the workflow which would then get launched as my extension is
selected. You said that I would have my oVirt UI plugin depend on my compiled 'plugin
support application'. My compiled plugin support application would normally be a war
file containing my compiled GWT code and a web-inf folder containing my libraries. Is the
plugin depending on the war file? Is that what I specify?
-George
-----Original Message-----
From: Vojtech Szocs [mailto:vszocs@redhat.com]
Sent: Monday, June 25, 2012 1:12 PM
To: Costea, George; engine-devel(a)ovirt.org
Cc: Schoenbrun, Dustin; Hopper, Ricky; Itamar Heim
Subject: Re: oVirt UI Plugins feature: Ready for review
Hi George,
thanks for your feedback. Please find my answers below.
1) Are the plugins hosted by the same jboss server that hosts the
engine? It would appear the answer is yes and that no separate container is required for
the plugins.
In short, yes.
Plugins, along with their configuration and 3rd party dependencies, are meant to be
embedded into final WebAdmin HTML page, see
[http://www.ovirt.org/wiki/Features/UIPlugins#Plugin_lifecycle] step #5.
JBoss AS instance serves WebAdmin HTML page (WebadminDynamicHostingServlet), along with
providing GWT RPC and REST endpoints that delegate to Engine business logic through EJB
BackendLocal interface.
However, plugins are not 'hosted' in a typical sense -
WebadminDynamicHostingServlet reads and embeds all plugin data directly into final
WebAdmin HTML page.
2) Does each plugin map to a unique extension within WebAdmin? Your
example shows that I can extend the VM table to have a "Show VM name and edit
VM" context-sensitive extension. This is named pluginApi.plugins.myPlugin. Can I
safely assume that this is per extension? I would have pluginApi.plugins.myPlugin2 for
extending a storage domain?
Extension points are represented by application events, triggered by WebAdmin and consumed
by plugins. For example, 'tableContextMenu' event gets triggered when a table
context menu is about to be shown to the user, which gives plugins the ability to do
something custom with the context menu before it's shown.
There can be multiple plugins handling the same event (extension point). You can have two
plugins, say 'pluginApi.plugins.One' and 'pluginApi.plugins.Two', each
providing 'tableContextMenu' function for handling the above mentioned event.
WebAdmin will invoke all plugins for the given event.
To answer your question, in order to handle X events (extension points), you don't
need to write X plugins. You can write one plugin that handles X events.
3) Instead of launching a jQuery dialog, can I point to a compiled
GWT html file to display a dialog that fits my needs?
You can do anything you want in your plugin event handler function. Show a jQuery UI
dialog, make oVirt REST API request, call arbitrary remote server using cross-domain
technique like JSONP [1] or CORS [2], etc. Plugin authors are free to decide if they want
to rely on 3rd party JavaScript libraries, or if they want to write entire plugin code by
themselves.
In my opinion, tools like jQuery are far more elegant for handling simple things such as
UI dialogs. But if you really want to use GWT for this purpose, I suggest following
approach:
a, develop a 'plugin support application' in GWT, which implements the necessary
dialog functionality b, export its main (e.g. dialog handling) classes for use in native
JavaScript through gwt-exporter [3] c, have your oVirt UI plugin depend on your compiled
'plugin support application' (this will cause your 'plugin support
application' to be called during WebAdmin startup) d, in your oVirt UI plugin, invoke
'plugin support application' functionality through exported classes (plugin ->
GWT delegate pattern)
4) Is session info passed into the plugin so that I can invoke APIs
into the engine? To power on a VM for instance? Or to mount a new NFS storage domain?
Yes, this should be part of
[http://www.ovirt.org/wiki/Features/UIPlugins#Global_API_functions] "Plugin utility
functions" (global API).
Your plugin might access user session information in the following way:
pluginApi.util().userInfo().* (replace * with id(), name(), domain(), etc.)
As you pointed out, this could be used to authenticate oVirt REST API requests made from
your plugin code.
BTW, the link to the original design notes on the wiki doesn't
work.
This is strange, [http://rhevmf.pad.engineering.redhat.com/68] has its visibility set to
"Public (Allow Internet guests)" ... Does anybody know why this doesn't
work?
Vojtech
[1] http://en.wikipedia.org/wiki/JSONP
[2] http://en.wikipedia.org/wiki/Cross-origin_resource_sharing
[3] http://code.google.com/p/gwt-exporter/
----- Original Message -----
From: "George Costea" <George.Costea(a)netapp.com>
To: "Vojtech Szocs" <vszocs(a)redhat.com>, engine-devel(a)ovirt.org
Cc: "Dustin Schoenbrun" <Dustin.Schoenbrun(a)netapp.com>, "Ricky
Hopper" <Ricky.Hopper(a)netapp.com>
Sent: Monday, June 25, 2012 3:09:43 PM
Subject: RE: oVirt UI Plugins feature: Ready for review
Hi Vojtech,
I have a few questions on this feature.
1) Are the plugins hosted by the same jboss server that hosts the engine? It would appear
the answer is yes and that no separate container is required for the plugins.
2) Does each plugin map to a unique extension within WebAdmin? Your example shows that I
can extend the VM table to have a "Show VM name and edit VM" context-sensitive
extension. This is named pluginApi.plugins.myPlugin. Can I safely assume that this is
per extension? I would have pluginApi.plugins.myPlugin2 for extending a storage domain?
3) Instead of launching a jQuery dialog, can I point to a compiled GWT html file to
display a dialog that fits my needs?
4) Is session info passed into the plugin so that I can invoke APIs into the engine? To
power on a VM for instance? Or to mount a new NFS storage domain?
BTW, the link to the original design notes on the wiki doesn't work.
Thanks,
George
-----Original Message-----
From: Vojtech Szocs [mailto:vszocs@redhat.com]
Sent: Thursday, June 21, 2012 11:03 AM
To: engine-devel(a)ovirt.org
Cc: Schoenbrun, Dustin; Costea, George; Hopper, Ricky
Subject: oVirt UI Plugins feature: Ready for review
Hi guys,
I wrote a wiki page describing UI Plugins, a feature planned for oVirt web administration
(WebAdmin) application:
http://www.ovirt.org/wiki/Features/UIPlugins
Feature design is finished and ready for review. Please feel free to add comments, ask
questions or reach me directly on #ovirt channel.
Cheers,
Vojtech
9:44 a.m.
--=_8c1ef5c2-c775-4be9-be4e-f09c4448d600
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit
Hi George,
I've been thinking about developing plugins with GWT. There are some important issues
that need to be addressed:
1. GWT bootstrap sequence requires permutation selector script (
<pluginApplication>.nocache.js ) to be invoked first. Selector script determines the
correct permutation ( <hashName>.cache.html ) and fetches it asynchronously from the
same location.
2. GWT bootstrap sequence is asynchronous in nature.
3. GWT RPC ( XMLHttpRequest ) is subject to Same Origin Policy [1]. This means that
pluginApplication 's server-side code should be deployed on oVirt JBoss AS instance
(next to engine.ear ).
Given these limitations, I'd say the process could be like this:
a) In pluginApplication 's EntryPoint , use GWT JSNI [2] to register the plugin using
native JavaScript code.
You don't need to use gwt-exporter here, since plugin registration and logic is
combined in one place.
Using plugin-to-GWT delegate pattern with gwt-exporter is actually more complicated than
going with plain JSNI.
For example:
package com.myplugin;
public class MyPluginApp implements com.google.gwt.core.client.EntryPoint {
public void void onModuleLoad() {
// Initialize plugin application, call registerPlugin() when ready
registerPlugin();
}
public static void tableContextMenu(com.google.gwt.core.client.JavaScriptObject
eventContext) {
// Consider using GWT overlay types [3] to easily work with JavaScriptObjects
}
private static native void registerPlugin() /*-{
// Register 'myPlugin' into pluginApi.plugins object
$wnd.pluginApi.plugins.myPlugin = myPlugin = {
tableContextMenu: function(eventContext) {
// Call Java static method to handle this event
@com.myplugin.MyPluginApp::tableContextMenu(Lcom/google/gwt/core/client/JavaScriptObject;)(eventContext);
}
};
// Call the ready() function right away
$wnd.pluginApi.lifecycle(myPlugin).ready();
}-*/;
}
b) Deploy the <pluginApplication>.war file on JBoss AS instance, e.g.
<JBOSS_HOME>/standalone/deployments .
This makes pluginApplication 's GWT RPC servlet(s) accessible from the same origin
(protocol, domain, port).
c) Modification of plugin lifecycle step #5:
Instead of embedding <pluginApplication>.nocache.js content into WebAdmin HTML page,
just embed the link to it, e.g.
http(s)://127.0.0.1:<port>/path/to/<pluginApplication>.nocache.js
d) Modification of plugin lifecycle step #6:
During WebAdmin startup, for each plugin that is supposed to be loaded remotely, create an
<iframe> that will fetch the plugin asynchronously.
The <iframe> is required in order for <pluginApplication>.nocache.js to appear
from different ( pluginApplication -specific ) domain than WebAdmin HTML page.
This way, fetching permutation ( <hashName>.cache.html ) files, which are relative
to <pluginApplication>.nocache.js , will work out-of-the-box.
George, please let me know what you think, and I will update UI Plugins wiki accordingly.
Vojtech
[1] http://en.wikipedia.org/wiki/Same_origin_policy
[2] https://developers.google.com/web-toolkit/doc/latest/DevGuideCodingBasics...
[3] https://developers.google.com/web-toolkit/doc/latest/DevGuideCodingBasics...
----- Original Message -----
From: "George Costea" <George.Costea(a)netapp.com>
To: "Vojtech Szocs" <vszocs(a)redhat.com>, engine-devel(a)ovirt.org
Cc: "Dustin Schoenbrun" <Dustin.Schoenbrun(a)netapp.com>, "Ricky
Hopper" <Ricky.Hopper(a)netapp.com>, "Itamar Heim"
<iheim(a)redhat.com>
Sent: Monday, June 25, 2012 9:11:33 PM
Subject: RE: oVirt UI Plugins feature: Ready for review
Thanks Vojtech.
Since the plugins are embedded into the WebAdmin HTML page, that seems to simplify things;
no external web service is needed. This approach ties into the issue over the freedom to
decide which technology to use when developing a plugin. While I agree that jQuery is best
for simple dialogs, a wizard-driven workflow is easier to develop in GWT.
For example, if I want to step a user through the process of creating a new storage domain
I would like to provide a workflow to select a storage array, provide credentials, and
configure the details of the NFS export. This workflow could presumably have a GWT-RPC
mechanism that relies on some additional libraries on the backend (libraries that allow me
to communicate with the storage array). Using the GWT-Exporter, I could export the classes
that would display the workflow which would then get launched as my extension is selected.
You said that I would have my oVirt UI plugin depend on my compiled 'plugin support
application'. My compiled plugin support application would normally be a war file
containing my compiled GWT code and a web-inf folder containing my libraries. Is the
plugin depending on the war file? Is that what I specify?
-George
-----Original Message-----
From: Vojtech Szocs [mailto:vszocs@redhat.com]
Sent: Monday, June 25, 2012 1:12 PM
To: Costea, George; engine-devel(a)ovirt.org
Cc: Schoenbrun, Dustin; Hopper, Ricky; Itamar Heim
Subject: Re: oVirt UI Plugins feature: Ready for review
Hi George,
thanks for your feedback. Please find my answers below.
1) Are the plugins hosted by the same jboss server that hosts the engine? It would appear
the answer is yes and that no separate container is required for the plugins.
In short, yes.
Plugins, along with their configuration and 3rd party dependencies, are meant to be
embedded into final WebAdmin HTML page, see
[http://www.ovirt.org/wiki/Features/UIPlugins#Plugin_lifecycle] step #5.
JBoss AS instance serves WebAdmin HTML page (WebadminDynamicHostingServlet), along with
providing GWT RPC and REST endpoints that delegate to Engine business logic through EJB
BackendLocal interface.
However, plugins are not 'hosted' in a typical sense -
WebadminDynamicHostingServlet reads and embeds all plugin data directly into final
WebAdmin HTML page.
<blockquote>
2) Does each plugin map to a unique extension within WebAdmin? Your example shows that I
can extend the VM table to have a "Show VM name and edit VM" context-sensitive
extension. This is named pluginApi.plugins.myPlugin. Can I safely assume that this is per
extension? I would have pluginApi.plugins.myPlugin2 for extending a storage domain?
Extension points are represented by application events, triggered by WebAdmin and consumed
by plugins. For example, 'tableContextMenu' event gets triggered when a table
context menu is about to be shown to the user, which gives plugins the ability to do
something custom with the context menu before it's shown.
</blockquote>
There can be multiple plugins handling the same event (extension point). You can have two
plugins, say 'pluginApi.plugins.One' and 'pluginApi.plugins.Two', each
providing 'tableContextMenu' function for handling the above mentioned event.
WebAdmin will invoke all plugins for the given event.
To answer your question, in order to handle X events (extension points), you don't
need to write X plugins. You can write one plugin that handles X events.
<blockquote>
3) Instead of launching a jQuery dialog, can I point to a compiled GWT html file to
display a dialog that fits my needs?
You can do anything you want in your plugin event handler function. Show a jQuery UI
dialog, make oVirt REST API request, call arbitrary remote server using cross-domain
technique like JSONP [1] or CORS [2], etc. Plugin authors are free to decide if they want
to rely on 3rd party JavaScript libraries, or if they want to write entire plugin code by
themselves.
</blockquote>
In my opinion, tools like jQuery are far more elegant for handling simple things such as
UI dialogs. But if you really want to use GWT for this purpose, I suggest following
approach:
a, develop a 'plugin support application' in GWT, which implements the necessary
dialog functionality b, export its main (e.g. dialog handling) classes for use in native
JavaScript through gwt-exporter [3] c, have your oVirt UI plugin depend on your compiled
'plugin support application' (this will cause your 'plugin support
application' to be called during WebAdmin startup) d, in your oVirt UI plugin, invoke
'plugin support application' functionality through exported classes (plugin ->
GWT delegate pattern)
<blockquote>
4) Is session info passed into the plugin so that I can invoke APIs into the engine? To
power on a VM for instance? Or to mount a new NFS storage domain?
Yes, this should be part of
[http://www.ovirt.org/wiki/Features/UIPlugins#Global_API_functions] "Plugin utility
functions" (global API).
</blockquote>
Your plugin might access user session information in the following way:
pluginApi.util().userInfo().* (replace * with id(), name(), domain(), etc.)
As you pointed out, this could be used to authenticate oVirt REST API requests made from
your plugin code.
<blockquote>
BTW, the link to the original design notes on the wiki doesn't work.
This is strange, [http://rhevmf.pad.engineering.redhat.com/68] has its visibility set to
"Public (Allow Internet guests)" ... Does anybody know why this doesn't
work?
</blockquote>
Vojtech
[1] http://en.wikipedia.org/wiki/JSONP
[2] http://en.wikipedia.org/wiki/Cross-origin_resource_sharing
[3] http://code.google.com/p/gwt-exporter/
----- Original Message -----
From: "George Costea" <George.Costea(a)netapp.com>
To: "Vojtech Szocs" <vszocs(a)redhat.com>, engine-devel(a)ovirt.org
Cc: "Dustin Schoenbrun" <Dustin.Schoenbrun(a)netapp.com>, "Ricky
Hopper" <Ricky.Hopper(a)netapp.com>
Sent: Monday, June 25, 2012 3:09:43 PM
Subject: RE: oVirt UI Plugins feature: Ready for review
Hi Vojtech,
I have a few questions on this feature.
1) Are the plugins hosted by the same jboss server that hosts the engine? It would appear
the answer is yes and that no separate container is required for the plugins.
2) Does each plugin map to a unique extension within WebAdmin? Your example shows that I
can extend the VM table to have a "Show VM name and edit VM" context-sensitive
extension. This is named pluginApi.plugins.myPlugin. Can I safely assume that this is per
extension? I would have pluginApi.plugins.myPlugin2 for extending a storage domain?
3) Instead of launching a jQuery dialog, can I point to a compiled GWT html file to
display a dialog that fits my needs?
4) Is session info passed into the plugin so that I can invoke APIs into the engine? To
power on a VM for instance? Or to mount a new NFS storage domain?
BTW, the link to the original design notes on the wiki doesn't work.
Thanks,
George
-----Original Message-----
From: Vojtech Szocs [mailto:vszocs@redhat.com]
Sent: Thursday, June 21, 2012 11:03 AM
To: engine-devel(a)ovirt.org
Cc: Schoenbrun, Dustin; Costea, George; Hopper, Ricky
Subject: oVirt UI Plugins feature: Ready for review
Hi guys,
I wrote a wiki page describing UI Plugins, a feature planned for oVirt web administration
(WebAdmin) application:
http://www.ovirt.org/wiki/Features/UIPlugins
Feature design is finished and ready for review. Please feel free to add comments, ask
questions or reach me directly on #ovirt channel.
Cheers,
Vojtech
--=_8c1ef5c2-c775-4be9-be4e-f09c4448d600
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; font-size: 12pt; color: #000000'=
<font size=3D"4">Hi
George,<br><br>I've been thinking about developing plu=
gins with
GWT. There are some important issues that need to be addressed:<b=
r></font><ol><li><font size=3D"4">GWT bootstrap
sequence requires <em>permu=
tation selector script</em> (<font size=3D"3"><span
style=3D"font-family: l=
ucida
console,sans-serif;"><pluginApplication>.nocache.js</span></fon=
t>) to be invoked first.<br>Selector script determines the correct permutat=
ion (<font style=3D"font-family: lucida console,sans-serif;"
size=3D"3"><=
;hashName>.cache.html</font>) and fetches it asynchronously from the sam=
e location.<br><br></font></li><li><font
size=3D"4">GWT bootstrap sequence =
is asynchronous in nature.<br><br></font></li><li><font
size=3D"4">GWT RPC =
(<font style=3D"font-family: lucida console,sans-serif;"
size=3D"3">XMLHttp=
Request</font>) is subject to Same Origin Policy [1].<br>This means that
<s=
pan style=3D"font-style: italic;">pluginApplication</span>'s
server-side co=
de should be deployed on oVirt JBoss AS instance (next to <font style=3D"fo=
nt-family: lucida console,sans-serif;"
size=3D"3">engine.ear</font>).<br></=
font></li></ol><font size=3D"4"><br>Given these
limitations, I'd say the pr=
ocess could be like this:<br><br>a) In <span style=3D"font-style:
italic;">=
pluginApplication</span>'s <font style=3D"font-family: lucida
console,sans-=
serif;" size=3D"3">EntryPoint</font>, use GWT JSNI [2] to register
the plug=
in using native JavaScript code.<br><br> You don't
need to use =
<span style=3D"font-style: italic;">gwt-exporter</span> here, since
plugin =
registration and logic is combined in one place.<br> Using
plug=
in-to-GWT delegate pattern with <span style=3D"font-style:
italic;">gwt-exp=
orter</span> is actually more complicated than going with plain
JSNI.<br><b=
r> For example:<br><br><font
style=3D"font-family: lucida conso=
le,sans-serif;" size=3D"3"> package
com.myplugin;<br><br> =
public class MyPluginApp implements com.google.gwt.core.client.Entry=
Point {<br><br> public void void
onModuleLoad() {<=
br> // Initialize plugin
application, call=
registerPlugin() when ready<br>
registerP=
lugin();<br>
}<br><br> pu=
blic static void tableContextMenu(com.google.gwt.core.client.JavaScriptObje=
ct eventContext) {<br> //
Consider using G=
WT overlay types [3] to easily work with JavaScriptObjects<br>
=
}<br><br>
private static native void =
registerPlugin() /*-{<br> //
Register 'myP=
lugin' into pluginApi.plugins object<br>
$=
wnd.pluginApi.plugins.myPlugin =3D myPlugin =3D {<br>
&n=
bsp; tableContextMenu: function(eventContext)
{<br>&nbs=
p; // Call
Java static meth=
od to handle this event<br>
=
@com.myplugin.MyPluginApp::tableContextMenu(Lcom/google/gwt/core/cli=
ent/JavaScriptObject;)(eventContext);<br>
=
}<br>
};<br> &nbs=
p; // Call the ready() function right
away<br> &n=
bsp;
$wnd.pluginApi.lifecycle(myPlugin).ready();<br> &nb=
sp; }-*/;<br><br>
}</font><br><br>b) Deploy the <f=
ont style=3D"font-family: lucida console,sans-serif;"
size=3D"3"><plugin=
Application>.war</font> file on JBoss AS instance, e.g. <font
style=3D"f=
ont-family: lucida console,sans-serif;"
size=3D"3"><JBOSS_HOME>/stand=
alone/deployments</font>.<br><br> This makes
<span style=3D"fon=
t-style: italic;">pluginApplication</span>'s GWT RPC servlet(s)
accessible =
from the same origin (protocol, domain, port).<br><br>c) Modification of pl=
ugin lifecycle step #5:<br><br> Instead of embedding
<font styl=
e=3D"font-family: lucida console,sans-serif;"
size=3D"3"><pluginApplicat=
ion>.nocache.js</font> content into WebAdmin HTML page, just embed the l=
ink to it, e.g. <font style=3D"font-family: lucida console,sans-serif;" siz=
e=3D"3">http(s)://127.0.0.1:<port>/path/to/<pluginApplication>.=
nocache.js</font><br><br>d) Modification of plugin lifecycle step
#6:<br><b=
r> During WebAdmin startup, for each plugin that is supposed to=
be loaded remotely, create an <font size=3D"3"><span
style=3D"font-family:=
lucida console,sans-serif;"><iframe></span></font> that
will fetch t=
he plugin asynchronously.<br><br> The <font
style=3D"font-famil=
y: lucida console,sans-serif;"
size=3D"3"><iframe></font> is required=
in order for <font size=3D"3"><span style=3D"font-family: lucida
console,s=
ans-serif;"><pluginApplication>.nocache.js</span></font>
to appear fr=
om different (</font><font size=3D"4"><span
style=3D"font-style: italic;">p=
luginApplication</span>-specific</font><font size=3D"4">)
domain than WebAd=
min HTML page.<br><br> This way, fetching permutation
(<font st=
yle=3D"font-family: lucida console,sans-serif;"
size=3D"3"><hashName>=
.cache.html</font>) files, which are relative to <font
style=3D"font-family=
: lucida console,sans-serif;"
size=3D"3"><pluginApplication>.nocache.=
js</font>, will work out-of-the-box.<br><br><br>George, please let
me know =
what you think, and I will update UI Plugins wiki accordingly.<br><br>Vojte=
ch<br><br><br>[1]
http://en.wikipedia.org/wiki/Same_origin_policy<br>[2] ht=
tps://developers.google.com/web-toolkit/doc/latest/DevGuideCodingBasicsJSNI=
<br>[3] https://developers.google.com/web-toolkit/doc/latest/DevGuideCoding=
BasicsOverlay<br><br></font><br><hr
id=3D"zwchr"><br>From: "George Costea" =
&lt;George.Costea(a)netapp.com&gt;<br>To: "Vojtech Szocs"
&lt;vszocs(a)redhat.c=
om>, engine-devel(a)ovirt.org<br>Cc: "Dustin Schoenbrun"
<Dustin.Schoen=
brun(a)netapp.com&gt;, "Ricky Hopper" &lt;Ricky.Hopper(a)netapp.com&gt;,
"Itama=
r Heim" &lt;iheim(a)redhat.com&gt;<br>Sent: Monday, June 25, 2012 9:11:33
PM<=
br>Subject: RE: oVirt UI Plugins feature: Ready for review<br><br>Thanks
Vo=
jtech.<br><br>Since the plugins are embedded into the WebAdmin HTML page, t=
hat seems to simplify things; no external web service is needed. This=
approach ties into the issue over the freedom to decide which technology t=
o use when developing a plugin. While I agree that jQuery is best for=
simple dialogs, a wizard-driven workflow is easier to develop in GWT. &nbs=
p;<br><br>For example, if I want to step a user through the process of crea=
ting a new storage domain I would like to provide a workflow to select a st=
orage array, provide credentials, and configure the details of the NFS expo=
rt. This workflow could presumably have a GWT-RPC mechanism that reli=
es on some additional libraries on the backend (libraries that allow me to =
communicate with the storage array). Using the GWT-Exporter, I could =
export the classes that would display the workflow which would then get lau=
nched as my extension is selected. You said that I would have my oVir=
t UI plugin depend on my compiled 'plugin support application'. My co=
mpiled plugin support application would normally be a war file containing m=
y compiled GWT code and a web-inf folder containing my libraries. Is =
the plugin depending on the war file? Is that what I
specify?<br><br>=
-George<br><br>-----Original Message-----<br>From: Vojtech Szocs
[mailto:vs=
zocs(a)redhat.com] <br>Sent: Monday, June 25, 2012 1:12 PM<br>To: Costea, Geo=
rge; engine-devel(a)ovirt.org<br>Cc: Schoenbrun, Dustin; Hopper, Ricky; Itama=
r Heim<br>Subject: Re: oVirt UI Plugins feature: Ready for
review<br><br>Hi=
George,<br><br>thanks for your feedback. Please find my answers
below.<br>=
<br><br><blockquote> 1) Are the plugins hosted by the same jboss server
tha=
t hosts the engine? It would appear the answer is yes and that no sep=
arate container is required for the plugins.<br><br>In short,
yes.</blockqu=
ote><br><br>Plugins, along with their configuration and 3rd party
dependenc=
ies, are meant to be embedded into final WebAdmin HTML page, see [http://ww=
w.ovirt.org/wiki/Features/UIPlugins#Plugin_lifecycle] step #5. <br>JBoss AS=
instance serves WebAdmin HTML page (WebadminDynamicHostingServlet), along =
with providing GWT RPC and REST endpoints that delegate to Engine business =
logic through EJB BackendLocal interface.<br><br>However, plugins are not
'=
hosted' in a typical sense - WebadminDynamicHostingServlet reads and embeds=
all plugin data directly into final WebAdmin HTML
page.<br><br><br><blockq=
uote> 2) Does each plugin map to a unique extension within WebAdmin? =
Your example shows that I can extend the VM table to have a "Show VM name a=
nd edit VM" context-sensitive extension. This is named pluginApi.plug=
ins.myPlugin. Can I safely assume that this is per extension? I=
would have pluginApi.plugins.myPlugin2 for extending a storage domain?<br>=
<br>Extension points are represented by application events, triggered by We=
bAdmin and consumed by plugins. For example, 'tableContextMenu' event gets =
triggered when a table context menu is about to be shown to the user, which=
gives plugins the ability to do something custom with the context menu bef=
ore it's shown.</blockquote><br><br>There can be multiple plugins
handling =
the same event (extension point). You can have two plugins, say 'pluginApi.=
plugins.One' and 'pluginApi.plugins.Two', each providing
'tableContextMenu'=
function for handling the above mentioned event. WebAdmin will invoke all =
plugins for the given event.<br><br>To answer your question, in order to ha=
ndle X events (extension points), you don't need to write X plugins. You ca=
n write one plugin that handles X events.<br><br><br><blockquote>
3) Instea=
d of launching a jQuery dialog, can I point to a compiled GWT html file to =
display a dialog that fits my needs?<br><br>You can do anything you want in=
your plugin event handler function. Show a jQuery UI dialog, make oVirt RE=
ST API request, call arbitrary remote server using cross-domain technique l=
ike JSONP [1] or CORS [2], etc. Plugin authors are free to decide if they w=
ant to rely on 3rd party JavaScript libraries, or if they want to write ent=
ire plugin code by themselves.</blockquote><br><br>In my opinion, tools
lik=
e jQuery are far more elegant for handling simple things such as UI dialogs=
. But if you really want to use GWT for this purpose, I suggest following a=
pproach:<br><br>a, develop a 'plugin support application' in GWT,
which imp=
lements the necessary dialog functionality b, export its main (e.g. dialog =
handling) classes for use in native JavaScript through gwt-exporter [3] c, =
have your oVirt UI plugin depend on your compiled 'plugin support applicati=
on' (this will cause your 'plugin support application' to be called during =
WebAdmin startup) d, in your oVirt UI plugin, invoke 'plugin support applic=
ation' functionality through exported classes (plugin -> GWT delegate pa=
ttern)<br><br><br><blockquote> 4) Is session info passed into the
plugin so=
that I can invoke APIs into the engine? To power on a VM for instanc=
e? Or to mount a new NFS storage domain?<br><br>Yes, this should be
p=
art of [http://www.ovirt.org/wiki/Features/UIPlugins#Global_API_functions] =
"Plugin utility functions" (global
API).</blockquote><br><br>Your plugin mi=
ght access user session information in the following way: pluginApi.util().=
userInfo().* (replace * with id(), name(), domain(), etc.)<br><br>As you po=
inted out, this could be used to authenticate oVirt REST API requests made =
from your plugin code.<br><br><br><blockquote> BTW, the link to
the origina=
l design notes on the wiki doesn't work.<br><br>This is strange,
[http://rh=
evmf.pad.engineering.redhat.com/68] has its visibility set to "Public (Allo=
w Internet guests)" ... Does anybody know why this doesn't work?</blockquot=
e><br><br><br>Vojtech<br><br><br>[1]
http://en.wikipedia.org/wiki/JSONP<br>=
[2] http://en.wikipedia.org/wiki/Cross-origin_resource_sharing<br>[3] http:=
//code.google.com/p/gwt-exporter/<br><br><br>----- Original Message
-----<b=
r>From: "George Costea" &lt;George.Costea(a)netapp.com&gt;<br>To:
"Vojtech Sz=
ocs" &lt;vszocs(a)redhat.com&gt;, engine-devel(a)ovirt.org<br>Cc:
"Dustin Schoe=
nbrun" &lt;Dustin.Schoenbrun(a)netapp.com&gt;, "Ricky Hopper"
<Ricky.Hoppe=
r(a)netapp.com&gt;<br>Sent: Monday, June 25, 2012 3:09:43 PM<br>Subject: RE:
=
oVirt UI Plugins feature: Ready for review<br><br>Hi
Vojtech,<br><br>I have=
a few questions on this feature.<br><br>1) Are the plugins hosted by the s=
ame jboss server that hosts the engine? It would appear the answer is=
yes and that no separate container is required for the plugins.<br>2) Does=
each plugin map to a unique extension within WebAdmin? Your example =
shows that I can extend the VM table to have a "Show VM name and edit VM" c=
ontext-sensitive extension. This is named pluginApi.plugins.myPlugin.=
Can I safely assume that this is per extension? I would have p=
luginApi.plugins.myPlugin2 for extending a storage domain?<br>3) Instead of=
launching a jQuery dialog, can I point to a compiled GWT html file to disp=
lay a dialog that fits my needs?<br>4) Is session info passed into the plug=
in so that I can invoke APIs into the engine? To power on a VM for in=
stance? Or to mount a new NFS storage domain?<br><br>BTW, the link
to=
the original design notes on the wiki doesn't
work.<br><br>Thanks,<br>Geor=
ge<br><br>-----Original Message-----<br>From: Vojtech Szocs
[mailto:vszocs@=
redhat.com]<br>Sent: Thursday, June 21, 2012 11:03 AM<br>To: engine-devel@o=
virt.org<br>Cc: Schoenbrun, Dustin; Costea, George; Hopper, Ricky<br>Subjec=
t: oVirt UI Plugins feature: Ready for review<br><br>Hi
guys,<br><br>I wrot=
e a wiki page describing UI Plugins, a feature planned for oVirt web admini=
stration (WebAdmin) application:<br>http://www.ovirt.org/wiki/Features/UIPl=
ugins<br><br>Feature design is finished and ready for review. Please feel f=
ree to add comments, ask questions or reach me directly on #ovirt channel.<=
br><br>Cheers,<br>Vojtech<br></div></body></html>
--=_8c1ef5c2-c775-4be9-be4e-f09c4448d600--
3:39 p.m.
--_000_6C8AC8C50E170C4E9B44D47B39B24A48012080BASACEXCMBX04PRDh_
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: base64
VGhpcyBzb3VuZHMgZ3JlYXQuICBUaGFua3MgVm9qdGVjaC4NCg0KRnJvbTogVm9qdGVjaCBTem9j
cyBbbWFpbHRvOnZzem9jc0ByZWRoYXQuY29tXQ0KU2VudDogVHVlc2RheSwgSnVuZSAyNiwgMjAx
MiAxMDo0NCBBTQ0KVG86IGVuZ2luZS1kZXZlbEBvdmlydC5vcmcNCkNjOiBDb3N0ZWEsIEdlb3Jn
ZTsgU2Nob2VuYnJ1biwgRHVzdGluOyBIb3BwZXIsIFJpY2t5OyBJdGFtYXIgSGVpbQ0KU3ViamVj
dDogUmU6IG9WaXJ0IFVJIFBsdWdpbnMgZmVhdHVyZTogUmVhZHkgZm9yIHJldmlldw0KDQpIaSBH
ZW9yZ2UsDQoNCkkndmUgYmVlbiB0aGlua2luZyBhYm91dCBkZXZlbG9waW5nIHBsdWdpbnMgd2l0
aCBHV1QuIFRoZXJlIGFyZSBzb21lIGltcG9ydGFudCBpc3N1ZXMgdGhhdCBuZWVkIHRvIGJlIGFk
ZHJlc3NlZDoNCg0KICAxLiAgR1dUIGJvb3RzdHJhcCBzZXF1ZW5jZSByZXF1aXJlcyBwZXJtdXRh
dGlvbiBzZWxlY3RvciBzY3JpcHQgKDxwbHVnaW5BcHBsaWNhdGlvbj4ubm9jYWNoZS5qcykgdG8g
YmUgaW52b2tlZCBmaXJzdC4NClNlbGVjdG9yIHNjcmlwdCBkZXRlcm1pbmVzIHRoZSBjb3JyZWN0
IHBlcm11dGF0aW9uICg8aGFzaE5hbWU+LmNhY2hlLmh0bWwpIGFuZCBmZXRjaGVzIGl0IGFzeW5j
aHJvbm91c2x5IGZyb20gdGhlIHNhbWUgbG9jYXRpb24uDQogIDIuICBHV1QgYm9vdHN0cmFwIHNl
cXVlbmNlIGlzIGFzeW5jaHJvbm91cyBpbiBuYXR1cmUuDQogIDMuICBHV1QgUlBDIChYTUxIdHRw
UmVxdWVzdCkgaXMgc3ViamVjdCB0byBTYW1lIE9yaWdpbiBQb2xpY3kgWzFdLg0KVGhpcyBtZWFu
cyB0aGF0IHBsdWdpbkFwcGxpY2F0aW9uJ3Mgc2VydmVyLXNpZGUgY29kZSBzaG91bGQgYmUgZGVw
bG95ZWQgb24gb1ZpcnQgSkJvc3MgQVMgaW5zdGFuY2UgKG5leHQgdG8gZW5naW5lLmVhcikuDQoN
CkdpdmVuIHRoZXNlIGxpbWl0YXRpb25zLCBJJ2Qgc2F5IHRoZSBwcm9jZXNzIGNvdWxkIGJlIGxp
a2UgdGhpczoNCg0KYSkgSW4gcGx1Z2luQXBwbGljYXRpb24ncyBFbnRyeVBvaW50LCB1c2UgR1dU
IEpTTkkgWzJdIHRvIHJlZ2lzdGVyIHRoZSBwbHVnaW4gdXNpbmcgbmF0aXZlIEphdmFTY3JpcHQg
Y29kZS4NCg0KICAgWW91IGRvbid0IG5lZWQgdG8gdXNlIGd3dC1leHBvcnRlciBoZXJlLCBzaW5j
ZSBwbHVnaW4gcmVnaXN0cmF0aW9uIGFuZCBsb2dpYyBpcyBjb21iaW5lZCBpbiBvbmUgcGxhY2Uu
DQogICBVc2luZyBwbHVnaW4tdG8tR1dUIGRlbGVnYXRlIHBhdHRlcm4gd2l0aCBnd3QtZXhwb3J0
ZXIgaXMgYWN0dWFsbHkgbW9yZSBjb21wbGljYXRlZCB0aGFuIGdvaW5nIHdpdGggcGxhaW4gSlNO
SS4NCg0KICAgRm9yIGV4YW1wbGU6DQoNCiAgIHBhY2thZ2UgY29tLm15cGx1Z2luOw0KDQogICBw
dWJsaWMgY2xhc3MgTXlQbHVnaW5BcHAgaW1wbGVtZW50cyBjb20uZ29vZ2xlLmd3dC5jb3JlLmNs
aWVudC5FbnRyeVBvaW50IHsNCg0KICAgICAgcHVibGljIHZvaWQgdm9pZCBvbk1vZHVsZUxvYWQo
KSB7DQogICAgICAgICAvLyBJbml0aWFsaXplIHBsdWdpbiBhcHBsaWNhdGlvbiwgY2FsbCByZWdp
c3RlclBsdWdpbigpIHdoZW4gcmVhZHkNCiAgICAgICAgIHJlZ2lzdGVyUGx1Z2luKCk7DQogICAg
ICB9DQoNCiAgICAgIHB1YmxpYyBzdGF0aWMgdm9pZCB0YWJsZUNvbnRleHRNZW51KGNvbS5nb29n
bGUuZ3d0LmNvcmUuY2xpZW50LkphdmFTY3JpcHRPYmplY3QgZXZlbnRDb250ZXh0KSB7DQogICAg
ICAgICAvLyBDb25zaWRlciB1c2luZyBHV1Qgb3ZlcmxheSB0eXBlcyBbM10gdG8gZWFzaWx5IHdv
cmsgd2l0aCBKYXZhU2NyaXB0T2JqZWN0cw0KICAgICAgfQ0KDQogICAgICBwcml2YXRlIHN0YXRp
YyBuYXRpdmUgdm9pZCByZWdpc3RlclBsdWdpbigpIC8qLXsNCiAgICAgICAgIC8vIFJlZ2lzdGVy
ICdteVBsdWdpbicgaW50byBwbHVnaW5BcGkucGx1Z2lucyBvYmplY3QNCiAgICAgICAgICR3bmQu
cGx1Z2luQXBpLnBsdWdpbnMubXlQbHVnaW4gPSBteVBsdWdpbiA9IHsNCiAgICAgICAgICAgIHRh
YmxlQ29udGV4dE1lbnU6IGZ1bmN0aW9uKGV2ZW50Q29udGV4dCkgew0KICAgICAgICAgICAgICAg
Ly8gQ2FsbCBKYXZhIHN0YXRpYyBtZXRob2QgdG8gaGFuZGxlIHRoaXMgZXZlbnQNCiAgICAgICAg
ICAgICAgIEBjb20ubXlwbHVnaW4uTXlQbHVnaW5BcHA6OnRhYmxlQ29udGV4dE1lbnUoTGNvbS9n
b29nbGUvZ3d0L2NvcmUvY2xpZW50L0phdmFTY3JpcHRPYmplY3Q7KShldmVudENvbnRleHQpOw0K
ICAgICAgICAgICAgfQ0KICAgICAgICAgfTsNCiAgICAgICAgIC8vIENhbGwgdGhlIHJlYWR5KCkg
ZnVuY3Rpb24gcmlnaHQgYXdheQ0KICAgICAgICAgJHduZC5wbHVnaW5BcGkubGlmZWN5Y2xlKG15
UGx1Z2luKS5yZWFkeSgpOw0KICAgICAgfS0qLzsNCg0KICAgfQ0KDQpiKSBEZXBsb3kgdGhlIDxw
bHVnaW5BcHBsaWNhdGlvbj4ud2FyIGZpbGUgb24gSkJvc3MgQVMgaW5zdGFuY2UsIGUuZy4gPEpC
T1NTX0hPTUU+L3N0YW5kYWxvbmUvZGVwbG95bWVudHMuDQoNCiAgIFRoaXMgbWFrZXMgcGx1Z2lu
QXBwbGljYXRpb24ncyBHV1QgUlBDIHNlcnZsZXQocykgYWNjZXNzaWJsZSBmcm9tIHRoZSBzYW1l
IG9yaWdpbiAocHJvdG9jb2wsIGRvbWFpbiwgcG9ydCkuDQoNCmMpIE1vZGlmaWNhdGlvbiBvZiBw
bHVnaW4gbGlmZWN5Y2xlIHN0ZXAgIzU6DQoNCiAgIEluc3RlYWQgb2YgZW1iZWRkaW5nIDxwbHVn
aW5BcHBsaWNhdGlvbj4ubm9jYWNoZS5qcyBjb250ZW50IGludG8gV2ViQWRtaW4gSFRNTCBwYWdl
LCBqdXN0IGVtYmVkIHRoZSBsaW5rIHRvIGl0LCBlLmcuIGh0dHAocyk6Ly8xMjcuMC4wLjE6PHBv
cnQ+L3BhdGgvdG8vPHBsdWdpbkFwcGxpY2F0aW9uPi5ub2NhY2hlLmpzDQoNCmQpIE1vZGlmaWNh
dGlvbiBvZiBwbHVnaW4gbGlmZWN5Y2xlIHN0ZXAgIzY6DQoNCiAgIER1cmluZyBXZWJBZG1pbiBz
dGFydHVwLCBmb3IgZWFjaCBwbHVnaW4gdGhhdCBpcyBzdXBwb3NlZCB0byBiZSBsb2FkZWQgcmVt
b3RlbHksIGNyZWF0ZSBhbiA8aWZyYW1lPiB0aGF0IHdpbGwgZmV0Y2ggdGhlIHBsdWdpbiBhc3lu
Y2hyb25vdXNseS4NCg0KICAgVGhlIDxpZnJhbWU+IGlzIHJlcXVpcmVkIGluIG9yZGVyIGZvciA8
cGx1Z2luQXBwbGljYXRpb24+Lm5vY2FjaGUuanMgdG8gYXBwZWFyIGZyb20gZGlmZmVyZW50IChw
bHVnaW5BcHBsaWNhdGlvbi1zcGVjaWZpYykgZG9tYWluIHRoYW4gV2ViQWRtaW4gSFRNTCBwYWdl
Lg0KDQogICBUaGlzIHdheSwgZmV0Y2hpbmcgcGVybXV0YXRpb24gKDxoYXNoTmFtZT4uY2FjaGUu
aHRtbCkgZmlsZXMsIHdoaWNoIGFyZSByZWxhdGl2ZSB0byA8cGx1Z2luQXBwbGljYXRpb24+Lm5v
Y2FjaGUuanMsIHdpbGwgd29yayBvdXQtb2YtdGhlLWJveC4NCg0KDQpHZW9yZ2UsIHBsZWFzZSBs
ZXQgbWUga25vdyB3aGF0IHlvdSB0aGluaywgYW5kIEkgd2lsbCB1cGRhdGUgVUkgUGx1Z2lucyB3
aWtpIGFjY29yZGluZ2x5Lg0KDQpWb2p0ZWNoDQoNCg0KWzFdIGh0dHA6Ly9lbi53aWtpcGVkaWEu
b3JnL3dpa2kvU2FtZV9vcmlnaW5fcG9saWN5DQpbMl0gaHR0cHM6Ly9kZXZlbG9wZXJzLmdvb2ds
ZS5jb20vd2ViLXRvb2xraXQvZG9jL2xhdGVzdC9EZXZHdWlkZUNvZGluZ0Jhc2ljc0pTTkkNClsz
XSBodHRwczovL2RldmVsb3BlcnMuZ29vZ2xlLmNvbS93ZWItdG9vbGtpdC9kb2MvbGF0ZXN0L0Rl
dkd1aWRlQ29kaW5nQmFzaWNzT3ZlcmxheQ0KDQpfX19fX19fX19fX19fX19fX19fX19fX19fX19f
X19fXw0KDQpGcm9tOiAiR2VvcmdlIENvc3RlYSIgPEdlb3JnZS5Db3N0ZWFAbmV0YXBwLmNvbTxt
YWlsdG86R2VvcmdlLkNvc3RlYUBuZXRhcHAuY29tPj4NClRvOiAiVm9qdGVjaCBTem9jcyIgPHZz
em9jc0ByZWRoYXQuY29tPG1haWx0bzp2c3pvY3NAcmVkaGF0LmNvbT4+LCBlbmdpbmUtZGV2ZWxA
b3ZpcnQub3JnPG1haWx0bzplbmdpbmUtZGV2ZWxAb3ZpcnQub3JnPg0KQ2M6ICJEdXN0aW4gU2No
b2VuYnJ1biIgPER1c3Rpbi5TY2hvZW5icnVuQG5ldGFwcC5jb208bWFpbHRvOkR1c3Rpbi5TY2hv
ZW5icnVuQG5ldGFwcC5jb20+PiwgIlJpY2t5IEhvcHBlciIgPFJpY2t5LkhvcHBlckBuZXRhcHAu
Y29tPG1haWx0bzpSaWNreS5Ib3BwZXJAbmV0YXBwLmNvbT4+LCAiSXRhbWFyIEhlaW0iIDxpaGVp
bUByZWRoYXQuY29tPG1haWx0bzppaGVpbUByZWRoYXQuY29tPj4NClNlbnQ6IE1vbmRheSwgSnVu
ZSAyNSwgMjAxMiA5OjExOjMzIFBNDQpTdWJqZWN0OiBSRTogb1ZpcnQgVUkgUGx1Z2lucyBmZWF0
dXJlOiBSZWFkeSBmb3IgcmV2aWV3DQoNClRoYW5rcyBWb2p0ZWNoLg0KDQpTaW5jZSB0aGUgcGx1
Z2lucyBhcmUgZW1iZWRkZWQgaW50byB0aGUgV2ViQWRtaW4gSFRNTCBwYWdlLCB0aGF0IHNlZW1z
IHRvIHNpbXBsaWZ5IHRoaW5nczsgbm8gZXh0ZXJuYWwgd2ViIHNlcnZpY2UgaXMgbmVlZGVkLiAg
VGhpcyBhcHByb2FjaCB0aWVzIGludG8gdGhlIGlzc3VlIG92ZXIgdGhlIGZyZWVkb20gdG8gZGVj
aWRlIHdoaWNoIHRlY2hub2xvZ3kgdG8gdXNlIHdoZW4gZGV2ZWxvcGluZyBhIHBsdWdpbi4gIFdo
aWxlIEkgYWdyZWUgdGhhdCBqUXVlcnkgaXMgYmVzdCBmb3Igc2ltcGxlIGRpYWxvZ3MsIGEgd2l6
YXJkLWRyaXZlbiB3b3JrZmxvdyBpcyBlYXNpZXIgdG8gZGV2ZWxvcCBpbiBHV1QuDQoNCkZvciBl
eGFtcGxlLCBpZiBJIHdhbnQgdG8gc3RlcCBhIHVzZXIgdGhyb3VnaCB0aGUgcHJvY2VzcyBvZiBj
cmVhdGluZyBhIG5ldyBzdG9yYWdlIGRvbWFpbiBJIHdvdWxkIGxpa2UgdG8gcHJvdmlkZSBhIHdv
cmtmbG93IHRvIHNlbGVjdCBhIHN0b3JhZ2UgYXJyYXksIHByb3ZpZGUgY3JlZGVudGlhbHMsIGFu
ZCBjb25maWd1cmUgdGhlIGRldGFpbHMgb2YgdGhlIE5GUyBleHBvcnQuICBUaGlzIHdvcmtmbG93
IGNvdWxkIHByZXN1bWFibHkgaGF2ZSBhIEdXVC1SUEMgbWVjaGFuaXNtIHRoYXQgcmVsaWVzIG9u
IHNvbWUgYWRkaXRpb25hbCBsaWJyYXJpZXMgb24gdGhlIGJhY2tlbmQgKGxpYnJhcmllcyB0aGF0
IGFsbG93IG1lIHRvIGNvbW11bmljYXRlIHdpdGggdGhlIHN0b3JhZ2UgYXJyYXkpLiAgVXNpbmcg
dGhlIEdXVC1FeHBvcnRlciwgSSBjb3VsZCBleHBvcnQgdGhlIGNsYXNzZXMgdGhhdCB3b3VsZCBk
aXNwbGF5IHRoZSB3b3JrZmxvdyB3aGljaCB3b3VsZCB0aGVuIGdldCBsYXVuY2hlZCBhcyBteSBl
eHRlbnNpb24gaXMgc2VsZWN0ZWQuICBZb3Ugc2FpZCB0aGF0IEkgd291bGQgaGF2ZSBteSBvVmly
dCBVSSBwbHVnaW4gZGVwZW5kIG9uIG15IGNvbXBpbGVkICdwbHVnaW4gc3VwcG9ydCBhcHBsaWNh
dGlvbicuICBNeSBjb21waWxlZCBwbHVnaW4gc3VwcG9ydCBhcHBsaWNhdGlvbiB3b3VsZCBub3Jt
YWxseSBiZSBhIHdhciBmaWxlIGNvbnRhaW5pbmcgbXkgY29tcGlsZWQgR1dUIGNvZGUgYW5kIGEg
d2ViLWluZiBmb2xkZXIgY29udGFpbmluZyBteSBsaWJyYXJpZXMuICBJcyB0aGUgcGx1Z2luIGRl
cGVuZGluZyBvbiB0aGUgd2FyIGZpbGU/ICBJcyB0aGF0IHdoYXQgSSBzcGVjaWZ5Pw0KDQotR2Vv
cmdlDQoNCi0tLS0tT3JpZ2luYWwgTWVzc2FnZS0tLS0tDQpGcm9tOiBWb2p0ZWNoIFN6b2NzIFtt
YWlsdG86dnN6b2NzQHJlZGhhdC5jb21dPG1haWx0bzpbbWFpbHRvOnZzem9jc0ByZWRoYXQuY29t
XT4NClNlbnQ6IE1vbmRheSwgSnVuZSAyNSwgMjAxMiAxOjEyIFBNDQpUbzogQ29zdGVhLCBHZW9y
Z2U7IGVuZ2luZS1kZXZlbEBvdmlydC5vcmc8bWFpbHRvOmVuZ2luZS1kZXZlbEBvdmlydC5vcmc+
DQpDYzogU2Nob2VuYnJ1biwgRHVzdGluOyBIb3BwZXIsIFJpY2t5OyBJdGFtYXIgSGVpbQ0KU3Vi
amVjdDogUmU6IG9WaXJ0IFVJIFBsdWdpbnMgZmVhdHVyZTogUmVhZHkgZm9yIHJldmlldw0KDQpI
aSBHZW9yZ2UsDQoNCnRoYW5rcyBmb3IgeW91ciBmZWVkYmFjay4gUGxlYXNlIGZpbmQgbXkgYW5z
d2VycyBiZWxvdy4NCg0KMSkgQXJlIHRoZSBwbHVnaW5zIGhvc3RlZCBieSB0aGUgc2FtZSBqYm9z
cyBzZXJ2ZXIgdGhhdCBob3N0cyB0aGUgZW5naW5lPyAgSXQgd291bGQgYXBwZWFyIHRoZSBhbnN3
ZXIgaXMgeWVzIGFuZCB0aGF0IG5vIHNlcGFyYXRlIGNvbnRhaW5lciBpcyByZXF1aXJlZCBmb3Ig
dGhlIHBsdWdpbnMuDQoNCkluIHNob3J0LCB5ZXMuDQoNCg0KUGx1Z2lucywgYWxvbmcgd2l0aCB0
aGVpciBjb25maWd1cmF0aW9uIGFuZCAzcmQgcGFydHkgZGVwZW5kZW5jaWVzLCBhcmUgbWVhbnQg
dG8gYmUgZW1iZWRkZWQgaW50byBmaW5hbCBXZWJBZG1pbiBIVE1MIHBhZ2UsIHNlZSBbaHR0cDov
L3d3dy5vdmlydC5vcmcvd2lraS9GZWF0dXJlcy9VSVBsdWdpbnMjUGx1Z2luX2xpZmVjeWNsZV0g
c3RlcCAjNS4NCkpCb3NzIEFTIGluc3RhbmNlIHNlcnZlcyBXZWJBZG1pbiBIVE1MIHBhZ2UgKFdl
YmFkbWluRHluYW1pY0hvc3RpbmdTZXJ2bGV0KSwgYWxvbmcgd2l0aCBwcm92aWRpbmcgR1dUIFJQ
QyBhbmQgUkVTVCBlbmRwb2ludHMgdGhhdCBkZWxlZ2F0ZSB0byBFbmdpbmUgYnVzaW5lc3MgbG9n
aWMgdGhyb3VnaCBFSkIgQmFja2VuZExvY2FsIGludGVyZmFjZS4NCg0KSG93ZXZlciwgcGx1Z2lu
cyBhcmUgbm90ICdob3N0ZWQnIGluIGEgdHlwaWNhbCBzZW5zZSAtIFdlYmFkbWluRHluYW1pY0hv
c3RpbmdTZXJ2bGV0IHJlYWRzIGFuZCBlbWJlZHMgYWxsIHBsdWdpbiBkYXRhIGRpcmVjdGx5IGlu
dG8gZmluYWwgV2ViQWRtaW4gSFRNTCBwYWdlLg0KDQoyKSBEb2VzIGVhY2ggcGx1Z2luIG1hcCB0
byBhIHVuaXF1ZSBleHRlbnNpb24gd2l0aGluIFdlYkFkbWluPyAgWW91ciBleGFtcGxlIHNob3dz
IHRoYXQgSSBjYW4gZXh0ZW5kIHRoZSBWTSB0YWJsZSB0byBoYXZlIGEgIlNob3cgVk0gbmFtZSBh
bmQgZWRpdCBWTSIgY29udGV4dC1zZW5zaXRpdmUgZXh0ZW5zaW9uLiAgVGhpcyBpcyBuYW1lZCBw
bHVnaW5BcGkucGx1Z2lucy5teVBsdWdpbi4gIENhbiBJIHNhZmVseSBhc3N1bWUgdGhhdCB0aGlz
IGlzIHBlciBleHRlbnNpb24/ICBJIHdvdWxkIGhhdmUgcGx1Z2luQXBpLnBsdWdpbnMubXlQbHVn
aW4yIGZvciBleHRlbmRpbmcgYSBzdG9yYWdlIGRvbWFpbj8NCg0KRXh0ZW5zaW9uIHBvaW50cyBh
cmUgcmVwcmVzZW50ZWQgYnkgYXBwbGljYXRpb24gZXZlbnRzLCB0cmlnZ2VyZWQgYnkgV2ViQWRt
aW4gYW5kIGNvbnN1bWVkIGJ5IHBsdWdpbnMuIEZvciBleGFtcGxlLCAndGFibGVDb250ZXh0TWVu
dScgZXZlbnQgZ2V0cyB0cmlnZ2VyZWQgd2hlbiBhIHRhYmxlIGNvbnRleHQgbWVudSBpcyBhYm91
dCB0byBiZSBzaG93biB0byB0aGUgdXNlciwgd2hpY2ggZ2l2ZXMgcGx1Z2lucyB0aGUgYWJpbGl0
eSB0byBkbyBzb21ldGhpbmcgY3VzdG9tIHdpdGggdGhlIGNvbnRleHQgbWVudSBiZWZvcmUgaXQn
cyBzaG93bi4NCg0KDQpUaGVyZSBjYW4gYmUgbXVsdGlwbGUgcGx1Z2lucyBoYW5kbGluZyB0aGUg
c2FtZSBldmVudCAoZXh0ZW5zaW9uIHBvaW50KS4gWW91IGNhbiBoYXZlIHR3byBwbHVnaW5zLCBz
YXkgJ3BsdWdpbkFwaS5wbHVnaW5zLk9uZScgYW5kICdwbHVnaW5BcGkucGx1Z2lucy5Ud28nLCBl
YWNoIHByb3ZpZGluZyAndGFibGVDb250ZXh0TWVudScgZnVuY3Rpb24gZm9yIGhhbmRsaW5nIHRo
ZSBhYm92ZSBtZW50aW9uZWQgZXZlbnQuIFdlYkFkbWluIHdpbGwgaW52b2tlIGFsbCBwbHVnaW5z
IGZvciB0aGUgZ2l2ZW4gZXZlbnQuDQoNClRvIGFuc3dlciB5b3VyIHF1ZXN0aW9uLCBpbiBvcmRl
ciB0byBoYW5kbGUgWCBldmVudHMgKGV4dGVuc2lvbiBwb2ludHMpLCB5b3UgZG9uJ3QgbmVlZCB0
byB3cml0ZSBYIHBsdWdpbnMuIFlvdSBjYW4gd3JpdGUgb25lIHBsdWdpbiB0aGF0IGhhbmRsZXMg
WCBldmVudHMuDQoNCjMpIEluc3RlYWQgb2YgbGF1bmNoaW5nIGEgalF1ZXJ5IGRpYWxvZywgY2Fu
IEkgcG9pbnQgdG8gYSBjb21waWxlZCBHV1QgaHRtbCBmaWxlIHRvIGRpc3BsYXkgYSBkaWFsb2cg
dGhhdCBmaXRzIG15IG5lZWRzPw0KDQpZb3UgY2FuIGRvIGFueXRoaW5nIHlvdSB3YW50IGluIHlv
dXIgcGx1Z2luIGV2ZW50IGhhbmRsZXIgZnVuY3Rpb24uIFNob3cgYSBqUXVlcnkgVUkgZGlhbG9n
LCBtYWtlIG9WaXJ0IFJFU1QgQVBJIHJlcXVlc3QsIGNhbGwgYXJiaXRyYXJ5IHJlbW90ZSBzZXJ2
ZXIgdXNpbmcgY3Jvc3MtZG9tYWluIHRlY2huaXF1ZSBsaWtlIEpTT05QIFsxXSBvciBDT1JTIFsy
XSwgZXRjLiBQbHVnaW4gYXV0aG9ycyBhcmUgZnJlZSB0byBkZWNpZGUgaWYgdGhleSB3YW50IHRv
IHJlbHkgb24gM3JkIHBhcnR5IEphdmFTY3JpcHQgbGlicmFyaWVzLCBvciBpZiB0aGV5IHdhbnQg
dG8gd3JpdGUgZW50aXJlIHBsdWdpbiBjb2RlIGJ5IHRoZW1zZWx2ZXMuDQoNCg0KSW4gbXkgb3Bp
bmlvbiwgdG9vbHMgbGlrZSBqUXVlcnkgYXJlIGZhciBtb3JlIGVsZWdhbnQgZm9yIGhhbmRsaW5n
IHNpbXBsZSB0aGluZ3Mgc3VjaCBhcyBVSSBkaWFsb2dzLiBCdXQgaWYgeW91IHJlYWxseSB3YW50
IHRvIHVzZSBHV1QgZm9yIHRoaXMgcHVycG9zZSwgSSBzdWdnZXN0IGZvbGxvd2luZyBhcHByb2Fj
aDoNCg0KYSwgZGV2ZWxvcCBhICdwbHVnaW4gc3VwcG9ydCBhcHBsaWNhdGlvbicgaW4gR1dULCB3
aGljaCBpbXBsZW1lbnRzIHRoZSBuZWNlc3NhcnkgZGlhbG9nIGZ1bmN0aW9uYWxpdHkgYiwgZXhw
b3J0IGl0cyBtYWluIChlLmcuIGRpYWxvZyBoYW5kbGluZykgY2xhc3NlcyBmb3IgdXNlIGluIG5h
dGl2ZSBKYXZhU2NyaXB0IHRocm91Z2ggZ3d0LWV4cG9ydGVyIFszXSBjLCBoYXZlIHlvdXIgb1Zp
cnQgVUkgcGx1Z2luIGRlcGVuZCBvbiB5b3VyIGNvbXBpbGVkICdwbHVnaW4gc3VwcG9ydCBhcHBs
aWNhdGlvbicgKHRoaXMgd2lsbCBjYXVzZSB5b3VyICdwbHVnaW4gc3VwcG9ydCBhcHBsaWNhdGlv
bicgdG8gYmUgY2FsbGVkIGR1cmluZyBXZWJBZG1pbiBzdGFydHVwKSBkLCBpbiB5b3VyIG9WaXJ0
IFVJIHBsdWdpbiwgaW52b2tlICdwbHVnaW4gc3VwcG9ydCBhcHBsaWNhdGlvbicgZnVuY3Rpb25h
bGl0eSB0aHJvdWdoIGV4cG9ydGVkIGNsYXNzZXMgKHBsdWdpbiAtPiBHV1QgZGVsZWdhdGUgcGF0
dGVybikNCg0KNCkgSXMgc2Vzc2lvbiBpbmZvIHBhc3NlZCBpbnRvIHRoZSBwbHVnaW4gc28gdGhh
dCBJIGNhbiBpbnZva2UgQVBJcyBpbnRvIHRoZSBlbmdpbmU/ICBUbyBwb3dlciBvbiBhIFZNIGZv
ciBpbnN0YW5jZT8gIE9yIHRvIG1vdW50IGEgbmV3IE5GUyBzdG9yYWdlIGRvbWFpbj8NCg0KWWVz
LCB0aGlzIHNob3VsZCBiZSBwYXJ0IG9mIFtodHRwOi8vd3d3Lm92aXJ0Lm9yZy93aWtpL0ZlYXR1
cmVzL1VJUGx1Z2lucyNHbG9iYWxfQVBJX2Z1bmN0aW9uc10gIlBsdWdpbiB1dGlsaXR5IGZ1bmN0
aW9ucyIgKGdsb2JhbCBBUEkpLg0KDQoNCllvdXIgcGx1Z2luIG1pZ2h0IGFjY2VzcyB1c2VyIHNl
c3Npb24gaW5mb3JtYXRpb24gaW4gdGhlIGZvbGxvd2luZyB3YXk6IHBsdWdpbkFwaS51dGlsKCku
dXNlckluZm8oKS4qIChyZXBsYWNlICogd2l0aCBpZCgpLCBuYW1lKCksIGRvbWFpbigpLCBldGMu
KQ0KDQpBcyB5b3UgcG9pbnRlZCBvdXQsIHRoaXMgY291bGQgYmUgdXNlZCB0byBhdXRoZW50aWNh
dGUgb1ZpcnQgUkVTVCBBUEkgcmVxdWVzdHMgbWFkZSBmcm9tIHlvdXIgcGx1Z2luIGNvZGUuDQoN
CkJUVywgdGhlIGxpbmsgdG8gdGhlIG9yaWdpbmFsIGRlc2lnbiBub3RlcyBvbiB0aGUgd2lraSBk
b2Vzbid0IHdvcmsuDQoNClRoaXMgaXMgc3RyYW5nZSwgW2h0dHA6Ly9yaGV2bWYucGFkLmVuZ2lu
ZWVyaW5nLnJlZGhhdC5jb20vNjhdIGhhcyBpdHMgdmlzaWJpbGl0eSBzZXQgdG8gIlB1YmxpYyAo
QWxsb3cgSW50ZXJuZXQgZ3Vlc3RzKSIgLi4uIERvZXMgYW55Ym9keSBrbm93IHdoeSB0aGlzIGRv
ZXNuJ3Qgd29yaz8NCg0KDQoNClZvanRlY2gNCg0KDQpbMV0gaHR0cDovL2VuLndpa2lwZWRpYS5v
cmcvd2lraS9KU09OUA0KWzJdIGh0dHA6Ly9lbi53aWtpcGVkaWEub3JnL3dpa2kvQ3Jvc3Mtb3Jp
Z2luX3Jlc291cmNlX3NoYXJpbmcNClszXSBodHRwOi8vY29kZS5nb29nbGUuY29tL3AvZ3d0LWV4
cG9ydGVyLw0KDQoNCi0tLS0tIE9yaWdpbmFsIE1lc3NhZ2UgLS0tLS0NCkZyb206ICJHZW9yZ2Ug
Q29zdGVhIiA8R2VvcmdlLkNvc3RlYUBuZXRhcHAuY29tPG1haWx0bzpHZW9yZ2UuQ29zdGVhQG5l
dGFwcC5jb20+Pg0KVG86ICJWb2p0ZWNoIFN6b2NzIiA8dnN6b2NzQHJlZGhhdC5jb208bWFpbHRv
OnZzem9jc0ByZWRoYXQuY29tPj4sIGVuZ2luZS1kZXZlbEBvdmlydC5vcmc8bWFpbHRvOmVuZ2lu
ZS1kZXZlbEBvdmlydC5vcmc+DQpDYzogIkR1c3RpbiBTY2hvZW5icnVuIiA8RHVzdGluLlNjaG9l
bmJydW5AbmV0YXBwLmNvbTxtYWlsdG86RHVzdGluLlNjaG9lbmJydW5AbmV0YXBwLmNvbT4+LCAi
Umlja3kgSG9wcGVyIiA8Umlja3kuSG9wcGVyQG5ldGFwcC5jb208bWFpbHRvOlJpY2t5LkhvcHBl
ckBuZXRhcHAuY29tPj4NClNlbnQ6IE1vbmRheSwgSnVuZSAyNSwgMjAxMiAzOjA5OjQzIFBNDQpT
dWJqZWN0OiBSRTogb1ZpcnQgVUkgUGx1Z2lucyBmZWF0dXJlOiBSZWFkeSBmb3IgcmV2aWV3DQoN
CkhpIFZvanRlY2gsDQoNCkkgaGF2ZSBhIGZldyBxdWVzdGlvbnMgb24gdGhpcyBmZWF0dXJlLg0K
DQoxKSBBcmUgdGhlIHBsdWdpbnMgaG9zdGVkIGJ5IHRoZSBzYW1lIGpib3NzIHNlcnZlciB0aGF0
IGhvc3RzIHRoZSBlbmdpbmU/ICBJdCB3b3VsZCBhcHBlYXIgdGhlIGFuc3dlciBpcyB5ZXMgYW5k
IHRoYXQgbm8gc2VwYXJhdGUgY29udGFpbmVyIGlzIHJlcXVpcmVkIGZvciB0aGUgcGx1Z2lucy4N
CjIpIERvZXMgZWFjaCBwbHVnaW4gbWFwIHRvIGEgdW5pcXVlIGV4dGVuc2lvbiB3aXRoaW4gV2Vi
QWRtaW4/ICBZb3VyIGV4YW1wbGUgc2hvd3MgdGhhdCBJIGNhbiBleHRlbmQgdGhlIFZNIHRhYmxl
IHRvIGhhdmUgYSAiU2hvdyBWTSBuYW1lIGFuZCBlZGl0IFZNIiBjb250ZXh0LXNlbnNpdGl2ZSBl
eHRlbnNpb24uICBUaGlzIGlzIG5hbWVkIHBsdWdpbkFwaS5wbHVnaW5zLm15UGx1Z2luLiAgQ2Fu
IEkgc2FmZWx5IGFzc3VtZSB0aGF0IHRoaXMgaXMgcGVyIGV4dGVuc2lvbj8gIEkgd291bGQgaGF2
ZSBwbHVnaW5BcGkucGx1Z2lucy5teVBsdWdpbjIgZm9yIGV4dGVuZGluZyBhIHN0b3JhZ2UgZG9t
YWluPw0KMykgSW5zdGVhZCBvZiBsYXVuY2hpbmcgYSBqUXVlcnkgZGlhbG9nLCBjYW4gSSBwb2lu
dCB0byBhIGNvbXBpbGVkIEdXVCBodG1sIGZpbGUgdG8gZGlzcGxheSBhIGRpYWxvZyB0aGF0IGZp
dHMgbXkgbmVlZHM/DQo0KSBJcyBzZXNzaW9uIGluZm8gcGFzc2VkIGludG8gdGhlIHBsdWdpbiBz
byB0aGF0IEkgY2FuIGludm9rZSBBUElzIGludG8gdGhlIGVuZ2luZT8gIFRvIHBvd2VyIG9uIGEg
Vk0gZm9yIGluc3RhbmNlPyAgT3IgdG8gbW91bnQgYSBuZXcgTkZTIHN0b3JhZ2UgZG9tYWluPw0K
DQpCVFcsIHRoZSBsaW5rIHRvIHRoZSBvcmlnaW5hbCBkZXNpZ24gbm90ZXMgb24gdGhlIHdpa2kg
ZG9lc24ndCB3b3JrLg0KDQpUaGFua3MsDQpHZW9yZ2UNCg0KLS0tLS1PcmlnaW5hbCBNZXNzYWdl
LS0tLS0NCkZyb206IFZvanRlY2ggU3pvY3MgW21haWx0bzp2c3pvY3NAcmVkaGF0LmNvbV08bWFp
bHRvOlttYWlsdG86dnN6b2NzQHJlZGhhdC5jb21dPg0KU2VudDogVGh1cnNkYXksIEp1bmUgMjEs
IDIwMTIgMTE6MDMgQU0NClRvOiBlbmdpbmUtZGV2ZWxAb3ZpcnQub3JnPG1haWx0bzplbmdpbmUt
ZGV2ZWxAb3ZpcnQub3JnPg0KQ2M6IFNjaG9lbmJydW4sIER1c3RpbjsgQ29zdGVhLCBHZW9yZ2U7
IEhvcHBlciwgUmlja3kNClN1YmplY3Q6IG9WaXJ0IFVJIFBsdWdpbnMgZmVhdHVyZTogUmVhZHkg
Zm9yIHJldmlldw0KDQpIaSBndXlzLA0KDQpJIHdyb3RlIGEgd2lraSBwYWdlIGRlc2NyaWJpbmcg
VUkgUGx1Z2lucywgYSBmZWF0dXJlIHBsYW5uZWQgZm9yIG9WaXJ0IHdlYiBhZG1pbmlzdHJhdGlv
biAoV2ViQWRtaW4pIGFwcGxpY2F0aW9uOg0KaHR0cDovL3d3dy5vdmlydC5vcmcvd2lraS9GZWF0
dXJlcy9VSVBsdWdpbnMNCg0KRmVhdHVyZSBkZXNpZ24gaXMgZmluaXNoZWQgYW5kIHJlYWR5IGZv
ciByZXZpZXcuIFBsZWFzZSBmZWVsIGZyZWUgdG8gYWRkIGNvbW1lbnRzLCBhc2sgcXVlc3Rpb25z
IG9yIHJlYWNoIG1lIGRpcmVjdGx5IG9uICNvdmlydCBjaGFubmVsLg0KDQpDaGVlcnMsDQpWb2p0
ZWNoDQo=
--_000_6C8AC8C50E170C4E9B44D47B39B24A48012080BASACEXCMBX04PRDh_
Content-Type: text/html; charset="utf-8"
Content-Transfer-Encoding: base64
PGh0bWwgeG1sbnM6dj0idXJuOnNjaGVtYXMtbWljcm9zb2Z0LWNvbTp2bWwiIHhtbG5zOm89InVy
bjpzY2hlbWFzLW1pY3Jvc29mdC1jb206b2ZmaWNlOm9mZmljZSIgeG1sbnM6dz0idXJuOnNjaGVt
YXMtbWljcm9zb2Z0LWNvbTpvZmZpY2U6d29yZCIgeG1sbnM6bT0iaHR0cDovL3NjaGVtYXMubWlj
cm9zb2Z0LmNvbS9vZmZpY2UvMjAwNC8xMi9vbW1sIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcv
VFIvUkVDLWh0bWw0MCI+DQo8aGVhZD4NCjxtZXRhIGh0dHAtZXF1aXY9IkNvbnRlbnQtVHlwZSIg
Y29udGVudD0idGV4dC9odG1sOyBjaGFyc2V0PXV0Zi04Ij4NCjxtZXRhIG5hbWU9IkdlbmVyYXRv
ciIgY29udGVudD0iTWljcm9zb2Z0IFdvcmQgMTQgKGZpbHRlcmVkIG1lZGl1bSkiPg0KPCEtLVtp
ZiAhbXNvXT48c3R5bGU+dlw6KiB7YmVoYXZpb3I6dXJsKCNkZWZhdWx0I1ZNTCk7fQ0Kb1w6KiB7
YmVoYXZpb3I6dXJsKCNkZWZhdWx0I1ZNTCk7fQ0Kd1w6KiB7YmVoYXZpb3I6dXJsKCNkZWZhdWx0
I1ZNTCk7fQ0KLnNoYXBlIHtiZWhhdmlvcjp1cmwoI2RlZmF1bHQjVk1MKTt9DQo8L3N0eWxlPjwh
W2VuZGlmXS0tPjxzdHlsZT48IS0tDQovKiBGb250IERlZmluaXRpb25zICovDQpAZm9udC1mYWNl
DQoJe2ZvbnQtZmFtaWx5OkNhbGlicmk7DQoJcGFub3NlLTE6MiAxNSA1IDIgMiAyIDQgMyAyIDQ7
fQ0KQGZvbnQtZmFjZQ0KCXtmb250LWZhbWlseTpUYWhvbWE7DQoJcGFub3NlLTE6MiAxMSA2IDQg
MyA1IDQgNCAyIDQ7fQ0KQGZvbnQtZmFjZQ0KCXtmb250LWZhbWlseToiTHVjaWRhIENvbnNvbGUi
Ow0KCXBhbm9zZS0xOjIgMTEgNiA5IDQgNSA0IDIgMiA0O30NCi8qIFN0eWxlIERlZmluaXRpb25z
ICovDQpwLk1zb05vcm1hbCwgbGkuTXNvTm9ybWFsLCBkaXYuTXNvTm9ybWFsDQoJe21hcmdpbjow
aW47DQoJbWFyZ2luLWJvdHRvbTouMDAwMXB0Ow0KCWZvbnQtc2l6ZToxMi4wcHQ7DQoJZm9udC1m
YW1pbHk6IlRpbWVzIE5ldyBSb21hbiIsInNlcmlmIjt9DQphOmxpbmssIHNwYW4uTXNvSHlwZXJs
aW5rDQoJe21zby1zdHlsZS1wcmlvcml0eTo5OTsNCgljb2xvcjpibHVlOw0KCXRleHQtZGVjb3Jh
dGlvbjp1bmRlcmxpbmU7fQ0KYTp2aXNpdGVkLCBzcGFuLk1zb0h5cGVybGlua0ZvbGxvd2VkDQoJ
e21zby1zdHlsZS1wcmlvcml0eTo5OTsNCgljb2xvcjpwdXJwbGU7DQoJdGV4dC1kZWNvcmF0aW9u
OnVuZGVybGluZTt9DQpwDQoJe21zby1zdHlsZS1wcmlvcml0eTo5OTsNCgltYXJnaW46MGluOw0K
CW1hcmdpbi1ib3R0b206LjAwMDFwdDsNCglmb250LXNpemU6MTIuMHB0Ow0KCWZvbnQtZmFtaWx5
OiJUaW1lcyBOZXcgUm9tYW4iLCJzZXJpZiI7fQ0KcC5Nc29BY2V0YXRlLCBsaS5Nc29BY2V0YXRl
LCBkaXYuTXNvQWNldGF0ZQ0KCXttc28tc3R5bGUtcHJpb3JpdHk6OTk7DQoJbXNvLXN0eWxlLWxp
bms6IkJhbGxvb24gVGV4dCBDaGFyIjsNCgltYXJnaW46MGluOw0KCW1hcmdpbi1ib3R0b206LjAw
MDFwdDsNCglmb250LXNpemU6OC4wcHQ7DQoJZm9udC1mYW1pbHk6IlRhaG9tYSIsInNhbnMtc2Vy
aWYiO30NCnNwYW4uRW1haWxTdHlsZTE5DQoJe21zby1zdHlsZS10eXBlOnBlcnNvbmFsLXJlcGx5
Ow0KCWZvbnQtZmFtaWx5OiJDYWxpYnJpIiwic2Fucy1zZXJpZiI7DQoJY29sb3I6IzFGNDk3RDt9
DQpzcGFuLkJhbGxvb25UZXh0Q2hhcg0KCXttc28tc3R5bGUtbmFtZToiQmFsbG9vbiBUZXh0IENo
YXIiOw0KCW1zby1zdHlsZS1wcmlvcml0eTo5OTsNCgltc28tc3R5bGUtbGluazoiQmFsbG9vbiBU
ZXh0IjsNCglmb250LWZhbWlseToiVGFob21hIiwic2Fucy1zZXJpZiI7fQ0KLk1zb0NocERlZmF1
bHQNCgl7bXNvLXN0eWxlLXR5cGU6ZXhwb3J0LW9ubHk7DQoJZm9udC1zaXplOjEwLjBwdDt9DQpA
cGFnZSBXb3JkU2VjdGlvbjENCgl7c2l6ZTo4LjVpbiAxMS4waW47DQoJbWFyZ2luOjEuMGluIDEu
MGluIDEuMGluIDEuMGluO30NCmRpdi5Xb3JkU2VjdGlvbjENCgl7cGFnZTpXb3JkU2VjdGlvbjE7
fQ0KLyogTGlzdCBEZWZpbml0aW9ucyAqLw0KQGxpc3QgbDANCgl7bXNvLWxpc3QtaWQ6MjA1MDQ5
MTY3NTsNCgltc28tbGlzdC10ZW1wbGF0ZS1pZHM6MjczMTU3MTQyO30NCm9sDQoJe21hcmdpbi1i
b3R0b206MGluO30NCnVsDQoJe21hcmdpbi1ib3R0b206MGluO30NCi0tPjwvc3R5bGU+PCEtLVtp
ZiBndGUgbXNvIDldPjx4bWw+DQo8bzpzaGFwZWRlZmF1bHRzIHY6ZXh0PSJlZGl0IiBzcGlkbWF4
PSIxMDI2IiAvPg0KPC94bWw+PCFbZW5kaWZdLS0+PCEtLVtpZiBndGUgbXNvIDldPjx4bWw+DQo8
bzpzaGFwZWxheW91dCB2OmV4dD0iZWRpdCI+DQo8bzppZG1hcCB2OmV4dD0iZWRpdCIgZGF0YT0i
MSIgLz4NCjwvbzpzaGFwZWxheW91dD48L3htbD48IVtlbmRpZl0tLT4NCjwvaGVhZD4NCjxib2R5
IGxhbmc9IkVOLVVTIiBsaW5rPSJibHVlIiB2bGluaz0icHVycGxlIj4NCjxkaXYgY2xhc3M9Ildv
cmRTZWN0aW9uMSI+DQo8cCBjbGFzcz0iTXNvTm9ybWFsIj48c3BhbiBzdHlsZT0iZm9udC1zaXpl
OjExLjBwdDtmb250LWZhbWlseTomcXVvdDtDYWxpYnJpJnF1b3Q7LCZxdW90O3NhbnMtc2VyaWYm
cXVvdDs7Y29sb3I6IzFGNDk3RCI+VGhpcyBzb3VuZHMgZ3JlYXQuJm5ic3A7IFRoYW5rcyBWb2p0
ZWNoLjxvOnA+PC9vOnA+PC9zcGFuPjwvcD4NCjxwIGNsYXNzPSJNc29Ob3JtYWwiPjxhIG5hbWU9
Il9NYWlsRW5kQ29tcG9zZSI+PHNwYW4gc3R5bGU9ImZvbnQtc2l6ZToxMS4wcHQ7Zm9udC1mYW1p
bHk6JnF1b3Q7Q2FsaWJyaSZxdW90OywmcXVvdDtzYW5zLXNlcmlmJnF1b3Q7O2NvbG9yOiMxRjQ5
N0QiPjxvOnA+Jm5ic3A7PC9vOnA+PC9zcGFuPjwvYT48L3A+DQo8ZGl2Pg0KPGRpdiBzdHlsZT0i
Ym9yZGVyOm5vbmU7Ym9yZGVyLXRvcDpzb2xpZCAjQjVDNERGIDEuMHB0O3BhZGRpbmc6My4wcHQg
MGluIDBpbiAwaW4iPg0KPHAgY2xhc3M9Ik1zb05vcm1hbCI+PGI+PHNwYW4gc3R5bGU9ImZvbnQt
c2l6ZToxMC4wcHQ7Zm9udC1mYW1pbHk6JnF1b3Q7VGFob21hJnF1b3Q7LCZxdW90O3NhbnMtc2Vy
aWYmcXVvdDsiPkZyb206PC9zcGFuPjwvYj48c3BhbiBzdHlsZT0iZm9udC1zaXplOjEwLjBwdDtm
b250LWZhbWlseTomcXVvdDtUYWhvbWEmcXVvdDssJnF1b3Q7c2Fucy1zZXJpZiZxdW90OyI+IFZv
anRlY2ggU3pvY3MgW21haWx0bzp2c3pvY3NAcmVkaGF0LmNvbV0NCjxicj4NCjxiPlNlbnQ6PC9i
PiBUdWVzZGF5LCBKdW5lIDI2LCAyMDEyIDEwOjQ0IEFNPGJyPg0KPGI+VG86PC9iPiBlbmdpbmUt
ZGV2ZWxAb3ZpcnQub3JnPGJyPg0KPGI+Q2M6PC9iPiBDb3N0ZWEsIEdlb3JnZTsgU2Nob2VuYnJ1
biwgRHVzdGluOyBIb3BwZXIsIFJpY2t5OyBJdGFtYXIgSGVpbTxicj4NCjxiPlN1YmplY3Q6PC9i
PiBSZTogb1ZpcnQgVUkgUGx1Z2lucyBmZWF0dXJlOiBSZWFkeSBmb3IgcmV2aWV3PG86cD48L286
cD48L3NwYW4+PC9wPg0KPC9kaXY+DQo8L2Rpdj4NCjxwIGNsYXNzPSJNc29Ob3JtYWwiPjxvOnA+
Jm5ic3A7PC9vOnA+PC9wPg0KPGRpdj4NCjxwIGNsYXNzPSJNc29Ob3JtYWwiPjxzcGFuIHN0eWxl
PSJmb250LXNpemU6MTMuNXB0O2NvbG9yOmJsYWNrIj5IaSBHZW9yZ2UsPGJyPg0KPGJyPg0KSSd2
ZSBiZWVuIHRoaW5raW5nIGFib3V0IGRldmVsb3BpbmcgcGx1Z2lucyB3aXRoIEdXVC4gVGhlcmUg
YXJlIHNvbWUgaW1wb3J0YW50IGlzc3VlcyB0aGF0IG5lZWQgdG8gYmUgYWRkcmVzc2VkOjwvc3Bh
bj48c3BhbiBzdHlsZT0iY29sb3I6YmxhY2siPjxvOnA+PC9vOnA+PC9zcGFuPjwvcD4NCjxvbCBz
dGFydD0iMSIgdHlwZT0iMSI+DQo8bGkgY2xhc3M9Ik1zb05vcm1hbCIgc3R5bGU9ImNvbG9yOmJs
YWNrO21zby1tYXJnaW4tdG9wLWFsdDphdXRvO21hcmdpbi1ib3R0b206MTIuMHB0O21zby1saXN0
OmwwIGxldmVsMSBsZm8xIj4NCjxzcGFuIHN0eWxlPSJmb250LXNpemU6MTMuNXB0Ij5HV1QgYm9v
dHN0cmFwIHNlcXVlbmNlIHJlcXVpcmVzIDxlbT5wZXJtdXRhdGlvbiBzZWxlY3RvciBzY3JpcHQ8
L2VtPiAoPC9zcGFuPjxzcGFuIHN0eWxlPSJmb250LWZhbWlseTomcXVvdDtMdWNpZGEgQ29uc29s
ZSZxdW90OyI+Jmx0O3BsdWdpbkFwcGxpY2F0aW9uJmd0Oy5ub2NhY2hlLmpzPC9zcGFuPjxzcGFu
IHN0eWxlPSJmb250LXNpemU6MTMuNXB0Ij4pIHRvIGJlIGludm9rZWQgZmlyc3QuPGJyPg0KU2Vs
ZWN0b3Igc2NyaXB0IGRldGVybWluZXMgdGhlIGNvcnJlY3QgcGVybXV0YXRpb24gKDwvc3Bhbj48
c3BhbiBzdHlsZT0iZm9udC1mYW1pbHk6JnF1b3Q7THVjaWRhIENvbnNvbGUmcXVvdDsiPiZsdDto
YXNoTmFtZSZndDsuY2FjaGUuaHRtbDwvc3Bhbj48c3BhbiBzdHlsZT0iZm9udC1zaXplOjEzLjVw
dCI+KSBhbmQgZmV0Y2hlcyBpdCBhc3luY2hyb25vdXNseSBmcm9tIHRoZSBzYW1lIGxvY2F0aW9u
Ljwvc3Bhbj48bzpwPjwvbzpwPjwvbGk+PGxpIGNsYXNzPSJNc29Ob3JtYWwiIHN0eWxlPSJjb2xv
cjpibGFjazttc28tbWFyZ2luLXRvcC1hbHQ6YXV0bzttYXJnaW4tYm90dG9tOjEyLjBwdDttc28t
bGlzdDpsMCBsZXZlbDEgbGZvMSI+DQo8c3BhbiBzdHlsZT0iZm9udC1zaXplOjEzLjVwdCI+R1dU
IGJvb3RzdHJhcCBzZXF1ZW5jZSBpcyBhc3luY2hyb25vdXMgaW4gbmF0dXJlLjwvc3Bhbj48bzpw
PjwvbzpwPjwvbGk+PGxpIGNsYXNzPSJNc29Ob3JtYWwiIHN0eWxlPSJjb2xvcjpibGFjazttc28t
bWFyZ2luLXRvcC1hbHQ6YXV0bzttc28tbWFyZ2luLWJvdHRvbS1hbHQ6YXV0bzttc28tbGlzdDps
MCBsZXZlbDEgbGZvMSI+DQo8c3BhbiBzdHlsZT0iZm9udC1zaXplOjEzLjVwdCI+R1dUIFJQQyAo
PC9zcGFuPjxzcGFuIHN0eWxlPSJmb250LWZhbWlseTomcXVvdDtMdWNpZGEgQ29uc29sZSZxdW90
OyI+WE1MSHR0cFJlcXVlc3Q8L3NwYW4+PHNwYW4gc3R5bGU9ImZvbnQtc2l6ZToxMy41cHQiPikg
aXMgc3ViamVjdCB0byBTYW1lIE9yaWdpbiBQb2xpY3kgWzFdLjxicj4NClRoaXMgbWVhbnMgdGhh
dCA8aT5wbHVnaW5BcHBsaWNhdGlvbjwvaT4ncyBzZXJ2ZXItc2lkZSBjb2RlIHNob3VsZCBiZSBk
ZXBsb3llZCBvbiBvVmlydCBKQm9zcyBBUyBpbnN0YW5jZSAobmV4dCB0bw0KPC9zcGFuPjxzcGFu
IHN0eWxlPSJmb250LWZhbWlseTomcXVvdDtMdWNpZGEgQ29uc29sZSZxdW90OyI+ZW5naW5lLmVh
cjwvc3Bhbj48c3BhbiBzdHlsZT0iZm9udC1zaXplOjEzLjVwdCI+KS48L3NwYW4+PG86cD48L286
cD48L2xpPjwvb2w+DQo8cCBjbGFzcz0iTXNvTm9ybWFsIiBzdHlsZT0ibWFyZ2luLWJvdHRvbTox
Mi4wcHQiPjxzcGFuIHN0eWxlPSJmb250LXNpemU6MTMuNXB0O2NvbG9yOmJsYWNrIj48YnI+DQpH
aXZlbiB0aGVzZSBsaW1pdGF0aW9ucywgSSdkIHNheSB0aGUgcHJvY2VzcyBjb3VsZCBiZSBsaWtl
IHRoaXM6PGJyPg0KPGJyPg0KYSkgSW4gPGk+cGx1Z2luQXBwbGljYXRpb248L2k+J3MgPC9zcGFu
PjxzcGFuIHN0eWxlPSJmb250LWZhbWlseTomcXVvdDtMdWNpZGEgQ29uc29sZSZxdW90Oztjb2xv
cjpibGFjayI+RW50cnlQb2ludDwvc3Bhbj48c3BhbiBzdHlsZT0iZm9udC1zaXplOjEzLjVwdDtj
b2xvcjpibGFjayI+LCB1c2UgR1dUIEpTTkkgWzJdIHRvIHJlZ2lzdGVyIHRoZSBwbHVnaW4gdXNp
bmcgbmF0aXZlIEphdmFTY3JpcHQgY29kZS48YnI+DQo8YnI+DQombmJzcDsmbmJzcDsgWW91IGRv
bid0IG5lZWQgdG8gdXNlIDxpPmd3dC1leHBvcnRlcjwvaT4gaGVyZSwgc2luY2UgcGx1Z2luIHJl
Z2lzdHJhdGlvbiBhbmQgbG9naWMgaXMgY29tYmluZWQgaW4gb25lIHBsYWNlLjxicj4NCiZuYnNw
OyZuYnNwOyBVc2luZyBwbHVnaW4tdG8tR1dUIGRlbGVnYXRlIHBhdHRlcm4gd2l0aCA8aT5nd3Qt
ZXhwb3J0ZXI8L2k+IGlzIGFjdHVhbGx5IG1vcmUgY29tcGxpY2F0ZWQgdGhhbiBnb2luZyB3aXRo
IHBsYWluIEpTTkkuPGJyPg0KPGJyPg0KJm5ic3A7Jm5ic3A7IEZvciBleGFtcGxlOjxicj4NCjxi
cj4NCjwvc3Bhbj48c3BhbiBzdHlsZT0iZm9udC1mYW1pbHk6JnF1b3Q7THVjaWRhIENvbnNvbGUm
cXVvdDs7Y29sb3I6YmxhY2siPiZuYnNwOyZuYnNwOyBwYWNrYWdlIGNvbS5teXBsdWdpbjs8YnI+
DQo8YnI+DQombmJzcDsmbmJzcDsgcHVibGljIGNsYXNzIE15UGx1Z2luQXBwIGltcGxlbWVudHMg
Y29tLmdvb2dsZS5nd3QuY29yZS5jbGllbnQuRW50cnlQb2ludCB7PGJyPg0KPGJyPg0KJm5ic3A7
Jm5ic3A7ICZuYnNwOyAmbmJzcDtwdWJsaWMgdm9pZCB2b2lkIG9uTW9kdWxlTG9hZCgpIHs8YnI+
DQombmJzcDsmbmJzcDsgJm5ic3A7ICZuYnNwOyAmbmJzcDsgLy8gSW5pdGlhbGl6ZSBwbHVnaW4g
YXBwbGljYXRpb24sIGNhbGwgcmVnaXN0ZXJQbHVnaW4oKSB3aGVuIHJlYWR5PGJyPg0KJm5ic3A7
Jm5ic3A7ICZuYnNwOyAmbmJzcDsgJm5ic3A7IHJlZ2lzdGVyUGx1Z2luKCk7PGJyPg0KJm5ic3A7
Jm5ic3A7ICZuYnNwOyAmbmJzcDt9PGJyPg0KPGJyPg0KJm5ic3A7Jm5ic3A7ICZuYnNwOyAmbmJz
cDtwdWJsaWMgc3RhdGljIHZvaWQgdGFibGVDb250ZXh0TWVudShjb20uZ29vZ2xlLmd3dC5jb3Jl
LmNsaWVudC5KYXZhU2NyaXB0T2JqZWN0IGV2ZW50Q29udGV4dCkgezxicj4NCiZuYnNwOyZuYnNw
OyAmbmJzcDsgJm5ic3A7ICZuYnNwOyAvLyBDb25zaWRlciB1c2luZyBHV1Qgb3ZlcmxheSB0eXBl
cyBbM10gdG8gZWFzaWx5IHdvcmsgd2l0aCBKYXZhU2NyaXB0T2JqZWN0czxicj4NCiZuYnNwOyZu
YnNwOyAmbmJzcDsgJm5ic3A7fTxicj4NCjxicj4NCiZuYnNwOyZuYnNwOyAmbmJzcDsgJm5ic3A7
cHJpdmF0ZSBzdGF0aWMgbmF0aXZlIHZvaWQgcmVnaXN0ZXJQbHVnaW4oKSAvKi17PGJyPg0KJm5i
c3A7Jm5ic3A7ICZuYnNwOyAmbmJzcDsgJm5ic3A7IC8vIFJlZ2lzdGVyICdteVBsdWdpbicgaW50
byBwbHVnaW5BcGkucGx1Z2lucyBvYmplY3Q8YnI+DQombmJzcDsmbmJzcDsgJm5ic3A7ICZuYnNw
OyAmbmJzcDsgJHduZC5wbHVnaW5BcGkucGx1Z2lucy5teVBsdWdpbiA9IG15UGx1Z2luID0gezxi
cj4NCiZuYnNwOyZuYnNwOyAmbmJzcDsgJm5ic3A7ICZuYnNwOyAmbmJzcDsgJm5ic3A7dGFibGVD
b250ZXh0TWVudTogZnVuY3Rpb24oZXZlbnRDb250ZXh0KSB7PGJyPg0KJm5ic3A7Jm5ic3A7ICZu
YnNwOyAmbmJzcDsgJm5ic3A7ICZuYnNwOyAmbmJzcDsgJm5ic3A7IC8vIENhbGwgSmF2YSBzdGF0
aWMgbWV0aG9kIHRvIGhhbmRsZSB0aGlzIGV2ZW50PGJyPg0KJm5ic3A7Jm5ic3A7ICZuYnNwOyAm
bmJzcDsgJm5ic3A7ICZuYnNwOyAmbmJzcDsgJm5ic3A7IEBjb20ubXlwbHVnaW4uTXlQbHVnaW5B
cHA6OnRhYmxlQ29udGV4dE1lbnUoTGNvbS9nb29nbGUvZ3d0L2NvcmUvY2xpZW50L0phdmFTY3Jp
cHRPYmplY3Q7KShldmVudENvbnRleHQpOzxicj4NCiZuYnNwOyZuYnNwOyAmbmJzcDsgJm5ic3A7
ICZuYnNwOyAmbmJzcDsgJm5ic3A7fTxicj4NCiZuYnNwOyZuYnNwOyAmbmJzcDsgJm5ic3A7ICZu
YnNwOyB9Ozxicj4NCiZuYnNwOyZuYnNwOyAmbmJzcDsgJm5ic3A7ICZuYnNwOyAvLyBDYWxsIHRo
ZSByZWFkeSgpIGZ1bmN0aW9uIHJpZ2h0IGF3YXk8YnI+DQombmJzcDsmbmJzcDsgJm5ic3A7ICZu
YnNwOyAmbmJzcDsgJHduZC5wbHVnaW5BcGkubGlmZWN5Y2xlKG15UGx1Z2luKS5yZWFkeSgpOzxi
cj4NCiZuYnNwOyZuYnNwOyAmbmJzcDsgJm5ic3A7fS0qLzs8YnI+DQo8YnI+DQombmJzcDsmbmJz
cDsgfTwvc3Bhbj48c3BhbiBzdHlsZT0iZm9udC1zaXplOjEzLjVwdDtjb2xvcjpibGFjayI+PGJy
Pg0KPGJyPg0KYikgRGVwbG95IHRoZSA8L3NwYW4+PHNwYW4gc3R5bGU9ImZvbnQtZmFtaWx5OiZx
dW90O0x1Y2lkYSBDb25zb2xlJnF1b3Q7O2NvbG9yOmJsYWNrIj4mbHQ7cGx1Z2luQXBwbGljYXRp
b24mZ3Q7Lndhcjwvc3Bhbj48c3BhbiBzdHlsZT0iZm9udC1zaXplOjEzLjVwdDtjb2xvcjpibGFj
ayI+IGZpbGUgb24gSkJvc3MgQVMgaW5zdGFuY2UsIGUuZy4NCjwvc3Bhbj48c3BhbiBzdHlsZT0i
Zm9udC1mYW1pbHk6JnF1b3Q7THVjaWRhIENvbnNvbGUmcXVvdDs7Y29sb3I6YmxhY2siPiZsdDtK
Qk9TU19IT01FJmd0Oy9zdGFuZGFsb25lL2RlcGxveW1lbnRzPC9zcGFuPjxzcGFuIHN0eWxlPSJm
b250LXNpemU6MTMuNXB0O2NvbG9yOmJsYWNrIj4uPGJyPg0KPGJyPg0KJm5ic3A7Jm5ic3A7IFRo
aXMgbWFrZXMgPGk+cGx1Z2luQXBwbGljYXRpb248L2k+J3MgR1dUIFJQQyBzZXJ2bGV0KHMpIGFj
Y2Vzc2libGUgZnJvbSB0aGUgc2FtZSBvcmlnaW4gKHByb3RvY29sLCBkb21haW4sIHBvcnQpLjxi
cj4NCjxicj4NCmMpIE1vZGlmaWNhdGlvbiBvZiBwbHVnaW4gbGlmZWN5Y2xlIHN0ZXAgIzU6PGJy
Pg0KPGJyPg0KJm5ic3A7Jm5ic3A7IEluc3RlYWQgb2YgZW1iZWRkaW5nIDwvc3Bhbj48c3BhbiBz
dHlsZT0iZm9udC1mYW1pbHk6JnF1b3Q7THVjaWRhIENvbnNvbGUmcXVvdDs7Y29sb3I6YmxhY2si
PiZsdDtwbHVnaW5BcHBsaWNhdGlvbiZndDsubm9jYWNoZS5qczwvc3Bhbj48c3BhbiBzdHlsZT0i
Zm9udC1zaXplOjEzLjVwdDtjb2xvcjpibGFjayI+IGNvbnRlbnQgaW50byBXZWJBZG1pbiBIVE1M
IHBhZ2UsIGp1c3QgZW1iZWQgdGhlIGxpbmsgdG8gaXQsIGUuZy4NCjwvc3Bhbj48c3BhbiBzdHls
ZT0iZm9udC1mYW1pbHk6JnF1b3Q7THVjaWRhIENvbnNvbGUmcXVvdDs7Y29sb3I6YmxhY2siPmh0
dHAocyk6Ly8xMjcuMC4wLjE6Jmx0O3BvcnQmZ3Q7L3BhdGgvdG8vJmx0O3BsdWdpbkFwcGxpY2F0
aW9uJmd0Oy5ub2NhY2hlLmpzPC9zcGFuPjxzcGFuIHN0eWxlPSJmb250LXNpemU6MTMuNXB0O2Nv
bG9yOmJsYWNrIj48YnI+DQo8YnI+DQpkKSBNb2RpZmljYXRpb24gb2YgcGx1Z2luIGxpZmVjeWNs
ZSBzdGVwICM2Ojxicj4NCjxicj4NCiZuYnNwOyZuYnNwOyBEdXJpbmcgV2ViQWRtaW4gc3RhcnR1
cCwgZm9yIGVhY2ggcGx1Z2luIHRoYXQgaXMgc3VwcG9zZWQgdG8gYmUgbG9hZGVkIHJlbW90ZWx5
LCBjcmVhdGUgYW4NCjwvc3Bhbj48c3BhbiBzdHlsZT0iZm9udC1mYW1pbHk6JnF1b3Q7THVjaWRh
IENvbnNvbGUmcXVvdDs7Y29sb3I6YmxhY2siPiZsdDtpZnJhbWUmZ3Q7PC9zcGFuPjxzcGFuIHN0
eWxlPSJmb250LXNpemU6MTMuNXB0O2NvbG9yOmJsYWNrIj4gdGhhdCB3aWxsIGZldGNoIHRoZSBw
bHVnaW4gYXN5bmNocm9ub3VzbHkuPGJyPg0KPGJyPg0KJm5ic3A7Jm5ic3A7IFRoZSA8L3NwYW4+
PHNwYW4gc3R5bGU9ImZvbnQtZmFtaWx5OiZxdW90O0x1Y2lkYSBDb25zb2xlJnF1b3Q7O2NvbG9y
OmJsYWNrIj4mbHQ7aWZyYW1lJmd0Ozwvc3Bhbj48c3BhbiBzdHlsZT0iZm9udC1zaXplOjEzLjVw
dDtjb2xvcjpibGFjayI+IGlzIHJlcXVpcmVkIGluIG9yZGVyIGZvcg0KPC9zcGFuPjxzcGFuIHN0
eWxlPSJmb250LWZhbWlseTomcXVvdDtMdWNpZGEgQ29uc29sZSZxdW90Oztjb2xvcjpibGFjayI+
Jmx0O3BsdWdpbkFwcGxpY2F0aW9uJmd0Oy5ub2NhY2hlLmpzPC9zcGFuPjxzcGFuIHN0eWxlPSJm
b250LXNpemU6MTMuNXB0O2NvbG9yOmJsYWNrIj4gdG8gYXBwZWFyIGZyb20gZGlmZmVyZW50ICg8
aT5wbHVnaW5BcHBsaWNhdGlvbjwvaT4tc3BlY2lmaWMpIGRvbWFpbiB0aGFuIFdlYkFkbWluIEhU
TUwgcGFnZS48YnI+DQo8YnI+DQombmJzcDsmbmJzcDsgVGhpcyB3YXksIGZldGNoaW5nIHBlcm11
dGF0aW9uICg8L3NwYW4+PHNwYW4gc3R5bGU9ImZvbnQtZmFtaWx5OiZxdW90O0x1Y2lkYSBDb25z
b2xlJnF1b3Q7O2NvbG9yOmJsYWNrIj4mbHQ7aGFzaE5hbWUmZ3Q7LmNhY2hlLmh0bWw8L3NwYW4+
PHNwYW4gc3R5bGU9ImZvbnQtc2l6ZToxMy41cHQ7Y29sb3I6YmxhY2siPikgZmlsZXMsIHdoaWNo
IGFyZSByZWxhdGl2ZSB0bw0KPC9zcGFuPjxzcGFuIHN0eWxlPSJmb250LWZhbWlseTomcXVvdDtM
dWNpZGEgQ29uc29sZSZxdW90Oztjb2xvcjpibGFjayI+Jmx0O3BsdWdpbkFwcGxpY2F0aW9uJmd0
Oy5ub2NhY2hlLmpzPC9zcGFuPjxzcGFuIHN0eWxlPSJmb250LXNpemU6MTMuNXB0O2NvbG9yOmJs
YWNrIj4sIHdpbGwgd29yayBvdXQtb2YtdGhlLWJveC48YnI+DQo8YnI+DQo8YnI+DQpHZW9yZ2Us
IHBsZWFzZSBsZXQgbWUga25vdyB3aGF0IHlvdSB0aGluaywgYW5kIEkgd2lsbCB1cGRhdGUgVUkg
UGx1Z2lucyB3aWtpIGFjY29yZGluZ2x5Ljxicj4NCjxicj4NClZvanRlY2g8YnI+DQo8YnI+DQo8
YnI+DQpbMV0gPGEgaHJlZj0iaHR0cDovL2VuLndpa2lwZWRpYS5vcmcvd2lraS9TYW1lX29yaWdp
bl9wb2xpY3kiPmh0dHA6Ly9lbi53aWtpcGVkaWEub3JnL3dpa2kvU2FtZV9vcmlnaW5fcG9saWN5
PC9hPjxicj4NClsyXSA8YSBocmVmPSJodHRwczovL2RldmVsb3BlcnMuZ29vZ2xlLmNvbS93ZWIt
dG9vbGtpdC9kb2MvbGF0ZXN0L0Rldkd1aWRlQ29kaW5nQmFzaWNzSlNOSSI+DQpodHRwczovL2Rl
dmVsb3BlcnMuZ29vZ2xlLmNvbS93ZWItdG9vbGtpdC9kb2MvbGF0ZXN0L0Rldkd1aWRlQ29kaW5n
QmFzaWNzSlNOSTwvYT48YnI+DQpbM10gPGEgaHJlZj0iaHR0cHM6Ly9kZXZlbG9wZXJzLmdvb2ds
ZS5jb20vd2ViLXRvb2xraXQvZG9jL2xhdGVzdC9EZXZHdWlkZUNvZGluZ0Jhc2ljc092ZXJsYXki
Pg0KaHR0cHM6Ly9kZXZlbG9wZXJzLmdvb2dsZS5jb20vd2ViLXRvb2xraXQvZG9jL2xhdGVzdC9E
ZXZHdWlkZUNvZGluZ0Jhc2ljc092ZXJsYXk8L2E+PGJyPg0KPGJyPg0KPC9zcGFuPjxzcGFuIHN0
eWxlPSJjb2xvcjpibGFjayI+PG86cD48L286cD48L3NwYW4+PC9wPg0KPGRpdiBjbGFzcz0iTXNv
Tm9ybWFsIiBhbGlnbj0iY2VudGVyIiBzdHlsZT0idGV4dC1hbGlnbjpjZW50ZXIiPjxzcGFuIHN0
eWxlPSJjb2xvcjpibGFjayI+DQo8aHIgc2l6ZT0iMiIgd2lkdGg9IjEwMCUiIGFsaWduPSJjZW50
ZXIiIGlkPSJ6d2NociI+DQo8L3NwYW4+PC9kaXY+DQo8cCBjbGFzcz0iTXNvTm9ybWFsIiBzdHls
ZT0ibWFyZ2luLWJvdHRvbToxMi4wcHQiPjxzcGFuIHN0eWxlPSJjb2xvcjpibGFjayI+PGJyPg0K
RnJvbTogJnF1b3Q7R2VvcmdlIENvc3RlYSZxdW90OyAmbHQ7PGEgaHJlZj0ibWFpbHRvOkdlb3Jn
ZS5Db3N0ZWFAbmV0YXBwLmNvbSI+R2VvcmdlLkNvc3RlYUBuZXRhcHAuY29tPC9hPiZndDs8YnI+
DQpUbzogJnF1b3Q7Vm9qdGVjaCBTem9jcyZxdW90OyAmbHQ7PGEgaHJlZj0ibWFpbHRvOnZzem9j
c0ByZWRoYXQuY29tIj52c3pvY3NAcmVkaGF0LmNvbTwvYT4mZ3Q7LCA8YSBocmVmPSJtYWlsdG86
ZW5naW5lLWRldmVsQG92aXJ0Lm9yZyI+DQplbmdpbmUtZGV2ZWxAb3ZpcnQub3JnPC9hPjxicj4N
CkNjOiAmcXVvdDtEdXN0aW4gU2Nob2VuYnJ1biZxdW90OyAmbHQ7PGEgaHJlZj0ibWFpbHRvOkR1
c3Rpbi5TY2hvZW5icnVuQG5ldGFwcC5jb20iPkR1c3Rpbi5TY2hvZW5icnVuQG5ldGFwcC5jb208
L2E+Jmd0OywgJnF1b3Q7Umlja3kgSG9wcGVyJnF1b3Q7ICZsdDs8YSBocmVmPSJtYWlsdG86Umlj
a3kuSG9wcGVyQG5ldGFwcC5jb20iPlJpY2t5LkhvcHBlckBuZXRhcHAuY29tPC9hPiZndDssICZx
dW90O0l0YW1hciBIZWltJnF1b3Q7ICZsdDs8YSBocmVmPSJtYWlsdG86aWhlaW1AcmVkaGF0LmNv
bSI+aWhlaW1AcmVkaGF0LmNvbTwvYT4mZ3Q7PGJyPg0KU2VudDogTW9uZGF5LCBKdW5lIDI1LCAy
MDEyIDk6MTE6MzMgUE08YnI+DQpTdWJqZWN0OiBSRTogb1ZpcnQgVUkgUGx1Z2lucyBmZWF0dXJl
OiBSZWFkeSBmb3IgcmV2aWV3PGJyPg0KPGJyPg0KVGhhbmtzIFZvanRlY2guPGJyPg0KPGJyPg0K
U2luY2UgdGhlIHBsdWdpbnMgYXJlIGVtYmVkZGVkIGludG8gdGhlIFdlYkFkbWluIEhUTUwgcGFn
ZSwgdGhhdCBzZWVtcyB0byBzaW1wbGlmeSB0aGluZ3M7IG5vIGV4dGVybmFsIHdlYiBzZXJ2aWNl
IGlzIG5lZWRlZC4gJm5ic3A7VGhpcyBhcHByb2FjaCB0aWVzIGludG8gdGhlIGlzc3VlIG92ZXIg
dGhlIGZyZWVkb20gdG8gZGVjaWRlIHdoaWNoIHRlY2hub2xvZ3kgdG8gdXNlIHdoZW4gZGV2ZWxv
cGluZyBhIHBsdWdpbi4gJm5ic3A7V2hpbGUgSSBhZ3JlZSB0aGF0DQogalF1ZXJ5IGlzIGJlc3Qg
Zm9yIHNpbXBsZSBkaWFsb2dzLCBhIHdpemFyZC1kcml2ZW4gd29ya2Zsb3cgaXMgZWFzaWVyIHRv
IGRldmVsb3AgaW4gR1dULiAmbmJzcDs8YnI+DQo8YnI+DQpGb3IgZXhhbXBsZSwgaWYgSSB3YW50
IHRvIHN0ZXAgYSB1c2VyIHRocm91Z2ggdGhlIHByb2Nlc3Mgb2YgY3JlYXRpbmcgYSBuZXcgc3Rv
cmFnZSBkb21haW4gSSB3b3VsZCBsaWtlIHRvIHByb3ZpZGUgYSB3b3JrZmxvdyB0byBzZWxlY3Qg
YSBzdG9yYWdlIGFycmF5LCBwcm92aWRlIGNyZWRlbnRpYWxzLCBhbmQgY29uZmlndXJlIHRoZSBk
ZXRhaWxzIG9mIHRoZSBORlMgZXhwb3J0LiAmbmJzcDtUaGlzIHdvcmtmbG93IGNvdWxkIHByZXN1
bWFibHkgaGF2ZSBhDQogR1dULVJQQyBtZWNoYW5pc20gdGhhdCByZWxpZXMgb24gc29tZSBhZGRp
dGlvbmFsIGxpYnJhcmllcyBvbiB0aGUgYmFja2VuZCAobGlicmFyaWVzIHRoYXQgYWxsb3cgbWUg
dG8gY29tbXVuaWNhdGUgd2l0aCB0aGUgc3RvcmFnZSBhcnJheSkuICZuYnNwO1VzaW5nIHRoZSBH
V1QtRXhwb3J0ZXIsIEkgY291bGQgZXhwb3J0IHRoZSBjbGFzc2VzIHRoYXQgd291bGQgZGlzcGxh
eSB0aGUgd29ya2Zsb3cgd2hpY2ggd291bGQgdGhlbiBnZXQgbGF1bmNoZWQgYXMNCiBteSBleHRl
bnNpb24gaXMgc2VsZWN0ZWQuICZuYnNwO1lvdSBzYWlkIHRoYXQgSSB3b3VsZCBoYXZlIG15IG9W
aXJ0IFVJIHBsdWdpbiBkZXBlbmQgb24gbXkgY29tcGlsZWQgJ3BsdWdpbiBzdXBwb3J0IGFwcGxp
Y2F0aW9uJy4gJm5ic3A7TXkgY29tcGlsZWQgcGx1Z2luIHN1cHBvcnQgYXBwbGljYXRpb24gd291
bGQgbm9ybWFsbHkgYmUgYSB3YXIgZmlsZSBjb250YWluaW5nIG15IGNvbXBpbGVkIEdXVCBjb2Rl
IGFuZCBhIHdlYi1pbmYgZm9sZGVyIGNvbnRhaW5pbmcNCiBteSBsaWJyYXJpZXMuICZuYnNwO0lz
IHRoZSBwbHVnaW4gZGVwZW5kaW5nIG9uIHRoZSB3YXIgZmlsZT8gJm5ic3A7SXMgdGhhdCB3aGF0
IEkgc3BlY2lmeT88YnI+DQo8YnI+DQotR2VvcmdlPGJyPg0KPGJyPg0KLS0tLS1PcmlnaW5hbCBN
ZXNzYWdlLS0tLS08YnI+DQpGcm9tOiBWb2p0ZWNoIFN6b2NzIDxhIGhyZWY9Im1haWx0bzpbbWFp
bHRvOnZzem9jc0ByZWRoYXQuY29tXSI+W21haWx0bzp2c3pvY3NAcmVkaGF0LmNvbV08L2E+DQo8
YnI+DQpTZW50OiBNb25kYXksIEp1bmUgMjUsIDIwMTIgMToxMiBQTTxicj4NClRvOiBDb3N0ZWEs
IEdlb3JnZTsgPGEgaHJlZj0ibWFpbHRvOmVuZ2luZS1kZXZlbEBvdmlydC5vcmciPmVuZ2luZS1k
ZXZlbEBvdmlydC5vcmc8L2E+PGJyPg0KQ2M6IFNjaG9lbmJydW4sIER1c3RpbjsgSG9wcGVyLCBS
aWNreTsgSXRhbWFyIEhlaW08YnI+DQpTdWJqZWN0OiBSZTogb1ZpcnQgVUkgUGx1Z2lucyBmZWF0
dXJlOiBSZWFkeSBmb3IgcmV2aWV3PGJyPg0KPGJyPg0KSGkgR2VvcmdlLDxicj4NCjxicj4NCnRo
YW5rcyBmb3IgeW91ciBmZWVkYmFjay4gUGxlYXNlIGZpbmQgbXkgYW5zd2VycyBiZWxvdy48YnI+
DQo8YnI+DQo8bzpwPjwvbzpwPjwvc3Bhbj48L3A+DQo8cCBjbGFzcz0iTXNvTm9ybWFsIj48c3Bh
biBzdHlsZT0iY29sb3I6YmxhY2siPjEpIEFyZSB0aGUgcGx1Z2lucyBob3N0ZWQgYnkgdGhlIHNh
bWUgamJvc3Mgc2VydmVyIHRoYXQgaG9zdHMgdGhlIGVuZ2luZT8gJm5ic3A7SXQgd291bGQgYXBw
ZWFyIHRoZSBhbnN3ZXIgaXMgeWVzIGFuZCB0aGF0IG5vIHNlcGFyYXRlIGNvbnRhaW5lciBpcyBy
ZXF1aXJlZCBmb3IgdGhlIHBsdWdpbnMuPGJyPg0KPGJyPg0KSW4gc2hvcnQsIHllcy48bzpwPjwv
bzpwPjwvc3Bhbj48L3A+DQo8cCBjbGFzcz0iTXNvTm9ybWFsIiBzdHlsZT0ibWFyZ2luLWJvdHRv
bToxMi4wcHQiPjxzcGFuIHN0eWxlPSJjb2xvcjpibGFjayI+PGJyPg0KPGJyPg0KUGx1Z2lucywg
YWxvbmcgd2l0aCB0aGVpciBjb25maWd1cmF0aW9uIGFuZCAzcmQgcGFydHkgZGVwZW5kZW5jaWVz
LCBhcmUgbWVhbnQgdG8gYmUgZW1iZWRkZWQgaW50byBmaW5hbCBXZWJBZG1pbiBIVE1MIHBhZ2Us
IHNlZSBbaHR0cDovL3d3dy5vdmlydC5vcmcvd2lraS9GZWF0dXJlcy9VSVBsdWdpbnMjUGx1Z2lu
X2xpZmVjeWNsZV0gc3RlcCAjNS4NCjxicj4NCkpCb3NzIEFTIGluc3RhbmNlIHNlcnZlcyBXZWJB
ZG1pbiBIVE1MIHBhZ2UgKFdlYmFkbWluRHluYW1pY0hvc3RpbmdTZXJ2bGV0KSwgYWxvbmcgd2l0
aCBwcm92aWRpbmcgR1dUIFJQQyBhbmQgUkVTVCBlbmRwb2ludHMgdGhhdCBkZWxlZ2F0ZSB0byBF
bmdpbmUgYnVzaW5lc3MgbG9naWMgdGhyb3VnaCBFSkIgQmFja2VuZExvY2FsIGludGVyZmFjZS48
YnI+DQo8YnI+DQpIb3dldmVyLCBwbHVnaW5zIGFyZSBub3QgJ2hvc3RlZCcgaW4gYSB0eXBpY2Fs
IHNlbnNlIC0gV2ViYWRtaW5EeW5hbWljSG9zdGluZ1NlcnZsZXQgcmVhZHMgYW5kIGVtYmVkcyBh
bGwgcGx1Z2luIGRhdGEgZGlyZWN0bHkgaW50byBmaW5hbCBXZWJBZG1pbiBIVE1MIHBhZ2UuPGJy
Pg0KPGJyPg0KPG86cD48L286cD48L3NwYW4+PC9wPg0KPHAgY2xhc3M9Ik1zb05vcm1hbCI+PHNw
YW4gc3R5bGU9ImNvbG9yOmJsYWNrIj4yKSBEb2VzIGVhY2ggcGx1Z2luIG1hcCB0byBhIHVuaXF1
ZSBleHRlbnNpb24gd2l0aGluIFdlYkFkbWluPyAmbmJzcDtZb3VyIGV4YW1wbGUgc2hvd3MgdGhh
dCBJIGNhbiBleHRlbmQgdGhlIFZNIHRhYmxlIHRvIGhhdmUgYSAmcXVvdDtTaG93IFZNIG5hbWUg
YW5kIGVkaXQgVk0mcXVvdDsgY29udGV4dC1zZW5zaXRpdmUgZXh0ZW5zaW9uLiAmbmJzcDtUaGlz
IGlzIG5hbWVkIHBsdWdpbkFwaS5wbHVnaW5zLm15UGx1Z2luLg0KICZuYnNwO0NhbiBJIHNhZmVs
eSBhc3N1bWUgdGhhdCB0aGlzIGlzIHBlciBleHRlbnNpb24/ICZuYnNwO0kgd291bGQgaGF2ZSBw
bHVnaW5BcGkucGx1Z2lucy5teVBsdWdpbjIgZm9yIGV4dGVuZGluZyBhIHN0b3JhZ2UgZG9tYWlu
Pzxicj4NCjxicj4NCkV4dGVuc2lvbiBwb2ludHMgYXJlIHJlcHJlc2VudGVkIGJ5IGFwcGxpY2F0
aW9uIGV2ZW50cywgdHJpZ2dlcmVkIGJ5IFdlYkFkbWluIGFuZCBjb25zdW1lZCBieSBwbHVnaW5z
LiBGb3IgZXhhbXBsZSwgJ3RhYmxlQ29udGV4dE1lbnUnIGV2ZW50IGdldHMgdHJpZ2dlcmVkIHdo
ZW4gYSB0YWJsZSBjb250ZXh0IG1lbnUgaXMgYWJvdXQgdG8gYmUgc2hvd24gdG8gdGhlIHVzZXIs
IHdoaWNoIGdpdmVzIHBsdWdpbnMgdGhlIGFiaWxpdHkgdG8gZG8gc29tZXRoaW5nDQogY3VzdG9t
IHdpdGggdGhlIGNvbnRleHQgbWVudSBiZWZvcmUgaXQncyBzaG93bi48bzpwPjwvbzpwPjwvc3Bh
bj48L3A+DQo8cCBjbGFzcz0iTXNvTm9ybWFsIiBzdHlsZT0ibWFyZ2luLWJvdHRvbToxMi4wcHQi
PjxzcGFuIHN0eWxlPSJjb2xvcjpibGFjayI+PGJyPg0KPGJyPg0KVGhlcmUgY2FuIGJlIG11bHRp
cGxlIHBsdWdpbnMgaGFuZGxpbmcgdGhlIHNhbWUgZXZlbnQgKGV4dGVuc2lvbiBwb2ludCkuIFlv
dSBjYW4gaGF2ZSB0d28gcGx1Z2lucywgc2F5ICdwbHVnaW5BcGkucGx1Z2lucy5PbmUnIGFuZCAn
cGx1Z2luQXBpLnBsdWdpbnMuVHdvJywgZWFjaCBwcm92aWRpbmcgJ3RhYmxlQ29udGV4dE1lbnUn
IGZ1bmN0aW9uIGZvciBoYW5kbGluZyB0aGUgYWJvdmUgbWVudGlvbmVkIGV2ZW50LiBXZWJBZG1p
biB3aWxsIGludm9rZQ0KIGFsbCBwbHVnaW5zIGZvciB0aGUgZ2l2ZW4gZXZlbnQuPGJyPg0KPGJy
Pg0KVG8gYW5zd2VyIHlvdXIgcXVlc3Rpb24sIGluIG9yZGVyIHRvIGhhbmRsZSBYIGV2ZW50cyAo
ZXh0ZW5zaW9uIHBvaW50cyksIHlvdSBkb24ndCBuZWVkIHRvIHdyaXRlIFggcGx1Z2lucy4gWW91
IGNhbiB3cml0ZSBvbmUgcGx1Z2luIHRoYXQgaGFuZGxlcyBYIGV2ZW50cy48YnI+DQo8YnI+DQo8
bzpwPjwvbzpwPjwvc3Bhbj48L3A+DQo8cCBjbGFzcz0iTXNvTm9ybWFsIj48c3BhbiBzdHlsZT0i
Y29sb3I6YmxhY2siPjMpIEluc3RlYWQgb2YgbGF1bmNoaW5nIGEgalF1ZXJ5IGRpYWxvZywgY2Fu
IEkgcG9pbnQgdG8gYSBjb21waWxlZCBHV1QgaHRtbCBmaWxlIHRvIGRpc3BsYXkgYSBkaWFsb2cg
dGhhdCBmaXRzIG15IG5lZWRzPzxicj4NCjxicj4NCllvdSBjYW4gZG8gYW55dGhpbmcgeW91IHdh
bnQgaW4geW91ciBwbHVnaW4gZXZlbnQgaGFuZGxlciBmdW5jdGlvbi4gU2hvdyBhIGpRdWVyeSBV
SSBkaWFsb2csIG1ha2Ugb1ZpcnQgUkVTVCBBUEkgcmVxdWVzdCwgY2FsbCBhcmJpdHJhcnkgcmVt
b3RlIHNlcnZlciB1c2luZyBjcm9zcy1kb21haW4gdGVjaG5pcXVlIGxpa2UgSlNPTlAgWzFdIG9y
IENPUlMgWzJdLCBldGMuIFBsdWdpbiBhdXRob3JzIGFyZSBmcmVlIHRvIGRlY2lkZSBpZiB0aGV5
IHdhbnQNCiB0byByZWx5IG9uIDNyZCBwYXJ0eSBKYXZhU2NyaXB0IGxpYnJhcmllcywgb3IgaWYg
dGhleSB3YW50IHRvIHdyaXRlIGVudGlyZSBwbHVnaW4gY29kZSBieSB0aGVtc2VsdmVzLjxvOnA+
PC9vOnA+PC9zcGFuPjwvcD4NCjxwIGNsYXNzPSJNc29Ob3JtYWwiIHN0eWxlPSJtYXJnaW4tYm90
dG9tOjEyLjBwdCI+PHNwYW4gc3R5bGU9ImNvbG9yOmJsYWNrIj48YnI+DQo8YnI+DQpJbiBteSBv
cGluaW9uLCB0b29scyBsaWtlIGpRdWVyeSBhcmUgZmFyIG1vcmUgZWxlZ2FudCBmb3IgaGFuZGxp
bmcgc2ltcGxlIHRoaW5ncyBzdWNoIGFzIFVJIGRpYWxvZ3MuIEJ1dCBpZiB5b3UgcmVhbGx5IHdh
bnQgdG8gdXNlIEdXVCBmb3IgdGhpcyBwdXJwb3NlLCBJIHN1Z2dlc3QgZm9sbG93aW5nIGFwcHJv
YWNoOjxicj4NCjxicj4NCmEsIGRldmVsb3AgYSAncGx1Z2luIHN1cHBvcnQgYXBwbGljYXRpb24n
IGluIEdXVCwgd2hpY2ggaW1wbGVtZW50cyB0aGUgbmVjZXNzYXJ5IGRpYWxvZyBmdW5jdGlvbmFs
aXR5IGIsIGV4cG9ydCBpdHMgbWFpbiAoZS5nLiBkaWFsb2cgaGFuZGxpbmcpIGNsYXNzZXMgZm9y
IHVzZSBpbiBuYXRpdmUgSmF2YVNjcmlwdCB0aHJvdWdoIGd3dC1leHBvcnRlciBbM10gYywgaGF2
ZSB5b3VyIG9WaXJ0IFVJIHBsdWdpbiBkZXBlbmQgb24geW91ciBjb21waWxlZA0KICdwbHVnaW4g
c3VwcG9ydCBhcHBsaWNhdGlvbicgKHRoaXMgd2lsbCBjYXVzZSB5b3VyICdwbHVnaW4gc3VwcG9y
dCBhcHBsaWNhdGlvbicgdG8gYmUgY2FsbGVkIGR1cmluZyBXZWJBZG1pbiBzdGFydHVwKSBkLCBp
biB5b3VyIG9WaXJ0IFVJIHBsdWdpbiwgaW52b2tlICdwbHVnaW4gc3VwcG9ydCBhcHBsaWNhdGlv
bicgZnVuY3Rpb25hbGl0eSB0aHJvdWdoIGV4cG9ydGVkIGNsYXNzZXMgKHBsdWdpbiAtJmd0OyBH
V1QgZGVsZWdhdGUgcGF0dGVybik8YnI+DQo8YnI+DQo8bzpwPjwvbzpwPjwvc3Bhbj48L3A+DQo8
cCBjbGFzcz0iTXNvTm9ybWFsIj48c3BhbiBzdHlsZT0iY29sb3I6YmxhY2siPjQpIElzIHNlc3Np
b24gaW5mbyBwYXNzZWQgaW50byB0aGUgcGx1Z2luIHNvIHRoYXQgSSBjYW4gaW52b2tlIEFQSXMg
aW50byB0aGUgZW5naW5lPyAmbmJzcDtUbyBwb3dlciBvbiBhIFZNIGZvciBpbnN0YW5jZT8gJm5i
c3A7T3IgdG8gbW91bnQgYSBuZXcgTkZTIHN0b3JhZ2UgZG9tYWluPzxicj4NCjxicj4NClllcywg
dGhpcyBzaG91bGQgYmUgcGFydCBvZiBbaHR0cDovL3d3dy5vdmlydC5vcmcvd2lraS9GZWF0dXJl
cy9VSVBsdWdpbnMjR2xvYmFsX0FQSV9mdW5jdGlvbnNdICZxdW90O1BsdWdpbiB1dGlsaXR5IGZ1
bmN0aW9ucyZxdW90OyAoZ2xvYmFsIEFQSSkuPG86cD48L286cD48L3NwYW4+PC9wPg0KPHAgY2xh
c3M9Ik1zb05vcm1hbCIgc3R5bGU9Im1hcmdpbi1ib3R0b206MTIuMHB0Ij48c3BhbiBzdHlsZT0i
Y29sb3I6YmxhY2siPjxicj4NCjxicj4NCllvdXIgcGx1Z2luIG1pZ2h0IGFjY2VzcyB1c2VyIHNl
c3Npb24gaW5mb3JtYXRpb24gaW4gdGhlIGZvbGxvd2luZyB3YXk6IHBsdWdpbkFwaS51dGlsKCku
dXNlckluZm8oKS4qIChyZXBsYWNlICogd2l0aCBpZCgpLCBuYW1lKCksIGRvbWFpbigpLCBldGMu
KTxicj4NCjxicj4NCkFzIHlvdSBwb2ludGVkIG91dCwgdGhpcyBjb3VsZCBiZSB1c2VkIHRvIGF1
dGhlbnRpY2F0ZSBvVmlydCBSRVNUIEFQSSByZXF1ZXN0cyBtYWRlIGZyb20geW91ciBwbHVnaW4g
Y29kZS48YnI+DQo8YnI+DQo8bzpwPjwvbzpwPjwvc3Bhbj48L3A+DQo8cCBjbGFzcz0iTXNvTm9y
bWFsIj48c3BhbiBzdHlsZT0iY29sb3I6YmxhY2siPkJUVywgdGhlIGxpbmsgdG8gdGhlIG9yaWdp
bmFsIGRlc2lnbiBub3RlcyBvbiB0aGUgd2lraSBkb2Vzbid0IHdvcmsuPGJyPg0KPGJyPg0KVGhp
cyBpcyBzdHJhbmdlLCBbaHR0cDovL3JoZXZtZi5wYWQuZW5naW5lZXJpbmcucmVkaGF0LmNvbS82
OF0gaGFzIGl0cyB2aXNpYmlsaXR5IHNldCB0byAmcXVvdDtQdWJsaWMgKEFsbG93IEludGVybmV0
IGd1ZXN0cykmcXVvdDsgLi4uIERvZXMgYW55Ym9keSBrbm93IHdoeSB0aGlzIGRvZXNuJ3Qgd29y
az88bzpwPjwvbzpwPjwvc3Bhbj48L3A+DQo8cCBjbGFzcz0iTXNvTm9ybWFsIj48c3BhbiBzdHls
ZT0iY29sb3I6YmxhY2siPjxicj4NCjxicj4NCjxicj4NClZvanRlY2g8YnI+DQo8YnI+DQo8YnI+
DQpbMV0gPGEgaHJlZj0iaHR0cDovL2VuLndpa2lwZWRpYS5vcmcvd2lraS9KU09OUCI+aHR0cDov
L2VuLndpa2lwZWRpYS5vcmcvd2lraS9KU09OUDwvYT48YnI+DQpbMl0gPGEgaHJlZj0iaHR0cDov
L2VuLndpa2lwZWRpYS5vcmcvd2lraS9Dcm9zcy1vcmlnaW5fcmVzb3VyY2Vfc2hhcmluZyI+aHR0
cDovL2VuLndpa2lwZWRpYS5vcmcvd2lraS9Dcm9zcy1vcmlnaW5fcmVzb3VyY2Vfc2hhcmluZzwv
YT48YnI+DQpbM10gPGEgaHJlZj0iaHR0cDovL2NvZGUuZ29vZ2xlLmNvbS9wL2d3dC1leHBvcnRl
ci8iPmh0dHA6Ly9jb2RlLmdvb2dsZS5jb20vcC9nd3QtZXhwb3J0ZXIvPC9hPjxicj4NCjxicj4N
Cjxicj4NCi0tLS0tIE9yaWdpbmFsIE1lc3NhZ2UgLS0tLS08YnI+DQpGcm9tOiAmcXVvdDtHZW9y
Z2UgQ29zdGVhJnF1b3Q7ICZsdDs8YSBocmVmPSJtYWlsdG86R2VvcmdlLkNvc3RlYUBuZXRhcHAu
Y29tIj5HZW9yZ2UuQ29zdGVhQG5ldGFwcC5jb208L2E+Jmd0Ozxicj4NClRvOiAmcXVvdDtWb2p0
ZWNoIFN6b2NzJnF1b3Q7ICZsdDs8YSBocmVmPSJtYWlsdG86dnN6b2NzQHJlZGhhdC5jb20iPnZz
em9jc0ByZWRoYXQuY29tPC9hPiZndDssIDxhIGhyZWY9Im1haWx0bzplbmdpbmUtZGV2ZWxAb3Zp
cnQub3JnIj4NCmVuZ2luZS1kZXZlbEBvdmlydC5vcmc8L2E+PGJyPg0KQ2M6ICZxdW90O0R1c3Rp
biBTY2hvZW5icnVuJnF1b3Q7ICZsdDs8YSBocmVmPSJtYWlsdG86RHVzdGluLlNjaG9lbmJydW5A
bmV0YXBwLmNvbSI+RHVzdGluLlNjaG9lbmJydW5AbmV0YXBwLmNvbTwvYT4mZ3Q7LCAmcXVvdDtS
aWNreSBIb3BwZXImcXVvdDsgJmx0OzxhIGhyZWY9Im1haWx0bzpSaWNreS5Ib3BwZXJAbmV0YXBw
LmNvbSI+Umlja3kuSG9wcGVyQG5ldGFwcC5jb208L2E+Jmd0Ozxicj4NClNlbnQ6IE1vbmRheSwg
SnVuZSAyNSwgMjAxMiAzOjA5OjQzIFBNPGJyPg0KU3ViamVjdDogUkU6IG9WaXJ0IFVJIFBsdWdp
bnMgZmVhdHVyZTogUmVhZHkgZm9yIHJldmlldzxicj4NCjxicj4NCkhpIFZvanRlY2gsPGJyPg0K
PGJyPg0KSSBoYXZlIGEgZmV3IHF1ZXN0aW9ucyBvbiB0aGlzIGZlYXR1cmUuPGJyPg0KPGJyPg0K
MSkgQXJlIHRoZSBwbHVnaW5zIGhvc3RlZCBieSB0aGUgc2FtZSBqYm9zcyBzZXJ2ZXIgdGhhdCBo
b3N0cyB0aGUgZW5naW5lPyAmbmJzcDtJdCB3b3VsZCBhcHBlYXIgdGhlIGFuc3dlciBpcyB5ZXMg
YW5kIHRoYXQgbm8gc2VwYXJhdGUgY29udGFpbmVyIGlzIHJlcXVpcmVkIGZvciB0aGUgcGx1Z2lu
cy48YnI+DQoyKSBEb2VzIGVhY2ggcGx1Z2luIG1hcCB0byBhIHVuaXF1ZSBleHRlbnNpb24gd2l0
aGluIFdlYkFkbWluPyAmbmJzcDtZb3VyIGV4YW1wbGUgc2hvd3MgdGhhdCBJIGNhbiBleHRlbmQg
dGhlIFZNIHRhYmxlIHRvIGhhdmUgYSAmcXVvdDtTaG93IFZNIG5hbWUgYW5kIGVkaXQgVk0mcXVv
dDsgY29udGV4dC1zZW5zaXRpdmUgZXh0ZW5zaW9uLiAmbmJzcDtUaGlzIGlzIG5hbWVkIHBsdWdp
bkFwaS5wbHVnaW5zLm15UGx1Z2luLiAmbmJzcDtDYW4gSSBzYWZlbHkgYXNzdW1lIHRoYXQgdGhp
cyBpcw0KIHBlciBleHRlbnNpb24/ICZuYnNwO0kgd291bGQgaGF2ZSBwbHVnaW5BcGkucGx1Z2lu
cy5teVBsdWdpbjIgZm9yIGV4dGVuZGluZyBhIHN0b3JhZ2UgZG9tYWluPzxicj4NCjMpIEluc3Rl
YWQgb2YgbGF1bmNoaW5nIGEgalF1ZXJ5IGRpYWxvZywgY2FuIEkgcG9pbnQgdG8gYSBjb21waWxl
ZCBHV1QgaHRtbCBmaWxlIHRvIGRpc3BsYXkgYSBkaWFsb2cgdGhhdCBmaXRzIG15IG5lZWRzPzxi
cj4NCjQpIElzIHNlc3Npb24gaW5mbyBwYXNzZWQgaW50byB0aGUgcGx1Z2luIHNvIHRoYXQgSSBj
YW4gaW52b2tlIEFQSXMgaW50byB0aGUgZW5naW5lPyAmbmJzcDtUbyBwb3dlciBvbiBhIFZNIGZv
ciBpbnN0YW5jZT8gJm5ic3A7T3IgdG8gbW91bnQgYSBuZXcgTkZTIHN0b3JhZ2UgZG9tYWluPzxi
cj4NCjxicj4NCkJUVywgdGhlIGxpbmsgdG8gdGhlIG9yaWdpbmFsIGRlc2lnbiBub3RlcyBvbiB0
aGUgd2lraSBkb2Vzbid0IHdvcmsuPGJyPg0KPGJyPg0KVGhhbmtzLDxicj4NCkdlb3JnZTxicj4N
Cjxicj4NCi0tLS0tT3JpZ2luYWwgTWVzc2FnZS0tLS0tPGJyPg0KRnJvbTogVm9qdGVjaCBTem9j
cyA8YSBocmVmPSJtYWlsdG86W21haWx0bzp2c3pvY3NAcmVkaGF0LmNvbV0iPlttYWlsdG86dnN6
b2NzQHJlZGhhdC5jb21dPC9hPjxicj4NClNlbnQ6IFRodXJzZGF5LCBKdW5lIDIxLCAyMDEyIDEx
OjAzIEFNPGJyPg0KVG86IDxhIGhyZWY9Im1haWx0bzplbmdpbmUtZGV2ZWxAb3ZpcnQub3JnIj5l
bmdpbmUtZGV2ZWxAb3ZpcnQub3JnPC9hPjxicj4NCkNjOiBTY2hvZW5icnVuLCBEdXN0aW47IENv
c3RlYSwgR2VvcmdlOyBIb3BwZXIsIFJpY2t5PGJyPg0KU3ViamVjdDogb1ZpcnQgVUkgUGx1Z2lu
cyBmZWF0dXJlOiBSZWFkeSBmb3IgcmV2aWV3PGJyPg0KPGJyPg0KSGkgZ3V5cyw8YnI+DQo8YnI+
DQpJIHdyb3RlIGEgd2lraSBwYWdlIGRlc2NyaWJpbmcgVUkgUGx1Z2lucywgYSBmZWF0dXJlIHBs
YW5uZWQgZm9yIG9WaXJ0IHdlYiBhZG1pbmlzdHJhdGlvbiAoV2ViQWRtaW4pIGFwcGxpY2F0aW9u
Ojxicj4NCjxhIGhyZWY9Imh0dHA6Ly93d3cub3ZpcnQub3JnL3dpa2kvRmVhdHVyZXMvVUlQbHVn
aW5zIj5odHRwOi8vd3d3Lm92aXJ0Lm9yZy93aWtpL0ZlYXR1cmVzL1VJUGx1Z2luczwvYT48YnI+
DQo8YnI+DQpGZWF0dXJlIGRlc2lnbiBpcyBmaW5pc2hlZCBhbmQgcmVhZHkgZm9yIHJldmlldy4g
UGxlYXNlIGZlZWwgZnJlZSB0byBhZGQgY29tbWVudHMsIGFzayBxdWVzdGlvbnMgb3IgcmVhY2gg
bWUgZGlyZWN0bHkgb24gI292aXJ0IGNoYW5uZWwuPGJyPg0KPGJyPg0KQ2hlZXJzLDxicj4NClZv
anRlY2g8bzpwPjwvbzpwPjwvc3Bhbj48L3A+DQo8L2Rpdj4NCjwvZGl2Pg0KPC9ib2R5Pg0KPC9o
dG1sPg0K
--_000_6C8AC8C50E170C4E9B44D47B39B24A48012080BASACEXCMBX04PRDh_--
10:19 a.m.
New subject: [Engine-devel] oVirt UI Plugins: some more ideas
Hi guys,
as a follow-up to an excellent discussion with Michal, here are some ideas that could
prove useful when implementing robust UI plugin infrastructure. (Please let me know what
you think.)
1. Implement WebAdmin dialog that lists active plugins, with the ability to turn them
on/off (during WebAdmin runtime).
2. Implement WebAdmin 'plugin-safe' mode, which disables all plugins during
WebAdmin startup (could be controlled via HTTP parameter)
3. Introduce WebAdmin plugin API compliance version, so that plugins can be made against
specific version of WebAdmin
Cheers,
Vojtech
2:05 p.m.
New subject: [Engine-devel] oVirt UI Plugins: some more ideas
All of these are excellent ideas!
-----Original Message-----
From: engine-devel-bounces(a)ovirt.org [mailto:engine-devel-bounces@ovirt.org] On Behalf Of
Vojtech Szocs
Sent: Tuesday, June 26, 2012 11:19 AM
To: engine-devel(a)ovirt.org
Cc: Michal Skrivanek
Subject: [Engine-devel] oVirt UI Plugins: some more ideas
Hi guys,
as a follow-up to an excellent discussion with Michal, here are some ideas that could
prove useful when implementing robust UI plugin infrastructure. (Please let me know what
you think.)
1. Implement WebAdmin dialog that lists active plugins, with the ability to turn them
on/off (during WebAdmin runtime).
2. Implement WebAdmin 'plugin-safe' mode, which disables all plugins during
WebAdmin startup (could be controlled via HTTP parameter) 3. Introduce WebAdmin plugin API
compliance version, so that plugins can be made against specific version of WebAdmin
Cheers,
Vojtech
_______________________________________________
Engine-devel mailing list
Engine-devel(a)ovirt.org
http://lists.ovirt.org/mailman/listinfo/engine-devel
12:25 p.m.
On 06/25/2012 10:11 PM, Costea, George wrote:
Thanks Vojtech.
Since the plugins are embedded into the WebAdmin HTML page, that seems to simplify
things; no external web service is needed. This approach ties into the issue over the
freedom to decide which technology to use when developing a plugin. While I agree that
jQuery is best for simple dialogs, a wizard-driven workflow is easier to develop in GWT.
For example, if I want to step a user through the process of creating a new storage
domain I would like to provide a workflow to select a storage array, provide credentials,
and configure the details of the NFS export. This workflow could presumably have a
GWT-RPC mechanism that relies on some additional libraries on the backend (libraries that
allow me to communicate with the storage array). Using the GWT-Exporter, I could export
the classes that would display the workflow which would then get launched as my extension
is selected. You said that I would have my oVirt UI plugin depend on my compiled
'plugin support application'. My compiled plugin support application would
normally be a war file containing my compiled GWT code and a web-inf folder containing my
libraries. Is the plugin depending on the war file? Is that what I specify?
-George
-----Original Message-----
From: Vojtech Szocs [mailto:vszocs@redhat.com]
Sent: Monday, June 25, 2012 1:12 PM
To: Costea, George; engine-devel(a)ovirt.org
Cc: Schoenbrun, Dustin; Hopper, Ricky; Itamar Heim
Subject: Re: oVirt UI Plugins feature: Ready for review
Hi George,
thanks for your feedback. Please find my answers below.
> 1) Are the plugins hosted by the same jboss server that hosts the engine? It would
appear the answer is yes and that no separate container is required for the plugins.
In short, yes.
Plugins, along with their configuration and 3rd party dependencies, are meant to be
embedded into final WebAdmin HTML page, see
[http://www.ovirt.org/wiki/Features/UIPlugins#Plugin_lifecycle] step #5.
JBoss AS instance serves WebAdmin HTML page (WebadminDynamicHostingServlet), along with
providing GWT RPC and REST endpoints that delegate to Engine business logic through EJB
BackendLocal interface.
However, plugins are not 'hosted' in a typical sense -
WebadminDynamicHostingServlet reads and embeds all plugin data directly into final
WebAdmin HTML page.
> 2) Does each plugin map to a unique extension within WebAdmin? Your example shows
that I can extend the VM table to have a "Show VM name and edit VM"
context-sensitive extension. This is named pluginApi.plugins.myPlugin. Can I safely
assume that this is per extension? I would have pluginApi.plugins.myPlugin2 for extending
a storage domain?
Extension points are represented by application events, triggered by WebAdmin and
consumed by plugins. For example, 'tableContextMenu' event gets triggered when a
table context menu is about to be shown to the user, which gives plugins the ability to do
something custom with the context menu before it's shown.
There can be multiple plugins handling the same event (extension point). You can have two
plugins, say 'pluginApi.plugins.One' and 'pluginApi.plugins.Two', each
providing 'tableContextMenu' function for handling the above mentioned event.
WebAdmin will invoke all plugins for the given event.
To answer your question, in order to handle X events (extension points), you don't
need to write X plugins. You can write one plugin that handles X events.
> 3) Instead of launching a jQuery dialog, can I point to a compiled GWT html file to
display a dialog that fits my needs?
You can do anything you want in your plugin event handler function. Show a jQuery UI
dialog, make oVirt REST API request, call arbitrary remote server using cross-domain
technique like JSONP [1] or CORS [2], etc. Plugin authors are free to decide if they want
to rely on 3rd party JavaScript libraries, or if they want to write entire plugin code by
themselves.
In my opinion, tools like jQuery are far more elegant for handling simple things such as
UI dialogs. But if you really want to use GWT for this purpose, I suggest following
approach:
a, develop a 'plugin support application' in GWT, which implements the necessary
dialog functionality b, export its main (e.g. dialog handling) classes for use in native
JavaScript through gwt-exporter [3] c, have your oVirt UI plugin depend on your compiled
'plugin support application' (this will cause your 'plugin support
application' to be called during WebAdmin startup) d, in your oVirt UI plugin, invoke
'plugin support application' functionality through exported classes (plugin ->
GWT delegate pattern)
> 4) Is session info passed into the plugin so that I can invoke APIs into the engine?
To power on a VM for instance? Or to mount a new NFS storage domain?
Yes, this should be part of
[http://www.ovirt.org/wiki/Features/UIPlugins#Global_API_functions] "Plugin utility
functions" (global API).
Your plugin might access user session information in the following way:
pluginApi.util().userInfo().* (replace * with id(), name(), domain(), etc.)
As you pointed out, this could be used to authenticate oVirt REST API requests made from
your plugin code.
> BTW, the link to the original design notes on the wiki doesn't work.
This is strange, [http://rhevmf.pad.engineering.redhat.com/68] has its visibility set to
"Public (Allow Internet guests)" ... Does anybody know why this doesn't
work?
Vojtech
[1] http://en.wikipedia.org/wiki/JSONP
[2] http://en.wikipedia.org/wiki/Cross-origin_resource_sharing
[3] http://code.google.com/p/gwt-exporter/
----- Original Message -----
From: "George Costea" <George.Costea(a)netapp.com>
To: "Vojtech Szocs" <vszocs(a)redhat.com>, engine-devel(a)ovirt.org
Cc: "Dustin Schoenbrun" <Dustin.Schoenbrun(a)netapp.com>, "Ricky
Hopper" <Ricky.Hopper(a)netapp.com>
Sent: Monday, June 25, 2012 3:09:43 PM
Subject: RE: oVirt UI Plugins feature: Ready for review
Hi Vojtech,
I have a few questions on this feature.
1) Are the plugins hosted by the same jboss server that hosts the engine? It would
appear the answer is yes and that no separate container is required for the plugins.
2) Does each plugin map to a unique extension within WebAdmin? Your example shows that I
can extend the VM table to have a "Show VM name and edit VM" context-sensitive
extension. This is named pluginApi.plugins.myPlugin. Can I safely assume that this is
per extension? I would have pluginApi.plugins.myPlugin2 for extending a storage domain?
3) Instead of launching a jQuery dialog, can I point to a compiled GWT html file to
display a dialog that fits my needs?
4) Is session info passed into the plugin so that I can invoke APIs into the engine? To
power on a VM for instance? Or to mount a new NFS storage domain?
BTW, the link to the original design notes on the wiki doesn't work.
Thanks,
George
-----Original Message-----
From: Vojtech Szocs [mailto:vszocs@redhat.com]
Sent: Thursday, June 21, 2012 11:03 AM
To: engine-devel(a)ovirt.org
Cc: Schoenbrun, Dustin; Costea, George; Hopper, Ricky
Subject: oVirt UI Plugins feature: Ready for review
Hi guys,
I wrote a wiki page describing UI Plugins, a feature planned for oVirt web administration
(WebAdmin) application:
http://www.ovirt.org/wiki/Features/UIPlugins
Feature design is finished and ready for review. Please feel free to add comments, ask
questions or reach me directly on #ovirt channel.
Cheers,
Vojtech
reviewed the wiki, some notes:
1. nit: plugin is in {} - should only be function call there so not all
of plugin needs such a deep indentation.
2. what are deps?
3. sorting/ordering of plugins. either part of their conf, or part of
their name (nn-pluginname...) which is a normal linux convention
4. Proposed configuration file location: /etc/ovirt/webadmin
add /extensions
5. events - should have before and after event calls
6. missing in api - api to perform a rest call (say using json)
7. future: provide a javascript sdk like the python one, rather than
just a rest api level integration - not sure worth the hassle
8. reminder - extensions need can't use internal API, only the REST API.
this goes to *entities* as well - either you expose a REST-like
entity for the important fields, or we start moving parts of the UI
to the REST entities to match (I'm not sure you want to go with
latter yet, as it is a huge undertaking, but you need to expose
matching entities to begin with, or extensions will break on upgrade
since internal entities aren't backward compatible.
to sum it up:
ui plugins must get an SDK of what they can do, which will include
entry points, entities and relevant methods.
UI code should be as simple as possible to write for the main use cases
(i.e., i think the SDK should provide very simple objets for adding
subtabs, context menu items, etc.) - right now it is very java script
oriented.
9:15 a.m.
On Mon, Jun 25, 2012 at 01:11:41PM -0400, Vojtech Szocs wrote:
> BTW, the link to the original design notes on the wiki
doesn't work.
This is strange, [http://rhevmf.pad.engineering.redhat.com/68] has its
visibility set to "Public (Allow Internet guests)" ... Does anybody
know why this doesn't work?
The DNS records aren't public.
10:04 a.m.
Looks like rhevmf.pad.engineering.redhat.com is on internal network :(
You can find original UI plugin design notes here:
http://www.ovirt.org/wiki/Features/UIPluginsOriginalDesignNotes
(I've also updated UI plugin main wiki page to reflect the link above.)
Vojtech
----- Original Message -----
From: "Ewoud Kohl van Wijngaarden" <ewoud+ovirt(a)kohlvanwijngaarden.nl>
To: engine-devel(a)ovirt.org
Sent: Tuesday, June 26, 2012 4:15:21 PM
Subject: Re: [Engine-devel] oVirt UI Plugins feature: Ready for review
On Mon, Jun 25, 2012 at 01:11:41PM -0400, Vojtech Szocs wrote:
> BTW, the link to the original design notes on the wiki
doesn't work.
This is strange, [http://rhevmf.pad.engineering.redhat.com/68] has its
visibility set to "Public (Allow Internet guests)" ... Does anybody
know why this doesn't work?
The DNS records aren't public.
_______________________________________________
Engine-devel mailing list
Engine-devel(a)ovirt.org
http://lists.ovirt.org/mailman/listinfo/engine-devel
4553
days inactive
4566
days old
10 comments
4 participants
participants (4)
-
Costea, George -
Ewoud Kohl van Wijngaarden -
Itamar Heim -
Vojtech Szocs