Return to Index

Script to Start/stop/check-status/restart eContent Servers on UNIX

Download it now.

(All examples assume a docbase named "devdoc1" exists.)

This script can be installed (FTP to server as installation owner and CHMOD to 750) on any UNIX eContent Server.

It will allow the user to quickly start/stop/check-status/restart eContent Servers (one or all on local server).

The "restart" feature is especially great for developers, since it automates the dm_shutdown_docbase...dm_start_docbase nonsense.
EXAMPLE:
dctmctrl restart devdoc1

The "status" features is good, because you can quickly make sure that your docbases are "up" (or down) and if up, that they're able to accept connections, etc.
EXAMPLE:
dctmctrl status
(Will provide a status for the docbroker and ALL docbases located on the server.)

dctmctrl status devdoc1
(Provides status info for docbase only.)

The "start"/"stop"/"restart" all check the database connection before attempting to start, to insure that the RDBMS is ready for the eContent Server. (The script is database independent.)

Simply executing the script without any parameters will give you the usage statement. For example:

dmadmin@uswodoc0:>dctmctrl
USAGE: dctmctrl stop | start | restart | status [-q[uick]] [ <docbase name> ]
stop = STOP all (or named) docbases and docbroker
start = START all (or named) docbases and docbroker
restart = STOP then START all (or named) docbases and docbroker
status = Display up/down state of configured eContent Servers
-q[uick] = don't attempt to connect just check procs.
(only valid for 'status')
dmadmin@uswodoc0:>

FINALLY, the script is excellent to be included in the server's startup/shutdown (rc.d) scripts since it'll startup or shutdown all Documentum processes when not supplying any explicit docbases, and accepts standard UNIX rc-syntax (i.e. passing a "start" or "stop" as parameter one).

For example, a startup/shutdown script that could be linked to the appropriate rc... directories could be as simple as:

#!/sbin/sh

case "$1" in
'start')
su - dmadmin -c "/opt/documentum/dba/dctmctrl $1"
;;

'stop')
su - dmadmin -c "/opt/documentum/dba/dctmctrl $1"
;;
esac