RIS Core Schema - Version

Last Modified:

Class Netscape::top

The Netscape:top class is used as a superclass for all other object classes in the directory. The top object class is an abstract class and is reserved for use by the directory server. RFC 2256 specifies the top object class must be recognized by all LDAP server implementations. The following is the Netscape definition for the top object class.

attribute	required	single-value	type	description
objectClass	true	false	string	Defines the object classes for the entry. An object in a directory can be created from more than one object class.
aci	false	false	binary	Defines the directory server access control information for this entry.

Class Grid::Preferences

This class is used to store user preferences. Currently preferences are defined as key/value pairs and are stored as key=value.

Superior = Netscape::top
RDN = uniqueName
Child Of

Grid::Person

attribute	required	single-value	type	description
uniqueName	true	false	string	A name that is unique to the object class in order to support the lookup of an object.
mail	false	false	string	An electronic mailing address.
keyvalue	false	false	keyValue	A key/value pair of the form key=value.

Class X500::organization

This class defines entries that represent organizations. This is the X.500 definition as implemented by Netscape. Note that this class is defined to be recursive - organizations can consist of other organizations. We purposely did not use the organizationalUnit class since it seemed to merge with the definition of organization over time.

Superior = Netscape::top
RDN = o
Child Of

X500::organization

attribute	required	single-value	type	description
o	true	false	string	The name of the organization.
businessCategory	false	false	string	Business in which the entity is involved. Examples are profit, nonprofit, research, government, educational, university.
description	false	false	string	Description of the entity.
destinationIndicator	false	false	string	The country and city associated with the entry to provide Public Telegram Service.
facsimileTelephoneNumber	false	false	phone	Fax number associated with the entity.
internationalIsdnNumber	false	false	ces	Contains an ISDN number for the entity.
l	false	false	string	The entity's location(s).
physicalDeliveryOfficeName	false	false	string	The location where physical deliveries can be made to the entity.
postalAddress	false	false	string	The entity's mailing address.
postalCode	false	false	string	The entity's postal code (such as United States zip code).
postOfficeBox	false	false	string	The entity's post office box.
preferredDeliveryMethod	false	false	string	The entity's preferred method of contact or delivery.
registeredAddress	false	false	string	Postal address suitable for reception of expedited documents where the recipient must verify delivery.
searchGuide	false	false	ces	Specifies information for suggested search criteria when using the entry as the base object in the directory tree for a search operation.
seeAlso	false	false	dn	URL to information relevent to the entity.
st	false	false	string	State or province in which the entity resides.
street	false	false	string	Street address at which the entity is located.
telephoneNumber	false	false	phone	Telephone number associated with the entity.
teletexTerminalIdentifier	false	false	string	Identifier for the teletex terminal of the entity.
telexNumber	false	false	string	Telex number of the entity represented by the object.
userPassword	false	false	binary	Password with which the entity represented by the object can bind to the directory.
x121Address	false	false	ces	The X.121 address of the entity represented by the object.

Class X500::person

X.500::person is an abstract class that generically represents people. This is the X.500 definition as implemented by Netscape.

Superior = Netscape::top

attribute	required	single-value	type	description
cn	true	false	string	A person's common name or fullname.
sn	true	false	string	A person's surname or last name.
description	false	false	string	Description of the entity.
seeAlso	false	false	dn	URL to information relevent to the entity.
telephoneNumber	false	false	phone	Telephone number associated with the entity.
userPassword	false	false	binary	Password with which the entity represented by the object can bind to the directory.

Class X500::organizationalPerson

X.500::organizationalPerson defines entries for people employed by an organization. This abstract class is the X.500 definition as implemented by Netscape.

Superior = X500::person

attribute	required	single-value	type	description
destinationIndicator	false	false	string	The country and city associated with the entry to provide Public Telegram Service.
facsimileTelephoneNumber	false	false	phone	Fax number associated with the entity.
internationalIsdnNumber	false	false	ces	Contains an ISDN number for the entity.
l	false	false	string	The entity's location(s).
ou	false	false	string	Organizational unit to which the person belongs.
physicalDeliveryOfficeName	false	false	string	The location where physical deliveries can be made to the entity.
postalAddress	false	false	string	The entity's mailing address.
postalCode	false	false	string	The entity's postal code (such as United States zip code).
postOfficeBox	false	false	string	The entity's post office box.
preferredDeliveryMethod	false	false	string	The entity's preferred method of contact or delivery.
registeredAddress	false	false	string	Postal address suitable for reception of expedited documents where the recipient must verify delivery.
st	false	false	string	State or province in which the entity resides.
street	false	false	string	Street address at which the entity is located.
teletexTerminalIdentifier	false	false	string	Identifier for the teletex terminal of the entity.
telexNumber	false	false	string	Telex number of the entity represented by the object.
title	false	false	string	A person's job title.
x121Address	false	false	ces	The X.121 address of the entity represented by the object.

