README update with reformatting

Change-Id: Id6d83229c5e2d78719dece4d116dd06cede1fcb0

README.rst

@@ -4,9 +4,6 @@ os-namos
 
 Discovery agent of namos service.
 
-Please feel here a long description which must be at least 3 lines wrapped on
-80 cols, so that distribution package maintainers can use it in their packages.
-Note that this is a hard requirement.
 
 * Free software: Apache license
 * Documentation: http://docs.openstack.org/developer/os-namos
@@ -16,4 +13,19 @@ Note that this is a hard requirement.
 Features
 --------
 
-* TODO
+* Register the given OpenStack service component under namos and acknowledge it
+* Helps to find the live status of OpenStack service components
+* Helps to update the configuration files lively.
+
+How to setup os-namos
+---------------------
+* Assume, os-namos is cloned at /opt/stack/os-namos, then run below command to
+  install namos from this directory.
+
+  `sudo python setup.py install`
+
+How to use this agent
+---------------------
+
+* Invoke this agent from the service component console python scripts, where
+  its launched.

config-generator.conf

@@ -1,5 +1,4 @@
 [DEFAULT]
-output_file = etc/namos/namos.conf.sample
 wrap_width = 79
 namespace = os_namos
 namespace = oslo.messaging

os_namos/common/rpcapi.py

@@ -68,7 +68,7 @@ class ConductorAPI(object):
                 '%s.openstack.common.rpc.impl_zmq' % project: 'zmq',
             }
         )
-
+        # TODO(mrkanag) Ceilometer is causing an issue with this in place.
         oslo_messaging.set_transport_defaults('namos')
 
         self.client = rpc.get_rpc_client(version=self.RPC_API_VERSION,
@@ -98,6 +98,15 @@ class ConductorAPI(object):
     def update_config_file(self, context, identification, name, content):
         self.mgr._update_config_file(identification, name, content)
 
+    @request_context
+    def regisgration_ackw(self, context, identification):
+        self.mgr.regisgration_ackw(identification)
+
+    @request_context
+    def ping_me(self, context, identification):
+        identification = self.mgr.ping_me(identification)
+        return identification
+
     def manage_me(self):
         self.server.start()
 
@@ -107,12 +116,3 @@ class ConductorAPI(object):
             self.server.wait()
         except:  # noqa
             pass
-
-    @request_context
-    def regisgration_ackw(self, context, identification):
-        self.mgr.regisgration_ackw(identification)
-
-    @request_context
-    def ping_me(self, context, identification):
-        identification = self.mgr.ping_me(identification)
-        return identification

os_namos/sync.py

@@ -26,9 +26,6 @@ from oslo_utils import netutils
 NAMOS_RPCAPI = None
 logger = log.getLogger(__name__)
 
-# TODO(mrkanag) when more than one workers are reported per service component
-# Then make the IDENTIFICATION for each worker instead. Currrently its only
-# one for whole service component == PID
 IDENTIFICATION = str(uuid.uuid4())
 HEART_BEAT_STARTED = False
 NAMOS_RPCSERVER_STARTED = False