ci-server-engineer/knowledge/manuals/IM36K01A50-01EN.md
cliu 070e578129 Add phase 0-1 knowledge and system skills
Summarize the Release Information (known issues) and System
Design/Management manuals, add the system-check and system-management
skills practiced on the R1.03 test system, and add the progress tracker,
issue register and a CI-Eng-Sample placeholder. CLAUDE.md now requires a
version check, asks once per conversation whether to work directly or
prepare files only, and treats the manuals as development-only.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 13:07:37 +10:00

12 KiB
Raw Blame History

manual title edition version status
IM 36K01A50-01EN CI Server Release Information 3rd Edition, Sep. 2023 R1.03 from docs

Release Information: known issues and cautions (R1.03)

Known limitations and workarounds that the other manuals do not cover. Check this list before recommending a workflow in any area. Section numbers refer to the manual.

Platform and installation

Area Issue What to do
Dual-redundant platform (1.1) Without a Vnet/IP card, guest time sync by NTP makes host messages in the historical alarm overview show wrong timestamps. Accept, or use Vnet/IP time sync.
Dual-redundant platform (1.1) After both computers restart, the former standby may come up as Guest OS (Isolated). In the Redundancy Management Tool set Next Status to Standby, then restart that computer.
IT Security tool (1.3) Remote Desktop to the CI Server may fail after applying IT Security if OS patch levels differ. Patch both the server and the RDP client to the latest level.
IT Security tool (1.3) Changing Windows region/language after applying IT Security causes problems. Set region and language before applying IT Security; never change afterwards.
Windows (1.4) Windows Server 2016 start menu may not refresh after install. Restart after installing CI Server.
Windows (1.4) CI Server started from the command line on Win10 / Server 2016 needs elevation. Always use Run as administrator.
Windows (1.4) Custom fonts can cause visual glitches in the Engineering and Edit modules. Avoid custom fonts.
Install path (1.9) The MELSEC EZSocket installer fails if CI Server is in a non-default path that contains spaces. Non-default install paths must have no spaces.
Virtual machines (1.19) Live migration, failover and shared-storage path switching lose acquired data/alarms; failover during engineering can corrupt the engineering data. Migrate only when no engineering is in progress; keep engineering backups.
Virtual machines (1.19) Serial-only drivers (Siemens 3964R, telemetry integration), Siemens SAPI-S7 and MELSEC are unavailable on VMs; many other drivers work over TCP/IP only. Check driver support before choosing a VM.
Virtual machines (1.19) Do not use VM replication; do not mix physical and virtual machines in HAC; only thin clients may RDP into a virtual CI Server. Design accordingly.
Virtual machines (1.19) The software medium must be mounted as an ISO on the VM (e.g. via Hyper-V Manager › Media › DVD Drive › Insert Disk). Read "DVD drive" in the manuals as the mounted ISO drive.

Services

ACCESS (1.5)

  • OPC classic on Win10 / Server 2016 / 2019 needs .NET 3.5. Install it from the Windows medium (DISM /Online /Enable-Feature /FeatureName:NetFx3 /All /LimitAccess /Source:<drive>:\sources\sxs), then re-run the OPC Core Components Redistributable in %TLS_EXE_PATH%.
  • OPC AE: items in the tree root (no section) appear as .NAME and some clients can't use them as alarm sources. Put alarm-source items inside a section.

ALARM (1.6)

  • Shelving cannot restrict OPC AE items by status/type.
  • Shelving more than 500 alarms can overflow the DURM queue; after a Portal–Core link loss, restart the shelf overview.

BUS (1.7)

  • Secure MDUR on Linux: create /tls/pki manually before configuring the secure connection.

DATABASE (1.8)

  • With Active Directory login, up to ~15 s may pass between the login form closing and the application appearing. Expected behavior.

EQUIPMENT (1.9)

  • MELSEC iQ-R needs Mitsubishi EZSocket 4.4: uninstall older EZSocket first, then run RunInstaller (as administrator) from %TLS_ROOT_PATH%\tls\exe\EZSocketPcRedistributableInstaller.
  • IEC 61850: add the line, then the station (General tab: device IP; Options tab: domain prefix and report object), then points. The element address is <domain prefix><rest>; the point I/O address is only the part after the prefix (the prefix is added automatically). Wrong delimiting means no reports/elements are created.

