4:14 a.m.
------=_=-_OpenGroupware_org_NGMime-17650-1523607277.566640-80------
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Content-Length: 8119
Hi all,
I can't find any exhaustive doc for new vdsm-client. My problem actuall=
y is a task (export a vm to OVA) blocked.
I found that I can interact with
vdsm-client Task getInfo taskID=3D<uuid>, and replace getInfo by "stop"=
, BUT : how can I find this UUID ???
Old "vdsClient -s 0 getAllTasksStatuses" has no equivalent ??
Does someone knows if a complete doc exists dot vdsm-client ?
Thanks
Frank
=C2=A0
Le Mercredi, Janvier 25, 2017 12:30 CET, Irit Goihman <igoihman(a)redhat.=
com> a =C3=A9crit:
=C2=A0Hi All,=C2=A0vdsClient will be removed from master branch today.I=
t is using XMLRPC protocol which has been deprecated and replaced by JS=
ON-RPC.=C2=A0A new client for vdsm was introduced in 4.1: vdsm-client.T=
his is a simple client that uses JSON-RPC protocol which was introduced=
in ovirt 3.5.=C2=A0The client is not aware of the available methods an=
d parameters, and you should consult=C2=A0the schema [1] in order to co=
nstruct the desired command.=C2=A0Future version should parse the schem=
a and provide online help.=C2=A0=C2=A0If you're using vdsClient, we wil=
l be happy to assist you in migrating to the new vdsm client.=C2=A0=C2=A0=
=C2=A0vdsm-client usage:=C2=A0vdsm-client [-h] [-a ADDRESS] [-p PORT] [=
--unsecure] [--timeout TIMEOUT]=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=
=C2=A0 =C2=A0 =C2=A0 =C2=A0[-f FILE] namespace method [name=3Dvalue [n=
ame=3Dvalue] ...]=C2=A0=C2=A0Invoking simple methods:=C2=A0# vdsm-clien=
t Host getVMList['b3f6fa00-b315-4ad4-8108-f73da817b5c5']=C2=A0For invok=
ing methods with many or complex parameters, you can read the=C2=A0para=
meters from a JSON format file:=C2=A0# vdsm-client Lease info -f lease.=
json=C2=A0where lease.json file content is:=C2=A0{ =C2=A0 =C2=A0 =C2=A0=
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=
=C2=A0 =C2=A0 =C2=A0 =C2=A0=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 "lease":=
{ =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0=C2=A0=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 "sd=5Fid": "7=
5ab40e3-06b1-4a54-a825-2df7a40b93b2", =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=C2=A0=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 "lease=5Fid": "b3f6fa00-b315-4ad4-8108-f73da817b5c5"
=
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=C2=A0=C2=
=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 } =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=C2=
=A0 } =C2=A0=C2=A0It is also possible to read parameters from standard =
input, creating complex=C2=A0parameters interactively:=C2=A0# cat <<EOF=
| vdsm-client Lease info -f - =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =
=C2=A0 =C2=A0=C2=A0 =C2=A0 =C2=A0{ =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0"lease": { =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=C2=A0=C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0"sd=5Fid": "75ab40e3-06b1-4a54-a8=
25-2df7a40b93b2", =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=
=C2=A0 =C2=A0=C2=A0=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0"le=
ase=5Fid": "b3f6fa00-b315-4ad4-8108-f73da817b5c5" =C2=A0 =C2=A0 =C2=A0 =
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=C2=A0=C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0} =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=C2=A0 =C2=A0 =C2=A0} =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=C2=A0 =C2=A0 EOF =C2=A0=C2=
=A0=C2=A0Constructing a command from vdsm schema:=C2=A0Let's take VM.ge=
tStats as an example.This is the entry in the schema:=C2=A0VM.getStats:=
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=
=C2=A0 =C2=A0 =C2=A0=C2=A0 =C2=A0 added: '3.1' =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=C2=A0 =C2=A0 de=
scription: Get statistics about a running virtual machine. =C2=A0 =C2=A0=
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=C2=A0 =C2=A0 params: =C2=A0 =
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =
=C2=A0 =C2=A0=C2=A0=C2=A0 =C2=A0 - =C2=A0 description: The UUID of the =
VM =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=C2=
=A0=C2=A0 =C2=A0 =C2=A0 =C2=A0 name: vmID =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=C2=A0 =C2=A0 =C2=A0 =C2=A0 ty=
pe: *UUID =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0=C2=A0=C2=A0 =C2=A0 return: =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=C2=A0=C2=A0 =C2=A0=
=C2=A0 =C2=A0 description: An array containing a single VmStats record=
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=C2=A0 =C2=A0 =C2=
=A0 =C2=A0 type: =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=C2=A0=C2=A0 =C2=A0 =C2=A0 =C2=A0 - *VmS=
tats =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =
=C2=A0=C2=A0namespace: VMmethod name: getStatsparams: vmID=C2=A0The vds=
m-client command is:=C2=A0# vdsm-client VM=C2=A0getStats vmID=3Db3f6fa0=
0-b315-4ad4-8108-f73da817b5c5=C2=A0=C2=A0Invoking getVdsCaps command:=C2=
=A0# vdsm-client Host=C2=A0getCapabilities=C2=A0=C2=A0=C2=A0Please cons=
ult vdsm-client help and man page for further details and options.=C2=A0=
=C2=A0=C2=A0[1] https://github.com/oVirt/vdsm/blob/master/lib/api/vdsm-=
api.yml=C2=A0--Irit GoihmanSoftware EngineerRed Hat Israel Ltd.
------=_=-_OpenGroupware_org_NGMime-17650-1523607277.566640-80------
Content-Type: text/html; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Content-Length: 9962
<html>Hi all,<br />I can't find any exhaustive doc for new vdsm-client.=
My problem actually is a task (export a vm to OVA) blocked.<br />I fou=
nd that I can interact with<br />vdsm-client Task getInfo taskID=3D<=
uuid>, and replace getInfo by "stop", BUT : how can I find this UUID=
???<br />Old "vdsClient -s 0 getAllTasksStatuses" has no equivalent ??=
<br /><br />Does someone knows if a complete doc exists dot vdsm-client=
?<br />Thanks<br />Frank<p class=3D"Text2"><br
/> </p><br /><br /=
Le Mercredi, Janvier 25, 2017 12:30 CET, Irit Goihman
<igoihman@red=
hat.com> a =C3=A9crit:<br
/> <blockquote type=3D"cite" cite=3D"=
CAA=3Di7HMsB7iRYqP9yyBx4w7pGer9rTE9wkJZRgcmXRQMaJezwg(a)mail.gmail.com"><=
div dir=3D"ltr">Hi All,<div> </div><div>vdsClient
will be removed =
from master branch today.</div><div>It is using XMLRPC protocol which h=
as been deprecated and replaced by
JSON-RPC.</div><div> </div><div=
A new client for vdsm was introduced in 4.1:
vdsm-client.</div><div>Th=
is is a simple client that uses JSON-RPC
protocol which was introduced =
in ovirt 3.5.</div><div> </div><div>The client is not
aware of the=
available methods and parameters, and you should consult </div><d=
iv>the schema [1] in order to construct the desired command.</div><div>=
</div><div>Future version should parse the schema and provide onl=
ine
help.</div><div> </div><div> </div><div>If
you're using v=
dsClient, we will be happy to assist you in migrating to the new vdsm c=
lient.</div><div> </div><div> </div><div> </div><div><b>=
<u>vdsm-client
usage:</u></b></div><div> </div><div><div>vdsm-clie=
nt [-h] [-a ADDRESS] [-p PORT] [--unsecure] [--timeout TIMEOUT]</div><d=
iv>
 =
