This guide will walk you through the initial installation and configuration of your Stackify monitoring agent.
If you haven't already reviewed it, please look at the previous lesson, Installation Overview, to get your environment ready for installation.
To get the agent downloaded on a server, navigate to the Servers page.
Once on the Servers page, click on the "Add Servers" button to bring up the installation options.
IF you are only wanting to install the agent for basic monitoring (non-APM+), select the Windows option. From there, simply follow the directions within the page.
Note: If you are wanting to install the agent with APM+ enabled, or enable APM+ on an existing monitored server, click here.
Stackify Monitoring Agent Installer
After downloading the Monitoring Agent installer, just run the installer on each machine to be monitored. The installer for our monitoring agent is straightforward - just follow the prompts.
You will be prompted for an Activation Key. This key identifies your server as belonging to your company. You can access your Activation Key with your login to our site.
Finding Your Activation Key
If you forgot to copy your activation key when you downloaded the installer, you can find your Activation Key at any time on the Client Info page under the Settings tab. Copy and paste this key into the Activation Key field in the installer.
For each server, you will be prompted to set the Environment. This is a way of grouping your servers; Stackify gives you the opportunity to set this parameter at install time so that each server is grouped with like servers based on deployment strategies, physical location, client, or whatever makes sense for your particular scenario.
To make sure all is working properly, simply to go the Monitoring link and view the Servers page to verify that your new server has appeared. Usually within 5-10 minutes (often sooner) the Stackify Agent will complete its initial discovery process and start streaming information found to the dashboard.
1. First, uninstall the Stackify service via Control Panel -> Uninstall a program.
2. Delete the folder that was created on installation (typically C:\Program Files (x86)\Stackify).
3. Remove the Stackify user that was created either on the local machine or on your Domain, depending on your choices during your previous installation. This user is no longer necessary for the Stackify Monitoring Agent.
Performing a Silent Install
To perform a silent install of the Stackify agent, run the following in the Command Prompt in the directory that you installed the agent:
"Stackify Version#.exe" /s /v"ACTIVATIONKEY=activationkey ENVIRONMENT=\"environment\" /qn /l*v .\Log.txt"
You will need to specify the installer version number, ACTIVATIONKEY and ENVIRONMENT parameters with your information.
Note: The \" escapes are only necessary if the environment name has a space or special characters in it.
Note: The /l is optional. This will create a log file of the installation called Log.txt.
You can perform a silent "uninstall" in a similar way as the installation script above, this time with an argument of /x (the standard MSI argument) to uninstall:
"Stackify Version#.exe" /x
Note: If the agent is still on the same version used from original install, just execute that same package again from wherever you saved it.
Note: If the agent has been auto-updated, you will want to execute this from the file found in "Program Files (x86)\Stackify\AgentExeStaging".
Silent Install with APM+ Disabled
If you want to silently install without enabling the CLR profiler for APM+ add the ENABLEPROFILER parameter and set it to 0. It would look like this in the Command Line:
"Stackify Version#.exe" /s /v"ACTIVATIONKEY=activationkey ENVIRONMENT=\"environment\" ENABLEPROFILER=0 /qn /l*v .\Log.txt"
Note: If you disable APM+ during the installation, this setting will still be honored after updates of the agent.
If you are using a configuration management tool such as Puppet or Chef, you will not want to automate the install of a specific version. Instead you can use the Powershell script below to download the most recent version and then install it.
$storagedir = $pwd $webclient = New-Object System.Net.WebClient $url = "https://s1.stackify.com/account/agentdownload/index" $file = "$storagedir\StackifyInstall.exe" $webclient.DownloadFile($url,$file) & $file /s /v"ACTIVATIONKEY=your_Activation_key ENVIRONMENT=\`"Put your environment here\`" ENABLEPROFILER=0 /qn /l*v .\Log.txt"
Save this as a .ps1 file and you can execute it by running it manually in the directory where the .ps1 file is located:
Or you can have a runbook execute it.