| Option | --channels | |
| Aliases | --repl-channels | |
| Config File Options | channels, repl-channels | |
| Description | Number of replication channels to use for services | |
| Value Type | numeric | |
--cluster-slave-auto-recovery-delay-interval
| Option | --cluster-slave-auto-recovery-delay-interval | |
| Aliases | --cluster-slave-repl-auto-recovery-delay-interval | |
| Config File Options | cluster-slave-auto-recovery-delay-interval, cluster-slave-repl-auto-recovery-delay-interval | |
| Description | Default value for --auto-recovery-delay-interval when --topology=cluster-slave | |
| Value Type | string | |
--cluster-slave-auto-recovery-max-attempts
| Option | --cluster-slave-auto-recovery-max-attempts | |
| Aliases | --cluster-slave-repl-auto-recovery-max-attempts | |
| Config File Options | cluster-slave-auto-recovery-max-attempts, cluster-slave-repl-auto-recovery-max-attempts | |
| Description | Default value for --auto-recovery-max-attempts when --topology=cluster-slave | |
| Value Type | string | |
--cluster-slave-auto-recovery-reset-interval
| Option | --cluster-slave-auto-recovery-reset-interval | |
| Aliases | --cluster-slave-repl-auto-recovery-reset-interval | |
| Config File Options | cluster-slave-auto-recovery-reset-interval, cluster-slave-repl-auto-recovery-reset-interval | |
| Description | Default value for --auto-recovery-reset-interval when --topology=cluster-slave | |
| Value Type | string | |
| Option | --composite-datasources | |
| Aliases | --dataservice-composite-datasources | |
| Config File Options | composite-datasources, dataservice-composite-datasources | |
| Description | Data services that should be added to this composite data service | |
| Value Type | string | |
| Option | --config-file-help | |
| Config File Options | config-file-help | |
| Description | Display help information for content of the config file | |
| Value Type | string | |
--conn-java-enable-concurrent-gc
| Option | --conn-java-enable-concurrent-gc | |
| Config File Options | conn-java-enable-concurrent-gc | |
| Description | Connector Java uses concurrent garbage collection | |
| Value Type | string | |
| Option | --conn-java-mem-size | |
| Config File Options | conn-java-mem-size | |
| Description | Connector Java heap memory size used to buffer data between clients and databases | |
| Value Type | numeric | |
| Valid Values | 256 | |
The Connector allocates memory for each concurrent client
connection, and may use up to the size of the configured MySQL
max_allowed_packet. With
multiple connections, the heap size should be configured to at
least the combination of the number of concurrent connections
multiplied by the maximum packet size.
--conn-round-robin-include-master
| Option | --conn-round-robin-include-master | |
| Config File Options | conn-round-robin-include-master | |
| Description | Should the Connector include the Primary in round-robin load balancing | |
| Value Type | string | |
| Option | --connector-affinity | |
| Config File Options | connector-affinity | |
| Description | The default affinity for all connections | |
| Value Type | string | |
| Option | --connector-autoreconnect | |
| Config File Options | connector-autoreconnect | |
| Description | Enable auto-reconnect in the connector | |
| Value Type | string | |
--connector-autoreconnect-killed-connections
| Option | --connector-autoreconnect-killed-connections | |
| Config File Options | connector-autoreconnect-killed-connections | |
| Description | Enable autoreconnect for connections killed within the connector | |
| Value Type | string | |
| Valid Values | false | Do not retry killed connections |
| true | ||
By default, the connector operates as follows:
Reconnect closed connections
Retry autocommitted reads
The behavior can be modified by using the
--connector-autoreconnect-killed-connections.
Setting to false disables
the reconnection or retry of a connection outside of a planned
switch or automatic failover. The default is
true, reconnecting and
retrying all connections.
| Option | --connector-bridge-mode | |
| Aliases | --enable-connector-bridge-mode | |
| Config File Options | connector-bridge-mode, enable-connector-bridge-mode | |
| Description | Enable the Tungsten Connector bridge mode | |
| Value Type | string | |
| Option | --connector-default-schema | |
| Aliases | --connector-forced-schema | |
| Config File Options | connector-default-schema, connector-forced-schema | |
| Description | Default schema for the connector to use | |
| Value Type | string | |
| Option | --connector-delete-user-map | |
| Config File Options | connector-delete-user-map | |
| Description | Overwrite an existing user.map file | |
| Value Type | string | |
--connector-disable-connection-warnings
| Option | --connector-disable-connection-warnings | |
| Config File Options | connector-disable-connection-warnings | |
| Description | Hide Connector warnings in log files | |
| Value Type | string | |
--connector-disconnect-timeout
| Option | --connector-disconnect-timeout | |
| Config File Options | connector-disconnect-timeout | |
| Description | Time (in seconds) to wait for active connection to disconnect before forcing them closed [default: 5] | |
| Value Type | boolean | |
--connector-drop-after-max-connections
| Option | --connector-drop-after-max-connections | |
| Config File Options | connector-drop-after-max-connections | |
| Description | Instantly drop connections that arrive after --connector-max-connections has been reached | |
| Value Type | boolean | |
| Option | --connector-keepalive-timeout | |
| Config File Options | connector-keepalive-timeout | |
| Description | Delay (in ms) after which a manager connection is considered broken by the connector if no keep-alive command was received. Value must be positive and lower than 300000 (5 min) or the connector will refuse to start. Make sure the manager has mgr-monitor-interval value set greater than this, it controls the frequency at which keep-alive commands are sent. | |
| Value Type | numeric | |
| Default | 30000 | |
| Option | --connector-listen-interface | |
| Config File Options | connector-listen-interface | |
| Description | Listen interface to use for the connector | |
| Value Type | string | |
| Option | --connector-max-connections | |
| Config File Options | connector-max-connections | |
| Description | The maximum number of connections the connector should allow at any time | |
| Value Type | numeric | |
| Option | --connector-max-slave-latency | |
| Aliases | --connector-max-applied-latency | |
| Config File Options | connector-max-applied-latency, connector-max-slave-latency | |
| Description | The maximum applied latency for Replica connections. Disabled by default. | |
| Value Type | string | |
| Default | -1 | |
| Option | --connector-readonly | |
| Aliases | --enable-connector-readonly | |
| Config File Options | connector-readonly, enable-connector-readonly | |
| Description | Enable the Tungsten Connector read-only mode | |
| Value Type | string | |
| Option | --connector-ro-addresses | |
| Config File Options | connector-ro-addresses | |
| Description | Connector addresses that should receive a r/o connection | |
| Value Type | string | |
| Option | --connector-rw-addresses | |
| Config File Options | connector-rw-addresses | |
| Description | Connector addresses that should receive a r/w connection | |
| Value Type | string | |
| Option | --connector-rwsplitting | |
| Config File Options | connector-rwsplitting | |
| Description | Enable DirectReads R/W splitting in the connector | |
| Value Type | string | |
| Option | --connector-smartscale | |
| Config File Options | connector-smartscale | |
| Description | Enable SmartScale R/W splitting in the connector | |
| Value Type | string | |
--connector-smartscale-sessionid
| Option | --connector-smartscale-sessionid | |
| Config File Options | connector-smartscale-sessionid | |
| Description | The default session ID to use with smart scale | |
| Value Type | string | |
| Option | --connector-ssl-capable | |
| Config File Options | connector-ssl-capable | |
| Description | Defines whether connector ports are advertised as being capable of SSL | |
| Value Type | boolean | |
| Default | true | |
| Valid Values | false | Do not advertise connector ports as SSL capable |
| true | Advertise connector ports as SSL capable | |
When SSL is enabled, the Connector automatically advertises the ports and itself as SSL capable. With some clients, this triggers them to use SSL even if SSL has not been configured. This causes the connections to fail and not operate correctly.
| Option | --connectors | |
| Aliases | --dataservice-connectors | |
| Config File Options | connectors, dataservice-connectors | |
| Description | Hostnames for the dataservice connectors | |
| Value Type | string | |
| Option | --consistency-policy | |
| Aliases | --repl-consistency-policy | |
| Config File Options | consistency-policy, repl-consistency-policy | |
| Description | Should the replicator stop or warn if a consistency check fails? | |
| Value Type | string | |