;[-f FILE] namespace method [name=3Dvalue [name=3Dvalue] ...]</div></di=
v><div> </div><div> </div><div><div>Invoking
simple methods:<=
/div><div> </div><div># vdsm-client Host
getVMList</div><div>['b3f=
6fa00-b315-4ad4-8108-f73da817b5c5']</div></div><div> </div><div>Fo=
r invoking methods with many or complex parameters, you can read the&nb=
sp;parameters from a JSON format
file:</div><div> </div><div># vds=
m-client Lease info -f
lease.json</div><div> </div><div>where leas=
e.json file content
is:</div><div> </div><div><div>{
=
=
&=
nbsp;
&n=
bsp;
</div><div> =
"lease": {
&nbs=
p;
 =
;
=
</div><div>
 =
; "sd=5Fid":
"75ab40e3-06b1-4a54-a825-2df7a40b93b2=
",
 =
; </div><div>
"lea=
se=5Fid": "b3f6fa00-b315-4ad4-8108-f73da817b5c5"
&=
nbsp;
</div><div> =
}
=
=
&=
nbsp;
</div><div=
}
</div></div><div> </div><div>It is also
possible t=
o read parameters from standard input, creating
complex parameters=
interactively:</div><div> </div><div><div># cat
<<EOF | vds=
m-client Lease info -f -
&nbs=
p;
 =
; </div><div> {
&n=
bsp;
&nb=
sp;
&nbs=
p;
 =
; </div><div>
"lea=
se": {
&=
nbsp;
&n=
bsp;
&nb=
sp; </div><div>
&n=
bsp;"sd=5Fid": "75ab40e3-06b1-4a54-a825-2df7a40b93b2",
&n=
bsp;
</div><div>&=
nbsp;
"lease=5Fid": "b3f6fa00-=
b315-4ad4-8108-f73da817b5c5"
=
</div><div>
=
}
=
=
&=
nbsp;
</div><div> =
}
=
=
&=
nbsp;
</div><div> =
EOF
</div></div><div> </div><div> </div><div><b=
<u>Constructing a command from vdsm
schema:</u></b></div><div> </=
div><div>Let's take VM.getStats as an
example.</div><div>This is the en=
try in the
schema:</div><div> </div><div><div>VM.getStats:
=
&=
nbsp;
&n=
bsp;
&nb=
sp; </div><div> added: '3.1'
&n=
bsp;
&nb=
sp;
&nbs=
p;
</div>=
<div> description: Get statistics about a running virtual =
machine.
</div><=
div> params:
&nb=
sp;
&nbs=
p;
 =
