Add MID Server parameters

Use a MID Server parameter to control the behavior of a particular MID Server.

Before you begin

Role required: admin

About this task

You can set MID Server configuration parameters in either of the following places:
  • From the Configuration Parameters related list in the MID Server record.
  • From the config.xml file in the \agent directory of your MID Server installation.
Note: Changes to parameters only take effect when the MID Server is started (or restarted).

You can view and manage MID Server configuration from the ServiceNow instance.

Procedure

  1. Navigate to the list of MID Servers using one of the following paths:
    • MID Server > Servers
    • Discovery > MID Servers
    • Orchestration > MID Servers
  2. From the list of MID Servers, select a MID Server to configure.

    The Configuration Parameters related list shows all the parameters currently in the MID Server 's configuration file. If there are any passwords, they are displayed in asterisks for security reasons.



  3. To add parameters, click New, and then complete the form.
    After the form is submitted, the configuration file for that MID Server is modified to include the new parameter. Changes to existing parameters are reflected in the MID Server configuration file as well. Changes made to the MID Server configuration file do not take place immediately, but rather the next time the MID Server is restarted. The MID Server form has a related link for restarting the MID Server.
    Note: ServiceNow prevents you from saving changes, such as modifying or deleting parameters, that would cause the MID Server to lose communications with the instance. For example, you cannot change the url parameter. Any changes to these protected properties must be made directly in the config.xml file for that MID Server.

    Setting Parameters from the config.xml File

    MID Server configuration is controlled by an XML file called config.xml. This file is located in the \agent directory, immediately under the directory where the MID Server is installed. Edit this file directly to make any configuration changes to protected parameters. Many configuration changes, such as those that do not disrupt communication between the MID Server and the ServiceNow instance, may also be made from the instance.

    The structure of the config.xml file is simply an outer parameters tag and a series of inner parameter tags. Each parameter tag has name and value attributes.
    • To change the value of a parameter, edit the value attribute.
    • To add a parameter, add another parameter tag with its name and value.
    • To delete a parameter, delete the entire parameter tag.
    The order of the parameters within the file is not important. Notice the green comment sections in the sample. Use these elements to add useful comments to the configuration file.
    Note: When configuring the MID Server for use with a proxy server, be sure to remove the comment tags around the proxy sections that you configure.


    Note: The sample file here is from FireFox. Conventional text editors, such as Notepad, Wordpad, or TextEdit, do not display colors and variable fonts.