Spectrum Upgrade fails with landscape handle error.

Products

• Network Observability
• Spectrum

Issue/Introduction

When trying to upgrade spectrum using sdclinux.exe, the install fails with the following error:

hostname: Creating installation log: LOGS_20250924/hostname.12.47
hostname: Starting installation
hostname: Landscape handle must be 64 - 16256, multiples of 64 (or 0x1000000 - 0xfe000000 with low 24 bits 0).
hostname: Installation complete

Install Summary:
hostname: Installation failure

Environment

DX NetOps Spectrum: All versions

Cause

The customer was migrating a database that had a legacy landscape handle but had included "huge_landscape_handle=yes" in the host installation information file.

Resolution

Change the "huge_landscape_handle=yes" to "huge_landscape_handle=no" in the host installation information(HII) file and re-run the install. 

Additional Information

If you see the error:

Error: Detected incompatible model mask configuration. The database
is configured as 20 bits, but the server is configured as 24 bits.
Database can't be loaded

Then make sure that your hii file has huge_landscape_handle=no

Error: Detected incompatible model mask configuration. The database
is configured as 24 bits, but the server is configured as 20 bits.
Database can't be loaded

Then make sure that your hii file has huge_landscape_handle=yes