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