5.2 ORF Online Help
Select your ORF version:

Table of Contents

Managing Transport Agents


This help section describes the process of managing ORF Transport Agents.

Transport Agents used by ORF

For Microsoft® Exchange 2010 and Exchange 2007

ORF installs two Transport Agents: the Vamsoft ORF SMTP Receive Agent (responsible for Before Arrival filtering and On Arrival filtering) and the Vamsoft ORF Routing Agent (responsible for collecting outbound email data for the Auto Sender Whitelist).

For Microsoft® Exchange 2013

Similarly to previous Exchange versions, ORF may install the Vamsoft ORF SMTP Receive Agent and the Vamsoft ORF Routing Agent, but the local Exchange roles decide which agents are actually installed.

Client Access Server-only installation

Only the Vamsoft ORF SMTP Receive Agent is installed.

Mailbox Server-only installation

Both the Vamsoft ORF SMTP Receive Agent and the Vamsoft ORF Routing Agent are installed.

Single-server, mixed Client Access Server + Mailbox Server installation

The Vamsoft ORF SMTP Receive Agent is installed twice, once for the Front-End Transport Service of Exchange 2013 Client Access Server and once for the Hub Transport Service of Exchange 2013 Mailbox Server. The Vamsoft ORF Routing Agent is also installed.

For diagnostic purposes, you may want to temporarily disable these agents. This can be done using the Exchange PowerShell console.

Disabling an ORF Transport Agent

Exchange 2007/2010

Start the Exchange PowerShell console and run the

Disable-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent"

or the

Disable-TransportAgent -Identity "Vamsoft ORF Routing Agent"

command. Note that this change will take effect only after restarting the related Exchange transport service. To restart these services manually, use the

Restart-Service MSExchangeTransport

command.

Exchange 2013

On Exchange 2013, when both roles (Client Access server and Mailbox) are installed on the same server, Transport Agent PowerShell commands require an additional TransportService parameter to specify which role the command should run on.

Start the Exchange PowerShell console and run the

Disable-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent" -TransportService FrontEnd

and the

Disable-TransportAgent -Identity "Vamsoft ORF Routing Agent" -TransportService Hub

commands. Note that these changes will take effect only after restarting the related Exchange transport service(s). Depending on your setup this could be the MSExchangeTransport service (Exchange 2013 Mailbox server role), the MSExchangeFrontEndTransport (Exchange 2013 Client Access server role) or both (Exchange 2013 Client Access server and Mailbox roles on the same server). To restart these services manually, use the

Restart-Service MSExchangeTransport

and/or the

Restart-Service MSExchangeFrontEndTransport

commands.

If the Client Access server and Mailbox server roles are installed on separate servers, the *-TransportAgent commands issued from the Exchange Management Shell on a Client Access server will always run on the Mailbox server.

To manage the Transport Agents of the CAS, you should start a regular PowerShell prompt and install an additional snap-in in order to run the *-TransportAgent commands on the local server. For more information, please consult this article ("TransportAgent cmdlets on Client Access servers require local Windows PowerShell" section).

Enabling an ORF Transport Agent

Exchange 2007/2010

Start the Exchange PowerShell console and run the

Enable-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent"

or the

Enable-TransportAgent -Identity "Vamsoft ORF Routing Agent"

command. Note that this change will take effect only after restarting the Exchange transport:

Restart-Service MSExchangeTransport

Exchange 2013

The simplest way to enable ORF Transport Agents if they get disabled is uninstalling and reinstalling them using the Exchange Helper tool — see the related Help topic for detailed instructions.

Alternatively, you can use PowerShell commands. On Exchange 2013, when both roles (Client Access server and Mailbox) are installed on the same server, Transport Agent PowerShell commands require an additional TransportService parameter to specify which role the command should run on.

Start the Exchange PowerShell console and run the

Enable-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent" -TransportService FrontEnd

and the

Enable-TransportAgent -Identity "Vamsoft ORF Routing Agent" -TransportService Hub

commands. Note that these changes will take effect only after restarting the related Exchange transport service(s). Depending on your setup this could be the MSExchangeTransport service (Exchange 2013 Mailbox server role), the MSExchangeFrontEndTransport (Exchange 2013 Client Access server role) or both (Exchange 2013 Client Access server and Mailbox roles on the same server). To restart these services manually, use the

Restart-Service MSExchangeTransport

and/or the

Restart-Service MSExchangeFrontEndTransport

commands.

Installing Transport Agents

If, for any reason, the ORF Transport Agents get uninstalled, follow the instructions described in the related Help topic to install them.

Changing the Agent Priority

Exchange 2007/2010

Start the Exchange PowerShell console and run the

Get-TransportAgent

command to get the list of transport agents installed on your system. To change the priority of the ORF Transport Agents, run the

Set-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent" -Priority X

or the

Set-TransportAgent -Identity "Vamsoft ORF Routing Agent" -Priority X

commands, where X is the new priority. The highest priority is 1. Note that priority values are not absolute—if you have 4 transport agents and you change the priority of an agent from 4 to 3, the agent that previously had priority 3 will have priority 4.

Exchange 2013

To change the priority of the ORF Transport Agents on an Exchange 2013 server with both roles installed, run the

Set-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent" -TransportService FrontEnd -Priority X

or the

Set-TransportAgent -Identity "Vamsoft ORF Routing Agent" -TransportService Hub -Priority X

command, where X is the new priority. The highest priority is 1. Note that priority values are not absolute—if you have 4 transport agents and you change the priority of an agent from 4 to 3, the agent that previously had priority 3 will have priority 4.

Copyright © Vamsoft Ltd. 2024. All rights reserved. Document ID ta-manage, version 2.