PROCESS (1.10)

  • Java classes that access datasets must get the DSS session with getDssSession() (never Dss.createSession() or DssContext.getSession()), must never close it, and must be recompiled and reset after the change. Otherwise results are undefined (e.g. ADT-E-ECL_UNKNOWN in the system log).
  • When making items with SIGNALs, handle root-level items: if SECTION is empty use the tag alone, else SECTION || "." || tag. Prefer automatic naming.
  • Section-based SIGNAL creation does not support process area definitions.

REPORT (1.11)

  • AD + printer management can make report generation fail (looks for the user's default printer). Workaround: create a printer destination not bound to a device and set it as the default destination in the AD user profile.
  • Report features of Schemes take effect only after restarting the Engineering module.

USER (1.12)

  • Remote Connect is for client machines without CI Server; don't install it on a CI Server.
  • HTML5 displays cannot be validated via Remote Connect; engineer them on a CI Portal.
  • HTML5 is a lightweight/mobile HMI with fewer components than Java displays (details in Edit Module, IM 36K10C50). Use Google Chrome; other browsers may render differently.
  • SSO leaves a landing page open that the user must close. SSO needs Active Directory, so Windows only.
  • jwuiutl over Remote Desktop is denied by default. To allow it: Setup File Editor › dssana.sup › Login Control tab › row Client system name <remote>, Display and Symbol Utility › Login method = No › restart CI Server. Needed by CI Exchange (CENTUM VP / Prodigy) load and conversion scripts.
  • Remote Connect operator interface may fail to start (Java network read issue): retry, or clear the Java cache (Java Control Panel › Temporary Internet files › Delete files).
  • Auto-login is for server / CI Portal applications only, not Remote Connect.
  • "Application blocked" for .jnlp over HTTPS is caused by the self-signed web server certificate. Fix with a CA/domain-issued certificate (preferred) or add https://localhost:8443 to trusted sites (less safe).
  • Web HMI display names are case sensitive.
  • Custom Java components must be signed by Yokogawa before use.
  • Edit module quirks: item properties editor Value field font too small; Update item/parameter on the Attributes sheet ignores the first change (repeat it or use the Actions sheet); a symbol custom property must not reuse an existing property name; choosing Open display in an event's Action combo adds a duplicate event (delete it); function components must stay inside the drawing area and must not be grouped.
  • Same-size labels may render at slightly different sizes (Java anti-aliasing). Use Apply text smoothing in the CI Portal setup file, or a non-integer zoom such as 99.999 %.
  • HTML5 limitations: no login name in the status bar; frame border styles map imperfectly; Windows display scaling must be 100 %; no rotation or column filters on alarm overview / shelved alarm overview; transparency and margin properties are ignored.

HMI, GIS and OPC UA

HMI general (1.13)

  • Date/Time field with editable or disable set shows a black foreground in the operator interface (correct in HTML).
  • Up/down buttons differ in size between operator interface and HTML.
  • With Fit display, tooltips and selection dialogs of trend / alarm overview are misplaced. Uncheck Zoom enabled on those components, or design displays at the target resolution.

GIS (1.14)

  • Click info is not shown for symbols built with a data bar. Use simple symbols as map markers.
  • Don't use symbols containing alarm overview, trend or report components in GIS (high memory in Chrome; alarm overview filters don't receive item names).
  • Symbols/map layer may disappear or draw behind the map after long runs (Ctrl+wheel zoom restores). In Chrome, disabling hardware acceleration fixes symbols drawn behind the map.

OPC UA (1.15)

  • PubSub upload fails with Internal error if a published dataset has zero items. Remove or revert those datasets.
  • The datatype combo in PubSub Reader item mapping has no effect.
  • Variables/properties of CIAlarmConditionType / CISystemEventType nodes can't be read (BadNotReadable) or subscribed individually (BadNotSupported); subscribe to the alarm event.
  • CI Core memory for external OPC UA clients: under 20,000 items no extra memory; 20,000–99,999 add 8 GB; 100,000–199,999 add 16 GB; beyond that add 8 GB per extra 100,000.

