Virtual Machine Installation

A guide to installing Shoreline Agents on virtual machines.

Create a Policy

To install Agents on AWS VMs you must first create an AWS IAM policy. Below you'll find instructions for both the AWS Console and the AWS CLI.

Attach the Policy

Next, attach the GetShorelineLinuxPackages policy to an IAM role.

  • An existing IAM role

    The examples below use the ShorelinePackageConsumer role.

Provide the Role ARN to Shoreline

Shoreline whitelists all roles that require access to the shoreline-linux-packages S3 bucket.

  1. Please contact your Shoreline representative and give them the full role ARN that has the GetShorelineLinuxPackages policy attached.

  2. Once Shoreline whitelists the role, you may proceed to the next step.

Setup VMs

The final step is to set up your virtual machines using a customer-specific package provided by Shoreline.

Install the Docker Engine appropriate to your OS.

Download the Shoreline Package

To download the Shoreline package from our Amazon S3 bucket you need the AWS CLI installed and configured.

Download the Shoreline package and configuration from the shoreline-linux-packages bucket.

/usr/local/bin/aws s3 cp s3://<shoreline_provided_package_path>
/usr/local/bin/aws s3 cp s3://<shoreline_provided_conf_path>

Install the Shoreline Package

Lastly, install the provided Shoreline package.

Verify the Shoreline Installation

Check the Shoreline service status using the systemctl.

sudo systemctl status shoreline.shoreline.service

You can also check the systemd logs with journalctl.

sudo journalctl -f -u shoreline.shoreline.service

You can also use Shoreline to check for Agent-enabled hosts.

  1. Get the EC2 instance id.

  2. Use a hosts Resource query in the Op CLI to verify that the Agent is registered via the host.

    hosts | instance_id=~"i-8aef8284c836103b"
    ID | TYPE | NAME               | REGION    | AZ
    1  | HOST | i-8aef8284c836103b | us-west-2 | us-west-2a