| Table of Contents |
|---|
...
|
...
|
Navigation
| Anchor | ||||
|---|---|---|---|---|
|
1. Log in to
...
Cloudaware account → Admin.
...
Select Admin under your username in the upper right corner.
...
...
2. Find Breeze in the list of DevOps
...
integrations. Click 1Configured.
...
3. Select the installer file based on OS version.
...
Manual Installation
Check the Navigation section to get the Breeze agent installer file.
...
Linux Installation Verification:
1) . Check the cronjob or the systemd timer status:
...
| Code Block |
|---|
systemctl status breeze-agent.timer |
...
Run the agent manually as root-user or using sudo:
| Code Block |
|---|
cd /opt/breeze-agent
./app.sh |
3) Check the log file var/log/breeze-agent.log. It should be used only by the cronjob. When the agent is run manually, the log data will be printed to STDOUT.
Windows
| Anchor | ||||
|---|---|---|---|---|
|
1. Download the agent installer (select Windows Agent version)
...
Windows Installation Verification:
1) . Open the Task Scheduler (Start : Start → Control Panel → Administrative tools → Task Scheduler).
2) . Ensure that the scheduled task Breeze Agent has been created.
3) . Run the job manually. Check the log file C:\Program Files\Breeze\agent.log.
Microsoft Intune
1. Install a Breeze agent on a Windows device.
2. In the file C:\Program Files\Breeze\etc\tags write preferred.descriptor=intune
This step is applicable if the Breeze agent has already been installed on the device.
3. When creating a new web interface deployment, Intune requires an uninstall script. The Breeze uninstall script is shipped as a part of Windows Breeze Installer. When prompted for a path to the uninstall script, specify C:\Program Files\Breeze\uninstall.bat
Automated Installation
Check the Navigation section to get the Breeze agent installer file.
AWS Elastic Beanstalk
You can install Breeze agent on AWS Elastic Beanstalk using .ebextension configuration files. In this example, we will use EB CLI to deploy a new configuration.
1. Upload the Breeze agent installer file to where it is available for your Elastic Beanstalk environment. We recommend using any S3 bucket with restricted access or the one created by Elastic Beanstalk (used in the example below).
2. Create a configuration file in the .ebextension directory that is located in your project directory.
Windows-based environment:
...
Automated Installation
Check the Navigation section to get the Breeze agent installer file.
AWS Elastic Beanstalk
Install Breeze agent on AWS Elastic Beanstalk using .ebextension configuration files. In this example, we use EB CLI to deploy a new configuration.
1. Upload the Breeze agent installer file to where it is available for your Elastic Beanstalk environment. We recommend using any S3 bucket with restricted access or the one created by Elastic Beanstalk (used in the example below).
2. Create a configuration file in the .ebextension directory that is located in your project directory.
Windows-based environment:
| Code Block |
|---|
files:
"C:\\breeze-agent.exe":
source: https://elasticbeanstalk-us-east-1-123456789098.s3.amazonaws.com/breeze-agent.exe
authentication: S3Auth
commands:
install_breeze:
command: IF NOT EXIST "C:\Program Files\Breeze\app.bat" (C:\breeze-agent.exe)
Resources:
AWSEBAutoScalingGroup:
Metadata:
AWS::CloudFormation::Authentication:
S3Auth:
type: "s3"
buckets: ["elasticbeanstalk-us-east-1-123456789098"]
roleName:
"Fn::GetOptionSetting":
Namespace: "aws:autoscaling:launchconfiguration"
OptionName: "IamInstanceProfile"
DefaultValue: "aws-elasticbeanstalk-ec2-role" |
...
| Code Block |
|---|
eb deploy |
AWS EC2 User Data Script
You can install Install Breeze agent on AWS EC2 instances using 'EC2 instance user data' during the initial launch of an instance. The script involves the following steps:
...
2. Unpack the installer (for Linux OSs)
3. Run the installer
Since the installer file is customer-related and may contain vulnerable data, it may be challenging to define a secure location where it will be placed and accessible for EC2 instance. Upload the installer file into the location where it will be publicly available for short duration. In the use case below, we will generate a presigned pre-signed AWS S3 object URL for the S3 bucket storing the installer file.
...
Prepare the user data script and launch the instance
Once agent installers are ready, add the script to EC2 instance user data to install Breeze agent.
Replace the presigned pre-signed URL in the script samples below by the one you generated and insert it into the User data section when launching the instance.
...
AWS Systems Manager Distributor
You can install Install Breeze agent on AWS EC2 instances using AWS Systems Manager Distributor.
...
| Note |
|---|
Ensure that the script files have correct lines line breaks, namely |
...
To install Breeze agent via SCCM, we recommend using use a PowerShell script that will download the agent installer to a target machine and install it.
...
*The saved link should be of in the following format: breeze-agent.XXXXXXXXXXXXXXXXXXXXXXX.cloudaware.20200922.0.x86_64.linux.tgz (for Linux) or breeze-agent.XXXXXXXXXXXXXXXXXXXXXXX.cloudaware.20210707.0.windows.signed.exe (for Windows).Please note that the copied installer link is valid for one hour only.
Save the installer file in a secure location. Ensure the VM can route to that endpoint via HTTP protocol (for example, Azure Storage or an internal file server).
...
| Code Block |
|---|
$url = "AGENT_DISTRO_URL"
[Net.ServicePointManager]::SecurityProtocol += [System.Net.SecurityProtocolType]::Tls12
function Exit-WithError($e, $c) { Write-Host "Error:" $(If ($e.Exception.InnerException) {$e.Exception.InnerException.Message} Else {$e.Exception.Message}); Exit $c }
Write-Host "Downloading..."
$dir_tmp = New-Item -ItemType Directory -Path ([IO.Path]::Combine([System.IO.Path]::GetTempPath(), [System.Guid]::NewGuid()))
$agent_distro = "$dir_tmp\agent.exe"
try { (New-Object System.Net.WebClient).DownloadFile($url, $agent_distro) } catch [System.Net.WebException] { Exit-WithError $_ 1 }
Write-Host "Installing..."
try { Start-Process $agent_distro -ArgumentList '-gm2' -NoNewWindow -Wait } catch { Exit-WithError $_ 2 }
Remove-Item $dir_tmp -Recurse -Force
Write-Host "Done" |
...
"Done" |
More about running scripts on Azure VM here.
Installation to Microsoft Intune
1. Install a Breeze agent on a Windows device (as described here).
2. In the file C:\Program Files\Breeze\etc\tags write preferred.descriptor=intune
This step is also applicable if the Breeze agent has already been installed on the device.
3. When creating a new web interface deployment, Intune requires an uninstall script. The Breeze uninstall script is shipped as a part of Windows Breeze Installer. When prompted for a path to the uninstall script, specify C:\Program Files\Breeze\uninstall.bat
Installation on VM managed by vCenter (deprecated)
...
Since VM ID cannot be used as a unique identifier across multiple vCenter Servers, you should perform additional configuration when installing Breeze on vCenter VMs. Once the agent is installed:
...
| Code Block |
|---|
vmware.vmid=vm-123456 vmware.service.uuid=1111-22-33-44-555555 |
WHERE
vmware.vmid - moRef ID (vm-123456 is a placeholder)
...