Standard options for all servers

These command-line options apply to all of the Crystal Enterprise servers, unless otherwise indicated. See the remainder of this section for options specific to each type of server.

Option Valid Arguments Behavior

-name

string

Specify the friendly name of the server. The server registers this name with the Crystal Management Server (CMS), and the name is displayed in the CMC. The default friendly name is hostname.servertype

Note:

Do not modify -name for a CMS.
If you modify -name for an Input or Output File Repository Server, you must include "Input." or "Output." as the prefix to the value you type for string (for example, -name Input.Server01 or -name Output.UK).

-ns

cmsname[:port]

Specify the CMS that the server should register with. Add port if the CMS is not listening on the default (6400). This option does not apply to the CMS itself.

-requestPort

port

Specify the port that the server listens on. The server registers this port with the CMS. If unspecified, the server chooses any free port > 1024.

Note:    This port is used for different purposes by different servers. Before changing, see Changing the default server port numbers.

-port

[interface:][port]

Bind WCS or CMS to the specified port, or to the specified network interface and port. Binds other servers to the specified network interface. Useful on multihomed machines or in certain NAT firewall environments.

Note:

Use -port port or -port interface:port for WCS and CMS. Use -port interface for other servers. The port command is used for different purposes by different servers. Before changing, see Changing the default server port numbers.
If you change the default port value for the CMS, you must perform additional system configuration. For more information please see Changing the default server port numbers.

-restart

Server restarts if it exits with an unusual exit code.

-fg

UNIX only. Run the daemon in the foreground. When passing the server's command line to the crystalrestart.sh script, you must use this option (see ccm.config). If you run the server's command line directly, do not use this option, because the foreground process blocks the shell until the server exits.

Option	Valid Arguments	Behavior
`-name`	`string`	Specify the friendly name of the server. The server registers this name with the Crystal Management Server (CMS), and the name is displayed in the CMC. The default friendly name is `hostname.servertype` Note: Do not modify `-name` for a CMS. If you modify `-name` for an Input or Output File Repository Server, you must include "Input." or "Output." as the prefix to the value you type for `string` (for example, `-name Input.Server01` or `-name Output.UK`).
`-ns`	`cmsname[:port]`	Specify the CMS that the server should register with. Add `port` if the CMS is not listening on the default (6400). This option does not apply to the CMS itself.
`-requestPort`	`port`	Specify the port that the server listens on. The server registers this port with the CMS. If unspecified, the server chooses any free port > 1024. Note: This port is used for different purposes by different servers. Before changing, see Changing the default server port numbers.
`-port`	`[interface:][port]`	Bind WCS or CMS to the specified `port`, or to the specified network `interface` and `port`. Binds other servers to the specified network `interface`. Useful on multihomed machines or in certain NAT firewall environments. Note: Use `-port` `port` or `-port` `interface:port` for WCS and CMS. Use `-port` `interface` for other servers. The port command is used for different purposes by different servers. Before changing, see Changing the default server port numbers. If you change the default port value for the CMS, you must perform additional system configuration. For more information please see Changing the default server port numbers.
`-restart`		Server restarts if it exits with an unusual exit code.
`-fg`		UNIX only. Run the daemon in the foreground. When passing the server's command line to the `crystalrestart.sh` script, you must use this option (see `ccm.config`). If you run the server's command line directly, do not use this option, because the foreground process blocks the shell until the server exits.

UNIX signal handling

On UNIX, the Crystal Enterprise daemons handle the following signals:

SIGTERM results in a graceful server shutdown (exit code = 0).
SIGSEGV, SIGBUS, SIGSYS, SIGFPE, and SIGILL result in a rapid shutdown (exit code = 1).

Standard options for all servers

UNIX signal handling

Related topics