Sun Java System Instant Messaging 7.2 Administration Guide

Appendix C Instant Messaging imadmin Tool Reference

This chapter explains the imadmin command used to administer Instant Messaging in the following sections:

imadmin Overview

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.

imadmin Requirements

You must invoke the imadmin utility from the host on which Instant Messaging server is installed.

imadmin Location

By default, imadmin is installed in the following location:


imadmin Commands

Table C–1 lists and describes commands related to the imadmin command.

Table C–1 imadmin Commands and Descriptions



imadmin assign_services

If iim.policy.modules is set to identity, this command assigns Instant Messaging and presence services to existing users under the base DN you specify. The DN should be the base DN of the organization under which user entries are stored.

If iim.policy.modules is set to iim_ldap, and is set to ldap, this command adds objectclasses (sunIMUser, and sunPresenceUser) to user entries in the directory. Instant Messaging requires these objectclasses in order to store properties in LDAP.

imadmin status

(Previously 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 component(s). 

imadmin stop

Stops the enabled component(s). 

imadmin refresh

Refreshes the enabled 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 version

Displays the version. 

imadmin Syntax

imadmin [options] [action] [component]

imadmin Options

Table C–2 lists and describes options for the imadmin command.

Table C–2 Options for imadmin command



-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


Displays help on the imadmin command.

imadmin Actions

Table C–3 lists and describes actions performed after various imadmin commands are issued.

Table C–3 Actions for imadmin Command




(Previously imadmin check)

Returns information about Instant Messaging components (server, multiplexor, agent-calendar, and watchdog). You do not need to provide a [component] with this action.


Sets the classpath, the Java heap size and starts all the specified components.


Stops all the specified component’s daemons. 


Stops and starts the specified component(s). Useful after a configuration change. 

imadmin Components

Table C–4 lists and describes the components for the imadmin command.

Table C–4 Components for imadmin Command




Indicates the Calendar agent (agent-calendar).


Indicates the multiplexor alone. 


Indicates the Instant Messaging server. 


Indicates the watchdog.