What the Connectivity Agent is
The OIC Connectivity Agent is a lightweight Java process you run on a server inside your network. It creates an outbound tunnel to OIC, allowing integrations to reach on-premise databases, file shares, JMS queues, and legacy APIs — without opening inbound firewall ports.
Prerequisites
- A server (physical or VM) with Java 8 or later, inside the network that hosts your on-premise systems
- Outbound HTTPS access to OIC (port 443)
- At least 2 vCPUs and 4GB RAM recommended
- Network access to the systems you want OIC to reach
Installation steps
- In the OIC console: Settings → Connectivity Agents → Download Agent
- Extract the archive to your server:
unzip oic-agent.zip -d /opt/oic-agent - Edit
conf/Config.properties: set your OIC URL and the agent group name - Authenticate:
./agent.sh configure— enter your OIC credentials - Start:
./agent.sh start - Verify in OIC console: the agent should appear as Active within 60 seconds
Making the agent a system service
Don’t run the agent manually — it’ll stop when you log out. Create a systemd service:
[Unit]
Description=OIC Connectivity Agent
After=network.target
[Service]
ExecStart=/opt/oic-agent/agent.sh start
ExecStop=/opt/oic-agent/agent.sh stop
Restart=on-failure
User=oicagent
[Install]
WantedBy=multi-user.target
High availability
Run two agent instances in the same agent group for redundancy. OIC load-balances across all active agents in a group. Both agents need identical configurations pointing to the same on-premise systems.
Common issues
Agent shows Inactive in console: usually a network or credential issue. Check outbound connectivity to OIC URL and verify credentials haven’t expired.
Slow integration performance: the agent introduces latency. Minimize round trips — batch requests where possible.
Agent crashes under load: increase JVM heap in agent.sh by editing JAVA_OPTS=-Xmx2g.
Maintenance
Update the agent whenever OIC has a major version upgrade. Download the new agent binary and redeploy — agent group configurations persist in OIC. Always test in a non-production agent group first.