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@mail.gmail.com"><=
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=
} </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=
<u>Constructing a command from vdsm schema:</u></b></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.</=
------=_=-_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@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 /= 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= 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= 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= 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><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></div><d= 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--------