Uninstalling a deployment before migration

If you migrate IBM® Connections using the same hardware that you used for the previous release, known as an in-place migration, you must uninstall the earlier version of IBM Connections before you install the new release. You must also uninstall the Cognos® Business Intelligence server if it is installed. If you are installing IBM Connections 5.5 side-by-side with your current deployment, you do not need to complete this task.

Before you begin

Back up your current deployment of applications, databases, and customized files and reports. For a list of what to back up, see the Getting ready for migrating or updating topic.

About this task

  • Deleting IBM Connections data files makes the original deployment unrecoverable. If you plan to reinstall IBM Connections and use your old data, do not delete the data files.
  • You do not need to remove IBM Installation Manager files. These files might be associated with other IBM applications.

To uninstall IBM Connections, complete the following steps:


  1. Start the IBM WebSphere® Application Server Deployment Manager.
  2. Stop all instances of WebSphere Application Server, including node agents, in your deployment.
  3. To uninstall a deployment of Connections, start the IBM Installation Manager and then click Uninstall.
  4. Select the IBM Connections package group and click Next.
  5. Click Uninstall to begin uninstalling.
  6. When the process is complete, restart the Deployment Manager.
  7. Restart all instances of WebSphere Application Server, including node agents.
  8. Synchronize the nodes.
  9. To check the details of the procedure, open the log files in the connections_root/logs directory. Each IBM Connections application that you uninstalled has a log file that uses the following naming format: application_nameUninstall.log, where application_name is the name of an IBM Connections application.
  10. If you plan to install IBM Connections 5.5 on the same server as the 4.5 or 5.0 deployment, remove the following files:
    • Except where noted, remove these files from the system that hosts the Deployment Manager.
    • Because some of these files might be used by other programs, it is possible that you are not allowed to remove all of the following files.
    • You do not need to remove IBM Installation Manager files. These files might be associated with other IBM applications.
    1. IBM Connections installation files: connections_root
      Note: If you did not install IBM Connections in the default directory, delete the directory where you installed the product.
    2. IBM Connections shared and local content stores. Before you remove this data, migrate your 4.5 or 5.0 content stores. For more information, see Content store migration.
    3. IBM Connections configuration files: Delete the profile_root/config/cells/cell_name/LotusConnections-config directory, where cell_name is the name of your WebSphere Application Server cell.
    4. If it is present, delete the registry.xml file from the profile_root/config/cells/cell_name directory.
    5. Delete all .py files from the /opt/IBM/WebSphere/AppServer/profiles/profile_name/bin directory on the deployment manager server.
  11. If you installed IBM Cognos Business Intelligence for the previous release, uninstall those components before you migrate to this release as described in the Uninstalling Cognos Business Intelligence server topic.

What to do next

Follow the steps in Before installing for migration.