FileRetrieval.md

Retrieve a file from the Secure Agent

The Secure Agent is a Linux-based virtual machine that lives in the AWS cloud space. Since it is behind multiple virtual layers, it may be difficult to retrieve files directly off of it. We recommend a small addition to your mapping for regular retrieval of a file, or a small independent mapping for one-off retrieval of files.

To accomplish this, please have a Box account or S3 bucket with a connector set up in IICS to that storage space. Below is an example of an independent mapping to retrieve a log file.

Mapping from Secure Agent to your storage connection

1. Login to IICS.
2. Choose Data Integration in the top menu dropdown.
3. Choose New... in the left menu.
4. Choose Mappings in the left pane of the pop-up window, then choose Mapping in the body of the window. Click Create.

5. Click on the Source box in the mapping, then Source in the Properties section at the bottom of the window.
6. In the Connection drop menu, select an existing Flat File connection to the Secure Agent. If you don't have an existing connector for your team, you may use IntegrationTeamFlatFileTemp, which leads to the temp folder on the Secure Agent.
   • If the file you need isn't in the temp folder on the secure agent, you will need to create a Flat File connector that leads to the appropriate directory.
7. Select Single Object in Source Type and then click the Select... button for Object.
8. In the pop-up window, browse through the file tree to the file you wish to retrieve off of the secure agent.

9. Select the Target box in the mapping, then select Target in the Properties section at the bottom of the window.
10. Select your Connection in the drop menu. We recommend a Box account or an S3 bucket for this purpose.
11. Target Type should be Single Object.
12. Click the Select... button for Object. In the pop-up window, we recommend selecting the radio for Create New at Runtime. If this is a recurring task in your existing mapping, you may wish to select the Existing radio for overwriting with each run.
13. Create a name for your file and click OK.

14. Run your mapping and verify file is now in your storage space.