cliu/ci-server-engineer
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
ci-server-engineer/knowledge/version-differences.md
cliu bf7d88a027 R1.05 re-check batch 3: alarms, audit, authorization, classes, HAC, reporting, pyTOOLS 
Full manual diffs (L15, C20, E30, L25, J40, C10 §2, L10, P10, P11, J20,
C30, P20, R40, E10) and read-only checks on the shared R1.05 test server.
Skills and summaries moved to R1.05; new skill pytools (IM 36K10P40) from
docs (no Python on the test server). Issues ISS-132..181; corrections to
version-differences (E10, E30, P11, dss_ath_grp_u0104); C10 summary lists
the 3 new authorization actions; r105-verification V10-V17.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-09 10:21:36 +11:00

121 lines
11 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Version differences: R1.03 → R1.05
What changed between CI Server **R1.03.00** (what this repo was first written for; frozen on
branch `r1.03`, tag `r1.03-final`) and **R1.05.00** (current target of `main`).
Each skill and manual summary is moved to R1.05 one at a time; this file is where to look for
the changes in the meantime.
Sources: the revision tables at the end of each R1.05 manual (editions dated Feb. 2026; R1.04
editions Jan. 2025) and a read-only comparison of the installed files on the R1.03
development machine and the R1.05 test server (2026-10-08). Status: **from docs** plus
**verified** file lists; behaviour is not yet re-tested.
## 1. Installation and files (verified, 2026-10-08)
| | R1.03 (development machine) | R1.05 (test server) |
|---|---|---|
| Version string | `CI Server R1.03.00 (r10200M)` | `CI Server R1.05.00 (r11609M)` |
| Program root (`TLS_ROOT_PATH`) | `C:\Program Files (x86)\Yokogawa\CIServer` | `C:\Yokogawa\CIServer` |
| Data root (`TLS_ALLUSERS_PATH`) | `C:\Users\Public\Yokogawa\tls` | `C:\Yokogawa\CIServer\tls` (same folder as the program) |
| Manuals | `C:\Users\Public\Yokogawa\tls\doc\EN` | `C:\Yokogawa\CIServer\tls\doc\EN` |
| `tls_versions.lst` | all lines `R1.03.00` | 112 lines `R1.05.00`, `jython-full` `R1.04.00` |
The install paths may be a choice made at install time, not a product change. Always read the
`TLS_*` environment variables (`set TLS`) rather than assuming a path. Skills still show the R1.03 paths
until they are re-checked.
**Installed files that are new or gone** (only names that matter for engineering are listed):
| Area | New in R1.05 | Gone since R1.03 |
|---|---|---|
| IEC 60870-5-104 and IEC 61850 drivers | New driver family `eqt*` / `eta*`: `eqt104`, `eqt850`, `eqt850dmp`, `eqtdbg`, `eqtfrcscn`, `eqtiostat`, `etaman`, `eta104*.sup`, `eta850*.sup`, `eqtini.sup`, `eqt850.icd`, `eqtfrcscn.tpl`, `eqtini.tpl` | `eqp104`, `eqp850`, `eqp850dmp`, `epa104*.sup`, `epa850*.sup` (the drivers left the `eqp` EQUIPMENT family) |
| IEC 61850 configuration | Quick load / form programs `iec61850_line_u0104`, `iec61850_station_u0104`, `iec61850_point_u0105`, `iec61850_rcb_u0105` | — |
| OPC UA | `opcuac_method_u0104` (OPC UA client methods), `opcuac_station_u0104`, `opcaec_station_u0104` | `opcaec_station_u0103` |
| REST API | `jrstsrv.jar`, `jrstsrv.sup`, `jrstsrv.tpl` (RESTful API server on TCP 34597, IM 36K10L45 ch. 4; skill `data-access`) | — |
| Upgrade | `jupgutl.cmd`, `jmrg.jar` (merge configuration files on upgrade, IM 36K01C10 ch. 3) | — |
| Data access | `dacbackfill.cmd`, `intimpdac.exe` (OPC DA backfill; not yet investigated) | — |
| Graphics | `connectrdp.cmd` (Edit Module *RDP Connect* action, IM 36K10C50 §2.31) | — |
| Authorization | `dss_ath_grp_u0104` (authorization group form/loader, new revision) | — |
| Setup files | `fcsini.sup`, `scsini.sup`, `ugsini.sup`, `vvnetini.sup` now in `tls\sup` (were only templates in R1.03), `extjython-full.sup` | — |
The R1.03 development machine also had `eqpcieng*`, `opxcieng*` and `adtlogci.sup` files that were added there
for the sample project `CI-Eng-Sample`; they are not part of the product.
## 2. Manuals (from docs)
All 39 manuals were reissued (Feb. 2026). One manual is new. Most of them only added contact
information. The table lists the ones with real changes after R1.03, with the sections named in
the R1.04 and R1.05 revision tables.
| Manual | Changes after R1.03 | Repo area to re-check |
|---|---|---|
| **IM 36K10P40 pyTOOLS Programmer's Guide** | **New** (R1.04): Python extension module for DSS (connect, read/modify datasets, filter, lock, events, BUS messages, item history). Runs on CI Core / CI Portal, local node only. | new skill or `system-management` task |
| IM 36K01C10 CI Server Setup | R1.04: OS list, Defender, WMIC on Win 11 24H2, Vnet/IP drivers, Kernel DMA check, VAGW Bossd service, upgrade workflow, instance setup files vs templates. R1.05: IT security version 3.0, LAPS, automatic merge of configuration files on upgrade (`jupgutl`), new ch. 4 *Connecting CI Server and PRM* | `installation-security` |
| IM 36K01C30 Security Guide | R1.04: Windows Server 2022 (2016 removed), registry permissions, firewall port table, services list. R1.05: Windows 11 Enterprise LTSC 2024, IT security 3.0, §4.8.3–4.8.4 domain join, §5.27 new, ch. 6 safe API use | `installation-security` |
| IM 36K01A50 Release Information | Precaution sets updated (e.g. lockout policy dialog when upgrading from R1.03 with IT security applied) | `knowledge/manuals/IM36K01A50-01EN.md` |
| IM 36K10L45 Data Access Engineering | R1.04: ch. 4 new, §10.3.4, 10.5, 10.6 new, setup-file parameters in §10.4, 10.9, 11, 11.5.2. R1.05: §11.4 new, §11.1.6 note, §11.6.2 setup file, App. 1.3 | `data-access` |
| IM 36K10E20 OPC Interface | R1.04: parent object node ID and arguments of OPC UA methods. R1.05: certificate-expiry notifications, ch. 3 new *OPC UA Information Model Mapper* (map external OPC UA entities to CI Server), App. 1 SQL keywords | `data-access` |
| IM 36K10L41 EQUIPMENT Configuration | R1.04: item status descriptions (§3.4.5–3.4.8), §3.12.2, §3.15, IEC 61850 functions (§3.32), App. 1 new (precautions on upgrade to R1.04). R1.05: §3.32, App. 1.3, App. 1.4 new | `equipment` |
| IM 36K10L50 Data Set Service Engineering | R1.04: OPC UA client method dataset renamed `OPCUAC_METHOD_CALL_IN_DF` → `OPCUAC_METHOD_CALL2_DF` (installed: `…CALL_IN_DF` and `…CALL_OUT_DF` both gone); new datasets `IEC61850_RCB_DF`, `UASERVER_MAPPER_DF`, `API_KEYS_DF` | `system-management`, `data-access` |
| IM 36K10C40 Engineering Module – Historical | R1.04 §4.2: external access to history now lists ODBC, .NET API, **RESTful API**, **pyTOOLS** (C API no longer listed) | `history-management` |
| IM 36K10C50 Edit Module | R1.04: §2.22 properties, §2.31 *Password Check* action, §4.12 update item/parameter. R1.05: §2.22, 2.25, 2.26, 2.33 properties, §2.31 *RDP Connect* action | `graphics` |
| IM 36K10C60 Advanced Operating Graphics | R1.04 §1.2.2: demo displays | `graphics` |
| IM 36K10R30 Graphic Display Setup | R1.05: §4.8 Enterprise Operation properties, §4.10 restrictions | `graphics` |
| IM 36K10R10 CI Portal Setup | R1.04 §3.3 (`dur.sup`), installation from ISO file instead of DVD | `portal-setup` |
| IM 36K10J10 System Design/Management | R1.04 §2.9.1 | `system-management` |
| IM 36K10C10 Engineering Module – I/O | R1.04 §2.2 | `item-engineering` |
| IM 36K10G10 Tutorial | R1.04 §9.2, ch. 14 new. R1.05 ch. 14 extended, ch. 15 new | `knowledge/manuals/IM36K10G10-01EN.md` |
| IM 36K10L55 Exchange Tool Engineering | R1.04: upgrade scenario for CI Exchange for CENTUM VP. R1.05 §2.7: HIS-TSE connection options | `knowledge/manuals/IM36K10L55-01EN.md` |
**Revision table lists only contact information:** C20, C30, E10, E30, J20, J40, L10, L15,
L20, L25, L30, L35, L36, L40, P10, P11, P20, P30, R20, R40. The revision tables do not list
every R1.04 edit, so each of these was also compared word by word with its R1.03 edition
(`tools/manual_diff.py`, 2026-10-08). Result:
| Manual | Unlisted changes found by the text diff |
|---|---|
| E10 Excel Add-in | §3 no longer says the Connection Manager shows `localhost` first and then the last server used. (The item-filter text first listed here only moved between pages: corrected 2026-10-09, ISS-166.) |
| E30 Alarm System Performance Analysis | §3.2 KPI grid: the charts now have labels (*In Time*, *Too Late*, *Not Ackn*, *Nuisance*) and the third chart is corrected to alarms **not** acknowledged in the period (ISS-132) |
| L30 BUS Service | `durwfp` return value reworded (1 = process attached/running, 0 = otherwise); same meaning |
| P11 Java class language | §10.2 reworded, with one real fix: `createSection()` is described without the process-area argument; the §8 examples still pass it (ISS-154) |
| P20 RQL | Footer `<position>` sentence split in two; same meaning |
| L40, R20, R40, C30, L35, J40 | Spacing, punctuation, titles only |
| C20, J20, L10, L15, L20, L25, L36, P10, P30 | None |
Skills based only on these manuals still need a quick re-test on R1.05 (installed files may
differ), but their content is expected to hold. All of them were re-checked in batches 2 and 3
(2026-10-08/09).
**Unlisted changes found in the second re-check batch (2026-10-08):**
| Manual | Change not named in the revision table |
|---|---|
| C10 | §1.1 new *Tools* menu (OPC UA Information Model Mapper); §3.3.4 string item length max 200 bytes (was 100 characters) |
| G10 | §3.2.2 string length max 200 bytes; small rewording in §8, §13 |
| C50 | §1.5 `jwuiutl -m/-M` output space-separated; §1.7 and §2.36 HTML-display notes removed; §2.27 trend *Enterprise* supported on the web; §2.31 *Calculation/Function* renamed *Generic Functions* with documented timing; §2.32 JavaScript function timing |
| R30 | §4.4 enterprise supported on the HTML display; §4.7.15 removed; §4.8.1 alarm overview enterprise note removed; §4.10 restrictions changed |
| R10 | §3.1 setup from the ISO file (R1.04); §3.3 only a new cross-reference |
| J10 | new §3.2.6 *Gateway* configuration; §5.1 licence request wizard no longer listed |
| C40 | §4.2 remote access now "ODBC and RESTful API" |
**Installed-software changes with no manual text** (see the issues): `dur.sup` `gateway_core` and `ADTSTO` adaptive queue (ISS-109, 122); `jwuiisg.sup` redirect, whitelisting, cache keywords, security headers and CSP (ISS-110, 111); DSS processes `DSSSDARST` / `DSSSDAPY` and `dss.sup` queue sizes (ISS-117); start-script extension hooks `?*_<script>.cmd` (ISS-121); `ITEM_VAL` fields `ENG_UNIT`, `SCALE_HIGH_LIMIT`, `SCALE_LOW_LIMIT` (ISS-126); `AUTH_GROUP_DF` up to 250 actions; `tlsdnetapi.dll` no longer installed.
Batch 3 (2026-10-09): `AUDIT_TRAIL` `APPROVAL_REASON` / `APPROVER` and E_LAYOUT units (ISS-140); 36 new audit classifiers incl. `PENDING`, `REST-SERVER`, `PYTOOLS`, `PASSWORD-CHECK` (ISS-141); 3 new authorization actions `UA_MAPPER_PROJECT_*` (ISS-146); `dss_ath_grp_u0104` is a database upgrade tool run once by `database_start.cmd`, not a loader (ISS-147); `dssana.sup` user interfaces *RESTful API Server*, *Python Interface*, *Password Check Function* (ISS-148); `API_KEYS_DF` holds no key values (ISS-151); internal `ALARM_ATTRIBUTE_TEMP_DF` (ISS-133); `alnsms.sup` defaults (ISS-134); OPC UA method system classes `UAC_MTD_JBASE` / `UAS_MTD_JBASE` (ISS-155); Java runtime 11.0.28 (ISS-156); extension hooks also in alarm, audit, process, report and HAC scripts (ISS-121, 142, 160); `dss.pyd` pyTOOLS module 3.6.1 (ISS-174).
**Method for every manual re-check:** do not rely on the revision table or the release notes.
Run `python tools/manual_diff.py <R1.03 doc\EN> <R1.05 doc\EN> <IM>` and review every change,
including those made in R1.04.
## 3. Re-check plan
Order (biggest change first), tracked in `progress.md` under *R1.05 re-check*:
1. `system-check` (paths, version string): done in the baseline.
2. `installation-security`, `data-access`, `equipment`: real manual changes. Re-checked read-only 2026-10-08
(ISS-076–090). IM 36K10L45 section numbers moved by one chapter from ch. 4 on (new ch. 4 REST API).
3. New pyTOOLS manual (P40) and the REST API.
4. `graphics`, `history-management`, `portal-setup`, `system-management`.
5. All other skills: re-test the task files on R1.05, no manual change expected.
The R1.05 test server is **shared with other projects**. Re-checks there are read-only unless
the user approves a change; see "Test system" in `progress.md`.
Reference in a new issue View git blame Copy permalink