cliu/ci-server-engineer
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Move main to CI Server R1.05: version split, differences, system check #26

Merged
cliu merged 1 commit from chore/r1.05-baseline into main 2026-10-08 18:10:08 +11:00
Conversation 0 Commits 1 Files changed 7 +259 -92
7 changed files with 259 additions and 92 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

60
.claude/skills/system-check/SKILL.md
View file

@ -4,10 +4,10 @@ description: >-
Read-only check of a CI Server machine, run before any CI Server work. Use when Read-only check of a CI Server machine, run before any CI Server work. Use when
the user asks which CI Server version is installed, whether CI Server is running, where it is the user asks which CI Server version is installed, whether CI Server is running, where it is
installed, whether time is synchronized, or before starting any task in another skill. installed, whether time is synchronized, or before starting any task in another skill.
Also covers starting CI Server (needs administrator rights). Target version R1.03. Also covers starting CI Server (needs administrator rights). Target version R1.05 (R1.03 on branch r1.03).
version: R1.03 version: R1.05 (first written for R1.03)
source: IM 36K10J10-01EN §1.2, §1.4, §3.6, §3.7; practiced on the test system 2026-09-29/30 source: IM 36K10J10-01EN §1.2, §1.4, §3.6, §3.7; practiced on the R1.03 test system 2026-09-29/30 and the R1.05 test server 2026-10-08
status: verified (2026-09-30) status: verified on R1.03 (2026-09-30); sections 1, 2 and 4 verified on R1.05 (2026-10-08)
--- ---
# System check # System check
@ -23,11 +23,13 @@ $keys = @('HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*','HKLM:\S
foreach ($k in $keys) { foreach ($i in (Get-ItemProperty $k -ErrorAction SilentlyContinue)) { if ($i.DisplayName -match 'CI Server') { "{0} | {1}" -f $i.DisplayName, $i.DisplayVersion } } } foreach ($k in $keys) { foreach ($i in (Get-ItemProperty $k -ErrorAction SilentlyContinue)) { if ($i.DisplayName -match 'CI Server') { "{0} | {1}" -f $i.DisplayName, $i.DisplayVersion } } }
``` ```
Expected for this repo: `CI Server R1.03.00 (r10200M) | 1.03.00`. Anything else: warn the Expected for this branch: `CI Server R1.05.00 (r11609M)`. R1.03 (`CI Server R1.03.00 (r10200M)`):
user that the repo targets R1.03. switch to the repo branch `r1.03`. Anything else: warn the user that the repo targets R1.05
(see `knowledge/version-differences.md`).
**From the running system** (preferred when CI Server is running): export the local node **From the running system** (preferred when CI Server is running): export the local node
dataset and read `VERSION_MAJOR`, `VERSION_MINOR`, `VERSION_PACK` (1, 3, 0 = R1.03.00). dataset and read `VERSION_MAJOR`, `VERSION_MINOR`, `VERSION_PACK` (1, 5, 0 = R1.05.00;
1, 3, 0 = R1.03.00).
``` ```
dssqld -e local_node.qli -d LOCAL_NODE_DF -c -l local_node.lst dssqld -e local_node.qli -d LOCAL_NODE_DF -c -l local_node.lst
@ -39,8 +41,9 @@ licence state (`NAME`/`NODE_NAME` = `UNLICENCED` means no licence is registered)
to find another dataset. to find another dataset.
**Per-component versions** (rewritten at every start): `%TLS_ALLUSERS_PATH%\lst\tls_versions.lst`, **Per-component versions** (rewritten at every start): `%TLS_ALLUSERS_PATH%\lst\tls_versions.lst`,
one line per component: `<file>,<version>,<size>,<build date>`. On the test system all 110 one line per component: `<file>,<version>,<size>,<build date>`. On the R1.03 test system all 110
lines read `R1.03.00`; a different version on some lines means a patch is installed. lines read `R1.03.00`; on the R1.05 test server 112 lines read `R1.05.00` and `jython-full`
reads `R1.04.00` (as installed). Other different versions usually mean a patch is installed.
**Message log**: `%TLS_LOG_PATH%\umhlog.log` holds CI Server messages **Message log**: `%TLS_LOG_PATH%\umhlog.log` holds CI Server messages
(`--> From: <PROCESS> (<node>) on <time>` then `<FAC>-<I|W|E>-<CODE>, <text>`). Read it after (`--> From: <PROCESS> (<node>) on <time>` then `<FAC>-<I|W|E>-<CODE>, <text>`). Read it after
@ -49,22 +52,26 @@ station). It can contain connection strings with passwords; never copy those int
## 2. Install paths (environment variables) ## 2. Install paths (environment variables)
| Variable | Typical value | Holds | The paths differ between installations, so read them with `set TLS` (cmd) or
|---|---|---| `Get-ChildItem env:TLS*` (PowerShell) and never assume them.
| `TLS_ROOT_PATH` / `TLS_ITROOT_PATH` | `C:\Program Files (x86)\Yokogawa\CIServer` | Program: `tls\com` (start scripts), `tls\exe` (tools), `tls\sup` (setup files) |
| `TLS_ALLUSERS_PATH` | `C:\Users\Public\Yokogawa\tls` | Data root | | Variable | R1.05 test server | R1.03 test system | Holds |
| `TLS_DAT_PATH` | `…\tls\dat` | Database | |---|---|---|---|
| `TLS_HIS_PATH` | `…\tls\his` | History | | `TLS_ROOT_PATH` / `TLS_ITROOT_PATH` | `C:\Yokogawa\CIServer` | `C:\Program Files (x86)\Yokogawa\CIServer` | Program: `tls\com` (start scripts), `tls\exe` (tools), `tls\sup` (setup files) |
| `TLS_SAV_PATH` | `…\tls\sav` | Saved data | | `TLS_ALLUSERS_PATH` | `C:\Yokogawa\CIServer\tls` | `C:\Users\Public\Yokogawa\tls` | Data root (manuals in `doc\EN`) |
| `TLS_LOG_PATH`, `TLS_LST_PATH` | `…\tls\log`, `…\tls\lst` | Logs and listings | | `TLS_DAT_PATH` | `…\tls\dat` | `…\tls\dat` | Database |
| `TLS_WAP_PATH` | `…\tls\wap` | Web application files | | `TLS_HIS_PATH` | `…\tls\his` | `…\tls\his` | History |
| `TLS_SAV_PATH` | `…\tls\sav` | `…\tls\sav` | Saved data |
| `TLS_LOG_PATH`, `TLS_LST_PATH` | `…\tls\log`, `…\tls\lst` | `…\tls\log`, `…\tls\lst` | Logs and listings |
| `TLS_WAP_PATH` | `…\tls\wap` | `…\tls\wap` | Web application files |
`tls\com` and `tls\exe` are on `PATH`, so tools such as `dssqld` and `itmval` run from any `tls\com` and `tls\exe` are on `PATH`, so tools such as `dssqld` and `itmval` run from any
prompt. Setup files (`*.sup`) are plain text (CRLF); edit them with the Setup File Editor. prompt. Setup files (`*.sup`) are plain text (CRLF); edit them with the Setup File Editor.
## 3. Is CI Server running? ## 3. Is CI Server running?
- Windows service `StartCIServer` ("CI Service"), start type Manual on the test system. - Windows service `StartCIServer` ("CI Service"), start type Manual on the R1.03 test system,
Automatic (Delayed Start) on the R1.05 test server.
- Running processes live under `…\Yokogawa\CIServer\tls\exe`. None running = CI Server stopped. - Running processes live under `…\Yokogawa\CIServer\tls\exe`. None running = CI Server stopped.
- Most tools (`dssqld`, `itmval`, …) need CI Server running. - Most tools (`dssqld`, `itmval`, …) need CI Server running.
- Starting it needs administrator rights (the service runs as `.\CIX_PROCESS`, binary - Starting it needs administrator rights (the service runs as `.\CIX_PROCESS`, binary
@ -111,3 +118,18 @@ Check the source matches the design (domain controller, NTP server or `NOSYNC` o
`durm_udp`, `eqpmdc`, `eqpmqtt`, `wfl*`). `durm_udp`, `eqpmdc`, `eqpmqtt`, `wfl*`).
- `LOCAL_NODE_DF`: version 1.3.0 (R1.03.00), node 1, **UNLICENCED**, router type Endpoint. - `LOCAL_NODE_DF`: version 1.3.0 (R1.03.00), node 1, **UNLICENCED**, router type Endpoint.
- Windows Time running, source `time.windows.com`; synchronized on 2026-09-30 (stratum 5). - Windows Time running, source `time.windows.com`; synchronized on 2026-09-30 (stratum 5).
## R1.05 test server results (2026-10-08)
Read-only check on the shared R1.05 test server (other projects run there).
- Version `CI Server R1.05.00 (r11609M)`; `LOCAL_NODE_DF` version 1.5.0, node 1, node name
`CORE_0001`, router type Endpoint, **licensed** (`NAME` = `THIS_NODE`, not `UNLICENCED`), so
the unlicensed 1-hour shutdown does not apply there.
- Paths as in the table (program and data both under `C:\Yokogawa\CIServer`).
- CI Service running, start type Automatic (Delayed Start), account `.\CIX_PROCESS`, binary
`C:\Yokogawa\CIServer\tls\exe\ciserv.exe`.
- Windows Time synchronized from the *VM IC Time Synchronization Provider* (virtual machine
host), stratum 4.
- Section 3 (starting and stopping) was not repeated: the server is shared and must not be
restarted for a test.

18
CLAUDE.md
View file

@ -5,9 +5,13 @@ in CI Server; you do it (or prepare it for them) using the knowledge in this rep
## Before any CI Server work ## Before any CI Server work
1. **Confirm the software version.** This repo covers CI Server **R1.03** (R1.03.00). 1. **Confirm the software version.** This branch (`main`) targets CI Server **R1.05**
Check the installed version first (skill `system-check`). If it is not R1.03, (R1.05.00) and is being moved over from R1.03 one skill at a time: until a skill is marked
tell the user before doing anything and point out which content may not apply. R1.05, it was verified on R1.03 only. Check the installed version first (skill
`system-check`) and read `knowledge/version-differences.md` for what changed.
- R1.03 system: use the frozen branch `r1.03` (tag `r1.03-final`) instead of `main`.
- Any other version: tell the user before doing anything and point out which content may
not apply.
2. **Ask how the user wants to work** — once per conversation, before the first action: 2. **Ask how the user wants to work** — once per conversation, before the first action:
- **Direct**: you make changes in CI Server yourself (run tools, edit setup files, load data). - **Direct**: you make changes in CI Server yourself (run tools, edit setup files, load data).
- **Prepare only**: you only read the system's files, generate new files in a location the - **Prepare only**: you only read the system's files, generate new files in a location the
@ -42,7 +46,8 @@ cover something, say so plainly instead of guessing CI Server behavior.
## Building the repo (development stage) ## Building the repo (development stage)
The manuals are at `C:\Users\Public\Yokogawa\tls\doc\EN\` on the development machine. Work The R1.05 manuals are on the R1.05 test server in `C:\Yokogawa\CIServer\tls\doc\EN\` (the
R1.03 ones at `C:\Users\Public\Yokogawa\tls\doc\EN\` on the development machine). Work
proceeds manual by manual in the order in `knowledge/progress.md`: summarize the manual into proceeds manual by manual in the order in `knowledge/progress.md`: summarize the manual into
`knowledge/manuals/`, practice each task on the test system, and record a task in a skill only `knowledge/manuals/`, practice each task on the test system, and record a task in a skill only
after the user confirms it works. Tasks may be practiced first on the author's AID test after the user confirms it works. Tasks may be practiced first on the author's AID test
@ -50,3 +55,8 @@ project, but whatever they need must then be added to `CI-Eng-Sample` and re-tes
a task is done only when it passes on the sample project (or needs no project data). Track a task is done only when it passes on the sample project (or needs no project data). Track
status in `knowledge/progress.md`. Log open questions status in `knowledge/progress.md`. Log open questions
and problems in `knowledge/issues.md`, each with the files to update once it is resolved. and problems in `knowledge/issues.md`, each with the files to update once it is resolved.
The R1.05 test server is shared with other projects. Never disturb their work there: run only
read-only checks unless the user approves a change, never restart CI Server, never write to other
projects' records or to live plant values, and remove anything you put on the server.
Fixes that also apply to R1.03 can be cherry-picked onto branch `r1.03`.

17
README.md
View file

@ -1,8 +1,18 @@
# ci-server-engineer # ci-server-engineer
A knowledge base that lets Claude Code work as a Yokogawa CI Server (R1.03) engineer. A knowledge base that lets Claude Code work as a Yokogawa CI Server engineer.
Open this repo in Claude Code and describe what you want to do in CI Server. Open this repo in Claude Code and describe what you want to do in CI Server.
## Versions
| CI Server | Use | Status |
|---|---|---|
| **R1.05** | branch `main` | Being moved over from R1.03 one skill at a time; see `knowledge/version-differences.md` and `knowledge/progress.md` |
| **R1.03** | branch `r1.03` (tag `r1.03-final`) | Frozen; only fixes are added |
For an R1.03 system, check out the `r1.03` branch, or keep it next to `main` as a separate
folder: `git worktree add ../ci-server-engineer-r1.03 r1.03`.
## Layout ## Layout
| Path | Contents | | Path | Contents |
@ -17,8 +27,9 @@ Open this repo in Claude Code and describe what you want to do in CI Server.
Using the repo needs no manuals: the knowledge is in `knowledge/` and `.claude/skills/`. Using the repo needs no manuals: the knowledge is in `knowledge/` and `.claude/skills/`.
Only to **extend** the repo (summarize a manual, check a citation) you need the CI Server EN Only to **extend** the repo (summarize a manual, check a citation) you need the CI Server EN
manuals locally. They are not stored in this repo. The default location is manuals locally. They are not stored in this repo. They are installed in `tls\doc\EN\` under
`C:\Users\Public\Yokogawa\tls\doc\EN\`; see `knowledge/document-map.md` if yours is different. the CI Server data folder (`%TLS_ALLUSERS_PATH%`): `C:\Yokogawa\CIServer\tls\doc\EN\` on the
R1.05 test server, `C:\Users\Public\Yokogawa\tls\doc\EN\` on the R1.03 machine.
## Contributing ## Contributing

1
knowledge/README.md
View file

@ -9,3 +9,4 @@ that area's skill (`.claude/skills/<area>/reference/`).
| `progress.md` | Working order of the manuals and status of every practiced task | | `progress.md` | Working order of the manuals and status of every practiced task |
| `manuals/` | One summary per manual (`IM36K….md`), written in our own words | | `manuals/` | One summary per manual (`IM36K….md`), written in our own words |
| `document-map.md` | All EN manuals by IM number, with editions | | `document-map.md` | All EN manuals by IM number, with editions |
| `version-differences.md` | What changed from R1.03 to R1.05 (manuals and installed files) |

132
knowledge/document-map.md
View file

@ -2,113 +2,115 @@
| | | | | |
|---|---| |---|---|
| **Software** | Yokogawa CI Server **R1.03** (R1.03.00 or later) | | **Software** | Yokogawa CI Server **R1.05** (R1.05.00); R1.03 editions kept for comparison |
| **Documentation set** | English manuals, editions dated Sep. 2023 (see Edition column) | | **Documentation set** | English manuals, R1.05 editions dated Feb. 2026; R1.03 editions dated Sep. 2023 |
| **Source** | `ciserver.pdf` (English page) in the documentation folder | | **Source** | `ciserver.pdf` (English page) in the documentation folder |
> [!IMPORTANT] > [!IMPORTANT]
> **Documentation location is machine-specific.** > **Documentation location is machine-specific.**
> The links below point to the default location on the machine where this map was written: > The links below point to the location on the R1.05 test server:
> `C:\Users\Public\Yokogawa\tls\doc\EN\` > `C:\Yokogawa\CIServer\tls\doc\EN\` (on the R1.03 development machine it was
> `C:\Users\Public\Yokogawa\tls\doc\EN\`). In general it is `%TLS_ALLUSERS_PATH%\doc\EN\`.
> >
> The PDFs are **not** stored in this repository. If your CI Server documentation is installed > The PDFs are **not** stored in this repository. If your CI Server documentation is installed
> elsewhere, the links will not open. Look up the manual by its **IM number / file name** > elsewhere, the links will not open. Look up the manual by its **IM number / file name**
> (e.g. `IM36K01C10-01EN.pdf`) in your own `...\doc\EN\` folder, or find-and-replace > (e.g. `IM36K01C10-01EN.pdf`) in your own `...\doc\EN\` folder, or find-and-replace
> `file:///C:/Users/Public/Yokogawa/tls/doc/EN/` in this file with your local path. > `file:///C:/Yokogawa/CIServer/tls/doc/EN/` in this file with your local path.
> >
> If your installed CI Server release is not R1.03, check that your manual editions match the ones listed here. > What changed between the editions: `version-differences.md`.
## Read Me First ## Read Me First
| Document | IM Number | Edition | | Document | IM Number | R1.05 edition | R1.03 edition |
|---|---|---| |---|---|---|---|
| [Read Me First](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K01A10-01EN.pdf) | IM 36K01A10-01EN | 2nd Edition, Sep. 2023 | | [Read Me First](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K01A10-01EN.pdf) | IM 36K01A10-01EN | 4th Edition, Feb. 2026 | 2nd Edition, Sep. 2023 |
| [CI Server Release Information](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K01A50-01EN.pdf) | IM 36K01A50-01EN | 3rd Edition, Sep. 2023 | | [CI Server Release Information](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K01A50-01EN.pdf) | IM 36K01A50-01EN | 5th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
## Installation ## Installation
| Document | IM Number | Edition | | Document | IM Number | R1.05 edition | R1.03 edition |
|---|---|---| |---|---|---|---|
| [CI Server Setup](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K01C10-01EN.pdf) | IM 36K01C10-01EN | 3rd Edition, Sep. 2023 | | [CI Server Setup](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K01C10-01EN.pdf) | IM 36K01C10-01EN | 5th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
| [CI Server Security Guide](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K01C30-01EN.pdf) | IM 36K01C30-01EN | 3rd Edition, Sep. 2023 | | [CI Server Security Guide](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K01C30-01EN.pdf) | IM 36K01C30-01EN | 5th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
## User Manual ## User Manual
### Engineering Basics ### Engineering Basics
| Document | IM Number | Edition | | Document | IM Number | R1.05 edition | R1.03 edition |
|---|---|---| |---|---|---|---|
| [Engineering Module - I/O Processes](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10C10-01EN.pdf) | IM 36K10C10-01EN | 3rd Edition, Sep. 2023 | | [Engineering Module - I/O Processes](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10C10-01EN.pdf) | IM 36K10C10-01EN | 5th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
| [Engineering Module - Alarms](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10C20-01EN.pdf) | IM 36K10C20-01EN | 3rd Edition, Sep. 2023 | | [Engineering Module - Alarms](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10C20-01EN.pdf) | IM 36K10C20-01EN | 4th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
| [Engineering Module - Reporting](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10C30-01EN.pdf) | IM 36K10C30-01EN | 3rd Edition, Sep. 2023 | | [Engineering Module - Reporting](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10C30-01EN.pdf) | IM 36K10C30-01EN | 4th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
| [Engineering Module - Historical](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10C40-01EN.pdf) | IM 36K10C40-01EN | 3rd Edition, Sep. 2023 | | [Engineering Module - Historical](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10C40-01EN.pdf) | IM 36K10C40-01EN | 5th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
| [Edit Module](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10C50-01EN.pdf) | IM 36K10C50-01EN | 3rd Edition, Sep. 2023 | | [Edit Module](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10C50-01EN.pdf) | IM 36K10C50-01EN | 5th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
| [Advanced Operating Graphics](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10C60-01EN.pdf) | IM 36K10C60-01EN | 3rd Edition, Sep. 2023 | | [Advanced Operating Graphics](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10C60-01EN.pdf) | IM 36K10C60-01EN | 5th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
### Function ### Function
| Document | IM Number | Edition | | Document | IM Number | R1.05 edition | R1.03 edition |
|---|---|---| |---|---|---|---|
| [Excel Add-in Data Analysis and Reporting](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10E10-01EN.pdf) | IM 36K10E10-01EN | 3rd Edition, Sep. 2023 | | [Excel Add-in Data Analysis and Reporting](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10E10-01EN.pdf) | IM 36K10E10-01EN | 4th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
| [OPC Interface](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10E20-01EN.pdf) | IM 36K10E20-01EN | 2nd Edition, Sep. 2023 | | [OPC Interface](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10E20-01EN.pdf) | IM 36K10E20-01EN | 4th Edition, Feb. 2026 | 2nd Edition, Sep. 2023 |
| [Alarm System Performance Analysis](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10E30-01EN.pdf) | IM 36K10E30-01EN | 3rd Edition, Sep. 2023 | | [Alarm System Performance Analysis](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10E30-01EN.pdf) | IM 36K10E30-01EN | 4th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
## Tutorial ## Tutorial
| Document | IM Number | Edition | | Document | IM Number | R1.05 edition | R1.03 edition |
|---|---|---| |---|---|---|---|
| [CI Server Tutorial](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10G10-01EN.pdf) | IM 36K10G10-01EN | 3rd Edition, Sep. 2023 | | [CI Server Tutorial](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10G10-01EN.pdf) | IM 36K10G10-01EN | 5th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
## Engineering Manual ## Engineering Manual
### System Design / System Construction ### System Design / System Construction
| Document | IM Number | Edition | | Document | IM Number | R1.05 edition | R1.03 edition |
|---|---|---| |---|---|---|---|
| [CI Server System Design/Management](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10J10-01EN.pdf) | IM 36K10J10-01EN | 3rd Edition, Sep. 2023 | | [CI Server System Design/Management](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10J10-01EN.pdf) | IM 36K10J10-01EN | 5th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
| [High Availability Computing](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10J20-01EN.pdf) | IM 36K10J20-01EN | 3rd Edition, Sep. 2023 | | [High Availability Computing](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10J20-01EN.pdf) | IM 36K10J20-01EN | 4th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
| [Active Directory Integration](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10J40-01EN.pdf) | IM 36K10J40-01EN | 3rd Edition, Sep. 2023 | | [Active Directory Integration](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10J40-01EN.pdf) | IM 36K10J40-01EN | 4th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
### Function ### Function
| Document | IM Number | Edition | | Document | IM Number | R1.05 edition | R1.03 edition |
|---|---|---| |---|---|---|---|
| [Class/Object Engineering](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10L10-01EN.pdf) | IM 36K10L10-01EN | 3rd Edition, Sep. 2023 | | [Class/Object Engineering](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10L10-01EN.pdf) | IM 36K10L10-01EN | 4th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
| [Alarm Management Engineering](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10L15-01EN.pdf) | IM 36K10L15-01EN | 3rd Edition, Sep. 2023 | | [Alarm Management Engineering](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10L15-01EN.pdf) | IM 36K10L15-01EN | 4th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
| [History Management Engineering](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10L20-01EN.pdf) | IM 36K10L20-01EN | 3rd Edition, Sep. 2022 | | [History Management Engineering](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10L20-01EN.pdf) | IM 36K10L20-01EN | 4th Edition, Feb. 2026 | 3rd Edition, Sep. 2022 |
| [Audit Trail Management Engineering](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10L25-01EN.pdf) | IM 36K10L25-01EN | 3rd Edition, Sep. 2023 | | [Audit Trail Management Engineering](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10L25-01EN.pdf) | IM 36K10L25-01EN | 4th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
| [BUS Service Engineering](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10L30-01EN.pdf) | IM 36K10L30-01EN | 3rd Edition, Sep. 2023 | | [BUS Service Engineering](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10L30-01EN.pdf) | IM 36K10L30-01EN | 4th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
| [ITEM Service Engineering - ITH](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10L35-01EN.pdf) | IM 36K10L35-01EN | 3rd Edition, Sep. 2023 | | [ITEM Service Engineering - ITH](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10L35-01EN.pdf) | IM 36K10L35-01EN | 4th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
| [ITEM Service Engineering - ITM](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10L36-01EN.pdf) | IM 36K10L36-01EN | 3rd Edition, Sep. 2023 | | [ITEM Service Engineering - ITM](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10L36-01EN.pdf) | IM 36K10L36-01EN | 4th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
| [EQUIPMENT Service Engineering - Utilities](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10L40-01EN.pdf) | IM 36K10L40-01EN | 3rd Edition, Sep. 2023 | | [EQUIPMENT Service Engineering - Utilities](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10L40-01EN.pdf) | IM 36K10L40-01EN | 4th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
| [EQUIPMENT Service Engineering - Configuration](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10L41-01EN.pdf) | IM 36K10L41-01EN | 3rd Edition, Sep. 2023 | | [EQUIPMENT Service Engineering - Configuration](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10L41-01EN.pdf) | IM 36K10L41-01EN | 5th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
| [Data Access Engineering](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10L45-01EN.pdf) | IM 36K10L45-01EN | 3rd Edition, Sep. 2023 | | [Data Access Engineering](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10L45-01EN.pdf) | IM 36K10L45-01EN | 5th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
| [Data Set Service Engineering](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10L50-01EN.pdf) | IM 36K10L50-01EN | 3rd Edition, Sep. 2023 | | [Data Set Service Engineering](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10L50-01EN.pdf) | IM 36K10L50-01EN | 5th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
| [Exchange Tool Engineering](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10L55-01EN.pdf) | IM 36K10L55-01EN | 3rd Edition, Sep. 2023 | | [Exchange Tool Engineering](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10L55-01EN.pdf) | IM 36K10L55-01EN | 5th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
### Language ### Language
| Document | IM Number | Edition | | Document | IM Number | R1.05 edition | R1.03 edition |
|---|---|---| |---|---|---|---|
| [Class Description Language - Traditional](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10P10-01EN.pdf) | IM 36K10P10-01EN | 3rd Edition, Sep. 2023 | | [Class Description Language - Traditional](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10P10-01EN.pdf) | IM 36K10P10-01EN | 4th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
| [Class Description Language - Java](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10P11-01EN.pdf) | IM 36K10P11-01EN | 3rd Edition, Sep. 2023 | | [Class Description Language - Java](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10P11-01EN.pdf) | IM 36K10P11-01EN | 4th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
| [Report Generation Language](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10P20-01EN.pdf) | IM 36K10P20-01EN | 3rd Edition, Sep. 2023 | | [Report Generation Language](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10P20-01EN.pdf) | IM 36K10P20-01EN | 4th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
| [Data Set Service Language](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10P30-01EN.pdf) | IM 36K10P30-01EN | 3rd Edition, Sep. 2023 | | [Data Set Service Language](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10P30-01EN.pdf) | IM 36K10P30-01EN | 4th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
| [pyTOOLS Programmer's Guide](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10P40-01EN.pdf) | IM 36K10P40-01EN | 2nd Edition, Feb. 2026 | — (new in R1.04) |
### Setup ### Setup
| Document | IM Number | Edition | | Document | IM Number | R1.05 edition | R1.03 edition |
|---|---|---| |---|---|---|---|
| [CI Portal Setup](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10R10-01EN.pdf) | IM 36K10R10-01EN | 3rd Edition, Sep. 2023 | | [CI Portal Setup](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10R10-01EN.pdf) | IM 36K10R10-01EN | 5th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
| [Setup File Editor](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10R20-01EN.pdf) | IM 36K10R20-01EN | 3rd Edition, Sep. 2023 | | [Setup File Editor](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10R20-01EN.pdf) | IM 36K10R20-01EN | 4th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
| [Graphic Display Setup](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10R30-01EN.pdf) | IM 36K10R30-01EN | 3rd Edition, Sep. 2023 | | [Graphic Display Setup](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10R30-01EN.pdf) | IM 36K10R30-01EN | 4th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
| [Report Server Setup](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K10R40-01EN.pdf) | IM 36K10R40-01EN | 3rd Edition, Sep. 2023 | | [Report Server Setup](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K10R40-01EN.pdf) | IM 36K10R40-01EN | 4th Edition, Feb. 2026 | 3rd Edition, Sep. 2023 |
## Not Listed in the Map ## Not Listed in the Map
These files are in the `EN` folder but do not appear in `ciserver.pdf`: These files are in the `EN` folder but do not appear in `ciserver.pdf`:
| Document | IM Number | Edition | | Document | IM Number | R1.05 edition | R1.03 edition |
|---|---|---| |---|---|---|---|
| [CI Server Software License Agreement](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K01A20-01EN.pdf) | IM 36K01A20-01EN | 1st Edition, Jan. 2021 | | [CI Server Software License Agreement](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K01A20-01EN.pdf) | IM 36K01A20-01EN | 1st Edition, Jan. 2021 | 1st Edition, Jan. 2021 |
| [CI Server Terms and Conditions of Open Source Software](file:///C:/Users/Public/Yokogawa/tls/doc/EN/IM36K01A30-01EN.pdf) | IM 36K01A30-01EN | 2nd Edition, Mar. 2022 | | [CI Server Terms and Conditions of Open Source Software](file:///C:/Yokogawa/CIServer/tls/doc/EN/IM36K01A30-01EN.pdf) | IM 36K01A30-01EN | 5th Edition, Feb. 2026 | 2nd Edition, Mar. 2022 |

37
knowledge/progress.md
View file

@ -15,7 +15,13 @@ longer needed to repeat it.
Practice notes refer to the repo author's **development test system**, not to anything shipped Practice notes refer to the repo author's **development test system**, not to anything shipped
with this repo: with this repo:
- CI Server R1.03.00, unlicensed, on the development machine. - **R1.03 work (phases 0–13):** CI Server R1.03.00, unlicensed, on the development machine.
- **R1.05 work (from 2026-10-08):** CI Server R1.05.00, licensed, on a remote test server reached
by ssh. The server is **shared with other projects**: checks there are read-only unless the
user approves a change; no CI Server restarts; never touch other projects' records or live
plant values; check `query user` and recent audit-trail writes before a test that changes
anything; remove scratch files afterwards. Loading `CI-Eng-Sample` there needs the user's
approval first.
- **AID** (e.g. `AID.WRPS.SIM.INFLOW`) is the author's own test project on that machine. It is - **AID** (e.g. `AID.WRPS.SIM.INFLOW`) is the author's own test project on that machine. It is
not in this repo and other systems will not have it. Item names here are evidence of what not in this repo and other systems will not have it. Item names here are evidence of what
was tested, not names to use elsewhere. was tested, not names to use elsewhere.
@ -25,6 +31,35 @@ Tasks may be practiced first on AID, but everything they need is then added to t
project **CI-Eng-Sample** (`examples/CI-Eng-Sample/`) and re-tested there, so that in the end project **CI-Eng-Sample** (`examples/CI-Eng-Sample/`) and re-tested there, so that in the end
AID is not needed. AID is not needed.
## R1.05 re-check
`main` moved to R1.05 on 2026-10-08; the R1.03 state is frozen on branch `r1.03` (tag
`r1.03-final`). All the status below was reached on **R1.03**. Each skill is re-checked on
R1.05 in the order of `version-differences.md` §3. Then its front matter gets `version: R1.05`
and its row here is updated.
**R1.05 status:** not started · manual diff read · re-checked (read-only) · re-tested · done
| Skill / area | Manual changes after R1.03 | R1.05 status | Notes |
|---|---|---|---|
| `system-check` | — | re-checked (read-only) | Version, paths, service, node, time on the R1.05 test server 2026-10-08. Start/stop not repeated (shared server). |
| `installation-security` | C10, C30 (large: IT security 3.0, LAPS, upgrade merge `jupgutl`, PRM) | manual diff read | |
| `data-access` | L45, E20 (large: OPC UA methods, information model mapper, certificate expiry), L50 dataset rename | manual diff read | |
| `equipment` | L41 (IEC 61850, item status, App. 1); IEC 104/61850 drivers moved to `eqt`/`eta` | manual diff read | |
| pyTOOLS (new) | P40 new | not started | No skill yet. |
| `graphics` | C50, C60, R30 (small) | manual diff read | |
| `history-management` | C40 §4.2 (REST API, pyTOOLS) | manual diff read | |
| `portal-setup` | R10 §3.3 | manual diff read | |
| `system-management` | J10 §2.9.1, L50 | manual diff read | |
| `item-engineering` | C10 §2.2 | manual diff read | |
| `alarm-management` | none | not started | |
| `audit-trail` | none | not started | |
| `authorization` | none (new `dss_ath_grp_u0104` loader) | not started | |
| `class-object-engineering` | none | not started | |
| `high-availability` | none | not started | |
| `reporting` | none | not started | |
| `examples/CI-Eng-Sample` | — | not started | Load on the shared server only with the user's approval. |
## Manuals, in working order ## Manuals, in working order
| Phase | Manual | Title | Status | | Phase | Manual | Title | Status |

86
knowledge/version-differences.md Normal file
View file

@ -0,0 +1,86 @@
# 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, see IM 36K10C40 §4.2) | — |
| 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` | `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` |
**No content change** (only contact information or wording): C20, C30, E10, E30, J20, J40,
L10, L15, L20, L25, L30, L35, L36, L40, P10, P11, P20, P30, R20, R40. 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.
## 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.
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`.