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>
12 KiB
12 KiB
| 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
.NAMEand 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/pkimanually 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()(neverDss.createSession()orDssContext.getSession()), must never close it, and must be recompiled and reset after the change. Otherwise results are undefined (e.g.ADT-E-ECL_UNKNOWNin the system log). - When making items with SIGNALs, handle root-level items: if
SECTIONis empty use the tag alone, elseSECTION || "." || 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.
jwuiutlover 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
.jnlpover HTTPS is caused by the self-signed web server certificate. Fix with a CA/domain-issued certificate (preferred) or addhttps://localhost:8443to 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/CISystemEventTypenodes 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
dssqldon datasetEXTERNAL_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, ordssqldon the Core/Portal. - Acknowledging external alarms over ODBC: filter on
NAMEinALARM_CURRENT(e.g.UPDATE ALARM_CURRENT SET ACK = 1 WHERE NAME = '<time>/<id>'), notITEM_NAME/ALARM_ORIG_TIME.
CI Exchange tools (1.17, 1.18)
- CENTUM VP and Prodigy tools use
jwuiutl; over RDP, first allow it indssana.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.cmdfails withUnicodeEncodeError). Unknown encoding 'ms932'fromLoad.cmd: in the publish folder runchcp 1252, thenload.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.