[sunzi/development] doc/concepts: fix unspotted repasted parts

commit 35ac31b305134e41b5564d3e4d97f5944067d7cd Author: Jan Pokorný <jpokorny(a)redhat.com&gt; Date: Mon Feb 27 16:21:30 2012 +0100 doc/concepts: fix unspotted repasted parts Me or my vim went probably a bit crazy when testing the syntax file :-P When doc/concepts to be diffed, please do it against commit 197a05ebc21da03b4 directly. BTW., previously, some references to pacemaker rng files were added. Signed-off-by: Jan Pokorný <jpokorny(a)redhat.com&gt; doc/concepts | 483 ---------------------------------------------------------- 1 files changed, 0 insertions(+), 483 deletions(-) --- diff --git a/doc/concepts b/doc/concepts index b536380..3dd1dcd 100644 --- a/doc/concepts +++ b/doc/concepts @@ -1,60 +1,3 @@ -# vim: set syntax=concepts: <-- see concepts_syntax.vim -# -# This documents uses hypothetical free-form understandable -# OOP-like language to define concepts in the project and -# the relations amongst them (inspired by Elixir a bit). -# There may be not (and probably is not) 1:1 correspondence -# with how the things are seen by Pacemaker. -# -# Flags used so far: -# <no flag> general attribute -# @one-of contraint for the concept domain: at least one -# specification must fit -# @refcollection collection as a bunch of references to items -# of other concept (aggregation/composition) -# @refsingle single reference to item of other concept -# (item forming aggregation/composition) -# @enum enumeration values -# @dynamic attributes highly dynamic -# -# Q: contraints for any undefined "singleval", e.g. -# - UTF-8, 1-63 length, excluding ':' - - -# -- META ----------------------------------------------------------------- -# MetaString and such have obvious meaning, omitted -# Similarly, known lexical-based concepts marked <CONCEPT> and omitted - - -# -- GENERAL -------------------------------------------------------------- - -concept HostnameOrIP derives MetaString: - @one-of - <FQDN> - <IPv4> # only single canonical notation (?) - <IPv6> # beware: plenty of notations - -concept MulticastAddress derives MetaString: - @one-of - MulticastIPv4 - MulticastIPv6 - -concept MulticastIPv4: - # Q: restricted to range of D/E-class only? - -concept MulticastIPv6: - # Q: restrictions here? - -concept SyslogFacility derives MetaEnumeration: - @enum - SfDaemon - ... - -concept SyslogPriority derives MetaEnumeration: - @enum - - SpInfo -# vim: set filetype=concepts: <-- see concepts_syntax.vim # vim: set filetype=concepts: <-- see concepts_syntax.vim # # This documents uses hypothetical free-form understandable @@ -296,429 +239,3 @@ concept FailoverDomainRelationship: @refsingle node: ManyToOne(Node, backref=failoverDomains) failoverDomain: ManyToOne(FailoverDomain, backref=registeredNodes) -# -# This documents uses hypothetical free-form understandable -# OOP-like language to define concepts in the project and -# the relations amongst them (inspired by Elixir a bit). -# There may be not (and probably is not) 1:1 correspondence -# with how the things are seen by Pacemaker. -# -# Flags used so far: -# <no flag> general attribute -# @one-of contraint for the concept domain: at least one -# specification must fit -# @refcollection collection as a bunch of references to items -# of other concept (aggregation/composition) -# @refsingle single reference to item of other concept -# (item forming aggregation/composition) -# @enum enumeration values -# @dynamic attributes highly dynamic -# -# Q: contraints for any undefined "singleval", e.g. -# - UTF-8, 1-63 length, excluding ':' - - -# -- META ----------------------------------------------------------------- -# MetaString and such have obvious meaning, omitted -# Similarly, known lexical-based concepts marked <CONCEPT> and omitted - - -# -- GENERAL -------------------------------------------------------------- - -concept HostnameOrIP derives MetaString: - @one-of - <FQDN> - <IPv4> # only single canonical notation (?) - <IPv6> # beware: plenty of notations - -concept MulticastAddress derives MetaString: - @one-of - MulticastIPv4 - MulticastIPv6 - -concept MulticastIPv4: - # Q: restricted to range of D/E-class only? - -concept MulticastIPv6: - # Q: restrictions here? - -concept SyslogFacility derives MetaEnumeration: - @enum - SfDaemon - ... - -concept SyslogPriority derives MetaEnumeration: - @enum - SpInfo - SpDebug - ... - - -# -- CLUSTER -------------------------------------------------------------- -# see https://github.com/ClusterLabs/pacemaker/blob/master/xml/pacemaker-1.2.rng - -concept Cluster: - # cluster - name - # fence - fencePostFailDelay - fencePostJoinDelay - # network - networkCommunication: ClusterNetworkCommunication - # Pacemaker - ... - # logging - globalLogging: ClusterGlobalLogging - otherLogging: ClusterOtherLogging[] - @dynamic - # Q: is configuration version relevant? - configurationVersion - status: ClusterStatus - @refcollection - nodes: Node[] - -concept ClusterLogging: - # TODO - -concept ClusterGlobalLogging derives ClusterLogging: - logBuggingMessages: MetaBool - syslog: MetaBool - syslogFacility: SyslogFacility - syslogPriority: SyslogPriority - -concept ClusterNetworkCommunication: - @one-of - CncUDPAuto - CncUDPManual - # Q: can be more addresses? - multicastAddress: MulticastAddress[] - CncUDPUnicast - -concept ClusterStatus: - # Q: ? - -# Q: is this relevant after all? -concept ClusterDaemon: - name - @dynamic - status: ClusterDaemonStatus - -# Q: dtto -concept ClusterDaemonStatus derives MetaEnumeration: - @enum - # Q: guessed for now - CdsRunning - CdsNotRunning - CdsFailed - - -# -- NODES --------------------------------------------------------------- - -concept Node: - name: HostnameOrIP - id - @dynamic - uptime - status: NodeStatus - @refsingle - # Q: can node be active in more clusters (running or at least declaratively)? - cluster: ManyToOne(Cluster, backref=nodes) - @refcollection - clusterDaemons: ClusterDaemon[] - collocatedResources: Resource[] - fenceDevices: FenceDevice[] - failoverDomains: FailoverDomainRelationship[] - -concept NodeStatus derives MetaEnumeration: - @enum - # Q: guessed for now - NsActive - NsInactive - - -# -- RESOURCES ----------------------------------------------------------- -# see https://github.com/ClusterLabs/pacemaker/blob/master/xml/resources-1.2.rng - -concept Resource: - name - class: ResourceClass - type: ResourceType - provider: ResourceProvider - @refsingle - location: ManyToOne(Node, backref=collocalatedResources) - @refcollection - constraints: Constraint[] - -concept ResourceClass derives MetaEnumeration: - # Q: is this enumeration to be queried at runtime? - enum: - -concept ResourceType derives MetaEnumeration: - # Q: is this enumeration to be queried at runtime? - enum: - -concept ResourceProvider - # Q: also queried at runtime (i.e., dynamical)? - name - -# sample concrete Resource -concept ResourceApache derives Resource: - serverRoot - configFile - ... -# similarly for other resources (not interesting in this context) - - -# -- CONSTRAINTS (aka Resource Dependencies) ----------------------------- -# see https://github.com/ClusterLabs/pacemaker/blob/master/xml/constraints-1.2.rng - -concept Contraint: - name - resourceConstraints: ResourceConstraint[] - -concept ResourceConstraint: - dependency: ConstrainDependency - quantification # Q: ? - @refsingle - resource: ManyToOne(Resource, backref=constraints) - constraint: ManyToOne(Constraint, backref=resourceConstraints) - -concept ConstraintDependency derives MetaEnumeration: - @enum - CdColocation - # Q: ? - - -# -- FENCE DEVICES ------------------------------------------------------- -# see https://github.com/ClusterLabs/pacemaker/blob/master/xml/fencing.rng - -concept FenceDevice: - name - type - hostname - @dynamic - status: FenceDeviceStatus - -concept SharedFenceDevice derives FenceDevice: - @refcollection - nodesUsing: ManyToMany(Node, backref=fenceDevices) - -concept NonSharedFenceDevice derives FenceDevice: - @refcollection - nodesUsing: ManyToOne(Node, backref=fenceDevices) - -concept FenceDeviceStatus derives MetaEnumeration: - @enum - # Q: guessed for now - FdsActive - FdsInactive - -# sample concrete FenceDevice -concept APCPowerSwitch derives SharedFenceDevice: - port - login - password - ... -# similarly for other fence devices - - -# -- FAILOVER DOMAINS ---------------------------------------------------- - -concept FailoverDomain: - name - prioritized: MetaBool - restricted: MetaBool - noFailBack: MetaBool - @refcollection - registeredNodes: FailoverDomainRelationship[] - -concept FailoverDomainRelationship: - @refsingle - node: ManyToOne(Node, backref=failoverDomains) - failoverDomain: ManyToOne(FailoverDomain, backref=registeredNodes) - SpDebug - ... - - -# -- CLUSTER -------------------------------------------------------------- -# see https://github.com/ClusterLabs/pacemaker/blob/master/xml/pacemaker-1.2.rng - -concept Cluster: - # cluster - name - # fence - fencePostFailDelay - fencePostJoinDelay - # network - networkCommunication: ClusterNetworkCommunication - # Pacemaker - ... - # logging - globalLogging: ClusterGlobalLogging - otherLogging: ClusterOtherLogging[] - @dynamic - # Q: is configuration version relevant? - configurationVersion - status: ClusterStatus - @refcollection - nodes: Node[] - -concept ClusterLogging: - # TODO - -concept ClusterGlobalLogging derives ClusterLogging: - logBuggingMessages: MetaBool - syslog: MetaBool - syslogFacility: SyslogFacility - syslogPriority: SyslogPriority - -concept ClusterNetworkCommunication: - @one-of - CncUDPAuto - CncUDPManual - # Q: can be more addresses? - multicastAddress: MulticastAddress[] - CncUDPUnicast - -concept ClusterStatus: - # Q: ? - -# Q: is this relevant after all? -concept ClusterDaemon: - name - @dynamic - status: ClusterDaemonStatus - -# Q: dtto -concept ClusterDaemonStatus derives MetaEnumeration: - @enum - # Q: guessed for now - CdsRunning - CdsNotRunning - CdsFailed - - -# -- NODES --------------------------------------------------------------- - -concept Node: - name: HostnameOrIP - id - @dynamic - uptime - status: NodeStatus - @refsingle - # Q: can node be active in more clusters (running or at least declaratively)? - cluster: ManyToOne(Cluster, backref=nodes) - @refcollection - clusterDaemons: ClusterDaemon[] - collocatedResources: Resource[] - fenceDevices: FenceDevice[] - failoverDomains: FailoverDomainRelationship[] - -concept NodeStatus derives MetaEnumeration: - @enum - # Q: guessed for now - NsActive - NsInactive - - -# -- RESOURCES ----------------------------------------------------------- -# see https://github.com/ClusterLabs/pacemaker/blob/master/xml/resources-1.2.rng - -concept Resource: - name - class: ResourceClass - type: ResourceType - provider: ResourceProvider - @refsingle - location: ManyToOne(Node, backref=collocalatedResources) - @refcollection - constraints: Constraint[] - -concept ResourceClass derives MetaEnumeration: - # Q: is this enumeration to be queried at runtime? - enum: - -concept ResourceType derives MetaEnumeration: - # Q: is this enumeration to be queried at runtime? - enum: - -concept ResourceProvider - # Q: also queried at runtime (i.e., dynamical)? - name - -# sample concrete Resource -concept ResourceApache derives Resource: - serverRoot - configFile - ... -# similarly for other resources (not interesting in this context) - - -# -- CONSTRAINTS (aka Resource Dependencies) ----------------------------- -# see https://github.com/ClusterLabs/pacemaker/blob/master/xml/constraints-1.2.rng - -concept Contraint: - name - resourceConstraints: ResourceConstraint[] - -concept ResourceConstraint: - dependency: ConstrainDependency - quantification # Q: ? - @refsingle - resource: ManyToOne(Resource, backref=constraints) - constraint: ManyToOne(Constraint, backref=resourceConstraints) - -concept ConstraintDependency derives MetaEnumeration: - @enum - CdColocation - # Q: ? - - -# -- FENCE DEVICES ------------------------------------------------------- -# see https://github.com/ClusterLabs/pacemaker/blob/master/xml/fencing.rng - -concept FenceDevice: - name - type - hostname - @dynamic - status: FenceDeviceStatus - -concept SharedFenceDevice derives FenceDevice: - @refcollection - nodesUsing: ManyToMany(Node, backref=fenceDevices) - -concept NonSharedFenceDevice derives FenceDevice: - @refcollection - nodesUsing: ManyToOne(Node, backref=fenceDevices) - -concept FenceDeviceStatus derives MetaEnumeration: - @enum - # Q: guessed for now - FdsActive - FdsInactive - -# sample concrete FenceDevice -concept APCPowerSwitch derives SharedFenceDevice: - port - login - password - ... -# similarly for other fence devices - - -# -- FAILOVER DOMAINS ---------------------------------------------------- - -concept FailoverDomain: - name - prioritized: MetaBool - restricted: MetaBool - noFailBack: MetaBool - @refcollection - registeredNodes: FailoverDomainRelationship[] - -concept FailoverDomainRelationship: - @refsingle - node: ManyToOne(Node, backref=failoverDomains) - failoverDomain: ManyToOne(FailoverDomain, backref=registeredNodes)