Installer Preferences File Reference

Installer Preferences File Schema

http://128technology.com/installerPreferencesFile

Schema for the preferences file used by the 128T Installer.

Installer Preferences File Type

object (Installer Preferences File)

Installer Preferences File Properties

PropertyTypeRequiredNullableDefined by
installobjectOptionalcannot be nullInstaller Preferences File
upgradeobjectOptionalcannot be nullInstaller Preferences File
rollbackobjectOptionalcannot be nullInstaller Preferences File
downloadobjectOptionalcannot be nullInstaller Preferences File
importobjectOptionalcannot be nullInstaller Preferences File
repositoryobjectOptionalcannot be nullInstaller Preferences File
authenticationobjectOptionalcannot be nullInstaller Preferences File
enable-128TbooleanOptionalcannot be nullInstaller Preferences File
start-128TbooleanOptionalcannot be nullInstaller Preferences File
reboot-if-requiredbooleanOptionalcannot be nullInstaller Preferences File
retry-max-attemptsintegerOptionalcannot be nullInstaller Preferences File
retry-delayintegerOptionalcannot be nullInstaller Preferences File
retry-backoffintegerOptionalcannot be nullInstaller Preferences File
set-default-kernelbooleanOptionalcannot be nullInstaller Preferences File
keep-deprecatedbooleanOptionalcannot be nullInstaller Preferences File

install

Cleanly install 128T with the given options after wiping away any traces of previous installations.

install

  • is optional
  • cannot be null

install Type

object (Install)

upgrade

Upgrade 128T to a newer version.

upgrade

  • is optional
  • cannot be null

upgrade Type

object (Upgrade)

rollback

Roll back to the previous installation of 128T. This is only possible if 128T was installed or upgraded with the Installer.

rollback

  • is optional
  • cannot be null

rollback Type

object (Rollback)

download

Download the 128T software and dependencies without installing.

download

  • is optional
  • cannot be null

download Type

object (Download)

import

Import a 128T ISO or packages directory into the local repository.

import

  • is optional
  • cannot be null

import Type

object (Import)

repository

Manage 128T software repositories.

repository

  • is optional
  • cannot be null

repository Type

object (Repository)

authentication

Authentication for downloading and installing 128T software.

authentication

  • is optional
  • cannot be null

authentication Type

object (Authentication)

authentication Constraints

minimum number of properties: the minimum number of properties for this object is: 1

enable-128T

Enable the 128T service if the operation is successful.

enable-128T

  • is optional
  • cannot be null

enable-128T Type

boolean

enable-128T Default Value

The default value is:

false

start-128T

Start the 128T service if the operation is successful.

start-128T

  • is optional
  • cannot be null

start-128T Type

boolean

start-128T Default Value

The default value is:

false

reboot-if-required

Reboot the system when the Installer exits if the operation is successful and a reboot is required.

reboot-if-required

  • is optional
  • cannot be null

reboot-if-required Type

boolean

reboot-if-required Default Value

The default value is:

false

retry-max-attempts

The maximum number of times to try an operation.

retry-max-attempts

  • is optional
  • cannot be null

retry-max-attempts Type

integer

retry-max-attempts Constraints

minimum: the value of this number must greater than or equal to: 1

retry-max-attempts Default Value

The default value is:

5

retry-delay

The initial number of seconds to wait before retrying. This can be increased for each successive try by using 'backoff'.

retry-delay

  • is optional
  • cannot be null

retry-delay Type

integer

retry-delay Constraints

minimum: the value of this number must greater than or equal to: 0

retry-delay Default Value

The default value is:

10

retry-backoff

The factor by which 'delay' should be multiplied for each successive retry.

retry-backoff

  • is optional
  • cannot be null

retry-backoff Type

integer

retry-backoff Constraints

minimum: the value of this number must greater than or equal to: 1

retry-backoff Default Value

The default value is:

1

set-default-kernel

Whether or not to set the system's default kernel after an Installer operation. If set to 'false', the correct kernel will need to be enabled manually for 128T to function normally.

set-default-kernel

  • is optional
  • cannot be null

set-default-kernel Type

boolean

set-default-kernel Default Value

The default value is:

true

keep-deprecated

Whether or not to keep deprecated packages during installation or upgrade.

keep-deprecated

  • is optional
  • cannot be null

keep-deprecated Type

boolean

keep-deprecated Default Value

The default value is:

false

Install Schema

http://128technology.com/installerPreferencesFile#/properties/install

Cleanly install 128T with the given options after wiping away any traces of previous installations.

install Type

object (Install)

Install Properties

PropertyTypeRequiredNullableDefined by
yum-certificatestringOptionalcannot be nullInstaller Preferences File
initializeobjectRequiredcannot be nullInstaller Preferences File
128T-versionstringOptionalcannot be nullInstaller Preferences File
no-nuke-on-startbooleanOptionalcannot be nullInstaller Preferences File
no-nuke-on-failurebooleanOptionalcannot be nullInstaller Preferences File

