Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

At a high level, to complete the installation process: 

Table of Contents

Tip
titleBefore you begin

Review the Requirements section before you begin the installation process.

Step 1: Locate the Armor Agent

  1. In the Armor user interface, on the left-side navigation, click Infrastructure
  2. Click Add Core
  3. Click your operating system (Amazon Linux, CentOS, and Redhat). 
  4. Locate and copy your license key. You will need this key later in the installation process. 
  5. Download and execute the armor-agent.deb file. 

Step 2: Download and install the Armor Agent

  1. Run the following command: 

    Code Block
    themeMidnight
    languagebash
    titleInstall Agent
    yum install armor-agent.rpm
  2. Modify the configuration file at /etc/armor/armor.config to use your license key. Use the following script as an example: 

    Code Block
    themeMidnight
    languagebash
    titleConfigure Agent
    sed -i -r 's/license=<license key>/' /etc/armor/armor.cfg
  3. Run the following command: 

    Code Block
    themeMidnight
    languagebash
    titleStart Agent
    service armor-agent start

Step 3: Validate the Core

Expand
titleInstall Output and Logs

A successful install will have the following output.

Code Block
themeMidnight
languagebash
titleSample Output
Selecting previously unselected package armor-agent. (Reading database ... 179956 files and directories currently installed.) Preparing to unpack armor-agent.deb ... Unpacking armor-agent (0.9.0.5) ... Setting up armor-agent (0.9.0.5) ... ===================================================================== The Armor Agent has been installed. You will need to register it by placing the license key provided by Armor into the configuration file located in /etc/armor/armor.cfg and starting the armor-agent service. ===================================================================== Processing triggers for ureadahead (0.100.0-16) ... * Starting Armor Defense Agent armor-agent started

After the Armor agent has completed installation, its sub-services will install after the first heartbeat completes. You can follow the armor.log to view the status.

Code Block
themeMidnight
languagebash
tail -f /var/log/armor.log

The logs for a completed agent install will look similar to:

Code Block
themeMidnight
languagebash
titleSample Output
PS C:\Users\Administrator> cat C:\.armor\log\armor.log time="Jan 13 21:19:22" level=info msg="Provider Found" key= provider=Azure time="Jan 13 21:19:22" level=info msg="OS Found" distro=Windows time="Jan 13 21:19:22" level=info msg="Registering Armor Core agent" time="Jan 13 21:19:26" level=info msg="Initial registration complete. Begin adding Armor..." time="Jan 13 21:19:26" level=info msg="Applying Armor Server Hardening" time="Jan 13 21:19:26" level=info msg="Installing Armor Anti-Virus support" time="Jan 13 21:19:45" level=info msg="Installing Armor Logging support" time="Jan 13 21:19:49" level=info msg="Installing Logging Certificate" time="Jan 13 21:19:49" level=info msg="Installing Armor Monitoring support" time="Jan 13 21:19:55" level=info msg="Validating Hash..." time="Jan 13 21:19:55" level=info msg="Hash validated"
Note

This topic only applies to users who run:

  • Windows 2012 Datacenter
  • Windows 2012 R2 Standard
  • Windows 2012 Standard
  • Windows 2016 Full Desktop
Note

Before you begin, Armor recommends that you review the pre-installation information, including firewall rules. To learn more, see ANYWHERE Pre-Installation.

Note

For Windows 2012 users, when you install the Armor Agent, the corresponding Trend Micro agent may cause your system to reboot. Trend Micro is currently researching this issue.

Warning

Before you install the Armor Anywhere agent, you must remove any previously installed anti-virus software, such as Trend Micro, McAfee, etc. Afterwards, you must reboot your system. 


Step 1: Locate the Armor Anywhere agent

Excerpt Include
ESLP:Locate the Armor Agent (snippets)
ESLP:Locate the Armor Agent (snippets)
nopaneltrue
 

Note

For Amazon Web Services users who:

  • Use Elastic Beanstalk to run their instance's applications, and
  • Run Windows 2012 R2,

Review the following example to understand how to install the Anywhere agent. Afterwards, you can skip to the Test your connection step.

Code Block
themeMidnight
files:
  "c:\\Windows\\Temp\\armor-setup.exe":
    source: https://get.core.armor.com/latest/armor-setup.exe
commands:
  armoragentinstall:
    test: if not exist 'c:\\.armor\\opt\\armor.exe' exit 0
    command: c:\\Windows\\Temp\\armor-setup.exe /verysilent /license=AAAA1-A11AA-AA1AA-AAAAA-1AAAA
    ignoreErrors: false
    waitAfterCompletion: 5
Tip

You must replace AAAA1-A11AA-AA1AA-AAAAA-1AAA with your specific license key.


Step 2: Download and install the Armor Anywhere agent

There are three types of scripts that you can use to install the agent. 

Script type

Description

Pre-Installation

You can use these scripts to verify that your environment is compatible with Armor Anywhere. These scripts will not install the agent.

Code Block
themeMidnight
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; Invoke-WebRequest https://get.core.armor.com/latest/armor_agent.ps1 -outfile armor_agent.ps1 ; .\armor_agent.ps1
Pre-Installation and Installation

You can use these scripts to:

  • Verify that your environment is compatible with Armor Anywhere
  • Install the agent
Code Block
themeMidnight
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; Invoke-WebRequest https://get.core.armor.com/latest/armor_agent.ps1 -outfile armor_agent.ps1 ; .\armor_agent.ps1 -license AAAA1-A11AA-AA1AA-AAAAA-1AAA
Installation

You can use these scripts to install the agent. These scripts will not verify your environment for compatibility. 

Code Block
themeMidnight
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; Invoke-WebRequest https://get.core.armor.com/latest/armor_agent.ps1 -outfile armor_agent.ps1 ; .\armor_agent.ps1 -license AAAA1-A11AA-AA1AA-AAAAA-1AAA -silent


Step 3: Test your connection

After you install the agent, Armor recommends that you test the connection for each configured firewall rule.

To verify connectivity to an Armor service endpoint, use the telnet command.

Tip

The following example tests connectivity to api.armor.com over 443/tcp:

Code Block
themeMidnight
telnet 146.88.106.210 443


For Windows systems without the telnet feature installed, you can also use PowerShell:

Code Block
themeMidnight
new-object System.Net.Sockets.TcpClient('146.88.106.210', 443)
Info

Include Page
ESLP:Update Armor Agent configuration file (snippet)
ESLP:Update Armor Agent configuration file (snippet)


Step 4: Review the status of the Armor Anywhere agent 

Excerpt Include
ESLP:Review the server status (snippet)
ESLP:Review the server status (snippet)
nopaneltrue




Was this helpful?
Rate Macro

Scrolltotop