tpm accepts these options along with those in Section 10.8, “tpm Configuration Options”.
On the command-line, using a double-dash prefix, i.e.
--skip-validation-check=MySQLConnectorPermissionsCheck
In an INI file, without the double-dash prefix, i.e.
skip-validation-check=MySQLConnectorPermissionsCheck
Table 10.7. tpm Common Options
| CmdLine Option | INI File Option | Description |
|---|---|---|
--enable-validation-check | enable-validation-check | Enable a specific validation check, overriding any configured skipped checks |
--enable-validation-warnings | enable-validation-warnings | Enable a specific validation warning, overriding any configured skipped warning |
--ini | ini | Specify the location of the directory where INI files will be located, or specify a specific filename |
--net-ssh-option | net-ssh-option | Set the Net::SSH option for remote system calls |
--property, --property=key+=value, --property=key=value, --property=key~=/match/replace/ | property, property=key+=value, property=key=value, property=key~=/match/replace/ | Modify specific property values for the key in any file that the configure script touches. |
--remove-property | remove-property | Remove the setting for a previously configured property |
--replace-release | replace-release | Used when upgrading or making configuration changes. This option will rebuild the entire release and recreate all metadata configuration. |
--skip-validation-check | skip-validation-check | Do not run the specified validation check. |
--skip-validation-warnings | skip-validation-warnings | Do not display warnings for the specified validation check. |
| Option | --enable-validation-check | |
| Config File Options | enable-validation-check | |
| Description | Enable a specific validation check, overriding any configured skipped checks | |
| Value Type | string | |
The --enable-validation-check
will specifically enable a given validation check if the check
had previously been set it be ignored in a previous invocation
of the configuration through tpm. If a check
fails, installation is canceled.
Setting both
--skip-validation-check and
--enable-validation-check is
equivalent to explicitly disabling the specified check.
− --enable-validation-warnings
| Option | --enable-validation-warnings | |
| Config File Options | enable-validation-warnings | |
| Description | Enable a specific validation warning, overriding any configured skipped warning | |
| Value Type | string | |
The
--enable-validation-warnings
will specifically enable a given validation warning check if the
check had previously been set it be ignored in a previous
invocation of the configuration through tpm.
Setting both
--skip-validation-warnings and
--enable-validation-warnings is
equivalent to explicitly disabling the specified check.
− --ini
| Option | --ini | |
| Config File Options | ini | |
| Description | Specify the location of the directory where INI files will be located, or specify a specific filename | |
| Value Type | string | |
| Default | /etc/tungsten/tungsten.ini | |
Specifies an alternative location, or file, for the INI files from the default.
| Option | --net-ssh-option | |
| Config File Options | net-ssh-option | |
| Description | Set the Net::SSH option for remote system calls | |
| Value Type | string | |
Enables you to set a specific Net::SSH option. For example:
shell> tpm update ... --net-ssh-option=compression=zlib| Option | --property | |
| Aliases | --property=key+=value, --property=key=value, --property=key~=/match/replace/ | |
| Config File Options | property, property=key+=value, property=key=value, property=key~=/match/replace/ | |
| Description | Modify specific property values for the key in any file that the configure script touches. | |
| Value Type | string | |
The --property option enables
you to explicitly set property values in the target files. A
number of different models are supported:
key=value
Set the property defined by
key to the specified
value without evaluating any template values or other rules.
key+=value
Add the value to the property defined by
key. Template values and
other options append their settings to the end of the
specified property.
key~=/match/replace/
Evaluate any template values and other settings, and then
perform the specified Ruby regex operation to the property
defined by key. For
example
--property=replicator.key~=/(.*)/somevalue,\1/
will prepend somevalue
before the template value for
replicator.key.
| Option | --remove-property | |
| Config File Options | remove-property | |
| Description | Remove the setting for a previously configured property | |
| Value Type | string | |
Remove a previous explicit property setting. For example:
shell> tpm configure --remove-property=replicator.filter.pkey.addPkeyToInserts| Option | --replace-release | |
| Config File Options | replace-release | |
| Description | Used when upgrading or making configuration changes. This option will rebuild the entire release and recreate all metadata configuration. | |
| Value Type | boolean | |
This property can only be used with tools/tpm update and can only be executed from within the software staging tree.
This option is highly recommended when upgrading between versions as it will ensure all metadata is correctly rebuilt for the version being installed.
It is not necessary when applying config changes, however it can be useful if properties are not being applied correctly, or if underlying metadata has become corrupt.
| Option | --skip-validation-check | |
| Config File Options | skip-validation-check | |
| Description | Do not run the specified validation check. | |
| Value Type | string | |
The --skip-validation-check
disables a given validation check. If any validation check
fails, the installation, validation or configuration will
automatically stop.
Using this option enables you to bypass the specified check, although skipping a check may lead to an invalid or non-working configuration.
You can identify a given check if an error or warning has been raised during configuration. For example, the default table type check:
... ERROR >> centos >> The datasource root@centos:3306 (WITH PASSWORD) » uses MyISAM as the default storage engine (MySQLDefaultTableTypeCheck) ...
The check in this case is
MySQLDefaultTableTypeCheck,
and could be ignored using
--skip-validation-check=MySQLDefaultTableTypeCheck.
Setting both
--skip-validation-check and
--enable-validation-check is
equivalent to explicitly disabling the specified check.
| Option | --skip-validation-warnings | |
| Config File Options | skip-validation-warnings | |
| Description | Do not display warnings for the specified validation check. | |
| Value Type | string | |
The --skip-validation-warnings
disables a given validation check.
You can identify a given check by examining the warnings generated during configuration. For example, the Linux swappiness warning:
... WARN >> centos >> Linux swappiness is currently set to 60, on restart it will be 60, » consider setting this to 10 or under to avoid swapping. (SwappinessCheck) ...
The check in this case is
MySQLDefaultTableTypeCheck,
and could be ignored using
--skip-validation-warnings=SwappinessCheck.
Setting both
--skip-validation-warnings and
--enable-validation-warnings is
equivalent to explicitly disabling the specified warning.