Help Docs

Associate Configuration Profiles to Server Monitor during Agent Installation

Configuration profiles include adding threshold, notification, resource check profiles, and display name(s) to the server monitors. The association of these profiles can be done:

During the Installation of the Agent via Command Line Arguments:

  1. Log in to Site24x7 and go to Server > Server Monitor > Servers (+) > Windows/Linux. For Windows, download and install the agent in the location of your choice. For Linux, execute the commands given in Step 2 under Linux - One-step Installation.
  2. Open command prompt as administrator and execute the following commands based on your OS type:
    Windows: Once the Windows agent is downloaded, go to the path where the file is present and then execute the following command: 
    msiexec.exe /i Site24x7WindowsAgent.msi EDITA1= ENABLESILENT=YES REBOOT=ReallySuppress DN= TP= RP= NP= GN= RULE= /qn

    Example:
    msiexec.exe /i Site24x7WindowsAgent.msi EDITA1=DeviceKeyHerefhgh ENABLESILENT=YES REBOOT=ReallySuppress DN="Windows Monitor" TP="sample Server" RP="oneMin" NP="Notification 1" GN="sample group" RULE="production servers" /qn

    Linux:
    wget https://staticdownloads.site24x7.com/server/Site24x7InstallScript.sh 
    bash Site24x7InstallScript.sh -i -key= -dn= -gn= -tp= -np= -rule=


    Example:
    bash Site24x7InstallScript.sh -i -key=DeviceKeyHere -dn=test_server -gn=aws -tp=profile1 -np=profile2 -rule="production servers"

    Alternative Method:
    wget https://staticdownloads.site24x7.com/server/Site24x7_Linux_64bit.install
    ./Site24x7_Linux_64bit.install -i -key= -dn=test_server -gn=aws -tp=profile1 -np=profile2

    Docker: For proxy, use the same -e option followed by the proxy key and value.
     
    docker run -d --name site24x7-agent \
    -v /var/run/docker.sock:/var/run/docker.sock:ro \
    -v /proc/:/host/proc/:ro \
    -v /sys:/host/sys/:ro \
    -e key= \
    -e ct= \
    -e tp=\
    -e rule=\ 
    site24x7/docker-agent:latest

    Parameters to be used in the above commands Description
    Windows Linux & Docker
    EDITA1 key Device key of your Site24x7 account
    RULE rule Configuration rule to be applied to the server monitor
    CT ct Configuration template to be associated with the server (deprecated)
    DN dn Display name of the server
    GN gn Group to which the server has to be added. Refer to the example format to associate with multiple groups. Example: -GN="Group1,Group2"
    TP tp Threshold profile to be associated with the server
    NP np Notification profile to be associated with the server
    RP rp Resource check profile to be associated with the server
    AUTOMATION=true automation=true Enable IT Automation. By default, IT Automation capabilities will be disabled.
    PLUGINS=false plugins=false Disable Plugins
    RESOURCE_CHECKS=false resource_checks=false Disable resource checks
    APPLICATIONS=false applications=false Disable application discovery
    MANAGEMENT_ACTIONS=false management_actions=false Disable start, stop, and restart actions
    SERVICE=false process=false Disable monitoring of services in Windows and processes in Linux
    ENABLEPROXY proxy Set proxy to connect to the Site24x7 servers. For Linux servers, refer our Knowledge Base document to configure proxy settings.
    PROXYSERVERNAME Proxy server name with port link :
    PROXYUSERNAME Proxy user name (if applicable)
    PROXYPASSWORD proxy password (if applicable)
    f Force install the agent even if there is an agent installed already
    lp Enable log profile
    lt AppLog type to be associated with the server. For example: -lt=syslog
    lf Applog files to be collected for the specified log type. For example: -lf=/var/log/syslog
    nk Create a monitor for cloned server
    da Install the agent as docker agent
    TAGS tags Associate tags to the monitor. Refer to the example format to specify multiple tags. Example: -tags=tag_name: (or) -tags=tag_name:,tag2_name:
    gid Create Site24x7 agent group with specific group ID
    uid Create Site24x7 agent group with a specific user ID
    prometheus Integrate Prometheus. Learn more about Prometheus integration in our Prometheus integration help document.
    statsd Integrate StatsD. Learn more about StatsD integration in our StatsD integration setup help document.
    init_system Manually specify the service manager as either systemd/sysvinit
    HEARTBEAT heartbeat=true/false Enable/Disable heartbeat check
    dc=true/false Enable/Disable data collection
    s24x7-agent Install agent as root and run as non root
    nr Install agent as non root
    ns Disable syslog monitoring
    ri Re-install the agent with the same configuration
    u Uninstall the agent
    CPU_LIMIT cpu_limit= Set the maximum CPU utilization the agent can consume (in percentage).
    MEM_LIMIT mem_limit= Set the maximum memory the agent can consume (in megabytes).
    For third party integrations like Slack, PagerDuty, add them to a configuration rule and then apply the configuration rule (RULE/rule) to a server monitor during command line installation.
    Note

    When entering the optional parameters, spaces in between names should be enclosed in quotes. For Windows, use double quotes and for Linux, you can use either single or double quotes.

  3. Go to Server > Server Monitor > Servers to view the newly added monitor(s).

