Skip to content

Known Issue Prerequisites require Internet access to be installed

Dmitry Kolinchuk edited this page Nov 1, 2021 · 2 revisions

← Troubleshooting

Known Issue - Prerequisites require Internet access to be installed

The following known issue may occur when installing Sitecore 9 and later without Internet access:

https://support.sitecore.com/kb?id=kb_article_view&sysparm_article=KB1000565

Solution

The Prerequisites.json file contains a list of tasks that are run when the prerequisites are installed using SIF. To install the prerequisites manually, proceed as follows:

  1. Download the required tools to a computer with Internet access. The download URLs are available in the Parameters section of the Prerequisites.json file. For example, there is the download link for the Microsoft Web Platform Installer:

     "WebPlatformDownload": {
         "Type": "String",
         "Description": "Download location of Microsoft Web Platform Installer 5.x",
         "DefaultValue": "https://download.microsoft.com/download/8/4/9/849DBCF2-DFD9-49F5-9A19-9AEE5B29341A/WebPlatformInstaller_x64_en-US.msi"
     }
    

    Note: the Prerequisites.json file for Sitecore 9.1.0 rev. 001564 - Sitecore 10.1.0 rev. 005207 contains the outdated link to the Microsoft Web Platform Installer 5.0. For more details, refer to the following known issue:

    https://github.com/Sitecore/Sitecore-Instance-Manager/wiki/Known-Issue-Outdated-download-links-in-Prerequisites.json

  2. Download the SQL PowerShell module.

  3. Copy the tools to a target computer without Internet access.

  4. Install the tools manually.

    Notes:

    • To make the SQL PowerShell module available for PowerShell, the "SQLServer" folder should be copied to the "C:\Program Files\WindowsPowerShell\Modules" folder. If the SQL PowerShell module is not installed, the following message might appear:

      ERROR_SMO_NEEDED_FOR_SQL_PROVIDER

    • Install the Web Deploy 3.6 and URL Rewrite 2.1 tools using the Microsoft Web Platform Installer (if these tools have not been installed yet).

  5. Enable the Windows features defined in the "WindowsFeatures" task of the Prerequisites.json file:

     "WindowsFeatures": {
         "Type": "EnableWindowsOptionalFeature",
         "Params": {
             "Online": true,
             "FeatureName": [
                 "IIS-WebServer",
                 ... // check the full list in the Prerequisites.json file because it depends on a Sitecore XP version
             ],
             "All": true,
             "NoRestart": true
         }
     }
    

    The Windows features can be enabled using the PowerShell Enable-WindowsOptionalFeature cmdlet. For example, to enable the "IIS-WebServer" feature, run the following code:

    Enable-WindowsOptionalFeature -Online -FeatureName IIS-WebServer -All

  6. Install Sitecore using SIM and uncheck the "Prerequisites" checkbox on the second step of Installation Wizard:

    Prerequisites