Skip to main content

Running LiveRamp’s Local Encoder in an AWS EC2 Virtual Machine

Local Encoder enables you to generate securely-encoded RampIDs for your consumer data files within your own cloud environment and then utilize that data for Activation or addressability use cases, depending on your needs. In this way your consumer data is never exposed to an external network, while still enabling full use of the LiveRamp solutions. The encoded RampIDs produced by the application cannot be decoded back to the original consumer identifiers.

Local Encoder can be run on any infrastructure that supports running Docker images. The Local Encoder Docker image is currently distributed via the Amazon Elastic Container Registry (ECR).

For more information on Local Encoder, including information on security, use cases, data you can send, and output options, see "LiveRamp Local Encoder".

For information on running Local Encoder in an AWS EC2 virtual machine, see the sections below.

Overall Steps

After you make sure all the prerequisites listed below are in place, running the Local Encoder in an AWS EC2 virtual machine involves the following overall steps:

  1. Create a virtual machine in AWS EC2.

  2. Perform the overall steps in “Running LiveRamp’s Local Encoder In a Docker-Run Environment”.

Prerequisites

Before setting up the Local Encoder application, make sure that the AWS EC2 Instance is set up according to your infrastructure needs and is ready for use.

Running the Local Encoder in an AWS EC2 virtual machine requires that you have the following additional prerequisites:

Note

  • You will use the AWS command line tool to issue commands at your system's command line to perform Amazon ECR and other AWS tasks. We recommend that you have the latest version of the AWS CLI installed. For information about installing the AWS CLI or upgrading it to the latest version, see Installing the AWS Command Line Interface.

  • We need to maintain the same architecture, i.e., build the image to match the architecture used by the Runner.

In this section:

LiveRamp's universal, pseudonymous identifier that is tied to devices in the LiveRamp Identity Graph.