Appendix B
Instant Messaging 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. On the Solaris platform, run imadmin as root or the end user specified during the installation.
Requirements:
You must invoke the imadmin utility from the host on which Instant Messaging server is installed.
Location:
- On Solaris: instant-messaging-installation-directory/SUNWiim/sbin
- On Windows: instant-messaging-installation-directory\sbin
Table B-1 lists and describes commands related to the imadmin command.
Table B-1 The imadmin Commands with Descriptions
Command
|
Description
|
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 migrate
|
Generates Sun ONE Identity Server policies based on current policy access control files.
|
imadmin version
|
Prints version
|
Synopsis
imadmin [options] [action] [component]
Options
Table B-2 lists and describes options (Solaris platform only) 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
|
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
|
server
|
Indicates the Instant Messaging server.
|
multiplexor
|
Indicates the Instant Messaging multiplexor alone.
|