Pipeline wizard
Relay
Choose a separate apply agent for the target and pair it with the capture agent on the wizard's Pair the relay screen.
When the target is far from the source, you can have a second agent, near the target, apply the changes. The wizard asks for it on the Target step, then pairs the two agents on a screen of its own, Pair the relay, before you can leave the step. A relay is available for every source and capture mode.
To relay a target you add later, see Apply a target on another agent. For how the relay works, see Distributed acceleration.
Choose the apply agent
On the Target step, Apply this pipeline target on offers:
- This pipeline’s agent (local, no relay), the default: the agent that captures the source also writes the target.
- agent (over the relay): that agent applies the target, and the capture agent ships the changes to it. Only online agents are offered.
Once you choose another agent:
- The apply agent resolves the target host, so
localhostmeans the apply agent's machine. - Test connection runs on the apply agent, and the target's credentials stay on it.
- Both agents must stay online. If either goes offline, the field says so in red.
Select Next after the connection test succeeds. The wizard opens Pair the relay.
Pair the relay
The screen names the two agents, and Pair & verify starts by itself.
| Field | What it shows | What you can do |
|---|---|---|
| Relay port | The port the apply agent listens on, 7420 unless that agent already listens on another port. in use means another pipeline already uses this listener. | Select Change to enter another port. A port that's in use can't change. |
| Relay host | The host the capture agent dials. | Select Change to enter a DNS name or IPv4 address the capture agent can reach, without a port or scheme. IPv6 isn't supported. |
| Pair & verify | The pairing action. It reads Verify dial once a pairing exists, and Re-pair & verify after you change the port or host. | Select it to pair the agents and have the capture agent dial the apply agent. |
| Status line | Verified: capture agent connected, Verifying from capture agent, or Failed at step: with the cause. | Fix the cause of a failure, then select Verify dial. |
Next stays disabled until the dial is verified. The capture agent must reach the relay port on the apply agent's host over TCP, so open that port in the firewall between them. Details shows the exact endpoint, the firewall rule and the pairing state.
Changing the port or host clears the verification of every pairing on that apply agent's listener, including other pipelines' pairings. The screen says so before you select Re-pair & verify.
For what each failed step means, see Setting up relay agents. The Review step shows the relay's agents, port and dial status. See Review and create.
