PDF generated on 20 Feb 2017DISCLAIMER : UNCONTROLLED WHEN PRINTED – PLEASE CHECK THE STATUS OF THE DOCUMENT IN IDM

Memorandum / Note

CODAC Core System Version 5.4 Release Notes

These are the release notes for the CCS 5.4.0 version with components version, new features, main changes and documentation update.

Approval Process Name Action AffiliationAuthor Di Maio F. 20 Feb 2017:signed IO/DG/COO/SCOD/CSD/CDCCo-AuthorsReviewersApprover Park M. 20 Feb 2017:approved IO/DG/COO/SCOD/CSD/CDC

Document Security: Internal UseRO: Stepanov Denis

Read Access AD: ITER, AD: External Collaborators, AD: IO_Director-General, AD: EMAB, AD: OBS - Control System Division (CSD) - EXT, AD: OBS - CODAC Section (CDC) - EXT, AD: OBS - CODAC Section (CDC), AD: Auditors, AD: ITER Management Assessor, project administrator, RO

IDM UID

UENKLPVERSION CREATED ON / VERSION / STATUS

20 Feb 2017 / 1.2 / Approved

EXTERNAL REFERENCE / VERSION

PDF generated on 20 Feb 2017DISCLAIMER : UNCONTROLLED WHEN PRINTED – PLEASE CHECK THE STATUS OF THE DOCUMENT IN IDM

Change Log

CODAC Core System Version 5.4 Release Notes (UENKLP)

Version Latest Status Issue Date Description of Change

v1.0 Signed 01 Feb 2017

