| Table of Contents | ||
|---|---|---|
|
Manual
Linux
1. Download the agent installer (Admin - Breeze - SHOW INFO - Linux Agent) to the temporary directory.
2. Unpack the archive:
| Code Block |
|---|
tar xvzf breeze-agent*.tgz |
3. Enter unpacked directory:
| Code Block |
|---|
cd breeze-agent |
Run installation script:
as root-user:
...
|
Linux Installation Verification:
Check the cronjob:
|
...
Breeze Agent will be automatically installed into the system.
Windows Installation Verification:
Open the Task Scheduler (Start → Control Panel → Administrative tools → Task Scheduler) and check that the scheduled task called Breeze Agent has been created.Run the job manually.Check the log-file C:\Program Files\Breeze\agent.log.
...
Installing the Breeze Agent on AWS Elastic Beanstalk can be done using .ebextension configuration files. In this example, we will use EB CLI to deploy new configuration.
1. Upload Breeze Agent installer file somewhere your ElasticBeanstalk environment can reach. We recommend using any S3 bucket with restricted access or the one created by Elastic Beanstalk (used in the example below).
2. Create 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" |
Linux-based environment:
| Code Block |
|---|
files:
"/tmp/breeze-agent.tgz":
source: https://elasticbeanstalk-us-east-1-123456789098.s3.amazonaws.com/breeze-agent.tgz
authentication: S3Auth
commands:
"install breeze agent":
test: test ! -d /opt/breeze-agent
command: tar -xf /tmp/breeze-agent.tgz -C /tmp && /tmp/breeze-agent/install.sh
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" |
| Info |
|---|
This configuration file contains 3 sections: Files, Commands and Resources (AWS). The Files section delivers Breeze Agent installer to the instance from S3 bucket. The Commands section installs the Breeze Agent. The Resources section creates an authentication role that allows access to the bucket with Breeze Agent installers to the Elastic Beanstalk. For more configuration options see AWS documentation. |
...
Download the Breeze Agent installer to any location where it can be downloaded by the target machine. In our example, we will use a shared folder with permission for account that set as Client Push Installation account for SCCM Site.
1. Create a new script in Software Library using the sample below.
2. Change the $url variable to your Breeze Agent installer location.
3. Make sure that target systems have access to the installer’s location.
4. Run the script on system or group to install Breeze Agent.
Script sample:
| Code Block |
|---|
function New-TemporaryDirectory {
$parent = [System.IO.Path]::GetTempPath()
[string]$name = [System.Guid]::NewGuid()
New-Item -ItemType Directory -Path (Join-Path $parent $name)
}
$url = "\\10.0.0.69\d\breeze-agent.exe"
$tmp_dir = New-TemporaryDirectory
$agent_sfx = "$tmp_dir\breeze-agent.exe"
# download agent installer
(New-Object System.Net.WebClient).DownloadFile($url, $agent_sfx)
# install agent
Start-Process $agent_sfx -ArgumentList '-gm2' -NoNewWindow -Wait
# clean up
Remove-Item "$tmp_dir" -recurse |
...
Once agent installers are ready, add the script to EC2 instance user data to install Breeze Agent. Replace the presigned URL in the script by the one you generated and insert it into the User data section when launching the instance.
Linux:
| Code Block |
|---|
#!/bin/bash
URL='<presigned URL to agent installer in your S3 bucket>'
# download agent installer
curl $URL -o /tmp/breeze-agent.tgz
# unpack agent installer
sudo tar -xf /tmp/breeze-agent.tgz -C /tmp
# install agent
sudo /tmp/breeze-agent/install.sh
|
Windows:
| Code Block |
|---|
<powershell>
function New-TemporaryDirectory {
$parent = [System.IO.Path]::GetTempPath()
[string]$name = [System.Guid]::NewGuid()
New-Item -ItemType Directory -Path (Join-Path $parent $name)
}
$url = "<presigned URL to agent installer in your S3 bucket>"
$tmp_dir = New-TemporaryDirectory
$agent_sfx = "$tmp_dir\breeze-agent.exe"
# download agent installer
(New-Object System.Net.WebClient).DownloadFile($url, $agent_sfx)
# install agent
Start-Process $agent_sfx -ArgumentList '-gm2' -NoNewWindow -Wait
# clean up
Remove-Item "$tmp_dir" -recurse
</powershell>
|
...