Install a MID Server on Windows

This MID Server installer automates the installation of a MID Server on a Windows computer.

Before you begin

Role required: admin or mid_server

About this task

You can install one or more MID Servers on a supported Windows computer. Click this link to view the installation video:

Procedure

  1. Log in to the Windows host machine where you want to install the MID Server.
  2. Create a folder for the MID Server on the top level of the drive such as ServiceNow\MID Server1.
  3. Download the MID archive file into the new folder.
  4. Right-click the archive and select Extract All.
  5. Navigate to the \agent folder that was created when the file was extracted.
  6. Change directories to the service-now\mid server name\agent folder, and enter the following command to start the MID Server installer: installer.bat.
    To configure the MID Server manually, skip to this step.
  7. Use the installer to enter the following information.

    An example MID Server installation

    Field Description
    ServiceNow instance URL Enter the full URL of your instance, for example:

    https://mycompanyinstace.service-now.com

    ServiceNow MID Server username Enter the user name of the MID Server user that you already created. The MID Server user must have the mid_server role.
    ServiceNow MID Server password Enter the password for the user in the ServiceNow MID Server username.
    Use proxy Select this check box if your MID Server communicates through a proxy to connect to the instance.
    Note: Your proxy server must use Basic Authentication for the MID server to connect to the instance.
    Proxy host Enter the proxy server host name.
    Proxy port Enter the port through which the proxy server communicates. If you leave this field blank, it should use the proxy server's default port number.
    Proxy username Enter the user name that has administrator rights to the proxy server.
    Proxy password Enter the password for the user name.
  8. Click Test your connection to validate the credentials and instance information. If you encounter any errors, verify the information that you input.
  9. Click Next.
  10. Configure the MID name parameters (see table).

    Table 1.
    Field Description
    MID Server name Enter any MID Server name.
    MID Service wrapper name Modify this field if necessary. It is populated automatically by prefixing snc_mid_ to the MID Server name. In most cases, you do not need to modify this.
    MID Server wrapper display name Modify this field if necessary. It is populated automatically by prefixing ServiceNow MID Server_ to the MID Server name. In most cases, you do not need to modify this.
  11. Click Next to view the summary.
  12. Click Start MID Server.
    The local host starts the MID Server.
  13. Click Mid Servers List Page.
    The installer opens the MID Server list from your instance.
  14. Select the MID Server name from the list.
    Note: It may take a few seconds for the MID Server time to establish a connection with your instance.
    The system displays the MID Server record.
  15. From Related Links, click Validate.
    The MID Server Validated changes to Yes.
  16. To configure the MID Server manually, edit the config.xml file with a text editor such as WordPad:
    1. Find the element <parameter name="url" value="https://YOUR_INSTANCE.service-now.com" /> element and change the value to the URL of your instance.
    2. Enter the MID user credentials in the mid.instance.username and mid.instance.password parameters.
      By default, the MID Server, uses basic authentication for SOAP messages. The password value is also encrypted authentication.
    3. (Optional) Find the <parameter name="name" value="YOUR_MIDSERVER_NAME_GOES_HERE" /> element and change the value for the MID Server name.
    4. (Optional) Enter connection information for the proxy server. Remove the appropriate comment tags from the proxy configuration information.
      For example, you can configure these parameters:
      • mid.proxy.use_proxy
      • mid.proxy.host
      • mid.proxy.port
      • mid.proxy.username
      • mid.proxy.password
  17. If you configured the MID Server manually, finalize the configuration as follows:
    1. Execute the batch file start.bat.
      The system starts the new MID Server.
    2. Log into the instance.
    3. Navigate to MID Servers > Servers.
      The system displays a list of MID Server records.
    4. Select the record matching your new MID Server and verify that the Status is listed as Up.