PMDF System Manager's Guide


Previous Next Contents Index


restart

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 the names of 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-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-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.


Previous Next Contents Index