PMDF System Manager's Guide
PMDF-REF-6.0

Restart PMDF components.

Syntax

pmdf restart [component]

Command Qualifiers	Defaults
None.	None.

restrictions

On UNIX, must have superuser privileges in order to use this utility.

PARAMETERS

component

Optional parameter which specifies a specific PMDF component to be restarted. On UNIX, the components which may be restarted with this utility are job_controller, dispatcher, smtp, pop3, imap, http, poppassd, or x400, or the names of PMDF-XGS, or PMDF-LAN Lotus Notes, or PMDF-DIRSYNC Lotus Notes servers. On NT, the components which may be restarted with this utility are job_controller or dispatcher. Note that restarting the PMDF Service Dispatcher, i.e., the dispatcher component, effectively restarts all the service components it handles, which may include smtp, pop3 (the system mailbox POP server), pop_server (the PMDF MessageStore POP server), imap (the system mailbox IMAP server), imap_server (the PMDF MessageStore IMAP server), http, and poppassd, and PMDF-XGS channel servers, PMDF-LAN Lotus Notes channel servers, and PMDF-DIRSYNC Lotus Notes directory agent servers. If no component name is given, then all active components will be restarted.

DESCRIPTION

Detached PMDF processes should be restarted whenever the PMDF configuration is altered---these processes load information from the configuration once only and need to be restarted in order for configuration changes to become visible to them. In addition to general PMDF configuration files such as the pmdf.cnf file, note that components such as the Service Dispatcher have their own specific configuration files, e.g., dispatcher.cnf, and should be restarted after changes to any of these files.

If no component name is specified, then the pmdf restart utility stops any old PMDF Job Controller or PMDF Service Dispatcher jobs that might be running, and restarts the PMDF Job Controller and PMDF Service Dispatcher. If a component parameter is specified, then only detached processes associated with that component will be restarted.

On UNIX, the standard component names are:

Component	Description
circuit_check	Detached process that monitors loopback message delivery.
dispatcher	PMDF multithreaded Service Dispatcher handling services such as SMTP, POP, IMAP, and HTTP servers.
http	HTTP server processes.
imap	This restarts IMAP server processes serving out PMDF MessageStore mailboxes, and restarts IMAP server processes serving out system mailboxes.
imap_server	IMAP server processes serving out PMDF MessageStores mailboxes.
job_controller	PMDF Job Controller.
pop_server	PMDF MessageStore POP server processes (serving out PMDF MessageStore mailboxes and PMDF popstore mailboxes).
pop3	This restarts PMDF MessageStore POP server processes (serving out PMDF MessageStore mailboxes and PMDF popstore mailboxes), and also restarts POP server processes serving out system mailboxes.
poppassd	POPPASSD server processes.
smtp	SMTP server processes.
x400	PMDF-X400 TSAPD listener process.

In addition, PMDF-XGS, PMDF-LAN Lotus Notes, and PMDF-DIRSYNC Lotus Notes servers may be restarted with this utility by specifying the name of the particular service (as defined in the Dispatcher configuration file).

On NT, the components that may be restarted with this utility are:

Component	Description
circuit_check	Detached process that monitors loopback message delivery.
dispatcher	PMDF multithreaded Service Dispatcher handling services such as SMTP, POP, IMAP, and HTTP servers.
job_controller	PMDF Job Controller.

EXAMPLES

# pmdf restart

The above UNIX command restarts the PMDF jobs.

C:\> pmdf restart

The above NT command restarts the PMDF jobs.