Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 35 Next »

This article explains how to deploy Cloudaware Breeze agent using AWS Systems Manager.

Automatic installation using Breeze Package sharing in Cloudaware CMDB

Requirements

1. Ensure AWS Systems Manager is enabled and properly configured in your AWS environment. Read more

2. Ensure that your AWS account is added to Cloudaware.

Enable package sharing

1. Log in to your Cloudaware account → Admin.

2. Find Breeze in the list of DevOps integrations. Click +Add (or +N Configured).

3. Click on the toggle switch next to 'Breeze Package Sharing (AWS only)' to enable sharing of Cloudaware Breeze Package in AWS Systems Manager.

breeze - aws system manager - breeze package sharing.png

  1. To check the package, log in to AWS Console → AWS System Manager → Distributor → Shared with me.

Manual package creation for AWS Systems Manager Distributor (deprecated)

Using this option, you create a package with Breeze Agent. The Distributor publishes this package to System Manager-managed instances. Then the agent can be installed or uninstalled:

Prerequisites

The distributor package consists of a manifest and two .zip archive files for Windows and Linux platforms. Each archive contains install and uninstall scripts, as well as Breeze Agent distro respectively to the platform. The manifest template and scripts can be obtained from the GitHub repository.

In the file manifest.json, find the field "version" and change its value to a meaningful one. The value of a version name should also be specified when the package is added to the Distributor (it becomes a part of the AWS Systems Manager document). The version value can contain letters, numbers, underscores, hyphens, and periods, and be from 3 to 128 characters in length. Using a human-readable value is recommended.

Preparing package files

A Linux archive named breeze-agent-linux.zip should contain such files as install.sh, uninstall.sh and agent.XXX.YY.Z.x86_64.linux.tgz (the Linux Breeze Agent distro as downloaded from CMDB).

A Windows archive named breeze-agent-windows.zip should contain such files as install.ps1, uninstall.ps1 and agent.XXX.YY.Z.windows.signed.exe (the Windows Breeze Agent distro as downloaded from CMDB).

Ensure the script files have correct lines breaks, namely LF (\n == 0x0A) on Linux and CRLF (\r\n == 0x0D 0x0A) on Windows.

For each archive file mentioned in the manifest, a sha256 checksum should be specified. To calculate it, the following commands can be used:

  • Linux: shasum -a 256 file-name.zip or openssl dgst -sha256 file-name.zip

  • Windows: Get-FileHash -Path file-name.zip (PowerShell)

In the manifest.json, find the section "files" and replace ARCHIVE_CHECKSUM placeholders with the calculated checksums.

Package creation

Create an Advanced package in the AWS Systems Manager, as described in AWS documentation.

  • No labels