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 section of the Gateway webpage, go to Enterprise Administration > Agent Tasks. Here you can create a Gateway Task to send a project from the Controller to an Agent.

  1. Click the ‘Create new Gateway Task’ link. The EAM wizard will guide you through each step of the Send Project task.

    images/download/attachments/6047381/Create_New_GW_Task.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/6047381/Send_Project_Task_2.png

  3. Just like with any Gateway Task, the Send Project task needs to be scheduled. There are several scheduling options available, but for this example, schedule the task to Execute Immediately and press Next.

    images/download/attachments/6047381/Send_Project_Sechedule.png

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

    images/download/attachments/6047381/Select_Agent_2.png

  5. The EAM wizard 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/6047381/Select_Local_System.png

  6. The EAM wizard will display 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 EAM wizard will display all your projects running on your Agent that were sent over previously from the Controller).

    images/download/attachments/6047381/Select_Project_2.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 the Agent.

    images/download/attachments/6047381/Parameters_Task_Summary.png

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

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

    images/download/attachments/6047381/Parameters_Project_Sent_to_Agent99.png

    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".

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 section of the Gateway webpage, go to Enterprise Administration > Agent Tasks. Let’s create another Gateway Task to send project resources from the Controller to the Agent. Click the ‘Create new Gateway Task’ link. 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/6047381/Send_Project_Resources_Task_2.png

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

  4. Select the Agent on the Agent Selection window, and press Next.

  5. Select the Source Gateway / Local System where your project resources reside, and press Next.

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

    images/download/attachments/6047381/Select_Source_Project.png

  7. 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/6047381/Select_Project_Resources_2.png

  8. 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 Next.

    images/download/attachments/6047381/Select_Target_Project.png

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

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

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

    images/download/attachments/6047381/NewProject_Created_on_Agent99.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.

Similar Topics ...