Skip to main content

Frequently Asked Questions

Getting started​

What do I need before I can set up a connection?​

The details depend on the protocol. For most connections, you need:

  1. The endpoint address (host and port) of the system you're connecting to
  2. Any credentials required by the external system
  3. The protocol-specific settings (your Connamara representative or the external system's connectivity team can provide these)

Do I need technical knowledge to use Conncentric?​

For most setups, no. You fill in the connection details provided by the external system, and Conncentric handles the protocol. The Pipeline Designer uses plain field names for filtering and transformation. No programming required.

For custom logic, the Plugin SDK is available for developers.

Adapter status​

What's the difference between "enabled" and "Running"?​

Enabled/Disabled is what you set. It's your instruction to the platform ("run this" or "don't run this").

Running/Provisioning/Standby/Error/Inactive is what the platform reports. It's the actual live state of the connection.

An adapter can be enabled and show Provisioning while it starts up, on its way to Running, or Error if something went wrong. An adapter that stays Inactive while it is enabled is not normal startup; it is a fault to investigate, because it means no adapter server has capacity to run it. See Adapters Overview for the full status explanation.

Why is my adapter stuck on "Provisioning"?​

Provisioning means the platform is placing the adapter and trying to start the session but has not succeeded yet. Common causes:

  • The adapter was just enabled and is still starting up. Wait for it to settle.
  • No adapter server has capacity to run it. Contact your administrator.

If Provisioning does not progress, open the adapter and read the Event Log for an error. See Troubleshooting for the full checklist.

My adapter was Running, then suddenly showed Error. What happened?​

Open the adapter and read the Event Log. The entry just before the Error status change names the cause. Common causes: a network drop to the external system, a session keepalive timeout, or a configuration problem. See Event Log Reference for what each event type means.

What does it mean when the status cycles between Provisioning and Error repeatedly?​

The adapter is trying to connect, failing, and retrying. The Event Log will show the specific error on each attempt. The most common cause is a network or configuration problem: wrong host, wrong port, or a connectivity issue.

Making changes​

Can I edit an adapter that's currently running?​

Yes. From the Adapters list, open the adapter's row menu and choose Configuration, make your changes, and save. The platform will restart the connection to apply the new configuration. (On the adapter's Operational Console, an Edit Configuration button appears once the adapter is disabled.)

For production connections, consider disabling the adapter first, making the change, then re-enabling. This gives you a cleaner restart.

I made a change but it doesn't seem to have taken effect. What should I do?​

Check that you saved the change (the adapter should show a "last modified" timestamp update). If the adapter is running, it needs to restart to pick up the new settings. Disable it, wait for it to show Inactive, then enable it again.

Can I copy an adapter to use as a template for a new one?​

Yes. When you create a new adapter, choose Use Existing on the Configuration Strategy step, select the source adapter's configuration from the library, then pick Clone (Copy). This creates an independent copy (its name is pre-filled as "Original (Copy)") that you can rename and edit freely. Changes to the copy do not affect the original, which makes it the right choice for templating and for building dev or test variants of a working setup.

If you instead want two adapters to share one configuration so that a change applies to both, pick Link (Shared) on the same step.

I deleted an adapter by accident. Can I get it back?​

If your team uses IaC bundles, your administrator can re-apply the bundle to restore it. If the adapter was only configured through the Portal with no export, it cannot be recovered.

This is one reason to export and save configurations for any important connection.

Connections​

What happens when I disable an adapter? Does it disconnect immediately?​

The platform sends a proper disconnect to the external system before closing the connection. The external system will see a clean shutdown rather than an abrupt drop.

Can I have two adapters connecting to the same external system?​

It depends on the external system and protocol. Some systems allow multiple simultaneous connections. Others require exclusive access.

From Conncentric's side, you can create as many adapters as you need. Each one manages an independent session.

My adapter connects but no messages are coming through. What do I check?​

  1. Check the Event Log. Are you seeing message receive events? If no messages appear in the log at all, the external system may not be sending any.
  2. If messages appear in the log but aren't reaching your destination, check your pipeline filters. A filter condition may be dropping them.
  3. Check with the external system's support team. They may need to enable message delivery for your connection.

What happens to a connection if the server running it crashes?​

Another server picks up the session automatically. The exact time depends on your platform's failover configuration. No action is required from you. See Adapters Overview for how redundancy works.

Platform​

How many adapters can I run at the same time?​

There is no hard limit in the platform. Practical limits depend on the capacity your administrator has provisioned and how resource-intensive each connection is. See Scaling for capacity planning.

Where is my data stored?​

All configuration (adapter settings, plugin files, and reference artifacts like data dictionaries) is stored in the platform's database. The platform does not store certificates or private keys. Message data passes through the platform on its way to its destination. Whether any message content is retained depends on the plugins in use: some keep a Message Log you can review from the adapter detail page for replay and troubleshooting. The platform itself keeps no separate copy of message payloads.

Is there an API I can use to automate things?​

Automation is possible without clicking through the Portal for every change. Configurations can be exported and applied as IaC bundles, which lets your administrator provision and update connections repeatably. Whether a supported, documented customer-facing API is available for direct integration is not something this guide can confirm; check with your Connamara representative for what your environment supports.