v1.1 Signed 16 Feb 2017 Include changes signaled by reviewers- OP applications release notes- name of the opc-ua package- Maven command new feature (no build when files not in SVN- New PLC IOC feature (Jignesh's)+ other minor changesUpdate documentation list as planned before final review

v1.2 Approved 20 Feb 2017 Final update for the releaseAdd IDM linkUpdate UDA Doc vs.

Page 1 of 10

CODAC CORE SYSTEM VERSION 5.4 RELEASE NOTESITER_D_UENKLP

This note is a supplementary document for the CODAC Core System (CCS) to provide users with information on the changes introduced with the release of the CCS 5.4.0 version. See warnings in these notes for changes that may have a significant impact on existing I&C applications. Those that are present since the previous version (impact on CCS 5.2 applications) are indicated with a reminder.This document is complemented with on-line information that is available at the CODAC Core System Community Pages that provides the CCS users with the up-to-date status of:

- The documentation- The changes introduced in each components (improvements and bug fixes)- The known issues remaining in the 5.4.0 version- The roadmap- The training material - these will be updated for CCS 5.4.0 in April 2017.

The CS-Studio release notes are in a separate document: CODAC Core System 5.4 CS-Studio Release Notes (UBEVKZ) The operational applications for FAT and SAT have been updated. Reference: CODAC Operational Applications Release Note (S3WV58 v1.2

Warning I&C projects developed with a previous versions of CCS shall be migrated to CCS 5.4.0 following the instructions available in the CODAC Core System Migration Guide (7JCFUD).

Page 2 of 10

COMPONENTS UPDATE

Components 5.0.0 5.1.0 5.2.0 5.3.0 5.4.0Operating System RHEL

MRG-R6.52.5

EPICS EPICSEPICS V4

3.15.14.4.0

3.15.24.4.0

3.15.34.5.0

3.15.44.5.0.2

3.15.54.6.0

Shared Units JavaEclipsePostgreSQLTomcat

1.8.04.4/3.79.3.57.0

1.8.04.4/3.79.3.57.0

1.8.04.5

9.3.58.0

1.8.04.5

9.3.58.0

1.8.04.5.29.3.58.0

Control System Studio

CS-Studio 4.0 4.2.0 4.3.2 4.3.4 4.4.7

Self Description Data

SDD tools 5.0 5.1 5.2 5.3 5.4

Maven Tools Maven tools 5.0 5.1 5.2 5.3 5.4Health Monitoring Health Mon 1.2 1.3 1.4 1.5 1.6PLC Driver S7PLC

S7PLC ASYNSPSS

2.11.02.1

2.11.13.0

2.11.23.1

2.11.3

3.1/3.2

2.11.43.2

TCN Support TCN APITCNdLinuxPTPUnified PTPd

3.14.01.3

3.1.14.11.3

3.2.05.0.01.3

3.2.15.0.11.3.1

3.2.15.1.0

1.0.0SDN Support SDN API

SDN Archiver2.0 2.1 2.1.0

1.02.1.11.0.1

2.1.21.1.0

DAN Support DAN API 2.0 2.1 2.1.2 2.2.0 2.2.3Logging Library LOG API 1.0 1.1 1.2 1.2.1 1.3.0NI Sync NI SYNC

NI SYNC EPICSNI SYNC PTPd

2.1.02.0.32.0.0

2.1.12.0.42.0.1

2.1.22.1.02.1.0

2.1.22.1.12.1.0

2.1.32.1.22.1.1

PXI-6259 PXI-6259PXI-6259 EPICS

2.3.12.3.1

2.4.12.4.0

2.5.02.5.0

2.5.02.6.0

2.5.12.6.1

PXI-6528 PXI-6528PXI-6528 EPICS

1.3.01.3.0

1.3.01.3.1

1.3.01.3.2

1.3.01.3.3

1.3.01.3.4

PXIe-6368 PXIe-6368 PXIe-6368 EPICS

1.1.01.1.0

2.0.11.2.0

2.1.01.3.0

2.2.01.4.0

2.2.01.5.0

NI RIO NI RIONI RIO EPICS (IRIO)

1.0.2-

1.0.31.0.0

1.0.41.1.0

2.0.01.1.1

2.0.01.1.2

NDS NDS 2.3.7 2.3.8 2.3.8 2.3.8 2.3.8Operational Applications

PSPS EditorSUPSDN ToolsSDN Monitor

1.41.01.01.0

1.4.11.0.11.0.11.0

1.5.01.1

1.0.51.0.1

Unified Data Access (UDA)

UDA 1.1.0

Page 3 of 10

1 Operating System (same as CCS 5.0/5.1/5.2/5.3)The RHEL version is RHEL 6.5. For non real-time profiles, the kernel version is 2.6.32, as for the CCS 4.x versions, but updated to 2.6.32-431.The MRG-R version is MRG-R 2.5. The kernel version is kernel-rt-3.10.33.

2 EPICS

2.1 EPICS BaseThe EPICS Base 3.15 has updated to 3.15.5 (patch release). Reference: http://www.aps.anl.gov/epics/base/R3-15/5.php

2.2 EPICS v4EPICS v4 has been upgraded to 4.6.0Summary of the changes:

pvDataJava and pvDataCPP

Minor changes since previous release

normativeTypesJava and normativeTypesCPP

Minor changes since previous release

pvAccessJava and pvAccessCPP

Minor changes since previous release

pvaClientJava and pvaClientCPP

More robust than previous release easyPva Java no longer supported

pvaSrv Minor changes since last releasepvaPy Several changes since last releaseexampleJava and exampleCPP

Many new examples since last release Several examples that were in pvaClient and pvDatabase have been moved to here

Reference: http://epics-pvdata.sourceforge.net/

2.3 EPICS ModulesUpdates

asyn 4.30Sequencer/SNL 2.2.4PyEPICS 3.2.5

areaDetectorThe areaDetector module with examples is provided for diagnostics applications for image acquisition. These components are not included in the system profiles but can be installed as required.Reference: http://cars9.uchicago.edu/software/epics/areaDetector.htmlThe available versions that can be installed on a CCS 5.4 system are:

areaDetector 2.4

examples 2.1

Page 4 of 10

The RPMs can be installed using $ sudo yum install <package> depending on the intended usage:

epics-ad-core areaDetector core libraries

epics-ad-core-devel development files, headers

epics-ad-core-opi BOY panels (autoconverted from medm)

epics-ad-simdetector areaDetector driver for simulated detector

epics-ad-simdetector-devel development files, headers, doc

epics-ad-example example application (IOC) using simdetector

Example: $ sudo yum install codac-core-5.4-epics-ad-example

will install the example application and all its dependencies on CCS 5.4.streamDevice examples

A package containing examples for the StreamDevice support has been included in the distribution.

OPC UA Device SupportEPICS Device Support for the OPC UA protocol, using the OPC UA client library from United Automation, has been included in the distribution. These components are not included in the system profiles but can be installed as required.

OPC UA EPICS Device Support 0.9.1

OPC UA client library 1.5.4

The following RPM packages are available:

epics-opcua-ua Device support for OPC UA client (United Automation)

epics-opcua-ua-devel development files, headers, README

ua-sdkcppclient OPC UA client library (United Automation)

The runtime (base) package is needed on runtime (production) systems. The development package is needed for development.The command to install a package is $ sudo yum install <package>

Example: $ sudo yum install codac-core-5.4-epics-opcua-ua-devel

will install the development environment and all its dependencies.

3 Shared Units

Page 5 of 10

Java and PostgreSQL are the same version for all CCS 5.x installation. No change for PostgreSQL.For CS-Studio, a new update for Java 1.8, 8u101, has been installed to replace 8u20. This change is affecting to all CCS 5.x installations.Eclipse has been updated to 4.5.2 (minor changes only)Tomcat is the same as for CCS 5.3

Reminder There is more than one instance of Tomcat to avoid interdependencies. As a result, the following port numbers shall be used:

- 8080 (default) is only for documentation - 8081 shall be used for the SDD web application- 8082 shall be used for the CS-Studio web clients

4 Control System Studio (CS-Studio) Enhancements:

By default, jumps will be assigned automatically to all horizontal lines crossing another line in an OPI

The alarm context menu allows to creating a logbook entry and accessing to Process Variable information and tools

ITER OPI Probe is resizable An Help button in the legend OPI opens codac-help in the default web browser css-dbmanager utility provides a simplified interface. More information with css-

dbmanager -help Connection/Disconnection simulated PV to test the disconnect behaviour on the

OPI Fixes:

Issue with multiple concurrent requests to archived data Y Axis autoscale on visible data only Connector issue with non-default route between widgets within different containers Issue with the event alarm time since event from the alarm context menu

The details are provided in dedicated release notes: CODAC Core System 5.4 CS-Studio Release Notes (UBEVKZ)

5 Self Description DataMain changes:

Extend translator to allow generation of one IOC per PLC Support of transition from Postcheck to Not Ready (COS-PSOS SNL) Support of naming an instance of a template. Operation such as search, export, import

and delete can now be done at instance level; Support for modification of existing templates with instances (provided that there is no

macros) Supervision (CTRL-SUP) project is now integrated in SDD Support of an alarm page definition at user template level Support for I&C program at server level

Page 6 of 10

Provide paging for generated objects HMIs (configurable parameters) Extend parser to support dry-run for BEAST and BEAUTY files Extend parser to support dry-run per domain (epics, beast, beauty) Performance improvement in export/import template instances, in saving a variable Provide a set of utilities to manage control units indexes (disable automatic creation of

indexes) and to generate AWLs with structured data and mapping function (case where templates are used)

The documentation has been updated for reflecting all changes.

6 Maven Tools

Reminder All the Maven commands have been removed from the operation system profiles: psh, pcf, pcf-rt and ct (PSH, fast controllers and CODAC terminal).As a result, the mvn command cannot be used anymore for installing RPMs on an operational system, neither locally nor from another development system (via the remote option)The yum command shall be used instead. Please check the CODAC Core System App Developer's Manual for details.

Changes:

Remove MVN Editor build dependency from CS-Studio Maven build fails if files are not under version control

7 Health MonitoringChanges:

Enable time alarm on cubicle monitoring PLC Type in EGU field for cubmon Create new records for uptime and version of tcnd Update list of records for cubicle PLC communication monitoring New service for CFA633 LCD of Opale V2 PICMG v1.3 fast controller New EPICS device support for PICMG v1.3 fast controller Integration of alarm page OPIs for I/O boards, PLC/EVTHLTS, CUBHTLS, TSTATUS

8 PLC DriverChanges

configurable callback queue size required for IOC with large number or records UDT for CBS4 and CBS5 have a new syntax to avoid name collisions

Warning In PLC, the UDT names for CBS4 and CBS5 functions have changed between CCS 5.3 and CCS 5.4In the new syntax, CBS3 is not omitted for CBS4 and CBS5 UDT but CBS1 is omitted for CBS5 UDT

9 TCN Support Changes:

Page 7 of 10

Unique PTP synchronization module for all TCN interfaces supported by CODAC (PXI board, PTP-enhanced Ethernet interface, plain Ethernet interface) - New component.

TCNd uptime available and published in SYSM variable (TUPTIME)

Warning Support for the legacy NI PXI 6682 boardThe new PTPd module supports only the NI PXI 6683H board and the ptpd-nisync daemon required for the legacy boards is not managed by the tcn-services script. The support for the legacy NI PXI 6682 on CCS 5.4 is therefore limited and the ptpd-nisync daemon will disappear in CCS 6.0.

10 SDN Support Add a function API to test validity of SDN_INTERFACE_NAME

11 DAN SupportChanges:

Remove the 2GB limit on buffer size (both client and archiver) Provide an API to retrieve the last datablock Automatic reconnection of the DAN streamer in case DAN archiver restarts Fix the master-slave configuration of DAN archiver

12 Logging Library Addition of a trace level

13 NI SyncChange:

Year 2038 bug fixed

14 PXI-6259No functional change, some code re-factoring.

15 PXI-6528No change

16 PXIe-6368Changes:

Addition of mbbiDirect/mbboDirect interface (EPICS)

17 NI RIONo significant change in CCS 5.4

Reminder (CCS 5.2 users)

For projects using the compactRIO hardware, the SDD board type name has been changed from "compactRIO" to "NI9159". This implies a manual change in the project. Please refer to section 5.1.5 (CompactRIO Boards) in the CODAC Core System Migration Guide (7JCFUD).

Page 8 of 10

Due to a change in the low level NI-RIO Linux driver, the hexadecimal RIO device serial number that is used as a string argument to the driver initialization call has to be prefixed with "0x" (case sensitive).

18 NDSNDS v2.3.8 is maintained in the CCS distribution for backward compatibility purposes but NDS users would rather use newer versions from the supplier, as available. Reference: https://github.com/Cosylab/nds3

19 CODAC Operational ApplicationsThe changes in the CODAC operational applications are described in an update of the dedicated release note: CODAC Operational Applications Release Note (S3WV58 v1.2) PSPS Editor:

Minor enhancements to workflow for export of configuration to SUPSUP:

POS sequence integration with elog application Data archive for pulse number management

20 Unified data Access (UDA)UDA is a set of modules which aims at providing transparent access to archived data. With CCS5.4, one can access data from SDN, DAN and PON without knowledge of data types and file names and location. UDA consists of a server part and clients. API in C/C++/Java and Python are available. We support queries both based on time and on shot number. Regarding viewer, we provide a set of basic plotters in Python, interface with Jscope (for shot-based queries) and with CS-databrowser for time access based data.

Page 9 of 10

DOCUMENTATION UPDATEDocument ID 5.0.0 5.1.0 5.2.0 5.3.0 5.4.0

OVERVIEWCODAC Core System Overview 34SDZ5 v5.0 v5.1 v5.2 v5.3 v5.4CODAC Core System User Manual 43PSH9 v3.4 v3.5 v3.6 v3.8 v3.9

INSTALLATION & SUPPORTCODAC Core System Installation Manual 33JNKW v5.1 v5.1 v5.2 v5.3 v5.3CODAC Installation Manager User Manual PKHN4H v1.0 v1.1CODAC Core System Migration Manual 7JCFUD v4.0 v5.0 v5.1 v5.3 v5.4

DEVELOPMENT & TESTINGCODAC Core System App Developer's Manual 33T8LW v5.0 v5.1 v5.2 v5.3 v5.4SDD Editor User Manual 32Z4W2 v8.0 v8.1 v8.3 v8.4 v8.6SDD Web Application User's Guide 42NFCY v8.0 v8.1 v8.4 v8.4 v8.5SDD Synchronization Guide 46AAXR v1.13 v1.14 v1.16 v1.16 v1.17How to include a new I/O module in SDD A4WQDZ v2.0 v2.0 v2.0 v2.0 v2.0Maven Editor User Guide 7MT2YC v5.1 v5.2 v5.4 v5.6 v5.7System Health Monitoring Variables 35XFCY v1.12 v1.14 v1.15 v1.17 v1.18Logging library - Software User Manual QEK784 v1.1 v1.1 v1.3 v1.4 v1.5

CONTROL SYSTEM STUDIOOperator Interface standardisation - CSS BOY Edition and Runtime

7367JQ v1.6 v1.7 v1.8 v1.8 v1.8

Operator Interface standardisation - CSS BOY Industrial Symbol Library

A69URK v1.4 v1.4 v2.0 v2.0 v2.0

SLOW CONTROLLERS (PLC)SPSS User Manual G4UMX5 v1.4 v2.0 v2.1 v2.1 v2.1S7 PLC EPICS Driver Extensions 6KFJEJ v2.0 v2.0 v2.0 v2.0 v2.0PLC Sample Guide 2N8C3M v4.0 v4.1 v4.2 v4.2 v4.2s7PLCAsyn EPICS Driver User's Manual PJAHXJ v1.0 v1.2 v1.3 v1.5 v1.8

FAST CONTROLLERS - I/ONI Sync Linux Device Driver User's Guide 2PLQ4P v2.6 v2.6 v2.7 v2.7 v2.7NI Sync EPICS Driver User's Guide 33Q5TX v2.10 v2.11 v2.12 v2.13 v2.13NI PXI-6259 Linux Driver User's Guide 32GTJY v1.18 v1.18 v1.19 v1.19 v1.19NI PXI-6259 EPICS Driver User's Guide 3DEY52 v2.8 v2.9 v2.10 v2.11 v2.11NI PXI-6528 Linux Driver User's Guide 3ZHXQ9 v1.8 v1.8 v1.8 v1.8 v1.8NI PXI-6528 EPICS Driver User's Guide 433VEW v1.11 v1.11 v1.12 v1.13 v1.13NI X-Series Linux Device Driver User's Guide 3LTMR6 v1.5 v1.5 v1.7 v1.7 v1.7NI X-Series EPICS Driver User's Guide 3P4N3R v1.4 v1.5 v1.7 v1.8 v1.9NI-RIO Linux Device Driver User Manual LW3UFH v2.4 v2.6 v2.6 v2.9 v2.9NI-RIO EPICS Device Driver User Manual RAJ9P8 - v1.0 v1.4 v1.5 v1.7IRIO Library user's manual RATM8Z - v1.0 v1.2 v1.2 v1.3NDS User Manual A6LWQ8 v1.2 v1.2 v1.2 v1.2 v1.2

FAST CONTROLERS – HPNTCN API - Software User Manual N4XTGG v1.6 v1.7 v1.11 v1.13 v1.16Linuxptp User Manual PNRCMB v1.2 v1.3 v1.4 v1.5 v1.5PTPd User Manual (New) U2TTSZ v1.3TCNd User Manual MUYNT6 v1.6 v1.7 v2.0 v2.1 v2.4SDN Software User Manual B7SKFU v2.0 v2.2 v2.6 v2.7 v2.10DAN User manual Q6GULS v1.3 v2.1 v2.2 v2.5 v2.6SDN Archiver User Manual SD29MG - - v1.2 v1.2 v1.3

Operational ApplicationsUser Manual for CODAC Operational Applications RUZCJ9 - - v1.3 v2.0 v2.1SDN Tools User Manual RGSWHS - - v1.4 v1.5 v1.5SDN Monitor User Manual S94S4T - - v1.2 v1.2 v1.2UDA User Manual (New) TPLTKG v1.1

Page 10 of 10