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 APS, and the name is displayed in the CMC and the CCM. The default friendly name is hostname.servertype

Note:    Do not modify -name for Input or Output File Repository Servers.

-ns

apsname[:port]

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

-requestPort

port

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

Note:    Before changing, see Changing the default server port numbers.

-port

[interface:]port

Bind server to the specified port, or to the specified network interface and port. Useful on multihomed machines.

Note:

Before changing, see Configuring Crystal Enterprise on a multihomed machine.
Use -psport to differentiate a Page Server from a Cache Server. For details, see Page Server and Cache Server.

-maxlogfilesize

bytes

Replace bytes with 0 (zero) to eliminate log files. The default value is 512 KB. For details, see Logging server activity.

-restart

Windows only. Server restarts if it exits with an unusual exit code. For UNIX, see crystalrestart.sh.

-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 APS, and the name is displayed in the CMC and the CCM. The default friendly name is `hostname.servertype` Note: Do not modify `-name` for Input or Output File Repository Servers.
`-ns`	`apsname[:port]`	Specify the APS that the server should register with. Add `port` if the APS is not listening on the default (6400). This option does not apply to the APS itself.
`-requestPort`	`port`	Specify the port that the server listens on. The server registers this port with the APS. If unspecified, the server chooses any free port > 1024. Note: Before changing, see Changing the default server port numbers.
`-port`	`[interface:]port`	Bind server to the specified `port`, or to the specified network `interface` and `port`. Useful on multihomed machines. Note: Before changing, see Configuring Crystal Enterprise on a multihomed machine. Use `-psport` to differentiate a Page Server from a Cache Server. For details, see Page Server and Cache Server.
`-maxlogfilesize`	`bytes`	Replace `bytes` with 0 (zero) to eliminate log files. The default value is 512 KB. For details, see Logging server activity.
`-restart`		Windows only. Server restarts if it exits with an unusual exit code. For UNIX, see crystalrestart.sh.
`-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