Sun Java System Calendar Server 6 2005Q4 Administration Guide


The cstool utility can ping one of the following:

The cstool utility can also display its version number.

The cstool can not be used to ping the following processes:

Note –

To refresh the configuration, use stop-cal, then start-cal to stop and then restart Calendar Server.

Do not use cstool to refresh the configuration. It could cause unpredictable negative outcomes.

For more information, see Starting and Stopping Calendar Server.



cstool [-q|-v] 
       [-h host] 
       [-p port] 
       [-t timeout] 
       ping [http|ens]

cstool [-q|-v] 
       [-h host] 

The following table describes cstool commands and their parameters.

Table D–36 cstool Utility Commands






neither parameter specified 

Ping the cshttpd process, the csadmind process, or the ENS process (enpd)

Ping the server where Calendar Server is located. 



Display the version of the utility. 

The following table describes the cstool utility options.

Table D–37 cstool Utility Command Options




Run in verbose mode: Display all available information about the command being performed. Default is off. 


Run in quiet mode: 

  • Display no information if the operation is successful (errors, if they occur, are displayed).

  • Suppress confirmation prompting for dangerous commands.

    Default is off.

-h host

Specifies host name of the machine on which Calendar Server is running. The default value is set at installation and taken from the local.hostname parameter in the ics.conf file. Use this option if you are accessing a Calendar Server running on a remote machine.

-p port

The port of the specified service, or if no service is specified, use the default value of the port as defined in the ics.conf file. 

-t timeout

The amount of time (in seconds) to wait for a response from the server. The default is 120 seconds.