Starting the Sun Messaging Connectivity Services

The following information describes how to use the smcs start up script. This utility is used to perform a variety of maintenance functions for SMCS. This utility should not be modified. Do not edit the SMCS script.

The smcs Utility

The following information describes the arguments and command-line syntax for the smcs start up script.

smcs [-p number] [-d directory] backup

backup restricts access to SMCS and performs a copy of essential files into another location. It is recommended to backup to disk first, and then use normal backup procedures. The target directory should be empty because multiple files are backed up and if the directory is not empty you will not know the name of the files.

smcs delete

delete removes all nonstandard files from an SMCS configuration. It also removes SMCS installed entries from the running directory.

smcs [-p number] dirsync

dirsync starts a Directory Synchronization based on the current configuration. This command is normally run periodically from cron if the user has scheduled a dirsync from the directory UI.

smcs getport

Returns the MMAD port number.

smcs [-p number] initialize

initialize prompts for variables that are used to configure a newly-installed SMCS configuration. The initialize option can be used with new installations or after using smcs delete. The following is a sample initialization script:

WARNING: Initialize is a non-reversible, destructive operation!   Are you sure you want to continue? (y/[n]) y   Please enter the SMCS Search Base DN: ou=abc,o=xyz,c=us   Please enter the SMCS Root DN: ou=services,ou=abc,o=xyz,c=us   Please enter the fully qualified local host name: abc.xyz.com   Please enter the IMTA->SMCS SMTP port [27]:   Please enter the Administrator DN: cn=admin,o=xyz,c=us   Please enter the directory Administrator password:

smcs [-p number] nightly

nightly is added to cron during installation and runs a series of maintenance and informational routines such as clean-up and maintenance of message queues. nightly is run at least once per day from cron. The standard output from this command is mailed to the postmaster (usually root).

The following tasks are executed the smcs nightly script. Create a file in /etc/opt/SUNWmail/gtw/cfg called nightly_opts to change the default options. The nightly_opts file should have an entry for each of the options. The following is a sample nightly_opts file. The default options are listed.

NIGHTLY_TIDY = 1 /* Send back undeliverable messages */   NIGHTLY_R_TMP = 1 /* Removes temporary files */   NIGHTLY_PURGE = 0 /* Delete messages older than 3 days */   NIGHTLY_BACKUP = 0 /* Backup and configuration */

smcs [-p number] purge

purge removes all queued messages with a "Deleted" status, plus any miscellaneous tracing logs.

smcs [-p number] restart

restart confirms that the MMA is running, and restarts it if it is idle. smcs restart is frequently run from root's crontab. By default, restart is set to run every 10 minutes.

smcs [-d directory] restore

restore performs the complement to the backup operation and should be performed with caution as a restore replaces the current configuration. The target directory should be the same directory that was used with the -d option in the smcs backup utility.

smcs setport

Prompts the user for the new MMAD port number. SMCS then sets the MMAD port number accordingly.

smcs [-p number] start

start starts the SMCS Management Agent (MMAD) and then attempts to start the Router, the Transports, and the configured channels. The -p option is needed only if the management agent is running on a port other than the default (2585), which is not recommended. smcs start is part of the system initialization scripts and is, by default, added to /etc/inittab by the installation script.

smcs [-p number] stop

stop stops the MMA in a process similar to smcs start. You should only run this when serious problems occur, such as, the system shuts down, or a restoration is needed.