Running the Radar Agent as a Service or Daemon

Running a Radar Agent as a Linux Daemon

For Linux, there are two approaches we recommend to make sure the Radar agent keeps running on your server, in case any failures makes its process stop:

• Use the nohup command to run the agent:

  nohup ./runscope-radar -f radar.conf

• Use the GNU Screen utility.

  For more information about how to use the GNU Screen utility, see the Linux screen Command: Keep Processes Running Despite a Dropped Connection (howtoforge.com) article, and this Running commands on Putty without fear of losing connection (superuser.com) thread.

Running a Radar Agent as a Windows Service

Download the Radar and configure the Radar agent. For more information, see Radar Agent Overview. To run the radar agent as a Windows service, use the NSSM utility.

In this example the radar agent executable and config file are stored in the c:\radar folder. Be ready to provide the path to your local installation.

1. Download NSSM from https://nssm.cc/download and extract it to a folder, for example, C:\nssm.

2. Install the service using one of the following methods:

   • Install the Service from the Command Line:

     Run this command to install the service. Provide your paths to the agent and its config.

     nssm install RadarService "C:\path\to\runscope-radar.exe" -f "C:\path\to\radar.conf"

   • Install the service using a GUI:

     1. Run this command to open the installer dialog:

        nssm.exe install RadarService

     2. On the Application tab, enter your paths to the agent and its configuration:

        Path  = C:\path\to\runscope-radar.exe
        Startup Directory = c:\radar
        Argument = -f C:\path\to\radar.conf --logfile=c:\radar\agent.log

     3. On the Details Tab, enter a description of the agent being deployed. Enter the Bucket / Team and so on, and the Display Name required.
     4. You can leave the other settings as defaults.
     5. Press Install Service to create the service.
3. Start the service.