Displaying OPC Output

After you have enabled OPC server functionality on the ztC Edge system, an OPC client (on a computer that is not the ztC Edge system) can publish the system's performance data. The data is divided into address spaces, where each address space is divided into sub-objects that contain several data items. The OPC server functionality on the ztC Edge system passes values for the data items to the OPC client, which then displays the data.

This topic describes how to display ztC Edge system information using an OPC client created with UaExpert® software from Unified Automation.

To display OPC output

  1. On the computer where you have created an OPC client, open the client.

  2. In the (left) Project panel, click Project, Servers, and then ztC OPC Server.

    In the left panel beneath Project is Address Space. After you select ztC OPC Server, the Address Space panel displays the Root hierarchy.

  3. In the Address Space panel, click Objects below Root. Beneath Objects, you can select Server and ztC.

    • For information about the node that is currently running the OPC server, view the BuildInfo sub-object: click Server and then ServerStatus.

      The BuildInfo sub-object displays values for the following data items:

      Data Items Description
      ProductUrl

      Displays http://www.stratus.com/.

      ManufacturerName

      Displays Stratus Technologies Ireland, Ltd.

      ProductName

      Displays the product name of the hardware (ztC Edge).
      SoftwareVersion Displays the version number of the Stratus Redundant Linux software.
      BuildNumber

      Displays the Stratus Redundant Linux software build number.

      BuildDate

      Displays the date of the Stratus Redundant Linux software build.

      For additional information on the Server object, see Part 5: Information Model of the OPC Unified Architecture Specification, which is available at opcfoundation.org.

    • ztC—The ztC object divides the address space into the following sub-objects, with the data items listed in the each table:

      The applications data items provide information about the health of applications.

      Data Items Description
      AlertedApplicationsCount

      Lists the number of applications in AlertedApplicationsList.

      Data type: UInt32.
      AlertedApplicationsList

      Lists the applications currently monitored that have any status that is not normal or is unavailable (Not Running, Not Responding, Unavailable, and Not Found). This list includes applications with a VM that is stopped. The list does not include monitors that are not activated (that is, application monitors listed in the Applications panel of the Monitor tab without the Enabled box activated).

      Data type: dynamic array of string.

      AllApplicationsHealthy

      Indicates whether or not a monitored application has a warning: true indicates no warnings; false indicates that one or more monitored applications has a warning.

      Data type: Boolean.
      ApplicationMonitoringEnabled

      Indicates whether application monitoring is licensed and turned on: true indicates that it is turned on; false indicates that it is not turned on.

      Data type: Boolean.
      ApplicationsCount

      Indicates the number of applications currently monitored . Its value should equal the number of applications in ApplicationsList.

      Data type: UInt32.
      ApplicationsList

      Lists the applications currently monitored. It is a one-dimensional array that increases or decreases as monitored applications are added or removed. The list does not include monitors that are not activated (that is, application monitors listed in the Applications panel of the Monitor tab without the Enabled box activated). Names listed include the VM name as a prefix to the application name (for example, vm1/testapp.exe).

      Data type: dynamic array of string.

      The data items for physical machines provide information about whether or not individual nodes in a system are healthy.

      Data Items Description
      AllPhysicalMachinesHealthy

      Indicates whether both nodes are healthy: true indicates both nodes are present, running green-checked, and neither is in maintenance mode; false indicates that one node (or both nodes) is not present, is not running green-checked, and/or is in maintenance mode.

      Data type: Boolean.
      Node0 and Node1

       

      NodenHostState: the host state. Valid values include exiled, failed, firmware, imaging, lost, nfc, off, proto, running, starting, stopping, unlicensed, and unreachable.
      NodenIPaddress: the node IP address.

      NodenMaintenanceMode: the host maintenance mode. Valid values include evacuating, maintenance , and normal.

      NodenExists: indicates whether or not the node is known to the system, where true indicates the node successfully joined the system; false indicates that a second node was not added to the system, or that a second node was added and was later removed. If the value is false, ignore all other noden information.
      NodenVirtualMachineList: lists the virtual machines (VMs) running on this node.

      NodenCombinedState: indicates a combination of NodenMaintenanceMode, NodenExists, and NodenHostState, as follows:

      • NodenCombinedState is missing when NodenExists is false.

      • NodenCombinedState is either evacuating or maintenance when NodenExists is true, NodenHostState is running, and NodenMaintenanceMode is evacuating or maintenance.

      • When NodenCombinedState is any other value, it indicates the value of NodenHostState, with the range of NodenHostState values listed above.
      PhysicalMachinesList

      Lists nodes that are present.

      Data type: dynamic array of string.

      PhysicalMachinesWarningCount

      Lists the number of physical machines that are not green-checked.

      Data type: UInt32.

      PhysicalMachinesWarningList

      Lists physical machines that are reporting problems. The list typically includes both nodes; for example, when the secondary is in maintenance mode, the primary is marked unsafe to pull.

      Data type: dynamic array of string.

      PrimaryPhysicalMachine

      Displays the name of the current primary node.

      Data type: string.

      The data items for virtual machines provide information about the status of VMs running on the system.

      Data Items Description
      AllVirtualMachinesHealthy

      Indicates whether any VM has a warning or failure status: true indicates all VMs are green-checked; false indicates that one or more VMs is not running green-checked.

      Data type: Boolean.
      FTVirtualMachinesList

      Displays the names of FT VMs present on the system.

      Data type: dynamic array of string.

      GetPhysicalMachine

      Indicates which physical machine is running the specified VM.

      Data type: function that takes one string and returns one string (the input argument of the function is a string that is a VM name, and the output is a string (node0 or node1) indicating the physical machine that is currently running the VM named in the input argument).
      HAVirtualMachinesList

      Displays the names of HA VMs present on the system.

      Data type: dynamic array of string.

      RunningVirtualMachinesCount

      Lists the number of VMs in RunningVirtualMachinesList.

      Data type: UInt32.

      RunningVirtualMachinesList

      Lists the names of VMs marked as running.

      Data type: dynamic array of string.

      StoppedVirtualMachinesCount

      Lists the number of VMs in StoppedVirtualMachinesList.

      Data type: UInt32.

      StoppedVirtualMachinesList

      Lists the names of VMs marked as stopped (ignores transition states such as booting).

      Data type: dynamic array of string.

      VirtualMachinesCount

      Lists the number of VMs present on the system.

      Data type: UInt32.

      VirtualMachinesList

      Lists the names of VMs present on the system.

      Data type: dynamic array of string.

      The data items for the system provide high-level status information as well as information about access methods for the overall system.

      Data Items Description
      ManagementConnectionGood

      Indicates whether the OPC server can retrieve information from the ztC Edge system: true indicates that the server can retrieve information from the system; false indicates that the server cannot retrieve information.

      Data type: Boolean.
      ManagementIP

      Indicates the system IP address of the ztC Edge system.

      Data type: string.

      ManagementURL

      Indicates the HTTP URL of the ztC Edge Console.

      Data type: string.

      OutstandingSeverity

      Corresponds to the overall system status icon on the login page.

      Data type: string.
      SecureManagementURL

      Indicates the HTTPS URL for the ztC Edge Console.

      Data type: string.

Related Topics

Configuring OPC Settings