yum-certificate

Deprecated; use 'authentication.certificate' instead

yum-certificate

  • is optional
  • cannot be null

yum-certificate Type

string

initialize

Preferences to pass to the Initializer. These must conform to the Initializer preferences schema for the version of 128T being installed.

initialize

  • is required
  • cannot be null

initialize Type

object (Initializer Preferences File)

128T-version

An RPM version requirement string of the form '[comparison ][epoch:]version[-release]', where 'comparison' is one of '>=', '<', '>', '<=', or '='. If omitted, '=' will be used for 'comparison'.

128T-version

  • is optional
  • cannot be null

128T-version Type

string

128T-version Constraints

pattern: the string must match the following regular expression:

^((=|[><]=?)\s+)?([^\s:]+)?([^\s\-]+)(-(\S+))?$

try pattern

128T-version Examples

"3.0.3"
"3.0.3-release.201705302342.1.el7"
"0:3.1.4"
"0:3.1.4-release.1"
"= 3.1.4"
"< 3.2.0"
"<= 3.1.5-release.201710132231.1.el7"
"> 3.1.5-release.201710132231.1.el7"
">= 3.1.3"

no-nuke-on-start

Do not erase previous installations of 128T when the Installer starts.

no-nuke-on-start

  • is optional
  • cannot be null

no-nuke-on-start Type

boolean

no-nuke-on-start Default Value

The default value is:

false

no-nuke-on-failure

Do not uninstall 128T and clean up if the Installer fails.

no-nuke-on-failure

  • is optional
  • cannot be null

no-nuke-on-failure Type

boolean

no-nuke-on-failure Default Value

The default value is:

false

Upgrade Schema

http://128technology.com/installerPreferencesFile#/properties/upgrade

Upgrade 128T to a newer version.

upgrade Type

object (Upgrade)

Upgrade Properties

PropertyTypeRequiredNullableDefined by
yum-certificatestringOptionalcannot be nullInstaller Preferences File
128T-versionstringOptionalcannot be nullInstaller Preferences File

yum-certificate

Deprecated; use 'authentication.certificate' instead.

yum-certificate

  • is optional
  • cannot be null

yum-certificate Type

string

128T-version

An RPM version requirement string of the form '[comparison ][epoch:]version[-release]', where 'comparison' is one of '>=', '<', '>', '<=', or '='. If omitted, '=' will be used for 'comparison'.

128T-version

  • is optional
  • cannot be null

128T-version Type

string

128T-version Constraints

pattern: the string must match the following regular expression:

^((=|[><]=?)\s+)?([^\s:]+)?([^\s\-]+)(-(\S+))?$

try pattern

128T-version Examples

"3.0.3"
"3.0.3-release.201705302342.1.el7"
"0:3.1.4"
"0:3.1.4-release.1"
"= 3.1.4"
"< 3.2.0"
"<= 3.1.5-release.201710132231.1.el7"
"> 3.1.5-release.201710132231.1.el7"
">= 3.1.3"

Rollback Schema

http://128technology.com/installerPreferencesFile#/properties/rollback

Roll back to the previous installation of 128T. This is only possible if 128T was installed or upgraded with the Installer.

rollback Type

object (Rollback)

Download Schema

http://128technology.com/installerPreferencesFile#/properties/download

Download the 128T software and dependencies without installing.

download Type

object (Download)

Download Properties

PropertyTypeRequiredNullableDefined by
128T-versionstringOptionalcannot be nullInstaller Preferences File
yum-certificatestringOptionalcannot be nullInstaller Preferences File

128T-version

An RPM version requirement string of the form '[comparison ][epoch:]version[-release]', where 'comparison' is one of '>=', '<', '>', '<=', or '='. If omitted, '=' will be used for 'comparison'.

128T-version

  • is optional
  • cannot be null

128T-version Type

string

128T-version Constraints

pattern: the string must match the following regular expression:

^((=|[><]=?)\s+)?([^\s:]+)?([^\s\-]+)(-(\S+))?$

try pattern

128T-version Examples

"3.0.3"
"3.0.3-release.201705302342.1.el7"
"0:3.1.4"
"0:3.1.4-release.1"
"= 3.1.4"
"< 3.2.0"
"<= 3.1.5-release.201710132231.1.el7"
"> 3.1.5-release.201710132231.1.el7"
">= 3.1.3"

yum-certificate

Deprecated; use 'authentication.yum-certificate' instead.

yum-certificate

  • is optional
  • cannot be null

yum-certificate Type

string

Import Schema

http://128technology.com/installerPreferencesFile#/properties/import

Import a 128T ISO or packages directory into the local repository.

import Type

object (Import)

Import Properties

