aboutsummaryrefslogtreecommitdiffstats
path: root/sdnr
diff options
context:
space:
mode:
authorAijana Schumann <aijana.schumann@highstreet-technologies.com>2020-02-11 15:44:17 +0100
committerAijana Schumann <aijana.schumann@highstreet-technologies.com>2020-02-11 15:47:12 +0100
commit06fb529a84d4e7d70b3aca68c33b2980049d5973 (patch)
tree843a61b2a980cfb486996c967b86da56863f27de /sdnr
parentf6f3b57be8e57ffc6790d139b0b7f168b8cc69e6 (diff)
Update documentation for odlux
Update help texts for all odlux apps to include new functionality Issue-ID: SDNC-1065 Signed-off-by: Aijana Schumann <aijana.schumann@highstreet-technologies.com> Change-Id: I35b60a950b758f3bc3c182a01646d6d746ed2240 Signed-off-by: Aijana Schumann <aijana.schumann@highstreet-technologies.com>
Diffstat (limited to 'sdnr')
-rw-r--r--sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/connect/README.md12
-rw-r--r--sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/general.md25
-rw-r--r--sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfConfig/README.md6
-rw-r--r--sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfEventLog/README.md6
-rw-r--r--sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfFault/README.md17
-rw-r--r--sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfInventory/README.md21
-rw-r--r--sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfMaintenance/README.md9
-rw-r--r--sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfMediator/README.md6
-rw-r--r--sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfPerformance/README.md5
9 files changed, 72 insertions, 35 deletions
diff --git a/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/connect/README.md b/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/connect/README.md
index e1eefcd8e..663aed520 100644
--- a/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/connect/README.md
+++ b/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/connect/README.md
@@ -1,15 +1,19 @@
# Connect
-The 'Connect' application on OpenDaylight provides up-to-date connectivity information about the wireless devices in the network. It automatically displays new network elements and their connection status. Despite the network elements usually automatically mount themselves, an additional small window allows manually mounting devices/mediators. For better understanding alarms and status, a connection status log lists all the connection status changes of OpenDaylight mount points.
+The 'Connect' application on OpenDaylight provides up-to-date connectivity information about the wireless devices in the network. It automatically displays new Network Elements and their connection status. Usually, the Network Elements mount themselves. If necessary, they can be mounted manually by right-clicking on the element. For better understanding of alarms and status, a connection status log lists all the connection status changes of OpenDaylight mount points.
## Views
-The graphical user interfaces is divided in two sections.
+The graphical user interface is divided into two sections.
### Network Elements
-Network Elements are physical network functions (PNFs). A table view show configured and connected NetConf Servers to the SDN-R cluster.
-This view also offer to manually configure/mount the device with the '+' icon. The SDN controller will start connecting the NetConf server.
+Network Elements are physical network functions (PNFs). A table view shows all configured and connected NetConf Servers of the SDN-R cluster. This view also allows to manually configure/mount a device via the '+' button. The SDN controller will start connecting to the NetConf server.
+
+Network Elements can be marked as 'required'. If an element is required, it will stay available even if disconnected. If an element is not required, it will be deleted once disconnected.
+
+By right-clicking on an element, an action menu opens. The menu allows to mount, unmount, view the details, edit and remove the element. Additionally, it links to several applications like [Fault](../pnfFault/README.md) and [Configure](../pnfConfig/README.md), which will be filtered to display information relevant to the selected element.
+
### Connection Status Log
diff --git a/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/general.md b/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/general.md
new file mode 100644
index 000000000..d908d1221
--- /dev/null
+++ b/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/general.md
@@ -0,0 +1,25 @@
+# General functionality
+
+The following functionality is common to all applications.
+
+### Table data export
+
+Every table can export its data via the '&#65049;' button.
+The data, which gets exported is the currently viewed data in the table. As the default pagination is set to 10, only the first 10 rows or filtered rows will be exported. To increase the number of exported rows, change the pagination.
+
+The behavior of the export can vary based on the browser:
+
+a) Some browsers allow you to save the file with the predefined name export.csv. In case your browser does not offer this function please use the 'Save as...' option and define the filename with extension csv.
+
+b) Some browsers save the file automatically with the alphanumeric name but without an extension. In such a case navigate to the downloaded file location and rename the file. The extension (csv) must be appended to the name. The result should look like 'export_file.csv'.
+
+### Table filters
+
+The following filters are supported by all tables based on the data type of the column.
+
+|Data type | Possible Filter | Example |
+| ---------|---------------|---------|
+| Text | Any characters or numbers, matches exactly unless a * is used. The * acts as a wildcard and can be used for contains, ends with and begins with queries. |Test, Tes*, *t |
+| Numeric | < or <= or > or >= or exact number |>5000, 20, <=82 |
+| Boolean |None (no filter set), true or false |true, false |
+
diff --git a/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfConfig/README.md b/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfConfig/README.md
index 98c9f946c..7bc27d10a 100644
--- a/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfConfig/README.md
+++ b/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfConfig/README.md
@@ -1,12 +1,12 @@
# Configuration
-The application shows the actual values of all attributes of the ONF-TR-532 for a selected physical network function (PNF). Each view of a functional element is divide into capabilities, configuration, status, current problem, current performance and history performance information according to TR-532.
+The application shows the actual values of all attributes of the ONF-TR-532 for a selected physical network function (PNF). Each view of a functional element is divided into capabilities, configuration, status, current problem, current performance and history performance information according to TR-532.
A separate window is available for modifying the configuration. All changes made are sent to the device in a single NetConf bulk request. The operator is notified about successfully configuring the device.
## Implementation
-The applications are implemented as OpenDaylight-DLUX web application using the RestConf northbound interface of the SDN controller. The key frameworks are: Typescript, react and material-ui.
+The application is implemented as OpenDaylight-DLUX web application using the RestConf northbound interface of the SDN controller. The key frameworks are: Typescript, React and material-ui.
-Connections status information are updated automatically due to a web socket for notifications from OpenDaylight to the browser.
+Connection status information is updated automatically using a web socket for notifications from OpenDaylight to the browser.
diff --git a/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfEventLog/README.md b/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfEventLog/README.md
new file mode 100644
index 000000000..e289f422c
--- /dev/null
+++ b/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfEventLog/README.md
@@ -0,0 +1,6 @@
+# Event Log
+
+The 'EventLog' application displays application logs and messages automatically created by the different active applications.
+SDN-R offers a common log service so that PNFs or other ONAP components can log their data and users can analyze and export the data in a common way.
+
+
diff --git a/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfFault/README.md b/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfFault/README.md
index b7db4388e..2d9d35a32 100644
--- a/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfFault/README.md
+++ b/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfFault/README.md
@@ -1,18 +1,18 @@
# Fault Management
-To operate a network, it is important to get an overview about the currently raised alarms. The application offers basic fault management of devices supporting ONF-TR-532. The alarms are classified according to the severity level (warning, minor, major, critical).
+To operate a network, it is important to get an overview about the currently raised alarms. The application offers basic fault management of devices supporting ONF-TR-532. The alarms are classified according to the severity level (warning, minor, major, critical).
## Views
-The graphical user interface is separated in three views.
+The graphical user interface is separated into three views.
### Current Alarms
-It list all current active faults in the network. In addition it also list alarms sent by the SDN controller itself, which detects connections losses to the NetConf server (connectionLossOAM) or which detects connection loss to a devices via a mediator to a device (connectionLossNeOAM).
+Lists all current active faults in the network. In addition, it also lists alarms sent by the SDN controller itself, which detects connection losses to the NetConf server (connectionLossOAM) or to a device via a mediator to a device (connectionLossNeOAM).
### Alarm Notifications
-As long as the view is open, it lists all alarm notification reached by the SDN Controller. Please note that refreshing the view will start the collection again. Previous alarm notification can be viewed in the alarm log.
+As long as the view is open, all alarm notifications received by the SDN Controller are listed. Please note that refreshing the view will start the collection again. Previous alarm notification can be viewed in the alarm log.
### Alarm Log
@@ -20,11 +20,12 @@ Next to the current active alarms an alarm log lists all alarm notifications of
## Implementation
-The application has two parts. While the server is listening for NetConf notifications to store them in the database the client retrieves the information from the database and displays them in a grid view.
+The application has two parts. While the server is listening for NetConf notifications to store them in the database, the client retrieves the information from the database and displays them in a table.
-The server synchronizes with the current alarm lists of the devices and calculates based on raise and clear notifications the current alarm status of the network. The current alarms are stored in a database. In addition all Problem Notifications received by the SDN controller are stored. There is no logic implemented on the client.
+The server synchronizes with the current alarm lists of the devices. Based on raised and cleared notifications, the current alarm status of the network is calculated. The current alarms are stored in a database. In addition, all Problem Notifications received by the SDN controller are stored. There is no logic implemented on the client side.
-An alarm status bar on top of each graphical user interface informs the operator about the health status of the network.
+An alarm status bar in the header of the web application informs the operator about the health status of the network.
+
+The OpenDaylight-DLUX web application uses web sockets to update the graphical user interface of the Problem Notifications (devices) and Connection Status Notifications (ODL) in real-time.
-The OpenDaylight DLUX web application uses web sockets for updating the graphical user interface in case of Problem Notification (devices) and Connection Status Notifications (ODL).
diff --git a/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfInventory/README.md b/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfInventory/README.md
index 8308c0530..f09a492d7 100644
--- a/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfInventory/README.md
+++ b/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfInventory/README.md
@@ -1,21 +1,20 @@
# Inventory
-The application offers basic inventory management of devices supporting ONF-TR-512 and ietf-hardware.
+The application offers basic inventory management of devices supporting ONF-TR-512 and ietf-hardware.
+
+The view displays the inventory data of the network element – for example, serial-numbers and part-numbers according to the containment of the equipment.
-The view displays the inventory data of the network element - basically serial-numbers and part-numbers are displaced according to the containment of the equipment.
##### Inventory Export:
-As the default pagination size is set to 10, when you export the data only first 10 rows or the first 10 filtered rows shown on the page will be exported to a file.
-The inventory export allows the export of up to 1000 entries, when the pagination size is increased to 1000. 
-So, It is recommended to change the pagination size 'Rows per page' to 1000 if you want to export the complete Inventory data.
+The '&#65049;' button in the upper right corner of the table allows exporting the inventory data as a CSV file.
+
+Only the currently viewed table data is exported. As the default pagination is set to 10, only the first 10 rows or filtered rows would be exported. To increase the number of exported rows change the pagination.
+
+The behavior of the export can vary based on different browsers:
-To export the Inventory data:
-The behaviour is different depending on the browser:
+a) Some browsers allow you to save the file with the predefined name export.csv. In case your browser does not offer this function please use the 'Save as...' option and define the filename with extension csv.
-a) Some browsers allows you to save the file with the predefined name export.csv. In case your browser does not offer this function please use 'Save as..'
- option and define the filename with extension csv.
+b) Some browsers save the file automatically with the alphanumeric name but without an extension. In such a case navigate to the downloaded file location and rename the file. The extension (csv) must be appended to the name. The result should look like export_file.csv.
-b) Some browsers saves the file automatically with the alphanumeric name without an extension. In such case please go to the downloaded file location and rename the file
- with the extension after the download. (eg: export_file.csv)
diff --git a/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfMaintenance/README.md b/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfMaintenance/README.md
index 2deadcafc..f6bf53889 100644
--- a/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfMaintenance/README.md
+++ b/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfMaintenance/README.md
@@ -1,10 +1,7 @@
# Maintenance
-The 'Maintenance' application on the OpenDaylight provides the information of the Network Elements which are set for Maintenance, currently or in the future.
-User can manage devices to set the maintenance mode so that no unnecessary alarms are created.
-When the device is in Maintenace alarms are not forwarded to DCAE and when the device maintenance is turned off the alarms will start flowing again.
+The 'Maintenance' application on OpenDaylight provides information about planned maintenances of Network Elements, currently or in the future. Users can manage devices to set the maintenance mode so that no unnecessary alarms are created. When the device is in maintenance mode, alarms are not forwarded to DCAE. As soon as the maintenance is finished, the alarms will start flowing again.
-'Active' field in this application shows if the Network Element is in maintenance mode currently or not.
-If it is 'active' it means the Network Element is currently undergoing maintenance, If 'not active' it means maintenance might have been set for future or maintenance is already completed.
+The 'active' field in the table shows if the Network Element is currently in maintenance mode or not. If it is 'active' it means the Network Element is currently undergoing maintenance, if 'not active' it means maintenance might have been set for a future date or is already completed.
-Users have access to disable the Maintenance mode or change the maintenance start and end dates at any point of time by using the available options in actions column.
+Users can disable the maintenance mode or change its start and end dates by using the available options in the actions column.
diff --git a/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfMediator/README.md b/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfMediator/README.md
index 246e77b70..ef20c15bc 100644
--- a/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfMediator/README.md
+++ b/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfMediator/README.md
@@ -1,3 +1,7 @@
# Mediator
-Some device vendors (Altiostar, CommScope, Dragonwave-X) uses the [generic mediator framework](https://github.com/Melacon/NetConf2SNMP). Such mediator offers an API to create, delete, start and stop mediator instances. \ No newline at end of file
+Some device vendors (Altiostar, CommScope, Dragonwave-X) use the [generic mediator framework](https://github.com/Melacon/NetConf2SNMP). Such mediators offer an API to create, delete, start and stop mediator instances.
+
+New mediator servers can be added via the '+' button. Afterward, a server can be selected to view all available mediator instances.
+
+A mediator instance can be started, stopped and deleted using the available actions. Additionally, its details can be viewed. The '+' button allows the user to add a new instance. During the creation, at least one 'ODL auto connect' configuration must be added.
diff --git a/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfPerformance/README.md b/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfPerformance/README.md
index 2db5eda81..ec9f8d597 100644
--- a/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfPerformance/README.md
+++ b/sdnr/wt/helpserver/provider/src/main/resources/help/sdnr/pnfPerformance/README.md
@@ -1,8 +1,9 @@
# Performance
-Performance Monitoring values measured by the devices are necessary to analyze and optimize the network. Therefore the application automatically retrieves all historical performance values from the devices and stores them in a database. The client part just retrieves the values from the database and displays them in graphical user interface.
+Performance Monitoring values measured by the devices are necessary to analyze and optimize the network. Therefore the application automatically retrieves all historical performance values from the devices and stores them in a database. The client retrieves the values from the database and displays them in a graphical user interface.
## Performance history values
-After selection of a connected PNF supporting ONF-TR-532 and an physical interface, the application collects the received and centralized stored performance values for this interface and displays them in table views.
+After selecting a connected PNF supporting ONF-TR-532 and a physical interface, the application collects the received and centralized stored performance values for this interface. The data gets displayed as a line chart to visualize the data in a given time period and a corresponding table. If the table gets filtered, the chart updates itself.
+