Uninstalling OpenPages

Applies to: On premises

Use these steps to uninstall IBM OpenPages®.

Before you begin

Decide whether you need to uninstall OpenPages or roll back to a previous version. If you migrated to 9.2.x and you want to roll back to your previous version, do not do these steps. Instead, see Rolling back an OpenPages migration.

About this task

For a demonstration of how to uninstall IBM OpenPages, see the following video. The video shows 7.4 but the steps are similar for 9.2.x.

Procedure

  1. Stop the OpenPages search server.

    You can leave the application servers running or stop them. The reporting server must be running.

  2. If you are using Windows, close any command prompts, folders, and files that are accessing the <OP_HOME>, <CC_HOME>, or <SEARCH_HOME> directories.
  3. If the OpenPages storage directory is mounted to an application server (Linux®), unmount it.
  4. Uninstall the OpenPages application. You can either do the following steps or run the silent install with the task value in the deploy.properties set to uninstall. For more information, see Silent installations.
    1. Open your deployment in the installation app. For more information, see Creating a deployment.
    2. Click the task list and select Uninstall.
    3. Click Validate.
    4. Click Uninstall.
    5. When the process completes, check the log files for any errors:
      <install_server_home>/src/deployment/<deployment name>/logs/nodes/<Server>/uninstall.log

      Where <Server> depends on the server and how it is named in the deploy.properties files. The error is displayed in the user interface. You can download the log file.

    If Uninstall is still enabled in the installation app, the uninstall process did not complete.
  5. On each remote server:
    1. If it is running, stop the agent. Go to the server card and click The stop icon, a red square or manually stop the agent with the npm run stop command.
    2. Log on to the remote server.
    3. Go to the <agent_home>/install/<OS type> directory.
    4. Run the uninstall script.
      • Windows
        uninstall.bat
      • Linux:
        ./uninstall.sh
    5. Delete the agent directory.
  6. Uninstall the installation server.
    1. Log out and close the installation app.
    2. Stop the installation server. For more information, see Stopping the installation server.
    3. Go to the <installation_server_home>/install/<OS type> directory.
    4. Run the uninstall script.
      • Windows
        uninstall.bat
      • Linux:
        ./uninstall.sh
    5. Delete the <installation_server_home> directory where the installation app was installed, for example, NewInstaller.

What to do next

  1. Drop the OpenPages database schema objects. For more information, see Dropping the OpenPages database for IBM Db2 or Dropping the full schema in an Oracle database.
  2. Verify that the OP_HOME directory does not exist.
  3. Verify that the CC_HOME directory does not exist.
  4. Verify that the SEARCH_HOME directory does not exist.
  5. Verify that the openpages-storage directory does not exist.
  6. You can now reinstall OpenPages.