Sun Java System Instant Messaging 7.2 Administration Guide

Chapter 3 Instant Messaging Configuration File and Directory Structure Overview

This chapter provides information about the configuration files you use to administer Instant Messaging. Familiarize yourself with the locations of these files before making changes to your deployment’s configuration.

This chapter describes the Instant Messaging server directory structure and the properties files used to store Instant Messaging operational data and configuration information in the following sections:

Instant Messaging Server Directory Structure

Instant Messaging Server Directory Structure shows the platform-specific directory structure for the Instant Messaging server.

Table 3–1 Instant Messaging server directories

Description  

Solaris Location  

Linux Location  

Program Files 

These files include the native executable files, the library files in the bin or lib directory, the shell scripts in the sbin directory, the Java classes, and templates files in the lib directory.

Instant Messaging Installation Directory (im-svr-base)

The default value for the Installation Directory is: 

/opt/SUNWiim

Instant Messaging Installation Directory (im-svr-base)

The default value for the Installation Directory is: 

/opt/sun/im

Server Configuration files 

These files are in the Configuration Directory and include the iim.conf file and a subdirectory which contains all the server-wide access control files.

Instant Messaging Configuration Directory (im-cfg-base)

The default value for the Configuration Directory is: 

/etc/opt/SUNWiim/default/config

For convenience, the installer creates a symbolic link from /etc/opt/SUNWiim/default/config to /opt/SUNWiim/config.

In addition, if you created multiple instances of Instant Messaging, the name of the /default directory will vary depending on the instance. See Creating Multiple Instances from a Single Instant Messaging Installation for more information.

Instant Messaging Configuration Directory (im-cfg-base)

The default value for the Configuration Directory is: 

/etc/opt/sun/im/default/config

For convenience, the installer creates a symbolic link from /etc/opt/sun/im/default/config to /opt/sun/im/config.

In addition, if you created multiple instances of Instant Messaging, the name of the /default directory will vary depending on the instance. See Creating Multiple Instances from a Single Instant Messaging Installation for more information.

Runtime Directory 

Contains Instant Messaging server data. These files include the configurable directory for the files generated by the server at runtime. It includes the end user data in the database directory. It also contains the server, multiplexor, Calendar agent, and XMPP service log files, in the log directory.

Instant Messaging Runtime Directory (im-runtime-base)

The default value for the Runtime Directory is: 

/var/opt/SUNWiim/default

In addition, if you created multiple instances of Instant Messaging, the name of the /default directory will vary depending on the instance. See Creating Multiple Instances from a Single Instant Messaging Installation for more information.

Instant Messaging Runtime Directory (im-runtime-base)

The default value for the Runtime Directory is: 

/var/opt/sun/im/default

In addition, if you created multiple instances of Instant Messaging, the name of the /default directory will vary depending on the instance. See Creating Multiple Instances from a Single Instant Messaging Installation for more information.

Database 

If you are using a file-based property store, the database directory contains end user information such as the user and news channels directory. If you are using LDAP to store user data, the database directory is not used. 

Instant Messaging Database Directory (im-db-base)

The default value for the Database Directory is: 

/var/opt/SUNWiim/default/db

In addition, if you created multiple instances of Instant Messaging, the name of the /default directory will vary depending on the instance. See Creating Multiple Instances from a Single Instant Messaging Installation for more information.

Instant Messaging Database Directory (im-db-base)

The default value for the Database Directory is: 

/var/opt/sun/im/default/db

In addition, if you created multiple instances of Instant Messaging, the name of the /default directory will vary depending on the instance. See Creating Multiple Instances from a Single Instant Messaging Installation for more information.

Instant Messenger resources. 

These files contain HTML documents and jar files used by Instant Messenger. The topmost directory contains the locale-independent resources, and the locale-specific directories contain the localized resources.

Instant Messaging Resource directory (im-svr-base/html)

The default value for the Resource Directory is: 

/opt/SUNWiim/html

Instant Messaging Resource directory (im-svr-base/html)

The default value for the Resource Directory is: 

/opt/sun/im/html

Instant Messaging Server Configuration File

Instant Messaging stores all configuration options in the iim.conf file. For more information on the parameters and their values stored in this file, see Appendix A, Instant Messaging Configuration Parameters in iim.conf

Instant Messaging Data

Instant Messaging server stores the following data used by Instant Messenger in the database directory (im-db-base), and is indicated by the iim.instancevardir parameter in iim.conf: