Appendix B
Instant Messaging imadmin Tool Reference
This chapter explains the imadmin command used to administer Instant Messaging.
imadmin
You can use the imadmin utility to start, stop, and refresh the Instant Messaging server and multiplexor. Run imadmin as root or as the end user you specified during configuration.
Requirements:
You must invoke the imadmin utility from the host on which Instant Messaging server is installed.
Location:
im_svr_base/sbin
Table B-1 lists and describes commands related to the imadmin command.
Table B-1 imadmin Commands with Descriptions
Command
|
Description
|
imadmin check
|
Checks to see if the components (server, multiplexor, agent-calendar, and watchdog) are up and running and displays the results. If you don’t specify a component, the imadmin utility returns information about all components.
|
imadmin start
|
Starts the enabled server and/or multiplexor component(s).
|
imadmin stop
|
Stops the enabled server and/or multiplexor component(s).
|
imadmin refresh
|
Refreshes the enabled server and/or multiplexor component(s).
|
imadmin start server
|
Starts only the server.
|
imadmin stop server
|
Stops only the server.
|
imadmin refresh server
|
Refreshes only the server.
|
imadmin start multiplexor
|
Starts only the multiplexor.
|
imadmin stop multiplexor
|
Stops only the multiplexor.
|
imadmin refresh multiplexor
|
Refreshes only the multiplexor.
|
imadmin start agent-calendar
|
Starts only the Calendar agent.
|
imadmin stop agent-calendar
|
Stops only the Calendar agent.
|
imadmin refresh agent-calendar
|
Refreshes only the Calendar agent.
|
imadmin start watchdog
|
Starts only the watchdog.
|
imadmin stop watchdog
|
Stops only the watchdog.
|
imadmin refresh watchdog
|
Refreshes only the watchdog.
|
imadmin migrate
|
Generates Sun Java System Access Manager policies based on current policy access control files. See the Sun Java Enterprise System 2005Q1Upgrade and Migration Guide at:
http://docs.sun.com/doc/819-0062
|
imadmin version
|
Displays the version
|
Synopsis
imadmin [Solaris_options] [action] [component]
Options
Table B-2 lists and describes options for the imadmin command.
Table B-2 Options for imadmin command
Option
|
Description
|
-c alt-config-file
|
Used with the start and refresh actions, to specify a different configuration file other than /etc/opt/SUNWiim/config/iim.conf file
|
-h
|
Displays help on the imadmin command.
|
Actions
Table B-3 lists and describes actions performed after various imadmin commands are issued.
Table B-3 Actions for imadmin Command
Option
|
Description
|
check
|
Returns information about Instant Messaging components (server, multiplexor, agent-calendar, and watchdog). You do not need to provide a [component] with this action.
|
start
|
Sets the classpath, the Java heap size and starts all the specified components.
|
stop
|
Stops all the specified component’s daemons.
|
refresh
|
Stops and starts the specified component(s). Useful after a configuration change.
|
Components
Table B-4 lists and describes the components for the imadmin command.
Table B-4 Components for imadmin Command
Option
|
Description
|
agent-calendar
|
Indicates the Calendar agent (agent-calendar).
|
multiplexor
|
Indicates the multiplexor alone.
|
server
|
Indicates the Instant Messaging server.
|
watchdog
|
Indicates the watchdog.
|