Return to
FAQs.htm
CVS log
Up to [Pegasus] / pegasus-JavaCIMClient / docs
|
Return to
FAQs.htm
CVS log
|
Up to [Pegasus] / pegasus-JavaCIMClient / docs
|
|
File: [Pegasus] / pegasus-JavaCIMClient / docs / FAQs.htm
(download)
/
(as text)
Revision: 1.2, Tue May 9 17:48:13 2006 UTC (18 years ago) by mateus.baur Branch: MAIN CVS Tags: HEAD Changes since 1.1: +1 -1 lines BUG#: 5041 TITLE: Java Client API should support certificate based authentication. DESCRIPTION: Created new interfaces in order to enable certificate based authentication utilization. |
<html xmlns:v="urn:schemas-microsoft-com:vml"
xmlns:o="urn:schemas-microsoft-com:office:office"
xmlns:w="urn:schemas-microsoft-com:office:word"
xmlns:st1="urn:schemas-microsoft-com:office:smarttags"
xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv=Content-Type content="text/html; charset=windows-1252">
<meta name=ProgId content=Word.Document>
<meta name=Generator content="Microsoft Word 10">
<meta name=Originator content="Microsoft Word 10">
<link rel=File-List href="FAQs_2_0_files/filelist.xml">
<title>WBEM Java Client Release Notes</title>
<o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
name="City"/>
<o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
name="place"/>
<!--[if gte mso 9]><xml>
<o:DocumentProperties>
<o:Subject>WBEM Java Client Release Notes </o:Subject>
<o:Author>Bapu Patil</o:Author>
<o:Template>normal</o:Template>
<o:LastAuthor>Bapu Patil</o:LastAuthor>
<o:Revision>2</o:Revision>
<o:TotalTime>24</o:TotalTime>
<o:LastPrinted>2003-05-14T19:27:00Z</o:LastPrinted>
<o:Created>2004-11-22T18:54:00Z</o:Created>
<o:LastSaved>2004-11-22T18:54:00Z</o:LastSaved>
<o:Pages>1</o:Pages>
<o:Words>2319</o:Words>
<o:Characters>13221</o:Characters>
<o:Company>Hewlett-Packard Company</o:Company>
<o:Lines>110</o:Lines>
<o:Paragraphs>31</o:Paragraphs>
<o:CharactersWithSpaces>15509</o:CharactersWithSpaces>
<o:Version>10.6714</o:Version>
</o:DocumentProperties>
</xml><![endif]--><!--[if gte mso 9]><xml>
<w:WordDocument>
<w:SpellingState>Clean</w:SpellingState>
<w:GrammarState>Clean</w:GrammarState>
<w:DisplayHorizontalDrawingGridEvery>0</w:DisplayHorizontalDrawingGridEvery>
<w:DisplayVerticalDrawingGridEvery>0</w:DisplayVerticalDrawingGridEvery>
<w:UseMarginsForDrawingGridOrigin/>
<w:Compatibility>
<w:FootnoteLayoutLikeWW8/>
<w:ShapeLayoutLikeWW8/>
<w:AlignTablesRowByRow/>
<w:ForgetLastTabAlignment/>
<w:LayoutRawTableWidth/>
<w:LayoutTableRowsApart/>
</w:Compatibility>
<w:BrowserLevel>MicrosoftInternetExplorer4</w:BrowserLevel>
</w:WordDocument>
</xml><![endif]--><!--[if !mso]><object
classid="clsid:38481807-CA0E-42D2-BF39-B33AF135CC4D" id=ieooui></object>
<style>
st1\:*{behavior:url(#ieooui) }
</style>
<![endif]-->
<style>
<!--
/* Font Definitions */
@font-face
{font-family:"Comic Sans MS";
panose-1:3 15 7 2 3 3 2 2 2 4;
mso-font-charset:0;
mso-generic-font-family:script;
mso-font-pitch:variable;
mso-font-signature:647 0 0 0 159 0;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{mso-style-parent:"";
margin:0in;
margin-bottom:.0001pt;
mso-pagination:widow-orphan;
font-size:10.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
h1
{mso-style-next:Normal;
margin-top:12.0pt;
margin-right:0in;
margin-bottom:3.0pt;
margin-left:0in;
mso-pagination:widow-orphan;
mso-outline-level:1;
font-size:14.0pt;
mso-bidi-font-size:10.0pt;
font-family:Arial;
mso-font-kerning:14.0pt;
font-weight:bold;
mso-bidi-font-weight:normal;}
h2
{mso-style-next:Normal;
margin-top:12.0pt;
margin-right:0in;
margin-bottom:3.0pt;
margin-left:0in;
mso-pagination:widow-orphan;
mso-outline-level:2;
font-size:12.0pt;
mso-bidi-font-size:10.0pt;
font-family:Arial;
font-weight:bold;
mso-bidi-font-weight:normal;
font-style:italic;
mso-bidi-font-style:normal;}
h3
{mso-style-next:Normal;
margin-top:12.0pt;
margin-right:0in;
margin-bottom:3.0pt;
margin-left:0in;
mso-pagination:widow-orphan;
mso-outline-level:3;
font-size:12.0pt;
mso-bidi-font-size:10.0pt;
font-family:Arial;
font-weight:normal;}
h4
{mso-style-next:Normal;
margin:0in;
margin-bottom:.0001pt;
mso-pagination:widow-orphan;
mso-outline-level:4;
font-size:12.0pt;
mso-bidi-font-size:10.0pt;
font-family:"Times New Roman";
font-weight:bold;}
h5
{mso-style-next:Normal;
margin:0in;
margin-bottom:.0001pt;
mso-pagination:widow-orphan;
mso-outline-level:5;
font-size:14.0pt;
mso-bidi-font-size:10.0pt;
font-family:"Times New Roman";
font-weight:normal;}
h6
{mso-style-next:Normal;
margin:0in;
margin-bottom:.0001pt;
mso-pagination:widow-orphan;
page-break-after:avoid;
mso-outline-level:6;
tab-stops:.5in;
mso-layout-grid-align:none;
text-autospace:none;
font-size:10.0pt;
font-family:"Courier New";
font-weight:bold;}
p.MsoNormalIndent, li.MsoNormalIndent, div.MsoNormalIndent
{margin-top:0in;
margin-right:0in;
margin-bottom:0in;
margin-left:.5in;
margin-bottom:.0001pt;
mso-pagination:widow-orphan;
font-size:10.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
p.MsoList2, li.MsoList2, div.MsoList2
{margin-top:0in;
margin-right:0in;
margin-bottom:0in;
margin-left:.5in;
margin-bottom:.0001pt;
text-indent:-.25in;
mso-pagination:widow-orphan;
font-size:10.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
p.MsoListBullet2, li.MsoListBullet2, div.MsoListBullet2
{mso-style-update:auto;
margin-top:0in;
margin-right:0in;
margin-bottom:0in;
margin-left:.5in;
margin-bottom:.0001pt;
text-indent:-.25in;
mso-pagination:widow-orphan;
mso-list:l0 level1 lfo3;
tab-stops:list .5in;
font-size:10.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
p.MsoSignature, li.MsoSignature, div.MsoSignature
{margin-top:0in;
margin-right:0in;
margin-bottom:0in;
margin-left:3.0in;
margin-bottom:.0001pt;
mso-pagination:widow-orphan;
font-size:10.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
p.MsoBodyText, li.MsoBodyText, div.MsoBodyText
{margin:0in;
margin-bottom:.0001pt;
mso-pagination:widow-orphan;
mso-layout-grid-align:none;
font-size:10.0pt;
font-family:"Comic Sans MS";
mso-fareast-font-family:"Times New Roman";
mso-bidi-font-family:"Times New Roman";
font-weight:bold;}
p.MsoBodyTextIndent, li.MsoBodyTextIndent, div.MsoBodyTextIndent
{margin-top:0in;
margin-right:0in;
margin-bottom:6.0pt;
margin-left:.25in;
mso-pagination:widow-orphan;
font-size:10.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
p.MsoListContinue2, li.MsoListContinue2, div.MsoListContinue2
{margin-top:0in;
margin-right:0in;
margin-bottom:6.0pt;
margin-left:.5in;
mso-pagination:widow-orphan;
font-size:10.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
p.MsoBodyText2, li.MsoBodyText2, div.MsoBodyText2
{margin:0in;
margin-bottom:.0001pt;
mso-pagination:widow-orphan;
font-size:12.0pt;
mso-bidi-font-size:10.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
a:link, span.MsoHyperlink
{color:blue;
text-decoration:underline;
text-underline:single;}
a:visited, span.MsoHyperlinkFollowed
{color:purple;
text-decoration:underline;
text-underline:single;}
p
{mso-margin-top-alt:auto;
margin-right:0in;
mso-margin-bottom-alt:auto;
margin-left:0in;
mso-pagination:widow-orphan;
font-size:12.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
pre
{margin:0in;
margin-bottom:.0001pt;
mso-pagination:widow-orphan;
tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;
font-size:10.0pt;
font-family:"Courier New";
mso-fareast-font-family:"Courier New";}
tt
{font-family:"Courier New";
mso-ascii-font-family:"Courier New";
mso-fareast-font-family:"Courier New";
mso-hansi-font-family:"Courier New";
mso-bidi-font-family:"Courier New";}
p.CcList, li.CcList, div.CcList
{mso-style-name:"Cc List";
margin:0in;
margin-bottom:.0001pt;
mso-pagination:widow-orphan;
font-size:10.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
p.ShortReturnAddress, li.ShortReturnAddress, div.ShortReturnAddress
{mso-style-name:"Short Return Address";
margin:0in;
margin-bottom:.0001pt;
mso-pagination:widow-orphan;
font-size:10.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
p.PPLine, li.PPLine, div.PPLine
{mso-style-name:"PP Line";
mso-style-parent:Signature;
margin-top:0in;
margin-right:0in;
margin-bottom:0in;
margin-left:3.0in;
margin-bottom:.0001pt;
mso-pagination:widow-orphan;
font-size:10.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
p.InsideAddressName, li.InsideAddressName, div.InsideAddressName
{mso-style-name:"Inside Address Name";
margin:0in;
margin-bottom:.0001pt;
mso-pagination:widow-orphan;
font-size:10.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
p.Style0, li.Style0, div.Style0
{mso-style-name:Style0;
mso-style-parent:"";
margin:0in;
margin-bottom:.0001pt;
mso-pagination:widow-orphan;
mso-layout-grid-align:none;
text-autospace:none;
font-size:12.0pt;
font-family:Arial;
mso-fareast-font-family:"Times New Roman";
mso-bidi-font-family:"Times New Roman";}
span.SpellE
{mso-style-name:"";
mso-spl-e:yes;}
span.GramE
{mso-style-name:"";
mso-gram-e:yes;}
@page Section1
{size:8.5in 11.0in;
margin:1.0in 1.25in 1.0in 1.25in;
mso-header-margin:.5in;
mso-footer-margin:.5in;
mso-paper-source:0;}
div.Section1
{page:Section1;}
/* List Definitions */
@list l0
{mso-list-id:-125;
mso-list-type:simple;
mso-list-template-ids:-218198392;}
@list l0:level1
{mso-level-number-format:bullet;
mso-level-style-link:"List Bullet 2";
mso-level-text:\F0B7;
mso-level-tab-stop:.5in;
mso-level-number-position:left;
text-indent:-.25in;
font-family:Symbol;}
@list l1
{mso-list-id:247084106;
mso-list-type:hybrid;
mso-list-template-ids:1643154800 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
@list l1:level1
{mso-level-tab-stop:.5in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l1:level2
{mso-level-tab-stop:1.0in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l1:level3
{mso-level-tab-stop:1.5in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l1:level4
{mso-level-tab-stop:2.0in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l1:level5
{mso-level-tab-stop:2.5in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l1:level6
{mso-level-tab-stop:3.0in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l1:level7
{mso-level-tab-stop:3.5in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l1:level8
{mso-level-tab-stop:4.0in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l1:level9
{mso-level-tab-stop:4.5in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l2
{mso-list-id:252513578;
mso-list-type:hybrid;
mso-list-template-ids:811916116 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
@list l2:level1
{mso-level-tab-stop:.5in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l2:level2
{mso-level-tab-stop:1.0in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l2:level3
{mso-level-tab-stop:1.5in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l2:level4
{mso-level-tab-stop:2.0in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l2:level5
{mso-level-tab-stop:2.5in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l2:level6
{mso-level-tab-stop:3.0in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l2:level7
{mso-level-tab-stop:3.5in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l2:level8
{mso-level-tab-stop:4.0in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l2:level9
{mso-level-tab-stop:4.5in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l3
{mso-list-id:524485251;
mso-list-type:hybrid;
mso-list-template-ids:-175104624 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l3:level1
{mso-level-number-format:bullet;
mso-level-text:\F0B7;
mso-level-tab-stop:.5in;
mso-level-number-position:left;
text-indent:-.25in;
font-family:Symbol;}
@list l3:level2
{mso-level-tab-stop:1.0in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l3:level3
{mso-level-tab-stop:1.5in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l3:level4
{mso-level-tab-stop:2.0in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l3:level5
{mso-level-tab-stop:2.5in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l3:level6
{mso-level-tab-stop:3.0in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l3:level7
{mso-level-tab-stop:3.5in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l3:level8
{mso-level-tab-stop:4.0in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l3:level9
{mso-level-tab-stop:4.5in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l4
{mso-list-id:1505632988;
mso-list-type:hybrid;
mso-list-template-ids:904969346 1896489038 -1021140422 616970556 753855378 -307702454 337287590 -362651142 1385077412 129915254;}
@list l4:level1
{mso-level-number-format:bullet;
mso-level-text:\F0B7;
mso-level-tab-stop:.5in;
mso-level-number-position:left;
text-indent:-.25in;
mso-ansi-font-size:10.0pt;
font-family:Symbol;}
@list l4:level2
{mso-level-tab-stop:1.0in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l4:level3
{mso-level-tab-stop:1.5in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l4:level4
{mso-level-tab-stop:2.0in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l4:level5
{mso-level-tab-stop:2.5in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l4:level6
{mso-level-tab-stop:3.0in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l4:level7
{mso-level-tab-stop:3.5in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l4:level8
{mso-level-tab-stop:4.0in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l4:level9
{mso-level-tab-stop:4.5in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l5
{mso-list-id:2007662374;
mso-list-type:hybrid;
mso-list-template-ids:1413667294 -1837347444 1447836560 -2085591486 1525986426 420924086 1411915016 220890626 1754024258 -168013522;}
@list l5:level1
{mso-level-number-format:bullet;
mso-level-text:\F0B7;
mso-level-tab-stop:.5in;
mso-level-number-position:left;
text-indent:-.25in;
mso-ansi-font-size:10.0pt;
font-family:Symbol;}
@list l5:level2
{mso-level-tab-stop:1.0in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l5:level3
{mso-level-tab-stop:1.5in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l5:level4
{mso-level-tab-stop:2.0in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l5:level5
{mso-level-tab-stop:2.5in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l5:level6
{mso-level-tab-stop:3.0in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l5:level7
{mso-level-tab-stop:3.5in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l5:level8
{mso-level-tab-stop:4.0in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l5:level9
{mso-level-tab-stop:4.5in;
mso-level-number-position:left;
text-indent:-.25in;}
ol
{margin-bottom:0in;}
ul
{margin-bottom:0in;}
-->
</style>
<!--[if gte mso 10]>
<style>
/* Style Definitions */
table.MsoNormalTable
{mso-style-name:"Table Normal";
mso-tstyle-rowband-size:0;
mso-tstyle-colband-size:0;
mso-style-noshow:yes;
mso-style-parent:"";
mso-padding-alt:0in 5.4pt 0in 5.4pt;
mso-para-margin:0in;
mso-para-margin-bottom:.0001pt;
mso-pagination:widow-orphan;
font-size:10.0pt;
font-family:"Times New Roman";}
</style>
<![endif]--><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="2050"/>
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1"/>
</o:shapelayout></xml><![endif]-->
</head>
<body lang=EN-US link=blue vlink=purple style='tab-interval:.5in'>
<div class=Section1>
<h1 align=center style='text-align:center'>\HP WBEM Services</h1>
<h1 align=center style='text-align:center'>Java Client SDK</h1>
<h1 align=center style='text-align:center'><span class=SpellE>FAQs</span></h1>
<p class=MsoNormal><o:p> </o:p></p>
<h2>Troubleshooting and CIM Exceptions<span style='font-family:"Courier New"'><o:p></o:p></span></h2>
<p style='text-align:justify;tab-stops:.5in'>In addition to the standard CIM
Exceptions sent by the CIM Server to the client, the CIM Client library
generates the following exceptions. The exception generated by the client
library along with the reason and solution is explained below:</p>
<p style='tab-stops:.5in'><b>Exception: CIMCLIENT_ERR_SSL_HANDSHAKE_FAILED
(Unable to Initialize Specified <span class=SpellE>TrustManager</span>: <a
href="mailto:org.snia.wbemcmd.xml.HTTPOutputSimple@ed0338"><span
style='mso-bidi-font-family:"Courier New";color:windowtext'>org.snia.wbemcmd.xml.HTTPOutputSimple@ed0338</span></a>)<o:p></o:p></b></p>
<p style='text-align:justify;tab-stops:.5in'>Problem: </p>
<p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>This exception
indicates that the specified <span class=SpellE>TrustManager</span> may not
exist, may contain invalid path, or it may not have required permission to
load.</p>
<p style='text-align:justify;tab-stops:.5in'>Solution: </p>
<p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>Make sure that
the <span class=SpellE>TrustManager</span> you have specified exist and has correct
path and right permissions. Also make sure that the <span class=SpellE>TrustManager</span>
is not set to “null”. </p>
<p style='tab-stops:.5in'><b>Exception: CIMCLIENT_ERR_SSL_HANDSHAKE_<span
class=GramE>FAILED(</span>SSL Factory Initialization failed: <a
href="mailto:org.snia.wbemcmd.xml.HTTPOutputSimple@ed0338"><span
style='mso-bidi-font-family:"Courier New";color:windowtext'>org.snia.wbemcmd.xml.HTTPOutputSimple@ed0338</span></a>)<o:p></o:p></b></p>
<p style='text-align:justify;tab-stops:.5in'>Problem: </p>
<p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>This exception
may happen in number different scenarios. Such as, unable to find JSSE
providers, unable to generate random seed, unable to connect to correct server,
server had problem with SSL handshake, or policy permissions are incorrect.</p>
<p style='text-align:justify;tab-stops:.5in'>Solution: </p>
<p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>Follow JSSE
specification and make sure the system java configurations are setup correctly.</p>
<p style='text-align:justify;tab-stops:.5in'><b>Exception: CIMCLIENT_ERR_HTTP_<span
class=GramE>ERROR(</span>Couldn't find trusted certificate, response=500)<o:p></o:p></b></p>
<p style='text-align:justify;tab-stops:.5in'>Problem: </p>
<p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>This exception
may happen because of SSL handshake failure. SSL handshake may fail because the
certificate sent by the server was an invalid certificate or the certificate is
not in clients Trust store.</p>
<p style='text-align:justify;tab-stops:.5in'>Solution: </p>
<p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>Either add this
certificate to client Trust store or handle the certificate appropriately in
the Certificate Manager.</p>
<p style='text-align:justify;tab-stops:.5in'><b>Exception:
CIMCLIENT_ERR_TIMED_OUT (Request Timeout)<o:p></o:p></b></p>
<p style='text-align:justify;tab-stops:.5in'>Problem: </p>
<p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>This exception
indicates that a timeout has occurred on a socket read. This could mean the
server or provider may be slow in responding to client request, or the client
time out is small.</p>
<p style='text-align:justify;tab-stops:.5in'>Solution: </p>
<p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>Consider trying
this operation at some other time or might want to set client timeout or
increase the client timeout. Refer to <span class=SpellE>CIMClient</span> API
java documentation for how to set client timeout.</p>
<p style='text-align:justify;tab-stops:.5in'><b>Exception: CIMCLIENT_ERR_CONNECTION_<span
class=GramE>FAILED(</span>Connection refused) <o:p></o:p></b></p>
<p style='text-align:justify;tab-stops:.5in'>Problem: </p>
<p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>This exception
indicates that an error occurred while attempting to connect to <span
class=SpellE>CIMServer</span> on a port. The <span class=SpellE>CIMServer</span>
may not be running on the specified address or it may not be listening on the specified
port.</p>
<p style='text-align:justify;tab-stops:.5in'>Solution: </p>
<p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>Check to make
sure that the server address is correct and the port number specified is the
correct port number for an SSL or non-SSL communication. (e.g., <span
class=GramE>This</span> exception may be thrown if the <span class=SpellE>CIMServer</span>
is SSL enabled and listening on port 5989, the client trying to connect to
non-SSL port 5988.)</p>
<p style='text-align:justify;tab-stops:.5in'><b>Exception:
CIMCLIENT_ERR_CONNECTION_<span class=GramE>FAILED(</span>sequoia Unknown host) <o:p></o:p></b></p>
<p style='text-align:justify;tab-stops:.5in'>Problem: This exception indicates
that the <span class=SpellE>CIMServer</span> address specified may contain an
invalid system name or the system is not reachable.</p>
<p style='text-align:justify;tab-stops:.5in'>Solution:<span
style='mso-spacerun:yes'> </span>Make sure the specified <span class=SpellE>CIMServer</span>
address is correct and the remote system is reachable.</p>
<p style='text-align:justify;tab-stops:.5in'><b style='mso-bidi-font-weight:
normal'>Exception: <i> </i>CIM_ERR_<span class=GramE>FAILED(</span>IO
terminated in HTTP headers)<o:p></o:p></b></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'>Problem: Java Client sends this error in couple of
cases -<o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'>1. Server closed the connection before the client had
a chance to read. <o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'>2. <span class=SpellE>CIMServer</span> did not send
the response. <o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'>3. <span class=SpellE>CIMServer</span> takes longer
time to respond. <o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'>4. Java Client read timeout is set too low.<o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'><o:p> </o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'>Solution:<o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'>You can turn on the trace on the Client side and
possibly in <span class=SpellE>cimserver</span>.<o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'>To turn on the trace in Java Client - set
DEBUG_XML=true in <span class=SpellE>cim.properties</span> <o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='mso-spacerun:yes'> </span><span class=GramE>and</span> pass it to the
client, for example </p>
<p class=MsoNormal style='text-indent:.5in;mso-layout-grid-align:none;
text-autospace:none'><span style='mso-spacerun:yes'> </span>#java -<span
class=SpellE>Dorg.snia.wbem.cimom.properties</span>=<span class=SpellE>cim.properties</span>
<span class=SpellE>TestClient</span><i><o:p></o:p></i></p>
<i style='mso-bidi-font-style:normal'><span style='font-size:12.0pt;mso-bidi-font-size:
10.0pt;font-family:Arial;mso-fareast-font-family:"Times New Roman";mso-ansi-language:
EN-US;mso-fareast-language:EN-US;mso-bidi-language:AR-SA'><br clear=all
style='page-break-before:always'>
</span></i>
<h2 style='tab-stops:.5in'><span style='font-style:normal;mso-bidi-font-style:
italic'>CIM Client FAQ<o:p></o:p></span></h2>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><b><span
style='font-size:12.0pt'><o:p> </o:p></span></b></p>
<p class=MsoNormal><b><span style='font-size:12.0pt'>I see my client hangs and
does not return or how to set timeouts in a Client?<o:p></o:p></span></b></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'><o:p> </o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'>When you have a SSL enabled client trying to connect
non-SSL <span class=SpellE>CIMServer</span> and vice-versa. You may notice that
the client does not return. In such case you should make sure to set the proper
timeouts.<o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'><o:p> </o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'>Here is how you can set the timeouts:<o:p></o:p></span></p>
<p class=MsoNormal style='text-indent:.5in;mso-layout-grid-align:none;
text-autospace:none'><span style='font-size:12.0pt'>1. Set READ timeout, refer
to <span class=SpellE>CIMClient</span> class<o:p></o:p></span></p>
<h3 style='margin-top:5.0pt;margin-right:0in;margin-bottom:5.0pt;margin-left:
0in;mso-layout-grid-align:none;text-autospace:none'><span style='mso-bidi-font-size:
12.0pt;font-family:"Times New Roman"'><span style='mso-spacerun:yes'> </span><span
style='mso-tab-count:2'> </span><span class=SpellE><span
class=GramE>CIMClient.setTimeout</span></span><span class=GramE>(</span><span
class=SpellE>int</span> timeout); //in milliseconds<o:p></o:p></span></h3>
<p class=MsoNormal style='margin-left:.5in;text-indent:.5in'><span
style='font-size:12.0pt'>This is a read timeout, i.e. the client has found the
server and connected to it, and the server is not responding to any request.
Basically the socket is blocked. This may happen in case of a Non-SSL client
connecting to SSL server and also vice versa. For your applications I think <span
class=SpellE><span class=GramE>setTimeout</span></span><span class=GramE>(</span>)
call is good enough.<o:p></o:p></span></p>
<p class=MsoNormal><span style='font-size:12.0pt'><o:p> </o:p></span></p>
<p class=MsoNormal style='text-indent:.5in;mso-layout-grid-align:none;
text-autospace:none'><span style='font-size:12.0pt'>2. To set the connection
timeout<o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'><span style='mso-spacerun:yes'> </span><span
style='mso-tab-count:2'> </span>//Assumption timeout is in
seconds<o:p></o:p></span></p>
<pre style='text-indent:.5in;tab-stops:.5in;mso-layout-grid-align:none;
text-autospace:none'><span style='font-size:12.0pt;font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman"'><span style='mso-spacerun:yes'> </span>Either you add the following line in your client program<o:p></o:p></span></pre>
<p class=MsoNormal style='margin-left:.5in;text-indent:.5in;mso-layout-grid-align:
none;text-autospace:none'><span class=SpellE><span class=GramE><span
style='font-size:12.0pt'>System.setProperty</span></span></span><span
class=GramE><span style='font-size:12.0pt'>(</span></span><span
style='font-size:12.0pt'>"java.net.connectiontimeout","20")
<o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'><span style='mso-spacerun:yes'> </span><span
style='mso-tab-count:1'> </span>Or<o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'><span style='mso-spacerun:yes'> </span><span
style='mso-tab-count:1'> </span>You can pass it at run time, using<o:p></o:p></span></p>
<p class=MsoNormal style='margin-left:.5in;mso-layout-grid-align:none;
text-autospace:none'><span style='font-size:12.0pt'><span
style='mso-spacerun:yes'> </span><span class=GramE>java</span> -<span
class=SpellE>Djava.net.connectiontimeout</span>=20<span
style='mso-spacerun:yes'> </span><span class=SpellE>myclient</span><o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'><o:p> </o:p></span></p>
<p class=MsoNormal><span style='font-size:12.0pt'><o:p> </o:p></span></p>
<p class=MsoNormal><b><span style='font-size:12.0pt'><o:p> </o:p></span></b></p>
<p class=MsoNormal><b><span style='font-size:12.0pt'>How to decode a property
that is an enumeration? I.E. to decode the numeric value that is returned for
the property.<span style='mso-spacerun:yes'> </span>Does WBEM provide methods
to look up the numeric value to retrieve a String value?<span
style='mso-spacerun:yes'> </span>Or do I need to implement a look up table for
every enumeration that I am interested in?<o:p></o:p></span></b></p>
<p class=MsoNormal><span style='font-size:12.0pt'> <o:p></o:p></span></p>
<pre style='tab-stops:.5in;mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt;font-family:"Times New Roman";mso-fareast-font-family:
"Times New Roman"'>The strings associated with enumeration property values are defined as </span><span
style='font-size:12.0pt;font-family:"Times New Roman"'>qualifiers on the class schema.<span style='mso-spacerun:yes'> </span>A client does not get these strings from a provider directly.<span style='mso-spacerun:yes'> </span>But rather than duplicate the string definitions on the client side, you can get them from the CIM server using a <span
class=SpellE>getClass</span> operation.<o:p></o:p></span></pre>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'><o:p> </o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'>For example, <span class=SpellE>PG_NISServerService</span><span
class=GramE>::</span> <span class=SpellE>ServerType</span> is an
enumeration.<span style='mso-spacerun:yes'> </span>When I make the request I
get a numeric value between 0 and 4 (inclusive).<span
style='mso-spacerun:yes'> </span>I then have to decode the numeric values as
such:<o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'><span style='mso-spacerun:yes'> </span>"0"
- Unknown<o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'><span style='mso-spacerun:yes'> </span>"1"
- Other<o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'><span style='mso-spacerun:yes'> </span>"2"
- Not an </span><st1:City><st1:place><span style='font-size:12.0pt'>NIS</span></st1:place></st1:City><span
style='font-size:12.0pt'> Server<o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'><span style='mso-spacerun:yes'> </span>"3"
- NIS Master<o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'><span style='mso-spacerun:yes'> </span>"4"
- </span><st1:City><st1:place><span style='font-size:12.0pt'>NIS</span></st1:place></st1:City><span
style='font-size:12.0pt'> Slave<o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'><o:p> </o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><b
style='mso-bidi-font-weight:normal'><span style='font-size:12.0pt'>How do I use
a <span class=SpellE>CIMInstance</span> to get a fully qualified <span
class=SpellE>CIMObjectPath</span> (i.e. a path with the class name and specific
keys)?<o:p></o:p></span></b></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'><o:p> </o:p></span></p>
<p class=MsoNormal><span style='font-size:12.0pt'>This creates a <span
class=SpellE>CIMObjectPath</span> with all of the properties correctly set.<o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'><o:p> </o:p></span></p>
<p class=MsoNormal><span style='font-size:12.0pt'><span
style='mso-spacerun:yes'> </span><span class=GramE>instances</span> = <span
class=SpellE>CIMClient.enumerateInstances</span>(<span class=SpellE>CIMObjectPath</span>(<span
class=SpellE>classname</span>, namespace), <span class=SpellE>CIMClient.DEEP</span>,
true, true, false, null);<o:p></o:p></span></p>
<p class=MsoNormal><span style='font-size:12.0pt'> <span
class=SpellE><span class=GramE>currentInstance</span></span> = (<span
class=SpellE>CIMInstance</span>)<span class=SpellE>instances.nextElement</span>();<o:p></o:p></span></p>
<p class=MsoNormal><span style='font-size:12.0pt'> <span
class=SpellE>CIMObjectPath</span> cop = new <span class=SpellE><span
class=GramE>CIMObjectPath</span></span><span class=GramE>(</span><span
class=SpellE>currentInstance.getClassName</span>(), "root/cimv2");<br>
<span class=SpellE>cop.setKeys</span>(<span
class=SpellE>currentInstance.getKeyValuePairs</span>());<o:p></o:p></span></p>
<p class=MsoNormal><span style='font-size:12.0pt'> <o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-family:"Courier New"'><o:p> </o:p></span></p>
<p style='text-align:justify;tab-stops:.5in'><b>The <span class=SpellE>cimclient</span>
library performs the SSL handshaking and receives the certificate/key, what
environment settings must be in place for certificates to be passed?<o:p></o:p></b></p>
<p style='text-align:justify;tab-stops:.5in'>Clients must create a trust store,
import certificates from the server they trust in to the trust store, provide
the trust store path to the JSSE either on the command line ( java -<span
class=SpellE>Djavax.net.ssl.trustStore</span>=<span class=SpellE>mytruststore</span>
<<span class=SpellE>MyClient</span>><span style='mso-spacerun:yes'>
</span>) or through</p>
<p style='text-align:justify;tab-stops:.5in'><span class=SpellE><span
class=GramE>System.setProperty</span></span><span class=GramE>(</span>"<span
class=SpellE>javax.net.trustStore</span>", "<span class=SpellE>mytruststore</span>");</p>
<p style='text-align:justify;tab-stops:.5in'><b>How do set ‘<span class=SpellE>trustManager</span>’
property </b><b><span style='font-size:10.0pt;font-family:Arial'>programmatically?<o:p></o:p></span></b></p>
<p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
style='mso-tab-count:1'> </span>String <span class=SpellE>myTrustManager</span>=
"<span class=SpellE>org.mycompany.cimapp.myCertManager</span>";<o:p></o:p></span></p>
<p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><span
style='mso-tab-count:1'> </span><span class=SpellE><span
class=GramE>GlobalConfig.setTrustManager</span></span><span class=GramE>(</span><span
class=SpellE>myTrustManager</span>);<o:p></o:p></span></p>
<p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>Note
that you can not set this property to ‘null’. If you would like to use the
default trust manager provided in JSSE, do not even define the trust manager
property in your program or in your properties file.<o:p></o:p></span></p>
<p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p> </o:p></span></p>
<h4>Can I change the trust manager property in between my program/process?</h4>
<p class=MsoNormal><b><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'><o:p> </o:p></span></b></p>
<p class=MsoNormal><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt'>No,
you cannot. If you define/set this property in your Client application either
using <span class=SpellE><span class=GramE>setTrustManager</span></span><span
class=GramE>(</span>) or through<span style='mso-spacerun:yes'> </span>WBEM
Client configuration file (like <span class=SpellE>cim.properties</span>) it
will be set once per process, I.E you can not set/unset for every connection
being in the same process.<o:p></o:p></span></p>
<p style='text-align:justify;tab-stops:.5in'><b>Does the <span class=SpellE>cimclient</span>
library accept the certificate and place it in the trust store?<span
style='mso-spacerun:yes'> </span>How would the application specify to the <span
class=SpellE>cimclient</span> library where the trust store is<o:p></o:p></b></p>
<p style='text-align:justify;tab-stops:.5in'>Client library using JSSE will
only validate the server certificate using the trust store. It accepts only
trusted certificates from the server. In case of non-trusted certificate the
client library will call the trust manager if there is one specified. It is the
job of trust manager to either accept the server certificate (possibly add that
to the trust store) or reject the certificate.</p>
<p style='text-align:justify;tab-stops:.5in'><b>How <span class=GramE>is the
client application</span> notified that the certificate or key was placed in
the trust store?<span style='mso-spacerun:yes'> </span>Is this assumed?<o:p></o:p></b></p>
<p style='text-align:justify;tab-stops:.5in'>Same as above</p>
<p style='text-align:justify;tab-stops:.5in'><b>Can the client application set
the environment so that certificates or keys are required from some target
systems but other target systems are not validated or authenticated?<o:p></o:p></b></p>
<p style='text-align:justify;tab-stops:.5in'>Yes, trust manager can do this.</p>
<p style='text-align:justify;tab-stops:.5in'><b>Where can I find more
information on Trust Manager and Trust Stores?<o:p></o:p></b></p>
<p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>More information
can be found at J2SE web site.<span style='mso-spacerun:yes'> </span>- ----</p>
<p style='margin-left:.5in;text-align:justify;tab-stops:.5in'><span
style='mso-bidi-font-family:"Courier New"'>http://java.sun.com/j2se/1.4/docs/guide/security/jsse/JSSERefGuide.html<o:p></o:p></span></p>
<p style='margin-left:.5in;text-align:justify;tab-stops:.5in'>http://java.sun.com/j2se/1.4/docs/api/javax/net/ssl/X509TrustManager.html
</p>
<p style='text-align:justify;tab-stops:.5in'><b>I am unable use/initialize SSL
connection, what do I do?<o:p></o:p></b></p>
<p style='text-align:justify;tab-stops:.5in'><span style='mso-bidi-font-family:
"Courier New"'>Some applications have their own version of Java included in it
and they use the included Java, not the one you installed on the systems (such
as the one from /opt/java). In such cases make sure that java security
configuration files are not modified.</span></p>
<p style='text-align:justify;tab-stops:.5in'><b>How can I find out <span
class=SpellE>cimclient.jar</span> version?<o:p></o:p></b></p>
<pre>You can run <span class=SpellE>PackageVersion</span> program to look at the version.</pre><pre><span style='mso-spacerun:yes'> </span><span
class=GramE>java</span> <span class=SpellE>org.snia.wbem.PackageVersion</span></pre><pre><span style='mso-spacerun:yes'> </span></pre>
<p style='text-align:justify;tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt'><b>My
GUI application doesn’t work properly on HP-UX?</b></p>
<p style='text-align:justify;tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt'>There
is a bug in Java 1.4 HP-UX version (and 1.3) AWT libraries. For this you will
need to install PHSS_24303 patch. I also found that Patch PHSS_24303 replaced
by PHSS_26262. So we will need PHSS_26262.</p>
<p class=MsoBodyText style='text-autospace:none'><span class=SpellE><span
class=GramE><span style='font-family:"Courier New"'>CIMInstance.getKeyValuePairs</span></span></span><span
class=GramE><span style='font-family:"Courier New"'>(</span></span><span
style='font-family:"Courier New"'>) returns no keys although there are multiple
keys in my (<span class=SpellE>exaple</span> <span class=SpellE>PG_OperatingSystem</span>
has 4 keys) provider.<o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-family:"Courier New"'><o:p> </o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-family:"Courier New"'>This bug is fixed in 2.0 Final Release.<span
style='mso-spacerun:yes'> </span>You should not see this bug.<o:p></o:p></span></p>
<p class=MsoNormal><span style='font-family:Arial;color:navy'><o:p> </o:p></span></p>
<p class=MsoNormal><span class=SpellE><b style='mso-bidi-font-weight:normal'><span
style='font-size:12.0pt'>CIMHTTPIndicationReceiver</span></b></span><b
style='mso-bidi-font-weight:normal'><span style='font-size:12.0pt'> -Exception:
<span class=SpellE>javax.net.ssl.SSLException</span>: No available certificate
corresponds to the SSL cipher suites which are enabled.<o:p></o:p></span></b></p>
<p class=MsoNormal><span style='font-size:12.0pt'>The certificate (<span
class=SpellE>i.e</span> a <span class=SpellE>keystore</span>) you are
passing to the Listener is either in incorrect format or may be the <span
class=SpellE>keystore</span> password is incorrect. <span
style='mso-spacerun:yes'> </span>You may want to verify the password and the certificate
format. Other thing you can do is - take the same certificate and see if you
can use it with a stand-alone listener (refer to SDK example listener
or if you have test listener you can use it with).<o:p></o:p></span></p>
<p style='text-align:justify;tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt'><b
style='mso-bidi-font-weight:normal'><o:p> </o:p></b></p>
<h2 style='tab-stops:.5in'><span style='font-style:normal;mso-bidi-font-style:
italic'>CIM Listener FAQ<o:p></o:p></span></h2>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><b><span
style='font-size:12.0pt'>How to Create Subscriptions?</span></b><span
style='font-size:12.0pt'><o:p></o:p></span></p>
<p>Creating subscription is same as creating any CIM instance...you will use
CIM Client interfaces to do so. Currently WBEM (core <span class=SpellE>CIMServer</span>)
only supports <span class=SpellE>CIM_IndicationSubscription</span>, <span
class=SpellE>CIM_IndicationFilter</span>, <span class=SpellE><span class=GramE>CIM</span>_IndicationHandlerCIMXML</span>
and <span class=SpellE>IndicationHandlerSNMPMapper</span> classes.<o:p></o:p></p>
<p><b>When a listener is created, does it execute in its own thread, separate
from the code that created it</b><o:p></o:p></p>
<p class=MsoNormal><span style='font-size:12.0pt'>Listener runs as server
(either SSL or non-SSL) and listens on the specified port. When Listener <span
class=SpellE><span class=GramE>startCIMHTTPListener</span></span><span
class=GramE>(</span>) is called, it will create a thread and starts listening.<br>
<o:p></o:p></span></p>
<p style='margin:0in;margin-bottom:.0001pt'><o:p> </o:p></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><b><span
style='font-size:12.0pt'>I am unable to modify instances of <span class=SpellE>CIM_IndicationHandlerCIMXML</span>
class.<span style='mso-spacerun:yes'> </span>Client says - Unable to modify
instance: CIM_ERR_NOT_<span class=GramE>FOUND(</span>CIM_ERR_NOT_FOUND: The
requested object could not be found: "<span class=SpellE>CIM_IndicationHandlerCIMXML</span>")<o:p></o:p></span></b></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><b><span
style='font-size:12.0pt'><o:p> </o:p></span></b></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'>The <span class=SpellE>modifyInstance</span> operation
is not supported for the<o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
class=SpellE><span style='font-size:12.0pt'>CIM_IndicationHandlerCIMXML</span></span><span
style='font-size:12.0pt'> class or <span class=SpellE>CIM_IndicationFilter</span>
class, and <span class=GramE>for<span style='mso-spacerun:yes'> </span><span
class=SpellE>CIM</span></span><span class=SpellE>_IndicationSubscription</span>,
only modification of the <span class=SpellE>SubscriptionState</span>
property<span style='mso-spacerun:yes'> </span>is supported.<span
style='mso-spacerun:yes'> </span>So, it's necessary to delete the old instance
and create a new instance with the desired change.<span
style='mso-spacerun:yes'> </span>Also, deletion of a filter or handler that is
referenced by an existing subscription is not allowed, without first<o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
class=GramE><span style='font-size:12.0pt'>deleting</span></span><span
style='font-size:12.0pt'> the subscription.<o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'><o:p> </o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'>However, in the case you should see something like
"CIM_ERR_NOT_SUPPORTED: The requested operation is not supported",
rather than CIM_ERR_NOT_FOUND.<span style='mso-spacerun:yes'> </span>Make sure
to check that your request specifies <span class=GramE>the<span
style='mso-spacerun:yes'> </span>correct</span> namespace, key values,
etc.<span style='mso-spacerun:yes'> </span>It looks like perhaps the <span
class=SpellE>instancename</span> parameter to the <span class=SpellE>modifyInstance</span>
operation included only the <span class=SpellE>classname</span> and not the key
values.<o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'><o:p> </o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><b><span
style='font-family:"Courier New"'><o:p> </o:p></span></b></p>
<p class=MsoBodyText2><b>If I create instances of <span class=SpellE>CIM_IndicationFilter</span>,
and corresponding instances of <span class=SpellE>CIM_IndicationSubscription</span>,
and <span class=SpellE>CIM_IndicationHandlerCIMXML</span> classes, does the
CIMOM check for the presence of the Indication provider? <span class=GramE>if</span>
'<span class=SpellE>RT_TestIndication</span>'(sample indication provider) is
not present, Will it give an error response?<o:p></o:p></b></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-family:"Courier New"'><o:p> </o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-family:"Courier New"'>When you create an enabled Subscription, the <span
class=SpellE>IndicationService</span> will look for indication providers that
can serve the subscription.<span style='mso-spacerun:yes'> </span>If none are
found, you will get an error response.<span style='mso-spacerun:yes'>
</span>The subscriber doesn't specify an indication provider. The subscriber
specifies the desired indication subclass, properties and namespace in the
Filter.<span style='mso-spacerun:yes'> </span>The <span class=SpellE>IndicationService</span>
looks for indication providers that have registered to serve the specified
indication class in the specified namespace.<span style='mso-spacerun:yes'>
</span>Maybe your indication provider is not registered?<span
style='mso-spacerun:yes'> </span>Let me know if you need help registering your
indication provider.<o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-family:"Courier New"'><o:p> </o:p></span></p>
<p class=MsoBodyText2><b>If I create a disabled subscription (the property <span
class=SpellE>SubscriptionState</span> is set to 'Disabled'), will the <span
class=SpellE>IndicationService</span> still check for the presence of the
indication provider?<o:p></o:p></b></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-family:"Courier New"'><o:p> </o:p></span></p>
<p class=MsoBodyText><span style='font-weight:normal'>If you create the
Subscription with <span class=SpellE>SubscriptionState</span> property set to
'Disabled', the <span class=SpellE>IndicationService</span> will NOT check
whether there is an indication provider to serve the subscription.<span
style='mso-spacerun:yes'> </span>So maybe that's what you want to do for now,
to get going.<o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-family:"Courier New"'><o:p> </o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><b><span
style='font-size:12.0pt'>Since the <span class=SpellE>IndicationService</span>
knows which indication subclass is served by an indication provider, is it
required that the instances of indication classes be created before the
provider is registered?<o:p></o:p></span></b></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><b><span
style='font-family:"Courier New"'><o:p> </o:p></span></b></p>
<p class=MsoBodyText><span style='font-weight:normal'>The <span class=SpellE>IndicationService</span>
checks that the class specified in the Filter is a subclass of <span
class=SpellE>CIM_Indication</span>, so you must define the indication subclass
you'll be using.<span style='mso-spacerun:yes'> </span>(Instances of the
indication subclass don't get created until the indication provider generates
an indication.)<o:p></o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-family:"Courier New"'><o:p> </o:p></span></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><b><span
style='font-family:"Courier New"'><o:p> </o:p></span></b></p>
<p class=MsoNormal><b><span style='font-size:12.0pt'>How a particular listener
is associated with a given subscription and what goes into the Destination
property CIM_ <span class=SpellE>IndicationHandlerCIMXML</span><o:p></o:p></span></b></p>
<p><span style='font-size:10.0pt;font-family:"Courier New"'>The listener is
associated with the subscription through the destination property of the
handler instance. Multiple subscriptions can refer to the same handler instance;
so one listener can listen to multiple subscriptions.</span><span
style='font-size:10.0pt;mso-bidi-font-size:12.0pt;font-family:"Courier New"'><o:p></o:p></span></p>
<p><span style='font-size:10.0pt;font-family:"Courier New"'>With subscription
you will specify the destination where the Listener is running. An example,</span><span
style='font-size:10.0pt;mso-bidi-font-size:12.0pt;font-family:"Courier New"'><o:p></o:p></span></p>
<p style='margin:0in;margin-bottom:.0001pt'><span style='font-size:10.0pt;
font-family:"Courier New"'><PROPERTY NAME="Destination"
TYPE="string"><o:p></o:p></span></p>
<p style='margin:0in;margin-bottom:.0001pt'><span style='font-size:10.0pt;
font-family:"Courier New"'><VALUE>https://mysystem.cup.hp.com:8189/cimom/Pegasus_RT_IndicationConsumer</VALUE><o:p></o:p></span></p>
<p style='margin:0in;margin-bottom:.0001pt'><span style='font-size:10.0pt;
font-family:"Courier New"'></PROPERTY></span><span style='font-size:10.0pt;
mso-bidi-font-size:12.0pt;font-family:"Courier New"'><o:p></o:p></span></p>
<p><span style='font-size:10.0pt;mso-bidi-font-size:12.0pt;font-family:"Courier New"'>In
the above case, Listener would be running on mysystem.cup.hp.com at port 8189
with SSL enabled.</span><span style='font-family:"Courier New"'> <o:p></o:p></span></p>
<p><b>Can I specify/use any port number with my Listener?<o:p></o:p></b></p>
<p><span style='font-size:10.0pt;font-family:"Courier New"'>It is not a good
plan to select any port and have the application use it.<span
style='mso-spacerun:yes'> </span>It is recommended that a Listener application
to have its own port number and is registered with IANA so that no one
else uses that port number. And also if the application is going to be running
on HP-UX, you can request INET Team to have the IANA registered port number
added to /etc/services. This way no other HP-UX application uses your port
numbers.<o:p></o:p></span></p>
<p class=MsoNormal><b><span style='font-size:12.0pt'>When the client creates
the indication listener, does it return an error if a listener already exists
on that system on the same port? <o:p></o:p></span></b></p>
<p class=MsoNormal><span style='font-family:"Courier New"'><o:p> </o:p></span></p>
<p class=MsoNormal><span style='font-family:"Courier New"'>Yes it does say
- Address is in use.<o:p></o:p></span></p>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt'><b><span
style='font-size:12.0pt'>Create Instance for <span class=SpellE>CIM_IndicationSubscription</span>
fails; However, I can create Handler and Filter instances.<o:p></o:p></span></b></p>
<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt'><b><span
style='font-size:12.0pt'><o:p> </o:p></span></b></p>
<p class=MsoNormal style='mso-layout-grid-align:none;text-autospace:none'><span
style='font-size:12.0pt'>There is a problem with Java Client API while creating
instance with reference values related to indication subscription class. This
is mainly because of <span class=GramE>Each</span> time the <span class=SpellE>ObjectPath</span>
gets passed to CIM Operations, Client API modifies the <span class=SpellE>CIMObjectPath</span>
after it gets the response from <span class=SpellE>cimserver</span>. The work
around is to store the <span class=SpellE>CIMObjectPath</span> that is passed
to <span class=SpellE><span class=GramE>createInstance</span></span><span
class=GramE>(</span>) while creating Filter and Handler instances. Then use
that stored paths in Subscription.<o:p></o:p></span></p>
<p class=MsoNormal style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt'><span
style='font-size:12.0pt'>Refer to the example (examples/Indication/<span
class=SpellE><span class=GramE>SubscribeIndTest.java</span></span><span
class=GramE> )</span> that is in WBEM Java Client SDK.<o:p></o:p></span></p>
<p class=MsoNormal><o:p> </o:p></p>
</div>
</body>
</html>
| No CVS admin address has been configured |
Powered by ViewCVS 0.9.2 |