Open topic with navigation

Modify the File Meridium.AMQP.service.exe.config

Steps

  1. On your GE Digital APM Server, navigate to the folder where the Meridium.AMQP.service.exe.config is installed. If you installed the software in the default location, you can locate this file in the following location: C:\Program Files\Meridium\Services.
  2. Open the file Meridium.AMQP.service.exe.config in an application that you can use to modify XML script (e.g., Notepad).
  3. Within the <apmMqConnections> tags, uncomment the example connection tag by deleting <!--EXAMPLE: and the corresponding --> from the beginning and end of the string.

  4. Within the <apmMqConnections> tags, configure the attributes, by replacing the values within the quotation marks with the values detailed in the following chart.

    Note: The heartbeat attributes should not be edited.

    Attribute

    Replace text...

    ... with the following values:

    		Notes

    server key

    KEY

    A unique connection key.

    		 If there are multiple server entries containing the same key in the configuration file, the last defined server entry is used and all others with the same key are removed when the service starts.

    host

    ENTER_BROKER_HOSTNAME

    The host name of the GE Fleet Message Broker.

    		 If there are multiple server entries containing the same host name in the configuration file, the last defined server entry is used and the other host names with the same key will be logged as errors in the service log file.
    port 5672

    The appropriate port for your configuration.

    • The default SSL port is 5671.
    • The default HTTP port is 5672, and is the port preconfigured in the config file.
    		None

    user

    ENTER_MQ_USER_NAME

    The user name for the RabbitMQ Message Broker.

    		 This field is not required if using SSL to connect to the message broker.

    password

    ENTER_MQ_PASSWORD

    The password for the RabbitMQ Message Broker.

    This field is not required if using SSL to connect to the message broker.

    Note: Do not delete the ! in front of the password. This symbol is not part of the password itself. Instead, this symbol will cause the password to be encrypted automatically when the service is restarted.

  1. If you are using SSL configuration, configure the attributes, by replacing the values within the quotation marks with the values detailed in the following chart.

    Attribute

    Replace text...

    ... with the following values:

    		Notes

    sslEnabled

    FALSE

    TRUE

    		 None

    sslServerName

    SSL_SERVER_NAME

    The Common Name (CN) where the SSL certificate stored.

    		 Typically, this is the host name of the server to which this client will connect.

    sslCertPassPhrase

    SSL_CERT_PASSWORD

    SSL certificate password.

    Note: Do not delete the ! in front of the password. This symbol is not part of the password itself. Instead, this symbol will cause the password to be encrypted automatically when the service is restarted.

    sslCertPath

    PATH_TO_CERT

    File path to the directory where the SSL certificate is stored.

    The SSL certificate is not supplied by GE Digital It should be obtained from a third-party certificate authority.

    tlsVersions 1.2

    The desired encryption algorithm.

    • The default value is 1.2.
    • Alternatively, to support multiple algorithms, you can enter multiple values, and then separate the values with a semicolon.
    		 Only tls1.1 and tls1.2 versions are supported.

  2. Save and close the file.

Results

Your settings will be applied when you start or restart the Meridium AMQP Service.

What's Next?

Related Information

Copyright © 2018 General Electric Company. All rights reserved.