Release v1.03.0

CLIENT.md

@@ -9,13 +9,13 @@ The OPC UA endpoint of the datahub is public accessible by its DNS name. Each cl
 The datahub server will have the data of all connected machines in its address space.
 See [Aggregating multiple umati OPC UA servers](SERVER.md) for details on the information model.
 
-The datahub OPC UA Server will be available at `opc.tcp://datahub.umati.app:4840`. (Starting with the plugfest End of August)
+The datahub OPC UA Server is be available at `opc.tcp://datahub.umati.app:4840`.
 
 The following username and password is required to access the OPC UA Server:
 
 **User**: umati-user
 
-**Password**: Please request at [[email protected]](mailto:[email protected]) and [[email protected]](mailto:[email protected])
+**Password**: Please request at [[email protected]](mailto:[email protected]) and [[email protected]](mailto:[email protected]) 
 
 ## OPC UA client functionalities
 
@@ -24,15 +24,15 @@ As described in [OPC UA Server](SERVER.md), the client needs to support an encry
 - Standard UA Client 2017 Profile this includes:
   - Security Policy Required (encrypted connection required)
   - Security User Name Password Client
-- Session Client Renew NodeIDs (namespace table might change over time, URI is necessary to detect the required namespace index)
+- Session Client Renew NodeIds (namespace table might change over time, URI is necessary to detect the required namespace index)
 
 ## Getting started: OPC UA client for umati showcase
 
 This specification focuses on the points that are specific to the umati showcase, general functionalities of OPC UA clients are not covered.
 
 - A test server is available for the development of OPC UA clients. This does not correspond to a real machine behavior, but provides changing values in the parameters for functionality testing.
 
-- The start node of the Machines folder in the address space is described in chapter 9 of the [OPC 40001-1 UA for Machinery](https://opcua.vdma.org/catalog-detail/-/catalog/3803). There is no guarantee that the namespace index of a machine will remain the same permanently (e.g. if the datahub is restarted or the connection between the machine and the datahub is interrupted). Therefore, the URI should be used to identify the correct namespace.
+- The start node of the Machines folder in the address space is described in chapter 9 of the [OPC 40001-1 UA for Machinery](https://reference.opcfoundation.org/Machinery/docs/). There is no guarantee that the namespace index of a machine will remain the same permanently (e.g. if the datahub is restarted or the connection between the machine and the datahub is interrupted). Therefore, the URI should be used to identify the correct namespace.
 - The other nodes can be identified by Browse/ TranslateBrowsePathsToNodeIds.
  The client must be able to ignore certain/unavailable objects because some instances are optional (e.g. spindles or lamps).
 - To get data continuously, use subscriptions and monitored items instead of repetitive read requests.

DASHBOARD.md

@@ -25,7 +25,7 @@ Location is set by fair organiser.
 
 The machine instance _Location_ property (according to OPC 40001-1) shall be provided in the format `<fair> <hall> <booth>`, e.g, “METAV 1 A22” or format `<N/S> <Latitude|##.#########> <EW> <Longitude|###.#########>`, e.g. `N 51.257315 E 6.740885` for GPS coordinates.
 
-**The machine only gets a map icon, if is provides at least the GPS location** 
+**The machine only gets a map icon, if it provides at least the GPS location** 
 
 Machines can be referenced to more than one fair by providing a list of fair locations, deliminated by slash e.g. `METAV <XXX> <XXX>/EMO 12 D17/N 51.257315 E 6.740885`
 

README.md

@@ -2,6 +2,12 @@
 
 This repository provides the specification to connect to the umati virtual demonstration showcase.
 
+## What is umati - the universal machine technology interface
+
+To learn more please visit [https://umati.org](https://umati.org)
+
+---
+
 ## Structure of the specification
 
 - [Overview](index.md)

SERVER.md

@@ -4,7 +4,7 @@
 
 ### Datahub and the fairconnect-configuration
 
-For this showcase we have a datahub provided off premise. This acts as an OPC UA aggregation server. The OPC UA servers (M) will connect via an OpenVPN tunnel to an VPN endpoint (one per participant). An OPC UA client will connect to the OPC UA server(s) of that participant through the VPN tunnel. The application providers (A) will connect to the datahub OPC UA server endpoint, as an [OPC UA Client](CLIENT.md).
+For this showcase we have a datahub provided off premise. This acts as an OPC UA aggregation server. The OPC UA servers (M) will connect via an OpenVPN tunnel to an VPN endpoint (one per participant; multiple are possible in case of multiple machines But preaggregation of machines to a single OPC UA Server at the participant is also possible, [see below for details](SERVER.md#openvpn-configuration).). An OPC UA client will connect to the OPC UA server(s) of that participant through the VPN tunnel. The application providers (A) will connect to the datahub OPC UA server endpoint, as an [OPC UA Client](CLIENT.md).
 To connect to this datahub (M) need an OPC UA server and OpenVPN client to access one dedicated endpoint per partner.
 In order to ease the onboarding process onto the datahub, we provide the [fairconnect application](https://fairconnect.umati.app) and a specified process for connecting OPC UA servers to the showcase:
 

Specs/Machinetools.md

@@ -23,7 +23,7 @@ All participants not familiar with the released information model do not need to
 
 ## General information valid for the umati showcase demonstration
 
-| **DISCLAIMER** | For all applications the OPC UA server is to be configured without predefined NodeIds for the instances. Clients will need to browse Instances or translate BrowsePaths to find the NodeId for accessing the address space and available instances. |
+| **DISCLAIMER** | For all applications the OPC UA server is to be configured without predefined NodeIds for the instances. Clients need to utilize the Services [Browse](https://reference.opcfoundation.org/Core/docs/Part4/5.8.2/) and [TranslateBrowsePathsToNodeIds](https://reference.opcfoundation.org/Core/docs/Part4/5.8.4/) to access nodes of interest. |
 
 ---
 

index.md

@@ -1,10 +1,16 @@
-# General Information
+# General Information 
 
 - This document provides **all information** to get connected to the umati showcase demonstrator scenario.
 - Participants who connect to the showcase, need to do so **on their own**, or with the help of their controls or software supplier. The umati project group **cannot** supply individual support on how to get [OPC UA Servers](SERVER.md) installed, online and deliver data. If questions arise regarding the information provided in **this documentation** or the connection to the datahub for the umati showcase demonstrator, please open an issue [here](https://github.com/umati/Showcase).
 
 - An FAQ is provided [here](FAQ.md) and will be updated as needed.
 
+## What is umati - the universal machine technology interface
+
+To learn more please visit [https://umati.org](https://umati.org)
+
+---
+
 ## Structure of the specification
 
 - [OPC UA Server](SERVER.md)
@@ -35,7 +41,7 @@ This documentation is versioned, as some content details will be delivered later
 | v1.02.1 | 02.10.2020 | Update on Machine Tools |
 | v1.02.2 | 23.11.2020 | Update License and activate CLA |
 | v1.02.3 | 18.02.2021 | Update on Machine Tools and Software Solutions |
-| v1.03.0 | 19.05.2021 | Complete update to latest developments |
+| v1.03.0 | 21.05.2021 | Complete update to latest developments |
 
 ### Changelog