Uninstalling the PPT Software

This chapter provides step-by-step procedure to uninstall PPT application using console as well as GUI based uninstallation wizard.

CAUTION:

Uninstallation removes PPT database related files from the server. However, PPT back-up files such the database dump and PPT as well as PsMon configuration files, that are updated every mid-night by default are not removed during uninstallation process if these files are located outside PPT installation directory. These backup files are compatible with version of PPT application and cannot be used with earlier or later versions of PPT application.

Pre-uninstallation Steps in Cluster Mode

The following steps should be performed before uninstalling the PPT in cluster mode:

  1. Execute the following command to disable the resource on the standby node. This will make sure that the resource group does not failover in between uninstallation process and result in any sort of data corruption.
    $ hagrp -disable
    <resource group name> -sys <node2>
    
  2. Execute the following command to set the Critical and Enable attribute of ppt-app resource to '0'.
    $ hares -modify
    <resource-name> Enabled 0
    
    $ hares -modify
    <resource-name> Critical 0
    
Refer to GUI Based PPT Uninstallation Wizard and Console Based Uninstallation Method for further steps on how to uninstall PPT application.

Uninstallation Methods

This section describes the methods that can be used to uninstall PPT application.

The PPT application along with its components such as the Apache web server and PostgreSQL database engine, can be uninstalled using either a GUI based or a console based method.

GUI based method: This is commonly used uninstallation method. Following are the requirements for GUI-based uninstallation:
  • Administrative access to the PPT server and attached display terminal, with an active X-Windows application such as Xming or eXceed.
  • Network connectivity to PPT server via Telnet or SSH, using some X-Windows client on remote workstation.

Console based method:This uninstallation method is used when, neither X-Windows application nor remote network connectivity to the PPT server using Telnet or SSh is available.

IMPORTANT:

PPT installation and uninstallation method are not interdependent, i.e., PPT application can be installed using GUI and uninstalled using console and vice versa.

GUI Based PPT Uninstallation Wizard

This section provides instructions for uninstalling the PPT application using a GUI based uninstallation method.

IMPORTANT:

The uninstallation process must be executed by a user with root access privileges. This process removes all the database entities pertaining to the build that is being uninstalled. After uninstallation, it is not possible to recover these database entities.

  1. Log into the server on which PPT application is installed, using root username and password.
  2. Default installation directory is /users/ppt, access this directory by entering following command:
    cd /<ppt-install-dir>
  3. Access /Uninstall_PolicyProvisioningTool sub-directory by entering the following command:
    cd Uninstall_<ppt-install-dir>
  4. Execute the uninstall script by entering the following command:
    ./Uninstall_<ppt-install-dir>
    Uninstall Policy Provisioning Tool screen appears as shown below:
  5. Click Next. Uninstallation wizard identifies the processes to be stopped.
  6. Click Next and follow the instructions.
  7. Click Finish to complete the uninstallation process.

Console Based PPT Uninstallation Method

This section provides instructions for uninstalling the PPT application using the console-based uninstallation method.

IMPORTANT:

The uninstallation process must be executed by the user with root access privileges. This process removes all the database entities pertaining to the build that is being uninstalled. After uninstallation, it is not possible to recover these database entities.

  1. Log into the server on which the PPT application is installed. Use the root username and password.
  2. Access the directory in which PPT is installed, the default installation directory is /users/ppt, by entering the following command:
    cd /<ppt-install-dir>
  3. Access the /Uninstall_PolicyProvisioningTool sub-directory by entering the following command:
    cd Uninstall_<ppt-install-dir>
  4. Execute the uninstall script by entering the following command:
    ./Uninstall_PolicyProvisioningTool
    -i console
    Console based uninstallation displays a welcome message.
  5. Enter N to proceed. A message appears listing the application processes to be uninstalled.
  6. Enter N to proceed with the uninstallation. A number of messages are displayed indicating the progress of uninstallation process.
  7. Press Enter to complete the uninstallation process.

Post-uninstallation Steps in Cluster Mode

The following steps should be performed after uninstalling PPT application in cluster mode:

  1. After uninstalling PPT from the Active Node, enable the resource on the standby node and disable it on current active node. This will make sure that the resource group does not failover in between uninstall and result in any sort of data corruption.
    $ hagrp -enable
    <resource group name> -sys <node2> 
    
    $ hagrp -disable
    <resource group name> -sys <node1>
    
  2. Switchover the resource group to Standby Node.
  3. Uninstall PPT from the Standby Node.