Exaquantum Setup and Troubleshooting Guide
Exaquantum Setup and Troubleshooting Guide
KB-0037-24
Document Summary
This guide covers the initial setup of Exaopc for use with
Summary
Exaquantum
Table of Contents
Table of Contents ........................................................................................... 1
Chapter 1 Introduction ...................................................................................... 3
1.1 Audience ........................................................................................................... 3
1.2 Limitations ......................................................................................................... 3
Chapter 2 Installation of Exaopc ...................................................................... 4
2.1 Security Model Selection ................................................................................... 4
2.2 Installation Steps ............................................................................................... 4
Chapter 3 Exaquantum Installation .................................................................. 5
Chapter 4 Exaopc Cassettes and Servers ....................................................... 6
4.1 Exaopc-STN ...................................................................................................... 6
4.1.1 DA Server.............................................................................................. 6
4.1.2 AE Server .............................................................................................. 6
4.1.3 HDA server ............................................................................................ 6
4.2 Exaopc-STN-CAMS........................................................................................... 6
4.2.1 DA Server.............................................................................................. 6
4.2.2 AE Server .............................................................................................. 6
4.2.3 HDA server ............................................................................................ 6
4.3 Others ................................................................................................................ 7
4.3.1 Exaopc-RD ............................................................................................ 7
4.3.2 Exaopc Batch ........................................................................................ 7
Chapter 5 Setting up DA and AE Server .......................................................... 8
5.1 Post Installation Configuration – Exaopc ........................................................... 8
5.1.1 Add Main Exaquantum User Account ................................................... 8
5.2 Post Installation Configuration – Exaquantum................................................... 9
5.2.1 Open the Exaquantum Administration Tools ......................................... 9
5.2.2 Configuration Settings for HDA ............................................................. 9
Chapter 6 Exaopc Configuration .................................................................... 10
6.1.1 Choosing the value for Point Data (item 2) ......................................... 12
6.1.2 Limitations ........................................................................................... 12
6.1.3 Making Changes to Historical Data Tab .............................................. 12
Chapter 7 Testing the Exaopc Server Function ............................................ 13
7.1 Create a Tag on the DA Client ........................................................................ 13
KB-0037-24 Exaopc for Exaquantum Setup and Troubleshooting Guide Exaopc R3.80 Issue 1.0 17th January 2024
Exaopc for Exaquantum Setup and Troubleshooting Guide Knowledge Base Article 2
7.2 Check AE events ............................................................................................. 14
7.3 Check HDA...................................................................................................... 15
7.4 Check Historical Storage of AE messages...................................................... 16
Chapter 8 Checking Exaopc Data in Exaquantum ........................................ 17
8.1 Check DA data coming into Exaquantum........................................................ 17
8.2 Check Alarm and Events ................................................................................. 19
Chapter 9 Maintenance of an Exaopc Station ............................................... 20
Chapter 10 Trouble-shooting an Exaopc Station Connection ..................... 21
10.1 No data in Exaopc Station or Exaquantum ................................................... 21
10.2 No HDA in Exaopc Station ............................................................................ 21
Chapter 11 Resetting History Collection ....................................................... 22
Chapter 12 Collecting Failure Data ................................................................ 23
12.1 Data to collect................................................................................................ 23
Chapter 13 Further Reading ........................................................................... 24
Copyright and Trademark Notices ............................................................... 25
Highlights ..................................................................................................... 26
KB-0037-24 Exaopc for Exaquantum Setup and Troubleshooting Guide Exaopc R3.80 Issue 1.0 17th January 2024
Exaopc for Exaquantum Setup and Troubleshooting Guide Knowledge Base Article 3
Chapter 1 Introduction
Exaquantum can collect process data from any OPC server that is compliant with the OPC
Specification.
The most common OPC server is Yokogawa’s Exaopc server, normally referred to as an
Exaopc Station.
This document covers:
• Basic set-up of standalone Exaopc servers for use with Exaquantum.
• Settings and use of an Exaopc Station specifically with Exaquantum. It should be
viewed as an additional resource to the documentation sets of both products.
• Connection to a single Exaopc Station. A separate document covers connecting to
an Exaopc-RD cassette.
• Standard practices although in some cases some customisation may be used.
Contact your Yokogawa support channel if your system doesn’t match the settings in
this document.
Exaquantum collects live and historical process data from OPC Servers including Exaopc.
An Exaopc server will connect to the DCS and provide data to Exaquantum. Optionally, two
Exaopc Servers can be combined to provide a redundant configuration to an Exaopc-RD
server, which in turn can make data available to Exaquantum (not covered in this
document).
1.1 Audience
This document provides useful information for engineers who are setting up an Exaopc
Station that will provide data for an Exaquantum system.
It should be read by qualified engineers who are planning to install Exaopc to be used by
Exaquantum and also by authorised persons who will maintain the Exaopc installation.
1.2 Limitations
The document does not cover the hardware installation of an Exaopc station. Also not
covered is the use of a redundant Exaopc-RD configuration. This will be covered in a
separate document.
KB-0037-24 Exaopc for Exaquantum Setup and Troubleshooting Guide Exaopc R3.80 Issue 1.0 17th January 2024
Exaopc for Exaquantum Setup and Troubleshooting Guide Knowledge Base Article 4
KB-0037-24 Exaopc for Exaquantum Setup and Troubleshooting Guide Exaopc R3.80 Issue 1.0 17th January 2024
Exaopc for Exaquantum Setup and Troubleshooting Guide Knowledge Base Article 5
KB-0037-24 Exaopc for Exaquantum Setup and Troubleshooting Guide Exaopc R3.80 Issue 1.0 17th January 2024
Exaopc for Exaquantum Setup and Troubleshooting Guide Knowledge Base Article 6
4.1 Exaopc-STN
This is the most common Exaopc cassette and is used to provide point data (DA server),
alarm and event data (AE server) and historical data (HDA server)
The cassette has sales code NTPF100-S11 (English version) and allows connection to
CENTUM VP only.
4.1.1 DA Server
The progID used for the DA server is Yokogawa.ExaopcDACS1
4.1.2 AE Server
The ProgID used for the AE server is Yokogawa.ExaopcAECS1
4.1.3 HDA server
The progID used for the HDA server is Yokogawa.ExaopcHDACS1
4.2 Exaopc-STN-CAMS
This cassette allows CAMS for HIS messages to be collected when configured on the DCS.
The DA server behaves in the same way as for Exaopc_STN but the progID for the AE and
HDA servers are different.
The cassette has sales code NTPF100-S61 (English version) and allows connection to
CENTUM VP supporting CAMS for HIS.
4.2.1 DA Server
The progID used for the DA server is Yokogawa.ExaopcDACS1
4.2.2 AE Server
The ProgID used for the AE server is Yokogawa.ExaopcAEVPCAMS1
4.2.3 HDA server
The progID used for the HDA server is Yokogawa.ExaopcHDAVPCAMS1
KB-0037-24 Exaopc for Exaquantum Setup and Troubleshooting Guide Exaopc R3.80 Issue 1.0 17th January 2024
Exaopc for Exaquantum Setup and Troubleshooting Guide Knowledge Base Article 7
4.3 Others
Some cassettes are outside the scope of this document.
4.3.1 Exaopc-RD
This cassette allows for a pair of Exaopc-STN stations to be used in a redundant
configuration.
The cassette has sales code NTPF100-SX1 (English version) and allows connection to a
pair of Exaopc-STN stations in a redundant configuration. Connection of Exaopc-RD to
Exaopc-STN_CAMS is not supported.
4.3.2 Exaopc Batch
Allows the collection of batch data from VP Batch. This has Sales code NTPF100-SB1.
KB-0037-24 Exaopc for Exaquantum Setup and Troubleshooting Guide Exaopc R3.80 Issue 1.0 17th January 2024
Exaopc for Exaquantum Setup and Troubleshooting Guide Knowledge Base Article 8
KB-0037-24 Exaopc for Exaquantum Setup and Troubleshooting Guide Exaopc R3.80 Issue 1.0 17th January 2024
Exaopc for Exaquantum Setup and Troubleshooting Guide Knowledge Base Article 9
5.2 Post Installation Configuration – Exaquantum
To collect data from the Exaopc Server, it is necessary to create an OPC Gateway within
Exaquantum. This is covered in the Exaquantum documentation but the basic steps are as
follows:
5.2.1 Open the Exaquantum Administration Tools
Navigate to the OPC Gateways Page
Create a New Gateway of Type Exaopc-STN, specifying a name, an optional description,
the host name of the Exaopc Server and optionally whether to collect alarm and event
messages. You can also choose to select automatic data recovery and recalculation. The
default settings are usually sufficient. Click the Apply button to finish the Gateway definition.
This concludes the post installation configuration steps required to allow Exaquantum to
read DA and AE data from an Exaopc server.
5.2.2 Configuration Settings for HDA
Exaquantum includes two methods for filling in gaps caused by shutdowns or network
issues. These are History Catchup which runs when Exaquantum server is started up and
Data Recovery which runs when Exaquantum server is running. Both methods require HDA
data to be available on the Exaopc Server.
To allow Exaquantum to retrieve data using history catch-up, ensure that this is enabled in
the History Catch-up screen of the Administration Tools.
KB-0037-24 Exaopc for Exaquantum Setup and Troubleshooting Guide Exaopc R3.80 Issue 1.0 17th January 2024
Exaopc for Exaquantum Setup and Troubleshooting Guide Knowledge Base Article 10
There are various fields that need to be set when configuring the HDA and these are listed
below together with recommendation on how to set the configuration:
KB-0037-24 Exaopc for Exaquantum Setup and Troubleshooting Guide Exaopc R3.80 Issue 1.0 17th January 2024
Exaopc for Exaquantum Setup and Troubleshooting Guide Knowledge Base Article 11
2 Number of Records
This is used to specify how many data points you wish to store. The setting is global across
all tags. To calculate the number that you should enter, see the section below. Set this in
conjunction with item 5.
4 Deadband
Used to specify a percentage deadband which can be used to reduce the amount of data
stored. Unfortunately, this setting is global and applies to all tags that are requested with any
deadband. It also has to be a whole number so the setting is of no use to Exaquantum.
Leave at 0.
7 Number of Records
Use to specify the number of records that you want to store, based on the throughput of
A&E on the system and the period of downtime that you wish to recover. It is quite difficult to
establish this figure. Note that this number must be higher than the number for point data (2)
or A&E cannot be recovered.
8 Permanent
This check box can be checked to prevent files being deleted once the period specified in
item 5 elapses. Deleted tags will still stop collecting data following the Extension After
Removing period but the old data will sit in the files forever. It’s difficult to think of a use for
this setting so leave it unchecked unless you can think of a reason not to.
9 Save Folder
The location of the history files. Generally, the default is ok for this.
When the settings have been entered, apply them and then reboot the Exaopc Station so
that they take effect.
KB-0037-24 Exaopc for Exaquantum Setup and Troubleshooting Guide Exaopc R3.80 Issue 1.0 17th January 2024
Exaopc for Exaquantum Setup and Troubleshooting Guide Knowledge Base Article 12
6.1.1 Choosing the value for Point Data (item 2)
To set the correct values, you need to consider how much data you might want to recover in
the worst case and you also need to know the fastest update rate of your OPC Station. Then
you can use the following calculation to establish the number that you require:
Example: If you want to keep 3 days of data and you have 1 second tags then the number
you need is (3 x 24 hours x 60 minutes x 60 seconds) / 1 second = 259200
Example 2: To keep a week of data when 1 minute is your fastest update rate, the number
you need is (7 x 24 x 60 x 60) / 60 = 10080
Important: The Extension after removing field takes priority over the Number of Records.
Therefore, in the Example 2 above, if the Extension After Removing is left at the 48 hours
default, data would stop collecting after Exaquantum had been stopped for around 2 days.
In this case, set the Extension after removing to 168.
6.1.2 Limitations
Site experience has shown that the number of records value may need to be reduced if the
Exaopc stations use a virtual environment.
It has also been found that the number of values for an Exaopc-RD system may need to be
reduced.
When determining the values in use for such configurations, it is important to remember the
main reason for the HDA mechanism which is to allow maintenance restarts of the Exaopc
stations.
The default value of 2880 can be increased but it may be necessary to experiment with
different values to find the limit of what can be successfully recovered.
All systems will be different but a value of 12,000 have been confirmed in a number of site
environments. This provides a maintenance window of 3 hours for 1 second tags, much
longer for other update rates.
6.1.3 Making Changes to Historical Data Tab
Although it should be possible to make changes to any fields to adjust the HDA settings,
there have been many occasions where this operation has not succeeded and has led to
data not being stored.
Therefore, we recommend that any changes are applied by following the Resetting
Historical Data procedure that is outlined in a later Chapter of this document.
KB-0037-24 Exaopc for Exaquantum Setup and Troubleshooting Guide Exaopc R3.80 Issue 1.0 17th January 2024
Exaopc for Exaquantum Setup and Troubleshooting Guide Knowledge Base Article 13
KB-0037-24 Exaopc for Exaquantum Setup and Troubleshooting Guide Exaopc R3.80 Issue 1.0 17th January 2024
Exaopc for Exaquantum Setup and Troubleshooting Guide Knowledge Base Article 14
7.2 Check AE events
To check the AE events are coming into the Exaopc server, use the Yokogawa AE Client. It
is called ZOPAEClient.exe and is found in the same tools folder as the DA Client, usually:
C:\EXA\exaopc\tool
To use the tool, double-click the executable from the folder location. No configuration is
required. Events should appear in the tool after a short time. The screenshot shows the tool
displaying events:
KB-0037-24 Exaopc for Exaquantum Setup and Troubleshooting Guide Exaopc R3.80 Issue 1.0 17th January 2024
Exaopc for Exaquantum Setup and Troubleshooting Guide Knowledge Base Article 15
7.3 Check HDA
Creating a tag will also start the HDA data collection process. Check this by using the
ZOCSvrInfo tool
The tool is found in the same location as the DA client tool, usually:
C:\EXA\exaopc\tool
Test HDA by the following steps:
a) Open the tool by double-clicking in the folder location
b) Expand the Historical Data Access node
c) Expand the CS1 node
d) Expand the Historical Data node
e) Expand the first Periodxxxx node, normally Period0001
f) Click on a tag in the list
g) Verify that values are present
The following screenshot illustrates the above steps:
KB-0037-24 Exaopc for Exaquantum Setup and Troubleshooting Guide Exaopc R3.80 Issue 1.0 17th January 2024
Exaopc for Exaquantum Setup and Troubleshooting Guide Knowledge Base Article 16
7.4 Check Historical Storage of AE messages.
The ZOCSvrInfo tool can also be used to check for AE by expanding the AE Node and
clicking on one of the message files as shown below:
KB-0037-24 Exaopc for Exaquantum Setup and Troubleshooting Guide Exaopc R3.80 Issue 1.0 17th January 2024
Exaopc for Exaquantum Setup and Troubleshooting Guide Knowledge Base Article 17
The following image illustrates the above steps (there are additional Templates on this
server)
KB-0037-24 Exaopc for Exaquantum Setup and Troubleshooting Guide Exaopc R3.80 Issue 1.0 17th January 2024
Exaopc for Exaquantum Setup and Troubleshooting Guide Knowledge Base Article 18
Add the tag by following these steps:
a) Open the Exaquantum Administration Tools if not already open
b) Expand the Yokogawa Exaquantum Node
c) Expand the Tag Editor Node
d) Click on the Tag Editor Page
e) Right-click on the Root node and click Add
f) Click on OPC Tag and click OK
g) Give the Tag a name such as ConnectionTest
h) Select the ConnectionTest Tag Template from the dropdown
i) Enter a valid OPC ItemID in the OPC Item ID field (these are case-sensitive)
j) Check that the correct OPC Gateway is selected in the OPC Gateway dropdown
k) Click the Apply button
After a short delay, the tag should display changing values in the Tag Information section.
This verifies that DA data can be received from the Exaopc station.
The ConnectionTest tag can be deleted or retained as a sanity check tag.
KB-0037-24 Exaopc for Exaquantum Setup and Troubleshooting Guide Exaopc R3.80 Issue 1.0 17th January 2024
Exaopc for Exaquantum Setup and Troubleshooting Guide Knowledge Base Article 19
8.2 Check Alarm and Events
To check Alarm and Events are coming through, use Exaquantum/Explorer which can be
found within the Exaquantum program group.
Follow these steps:
Open Exaquantum/Explorer from the start menu.
1. Click File and New Document to create a new document
2. Select the Updating AE Control by clicking on it in the Palette. It is called
MXQuantumEventUpdate and looks like this
3. Add the control to the document by clicking on the document and then resize it to fill
the page.
4. Click on the blue ‘play’ icon at in the ribbon
5. The document will run and events will appear after a short delay
The following image illustrates the document before the play button is pressed:
Verify that events from the Exaopc Station are shown in the control.
Note: if there are multiple OPC Gateways, take care that events from the Gateway being
tested are in the list – use the filtering on the update control (right-click, properties and OPC
Servers tab when in design mode) to remove other Gateways if needed.
If events are seen, this verifies that Alarm and event messages can be seen in Exaquantum.
KB-0037-24 Exaopc for Exaquantum Setup and Troubleshooting Guide Exaopc R3.80 Issue 1.0 17th January 2024
Exaopc for Exaquantum Setup and Troubleshooting Guide Knowledge Base Article 20
KB-0037-24 Exaopc for Exaquantum Setup and Troubleshooting Guide Exaopc R3.80 Issue 1.0 17th January 2024
Exaopc for Exaquantum Setup and Troubleshooting Guide Knowledge Base Article 21
KB-0037-24 Exaopc for Exaquantum Setup and Troubleshooting Guide Exaopc R3.80 Issue 1.0 17th January 2024
Exaopc for Exaquantum Setup and Troubleshooting Guide Knowledge Base Article 22
a) Open the Exaopc Setup Configuration Tool (Start > All Programs > Yokogawa Exa >
Exaopc Setup) and select the Historical Data Tab.
b) Set both Trend Data and Historical Event Scope of Keeping to Nothing.
c) Reboot the Exaopc Station
d) Stop the EXA bossd services
e) Navigate to the Save folder that is specified in the Configuration Tool. The default is
C:\Exa\Save .
f) Delete everything in the Save Folder
g) Open the Exaopc Setup Configuration Tool (Start > All Programs > Yokogawa Exa >
Exaopc Setup) and select the Historical Data Tab.
h) Set the required values if they need to change and set the Trend Data and Historical
Event Scope of Keeping to All.
i) Reboot the Exaopc Station
j) When it has restarted, navigate to the Save folder location and verify the folders and
sub folders have been created. The following sample screenshot is taken from a
simple configuration and gives an indication of what should be expected:
KB-0037-24 Exaopc for Exaquantum Setup and Troubleshooting Guide Exaopc R3.80 Issue 1.0 17th January 2024
Exaopc for Exaquantum Setup and Troubleshooting Guide Knowledge Base Article 23
KB-0037-24 Exaopc for Exaquantum Setup and Troubleshooting Guide Exaopc R3.80 Issue 1.0 17th January 2024
Exaopc for Exaquantum Setup and Troubleshooting Guide Knowledge Base Article 24
KB-0037-24 Exaopc for Exaquantum Setup and Troubleshooting Guide Exaopc R3.80 Issue 1.0 17th January 2024
Exaopc for Exaquantum Setup and Troubleshooting Guide Knowledge Base Article 25
▪ Trademark Acknowledgements
▪ CENTUM, ProSafe, Exaquantum, Vnet/IP, PRM, Exaopc, Exaplog, Exapilot,
Exasmoc and Exarqe are registered trademarks of Yokogawa Electric Corporation.
▪ Microsoft, Windows, Windows Server, SQL Server, Excel, Internet Explorer,
SharePoint, ActiveX, Visual Basic, Visual C++, and Visual Studio are either
registered trademarks or trademarks of Microsoft Corporation in the United States
and other countries.
▪ Adobe and Acrobat are registered trademarks of Adobe Systems Incorporated and
registered within particular jurisdictions.
▪ Ethernet is a registered trademark of XEROX Corporation.
▪ All other company and product names mentioned in this manual are trademarks or
registered trademarks of their respective companies.
▪ We do not use TM or ® mark to indicate those trademarks or registered trademarks
in this manual.
▪ We do not use logos in this manual.
KB-0037-24 Exaopc for Exaquantum Setup and Troubleshooting Guide Exaopc R3.80 Issue 1.0 17th January 2024
Exaopc for Exaquantum Setup and Troubleshooting Guide Knowledge Base Article 26
Highlights
The Highlights section gives details of the changes made since the previous issue of this
document.
▪ Summary of Changes
This is Issue 1.0 of the document related to Product Library version 1.0.
▪ Detail of Changes
The changes are as follows:
Chapter/Section/Page Change
KB-0037-24 Exaopc for Exaquantum Setup and Troubleshooting Guide Exaopc R3.80 Issue 1.0 17th January 2024