Soft Patch Panel
 help / color / mirror / Atom feed
* [spp] [PATCH] docs: add desc for default config file
@ 2019-02-12  7:48 ogawa.yasufumi
  0 siblings, 0 replies; only message in thread
From: ogawa.yasufumi @ 2019-02-12  7:48 UTC (permalink / raw)
  To: spp, ferruh.yigit, ogawa.yasufumi

From: Yasufumi Ogawa <ogawa.yasufumi@lab.ntt.co.jp>

As config of SPP CLI is imported from the config file, add descriptions
about. This update also includes some of revisings of config command.

Signed-off-by: Yasufumi Ogawa <ogawa.yasufumi@lab.ntt.co.jp>
---
 docs/guides/commands/common.rst |  4 +--
 docs/guides/setup/howto_use.rst | 55 +++++++++++++++++++++++++++++++++++++----
 2 files changed, 52 insertions(+), 7 deletions(-)

diff --git a/docs/guides/commands/common.rst b/docs/guides/commands/common.rst
index 441c100..cfa4eaf 100644
--- a/docs/guides/commands/common.rst
+++ b/docs/guides/commands/common.rst
@@ -41,8 +41,8 @@ other than default ``spp >``.
 
 .. code-block:: none
 
-    # set prompt to "$ spp"
-    spp > config prompt "$ spp"
+    # set prompt to "$ spp "
+    spp > config prompt "$ spp "
     Set prompt: "$ spp "
     $ spp
 
diff --git a/docs/guides/setup/howto_use.rst b/docs/guides/setup/howto_use.rst
index 2f3e37f..cc3dd9b 100644
--- a/docs/guides/setup/howto_use.rst
+++ b/docs/guides/setup/howto_use.rst
@@ -135,20 +135,34 @@ soure or destination of phy ports.
    Multiple SPP nodes
 
 Launch SPP CLI with three entries of binding addresses with ``-b`` option
-for specifying ``spp-ctl``. Here is an example.
+for specifying ``spp-ctl``.
 
 .. code-block:: console
 
-    # Launch SPP CLI
+    # Launch SPP CLI with three nodes
     $ python src/spp.py -b 192.168.11.101 \
         -b 192.168.11.102 \
         -b 192.168.11.103 \
 
-You can find the host under the management of SPP CLI and switch with
-``server`` command.
+You can also add nodes after SPP CLI is launched.
 
 .. code-block:: console
 
+    # Launch SPP CLI with one node
+    $ python src/spp.py -b 192.168.11.101
+    Welcome to the SPP CLI. Type `help` or `?` to list commands.
+
+    # Add the rest of nodes after
+    spp > server add 192.168.11.102
+    Registered spp-ctl "192.168.11.102:7777".
+    spp > server add 192.168.11.103
+    Registered spp-ctl "192.168.11.103:7777".
+
+You find the host under the management of SPP CLI and switch with
+``server`` command.
+
+.. code-block:: none
+
     spp > server list
       1: 192.168.1.101:7777 *
       2: 192.168.1.102:7777
@@ -156,7 +170,7 @@ You can find the host under the management of SPP CLI and switch with
 
 To change the server, add an index number after ``server``.
 
-.. code-block:: console
+.. code-block:: none
 
     # Launch SPP CLI
     spp > server 3
@@ -181,6 +195,37 @@ All of options can be referred with help option ``-h``.
 All of SPP CLI commands are described in :doc:`../../commands/index`.
 
 
+Default Configuration
+^^^^^^^^^^^^^^^^^^^^^
+
+SPP CLI imports several params from configuration file while launching.
+Some of behaviours of SPP CLI depends on the params.
+The default configuration is defined in
+``src/controller/config/default.yml``.
+You can change this params by editing the config file, or from ``config``
+command after SPP CLI is launched.
+
+All of config params are referred by ``config`` command.
+
+.. code-block:: none
+
+    # show list of config
+    spp > config
+    - max_secondary: "16"       # The maximum number of secondary processes
+    - sec_nfv_nof_lcores: "1"   # Default num of lcores for workers of spp_nfv
+    ....
+
+To change the config, set a value for the param.
+Here is an example for changing command prompt.
+
+.. code-block:: none
+
+    # set prompt to "$ spp "
+    spp > config prompt "$ spp "
+    Set prompt: "$ spp "
+    $ spp
+
+
 SPP Primary
 -----------
 
-- 
2.7.4

^ permalink raw reply	[flat|nested] only message in thread

only message in thread, other threads:[~2019-02-12  7:48 UTC | newest]

Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2019-02-12  7:48 [spp] [PATCH] docs: add desc for default config file ogawa.yasufumi

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).