This data sheet provides information about
the Domain Name System WBEM provider (implemented using the Pegasus C++ API).
This provider supports the PG_DNSAdminDomain
class. The intended audience of this document is client/provider developers and
sophisticated end-users who want to use this provider.
This data sheet is maintained in open source
and is updated frequently. This version
was last updated 17-Jun-2002. See the
Pegasus open source site (http://cvs.opengroup.org/cgi-bin/cvsweb.cgi/pegasus/),
location
pegasus/src/Providers/ManagedSystem/DNSAdminDomain/doc/DNSProvider.htm, for the
most recent version.
Keywords: (Pegasus
C++ API, Domain Name System, HP-UX, Managed System Identity,
CIM_AdminDomain, PG_DNSAdminDomain)
Table Of Contents
1.
Provider Overview
(Description, Requirements, Release
History, Supported Managed Resources,
Special Requirements & Dependencies)
2.
Setting Up This Provider (Installing,
Configuring)
3.
Using This Provider
(Schema
Supported, Indications Generated, Associations Provided)
4.
Links To More Information (Additional Provider
Documentation, WBEM
Information, Managed Resource
Information, Client Information, Support Contacts, Migration and Co-existence
Information, Possible Provider
Enhancements)
5.
Limitations, Known Defects, and Performance
Considerations
·
Description
This provider is an extension of the
AdminDomain class that describes a Domain Name System (DNS). This Domain
Name System provider implements a PG_DNSAdminDomain subclass of
CIM_AdminDomain (adding the properties of SearchList and Addresses). The
SearchList property specifies the search list for hostname
lookup. The Addresses property specifies the IP address(es) in dot
notation format of the name server(s) that the resolver should query.
·
Requirements
The Domain Name System provider is
implemented and tested on PA-RISC running HP-UX 11.0 and 11.11. It will be
tested on IPF and PA-RISC machines running HP-UX 11.23 when it is available.
·
Release History
??-Aug-02 - initial release of
PG_DNSAdminDomain provider for the HP-UX operating system (via submittal to
Pegasus open source community).
·
Supported Managed Resources
Managed systems (servers,
appliances, desktops) running HP-UX 11.0, 11.11 and 11.23.
·
Special
Requirements & Dependencies
DNS needs to be installed for the
provider to return instances. If it is not installed, no instances will be
returned.
The DNS provider is IPv6 compliant, which means that it is capable of reading
both IPv4 and IPv6 addresses from the DNS configuration file.
This Domain Name System provider is available from
the Pegasus open source site (http://cvs.opengroup.org/cgi-bin/cvsweb.cgi/pegasus/)
with the following CVS tree locations:
o Makefile, headers, and source: pegasus/src/Providers/ManagedSystem/DNSAdminDomain/
o Schema MOF file:
pegasus/Schemas/pegasus/ManagedSystem/VER20/PG_DNSAdminDomain20.mof
o Provider registration MOF file: pegasus/Schemas/pegasus/ManagedSystem/VER20/PG_DNSAdminDomain20R.mof
The provider executable is "
libDNSProvider.sl" and is called "DNSProvider" in the
registration MOF. The provider is registered to support the /root/cimv2
namespace as an instance provider. There are no special installation
instructions. This provider may be installed by default in Pegasus-based
product releases.
·
Configuring This
Provider
This provider does not accept specific configuration
adjustments (beyond standard WBEM support).
·
Schema supported by
this provider
This provider
supports the PG_DNSAdminDomain class.
Tables 1 through 2 describe the properties and methods supported by the
provider. Specific details of the schema supported by this provider (including
property descriptions and value maps) are available in the MOF files.
Table 1 describes
the properties of the PG_DNSAdminDomain class.
It has three columns. The first
is the property name (including type and units), the second is the property
inheritance (indicating which class or superclass defines the property), and
the third is the property’s value or data source. Each row describes a property.
Table 1: PG_DNSAdminDomain Properties
Property Name |
Property Inheritance |
Property Value (&
data source) |
string Caption |
Inherited from CIM_ManagedElement |
HP-UX: Returns "DNS Admin Domain" Linux, Windows: Not implemented |
string Description |
Inherited from CIM_ManagedElement |
HP-UX: Returns "This is the PG_DNSAdminDomain object” Linux, Windows: Not implemented |
String CreationClassName [Key] |
Inherited from CIM_System |
HP-UX: Returns "PG_DNSAdminDomain" Linux, Windows: Not implemented |
string Name [Key] |
Inherited from CIM_ManagedSystemElement (and made one of 2 keys of CIM_System) |
HP-UX: Returns “domain” field from /etc/resolv.conf file Linux, Windows: Not implemented |
string NameFormat |
Inherited from CIM_System, overridden in CIM_AdminDomain |
HP-UX: Returns 1 (“IP”). Linux, Windows: Not implemented |
string SearchList[] |
Local to PG_DNSAdminDomain |
HP-UX: Returns
“search” field from /etc/resolv.conf file Linux,
Windows: Not
implemented |
string Addresses[] |
Local to PG_DNSAdminDomain |
HP-UX: Returns
“nameserver” field from /etc/resolv.conf file Linux, Windows: Not implemented |
Table 2 describes
the intrinsic methods supported by this provider. It has three columns. The
first is the method name, the second is a description of the provider’s actions
based on invoking that method, and the third is a list of any exceptions that
could result from invoking the method.
Each row describes a method. Note that this provider supports no
extrinsic methods.
Table 2:
Intrinsic Methods for PG_DNSAdminDomain
Method Name |
Description |
Exceptions thrown |
EnumerateInstances |
Returns all instances of
the class with all properties. There is only one instance. |
CIM_ERR_NOT_SUPPORTED if wrong class (different than PG_DNSAdminDomain). |
EnumerateInstanceNames |
Returns all instances of the class with key properties.
There is only one instance. |
CIM_ERR_NOT_SUPPORTED if wrong class (different than PG_DNSAdminDomain). |
GetInstance |
Supported |
CIM_ERR_INVALID_PARAMETER (if wrong class, wrong
number of keys, or wrong keys) CIM_ERR_NOT_FOUND (from
CIMOM) if no instance |
ModifyInstance |
Returns Not Supported |
CIM_ERR_NOT_SUPPORTED |
DeleteInstance |
Returns Not Supported |
CIM_ERR_NOT_SUPPORTED |
Initialize |
Does nothing |
None |
Terminate |
Does nothing |
None |
CreateInstance |
Returns Not Supported |
CIM_ERR_NOT_SUPPORTED |
·
Indications generated
by this provider
This provider does not currently
generate any indications.
·
Associations
provided by this provider
This provider does not currently support any associations
(but possible extensions would be to add the NetworksInAdminDomain association
to LogicalNetwork and the NetworkServicesInAdminDomain association to
NetworkService).
·
Additional Provider
Documentation
There is currently no additional
documentation for this provider beyond this information and that in the Pegasus
source tree (listed in Installing This Provider).
For DNS specific information on HP-UX systems, see the System Administrator Manager (SAM) help pages, or launch “man resolv.conf”.
·
WBEM information
For a CIM tutorial, go to http://dmtf.org/education/cimtutorial.php.
For information about the Pegasus WBEM infrastructure, see http://www.opengroup.org/pegasus.
For information about WBEMsource, see http://www.wbemsource.org.
·
Managed Resource
Documentation
Information regarding domain name systems can be found
in network manuals.
·
Support Contacts
ON HP-UX, use standard HP support channels.
·
Migration and
Co-existence Information
None.
·
Possible provider
enhancements
There are a number of enhancements
that could be made to this provider.
(1) All properties are currently read-only.
Could add support to change appropriate values (probably via
modifyInstance). Support for
createInstance and deleteInstance could also be added, though the maximum
number of instances could never exceed one instance. CreateInstance could be
used to configure DNS if the provider is returning no instances, whereas
deleteInstance could be used to remove DNS configurations.
(2) The provider currently doesn’t check Flags when invoked by CIMOM.
(3) The provider currently doesn’t check Property List when invoked by CIMOM.
(4) Support for NetworksInAdminDomain and NetworkServicesInAdminDomain
associations would be useful.
On HP-UX, the DNS provider parses the /etc/resolv.conf file directly.
Therefore, the provider would be impacted if the file format or location
changes.
Domain names specified in both Name and SearchList properties are limited to 256 characters.