-
Title
Upgrade offline to 9.3.1 NuGet mirror -
Description
During an upgrade from an older version of One Identity Manager to 9.3.1 in a restricted network environment (no Internet access), the compiler can not access the public NuGet repository.
The following errors maybe displayed in the complier:
[810086] Error compiling script (0,0): Unable to load the service index for source https://api.nuget.org/v3/index.json.
[810086] Error compiling script (0,0): Unable to find package <random package name>. No packages exist with this id in source(s): Local, nuget
How to create and use a local NuGet mirror for offline compilation for this type of upgrade?
-
Cause
Starting with version 9.3, One Identity Manager uses NuGet based dependency resolution for compilation.
When the environment does not allow Internet connectivity, the compiler cannot download needed NuGet packages from https://api.nuget.org/v3/index.json.
Therefore, a local mirror containing the same packages must be provided manually. -
Resolution
To perform a successful offline upgrade and compilation in One Identity Manager 9.3.1, follow these steps:
Please note that it is now possible to download the Identity Manager NuGet cache files from GitHub - Please see https://github.com/OneIdentity/IdentityManager.NuGet.Cache - This is currently only available for versions 9.3.1 and 10.0 LTS.
1. Prepare an online machine
- Install One Identity Manager 9.3.1 on a system with Internet access.
- Run a full system compilation using either:
- Designer - Database - Compile database..., or Launchpad - Database Compiler.
- This downloads all NuGet packages automatically.
2. Find the downloaded packages
- The packages are stored under: C:\Users\<username>\.nuget\packages
- or run the command: dotnet nuget locals global-packages -l
3. Create the local NuGet mirror
- Copy the contents of this folder to a shared location, for example: C:\NuGetMirror
4. Configure the offline environment
- On each offline machine that needs to compile
- Open the Registry Editor and create the following key: HKEY_CURRENT_USER\SOFTWARE\One Identity\One Identity Manager\Global\Compiler
- Add a String value: ExternalNugetSource = C:\NuGetMirror
5. Test compilation
After the mirror path is configured, recompile the database.
The compiler will use the local NuGet source instead of the public feed.If compilation fails due to a missing package, download that specific .nupkg file manually from nuget.org and add it to the mirror folder.