Skip to content

Changes

Page history
Some Formatting changes authored by Marcus Schilling's avatar Marcus Schilling
Show whitespace changes
Inline Side-by-side
KnowledgeBase/CII.md
View page @ 7e9484d8
...@@ -23,6 +23,8 @@ For more details and examples, see the [cii-postinstall user manual](http://www. ...@@ -23,6 +23,8 @@ For more details and examples, see the [cii-postinstall user manual](http://www.
After postinstall, you will want to start the CII services on your host (unless you have assigned the "groupclient" role to the host, which means you will use the CII Services running on another host). After postinstall, you will want to start the CII services on your host (unless you have assigned the "groupclient" role to the host, which means you will use the CII Services running on another host).
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### How-to start/stop CII services ### How-to start/stop CII services
...@@ -51,6 +53,9 @@ To learn about the options, run the command without arguments. ...@@ -51,6 +53,9 @@ To learn about the options, run the command without arguments.
For more details and examples, see the [cii-services user manual](http://www.eso.org/~eltmgr/CII/latest/manuals/html/docs/services.html) For more details and examples, see the [cii-services user manual](http://www.eso.org/~eltmgr/CII/latest/manuals/html/docs/services.html)
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### How-to get CII Demo apps ### How-to get CII Demo apps
...@@ -125,6 +130,10 @@ _Note: If any of the buttons mentioned below is greyed out, you're lacking permi ...@@ -125,6 +130,10 @@ _Note: If any of the buttons mentioned below is greyed out, you're lacking permi
We'll check the merge request, and your change can make it to the next release. Thanks in advance! We'll check the merge request, and your change can make it to the next release. Thanks in advance!
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### Failure to build ZPB from ICD \[ICD waf build\] ### Failure to build ZPB from ICD \[ICD waf build\]
...@@ -159,6 +168,8 @@ In the first case, the code that gets generated for the member looks to the comp ...@@ -159,6 +168,8 @@ In the first case, the code that gets generated for the member looks to the comp
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### No cpp/python from ICD \[ICD waf build\] ### No cpp/python from ICD \[ICD waf build\]
...@@ -186,6 +197,8 @@ declare_project(name='mytests', ...@@ -186,6 +197,8 @@ declare_project(name='mytests',
``` ```
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### Mock OLDB for unit tests \[cpp\] ### Mock OLDB for unit tests \[cpp\]
...@@ -232,6 +245,9 @@ NOTE: For python, a MR was created to add the feature: <https://gitlab.eso.org/c ...@@ -232,6 +245,9 @@ NOTE: For python, a MR was created to add the feature: <https://gitlab.eso.org/c
Example in <https://gitlab.eso.org/ahoffsta/cii-srv/-/blob/oldb-in-memory-missing-python-binding/oldb-client/python/oldb/test/oldbInMemoryTest.py> Example in <https://gitlab.eso.org/ahoffsta/cii-srv/-/blob/oldb-in-memory-missing-python-binding/oldb-client/python/oldb/test/oldbInMemoryTest.py>
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### Catching API Exceptions \[Python\] ### Catching API Exceptions \[Python\]
...@@ -314,6 +330,8 @@ Unfortunately, in the backtraces you will always see the original name instead o ...@@ -314,6 +330,8 @@ Unfortunately, in the backtraces you will always see the original name instead o
This question was originally asked in [ECII-422](https://jira.eso.org/browse/ECII-422). This question was originally asked in [ECII-422](https://jira.eso.org/browse/ECII-422).
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### access_key empty (DevEnv 3.2.0) \[OLDB\] ### access_key empty (DevEnv 3.2.0) \[OLDB\]
...@@ -361,6 +379,8 @@ The problem will be fixed in DevEnv 3.4. ...@@ -361,6 +379,8 @@ The problem will be fixed in DevEnv 3.4.
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### Datapoint already exists \[OLDB\] ### Datapoint already exists \[OLDB\]
...@@ -473,6 +493,10 @@ If you are dealing with a multi-user oldb ("role_groupserver", meaning it serves ...@@ -473,6 +493,10 @@ If you are dealing with a multi-user oldb ("role_groupserver", meaning it serves
If you have doubts, please contact us. If you have doubts, please contact us.
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### Req/Rep Connection Listeners \[MAL Python\] ### Req/Rep Connection Listeners \[MAL Python\]
...@@ -546,6 +570,8 @@ Remember to delete (assign None), to this object when closing the connection to ...@@ -546,6 +570,8 @@ Remember to delete (assign None), to this object when closing the connection to
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### Command Line Tools and Python snippets \[OLDB\] ### Command Line Tools and Python snippets \[OLDB\]
...@@ -628,6 +654,8 @@ Type "help", "copyright", "credits" or "license" for more information. ...@@ -628,6 +654,8 @@ Type "help", "copyright", "credits" or "license" for more information.
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### Latency on Pub/Sub \[MAL ZMQ\] ### Latency on Pub/Sub \[MAL ZMQ\]
...@@ -666,6 +694,8 @@ The problem lies in the ZMQ send queues. Default size is 1000 and with 144MB per ...@@ -666,6 +694,8 @@ The problem lies in the ZMQ send queues. Default size is 1000 and with 144MB per
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### Choose middlewares to build \[MAL ICD\] ### Choose middlewares to build \[MAL ICD\]
...@@ -695,6 +725,8 @@ The available options are: ...@@ -695,6 +725,8 @@ The available options are:
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### Sending an array of unions \[MAL cpp\] ### Sending an array of unions \[MAL cpp\]
...@@ -808,6 +840,8 @@ This issue was first described in [ECII-154](https://jira.eso.org/browse/ECII-15 ...@@ -808,6 +840,8 @@ This issue was first described in [ECII-154](https://jira.eso.org/browse/ECII-15
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### config not found on remote db \[Conf\] ### config not found on remote db \[Conf\]
...@@ -858,6 +892,8 @@ To that end, the error message is misleading, and should be improved (ticket [EC ...@@ -858,6 +892,8 @@ To that end, the error message is misleading, and should be improved (ticket [EC
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### Failed to send request, send queue full \[CII MAL\] ### Failed to send request, send queue full \[CII MAL\]
...@@ -878,6 +914,8 @@ Probably you have called close() on the CiiConfigClient instance somewhere, mayb ...@@ -878,6 +914,8 @@ Probably you have called close() on the CiiConfigClient instance somewhere, mayb
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### Getting More Logs \[MAL\] ### Getting More Logs \[MAL\]
...@@ -1015,70 +1053,43 @@ MAL does not use the Cii Logging System (CiiLogManager etc.) directly. Instead, ...@@ -1015,70 +1053,43 @@ MAL does not use the Cii Logging System (CiiLogManager etc.) directly. Instead,
List of logger names available in the **Cpp MAL / Python MAL:** List of logger names available in the **Cpp MAL / Python MAL:**
Loggers for **mal-zpb** Loggers for **mal-zpb**
- malZpbInstancePublisher - malZpbInstancePublisher
- malZpbPublisher - malZpbPublisher
- malZpbClientAsyncImpl - malZpbClientAsyncImpl
- malZpbServer - malZpbServer
- malZpb - malZpb
- malZpbSubscriber - malZpbSubscriber
- malZpbMrvSubscriber - malZpbMrvSubscriber
- malZpbBasePubSub - malZpbBasePubSub
Loggers for **mal-dds** Loggers for **mal-dds**
- malDds - malDds
- malDdsSubscriptionManager - malDdsSubscriptionManager
- malDdsSubscriptionReaderListener - malDdsSubscriptionReaderListener
- malDdsSubscriber - malDdsSubscriber
- malDdsPublisher - malDdsPublisher
- malDdsBasePubSub - malDdsBasePubSub
- malDdsMrvSubscriber - malDdsMrvSubscriber
- malDdsRequesterImpl - malDdsRequesterImpl
- malDdsInstancePublisher - malDdsInstancePublisher
Loggers for **mal-opcua** Loggers for **mal-opcua**
- malOpcua - malOpcua
- malOpcuaBasePubSub - malOpcuaBasePubSub
- malOpcuaMrvSubscriber - malOpcuaMrvSubscriber
- malOpcuaMrvDataMonitor - malOpcuaMrvDataMonitor
- malOpcuaInstancePublisher - malOpcuaInstancePublisher
- malOpcuaPublisher - malOpcuaPublisher
- malOpcuaSubscriber - malOpcuaSubscriber
- malOpcuaDataPoller - malOpcuaDataPoller
- malOpcuaDataMonitor - malOpcuaDataMonitor
- malOpcuaClient - malOpcuaClient
- malOpcuaClientEventLoop - malOpcuaClientEventLoop
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### Change Log Levels at Run-time ### Change Log Levels at Run-time
...@@ -1115,6 +1126,8 @@ elt.log.CiiLogManager.set_log_level(name_or_logger: Union\[str, logging.Logger\] ...@@ -1115,6 +1126,8 @@ elt.log.CiiLogManager.set_log_level(name_or_logger: Union\[str, logging.Logger\]
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### PYBIND errors \[ICD waf build\] ### PYBIND errors \[ICD waf build\]
...@@ -1155,6 +1168,8 @@ In general, due to the many code generation steps taking place, your freedom in ...@@ -1155,6 +1168,8 @@ In general, due to the many code generation steps taking place, your freedom in
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### multiple XMLs found \[ICD waf build\] ### multiple XMLs found \[ICD waf build\]
...@@ -1186,6 +1201,8 @@ For more information, see also: [KB: PYBIND errors \[ICD waf build\]](onenote:#K ...@@ -1186,6 +1201,8 @@ For more information, see also: [KB: PYBIND errors \[ICD waf build\]](onenote:#K
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### g++: internal compiler error: Killed \[waf build\] ### g++: internal compiler error: Killed \[waf build\]
...@@ -1270,6 +1287,8 @@ By default, ECM VMs come with 4 GB, but you want ...@@ -1270,6 +1287,8 @@ By default, ECM VMs come with 4 GB, but you want
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### More Frames expected \[CII MAL ZMQ\] ### More Frames expected \[CII MAL ZMQ\]
...@@ -1343,6 +1362,8 @@ zpb.ps://134.171.2.220:57110/test2 ...@@ -1343,6 +1362,8 @@ zpb.ps://134.171.2.220:57110/test2
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### Address in use \[CII MAL ZMQ\] ### Address in use \[CII MAL ZMQ\]
...@@ -1393,6 +1414,8 @@ On eltcii33, the endpoint must be eltcii33. ...@@ -1393,6 +1414,8 @@ On eltcii33, the endpoint must be eltcii33.
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### Scheme not supported \[CII MAL\] ### Scheme not supported \[CII MAL\]
...@@ -1417,6 +1440,8 @@ The middleware is supported in fact, but failed to load. ...@@ -1417,6 +1440,8 @@ The middleware is supported in fact, but failed to load.
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### Choosing a NIC \[CII MAL DDS\] ### Choosing a NIC \[CII MAL DDS\]
...@@ -1445,6 +1470,8 @@ Therefore, this boils down to configuring DDS. ...@@ -1445,6 +1470,8 @@ Therefore, this boils down to configuring DDS.
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### Configuring DDS \[CII MAL DDS\] ### Configuring DDS \[CII MAL DDS\]
...@@ -1495,6 +1522,8 @@ FASTRTPS_DEFAULT_PROFILES_FILE=\<path of XML file> ...@@ -1495,6 +1522,8 @@ FASTRTPS_DEFAULT_PROFILES_FILE=\<path of XML file>
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### Variable Tracking exceeded \[CII MAL\] ### Variable Tracking exceeded \[CII MAL\]
...@@ -1539,6 +1568,8 @@ def configure(cnf): ...@@ -1539,6 +1568,8 @@ def configure(cnf):
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### Multithreading in Java ### Multithreading in Java
...@@ -1549,6 +1580,8 @@ Look at this document: ...@@ -1549,6 +1580,8 @@ Look at this document:
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
### Summary of OPC/UA MAL in C++ ### Summary of OPC/UA MAL in C++
...@@ -1563,6 +1596,8 @@ Each attribute in the defined type is connected to a corresponding data point in ...@@ -1563,6 +1596,8 @@ Each attribute in the defined type is connected to a corresponding data point in
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
#### Pub/Sub API for OPC/UA Clients: #### Pub/Sub API for OPC/UA Clients:
...@@ -1598,6 +1633,8 @@ try { ...@@ -1598,6 +1633,8 @@ try {
--------------------------------------------------------------------------
--------------------------------------------------------------------------
-------------------------------------------------------------------------- --------------------------------------------------------------------------
#### Request/Reply API for OPC/UA Clients: #### Request/Reply API for OPC/UA Clients:
......