Overview
This document outlines the JSON file structure that the /
etc/cpanel/TIERS.json
uses to indicate Long-Term Support (LTS).
Some server owners need to deploy a specific version of cPanel & WHM to new installations, even when that version is no longer the current production release. In cPanel & WHM version 62 and later, we use this LTS structure for all release cycles.
The JSON file values
The following table describes the file's structure:
Return | Type | Description | Possible Values | Example |
---|---|---|---|---|
branch | hash | A hash that lists information about available branch builds. | This hash includes the versionnumber array of hashes. | |
| array of hashes | An array of ashes that contains information about a build version. Note: This return's name is the version number. The function returns this value in the | This array of hashes includes the build return. | |
| string | The build version number. The function returns this value in the | A valid build version number. |
|
| hash | A hash that lists information about build versions in release tiers. | This hash includes the versionnumber array of hashes. | |
| array of hashes | An array of hashes that contains information about a release version. Note: This return's name is the version number. The function returns this value in the | This array of hashes includes the | |
| Boolean | Whether cPanel offers this version as LTS. The function returns this value in the |
|
|
| array | The release tier or tiers which currently offer this branch, if applicable. The function returns this value in the |
| CURRENT |
| string | The build version number. The function returns this value in the | A valid build version number. |
|
| integer | When cPanel, Inc. support for the build version expires. The function returns this value in the | A valid date, in Unix time format. | 1473112978
|
Example
{ "tiers":{ "60":[ { "is_lts":0, "named":[ "CURRENT" ], "build":"11.60.0.35", "expires":1473112978 }, { "is_lts":0, "named":[ "EDGE" ], "build":"11.60.0.10", "expires":1477112978 } ], "56":[ { "is_lts":0, "build":"11.56.0.35", "expires":1473112978 } ], "58":[ { "is_lts":1, "named":[ "STABLE", "RELEASE" ], "build":"11.58.0.32", "expires":1474112978 } ], "62":[ { "is_lts":0, "build":"11.61.9999.21", "expires":1477312978 } ] } }
Additional documentation