Installation notes
------------------

** AGNodeService
-  Takes a port as argument; otherwise, defaults to port 11000
-  An AGNodeService requires a directory "services" under the directory in which
   it is run
-  Node services need to be installed as "service bundles".  A service bundle
   consists of a Python file and a service description file.  The service
   description file has the same name as the Python file, except it ends in
   ".svc".  The bundle consists of these two files together as a .zip file.
   Service bundles should be installed in the "services" directory mentioned above.
-  An AGNodeService requires a directory "config" under the directory in which
   it is run, for storing node configuration files (used by File->LoadConfiguration 
   and File->StoreConfiguration only)

** AGServiceManager
-  Takes a port as argument; otherwise, defaults to port 12000
-  An AGServiceManager requires a directory "local_services" under the directory 
   in which it is run
-  An AGServiceManager executes python scripts, and refers directly to "python".
   On Windows, the python executable might be named "python", on Linux it might
   be "python2" (or might be "python").  This reference needs to work correctly
   on both platforms.  The install should validate that python2 is installed.
   AGServiceManager.py should be modified to fix this issue, either by detecting
   the platform and using either "python" (for Windows) or "python2" (for Linux, if 
   the python exe is so named); or by accessing the correct python executable
   name through an environment variable.
-  At installation, the script bin/SetupVideo.py should be run in the bin 
   directory on the video capture machine that will run an AGServiceManager 
   (probably all machines).  This utility requires vic in the current directory.


** AGServices
-  The core services (AudioService, VideoProducerService, VideoConsumerService)
   are set by default to use, respectively, "rat", "vic", and "vic".  The user
   is expected to modify these through the Node Management UI to point at the
   appropriate executables on their machines.  (Later, this can be done by
   the installer.)  Yes, this is a security hole.

   Note:  The AudioService may have problems; I haven't tested it recently.



Usage notes
-----------

** Node Management
-  Node Management takes a single argument of NodeService URI.  If not specified
   on the command line, it defaults to "https://localhost:11000/NodeService".  
   
   If the node management client is not connected to an AGNodeService, it will break 
   all over the place.

-  After configuring a service, it needs to be stopped and started for the changes
   to take effect.




Basic startup of node
---------------------

* Start node service
   python2 AGNodeService.py <port>

* Start service manager on each machine
   python2 AGServiceManager.py <port>

* Start node management ui
   python2 NodeManagement.py <node service uri>

* Add service managers (hosts) to node service
   Hosts->AddHost

* Add services to service managers
   Services->AddService
      - select service to add
      - select resource to assign (only relevant to VideoProducerService)
      - configure service
         - for example, the vic executable path, the port type