Sending Controller and shell commands from a remote console

A server can run under a Java-based Controller; this starts the server when you start the Controller.

About this task

You can use remote consoles in the Domino® Administrator or Web Administrator to send commands to a server that runs under a Controller. You can send Controller commands and shell (operating system) commands, as well as Domino® server commands. There is also a Java-based remote console available called the Domino® Console that you can use to connect to a Controller.

To send a shell command to a Controller from a remote console, use the prefix $, for example:

$Dir c:\tmp

To send a Controller command, use the prefix #, for example:

#Start Domino

If you are sending several shell or Controller commands, you can change to Shell or Controller command mode in a remote console by entering the appropriate prefix in the Command box and pressing enter. Then you do not have to specify the prefix each time you send a command. To exit the specified command mode, enter the prefix again.

For example, to enter the Controller command mode, enter # in the Command box. When you are done sending Controller commands, enter # again to exit Controller command mode.

Table 1. Available Controller commands
Controller command	Description
Broadcast message	Broadcasts a specified message to all administrators connected to the Controller
Disable username(s)	Disables a specified administrator's connection to the Controller. Connection remains disabled until you use the Enable User command or until you quit and restart the Controller. To disable more than one administrator's connection, specify multiple names, separated by commas, for example: `#Disable user1,user2`
Enable username(s)	Enables an administrator's connection that you previously disabled using the Disable User command. To enable more than one administrator's connection, specify multiple names, separated by commas, for example: `#Enable user1,user2`
Kill Domino®	Stops the processes on a server that is not responding
Quit	Stops the Domino® server and the Server Controller
Refresh Admins	Refreshes the Controller's information about administrators from the Domino® Directory
Restart Domino®	Stops the processes on a server that is not responding and then restarts the server
Set ControllerLogExpiration=days	Specifies the number of days worth of log files to keep on the server. Default is 7 days. Change takes effect at midnight or when you restart the Server Controller.
Set ControllerLogFileName=path filename	Specifies the name and path of log files created on a server. By default, log files are stored in the server's data directory with filenames that begin with the text dcntrlr, followed by the creation date, a sequence number and the file extension .log or .meta. You can specify a different path, and can specify text to replace the dcntrlr portion of the log file names. Change takes effect at midnight or when you restart the Server Controller.
Set ControllerLogType=value	Specifies which type(s) of log file(s) to create on a server or prevents the creation of log files. 0 -- Do not create log files 1 -- Create .log files that log only data normally seen at a console 2 -- Create .meta files that log data normally seen at a console as well as additional details, such as color, font, and event filter settings 3 -- Create both .log files and .meta files simultaneously Setting takes effect immediately.
Show Users	Shows the administrators currently connected to the Controller
Show Processes	Shows the tasks running on the Domino® server
Start Domino®	Starts the Domino® server