To Create an Additional Instance of Instant Messaging from an Existing Installation

This procedure assumes that you have used default installation and configuration values for im_svr_base and im_runtime_base. If you installed using the default values, the original runtime directory would be as follows:

Solaris: /var/opt/SUNWiim/default

Linux: /var/opt/sun/im/default

If you used paths other than the defaults, you will need to substitute your paths for the paths used in this procedure.

Steps

1. Create a runtime directory for the new instance:

   For example, to create a new runtime directory for instance xyz:

   Solaris: mkdir /var/opt/SUNWiim/xyz

   Linux: mkdir /var/opt/sun/im/xyz

2. Create a log directory for the new instance:

   For example, to create a new log directory for instance xyz:

   Solaris: mkdir /var/opt/SUNWiim/xyz/log

   Linux: mkdir /var/opt/sun/im/xyz/log

3. Create a lock directory for the new instance:

   For example, to create a new lock directory for instance xyz:

   Solaris: mkdir /var/opt/SUNWiim/xyz/lock

   Linux: mkdir /var/opt/sun/im/xyz/lock

4. Create a database directory (im_db_base) for the new instance:

   For example, to create a new database directory for instance xyz:

   Solaris: mkdir /var/opt/SUNWiim/xyz/db

   Linux: mkdir /var/opt/sun/im/xyz/db

5. Copy the contents of the runtime directory and all of its subdirectories into the newly created directories:

   For example:

   Solaris: cp -r /etc/opt/SUNWiim/default /etc/opt/SUNWiim/xyz

   Linux: cp -r /etc/opt/sun/im/default /etc/opt/sun/im/xyz

6. Open the new instance's imadmin script in a text editor.

   By default, this script is stored in the /config directory under the runtime directory you just created for the new instance:

   Solaris: /etc/opt/SUNWiim/xyz/config/imadmin

   Linux: /etc/opt/sun/im/xyz/config/imadmin

7. In the imadmin script, change the configuration file path to the path for the new configuration file for the new instance

   For example:

   On Solaris, change /etc/opt/SUNWiim/default/config/iim.conf to /etc/opt/SUNWiim/xyz/config/iim.conf.

   On Linux, change /etc/opt/sun/im/default/config/iim.conf to /etc/opt/sun/im/xyz/config/iim.conf.

8. Save and close the imadmin script.

9. Open the new instance's iim.conf file in a text editor.

   By default, the iim.conf file is stored in the /config directory under the runtime directory you created for the new instance:

   Solaris: /etc/opt/SUNWiim/xyz/config/iim.conf

   Linux: /etc/opt/sun/im/xyz/config/iim.conf

10. Modify the port number so that it does not conflict with the original instance.

11. If necessary, modify iim.instancedir to point to the installation directory root where the shared binaries are stored.

12. Modify iim.instancevardir to point to the runtime directory for the new instance.

    For example:

    On Solaris, change /etc/opt/SUNWiim/default to /etc/opt/SUNWiim/xyz.

    On Linux, change /etc/opt/sun/im/default to /etc/opt/sun/im/xyz.

13. Save and close iim.conf.

14. Ensure that file and directory ownership and permissions are the same for all instances.

15. Make renamed copies of im_svr_base/html/iim.html iim.jnlp index.html and modify the copies to point to the new instance's port number.