Open topic with navigation

Modify the File Meridium.GE.Service.exe.config

Steps

  1. On the machine on which you are configuring the Meridium GE Service, navigate to the folder where the Meridium GE Service is installed. If you installed the software in the default location, you can locate this file in the following location: <root:>\Program Files\Meridium\Services.
  2. Open the file Meridium.GE.Service.exe.config in an application that you can use to modify XML script (e.g., Notepad).

  3. In the file, within the <configuration> tags, locate the following text:

    <apmMqConnections>

  4. Within the <apmMqConnections> tags, uncomment the example connection tag by deleting <!--EXAMPLE: and the corresponding --> from the beginning and end of the string.

  5. 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.

  6. 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.

  7. Within the <meridiumconnections> tags, uncomment the example connection tag by deleting <!--EXAMPLE: and the corresponding --> from the beginning and end of the string.

  8. Within the <meridiumconnections> tags, 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

    name

    NAME

    A name to identify the connection to the database.

    		This value is used only by the configuration file.
    apmMqKeyKEYThe key of the apmMqConnection to use for this connection.The key must match at least one of the defined keys in the apmMqConnection section.
    applicationServerENTER_APP_SERVERThe name of the GE Digital APM server.None

    datasource

    DATA_SOURCE

    The name of the GE Digital APM data source to which you want to connect.

    		The data source value is case sensitive and should be typed exactly as it is defined for the GE Digital APM Server in the Data Sources section of Operations Manager.

    userId

    ENTER_USER

    The User ID of the Security User whose credentials should be used to log in to the specified GE Digital APM database.

    		None

    password

    ENTER_PASS

    The password for the specified user.

    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. Save and close the file.

Results

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

What's Next?

Related Information

Copyright © 2018 General Electric Company. All rights reserved.