Help Docs

Mid-server  

The Site24x7 Mid-server is a lightweight, secure software component that acts as an intermediary between the Site24x7 agents operating within your intranet and the Site24x7 monitoring platform. It supports high availability and enables multiple Mid-servers to work together as a Mid-server Group, ensuring that monitoring continues seamlessly even if one server becomes unavailable.

All Site24x7 agent requests are routed through the Mid-server, which securely forwards them to Site24x7 over the internet. This approach ensures that the agents themselves never require direct internet exposure, thereby reducing security risks.

How it works 

  • The Mid-server receives data and communication requests from Site24x7 agents within your internal network.

  • It securely transmits this information to Site24x7's cloud servers via outbound HTTPS communication channels.

  • The Mid-server is registered to a specific Mid-server Group using the Mid-server Group key provided during installation.

  • Once the installation is complete, it automatically appears under the corresponding Mid-server Group in the web client.

Mid-server Architecture
Note

The Mid-server functions as an HTTP proxy, securely routing all agent traffic to Site24x7 without requiring direct internet access for the agents.

System requirements

The machine on which the Mid-server will be installed should meet the following requirements:

RAM 8GB of physical memory
(A minimum of 4GB of memory is required apart from the memory consumed by the OS and other processes)
Processor/Virtual processor 4 processors/8 virtual processors
Processor speed 2GHz or above
Disk space 20GB or higher
OS Windows or Linux
OS type 64-bit
Note
  1. The default port 3128 is opened automatically on the machine during installation. You can modify this port in the Mid-server configuration to use a custom port if required.

  2. The Mid-server needs to be started with root or administrator privileges after installation, depending on whether the machine's OS is Linux or Windows.

  3. At least one Mid-server should be associated with the Mid-server Group to allow this Mid-server feature work.

  4. While both Windows and Linux-based installations are supported, we recommend installing the Mid-server on a Linux-based system.

Install a Mid-server

  1. Log in to Site24x7.
  2. Navigate to Admin > Mid-server Group.
    Depending on the current state of the Mid-server Group, you may encounter one of the following scenarios:
    • Mid-server Group with existing Mid-servers: The group already contains one or more Mid-servers. You can add a Mid-server directly by clicking the existing Mid-server Group. Then, navigate to the Mid Server tab. Next, click the Add Mid Server button on the top-right of the table and follow the subsequent installation steps from step 3. 
    • Mid-server Group with no Mid-servers: The group is currently empty, indicating that no Mid-servers have been associated with it yet. 
      • Click the Mid-server Group and follow the below guided steps to add a Mid-server for Linux or Windows.
      • Using the Mid-server Group Key, you can associate each Mid-server with a respective group during installation. You can also install a new Mid-server and associate it with a group using the Mid-server Group Key.
  3. Toggle between Windows and Linux in the Select Platform field to start the platform-based installation.

Installing a Mid-server on a Windows machine

  1. Click the 64-bit to start downloading the Mid-server installer.
  2. Run the installer and follow the on-screen instructions.
  3. When prompted, copy and paste the Device Key from the Add Mid Server page (unique to your installation instance). You can view the device key by clicking Show Device Key.
  4. Choose Mid-server as the resource type on the Site24x7 On-Premise Poller pop-up page. 
  5. Next, open Notepad as an Administrator and paste the following content into the file. Then, save the file as resource.config inside the conf folder under the On-Premise Poller installation directory. When saving the resource.config file, change the file type to All Files instead of .txt.
    RESOURCE_TYPE=MID_SERVER
    MID_SERVER_GROUP_KEY=<mid-server-group-key>
    MID_SERVER_PORT=3128
    Note

    Mid Server uses port 3128 by default. You may change the port if needed.

Installing a Mid-server on a Linux machine

  1. Run the following commands in your terminal:
    sudo wget https://staticdownloads.site24x7.com/probe/Site24x7OnPremisePoller_64bit.bin
    sudo chmod 755 Site24x7OnPremisePoller_64bit.bin
    sudo ./Site24x7OnPremisePoller_64bit.bin
  2. Run the installer and follow the on-screen instructions.
  3. When prompted, copy and paste the Device Key from the Add Mid-server page (unique to your installation instance). You can view the device key by clicking Show Device Key.
  4. Create a file named resource.config inside the conf folder in the directory where the On-Premise Poller is installed. Paste the following code and save the file.
    RESOURCE_TYPE=MID_SERVER
    MID_SERVER_GROUP_KEY=<mid-server-group-key>
    MID_SERVER_PORT=3128

Verify the installed Mid-server

After installation, the Mid-server connects automatically and is listed in Site24x7 under Admin > Mid-server > Mid-server.

Verify Mid-server

It will also be listed under the assigned group. To view this, navigate to Admin > Mid-server > Mid-server Group. Select the desired Mid-server Group, then click the Mid-servers tab to view all associated Mid-servers.

Verify Mid-server group

Adding a Mid-server

After creating a Mid-server group, proceed with the following steps:

  1. Log in to your Site24x7 account.
  2. Click Admin > Mid-server > Mid-server Group.
  3. Select any one of the created Mid-server Groups.
    1. If Mid-servers already exist in that group, you can add one by clicking the Add Mid Server button in the top-right corner of the page.
    2. If the group has no Mid-servers, click No. of Mid-servers: 0 to begin the installation process and add your first Mid-server. 
  4. Verify the installed Mid-server.
    Add Mid-server

Edit a Mid-server

To edit the existing Mid-server, follow the steps:

  1. Go to Admin > Mid-server Group > Mid-server
    1. Alternatively, you can go to Admin > Mid-server Group > Choose any one of the Mid-server Groups > Select the Mid-servers tab.
  2. Choose the Mid-server that you want to edit, then click the hamburger icon Hamburger icon and click Edit.
  3. Change the necessary details to edit the Mid-server
    1. Display Name: Provide a display name to identify the Mid-server
    2. Host Name: Displays the domain name for the Mid-server host
    3. IP Address: Displays the IP address for the Mid-server
    4. Mid-server Details: Displays the technical details of the Mid-server, such as the OS, architecture, and kernel version
    5. Version: Displays the software version of the Mid-server
  4. Specify the details for Configuration Profiles:
    1. Threshold and Availability: Select the threshold profile to be associated with the server monitor. A threshold profile contains the list of all thresholds and the alert type (i.e., Critical, Trouble, or Down) that will be triggered when these thresholds are breached.
      • Click the pencil icon pencil icon  to edit the selected threshold profile and the plus icon + to create a new threshold profile.
    2. Tags: Associate your monitor with predefined tags to help organize and manage your monitors creatively. Learn how to add Tags.
  5. Specify the details for Alert Settings:
    1. User Alert Group: Select the user group that needs to be alerted during an outage. To add multiple users to a group, see User Alert Groups.
    2. On-Call Schedule: Choose an On-Call Schedule from the drop-down menu to stay updated via notifications in case of any incident or outage. Learn how to use an On-Call Schedule.
    3. Notification Profile: Choose a Notification Profile from the drop-down menu or select the default profile available. A Notification Profile helps to configure when and who gets notified in case of downtime. Refer to Notification Profiles to create a customized Notification Profile.
    4. Click Save.
      Edit Mid-server

Once you have updated the above steps, your Mid-server will be configured according to the specific thresholds, availability settings, and other relevant details defined within the dedicated Mid-server Group, ensuring optimal performance and reliability. 

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!