For Windows, the configuration profiles for the installed agent can be found in the Site24x7WindowsAgent registry under HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\ManageEngine\Site24x7WindowsAgent\ServerProfileConfig. For Linux, the configuration profiles for the installed agent can be found in the monagent.cfg file under /opt/site24x7/monagent/conf.

Note

Any change to the existing configuration profiles cannot be made via command line arguments. You can make changes to the profile by going to the Edit Server Monitor page of the respective server monitor (Server > Server Monitor > Servers > click on the server monitor > hover on the hamburger icon beside the display name > Edit > Edit Server Monitor > Configuration Profiles > make the edits and Save the changes).

During Remote Installation of Linux Servers using SSH:

This is a bulk installation method to install multiple Linux servers in one go.

  1. Log in to Site24x7 and go to Server > Server Monitor > Servers (+) > Bulk Install > Linux Bulk Installation Methods > Remote Installation using SSH.
  2. Copy, paste, and execute the command given in the Site24x7 web client:
    wget https://staticdownloads.site24x7.com/server/Site24x7remoteinstaller.sh
    bash Site24x7remoteinstaller.sh -i -automation=true -key=
  3. Associate configuration profile(s) by appending one or more of the following parameters to the above command:
    Parameters Description
    rule Configuration rule to be associated with the server
    ct Configuration template to be associated with the server (deprecated)
    gn Group to which the server has to be added
    tp Threshold profile to be associated with the server
    np Notification profile to be associated with the server
    rp Resource check profile to be associated with the server
    For example, associate a configuration rule (rule) to the command given in Step 2 as follows:
    sudo -E bash -c "$(curl -sL https://staticdownloads.site24x7.com/server/Site24x7remoteinstaller.sh)" readlink -i -key= -rule=
    The configuration rule will be associated to all the Linux server monitors installed.

While Adding VM Extensions via Azure Command Line Interface (CLI):

This is available only for Linux servers.

  1. Log in to Site24x7 and go to Server > Server Monitor > Servers (+) > Bulk Install > Linux Bulk Installation Methods > Azure.
  2. Append the following parameters to the command given under Step 2 in the web client and execute the command.
    Parameters Description
    rule Configuration rule to be associated with the server
    ct Configuration template to be associated with the server (deprecated)
    gn Group to which the server has to be added
    tp Threshold profile to be associated with the server
    np Notification profile to be associated with the server
    rp Resource Profile to be associated with the server
    For example, associate a configuration rule (rule) to the command given in the web client as follows:
    azure vm extension set -g  --vm-name  --version 1.5 --publisher-name Site24x7 -n Site24x7LinuxServerExtn --private-config "{\"site24x7LicenseKey\":\"ab_9868f27c8a45b2fc76088c8ecec7bd7305f59661\"}" --public-config "{\"site24x7AgentType\":\"azurevmextnlinuxserver\", \"rule\":\"\"}"
  3. To associate proxy, append the parameter \"proxy\":\"user:password@proxyhost:proxyport\" to the above command as follows:
    azure vm extension set -g  --vm-name  --version 1.5 --publisher-name Site24x7 -n Site24x7LinuxServerExtn --private-config "{\"site24x7LicenseKey\":\"ab_9868f27c8a45b2fc76088c8ecec7bd7305f59661\"}" --public-config "{\"site24x7AgentType\":\"azurevmextnlinuxserver\", \"proxy\":\"user:password@proxyhost:proxyport\"}"
    The configuration rule will be associated to the Linux server monitors installed.

 

Related Articles

Was this document helpful?

Would you like to help us improve our documents? Tell us what you think we could do better.


We're sorry to hear that you're not satisfied with the document. We'd love to learn what we could do to improve the experience.


Thanks for taking the time to share your feedback. We'll use your feedback to improve our online help resources.

Shortlink has been copied!