Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The file that controls the configuration settings for Perspectium Meshlet is

the 

a yaml file, generally named application.yml or application-dev.yml

 file

. This file

contains configurations that are needed for the Meshlet to run. 

is included as part of a meshlet's installation. To make changes to the configuration settings for your meshlet, open the yaml file in a text editing application and modify the configurations described in the sections below.



Panel
titleWhat's on this page?

Table of Contents
maxLevel2
absoluteUrltrue




UI Text Box
typetip

The keys configurations described below are only the essential configurations that must be set for your Meshletmeshlet. Additional configuration configurations will depend on your integration, i.e. a bi-directional integration between ServiceNow and Ivanti. 

Spring

; see the respective documentation (such as DataSync for Snowflake or ServiceBond for Jira) for further details.


Spring - RabbitMT Configuration

Meshlets connect to the Perspectium Integration Mesh over AMQP/AMQPS.

RabbitMQ Configuration

To configure your connection to the Perspectium Integration Mesh, you  you will need to include the following keysconfigurations under spring.rabbitmq


KeyDefault ValueDescription

host


Host name for connecting to the Perspectium Integration Mesh.

Code Block
languageyml
spring:
   rabbitmq:
      host: localhost


port 

A port number that the transferring data will useThe AMQP or AMQPS port for connecting to the Perspectium Integration Mesh. The value for this configuration is generally 5672 for connecting over AMQP or 5671 for a secure connection over AMQPS (SSL).

Code Block
languageyml
spring:
   rabbitmq:
      port: 12345671


username

Username for connecting to the Perspectium Integration Mesh.

Code Block
languageyml
spring:
   rabbitmq:
      username: georvioloan


password

Password for connecting to the Perspectium Integration Mesh.

Code Block
languageyml
spring:
   rabbitmq:
      password: password123


vhost

 Virtual host name for connecting to  Your virtual space (vhost) in the Perspectium Integration Mesh. This value will generally be provided to you by Perspectium Support.

Code Block
languageyml
spring:
   rabbitmq:
      vhost: /


exclusivetrue

Sets the outbound queue as an meshlet to be the exclusive consumer of messages in the queue specified in the below perspectium.message.inboundQueue configuration. When this value is true, any other meshlet that tries to connect to the queue will be denied access until this meshlet is no longer connected. Using this value as true prevents other meshlets (such as a test or dev meshlet) from consuming messages on accident.

This can also be use useful for high availability when you are running two Meshlets meshlets at once. The first Meshlet ran will be prioritized over the second Meshletmeshlet ran will continue to access and consume the queue while the second meshlet will continually retry every 30 seconds. If the first meshlet should die and lose connection, then the second meshlet will start connecting to consume messages.

Code Block
languageyml
spring:
   rabbitmq:
      exclusive: true


ssl:

   enabled


false

Enables a secure connection over AMQPS (SSL) to RabbitMQ. The spring.rabbitmq.port configuration above will also need to be an AMQPS port that accepts secure connections

Code Block
languageyml
spring:
   rabbitmq:
       exclusivessl: 
         enabled: true






Perspectium

- Message Configuration

To configure which queue will receive or send messagesPerspectium-related properties including which queues to connect to in the Integration Mesh, you will need to include the following keysconfigurations under perspectium.message


perspectium: message: inboundQueue: psp.in.meshlet.servicenow.incident.psp_demo

For more information on how to name your queues, contact Perspectium Support.

KeyDefault ValueDescription

inboundQueue


Represents the shared queue on the provider instance. in the Integration Mesh that the meshlet will consume messages from.

Code Block
languageyml
perspectium: 
   message:
      inboundQueue: psp.in.meshlet.servicenow.incident.psp_demo

Queues are generally in the In DataSync integration, the value will have the following format:

DataSync:

Code Block
psp.in.meshlet.<application>.<customer/key>

Example: psp.in.meshlet.servicenow.psp_demo.

In ServiceBond integration, the value will have the following format:

Code Block
psp.in.meshlet.<application>.<process>.<customer/key>

Example: psp.in.meshlet.servicenow.incident.psp_demo.

Code Block
languageyml
outboundQueue

Represents the subscribed queue on the provider queue in the Integration Mesh that the meshlet will be publishing messages to. This is normally a ServiceNow instance, such as another application that is being integrated with ServiceNow sending messages (records) to the instance. 

Code Block
languageyml
perspectium: 
   message:
      inboundQueue: psp.out.servicenow.dev123456


wrapCDATAfalse

Enabling the key this configuration will wrap all outbound message fields in a CDATA section. This is useful for when you have a ServiceBond integration with an API that receives XML payloads.

Code Block
languageyml
perspectium: 
   message:
      wrapCDATA: false






Example of

application-dev.yml

a meshlet configuration yaml file

The example below shows a basic configuration of the YAML file. Additional configuration will depend on your integration, meshlet configuration yaml file (i.e. a bi-directional integration between ServiceNow and Ivanti. . application.yml or application-dev.yml).

Code Block
languageyml
spring:
   rabbitmq:
      host: localhost
      port: 5672
      username: georvioloan
      password: password123
      vhost: /
      exclusive: false
perspectium:
   message:
      inboundQueue: psp.in.meshlet.servicenow.incident.psp_demo
      outboundQueue: psp.out.servicenow.dev123456
      wrapCDATA: false