18 KiB
18 KiB
Progress
Status of each manual and each practiced task. Update this file as work proceeds.
Manual status: not started · summarized · in practice · done Task status: not practiced · practiced, awaiting confirmation · passed · not completed (see notes) Sample column: whether the task has been re-tested on CI-Eng-Sample: n/a (needs no project data) · pending (tested on AID only) · added (sample content built) · passed
A task is done only when Status is passed and Sample is passed or n/a. Then AID is no longer needed to repeat it.
Test system
Practice notes refer to the repo author's development test system, not to anything shipped with this repo:
- CI Server R1.03.00, unlicensed, on the development machine.
- 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 was tested, not names to use elsewhere. - Communication stations seen there (
WRPS_PLC,MODSIM_STATION,STN_MQTT) belong to AID.
Tasks may be practiced first on AID, but everything they need is then added to the sample
project CI-Eng-Sample (examples/CI-Eng-Sample/) and re-tested there, so that in the end
AID is not needed.
Manuals, in working order
| Phase | Manual | Title | Status |
|---|---|---|---|
| 0 | IM 36K01A50 | Release Information | summarized (notes) |
| 1 | IM 36K10J10 | System Design/Management | done except migration (not practiced; needs a second system) and debugging tools; skill system-management (notes) |
| 2 | IM 36K01C10 | CI Server Setup | summarized (notes); skill installation-security |
| 2 | IM 36K01C30 | Security Guide | summarized (notes); skill installation-security |
| 3 | IM 36K10G10 | Tutorial | summarized (notes); command-line equivalents practiced on CI-Eng-Sample |
| 4 | IM 36K10R10 | CI Portal Setup | done except separate CI Portal node (needs a second node); skill portal-setup (notes) |
| 4 | IM 36K10R20 | Setup File Editor | done; Templates tab and Undo Field not explored (notes, ISS-016) |
| 5 | IM 36K10C10 | Engineering Module - I/O Processes | summarized (notes); default datasets checked read-only |
| 5 | IM 36K10L40 | EQUIPMENT Service - Utilities | summarized (notes); eqpdbg main info run read-only |
| 5 | IM 36K10L41 | EQUIPMENT Service - Configuration | summarized (notes); general + Modbus in detail, other drivers as a table |
| 5 | IM 36K10L35 | ITEM Service - ITH | summarized (notes); installed processes and setup files checked |
| 5 | IM 36K10L36 | ITEM Service - ITM | summarized (notes); itmdbg statistics run; itmval -f crashes (ISS-022) |
| 6 | IM 36K10L10 | Class/Object Engineering | done; opc.sup read-only, opcdbg read-only actions and Reset class practiced (notes); skill class-object-engineering |
| 6 | IM 36K10P10 | Class Description Language - Traditional | done for prompts, signals, created items, transitional operators, PRINT/ERROR; timers, alarms, containment, STEP, DSS routines, AGA from docs (notes) |
| 6 | IM 36K10P11 | Class Description Language - Java | done for a basic class (attach/create items, signal trigger, systemMessage); timers, containment, inheritance from docs (notes) |
| 7 | IM 36K10L55 | Exchange Tool Engineering | summarized, from docs only (needs CENTUM VP / RGS or Prodigy) (notes) |
| 7 | IM 36K10L30 | BUS Service | done for single-node checks; MDUR, encryption, logical addresses, printer devices from docs (notes); task system-management/bus-utilities.md |
| 7 | IM 36K10L45 | Data Access Engineering | done for OPC UA client/server (loopback); OPC DA/A&E from docs (DA loopback not allowed); ODBC not running (ISS-008) (notes); skill data-access |
| 7 | IM 36K10E20 | OPC Interface | summarized; OPC UA point form compared with quick load by the user (notes) |
| 8 | IM 36K10L15 | Alarm Management Engineering | not started |
| 8 | IM 36K10C20 | Engineering Module - Alarms | not started |
| 8 | IM 36K10E30 | Alarm System Performance Analysis | not started |
| 9 | IM 36K10L20 | History Management Engineering | not started |
| 9 | IM 36K10C40 | Engineering Module - Historical | not started |
| 10 | IM 36K10R30 | Graphic Display Setup | not started |
| 10 | IM 36K10C50 | Edit Module | not started |
| 10 | IM 36K10C60 | Advanced Operating Graphics | not started |
| 11 | IM 36K10L50 | Data Set Service Engineering | not started |
| 11 | IM 36K10P30 | Data Set Service Language | not started |
| 11 | IM 36K10P20 | Report Generation Language | not started |
| 11 | IM 36K10R40 | Report Server Setup | not started |
| 11 | IM 36K10C30 | Engineering Module - Reporting | not started |
| 11 | IM 36K10E10 | Excel Add-in | not started |
| 12 | IM 36K10L25 | Audit Trail Management | not started |
| 13 | IM 36K10J20 | High Availability Computing | not started (needs two servers) |
| 13 | IM 36K10J40 | Active Directory Integration | not started (needs a domain) |
| — | IM 36K01A10 / A20 / A30 | Read Me First, License, OSS terms | skipped (no engineering content) |
Order change after reading IM 36K10J10: its migration procedure (§5.6) shows the dependency chain communication lines/stations/points → installations/units → items (template items first) → storage groups → classes → objects → reports. So acquisition and items (phase 5) now come before classes and objects (phase 6), and the other interfaces follow as phase 7.
Tasks
| Manual | Task | Status | Sample | Notes |
|---|---|---|---|---|
| J10 | System check: version, paths, running state, time sync (skill) | passed | n/a | Started CI Service elevated; live version R1.03.00; node UNLICENCED (expected). |
| J10 | Time sync check (w32tm); DURUTL configuration (durutl.sup) |
passed (check); configuration not practiced | n/a | w32tm check verified in system-check. durutl.sup has no active settings (single node, not a time master); configuring DURUTL needs a second node, so not practiced. |
| J10 | Export a dataset with dssqld (task) |
passed | n/a | Filtered export (@SELECT) passed (ISS-003, closed). |
| J10 | Import and delete dataset records with dssqld (-i, -r) (task) |
passed | passed | Built CI-Eng-Sample: 3 sections + 4 items imported, removed and re-imported with 0 errors. 2026-09-30 later: -m (update, used to set a storage group stop time) and loading/removing storage groups passed; see ISS-005. |
| J10 | Read an item with itmval -g (task) |
passed | passed | Read AID.WRPS.* items. -a 1..5 gave ITM-E-WRONG_ATT on an item without limits; works on items with limits (ISS-004, closed). |
| J10 | Write an item with itmval -p (task) |
passed | passed | Sample: TANK1.INFLOW 120.5 then 130 with -s 9, PUMP1.RUNNING 1 (status 5 BOOLEAN 1); no uoff flag. AID: AID.WRPS.SIM.INFLOW 419.76 → 400 → 419.76. After the first write the item's options gained the uoff flag (0x8a → 0x8e) = updated offline, option bit 4 (written while its station was offline). See ISS-001, closed. |
| J10 | Read the message log (tls\log\umhlog.log) |
passed | n/a | |
| J10 | Per-component version list (tls\lst\tls_versions.lst) |
passed | n/a | |
| J10 | Load history from CSV with ithloahis; read history back with dssqld (task) |
passed | passed | Sample storage group CIENG_EVENT (Event/Item). SCAN file (LEVEL 61–63, INFLOW 101–103) and EVENT file (LEVEL 47, 48) stored and read back via ITEM_HISTORY. New groups need a CI Server restart before they store; samples dated before the current storage unit were not stored (ISS-006). |
| J10 | Consistency check (dsschk, ismchk) (task) |
passed (check); repair and ismchk not practiced |
n/a | dsschk -e -v (check only) reports each of 228 datasets, no problems. Plain dsschk prints nothing on a single node. ismchk needs a database file name; not run (ISS-002, closed). |
| J10 | Monitoring processes (intmon, intcpumon, intdskmon, inttcpmon, intspawn) (task) |
passed | passed | All five worked into CI-Eng-Sample.SYSTEM.* / PUMP1.MODE, started by hand with <exe> -n <name>; setup files restored afterwards. intdskmon reports used %; intspawn command path must be short (ISS-007). |
| J10 | Backup of tls folders |
not practiced | n/a | Plan only; the actual backup tool is site-specific. |
| J10 | Migration between systems (§5.6) | not practiced | added | After phase 6 CI-Eng-Sample has every data kind in the chain up to classes/objects (items, points, storage groups, classes, objects). Export with dssqld -e works; the import into a second system is not practiced (no second system). |
| J10 | Tuning checks (read-only) (task) | passed | n/a | Read dur.sup (max processes 250), itm.sup (item pool 650,000 KB) and the automatic health snapshots tls\log\smd_*.log (common memory free, queue use per process, lock collisions). Debug launchers and interactive debuggers not practiced. |
| C10/C30 | Setup check script tools/setup_check.ps1 (task) |
passed | n/a | Read-only; 16 OK / 5 CHECK / 15 DIFF on the Win10 Pro test PC (kept as dev PC by decision). |
| C10 | Read ci_start.log and web ports (jwuiisg.sup) |
passed | n/a | All services started; SSL error ISS-008. |
| C10 | Start / stop CI Server | passed (phase 1) | n/a | Via the CI Service (elevated). Start-menu shortcuts not used. |
| C10 | New install, reinstall, upgrade, uninstall, licence | not practiced | n/a | Would reinstall or change the test system; only the installed R1.03 is available. Skipped. |
| C10 | Windows settings changes (power, virtual memory, Defender, updates, …) | not practiced | n/a | Test PC kept as a development PC (user decision 2026-09-30); not applied. |
| C10 | Vnet/IP drivers / Vnet/IP Interface Package | not practiced | n/a | No Vnet/IP card; not supported on Windows 10 Pro. |
| C30 | IT Security Tool, Domain Link Management, account utilities | not practiced | n/a | Not installed and not supported on Windows 10 Pro. |
| G10 | Sub-items: Integrator, Min-Max (SUB_ITEM_DF) (task) |
passed | passed | Integrator adds value × seconds; TIME_UNIT ignored. |
| G10 | Block / unblock an item (ITEM_DF.BLOCKED via dssqld -m); write with itmval -o (task) |
passed | passed | blk flag, writes without -o silently ignored; ublk (updated blocked) after unblock (ISS-001, closed). |
| G10 | Trigger group, class (compile on load), object via quick load (task) | passed | passed | DEMO.COUNTER counts every second; full remove/load cycle clean. Phase 6: three classes and objects in one remove/load cycle, 0 errors. A class that fails to compile is not inserted (DSI-E-OPCCOMERR); error lines appear in LISTING after insert with COMPILE 0 and a compile update (test class removed). |
| P10/L10 | Traditional class with prompt/attribute, signal from SECTION, item created from a template, ERROR check, >=:, PRINT; attribute change via OBJECT_ATTR_VAL (task) |
passed | passed | CIENG_TANK / TANK1.CALC: volume 50→100, 82→164; capacity 0 refused; capacity 200→400 took effect on next run; created item and section deleted with the object. % in PRINT cuts the message (ISS-025). |
| P11 | Java class (task) | passed | passed | CIENG_JFLOW / TANK1.JFLOW: inflow 120→2, 90→1.5, systemMessage in umhlog.log from OPCJEXE. Created item keeps the identifier's case (…JFLOW.sPerMin). Worked without a class reset (ISS-029). |
| L10 | Change a class with objects: compile + reset (task) | passed | passed | Old code runs until reset (RESET_REQUIRED 1). opcdbg Reset class works (extra prompt for a report file); dssqld CLASS_DF.RESET does nothing, OBJECT_DF.RESET refused (ISS-028). |
| L10 | opcdbg read-only checks (task) |
passed | passed | Database check (one never-compiled foreign class SINUS), get class/object, object status/signals/attributes, executor main info. Dumps are not dssqld-readable (ISS-027). |
| G10/C10 | Authorization group and user creation (task) | passed | passed | Group CIENG_VIEWER (sample file 08_auth_group_df.qli) loaded/removed by Claude; test user CIENG_TEST (no password) loaded by the user, checked and removed. The sample creates no users. |
| C10 | String items: length 1–200, holds length − 1 characters (task) | passed | passed | Tested with temporary CI-Eng-Sample.DEMO.STR* items (removed): 201 rejected; too-long writes cut, status 12 OVERRANGED (ISS-019). |
| C10 | Integrator time unit: integration granule itm_int_secs in itm.sup (task) |
passed | passed | 60 → RUN_SECONDS +1 per minute; restored to 1 (file identical to backup), +1 per second again (ISS-010). Elevated restarts run by the user. |
| G10 | Displays, symbols, Operator Interface test | not practiced | pending | GUI (Edit Module); phase 10. |
| L41/C10 | Modbus TCP line, station, scan type, points, connected items by quick load (task) | passed | passed | Loopback to CI Server's own Modbus slave (eqpmdcmem + eqpmdcslvtcp on 5020, started by hand). Line load created and started EQPCIENG; removal stopped it and deleted its files. Write/read-back, off-scan/on-scan checked; full remove/reload from sample files. Protocol must be Open Modbus/TCP (ISS-024). Mirror start files copied to tls\com by the user; after a restart everything came back under the CI Service and the setpoint was re-sent on connect. |
| G10 | Alarms, reports, audit, RDBMS, history | not practiced | pending | Covered in their own phases (7–12). |
| R10/R20 | Read a setup file: active settings and keyword help (task) | passed | n/a | Read-only. Compared with the Setup File Editor GUI for wfla_display.sup, wflgdi.sup and all 9 tabs of jwuiisg.sup: fields and values identical. Manual differences logged as ISS-012 to ISS-017 (installed software taken as the reference). |
| R10 | Check web access for CI View: ports, Remote Connect page, DEPLOY folder (task) |
passed | n/a | 8080/8443 listening, page 200, six DEPLOY folders. |
| R10/R20 | Change a setup file safely (task) | passed | n/a | jwuiisg.sup HTTP port 8080 → 8081 (text edit, elevated restart): 8081 served the page, 8080 refused; restored, hash identical to backup. Editor: OK writes at once, Reset Field restores the default (ISS-016). |
| R10 | Separate CI Portal node (licence, DURM line, dur.sup host node, copy displays) |
not practiced | n/a | Needs a second node. |
| R10 | Login method / login control | not practiced | n/a | Moved to dssana.sup (ISS-017); phase 5 (C10) and 13 (J40). |
| L45/E20 | OPC UA client → own OPC UA server loopback by quick load; certificate exchange; node IDs (task) | passed | passed | Station CIENG_UA (opc.tcp://localhost:34493, Basic256Sha256/SignAndEncrypt): UA.LEVEL_COPY follows TANK1.LEVEL (55, 62.5, 71, 33, 44.4), UA.SRV_STATE 0. Certificates trusted by the user (client side, then server side). Entity namespace urn:Yokogawa:CI_SERVER_OPC_UA_SERVER found by browsing OPCUAC_TAG_DF (ISS-032). Full remove/reload clean, reconnects without a new exchange. User configured a point in the Engineering Module: browse stores the item object, value node must be typed (ISS-033); test item/point removed afterwards. |
| L45 | ACCESS read-only checks: processes, ports, OPC UA server config/PKI, ODBC server (task) | passed | n/a | ISS-008 cause found: odbsrv cannot load its SSL certificate (folder tls\pki\odbsrv missing) and exits. |
| L30 | BUS utilities: durwfp, setup files (dur.sup, durm_1_udp.sup, time_table.sup, fmfprt.sup) (task) |
passed (read-only) | n/a | umhman, umhtestprog, umhmsg fail (ISS-030). Unlicensed run-time limit hit and documented (ISS-031). |
| L30 | MDUR node links, encryption, logical addresses, printer devices | not practiced | n/a | Single node, no printer devices. |
| L55 | CI Exchange for CENTUM VP / Prodigy | not practiced | n/a | Needs CENTUM VP (RGS, Vnet/IP) or Prodigy data. |