Docs » Integrations Guide » Use the Smart Agent » Install and configure the Smart Agent » Install to Windows using a ZIP file

Install to Windows using a ZIP file ๐Ÿ”—

Install the SignalFx Smart Agent to a Windows host using a standalone package in a ZIP file.

Prerequisites ๐Ÿ”—

  • Windows Server 2012 or higher
  • Windows PowerShell access
  • Windows decompression application, such as WinZip or the native Windows decompression feature.
  • .NET Framework 3.5 or higher
  • Visual C++ compiler for Python
  • TLS 1.0 or 1.2
  • Administrator account in which to run the Smart Agent

If you want to invoke a Python script for non-default monitors such as exec, you must have Python 3 installed. The ZIP file includes the Python 3.8.0 runtime.

Install using a ZIP file ๐Ÿ”—

  1. Remove collector services such as collectd

  2. To get the latest Windows standalone installation package, navigate to Smart Agent releases and download the following file:

    signalfx-agent-<latest_version>-win64.zip
    

    For example, if the latest version is 5.1.6, follow these steps:

    1. In the releases section, find the section called v5.1.6.
    2. In the Assets section, click signalfx-agent-5.1.6-win64.zip
    3. The ZIP file starts downloading.
  3. Uncompress the ZIP file. The package contents expand into the signalfx-agent directory.

Configure the ZIP file installation ๐Ÿ”—

Navigate to the signalfx-agent directory, then create a configuration file for the agent:

  1. In a text editor, create a new file called signalfx-agent\agent-config.yml.

  2. In the file, add your hostname and port number:

    internalStatusHost: <local_hostname>
    internalStatusPort: <local_port>
    
  3. Save the file.

The Smart Agent collects metrics based on the settings in agent-config.yml. The internalStatusHost and internalStatusPort properties specify the host and port number of the host thatโ€™s running the Smart Agent.

Start the Smart Agent ๐Ÿ”—

To run the Smart Agent as a Windows program, run the following command in a console window:

SignalFxAgent\bin\signalfx-agent.exe -config SignalFxAgent\agent-config.yml > <log_file>`
The default log output for Smart Agent goes to STDOUT and STDERR. To persist log output, direct the log output to <log_file>.

To install the Smart Agent as a Windows service, run the following command in a console window:

SignalFxAgent\bin\signalfx-agent.exe -service "install" -logEvents -config SignalFxAgent\agent-config.yml

To start the Smart Agent as a Windows service, run the following command in a console window:

SignalFxAgent\bin\signalfx-agent.exe -service "start"

To learn about other Windows service options, see Service Configuration.

Verify the Smart Agent ๐Ÿ”—

To verify your installation and configuration, perform these steps:

  • For infrastructure monitoring, perform these steps:

    1. In SignalFx, open the Infrastructure built-in dashboard
    2. In the override bar, select Choose a host. Select one of your hosts from the dropdown list.

    The charts display metrics from your infrastructure.

    To learn more, see Built-In Dashboards and Charts.

  • For Kubernetes monitoring, perform these steps:

    1. In SignalFx, from the main menu select Infrastructure > Kubernetes Navigator > Cluster map.
    2. In the cluster display, find the cluster you installed.
    3. Click the magnification icon to view the nodes in the cluster.

    The detail pane on the right hand side of the page displays details of your cluster and nodes.

    To learn more, see Getting Around the Kubernetes Navigator

  • For APM monitoring, learn how to install, configure, and verify the Smart Agent for Microservices APM (ยตAPM). See Get started with SignalFx ยตAPM.