Professional Documents
Culture Documents
Domino ServerChapter 13
Domino ServerChapter 13
The Domino server console supports redirection for both input and output with the > and < operators. You
can create a text file of server commands, then issue the name of the file on the server console to run the
command listed in this batch file of server commands. The default location of this file is\LOTUS\DOMINO,
so if another location is specified, then the fully qualified filename of this file must be entered at the server
console. A use for this could be when you wish to push changes now from a hub server to all the spoke
servers in the company, rather than wait until the replication schedule. You could have a text file on the hub
server that contains a series of PUSH commands to each server, and run this just by typing the name of this
command file.
You can also redirect the console output into a file. If you use Domino Administrator, you can see that under
the hood, this is how it gets some of the server information about task and user status. Figure 13-3 shows
examples of both types of command redirection (the meaning of the actual commands listed will be
explained later in this chapter).
Figure 13-3. Redirection of input and output with the Domino server console
The basic commands are listed here, and then each is described in further detail:
broadcast
Sends a broadcast message to specified users or to all users.
dbcache
Displays, disables, or flushes the Domino database cache.
drop
Drops the server sessions for specified users or all users.
exit
Stops the Domino server.
help
Lists all Domino servers available.
load
Starts a task on the server.
platform
Works with the collection of operating system statistics by Domino.
pull
Starts replication now from the specified server.
push
Starts replication now to the specified server.
quit
Stops the Domino server.
replicate
Starts replication now from/to the specified server.
restart
Stops and restarts the Domino server or the specified communication port.
route
Starts mail routing with the specified server.
set
Makes changes to the Domino server configuration.
show
Displays information about the Domino server.
start port
Enables the given Domino port for network connections.
stop port
Disables the given Domino port for network connections.
tell
Issues a command to a Domino server task.
trace
Tests the connection to another server.
broadcast (b)
This is a broadcast message from the server console to either nominated users or to all connected users to the
server. This message is displayed in the status bar of the Notes client with no warning sound, so it can be
very easy to for users to miss the message.
Syntax
broadcast message
broadcast message users
Command options
message
The message you wish to send. For messages containing spaces, enclose the entire message in quotation
marks to ensure that it is processed as the message content.
users
Defines which users receive the message. If this parameter is not specified, the command applies to all
connected users. If a name is a specified, it should be enclosed in quotes.
Examples
> b "Please close all open Domino databases for scheduled maintenance"
07/11/99 09:16:06 PM BROADCAST from shoreline/Alameda: Please close all open Domino databases for
scheduled maintenance
> b "Please call the help desk on xtn5555" "Greg Neilson/Alameda"
07/11/99 09:16:41 PM BROADCAST from shoreline/Alameda: Please call the help desk on xtn5555 [Greg
Neilson/Alameda]
dbcache
Domino uses the database cache to keep open the most recently used databases for performance reasons.
However, sometimes you may need to work with one of the databases within the cache (perhaps to restore
from backup). You can use these commands to view the contents of the database cache, disable the use of
the cache, and flush out the contents of the database cache.
Syntax
dbcache show
dbcache disable
dbcache flush
Command options
show
Displays the current opened databases in the database cache.
disable
Disables the server from using the database cache.
flush
Flushes out the open databases that were in the database cache.
Examples
This is the output from a dbcache show command to display which databases are currently open in the
cache:
> dbcache show
ILLEGAL 3 0 0 0 0
OPEN_DB 25 0 541 1373 54
GET_SPECIAL_NOTE_ID 2 0 10 10 5
OPEN_NOTE 3 10 30 60 20
CLOSE_DB 20 0 20 20 1
POLL_DEL_SEQNUM 7 0 20 20 2
SERVER_AVAILABLE_LITE 53 0 0 0 0
START_SERVER 65 0 902 2635 40
REGISTER_MONITOR_RQST 3 0 20 20 6
MONITOR_GETEVENTS_RQST 12 0 70 80 6
FINDDESIGN_NOTES 3 0 20 20 6
This is an example of the SHOW CLUSTER command:
> sh cl
Cluster Information
Cluster name: Cluster1, Server name: shoreline/Alameda
Server cluster probe timeout: 1 minute(s)
Server cluster probe count: 72
Server availability threshold: 0
Server availability index: 100 (state: AVAILABLE)
Cluster members (2)...
server: shoreline/Alameda, availability index: 100
server: westline/Alameda, availability index: 100
See Also
set configuration, set statisics
start port
This command enables the network port for communications in Domino.
Syntax
start port portname
Command options
portname
The currently enabled ports for Domino are defined in the Ports= line in NOTES.INI. The default ports that
are available to be configured (others can be defined if needed)
are TCPIP, LAN0ip, VINES, SPX, Appletalk, LAN1-LAN8 (NetBIOS), and COM1-COM5.
Examples
start port tcpip enables the TCP/IP port to be used for Domino network communications.
See Also
show allports, stop port, restart port
stop port
This command disables the network port for communications in Domino.
Syntax
stop port portname
Command options
portname
The currently enabled ports for Domino are defined in the Ports= line in NOTES.INI. The default ports that
are available to be configured (others can be defined if needed)
are TCPIP, LAN0ip, VINES, SPX, Appletalk, LAN1-LAN8 (NetBIOS), and COM1-COM5.
Examples
stop port tcpip disables this port from being used for Domino communications.
See Also
show allports, start port, restart port
tell (t)
Used to issue a command to a running Domino server task. Every task responds to the quit command, but
some tasks have special options available to control their operation.
Syntax
tell task quit
tell task [options]
Command options
task quit
Stops the task.
trace (tr)
Used to test whether a server can successfully connect to another. There is also an option to specify which
port to use to test the connection.
Syntax
trace servername
trace portname!!!servername
Command options
servername
The name of the server you wish to test the connection to.
portname
The name of the server communication port you optionally wish to use to connect to the other server.
Examples
Output from a successful invocation of trace servername :
> trace westline/alameda
Determining path to server WESTLINE/ALAMEDA
Enabled Ports: TCPIP
Checking normal priority connection documents only...
Local network connection document found for westline/Alameda
Verifying address 'westline.alameda.com' for WESTLINE/ALAMEDA on TCPIP
Requesting IP Address for westline.alameda.com from DNS
DNS returned address 10.0.0.11 for westline.alameda.com
Connected to server WESTLINE/ALAMEDA
See Also
show allports, start port, stop port, restart port