PropertyTypeRequiredNullableDefined by
iso-huntbooleanOptionalcannot be nullInstaller Preferences File
iso-pathstringOptionalcannot be nullInstaller Preferences File
packages-pathstringOptionalcannot be nullInstaller Preferences File

iso-hunt

Search the filesystem for ISOs and attempt to import them all.

iso-hunt

  • is optional
  • cannot be null

iso-hunt Type

boolean

iso-hunt Default Value

The default value is:

false

iso-path

The path to the 128T ISO to be imported.

iso-path

  • is optional
  • cannot be null

iso-path Type

string

packages-path

The path to package directory to be imported.

packages-path

  • is optional
  • cannot be null

packages-path Type

string

Repository Schema

http://128technology.com/installerPreferencesFile#/properties/repository

Manage 128T software repositories.

repository Type

object (Repository)

Repository Properties

PropertyTypeRequiredNullableDefined by
enableobjectOptionalcannot be nullInstaller Preferences File
disableobjectOptionalcannot be nullInstaller Preferences File

enable

Enable 128T software repositories. If a new authentication token is specified, an existing repository configuration will be updated to use the new token.

enable

  • is optional
  • cannot be null

enable Type

object (Enable)

disable

Disable 128T software repositories.

disable

  • is optional
  • cannot be null

disable Type

object (Disable)

Enable Schema

http://128technology.com/installerPreferencesFile#/properties/repository/properties/enable

Enable 128T software repositories. If a new authentication token is specified, an existing repository configuration will be updated to use the new token.

enable Type

object (Enable)

Enable Properties

PropertyTypeRequiredNullableDefined by
reposarrayOptionalcannot be nullInstaller Preferences File
persistentbooleanOptionalcannot be nullInstaller Preferences File

repos

A list of 128T repositories to enable.

repos

  • is optional
  • cannot be null

repos Type

an array of merged types (Enabled Repo)

persistent

If false, enables the repo for this operation only. Does not apply to 'system' or 'legacy' repos (it will always be treated as false).

persistent

  • is optional
  • cannot be null

persistent Type

boolean

persistent Default Value

The default value is:

false

Enabled Repo Schema

http://128technology.com/installerPreferencesFile#/properties/repository/properties/enable/properties/repos/items

A repository to enable.

items Type

merged type (Enabled Repo)

one (and only one) of

System Schema

http://128technology.com/installerPreferencesFile#/properties/repository/properties/enable/properties/repos/items/oneOf/1

Allow the use of all configured and enabled RPM repositories.

System Type

string (System)

System Constraints

constant: the value of this property must be equal to:

"system"

Disable Schema

http://128technology.com/installerPreferencesFile#/properties/repository/properties/disable

Disable 128T software repositories.

disable Type

object (Disable)

Disable Properties

PropertyTypeRequiredNullableDefined by
reposarrayOptionalcannot be nullInstaller Preferences File
persistentbooleanOptionalcannot be nullInstaller Preferences File

repos

A list of 128T repositories to disable.

repos

  • is optional
  • cannot be null

repos Type

string[] (Repository Type)

persistent

If false, disables the repo for this operation only. Does not apply to 'legacy' repo type (it will always be treated as false).

persistent

  • is optional
  • cannot be null

persistent Type

boolean

persistent Default Value

The default value is:

false

Authentication Schema

http://128technology.com/installerPreferencesFile#/definitions/authentication

Authentication for downloading and installing 128T software.

authentication Type

object (Authentication)

authentication Constraints

minimum number of properties: the minimum number of properties for this object is: 1

Authentication Properties

PropertyTypeRequiredNullableDefined by
usernamestringOptionalcannot be nullInstaller Preferences File
tokenstringOptionalcannot be nullInstaller Preferences File
certificatestringOptionalcannot be nullInstaller Preferences File

username

Username for authentication.

username

  • is optional
  • cannot be null

username Type

string

username Constraints

minimum length: the minimum number of characters for this string is: 1

token

API key to be used for authentication.

token

  • is optional
  • cannot be null

token Type

string

token Constraints

minimum length: the minimum number of characters for this string is: 1

certificate

The contents of a certificate file to use for authenticating with the 128T RPM repository. If present, this will overwrite an existing certificate.

certificate

  • is optional
  • cannot be null

certificate Type

string

certificate Constraints

minimum length: the minimum number of characters for this string is: 1

Repository Type Schema

http://128technology.com/installerPreferencesFile#/definitions/repository-type

A 128T software repository.

repository-type Type

string (Repository Type)

repository-type Constraints

enum: the value of this property must be equal to one of the following values:

ValueExplanation
"alpha"128T alpha software repository
"beta"128T beta software repository
"legacy"128T software repository for older releases
"prealpha"128T pre-alpha software repository
"release"128T release software repository
"plugins-alpha"128T alpha plugin repository
"plugins-beta"128T beta plugin repository
"plugins-release"128T release plugin repository
Last updated on