Install and Configure Task Agent

Use these steps to run the Task Agent Service installer and then add a Task Agent. A task agent handles all scheduled tasks within the Epicor application.

Note When adding a task agent, you must select the Endpoint Binding for the task agent. This binding must match what you previously defined in the Setup Environment screen when adding the Epicor Application Server.

Task agents run against a specific database. To create a task agent, launch the Task Agent Service Configuration for x.x.x.x program (Where x.x.x.x is the ICE version installed with the service). Use this program to add task agents that run on either a local machine or a remote machine.

Note that you can install multiple versions of the Task Agent Service Configuration on the same server. Each version of the service has the ICE version number appended at the end of the program title. For example, you can have both Task Agent Service Configuration for 3.0.6.0 and Task Agent Service Configuration for 3.0.7.0

Epicor ERP 10 Installation Guide Post-Installation

installed on the same machine. Through this feature, you can have multiple versions of the service running at the same time. In the control panel, each instance of the service displays as a separate icon identified by its version number.

1. Navigate to the Task Agent folder in the path where your Epicor application is installed. For example, go to C:\Epicor\[product]\[product version]\SupplementalInstalls\Task Agent.

Note If you have installed an update to the base Epicor ERP 10 application, for example, Epicor ERP 10.0.700.x, you must use the updated installer. For example, go to C:\Epicor\[product]\[product version]\Updates\[update version]\SupplementalInstalls\Task Agent.

2. Double-click the Task Agent Service Installer.exe file to run it. An Epicor Task Agent Service Setup window appears. Click Next. Your dialog may look similar to the following:

3. In the Choose Folder dialog, select the folder where the Task Agent should be installed. The default path is C:\Program Files (x86)\Epicor Software\Task Agent Service. Click Next. Your dialog may look similar to the following:

4. In the Program Group Name dialog, enter a Program Group Name. The default is Task Agent Service x.x.x.x., where x.x.x.x is the ICE version installed with the service.

5. Select whether to create shortcuts for all users of this computer or only for yourself. Click Next.

6. In the Ready to Install dialog, click Next to proceed. The Epicor Task Agent Service is installed.

Post-Installation Epicor ERP 10 Installation Guide

7. In the confirmation window, click Finish.

8. Verify that the Task Agent Service Configuration opens automatically. If it does not open, navigate to Start

> All Programs > Epicor Software > Epicor Administration Tools > Task Agent Service Configuration for x.x.x.x > Task Agent Service Configuration (where x.x.x.x is the ICE version installed with the service).

Your dialog may look similar to the following:

9. To add a task agent service, from File, select New Task Agent. Your dialog may look similar to the following:

10. In the Add Task Agent dialog, enter a unique Name for your Task Agent. For example, ERP10TaskAgent.

11. Enter the AppServer URL to define the URL that connects the task agent to the application server (AppServer).

To locate this URL, you can open the *.sysconfig file for your application and locate the AppServerURL node.

Copy the value from that node to this AppSeverURL field. For example, your AppServer URL may look similar to the following: net.tcp://<app server name>/ERP10/

Note A correct URL format in the Add Task Agent dialog must end with a / (forward slash) symbol.

Verify that the / symbol is at the end of the AppServer URL.

Epicor ERP 10 Installation Guide Post-Installation

12. Use the drop-down menu to select the Endpoint Binding for the task agent. This binding must match what you previously defined in the Setup Environment screen when adding the Epicor Application Server.

13. Enter the Epicor ERP 10 User ID and User Password that the Task Agent uses to access the Epicor application.

Note In addition to the User ID being a valid user for accessing the Epicor application, it must also have rights to Allow Session Impersonation. Note that you set up your Task Agent User Id using the steps in the previous section.

14. Select the Operation Timeout value to define how long, in seconds, it takes a server call to generate an error and fail.

15. If an error occurs, the task agent will try to send the call back to the server. Select the Max Connection Attempts value to define how many times the task agent will attempt to send the call again.

16. Select the Max Concurrent Tasks value to define how many calls the task agent can send to the application server at the same time. Change the value to reflect the capacity of your application server.

17. If you selected UsernameSSLChannel for the Endpoint Binding, the following two check boxes become active:

• Validate WCF Certificate. Select this check box to specify that the task agent service must verify that the Secure Sockets Layer (SSL) Certificate is valid. If you use a self-signed certificate, do not select this check box.

• DNS Endpoint Identity. Enter the expected Domain Name System (DNS) identity of the server. When the system runs X509 SSL Certificate authentication, it uses this identity value to validate the server. If the SSL certificate contains a DNS Endpoint Identity with the same value, the server is valid and can be accessed by the task agent.

18. When all the fields are complete, verify that the Enabled check box is selected.

19. Click Save. Your Task Agent is now added and enabled. A green icon indicates it is active. Your dialog may look similar to the following:

Post-Installation Epicor ERP 10 Installation Guide

Note If a task agent already exists for this application server and you attempt to save, you will receive an error. To create a new task agent for this database, you must first delete the existing task agent.

After the task agent is removed, repeat these steps.