This chapter describes the iwadmin command. It gives the tool's syntax, commands and command options, and examples of its usage.
The iwadmin command enables you to deploy, redeploy, and undeploy XMPP Web components that are installed with Oracle Communications Instant Messaging Server. See "iwadmin Commands and Command-Specific Options" for a list of these IM Web components. You can also use the iwadmin command to create a WAR file or a ZIP file that contains a WAR file and additional files needed for an XMPP Web component.
The location of the iwadmin command is: InstantMessaging_home/sbin/. You have to run iwadmin locally, as root, on the Instant Messaging Server host.
The syntax of the iwadmin command is:
iwadmin [ iwadmin options ] command [ command-specific options ]
There are two iwadmin options. The options can be placed anywhere after the iwadmin command:
Table 32-1 lists the iwadmin options that are available.
Option | Description |
---|---|
[ --verbose | -v ] |
Enables verbose output. |
[ --force | -f ] |
If the all command option is used (see "iwadmin Commands and Command-Specific Options") and the command fails on one Web application, this option forces a continuation to the next Web application. |
Each of the iwadmin commands, with the exception of the iwadmin list command, requires specification of an option that corresponds to a Web component provided with Instant Messaging Server. Table 32-2 lists the IM Web components.
Table 32-2 Options for Web Components Provided with the Instant Messaging Server
Web Component | Description |
---|---|
httpbind |
Can be used with all iwadmin commands, except for the iwadmin list command. |
presenceapi |
This option corresponds to the Web Presence API. It can only be used with the iwadmin generatezip command. See "Using the Web Presence API" for more information on the Web Presence API |
Table 32-3 lists iwadmin commands and command-specific options.
Table 32-3 iwadmin Command and Command-Specific Options
Command and Command-Specific Options | Description |
---|---|
generatezip IM_Web_component [--configfile | |
Creates a ZIP file for deploying Instant Messaging Server. The ZIP file contains:
The --configfile or -c parameter specifies the future location of the configuration file for the Web Presence API, once the ZIP file is unzipped. The location of the configuration file must be given as an absolute path. The --destination or -d parameter specifies the destination directory and file name for the ZIP file. The destination must be given as an absolute path and the destination directory must exist before you generate the ZIP file. |
The following examples show how to use the iwadmin command.
To print a summary of iwadmin usage:
iwadmin
To create a ZIP file containing a WAR file and other files needed for deploying the presenceapi IM Web component (see generatezip in Table 32-3):
iwadmin generatezip presenceapi -c /opt/components/presence/config -d /opt/components/presence/config/deploy/presenceapi.zip