Class Netscape::inetOrgPerson

inetOrgPerson represents people in an organization's enterprise network.

Superior = X500::organizationalPerson
RDN = mail
Child Of

X500::organization

attribute	required	single-value	type	description
audio	false	false	binary	Contains a sound file in binary format.
businessCategory	false	false	string	Business in which the entity is involved. Examples are profit, nonprofit, research, government, educational, university.
carLicense	false	false	string	The license plate number(s) for vehicle(s).
departmentNumber	false	false	string	A unique identifier for a department within an organization.
displayName	false	false	string	Preferred name of a person to be used when displaying entries.
employeeNumber	false	false	string	A unique identifying number associated with an employee.
employeeType	false	false	string	The person's type of employment (for example, full time)
givenName	false	false	string	The person's given or first name.
homePhone	false	false	phone	The person's home phone number.
homePostalAddress	false	false	string	The person's home mailing address
initials	false	false	string	The person's initials.
jpegPhoto	false	false	binary	An image in JPEG format.
labeledURL	false	false	uri	A univeral resource locator that is relevent to the person.
mail	false	false	string	An electronic mailing address.
manager	false	false	dn	Distinguished name representing a manager.
mobile	false	false	phone	A mobile telephone number.
pager	false	false	phone	A pager phone number.
photo	false	false	binary	A photo, in binary form.
preferredLanguage	false	false	string	Defines a person's preferred written or spoken launguage.
roomNumber	false	false	string	The room number in which the entity represented by this object is located..
secretary	false	false	dn	A secretary or administrator for a person or group.
uid	false	false	string	Identifies the entry's userid (usually the logon id).
userCertificate	false	false	binary	Contains a user's certificate. Store this attribute with the binary subtype: userCertificate;binary.
userPKCS12_binary	false	false	integer	Identifies the PKCS-12 PFX PDU used to store a user's key and certificate. This is generated by the certificate server and consumed by Netscape communicator.
userSMIMECertificate	false	false	binary	Used by Netscape Communicator for s/MIME. Should only be used with the binary subtype.
x500UniqueIdentifier	false	false	binary	Undefined.

Class Grid::Person

Grid::Person objects represent people in a grid environment. We may need to redundantly add the mail attribute to this definition because it is the rdn for this class. This would be redundant because it is inherited from the inetOrgPerson class.

Superior = Netscape::inetOrgPerson
RDN = mail
Child Of

X500::organization

attribute	required	single-value	type	description
city	false	false	string	City of the person for postal contact.
c	false	false	string	Country of residence.
employer	false	false	string	Organization the person is employed by.
o	false	false	string	The name of the organization.

Class Grid::PhysicalResource

An abstract class for any physical resources, e.g. computers, instruments...

Superior = Netscape::top

attribute	required	single-value	type	description
resourceOwner	false	false	string	The owner of the entity.
description	false	false	string	Description of the entity.
seeAlso	false	false	dn	URL to information relevent to the entity.

Class Grid::ComputeResource

A computational resource that runs computational codes.

Superior = Grid::PhysicalResource
RDN = hn
Child Of

X500::organization

attribute	required	single-value	type	description
hn	true	false	string	The host name(s) for a compute resource. Names should include the full domain name. IP addresses can also be used.
totalNodes	true	true	positive-integer	The total number of nodes that comprise the compute resource.
totalProcessors	false	true	positive-integer	The total number of processors for the compute resource.
cpuSpeed	false	false	decimal	The clockrate of the CPUs in MHz.
manufacturer	false	false	string	The manufacturer name.
machineHardwareName	false	false	string	The machine hardware name as provided by the vendor.
architecture	false	true	string	The memory architecture of the machine. One of Shared, Distributed, or Hybrid.
model	false	false	string	The model of the compute resource. On many systems this is different from the machine hardware name.
osName	false	true	string	The operation system name (SunOS, IRIX).
osVersion	false	true	string	The operationg system version (uname -r).
scriptHeader	false	true	textBlock	A script header template used for submitting jobs. The entry is a multi-line text script. This header information applies to compute resources with queue management systems and is needed for machine customization only.
scriptBody	false	true	textBlock	A customized job script template. This is separated from the header because headers are often customized but bodies are not. This is not currently being used, instead the runScript attribute of the software object is being used, but if that proves insufficient then this attribute will need to be utilized.
networkDisks	false	false	string	Names of network disks that are available from a compute resource.

