Notifications

2348 views

Overview


NOTE: The resolution described below in this article is only required until you have upgraded to London or later. Once the MID Server is running London or later, the instance can then act like a kind of proxy and so direct access to the install server is no longer necessary. The MID Server will always have access to the instance, so this is no longer an issue.

Once you have got your MID Servers running London or later, please set/add this system property to avoid this in future:

mid.download.through.instance=true

 

Problem

When an instance is upgraded, the MID Server needs to upgrade itself to match and needs to Download Upgrade Files from https://install.service-now.com/ and if it does not have access, it fails to upgrade. The automatic Test MID Server connectivity feature will check for and notify you if the MID Server can't.

Warning: A MID Server on the wrong version can cause code and data mismatches between MID Server and instance, potentially causing:

  • the MID Server to not process commands sent it by the instance
  • the instance to not process data coming back from the MID Server

 

In the following situations, your MID Server computer has no access to the install server and cannot auto-upgrade itself. You should try to resolve these issues internally first:

  • The instance is on-premise and installed inside the customer network (with no Internet access), and the MID Server also has no internet access at all.
  • The instance is hosted in our datacenter, but although the MID Server does have access to the instance, you have not yet arranged for it to have access to our upgrade server: https://install.service-now.com/

Symptom


MID Server Agent log including:

Jakarta and Kingston:

AutoUpgrade.3600 Performing pre-upgrade validation tests.
AutoUpgrade.3600 Downloading from https://install.service-now.com/glide/distribution/builds/package/mid-upgrade/2018/01/03/mid-upgrade.kingston-10-17-2017__patch1-12-12-2017_01-03-2018_0843.preUpgradeCheck.zip
AutoUpgrade.3600 WARNING *** WARNING *** Method failed: (https://install.service-now.com/glide/distribution/builds/package/mid-upgrade/2018/01/03/mid-upgrade.kingston-10-17-2017__patch1-12-12-2017_01-03-2018_0843.preUpgradeCheck.zip) null with code: 0
 
Istanbul and earlier, there is no pre-upgrade check:
 
AutoUpgrade.3600 Downloading package to mid-upgrade.istanbul-09-23-2016__patch10b-12-07-2017_12-18-2017_1521.universal.universal.zip from https://install.service-now.com/glide/distribution/builds/package/mid-upgrade/2017/12/18/mid-upgrade.istanbul-09-23-2016__patch10b-12-07-2017_12-18-2017_1521.universal.universal.zip
AutoUpgrade.3600 WARNING *** WARNING *** Method failed: (https://install.service-now.com/glide/distribution/builds/package/mid-upgrade/2017/12/18/mid-upgrade.istanbul-09-23-2016__patch10b-12-07-2017_12-18-2017_1521.universal.universal.zip) null with code: 0
Resolution

This manual procedure fools the MID Server into thinking it has downloaded the files itself already, allowing it to upgrade itself in the normal way, and if necessary must be done for every MID Server after every upgrade or patch of every instance, without fail. 

1) Find the filenames from the Agent log:

On the MID Server computer, check the latest 'AutoUpgrade' or 'StartupSequencer' thread entries in the Agent Log for the "Missing:" ZIP file names:
<install folder>\agent\logs\agent0.log.0

StartupSequencer Packages refreshed.
StartupSequencer Current packages:
StartupSequencer   Installed: [mid-core.kingston-10-17-2017__patch0-11-06-2017_11-11-2017_1422.universal.universal.zip, mid-jre.kingston-10-17-2017__patch0-11-06-2017_11-11-2017_1422.windows.x86-64.zip]
StartupSequencer   Assigned: [mid-upgrade.kingston-10-17-2017__patch1-12-12-2017_01-03-2018_0843.universal.universal.zip, mid-jre.kingston-10-17-2017__patch1-12-12-2017_01-03-2018_0843.windows.x86-64.zip, mid-core.kingston-10-17-2017__patch1-12-12-2017_01-03-2018_0843.universal.universal.zip]
StartupSequencer   Missing: [mid-upgrade.kingston-10-17-2017__patch1-12-12-2017_01-03-2018_0843.universal.universal.zip, mid-jre.kingston-10-17-2017__patch1-12-12-2017_01-03-2018_0843.windows.x86-64.zip, mid-core.kingston-10-17-2017__patch1-12-12-2017_01-03-2018_0843.universal.universal.zip]
StartupSequencer   Downloaded: []

In that example, the MID Server is still Kingston Patch 0, even though the instance is already upgraded to Kingston Patch 1, and the missing files in this example are:

mid-upgrade.kingston-10-17-2017__patch1-12-12-2017_01-03-2018_0843.universal.universal.zip
mid-jre.kingston-10-17-2017__patch1-12-12-2017_01-03-2018_0843.windows.x86-64.zip
mid-core.kingston-10-17-2017__patch1-12-12-2017_01-03-2018_0843.universal.universal.zip

2) Next figure out the full URL for those files.

Since Geneva, the filename is made up of:
<Upgrade file>.<MID Buildstamp>.<platform>.<architecture>.zip
and the URLs also take a common form.
https://install.service-now.com/glide/distribution/builds/package/<file type>/<MID Buildstamp date>/<File name>

In my example the filenames are rearranged to become these URLs:

Filename: mid-upgrade.kingston-10-17-2017__patch1-12-12-2017_01-03-2018_0843.universal.universal.zip
URL: https://install.service-now.com/glide/distribution/builds/package/mid-upgrade/2018/01/03/mid-upgrade.kingston-10-17-2017__patch1-12-12-2017_01-03-2018_0843.universal.universal.zip

Filename: mid-jre.kingston-10-17-2017__patch1-12-12-2017_01-03-2018_0843.windows.x86-64.zip
URL: https://install.service-now.com/glide/distribution/builds/package/mid-jre/2018/01/03/mid-jre.kingston-10-17-2017__patch1-12-12-2017_01-03-2018_0843.windows.x86-64.zip

Filename: mid-core.kingston-10-17-2017__patch1-12-12-2017_01-03-2018_0843.universal.universal.zip
URL: https://install.service-now.com/glide/distribution/builds/package/mid-core/2018/01/03/mid-core.kingston-10-17-2017__patch1-12-12-2017_01-03-2018_0843.universal.universal.zip


3) Download these files manually on another computer that has internet access and then copy those ZIP files to the MID Server folder:

<install folder>\agent\package\incoming

Note: The file names and URLs will be specific to a particular version of the platform. In this example it is Kingston Patch 1, but the same process applies to all versions.

 

4) Upgrade the MID Server

At this point you can wait for the AutoUpgrade thread to run again (it is on a 1 hour interval) or restart the MID Server service to force it to upgrade now.

The next time the AutoUpgrade thread runs, Downloaded: shows the files present in the <install folder>\agent\logs\agent0.log.0 log. It then goes ahead and does the upgrade.

StartupSequencer   Downloaded: [mid-core.kingston-10-17-2017__patch1-12-12-2017_01-03-2018_0843.universal.universal.zip, mid-jre.kingston-10-17-2017__patch1-12-12-2017_01-03-2018_0843.windows.x86-64.zip, mid-upgrade.kingston-10-17-2017__patch1-12-12-2017_01-03-2018_0843.universal.universal.zip]

You can then re-use the downloaded files for any other MID Servers that are also connecting to the same instance.

 

Article Information

Last Updated:2019-05-21 11:55:36
Published:2019-04-01