Common Reference

cctrl Command-line Options

Applies to: Tungsten Clustering for MySQL

The following options can be passed on the command line with the cctrl command:

Usage

cctrl [options]

Option	Description
`-admin`	Enter admin mode when connecting.
`-expert`	Enter expert mode when connecting.
`-host`	Host name of the service manager to use.
`-logical`	Enter logical mode when connecting.
`-multi`	Allow support for connecting to multiple services.
`-no-history`	Disable command history.
`-physical`	Enter physical mode when connecting.
`-port`	Specify the TCP/IP port of the service manager. Default: `9997`
`-proxy`	Operate as a proxy service.
`-service`	Connect to a specific service.
`-timeout`	Specify timeout (in seconds) to determine how long to wait before timing out when unable to connect to the manager. Default: `30`

These commands and options are described below:

`-admin`

Automatically enters admin mode when cctrl connects to the cluster:

shell> cctrl -admin
Tungsten Clustering 8.0.4 Build 132
alpha: session established, encryption=false, authentication=false
[ADMIN] /alpha >

`-expert`

Automatically enters expert mode when cctrl connects to the cluster:

shell> cctrl -expert
Tungsten Clustering 8.0.4 Build 132
alpha: session established, encryption=false, authentication=false
LOGICAL:EXPERT] /alpha >

`-host`

Allows you to specify the host to connect to when looking for a manager. By default, cctrl will connect to the local host:

shell> cctrl -host host1
Tungsten Clustering 8.0.4 Build 132
alpha: session established, encryption=false, authentication=false
[LOGICAL] /alpha >

`-logical`

Automatically enters logical mode when cctrl connects to the cluster. This mode is the default when connecting to a typical topology; using this option forces this mode:

shell> cctrl -logical
Tungsten Clustering 8.0.4 Build 132
alpha: session established, encryption=false, authentication=false
[LOGICAL] /alpha >

`-multi`

By default, cctrl connects to the first local standalone service within the configuration. Using the-multi option, cctrl will connect you at the root level.

For example, without -multi option:

shell> cctrl 
Tungsten Clustering 8.0.4 Build 132
alpha: session established, encryption=false, authentication=false
[LOGICAL] /alpha >

With the option:

shell> cctrl -multi
Tungsten Clustering 8.0.4 Build 132
alpha: session established, encryption=false, authentication=false
[LOGICAL] / >

`-no-history`

Prevents cctrl from accessing or recording command history during interaction.

`-physical`

Automatically enters physical mode when cctrl connects to the cluster. This mode is the default when connecting to a typical topology; using this option forces this mode:

shell> cctrl -physical
Tungsten Clustering 8.0.4 Build 132
alpha: session established, encryption=false, authentication=false
[PHYSICAL] resource://>

`-port`

Default	`9997`

Specify the TCP/IP port of the service manager.

`-proxy`

Operate as a proxy service.

`-service`

Enables the selection of a specific service when first connecting to the cluster. For example:

shell> cctrl -service east_from_west
__dynxml_productintverbuild__
east: session established, encryption=false, authentication=false
east_from_west: session established, encryption=false, authentication=false
[LOGICAL] /east_from_west >

`-timeout`

Default	`30`

Specify timeout (in seconds) to determine how long to wait before timing out when unable to connect to the manager.