Server Core / Portal (1.16)

  • Secure DURM with an invalid certificate common name continues unencrypted (only logged). After installing/refreshing certificates, check the message log that they were accepted.
  • Remote Connect Engineering module is slow against a redundant CI Core. Use RDP to the Core, or temporarily run the redundant platform in single mode.
  • Several MQTT stations on one MQTT line with brokers unavailable can time out during offline engineering. Use one station per line, or a temporary local broker.
  • GIS component properties Apply increases Edit module memory each time; close the dialog and display to recover.
  • Object Selection dialog can hang the Edit module when a section has many objects (DSSSDA at high CPU). Type the object name directly; to recover, stop that DSSSDA instance in Performance Monitor, close the Edit module, restart CI Server.
  • Enterprise Edit Module: shelved alarm overview shows nothing if added before the alarm overview, on another layer, or with different alarm source locations. Add the alarm overview first, same layer, same source locations.
  • Alarm overview CI attributes: changing checkboxes on the Attributes tab can reorder the Columns tab. Workaround: Uncheck all › Apply › re-check › Apply › reorder on Columns › Apply.
  • Engineering module CI attribute names: pick Add new record or an existing name from the drop-down; cancel the Add new CI attribute dialog if it appears unexpectedly.
  • OPC UA alarm event type filters and alarm template settings that are in use can't be deleted, and a same-named one on another station also becomes undeletable. Use unique names per station; to recover, copy under a new name, repoint, then delete.
  • EALs can't be edited in bulk in the Engineering module. Use dssqld on dataset EXTERNAL_ALARM_DF.
  • Retrieve from archive does not restore alarm attribute databases (alarms visible, attributes not).
  • ODBC writes: Microsoft Access can't write to R1.03.00+; SQL Server Management Studio and Excel via ODBC can't either. PowerShell and custom applications can (ODBC DSN CiSimbaClient, e.g. UPDATE ITEM_VAL SET ITEM_VALUE_STR=..., STATUS_NUMBER=... WHERE NAME=...). Alternatives: Excel Add-in, or dssqld on the Core/Portal.
  • Acknowledging external alarms over ODBC: filter on NAME in ALARM_CURRENT (e.g. UPDATE ALARM_CURRENT SET ACK = 1 WHERE NAME = '<time>/<id>'), not ITEM_NAME / ALARM_ORIG_TIME.

CI Exchange tools (1.17, 1.18)

  • CENTUM VP and Prodigy tools use jwuiutl; over RDP, first allow it in dssana.sup (see USER).
  • HTML5 conversion warnings about graphics outside the viewing area are harmless; move Generic / JavaScript function components into view and reconvert to silence them.
  • Illegal reflective access Java warnings during load are harmless.
  • Folders must not contain Japanese characters (project, CI Exchange project and publish folders; Load.cmd fails with UnicodeEncodeError).
  • Unknown encoding 'ms932' from Load.cmd: in the publish folder run chcp 1252, then load.cmd.
  • Loading a publication overwrites VNET station settings (on scan, recover 10 s, slow 5 s, medium 3 s, fast 1 s) and line device (/dev/bk00). Correct them manually afterwards.
  • RGS with EAL: if both Vnet/IP buses to an FCS are cut, faceplates don't show OFFLINE and keep old values. Set the alarm status manually, or map the Vnet communication status to an item.
  • Unsupported controllers (e.g. GSGW, APCS) get stations created but no data. Exclude them in the Import Wizard (RGS with EAL), or filter in the Publish Wizard, e.g. TYPE LIKE '%%' AND STATION <> 'FCS0256' AND STATION <> 'FCS0258'; otherwise delete the stations in the Engineering module.
  • Tuning panel SUM is shown even when CENTUM integration is disabled. To reset to 0: disable integration in CENTUM, then set SUM to 0 on the CI tuning panel.
  • RGS collecting CENTUM alarms: 30 or more controllers needs +8 GB memory.