diff --git a/docs/tutorials/FileRetrieval/FileRetrieval.md b/docs/tutorials/FileRetrieval/FileRetrieval.md new file mode 100644 index 0000000000000000000000000000000000000000..9cec5cd281aa1edca18641326f5fc16d2d648897 --- /dev/null +++ b/docs/tutorials/FileRetrieval/FileRetrieval.md @@ -0,0 +1,31 @@ +# 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 radius for _Create New at Runtime_. If this is a recurring task in your existing mapping, you may wish to select the _Existing_ radius 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. diff --git a/images/Create1.png b/images/Create1.png new file mode 100644 index 0000000000000000000000000000000000000000..f23a8c2bd65937c1bcdc241502333737b08eb11b Binary files /dev/null and b/images/Create1.png differ diff --git a/images/CreateNew3.png b/images/CreateNew3.png new file mode 100644 index 0000000000000000000000000000000000000000..8c0008d673e67c9d0af51d1f772ede2286bbe2cc Binary files /dev/null and b/images/CreateNew3.png differ diff --git a/images/Source2.png b/images/Source2.png new file mode 100644 index 0000000000000000000000000000000000000000..0c14e42193944096dd8f1aa682d31fb6842005c3 Binary files /dev/null and b/images/Source2.png differ