The Long-Term Support JSON File

Overview

This document outlines the JSON file structure that the /etc/cpanel/TIERS.json file 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.
`versionnumber`	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 `branch` hash.	This array of hashes includes the `build` return.
`build`	string	The build version number. The function returns this value in the `versionnumber` array of hashes.	A valid build version number.	`11.60.0.35`
`is_main`	Boolean	Whether the build represents the main build of the branch.	`1` — The build is the main build of the branch. `0` — The build is not the main build of the branch.	`1`
`tiers`	hash	A hash that lists information about build versions in release tiers.	This hash includes the `versionnumber` array of hashes.
`versionnumber`	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 `tiers` hash.	This array of hashes includes the `is_lts`, `build`, and `expires` returns and the `named` array.
`is_lts`	Boolean	Whether cPanel offers this version as LTS. The function returns this value in the `versionnumber` array of hashes.	`1` — Long-term support. `0` — No Long-term support.	`0`
`named`	array	The release tier or tiers which currently offer this branch, if applicable. The function returns this value in the `versionnumber` array of hashes.	`EDGE` `CURRENT` `RELEASE` `STABLE` `LTS`	`CURRENT`
`build`	string	The build version number. The function returns this value in the `versionnumber` array of hashes.	A valid build version number.	`11.60.0.35`
`expires`	integer	When cPanel, L.L.C. support for the build version expires. The function returns this value in the `versionnumber` array of hashes.	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

Content by label

There is no content with the specified labels

Error rendering macro 'contentbylabel'

parameters should not be empty