---
sourceDocument: Yokohama ServiceNow AI Platform Capabilities
sourceDocumentLink: https://www.servicenow.com/docs/r/yokohama/servicenow-platform

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama ServiceNow AI Platform Capabilities

ft:clusterId :

    - platcap

bundleId :

    - platcap

workflow :

    - Platform


---

# Pause the MID Server

# Pause the MID Server {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read

Pause the MID Server to temporarily prevent it from polling the ECC
Queue for work or sending Discovery results back to the instance.

## Before you begin

Role required: agent_admin

|-|
|   |
[ ]

{#t_PauseTheMIDServer__table_uh4_bsf_khb}

## About this task

You can only pause [validated MID
Servers](https://www.servicenow.com/docs/7CRK9lFekoxJY4fHjsqvJw "You must manually validate the MID Server after it is installed to enable it to execute automation tasks. You can invalidate a MID Server you suspect has been compromised to prevent it from accessing automation credentials in the instance or executing outbound ECC probes."). You might want to pause the MID Server when your network
infrastructure is undergoing changes. This prevents applications like Discovery from
throwing errors during a particular maintenance window.  
A paused MID Server continues processing commands that it had already retrieved before it was paused. When you resume the MID Server, the MID Server starts retrieving new commands to process.  
Note:  
Discovery continues to assign jobs to MID Servers that are Paused. MID Servers that are Down are not assigned jobs.

## Procedure

1. Open the MID Server record.
2. Select a running MID Server that has been validated.
3. On the MID Server form, select Pause MID under Related Links.  
   The state of the MID Server changes to Paused.  
   Figure 1. A paused MID Server
4. To resume MID Server processing, select Resume MID under Related Links.
**Related concepts**   

* [MID Server upgrades](https://www.servicenow.com/docs/0fmzqDHt0iEzymIrRBjJUA "Upgrade MID Servers manually, or automatically through the instance. MID Server automatic upgrade is triggered when the instance upgrades and the MID Server no longer has the same version. The new MID Server package is downloaded from install.service-now.com, replaces the old one, and the MID Server starts with the new version.")
* [MID Server dashboard](https://www.servicenow.com/docs/CTke3Lqzsh8kfktMWhKK8A "The MID Server dashboard is a central place for MID Server users to monitor ongoing operations. The dashboard consists of reports and gauges that display information from the MID Server Status table.")
* [MID Server File Cleaner](https://www.servicenow.com/docs/UOs_PAj0ZzeS_1dGYhQ26A "A monitor thread runs in the MID Server to clean up old files, to keep the size and quantity of files within the install folder manageable, and to prevent performance issues with the MID Servers.")
* [MID Server privileged commands](https://www.servicenow.com/docs/jHZdSShGx_wDoFToSvoktw#c_PrivilegedCommandsForMIDServer "To discover certain information on a host server, the MID Server must run SSH commands with higher privileges. The platform provides default privileged commands for the MID Server to use and the ability to add additional commands to the system.")  
**Related tasks**   

* [Manually start, stop, and restart a MID Server](https://www.servicenow.com/docs/IYs5fBPqVEOuqstZJckkXw "If you did not start the MID Server at the end of the installation procedure, you can manually start the MID Server.")
* [Set the MID Server JVM memory size](https://www.servicenow.com/docs/KrWcjHIVVy4FOFmLc1ipGA "The MID Server starts with a default JVM memory allocation, but you can modify this setting in the configuration file.")  
**Related reference**   

* [MID Server system requirements](https://www.servicenow.com/docs/4j~DXw_Cfdj1uyhyC10Muw "Use these minimum system requirements to allocate resources for computers hosting MID Servers.")
* [Resolving MID Server issues](https://www.servicenow.com/docs/2mQkw_AXv_5F5KtFiT9UwA "Troubleshoot problems with the MID Server to find solutions. Monitor the MID Server to receive alerts about issues as they occur. Troubleshooting procedures exist to resolve specific problems with the MID Server. The Knowledge Base on Hi contains several articles to help you troubleshoot MID Server issues.")
* [MID Server properties](https://www.servicenow.com/docs/kCZI01CdDboQJ~Alkf3MFg#r_MIDServerProperties "Properties control the behavior of all MID Servers or a particular MID Server.")
* [MID Server parameters](https://www.servicenow.com/docs/9bf6AMU0YzFSeKaPniMXlQ#mid-server-parameters "Parameters control the behavior of a particular MID Server and have lower precedence than MID Server properties.")
* [MID Server Configuration Parameter settings and priority](https://www.servicenow.com/docs/zmIKyIToc_JohWVTG6CHNQ "The MID Server's settings reside in multiple tables and the MID Server prioritizes them in a set order. MIDConfigParameter must be defined with the correct type-style builders.")
* [MID Server protected records and reserved characters](https://www.servicenow.com/docs/R_UORSGTsWLLds5WDthYMg "Some MID Server records cannot be altered. Certain special characters are pre-defined in XML and cannot be used in passwords.")
* [MIDSystem methods](https://www.servicenow.com/docs/8sGrXh3ukCa4vzdmJEPzVw "MIDSystem variables (referred to by the variable name ms.) provide a variety of methods to get information about the MID Server.")
* [MID Server heartbeat](https://www.servicenow.com/docs/Cx2YLLAd_cUQAwGVk5QRIw "The instance checks the MID Server for a response every 5 minutes, using a synthetic transaction monitoring system.")

## MID Server pause {#ariaid-title2}

The MID server can be put into a Paused state to temporarily prevent it from
polling the ECC Queue for work or sending Discovery results back to the instance.

Unlike stopping the MID Server from the [Windows](https://www.servicenow.com/docs/zEKAxPsK6hW0ONY5YK5H2w#t_InstallAMIDServerOnWindows "Install MID Servers with the MID Server guided Windows installation package. The package includes an installer that automatically configures OpenJDK to run in the environment.")
or [Linux](https://www.servicenow.com/docs/td~JVZjWwO1vNJMOlEsHjQ#t_InstallAMIDServerOnLinux "Install MID Servers with the MID Server installer and verify it is active. The package includes an installer that automatically configures JRE to run in the environment. The MID Server can use an existing JRE rather than the provided JRE. Uninstall the MID Server to redeploy it.") server command line on the MID Server machine, pausing the MID server is
something that you can do from the instance. The MID Server pause feature is available
starting with the Istanbul release.  
Note:  
You can only pause [validated MID Servers](https://www.servicenow.com/docs/7CRK9lFekoxJY4fHjsqvJw "You must manually validate the MID Server after it is installed to enable it to execute automation tasks. You can invalidate a MID Server you suspect has been compromised to prevent it from accessing automation credentials in the instance or executing outbound ECC probes.").
You can still perform these actions when the MID Server is paused:

* [Access the
  MID Server logs](https://www.servicenow.com/docs/ZMA0sg3NtYS3mj9dEjU8ew#manage-ecc-queue-content "The ECC Queue allows you to create ECC Queue messages, access MID Server log entries, and retrieve statistics from an individual MID Server record.") and delete log entries.
* View MID server statistics. While the MID Server is in the Paused state it stops generating statistics. But you can still view the statistics generated before you paused the MID Server.
* Retrieve the MID Server thread dump.
* Make and save [configuration
  changes](https://www.servicenow.com/docs/l~Vv5LKk0kYnI_1s_R56lA "After installing and validating your MID Servers, ensure that they have access to sufficient system resources, probe the proper targets, and communicate with the instance as expected. Configure MID Server selection criteria, create clusters for failover protection, and set up MID Servers in different domains to protect data.") and property changes to the server. The changes take effect after the MID Server is resumed.
* Clear the ECC queue.
{#c_MIDServerPause__ul_kc5_yg4_xv}

The [MID server
heartbeat](https://www.servicenow.com/docs/Cx2YLLAd_cUQAwGVk5QRIw "The instance checks the MID Server for a response every 5 minutes, using a synthetic transaction monitoring system.") continues to function while the MID Server is in the
Paused state. If the MID Server is upgraded while it is in the
Paused state, the MID Server state automatically changes to
Up after successful upgrade. It does not return to the
Paused state.

During [MID Server
selection](https://www.servicenow.com/docs/cl1A~kiHy~JqUfrMHu0oZw "You can configure MID Server selection by application, IP address ranges, network capability, or behavior. Specific MID Servers can be assigned to particular tasks, or the MID Server can be selected automatically. MID Servers can use domain separation to limit the scope of discoveries and event management."), paused MID Servers can still be selected but are prioritized below MID
Servers that are not paused.

### Events that occur during MID Server pause

The vCenter and SNMP event collectors, continue
to run and process events when you pause the MID Server. These events are not part of the
normal synchronous communication that the MID Server has with the instance that you see in
the ECC queue. Events are still relayed to the instance and can even trigger actions on
records in the instance, such as a CI update. For example, if vCenter detects that a virtual
machine goes down or is deleted, a vCenter event makes a change to the status of the
corresponding CI record for that virtual machine.  
To prevent these events from being processed, stop the extensions from running. For more information, see:

* [Configure and run the vCenter event collector extension](https://www.servicenow.com/docs/wu3XSFcbAMzhmhz5sq5YlA#t_ConfigVCenEvntProcExt "Configure the vCenter event collector extension in the MID Server module, and then add or remove supported events.")
* [Configure the SNMP Trap Collector Extension](https://www.servicenow.com/docs/P7wtm9a47dSWuduiK24r1g#t_ConfigSNMPTrapCollExt "For the SNMP trap collector extension to receive traps from network devices, each device must designate the MID Server that runs the SNMP trap collector extension as a recipient of the trap.")
{#c_MIDServerPause__ul_bjd_znn_cw}