README.MD

   1 # Sparky - Inventory UI Service\r
   2 \r
   3 ## Overview\r
   4 _Sparky_ is a service that interacts with AAI and provides users a UI to view and analyze AAI data. The main goal behind _Sparky_ is providing a more user friendly and clear view of AAI data.\r
   5 \r
   6 At this time, _Sparky_ has two views available for use:\r
   7 \r
   8 [View and Inspect](./VIEW_INSPECT.md) - Graph based view of entities within AAI.\r
   9 \r
  10 [VNFs](./VNFS.md) - Aggregation based view of VNFs within AAI.\r
  11 \r
  12 ## Getting Started\r
  13 \r
  14 ### Building _Sparky_\r
  15 \r
  16 After cloning the project, execute the following Maven command from the project's top level directory to build the project:\r
  17 \r
  18     > mvn clean install\r
  19 \r
  20 After a successful install, build the docker image:\r
  21 \r
  22     > docker build -t openecomp/sparky target \r
  23 \r
  24 ### Deploying _Sparky_\r
  25 \r
  26 Push the Docker image that you have built to your Docker repository and pull it down to the location that you will be running _Sparky_.\r
  27 \r
  28 **Create the following directories on the host machine:**\r
  29 \r
  30     /logs\r
  31     /opt/app/sparky/appconfig\r
  32 \r
  33 You will be mounting these as data volumes when you start the Docker container.\r
  34 \r
  35 #### Clone Configuration Repo\r
  36 \r
  37 Clone the "test-config" repo to a seperate directory.\r
  38 Navigate to <test-config repo location>/sparky/appconfig (will contain files such as aaiui_filters.json and authentication files).\r
  39 Copy the entire contents of <test-config repo location>/sparky/appconfig into the /opt/app/sparky/appconfig directory you created in an above step.\r
  40 Copy the entire contents of <test-config repo location>/sparky/dynamic into the /opt/app/sparky/dynamic directory you created in an above step.\r
  41 \r
  42 The *dynamic* folder contains spring-beans and camel routes.  The spring-beans must be updated with environmental configuration, to enable correct operation. \r
  43 \r
  44 #### Edits to property files in /opt/app/sparky/appconfig\r
  45 \r
  46 Listed below are the values that will need to be updated to make _Sparky_ operate properly. The config files contain comments on the contents not listed here.\r
  47 \r
  48 **sparky-core.xml**\r
  49 \r
  50 - searchServiceRestEndpointConfig\r
  51         - endpointIpAddress ( ip address of the Search Data Service )\r
  52         - endpointServerPort ( server port of Search Data Service ) \r
  53 \r
  54 **sparky-core-sync.xml**\r
  55  \r
  56 - elasticSearchRestEndpointConfig\r
  57     - endpointIpAddress (ElasticSearch server ip address)\r
  58     - endpointServerPort (ElasticSearch transport server port.  Default: 9200)\r
  59 \r
  60 - aaiRestEndpointConfig\r
  61     - endpointIpAddress (AAI server ip address)\r
  62     - endpointServerPort (AAI server port.  Default: 8443)\r
  63 \r
  64 **portal/portal.properties**\r
  65 **portal/portal-authentication.properties**\r
  66 \r
  67 If this instance of _Sparky_ will be served in an ONAP Portal instance, use the two files above to configure against the proper Portal instance.\r
  68 \r
  69 ### Dependencies\r
  70 \r
  71 _Sparky_ requires:\r
  72 \r
  73 - AAI instance as the main driver behind data.\r
  74 - Elasticsearch instance for data storage.\r
  75 - Search-Data-Service instance for search functionality.\r
  76 - ONAP Portal instance for authentication.