On-premises transfer agent command-line options

Transfer service for on-premises data agents transfer data from your on-premises data center to Google Cloud. You can control agent options when you run an agent through the flags and options described in this page.

Command summary

sudo docker run [--ulimit memlock=64000000 -d -rm -v host-directory:container-directory]
gcr.io/cloud-ingest/tsop-agent:latest
{--help | --version | --project-id=project-id}
[--agent-id-prefix=id-prefix --creds-file=credential-file
--enable_mount_directory --hostname=hostname
--log-dir=logs-directory ]

Docker options

--ulimit memlock=64000000

Locks shared memory for a shared pool for Docker, so that it is always in memory for access by multiple sessions.

-d

Starts the Docker container in detached mode, or in the background. This allows you to continue issuing commands from the Linux terminal.

For more information, see Detached -d

-rm

Deletes the container and the container's file system when Docker exits.

For more information, see Clean up (--rm)

-v host-directory:container-directory

Specifies one or more volumes to map from the host to the container. When using -v with Transfer service for on-premises data, we require the host-directory and container-directory to be the same, otherwise Transfer service for on-premises data won't successfully locate your files for transfer.

For more information, see VOLUME (shared filesystems)

Agent options

--agent-id-prefix=id-prefix: An optional prefix that is prepended to the agent ID to help identify the agent or its machine in the Google Cloud Console. When a prefix is used, the agent ID is formatted as prefix + hostname + Docker container ID.
--creds-file=credential-file: An optional JSON-formatted service account credential file. For more information about generating a service account credential file, see creating and managing service account keys.

Note: Unless you are using --enable_mount_directory, you must prefix this path with /transfer_root, for example /transfer_root/path/to/cred_file.json.
--enable_mount_directory: Optionally mounts the whole file system under the directory /transfer_root within the Docker container, rather than specifying individual Docker -vvolume mounts. When using this flag, you don't need to prefix /transfer_root to the log directory or the service account credentials file path, and /transfer_root isn't visible in transfer logs or GUI error samples.
--help: Displays brief usage help.
--hostname=hostname: set the hostname that the agent is running on. Used to report the hostname of the machine a particular agent is running on.

Note: We recommend passing --hostname=$(hostname) when using this flag.
--log-dir=logs-directory: An optional directory that the agent writes logs to. The default directory is /tmp/.

Note: Unless you are using --enable_mount_directory, you must prefix this path with /transfer_root, for example, /transfer/root/path/to/log_file.
--project-id=project-id: Required string of the project ID that is hosting the transfer and Pub/Sub resources that are created and billed.
--version: Displays the current version of the agent.