Page tree
Skip to end of metadata
Go to start of metadata

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:

ReturnTypeDescriptionPossible ValuesExample
branchhashA 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

tiers

hashA 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
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, Inc. 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

Error rendering macro 'contentbylabel' : parameters should not be empty

There is no content with the specified labels