Sun ONE logo      Previous      Contents      Index      Next     

Sun ONE Instant Messaging Installation Guide

Appendix A  
Uninstalling Instant Messaging

This appendix details how to uninstall Instant Messaging components. Instructions are given for both UNIX and Windows.

Note

All the paths mentioned here assume that Sun ONE Instant Messaging is installed in the default directory.

This appendix contains:

Uninstalling Instant Messaging on UNIX

To uninstall Instant Messaging, use the following steps:

  1. (Optional) If you want a copy of the Sun ONE Instant Messaging data, back up the following files and directories:
    • The iim.conf file in the following directory:

      • On Solaris: /etc/opt/SUNWiim/config/

      On Linux: /etc/opt/soim/config/

    • All ACLs in the following directory:

      • On Solaris: /etc/opt/SUNWiim/config/acls

      On Linux: /etc/opt/soim/config/acls

    • All databases found in the following directory:

      • On Solaris: $RUNTIMEDIR/db

      On Linux: $RUNTIMEDIR/db

      Where:

      On solaris - the default value of the $RUNTIMEDIR is /var/opt/SUNWiim/default

      On Linux - the default value of the $RUNTIMEDIR is /var/opt/soim/default

    • Site specific HTML files and images, such as those found in the $imdocroot directory, and any others you have customized.

      • Where:

      On Solaris - the default value of the $imdocroot is /opt/SUNWiim/html

      On Linux - the default value of the $imdocroot is /opt/soim/html

  2. In a local terminal window, change directory to the installation directory which is the $BASEDIR.

    3. Where:

    On Solaris - the default value of the $BASEDIR is /opt/SUNWiim/

    On Linux - the default value of the $BASEDIR is /opt/soim/

  3. At the command line, type:

    4. ./uninstall

    If you want to run the uninstall program as a command-line script, type:

    ./uninstall -nodisplay.

  4. The Welcome panel is displayed. Click Next to continue.
  5. The “Select Type of Uninstallation” panel is displayed.

    6. Choose either a Full or a Partial uninstall. The Full uninstall removes all the components. The Partial uninstall allows you uninstall one or all of the components displayed in the Select Components window.

    Click Next to continue.

  6. The Instant Messaging Server LDAP Configuration panel is displayed. This panel is displayed only when Sun ONE Identity Server is selected for unistallation in the Select Components panel.

    7. Enter the following LDAP Server details:

    • LDAP Host Name. Host name of the machine on which the LDAP server is running. The default is the fully qualified host name. For example, fiat.sireo.com.
    • LDAP Port Number. Port number that the LDAP server listens to. The default is 389.
    • Base DN. Base DN (distinguished name) is the entry in your LDAP directory used as the starting point to search for users and groups. For example, if you specify a base DN of o=i-zed.com, LDAP search operations executed by the Instant Messaging server will examine only the o=i-zed.com directory tree. The installation program does not attempt to verify your entry if the Bind DN and Password are not specified.
    • BindDN. Enter the Bind DN (distinguished name) of the user who has read only privileges to the directory server.
    • Bind Password. Enter the password of the user who has read only privileges to the directory server.
  7. The Ready to Uninstall panel is displayed.

    8. Click Uninstall Now to proceed with the uninstallation.

  8. The Uninstalling panel displays the uninstall progress status.
  9. The Uninstallation Summary panel is displayed.

Click Details for more information about the uninstall. Click Dismiss to return to the Uninstallation Summary panel. Click Exit to end the uninstallation procedure.

Note

The uninstall script does not remove the Java Runtime Environment installed with the product.

Removing SUNWiimid Package Manually

When for some reason the .uninstall file fails to get copied to the uninstall directory you need to manually add the .uninstall file to be able to uninstall the SUNiimid package.

To manually add the uninstall file to the Instant Messaging Solaris package

  1. Create a $BASEDIR/SUNWiim/.uninstall

    2. In the ./uninstall file type the following:

    vi ./uninstall

    DS_HOST=host name on which the directory server of the identity server is running.

    DS_PORT=port number on which the directory server of the identity server is listening.

    DS_DIRMGR_DN= dn of the directory manager of the directory server of the identity server.

    DS_DIRMGR_PASSWORD =password of the directory manager of the directory server of the identity server

  2. pkgrm -v SUNWiimid
  3. rm $BASEDIR/SUNWiim/.uninstall

Uninstalling the Instant Messaging on Windows

To uninstall Instant Messaging, use the following steps:

  1. (Optional) If you want to preserve your Instant Messaging server data, back up the following files and directories:
    • The iim.conf file from $BASEDIR\config\

      • The default value of the $BASEDIR is c:\Program Files\Sun\InstantMessaging.

    • All ACL files from $BASEDIR\config\acls

      • The default value of the $BASEDIR is c:\Program Files\Sun\InstantMessaging.

    • All databases found in $RUNTIME\db

      • The default value of the $RUNTIME is c:\Program Files\Sun\InstantMessaging\db.

    • Site specific HTML files and images, such as those found in the $imdocroot\html directory, and any others you have customized.

      • The default value of the $imdocroot is c:\Program Files\Sun\InstantMessaging

  2. From the Start menu, choose Settings and then Control Panel.
  3. Choose Add Remove Programs.
  4. Click the Install/Uninstall tab.
  5. From the list of products, select Sun ONE Instant Messaging and click Add/Remove.
  6. Click Yes, if you want to uninstall the product.
  7. Choose either a Full or a Partial uninstall. The Full uninstall removes all the components. The Partial uninstall allows you to uninstall one or all of the components.
  8. Click Uninstall Now to continue uninstalling the product.

    9. Click Details for more information about the uninstall. Click Dismiss to return to the Uninstallation Summary panel. Click Exit to end the uninstall.

Uninstalling the Localized Packages on UNIX

When uninstalling the localized packages, the Sun ONE Instant Messenger uninstaller tries to uninstall the localized resources along with the core component.

You can also uninstall the localized resources of each individual component only.

For example, to uninstall the localized resources for the messenger resources component type:

Similarly you can uninstall the localized resources for other components using the following commands:



Previous      Contents      Index      Next     

Copyright 2003 Sun Microsystems, Inc. All rights reserved.