Class Grid::NetworkDisk

A disk drive available from the network, used for shared installs of software.

Superior = Grid::PhysicalResource
RDN = diskName
Child Of

X500::organization

attribute	required	single-value	type	description
diskName	true	true	string	Unique name for the network-available disk drive.
diskType	true	true	string	What is the type of the network disk drive (e.g. afs, nfs, etc.)

Class Grid::ResourceManager

Grid::ResourceManager is an abstraction for the type of job scheduling service available on a machines. Examples include Maui, NQE, NQS, LoadLeveler. This class also contains information about how the queue is configured and installed.

Superior = Netscape::top
RDN = mn
Child Of

Grid::ComputeResource

attribute	required	single-value	type	description
mn	true	true	string	specifies the type/name of the job broker/scheduler. Values are unix, loadleveler, maui, nqe, nqs.
hn	true	false	string	The host name(s) for a compute resource. Names should include the full domain name. IP addresses can also be used.
releaseTag	false	true	string	A string that represents a software release number. This number should be unique for any given product version. It would be nice to define this as a type but for now we leave it as a string.
allocationAccounts	false	true	boolean	True if an allocation account is requied in order to submit a job.
autoPick	false	true	boolean	True if the scheduler is configured to automatically pick a queue based on constraints passed with a job request. NQE is often configured this way.
installDirectory	false	true	file	Location where resource manager software is installed.
binDirectory	false	true	file	Location of resource manager commands such as qsub... This may be relative to the installDirectory.
queue	false	false	dn	The distinguished names of the queues that are associated with this resource manager. Not currently being used, since queues are children of the resource manager in the DIT.

Class Grid::Queue

This class contains information about a queue and how it is configured.

Superior = Netscape::top
RDN = qn
Child Of

Grid::ResourceManager

attribute	required	single-value	type	description
qn	true	false	string	Name of queue(s) under which the job is running.
mn	true	true	string	specifies the type/name of the job broker/scheduler. Values are unix, loadleveler, maui, nqe, nqs.
hn	true	false	string	The host name(s) for a compute resource. Names should include the full domain name. IP addresses can also be used.
defaultMaxCPUTime	false	true	timeInstant	Maximum cpu time before a job will be automatically terminated.
defaultMaxWallTime	false	true	timeInstant	Maximum wall time before a job will be automatically terminated.
defaultNodes	false	true	positive-integer	A default number of nodes to use for a given queue. This is not necessarily enforced by the queue system.
defaultSingleMemory	false	true	positive-integer	Default amount of memory to allocate per node.
defaultTotalMemory	false	true	positive-integer	Default amount of memory to allocate for all nodes.
minProcesses	false	true	positive-integer	Minimum number of processes that a job must request in this queue.
maxProcesses	false	true	positive-integer	Maximum number of processes that can be allocated to a job running under the queue.
maxSingleMemory	false	true	positive-integer	Maximum memory that can be allocated per task within a job.
maxTotalMemory	false	true	positive-integer	Maximum total memory for a job for all nodes.
maxWallTime	false	true	timeInstant	The maximum elapsed time a job can run before it is ejected by the queue manager. This value is also used as an input to load balancing algorithms on some systems (i.e. Maui).

Class Grid::QueueEntry

A queue entry represents a job that is submitted to a queue, is running, or has recently completed. This class must contain enough information so that processes can connect up to proxies associated with the running job (i.e. a job monitor).

Superior = Netscape::top
RDN = qen
Child Of

Grid::Person

