summaryrefslogtreecommitdiffstats
path: root/docs/userguide
diff options
context:
space:
mode:
Diffstat (limited to 'docs/userguide')
-rwxr-xr-x[-rw-r--r--]docs/userguide/api-documentation.rst79
1 files changed, 77 insertions, 2 deletions
diff --git a/docs/userguide/api-documentation.rst b/docs/userguide/api-documentation.rst
index b588dc9..2937127 100644..100755
--- a/docs/userguide/api-documentation.rst
+++ b/docs/userguide/api-documentation.rst
@@ -11,8 +11,30 @@
|
Using domino-cli Client
=======================
+Make sure that domino-cli.py is in +x mode.
-* heartbeat message
+Change directory to where domino-cli.py is located or include file path in the PATH environment variable
+
+* Registration Command
+
+Command line input:
+
+.. code-block:: bash
+
+ ./domino-cli.py register
+
+This message has the following fields that are automatically filled in.
+
+.. code-block:: bash
+
+ Message Type (= REGISTER)
+ DESIRED UDID (= if not allocated, this will be assigned as Unique Domino ID)
+ Sequence Number (=incremented after each RPC call)
+ IP ADDR (= IP address of DOMINO Client to be used by DOMINO Server for future RPC Calls to this client)
+ TCP PORT (= TCP port of DOMINO Client to be used by DOMINO Server for future RPC Calls to this client)
+ Supported Templates (= Null, this field not used currently)
+
+* Heart Beat Command
Command line input:
@@ -25,8 +47,61 @@ This message has the following fields that are automatically filled in.
.. code-block:: bash
Message Type (= HEART_BEAT)
- UDID (= assigned during registration)
+ UDID (= Unique Domino ID assigned during registration)
+ Sequence Number (=incremented after each RPC call)
+
+* Label and Template Type Subscription Command
+
+.. code-block:: bash
+
+ ./domino-cli.py subscribe -l <labelname> -t <templatetype>
+
+Note that -l can be substituted by --label and -t can be substituted by --ttype.
+
+To subscribe more than one label or template type, one can repeat the options -l and -t, e.g.:
+
+.. code-block:: bash
+
+ ./domino-cli.py subscribe -l <label1> -l <label2> ... -l <labeln> -t <ttype1> -t <ttype2> ... -t <ttypen>
+
+It is safe to call subscribe command multiple times with duplicate labels.
+
+This message has the following fields that are automatically filled in.
+
+.. code-block:: bash
+
+ Message Type (= SUBSCRIBE)
+ UDID (= Unique Domino IDassigned during registration)
+ Sequence Number (=incremented after each RPC call)
+ Template Operation (= APPEND)
+ Label Operation (= APPEND)
+
+The following fields are filled in based on arguments passed on via -l/--label and -t/--ttype flags
+
+.. code-block:: bash
+
+ Supported Template Types
+ Supported Labels
+
+* Template Publishing Command
+
+.. code-block:: bash
+
+ ./domino-cli.py publish -t <toscafile>
+
+Note that -t can be substituted by --tosca-file.
+
+If -t or --tosca-file flag is used multiple times, the last tosca file passed as input will be used. This usage is not recommended as undefined/unintended results may emerge as the Domino client will continue to publish.
+
+This message has the following fields that are automatically filled in.
+
+.. code-block:: bash
+
+ Message Type (= SUBSCRIBE)
+ UDID (= Unique Domino IDassigned during registration)
Sequence Number (=incremented after each RPC call)
+ Template Type (= TOSCA)
+ Template File
Interactive CLI mode
====================