Page MenuHomeClusterLabs Projects
Files F3153372

No OneTemporary
Actions

View Options

diff --git a/ra/next/Makefile b/ra/next/Makefile
index 5a985f0..128b6be 100644
--- a/ra/next/Makefile
+++ b/ra/next/Makefile
@@ -1,19 +1,23 @@
# Basic DocBook mangling makefile.
#
#
BASENAME=resource-agent-api
+GRAMMAR=ra-api.ng
+TEST_FILES=ra-metadata-example-1.0.xml ra-metadata-example.xml
.PHONY: all clean
%.html: %.md
pandoc -f markdown -o $@ $^
%.pdf: %.md
pandoc -f markdown -o $@ $^
all: $(BASENAME).pdf $(BASENAME).html
clean:
rm $(BASENAME).pdf $(BASENAME).html||true
+check: $(GRAMMAR) $(TEST_FILES)
+ xmllint --relaxng $(GRAMMAR) --noout $(TEST_FILES)
diff --git a/ra/next/ra-metadata-example-1.0.xml b/ra/next/ra-metadata-example-1.0.xml
new file mode 100644
index 0000000..71a5dd0
--- /dev/null
+++ b/ra/next/ra-metadata-example-1.0.xml
@@ -0,0 +1,105 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<!-- Root element: give the name of the Resource agent -->
+<resource-agent name="Filesystem" version="FailSafe 1.0.4">
+
+<!-- Version number of the standard this complies with -->
+<version>1.0</version>
+
+<!-- List all the instance parameters the RA supports or requires. -->
+<parameters>
+
+<!-- Note that parameters flagged with 'unique' must be unique; ie no
+ other resource instance of this resource type may have the same set
+ of unique parameters.
+ -->
+
+<parameter name="Mountpoint" unique="1">
+<!-- This is the long, helpful description of what the parameter is all
+ about. A user interface might display it to the user if he asks for
+ elaborate help with an option, and it would obviously also provide
+ examples etc.
+
+ You can have multiple ones with different "lang" attributes, but this is
+ not required.
+-->
+<longdesc lang="en">
+The resource name is the directory where the filesystem will be actually
+mounted. Please make sure it exists.
+</longdesc>
+
+<!-- The shortdesc may be displayed by the resource manager as a tooltip or
+ equivalent -->
+<shortdesc lang="en">Mountpoint</shortdesc>
+
+<!-- Further definition of the content -->
+<content type="string" default="/mnt" />
+
+</parameter>
+
+<parameter name="Device" unique="1">
+<longdesc lang="en">
+When mounting a filesystem on a specific mountpoint, you have to specify which
+device should be mounted; this will usually be similiar to /dev/sda1 or
+/dev/volumegroup/logicalvolume when using LVM.
+</longdesc>
+<shortdesc lang="en">Device to be mounted</shortdesc>
+<content type="string" default="/dev/"/>
+</parameter>
+
+<parameter name="FSType">
+<longdesc lang="en">
+You should chose a journaled filesystem for the shared storage to ensure that
+the filesystem remains consistent and that it can be mounted without an
+expensive fsck run; recommendations include reiserfs, ext3 and XFS.
+</longdesc>
+<shortdesc lang="en">Type of the filesystem</shortdesc>
+<content type="string" default="reiserfs"/>
+</parameter>
+
+<parameter name="mount_options">
+<longdesc lang="en">
+The mount options used for mounting a filesystem; normally this is set to
+defaults, but you may want to modify this if you require a read-only
+mount or something similar.
+</longdesc>
+<shortdesc lang="en">Mount options for this filesystem</shortdesc>
+<content type="string" default="defaults" />
+</parameter>
+
+</parameters>
+
+<!-- List the actions supported by the RA -->
+<actions>
+<!-- Valid actions: start, stop, recover, status, reload, verify-all
+
+ The timeout is given in seconds (or s, m, h, d postfix and their
+ usual meanings) and should be a reasonable _hint_ to the RM how
+ long a certain action might take in the worst case.
+ -->
+<action name="start" timeout="2m30s" />
+<action name="stop" timeout="100" />
+<action name="recover" timeout="150" />
+<!-- In what intervals the RM should poll the RA for status; and how early
+ after the start of the RA is should start. Again, this are just
+ _defaults_ and can be overridden by the RM. -->
+<action name="status" depth="0" timeout="20" interval="10" start-delay="1m" />
+<action name="status" depth="10" timeout="60" interval="1h" start-delay="5m" />
+<action name="status" depth="20" timeout="2m" interval="1d" start-delay="1d" />
+<action name="reload" timeout="60" />
+<action name="meta-data" timeout="5" />
+<!-- As with all not mandatory actions, this one is only listed if supported
+ -->
+<action name="verify-all" timeout="30" />
+
+</actions>
+
+<!-- Vendor specific attributes; as the content _inside_ the special tag is
+ obviously not covered by the RA-API DTD, it will not validate, but oh
+ well...
+ -->
+<special tag="FailSafe">
+<Ordering>403</Ordering>
+</special>
+
+</resource-agent>

File Metadata

Mime Type
text/x-diff
Expires
Tue, Feb 25, 5:47 PM (1 d, 5 h)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
1464913
Default Alt Text
(4 KB)

Event Timeline