Uninstalling a deployment before migration

If you migrate HCL 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 Connections before you migrate to the new release. You must also uninstall the Cognos® Business Intelligence server if it is installed. If you are migrating to Connections 6.0 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 Getting ready for migrating or updating.

About this task

Notes:
  • 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:

Procedure

  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 file named Uninstall.log in the connections_root/logs directory.
  10. If you plan to migrate to Connections 6.0 on the same server as the 5.0 or 5.5 deployment, remove the following files:
    Notes:
    • 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. Connections shared and local content stores. Before you remove this data, migrate your 5.0 or 5.5 content stores. For more information, see Content store migration.
    2. Connections installation files: connections_root
      Note: If you did not install Connections in the default directory, delete the directory where you installed the product.
    3. 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 Getting ready for migrating or updating.