From 6928f7f90c45d13d6e22c73a5fc7c41d3115d48f Mon Sep 17 00:00:00 2001
From: "Paul C. Buetow" <paul@buetow.org>
Date: Tue, 15 Apr 2014 23:00:48 +0200
Subject: more on documentation

---
 docs/fapi.pod | 44 +++++++++++++++++++++++++++++++++++---------
 1 file changed, 35 insertions(+), 9 deletions(-)

(limited to 'docs/fapi.pod')

diff --git a/docs/fapi.pod b/docs/fapi.pod
index f77c0ed..1d0bd69 100644
--- a/docs/fapi.pod
+++ b/docs/fapi.pod
@@ -72,6 +72,14 @@ And run
 
 =head1 EXAMPLES
 
+=head2 Listing
+
+If you want to list all configured objects on your partition just run
+
+  f node # To list all nodes
+  f pool # To list all pool
+  ... # etc
+
 =head2 Setting up simple NAT Services
 
   (Docu to be written)
@@ -84,11 +92,13 @@ And run
 
 A simple nPath service can be created as follows.
 
-  # Creating two nodes, auto resolve the IP addresses
+  # Creating two nodes, fapi auto resolves the IP addresses, and use the
+  # FQDN as the node name. 
   f node fooserver1.example.com create
   f node fooserver2.example.com create
 
-  # Creating a pool and add the nodes to it
+  # Creating a pool and add the nodes to it. Also specify the node ports to 
+  # use by the monitors (and maybe PAT if enabled)
   f pool foopool create
   f pool foopool add member fooserver1.example.com:80
   f pool foopool add member fooserver2.example.com:80
@@ -96,15 +106,31 @@ A simple nPath service can be created as follows.
   # Add a monitor to the pool
   f pool foopool add monitor http_lbtest
 
-  # Create a nPath HTTP service, 'nPath' also auto disables NAT and PAT
-  f vserver myservice.example.com:80 create PROTOCOL_TCP nPath
+  # Create a nPath HTTP vserver, 'nPath' also auto disables NAT and PAT
+  # fapi auto resolves the IP address.
+  f vserver myvserver.example.com:80 create PROTOCOL_TCP nPath
+
+  # Add the pool to the vserver. The vservers name will be the FQDN followed by
+  # _PORT. In this case it would be: myvserver.example.com_80. The reason is
+  # that : are not allowed in vserver names.
+  f vserver myvserver.example.com:80 set pool foopool
+
+  # Add a nPath HTTPS vserver
+  f vserver myvserver.example.com:443 create PROTOCOL_TCP nPath
+  f vserver myvserver.example.com:443 set pool foopool
+
+And everything can be deleted as folows:
+
+  # You can also specify the full object name (including the partition)
+  f vserver /Common/myvserver.example.com_80 delete
+
+  # Or just the way the service was created from command line
+  f vserver myvserver.example.com:443 delete
 
-  # Add the pool to the service
-  f vserver myservice.example.com:80 set pool foopool
+  f pool foopool delete
+  f node fooserver1.example.com delete
+  f node fooserver2.example.com delete
 
-  # Add a nPath HTTPS service
-  f vserver myservice.example.com:443 create PROTOCOL_TCP nPath
-  f vserver myservice.example.com:443 set pool foopool
 
 =head1 AUTHOR
 
-- 
cgit v1.2.3