Defining S3 Download File Jobs

This job allows you to download the S3 file from the specified bucket into your local machine. If the file already exist in the host, the file is overwritten.

On the Download File Job section, you define the parameters relevant to run that job on the S3 system from Automic Automation.

• Connection

  Select the S3 Connection object containing the relevant information to connect to the Simple Storage Service system.

  To search for a Connection object, start typing its name to limit the list of the objects that match your input.

• Region

  Defining the region in the job is optional and only relevant for AWS. If you choose not to define it, the job takes the URL defined in the Connection object.

  However, if you decide to define the region in the job, make sure that the definition matches the one defined in the Connection object that you have selected for the job. If both region definitions do not match, the job execution fails and an error message is logged in both, the Agent (PLOG) and the Job (REP) reports (see Monitoring S3 Jobs).

• Bucket Name

  Define the bucket name from where the file must be downloaded. You can click the browse button to the right of the field to open a picker dialog where you can select the relevant name.

• Source File Path

  Define the source file name or the path of where the source file is located. You can define the path using either <file name> or <folder name>/<file name>

  You can also click the browse button to the right of the field to open a picker dialog where you can select the relevant file path.

• Destination File Path

  Define the local destination file name (for example, C:\temp\text.xml) or the path on the Agent machine to where the file should be downloaded.

In this section, you define the parameters that determine who can access and modify the downloaded files and which permissions they will have.

• File Permission

  File permissions differ depending on the OS you are using. Those OS differences also apply when granting permissions to a user other than the one running the job.

  Windows

  These options are available:

  • Allowed values:

    • R = Read

    • W = Write

    • X = Execute

  • Format: Any combination of the allowed values (RWX, RW, R,W, X), in uppercase

  UNIX

  Each file is associated with an owner and a group and assigned with permission access rights for three different users: file owner, group members, and others, in that order.

  • Format:chmod

  • Allowed values: 000 to 777, where:

    • 0 = ---

    • 1 = --x

    • 2 = -w-

    • 3 = -wx-

    • 4 = r-

    • 5 = r-x

    • 6 = rw-

    • 7 = rwx

  Using this numeric method allows you to specify which users are allowed to read the file, write to the file, or execute the file.

  Examples

  The combination 640 gives the file owner read and write permissions, read permissions to group members and no permissions to all other users:

  • 6 (rw-) on the first position refers to the file owner permissions

  • 4 (r-) on the second position refers to the group members

  • 0 (---) on the third position refers to others

  Important!

  The job fails when diverging from the allowed file permissions. Also, on Windows, the job fails when both file owner and file owner group are not filled in but there are file permissions specified.

• File Owner

  Owner of the downloaded file who will have the specified permissions.

• File Owner Group

  Owner group as specified on your Unix environment. This group will have the specified permissions.

• On Invalid Permission Settings

  Select the relevant option to define the job behavior when the permission settings are not set correctly.

  • job fails, in these cases:

    • When diverging from the allowed file permission parameters

    • On Windows, when the file owner and the file owner group are not filled in but there are file permissions specified

  • job succeeds, thus ignoring incorrect permission settings

  Default: Job fails

• Defining RA/ Integration Reports Properties

• Defining Common Job Properties

• Executing S3 Jobs

• Monitoring S3 Jobs

• Defining S3 Download File Jobs

• Defining S3 Delete File Jobs

• Defining S3 Exist File Jobs

• Defining S3 Monitor File Jobs

• Defining S3 Upload File Jobs