26 Configuration File and Directory Structure Overview

This chapter describes the configuration files you use to administer Oracle Communications Instant Messaging Server. The chapter also describes the Instant Messaging Server directory structure and the properties files used to store Instant Messaging Server operational data and configuration information. The following topics are covered:

• Program Files

• Server Configuration Files

• Runtime Directory

• Database Directory

• Instant Messaging Server Configuration File

Program Files

Program 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.

Oracle Solaris Location of Program Files

Program files are located in the Instant Messaging Server installation directory. The default location of the installation directory is: /opt/sun/comms/im.

Red Hat Linux and Oracle Linux Location of Program Files

Program files are located in the Instant Messaging Server installation directory. The default location of the installation directory is: /opt/sun/comms/im.

Server Configuration Files

Server configuration files include the iim.conf.xml file and a subdirectory that contains all the server-wide access control files.

Note:

In Instant Messaging Server 9, you use the imconfutil command to make a configuration change. Never directly edit the iim.conf.xml file.

Oracle Solaris Location of Server Configuration Files

Server configuration files are located in the Instant Messaging Server configuration directory. The default location of the configuration directory is: /etc/opt/sun/comms/im/default/config.

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

In addition, if you create multiple instances of Instant Messaging Server, the name of the /default directory varies, depending on the instance. See the topic on creating multiple instances from a single Instant Messaging Server installation in Instant Messaging Server Installation and Configuration Guide.

Red Hat Linux and Oracle Linux Location of Server Configuration Files

Server configuration files are located in the Instant Messaging Server configuration directory. The default location of 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/comms/im/config.

In addition, if you create multiple instances of Instant Messaging Server, the name of the /default directory varies, depending on the instance. See the topic on creating multiple instances from a single Instant Messaging Server installation in Instant Messaging Server Installation and Configuration Guide.

Runtime Directory

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

Oracle Solaris Location of the Runtime Directory

The default value of the runtime directory is: /var/opt/sun/im/default.

In addition, if you create multiple instances of Instant Messaging Server, the name of the /default directory varies, depending on the instance. See the topic on creating multiple instances from a single Instant Messaging Server installation in Instant Messaging Server Installation and Configuration Guide.

Red Hat Linux and Oracle Linux Location of the Runtime Directory

The default value of the runtime directory is: /var/opt/sun/im/default.

In addition, if you create multiple instances of Instant Messaging Server, the name of the /default directory varies, depending on the instance. See the topic on creating multiple instances from a single Instant Messaging Server installation in Instant Messaging Server Installation and Configuration Guide.

Database Directory

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.

Oracle Solaris Location of the Database Directory

The default value for the Database Directory is: /var/opt/SUNWiim/default/db

In addition, if you create multiple instances of Instant Messaging, the name of the /default directory will vary depending on the instance. See the topic on creating multiple instances from a single Instant Messaging Server installation in Instant Messaging Server Installation and Configuration Guide.

Red Hat Linux and Oracle Linux Location of the Database Directory

The default value for the Database Directory is: /var/opt/sun/im/default/db

In addition, if you create multiple instances of Instant Messaging, the name of the /default directory will vary depending on the instance. See the topic on creating multiple instances from a single Instant Messaging Server installation in Instant Messaging Server Installation and Configuration Guide.

Instant Messaging Server Configuration File

Instant Messaging Server stores all configuration properties (formally called options) in the iim.conf.xml file. For more information on the properties and values stored in the iim.conf.xml file, see "Configuration Properties".

Instant Messaging Server Data

Instant Messaging Server stores the following Instant Messenger data in the database directory that is set by the iim.instance.vardir parameter.

• End user properties, such as contact lists, messenger settings, and access control (alternatively, these properties can be stored in LDAP).

• Public conferences. This does not involve instant messages which are not persistent, but only properties of the conference objects themselves, such as access rules.