ci-server-engineer/knowledge/version-differences.md
cliu af9a1bbe29 Full-text manual diff R1.03 -> R1.05 (catch unlisted R1.04 edits)
tools/manual_diff.py: word-level diff of one manual between two doc folders.
version-differences.md: the 20 manuals whose revision tables list only
contact information were diffed; E10 and E30 have real content changes,
the rest wording only. CLAUDE.md: re-checks use the full diff.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-08 18:35:39 +11:00

8.9 KiB
Raw Blame History

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 Item search: new description of the Item Filter / Description Filter boxes and wildcards (* default; both filters combine with AND); a CI Portal SSL note moved
E30 Alarm System Performance Analysis KPI grid: the KPI charts now have labels (In Time, Too Late, Not Ackn, Nuisance)
L30 BUS Service durwfp return value reworded (1 = process attached/running, 0 = otherwise); same meaning
P11 Java class language §10.2 methods reworded; same meaning
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. The E10 and E30 changes go into the reporting and alarm-management re-checks.

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.