Server startup utility (start_iq)

The server startup switches in Table A-8 are used to configure Sybase IQ multiplex servers at startup.

Table A-8: Server startup switches

Startup switch

Values

Description

-iqmpx_failover

1

Initiates multiplex coordinator failover to establish the designated failover Secondary node as the new coordinator. Starting the coordinator with this option has no effect.

-iqmpx_ov

1

Performs multiplex configuration override for the current node. Used to change node properties during startup in the event that a node's location or other property has changed.

-iqmpx_sn

1

Runs the current node in multiplex in single node mode. This mode is used exclusively for fixing problems with the multiplex configuration and should be used with extreme caution. Requires all other nodes in the multiplex to be shut down. Recommended only for use on the coordinator node.

-iqmpx_reclaimwriterfreelist

server name

This option applies only while restarting a coordinator node. The coordinator will forcefully reclaim the free-list of the writer node identified by server-name. This switch is only needed in the event that a Writer fails and cannot be restarted.

-iqmsgnum num

0-64 (inclusive)

Specifies the number of archives of the old message log maintained by the server. Default value is 0, which means that messages are wrapped in the main message log file. Takes effect only if -iqmsgsz or the IQMsgMaxSize server property is non-zero. The IQMsgNumFiles server property corresponds to -iqmsgnum and takes precedence over the value of -iqmsgnum.

-iqmsgsz size

integers 0-2047 (inclusive) in megabytes.

Limits the maximum size of the message log. The default value is 0, which specifies no limit on the size of the message file.