;
</div><div>&nbs=
p; - description: The UUID of the VM
=
=
</div><div> =
name: vmID
&nb=
sp;
&nbs=
p;
 =
; </div><div>
&nb=
sp; type: *UUID
=
=
&=
nbsp; </div><div> return:
=
=
&=
nbsp;
&n=
bsp; </div><div>
description: An array =
containing a single VmStats record
&=
nbsp; </div><div>
type: =
&=
nbsp;
&n=
bsp;
&nb=
sp; </div><div>
- *VmStats  =
;
=
=
</=
div></div><div> </div><div>namespace:
VM</div><div>method name: ge=
tStats</div><div>params:
vmID</div><div> </div><div>The vdsm-clien=
t command is:</div><div> </div><div># vdsm-client
VM getStats=
vmID=3Db3f6fa00-b315-4ad4-8108-f73da817b5c5</div><div> </div><div=
</div><div><div><b><u>Invoking
getVdsCaps command:</u></b></div>=
<div> </div><div># vdsm-client
Host getCapabilities</div></di=
v><div> </div><div><div> </div><div> </div><div>Please
c=
onsult vdsm-client help and man page for further details and options.</=
div><div> </div><div> </div><div> </div><div>[1]
<a href=
=3D"https://github.com/oVirt/vdsm/blob/master/lib/api/vdsm-api.yml">htt=
ps://github.com/oVirt/vdsm/blob/master/lib/api/vdsm-api.yml</a><...
iv> </div>--<div class=3D"gmail=5Fsignature"><div
dir=3D"ltr">Irit=
Goihman<div>Software Engineer</div><div>Red Hat Israel
Ltd.</div></div=
</div></div></div></blockquote><br
/><br /><style type=3D"text/css">.T=
ext1 {
color: black;
font-size:9pt;
font-family:Verdana;
}
.Text2 {
color: black;
font-size:7pt;
font-family:Verdana;
}</style></html>
------=_=-_OpenGroupware_org_NGMime-17650-1523607277.566640-80--------