commit 35ac31b305134e41b5564d3e4d97f5944067d7cd
Author: Jan Pokorný <jpokorny(a)redhat.com>
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>
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)