Troubleshooting - Metasys - LIT-12013243 - M4-OASMIN-0 - M4-OASSTD-0 - Server - Open Application Server - 13.0

Open Application Server (OAS) Commissioning Guide

Brand
Metasys
Product name
Open Application Server
Document type
Commissioning Guide
Document number
LIT-12013243
Version
13.0
Revision date
2023-10-12
Product status
Active
Language
English
The following table includes general troubleshooting information.
Table 1. General Troubleshooting
Error message or scenario Solution or workaround

When attempting to command a multi-state point in the Metasys UI, you receive the following error message: The command contains values out of range, even though the values are valid.

In some instances, this error message is correct.

However, occasionally the Online Archive that exists on the engine is out of sync with the Online Archive that exists on the server Site Director. To resolve this issue, execute a Sync engine command on the engine for the equipment the point resides on.

On a unified Metasys system that is starved for resources, the ActionQueue service may not properly start at system boot. The service does run correctly if it is started after the system boot is complete. Set the ActionQueue service to a delayed start.
An unsafe assembly message appears in SQL logs. This message is an information message and is not an error message that requires action. This message is informing the SQL administrator that SQL cannot verify that the assembly is safe. However, the Metasys system uses assemblies included with Metasys databases to perform functions on input argument values and return data. The unsafe assembly message denotes that the assembly requires additional access to restricted resources; however, no user action is required.

During Metasys server installation RabbitMQ configuration fails with the message: RabbitMQ.Client.Exceptions.

BrokerUnreachableException

Use the Administrator account when installing the Metasys Server software.
RabbitMQ stops working if the hostname is changed. RabbitMQ is dependent on the hostname of the machine (OAS ) and if the hostname is changed then the following steps are required to restart RabbitMQ:
  1. Stop all services.
  2. Rename the machine.
  3. Open a Command Prompt window with the Run as Administrator option.
  4. In the Command Prompt window, change to this folder: cd C:\ProgramFiles\RabbitMQ Server\rabbitmq_server-3.7.3\sbin.
  5. Run: rabbitmq-service stop.
  6. Run: rabbitmq-service remove.
  7. Run: rabbitmq-service install.
  8. Run: rabbitmq-service start.
  9. Start the Metasys server installation again.
The Summary Definitions Library is missing
  1. In the All Items tree, right-click the Summary Definitions folder and select Import Definition. The Import dialog box appears.
  2. Browse to the location on the computer where the Summary Definitions are stored.
    Note: You can access a set of pre-built Summary Definitions through the License Portal. You can download the Summary Definitions when you download the SCT software, or as a separate download.
  3. Select one or more Summary Definitions to import.
  4. Click Import. The Notice dialog box appears, indicating the results of the import after all imports complete.
  5. Click OK. The imported Summary Definitions appear in the Summary Definitions folder in the All Items tree.