| Option | --enable-active-witnesses | |
| Aliases | --active-witnesses | |
| Config File Options | active-witnesses, enable-active-witnesses | |
| Description | Enable active witness hosts | |
| Value Type | boolean | |
| Default | false | |
| Valid Values | false | |
| true | ||
| Option | --enable-batch-master | |
| Config File Options | enable-batch-master | |
| Description | Enable batch operation for the primary | |
| Value Type | boolean | |
| Default | false | |
| Valid Values | false | |
| true | ||
| Option | --enable-batch-service | |
| Config File Options | enable-batch-service | |
| Description | Enables batch mode for a service | |
| Value Type | boolean | |
| Default | false | |
| Valid Values | false | |
| true | ||
This option enables batch mode for a service, which ensures that replication services that are writing to a target database using batch mode in heterogeneous deployments (for example Hadoop, Amazon Redshift or Vertica). Setting this option enables the following settings on each host:
On a Primary
mysql-use-bytes-for-string
is set to false.
colnames filter is
enabled (in the
binlog-to-q stage
to add column names to the THL information.
pkey filter is
enabled (in the
binlog-to-q and
q-to-dbms stage),
with the
addPkeyToInserts
and
addColumnsToDeletes
filter options set to true. This ensures that rows have
the right primary key information.
enumtostring
filter is enabled (in the
q-to-thl stage), to
translate ENUM
values to their string equivalents.
settostring filter
is enabled (in the
q-to-thl stage), to
translate SET
values to their string equivalents.
On a Replica
mysql-use-bytes-for-string
is set to true.
pkey filter is
enabled (q-to-dbms
stage).
| Option | --enable-batch-slave | |
| Config File Options | enable-batch-slave | |
| Description | Enable batch operation for the Replica | |
| Value Type | boolean | |
| Default | false | |
| Valid Values | false | |
| true | ||
| Option | --enable-connector-client-ssl | |
| Aliases | --connector-client-ssl | |
| Config File Options | connector-client-ssl, enable-connector-client-ssl | |
| Description | Enable SSL encryption of traffic from the client to the connector | |
| Value Type | boolean | |
| Valid Values | false | Default when disable-security-controls=true, or not supplied in versions prior to v7.0.0 |
| true | Default when disable-security-controls=false, or not supplied in versions v7.0.0 onwards | |
| Option | --enable-connector-readonly | |
| Aliases | --connector-readonly | |
| Config File Options | connector-readonly, enable-connector-readonly | |
| Description | Enable the Tungsten Connector read-only mode | |
| Value Type | boolean | |
| Default | false | |
| Valid Values | false | |
| true | ||
| Option | --enable-connector-server-ssl | |
| Aliases | --connector-server-ssl | |
| Config File Options | connector-server-ssl, enable-connector-server-ssl | |
| Description | Enable SSL encryption of traffic from the connector to the database | |
| Value Type | boolean | |
| Valid Values | false | Default when disable-security-controls=true, or not supplied in versions prior to v7.0.0 |
| true | Default when disable-security-controls=false, or not supplied in versions v7.0.0 onwards | |
| Option | --enable-connector-ssl | |
| Aliases | --connector-ssl | |
| Config File Options | connector-ssl, enable-connector-ssl | |
| Description | Enable SSL encryption of connector traffic to the database | |
| Value Type | boolean | |
| Valid Values | false | Default when disable-security-controls=true, or not supplied in versions prior to v7.0.0 |
| true | Default when disable-security-controls=false, or not supplied in versions v7.0.0 onwards | |
| Option | --enable-heterogeneous-master | |
| Config File Options | enable-heterogeneous-master | |
| Description | Enable heterogeneous operation for the primary | |
| Value Type | boolean | |
| Default | false | |
| Valid Values | false | |
| true | ||
--enable-heterogeneous-service
| Option | --enable-heterogeneous-service | |
| Config File Options | enable-heterogeneous-service | |
| Description | Enable heterogeneous operation | |
| Value Type | boolean | |
| Default | false | |
| Valid Values | false | |
| true | ||
On a Primary
mysql-use-bytes-for-string
is set to false.
colnames filter is
enabled (in the
binlog-to-q stage
to add column names to the THL information.
pkey filter is
enabled (in the
binlog-to-q and
q-to-dbms stage),
with the
addPkeyToInserts
and
addColumnsToDeletes
filter options set to false.
enumtostring
filter is enabled (in the
q-to-thl stage), to
translate ENUM
values to their string equivalents.
settostring filter
is enabled (in the
q-to-thl stage), to
translate SET
values to their string equivalents.
On a Replica
mysql-use-bytes-for-string
is set to true.
pkey filter is
enabled (q-to-dbms
stage).
| Option | --enable-heterogeneous-slave | |
| Config File Options | enable-heterogeneous-slave | |
| Description | Enable heterogeneous operation for the replica | |
| Value Type | boolean | |
| Default | false | |
| Valid Values | false | |
| true | ||
| Option | --enable-jgroups-ssl | |
| Aliases | --jgroups-ssl | |
| Config File Options | enable-jgroups-ssl, jgroups-ssl | |
| Description | Enable SSL encryption of JGroups communication on this host | |
| Value Type | boolean | |
| Valid Values | false | Default when disable-security-controls=true, or not supplied in versions prior to v7.0.0 |
| true | Default when disable-security-controls=false, or not supplied in versions v7.0.0 onwards | |
| Option | --enable-rmi-authentication | |
| Aliases | --rmi-authentication | |
| Config File Options | enable-rmi-authentication, rmi-authentication | |
| Description | Enable RMI authentication for the services running on this host | |
| Value Type | boolean | |
| Valid Values | false | Default when disable-security-controls=true, or not supplied in versions prior to v7.0.0 |
| true | Default when disable-security-controls=false, or not supplied in versions v7.0.0 onwards | |
| Option | --enable-rmi-ssl | |
| Aliases | --rmi-ssl | |
| Config File Options | enable-rmi-ssl, rmi-ssl | |
| Description | Enable SSL encryption of RMI communication on this host | |
| Value Type | boolean | |
| Valid Values | false | Default when disable-security-controls=true, or not supplied in versions prior to v7.0.0 |
| true | Default when disable-security-controls=false, or not supplied in versions v7.0.0 onwards | |
| Option | --enable-slave-thl-listener | |
| Aliases | --repl-enable-slave-thl-listener | |
| Config File Options | enable-slave-thl-listener, repl-enable-slave-thl-listener | |
| Description | Should this service allow THL connections? | |
| Value Type | boolean | |
| Default | true | |
| Valid Values | false | |
| true | ||
| Option | --enable-sudo-access | |
| Aliases | --root-command-prefix | |
| Config File Options | enable-sudo-access, root-command-prefix | |
| Description | Run root commands using sudo | |
| Value Type | boolean | |
| Valid Values | false | Default for Connector only or Replicator only installs |
| true | Default for Cluster installs that include a manager AND OS User is NOT root | |
The default behavior of this property is different in certain installs.
For a cluster node install that INCLUDES the manager process, AND where the
install OS user is NOT root, the default will be true
For a Replicator only or Connector only install, the default will be false
When set to true, the property has the following effect:
During staging tpm installs, if the tungsten user is different from the ssh user on remote hosts
All startup scripts when using systemctl: replicator, connector, manager will call systemctl prefixed with sudo:
for example: sudo -n systemctl start treplicator
tprovision script (tps.pl) requires sudo access for mysql and xtrabackup calls
replicator backup script for xtrabackup and other backup utilities
check_tungsten.sh utility to call xinetd
tmonitor starts exporter service with sudo
manager to restart mysql service when found stopped
tpm diagnostic operation (tpm diag)
| Option | --enable-thl-ssl | |
| Aliases | --repl-enable-thl-ssl, --thl-ssl | |
| Config File Options | enable-thl-ssl, repl-enable-thl-ssl, thl-ssl | |
| Description | Enable SSL encryption of THL communication for this service | |
| Value Type | boolean | |
| Valid Values | false | Default when disable-security-controls=true, or not supplied in versions prior to v7.0.0 |
| true | Default when disable-security-controls=false, or not supplied in versions v7.0.0 onwards | |
| 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 to 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.
| 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 to 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.
| Option | --executable-prefix | |
| Config File Options | executable-prefix | |
| Description | Adds a prefix to command aliases | |
| Value Type | string | |
When enabled, the supplied prefix is added to each command alias
that is generated for a given installation. This enables
multiple installations to co-exist and and be accessible through
a unique alias. For example, if the executable prefix is
configured as east, then
an alias for the installation to trepctl will
be created as east_trepctl.
Alias information for executable prefix data is stored within
the
$CONTINUENT_ROOT/share/aliases.sh
file for each installation.