Agent Task - Send Project

Agent Tasks have the ability to send projects and project resources from a Controller to an Agent.

Send Project Task

On the Controller, under the Configure tab go to Enterprise Administration > Agent Tasks. Here you can create a Gateway Task to send a project from the Controller to an Agent.

  1. The following example demonstrates how to create a Gateway Task and send a project to an agent. Click the ‘Create new Gateway Task’ link. The EAM wizard will guide you through each step of the Send Project task.

    images/download/attachments/6035463/EAM_Send_Project_-_Controller_Gateway_Tasks_1.png

  2. Not only will the Send Project send a project from the Controller to the Agent, but if the project already exists on the Agent, it will replace it.
    Scroll down the list of Gateway Tasks and select Send Project. Press Next.

    images/download/attachments/6035463/EAM_Send_Project_-_Send_Project_Task_2.png

  3. Just like with all Gateway Tasks, the Send Project task needs to be scheduled. Schedule the task to Execute Immediately and press Next.

    images/download/attachments/6035463/EAM_Send_Project_-_Task_Scheduling_3.png

  4. Select the Agent where you want to send your project and press Next.

    images/download/attachments/6035463/EAM_Send_Project_-_Select_Agent133_4.png

  5. The EAM knows your controller and agent configuration. It’s going to prompt you to choose the machine where your project is located. In this example, the project that you want to send is located on the Controller or Gateway source so select Local System and press Next.

    images/download/attachments/6035463/EAM_Send_Project_-_Select_Local_System__5.png


  6. The wizard displays all your projects from your local system. Select the project you want to send to your Agent. In this example, select the Parameters project and press Next.
    (If you select your Agent on the previous screen, the wizard will display all your projects running on your Agent that were sent over previously from the Controller).

    images/download/attachments/6035463/EAM_Send_Project_-_Select_Project_to_Send_6.png

  7. The EAM wizard summarizes all the information for you to review. Press Finish and the Parameters project will be sent from the Controller to your Agent.

    images/download/attachments/6035463/EAM_Send_Project_-_Send_Project_Finish_Wizard_7.png

  8. The EAM will execute the task, the screen will refresh, and a message will popup stating that your Send Project task was successful.

    images/download/attachments/6035463/EAM_Send_Project_-_Successful_Send_Message_8.png

  9. To verify that the Parameters project was sent, go to your Agent, click on the Configure tab and select Projects. You can see that the Parameters project was created by the EAM controller. If you can't see your sent project, refresh the screen by clicking Projects.

    MySQL Warning Message

    Notice that for the "Parameters" project there is an warning icon next to the "MySQL" database. This is because the project was configured to use a default database connection named "MySQL" on the Controller, but the Agent that the project has been restored on does not have a database connection named "MySQL".

    images/download/attachments/6035463/EAM_Send_Project_-_Agent_Projects_Parmeters_9.png

Send Project Resources Task

You can also send project resources, such as project templates, windows, transaction groups, pipelines and even script modules from the Controller to an Agent.

  1. On the Controller, under the Configure tab, go to Enterprise Administration > Agent Tasks. Let’s create another Gateway Task to send resources from the Controller to the Agent. Click the ‘Create new Gateway Task’ link. Once again, the EAM wizard will guide you through each step of the Send Project Resources task.

    Reference screenshots in the Send Project section

    You can refer to some of the screenshots in the Send Project Task section as you work your way through the examples in this Send Project Resources Task.

  2. Click on the Send Project Resources radio button and press Next.

    images/download/attachments/6035463/EAM_Send_Project_-_Send_Project_Resources_11.png

  3. Schedule the Send Project Resources task to Execute Immediately and press Next.

  4. Select the resources from a project on the Controller. Select Local System and press Next.

  5. This example sends selected resources from the Training project on the Controller to the Agent. Select Training and press Next.

    images/download/attachments/6035463/EAM_Send_Project_-_Select_Local_Project_Resources_13.png

  6. You can see all the resources inside of the Training Project. Of course, real projects will have many more useful project resources than are shown here. It can include templates, windows, transaction groups, pipelines and script modules. Choose whatever resources you want to send to the agent, and press Next.

    images/download/attachments/6035463/EAM_Send_Project_-__Select_Resources_15.png

  7. You have the option of either merging the project resources into an existing project or creating a new project on the Agent. In this example, let's create a new project. Select Other, and enter a new project name. Press Finish.

    images/download/attachments/6035463/EAM_Send_Project_-_Select_Target_Project_16.png

  8. The EAM wizard summarizes all the information for you to review. Press Finish.

    images/download/attachments/6035463/EAM_Send_Project_-_Finish_17.png

  9. The Gateway Task for Send Project Resources will execute, the screen will refresh, and a message will appear stating that the task was successful.

  10. To verify that the Training project resources were sent, go to your Agent, click on the Configure tab, and select Projects. You can see in this example that 'NewProject2' was created by the EAM controller. If you cannot see your new project, refresh the screen by clicking Projects.

    images/download/attachments/6035463/EAM_Send_Project_-_Sent_Project_Resources_19.png

Once your project and project resources are sent to the Agent, you need to complete the installation of your project. You need to setup your authentication profile, database, and tag providers. Once this is completed, you are ready to use the project and project resources on your Agent.