Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1317129

Summary: [Docs] [Java SDK] authentication via the sessionid is not documented for python/java SDK
Product: Red Hat Enterprise Virtualization Manager Reporter: Roman Hodain <rhodain>
Component: DocumentationAssignee: Andrew Dahms <adahms>
Status: CLOSED CURRENTRELEASE QA Contact: Lucy Bopf <lbopf>
Severity: medium Docs Contact:
Priority: medium    
Version: 3.6.3CC: adahms, gklein, lbopf, lsurette, rbalakri, srevivo
Target Milestone: ovirt-4.0.0-beta   
Target Release: 4.0.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-05-30 22:58:58 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: Docs RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Roman Hodain 2016-03-12 09:16:37 UTC
Description of problem:
    The documentation does not contain instruction how to use the session id for the available SDKs. This is problematic as event java-docs does not contain some information.

Affected docs:
   Java SDK Guide - Using the Red Hat Enterprise Virtualization Java SDK 
   Python SDK Guide - Using the Red Hat Enterprise Virtualization Python SDK

Version-Release number of selected component (if applicable):
3.6

Additional notes:
For example java doc says that the Api constructor can be called in the following way:

    Api(java.lang.String url, java.lang.String sessionid) 

but it does not explain what is the format of the sessionid. This is confusing as one would do:

     sessionid='V7tybi14lt8GrzWoqlGobQnf'

but the right way is:

     sessionid='JSESSIONID=V7tybi14lt8GrzWoqlGobQnf...'

So the documentation should include a description of the session id usage and an example of usage.

Comment 1 Andrew Dahms 2016-05-09 05:32:10 UTC
Taking to work on in conjunction with BZ#1325323.

Comment 2 Yaniv Lavi 2016-05-09 10:56:36 UTC
oVirt 4.0 Alpha has been released, moving to oVirt 4.0 Beta target.

Comment 3 Andrew Dahms 2016-05-10 05:43:05 UTC
Moving to modified.

Tech review being requested in BZ#1325323 alongside the changes in that bug that also touch on the Java SDK.

Comment 4 Andrew Dahms 2016-05-20 01:59:34 UTC
Moving to ON_QA.

Assigning Lucy as the QA contact.

Lucy - would you be able to take a look at the changes for this bug?

See comment #4 in BZ#1325323 for the details.

Comment 5 Lucy Bopf 2016-05-23 03:53:55 UTC
Thanks, Andrew. I've reviewed the changes in bug 1325323, and everything looks good to me.

Moving to VERIFIED.