cliu
af9a1bbe29
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>
105 lines
8.9 KiB
Markdown
105 lines
8.9 KiB
Markdown
# 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`.
|