# set server

    set server parameter=value [parameter=value ...]

The set server command can control many parameters. Multiple parameters are separated by spaces. The following table describes the parameters you can set with this command.

Parameter | Description
--- | ---
`password [=` `string``]` | Sets server password used by the server to connect to other routed servers. If the value is omitted it is prompted for by the administration tool. Entered value will be stored in the main server configuration file in mangled form (but not encrypted). To reset this password, enter the empty string twice at the prompt.
`authorization=enabled|disabled` | Sets the `authorization` mode in the tibemsd.conf file. After a transition from disabled to enabled, the server checks ACL permissions for all subsequent requests. While the server requires valid authentication for existing producers and consumers, it does not retroactively reauthenticate them; it denies access to users without valid prior authentication.
`log_trace=trace-items` | Sets the trace preference on the file defined by the `logfile` parameter. If `logfile` is not set, the values are stored but have no effect. The value of this parameter is a comma-separated list of trace options. For a list of trace options and their meanings, see Server Tracing Options. You may specify trace options in three forms: plain A trace option without a prefix character replaces any existing trace options. + A trace option preceded by + adds the option to the current set of trace options. - A trace option preceded by - removes the option from the current set of trace options. Examples The following example sets the trace log to only show messages about access control violations.
    log_trace=ACL
The next example sets the trace log to show all default trace messages, in addition to SSL messages, but ADMIN messages are not shown.
    log_trace=DEFAULT,-ADMIN,+SSL
`console_trace=console-trace-items` | Sets trace options for output to `stderr`. The values are the same as for `log_trace`. However, console tracing is independent of log file tracing. If `logfile` is defined, you can stop console output by specifying:
    console_trace=-DEFAULT
Note that important error messages (and some other messages) are always output, overriding the trace settings. Examples This example sends a trace message to the console when a TIBCO Rendezvous advisory message arrives.
    console_trace=RVADV
`client_trace={enabled|disabled}  [target=``location``] [filter=``value``]` | Administrators can trace a connection or group of connections. When this property is enabled, the client generates trace output for opening or closing a connection, message activity, and transaction activity. This type of tracing does not require restarting the client program. The client sends trace output to location, which may be either `stderr` (the default) or `stdout`. You can specify a filter to selectively trace specific connections. The filter can be user, `connid` or `clientid`. The value can be a user name or ID (as appropriate to the filter). When the filter and value clause is absent, the default behavior is to trace all connections. Setting this parameter using the administration tool does not change its value in the configuration file `tibemsd.conf`.
`max_msg_memory=``value` | Maximum memory the server can use for messages. For a complete description, see `max_msg_memory` in `tibemsd.conf`. Specify units as `KB`, `MB` or `GB`. The minimum value is `8MB`. Zero is a special value, indicating no limit. Lowering this value will not immediately free memory occupied by messages.
`msg_swapping=enabled|disabled` | Enables or disables the ability to swap messages to disk.
`track_message_ids=enabled|disabled` | Enables or disables tracking messages by MessageID.
`track_correlation_ids=enabled|disabled` | Enables or disables tracking messages by CorrelationID.
`ssl_password[=``string``]` | This sets a password for SSL use only. Sets private key or PKCS#12 file password used by the server to decrypt the content of the server identity file. The password is stored in mangled form.
`ft_ssl_password[=``string``]` | This sets a password for SSL use with Fault Tolerance. Sets private key or PKCS#12 file password used by the server to decrypt the content of the FT identity file. The password is stored in mangled form.
`server_rate_interval=``num` | Sets the interval (in seconds) over which overall server statistics are averaged. This parameter can be set to any positive integer greater than zero. Overall server statistics are always gathered, so this parameter cannot be set to zero. By default, this parameter is set to 1. Setting this parameter allows you to average message rates and message size over the specified interval.
`statistics=enabled|disabled` | Enables or disables statistic gathering for producers, consumers, destinations, and routes. By default this parameter is set to disabled. Disabling statistic gathering resets the total statistics for each object to zero.
`rate_interval=``num` | Sets the interval (in seconds) over which statistics for routes, destinations, producers, and consumers are averaged. By default, this parameter is set to 3 seconds. Setting this parameter to zero disables the average calculation.
`detailed_statistics=` `NONE | PRODUCERS,``CONSUMERS,ROUTES` | Specifies which objects should have detailed statistic tracking. Detailed statistic tracking is only appropriate for routes, producers that specify no destination, or consumers that specify wildcard destinations. When detailed tracking is enabled, statistics for each destination are kept for the object. Setting this parameter to NONE disables detailed statistic tracking. You can specify any combination of PRODUCERS, CONSUMERS, or ROUTES to enable tracking for each object. If you specify more than one type of detailed tracking, separate each item with a comma.
`statistics_cleanup_interval=num` | Specifies how long (in seconds) the server should keep detailed statistics if the destination has no activity. This is useful for controlling the amount of memory used by detailed statistic tracking. When the specified interval is reached, statistics for destinations with no activity are deleted.
`max_stat_memory=``num` | Specifies the maximum amount of memory to use for detailed statistic gathering. If no units are specified, the amount is in bytes, otherwise you can specify the amount using KB, MB, or GB as the units. Once the maximum memory limit is reached, the server stops collecting detailed statistics. If statistics are deleted and memory becomes available, the server resumes detailed statistic gathering.

Copyright © Cloud Software Group, Inc. All rights reserved.