attribute	required	single-value	type	description
qen	true	true	string	Identifer that is comprised of the machine name and the job id, in this format "hn:jobID"
hn	true	false	string	The host name(s) for a compute resource. Names should include the full domain name. IP addresses can also be used.
jobId	true	true	string	The job id as provided by the resource manager.
proxyId	true	true	string	The id for the proxy (monitor) associated with a job.
proxyPort	true	true	positive-integer	Port number to contact the proxy.
nodes	true	true	positive-integer	Number of nodes allocated to this job.
qn	true	false	string	Name of queue(s) under which the job is running.
runDirectory	true	true	file	Path to location where job is running.
jobStatus	true	true	string	Status of job (submitted, running, completed, incomplete, failed).
uid	true	false	string	Identifies the entry's userid (usually the logon id).
mail	true	false	string	An electronic mailing address.
description	true	false	string	Description of the entity.
accountId	false	false	string	Identifies the logon id (if different then the userid).
startTime	false	false	timeInstant	Time when job started running.
submitTime	false	false	timeInstant	Time when job was submitted.
finishTime	false	false	timeInstant	Time when job stopped running.

Class Grid::QueueTemplates

The class contains queue submission default scripts per resource manager type. For resouce managers like Maui, this information is often overridden by the same attributes in Grid::ComputeResource.

Superior = Netscape::top
RDN = mn
Child Of

X500::organization

attribute	required	single-value	type	description
mn	true	true	string	specifies the type/name of the job broker/scheduler. Values are unix, loadleveler, maui, nqe, nqs.
scriptHeader	true	true	textBlock	A script header template used for submitting jobs. The entry is a multi-line text script. This header information applies to compute resources with queue management systems and is needed for machine customization only.
scriptBody	true	true	textBlock	A customized job script template. This is separated from the header because headers are often customized but bodies are not. This is not currently being used, instead the runScript attribute of the software object is being used, but if that proves insufficient then this attribute will need to be utilized.

Class Grid::RepositorySoftware

A repository software object stores information related to software that is independent of any particular installation of the software. Essentially it contains meta-data about the code itself.

Superior = Netscape::top
RDN = rsw
Child Of

X500::organization

attribute	required	single-value	type	description
rsw	true	true	string	The identifier for the software package, comprised of the name and releaseTag attributes, i.e. "name:releaseTag"
objName	true	true	string	An identifying name for an object.
releaseTag	true	true	string	A string that represents a software release number. This number should be unique for any given product version. It would be nice to define this as a type but for now we leave it as a string.
domainClassification	true	false	string	A classification of the domain the software falls into e.g. Parallel Processing Tools Communication Libraries, electronic structure chemistry.
contact	false	false	dn	Distinguished name of the point of contact for the software
description	false	false	string	Description of the entity.
seeAlso	false	false	dn	URL to information relevent to the entity.

Class Grid::Software

The Grid::Software object stores information related to software that is installed on a machine. It is currently not designed to reflect software installed "on the network" - Not entirely true (look at childof). Need to add attribute for NetworkDisk?

Superior = Netscape::top
RDN = sw
Child Of

Grid::ComputeResource
Grid::NetworkDisk

attribute	required	single-value	type	description
sw	true	true	string	the identifier for the installed software, comprised of the software name and releaseTag attributes, i.e. "name:releaseTag"
objName	true	true	string	An identifying name for an object.
releaseTag	true	true	string	A string that represents a software release number. This number should be unique for any given product version. It would be nice to define this as a type but for now we leave it as a string.
hn	false	false	string	The host name(s) for a compute resource. Names should include the full domain name. IP addresses can also be used.
environment	false	false	keyValue	Key/value pairs of environment variables that may or must be set to use the software.
installDirectory	false	true	file	Location where resource manager software is installed.
binDirectory	false	true	file	Location of resource manager commands such as qsub... This may be relative to the installDirectory.
libDirectory	false	false	file	Specifies the directory in which the libraries can be found, e.g. /usr/local/lib
executables	false	false	string	Specifies the names of executables appropriate for this machine. This does not include the path which can be derived from other attributes.
runScript	false	true	textBlock	Tailored script for executing the software, independent of compute platform.
envScript	false	true	textBlock	Script to be invoked to configure the environment for the software. The strategy for the use of these script is OBE by the use of runScript. If using runScript is sufficient then this can be removed.

Class Grid::Daemon

A Grid::Daemon stores information about daemons running on a system. Examples are globus gatekeeper, sshd, telnetd, HBM datacollector.

Superior = Grid::Software
RDN = da
Child Of

Grid::ComputeResource

attribute	required	single-value	type	description
da	true	true	string	The identifier for the running daemon software, comprised of the name and port attributes, i.e. "name:port"
hn	true	false	string	The host name(s) for a compute resource. Names should include the full domain name. IP addresses can also be used.
port	true	true	positive-integer	Contact port number.
objName	true	true	string	An identifying name for an object.
protocol	false	true	string	Name of protocol(s) supported by this daemon.