Removing a PAA assembly

You must remove the installed content and resources of a Portal Application Archive (PAA) assembly from IBM® WebSphere® Portal before removing the associated PAA assembly from the ConfigEngine.

About this task

Complete the following steps to remove an assembly from WebSphere Portal:

Procedure

  1. Open a command prompt and change to the following directory:
  2. Optional: If using the Simple and Protected GSS-API Negotiation Mechanism (SPNEGO) for single sign-on, complete the following steps to disable SPNEGO:
    1. Log on to WebSphere Integrated Solutions Console.
    2. Go to Security > Global security > Web and SIP security > SPNEGO Web authentication.
    3. Uncheck the Enable SPNEGO check box.
    4. Save your changes.
  3. Run the following command to remove the assembly:

    This command checks for any dependencies from other assemblies registered to the current offering.

    • AIX: ./ConfigEngine.sh remove-paa –DappName=assemblyName -DforceRemove=true -DWasPassword=password -DPortalAdminPwd=password
    • IBM i: ConfigEngine.sh remove-paa –DappName=assemblyName -DforceRemove=true -DWasPassword=password -DPortalAdminPwd=password
    • Linux: ./ConfigEngine.sh remove-paa –DappName=assemblyName -DforceRemove=true -DWasPassword=password -DPortalAdminPwd=password
    • Solaris: ./ConfigEngine.sh remove-paa –DappName=assemblyName -DforceRemove=true -DWasPassword=password -DPortalAdminPwd=password
    • Windows: ConfigEngine.bat remove-paa –DappName=assemblyName -DforceRemove=true -DWasPassword=password -DPortalAdminPwd=password
    • z/OS: Complete the following steps:
      1. From the Portal configuration panel, select Application configuration tasks.
      2. Select Configure content with Solution Installer.
      3. Select Uninstall and remove a solution.
      4. Select Define variables.
        Reminder: If you need assistance to define the variables, press F1 to display the help panel.
      5. Generate the customization jobs.
      6. Follow the Customization dialog instructions for submitting the customization jobs. If the job ends abruptly or is canceled without a failure message, remove all log files from the ConfigEngine/log directory before you rerun the job.
    Optional parameter: The -DforceRemove=true parameter is optional. If the parameter is not set, only components in the components.properties file with a value of true are removed.
  4. Run the following command to uninstall the assembly:

    The uninstall-paa command checks for any dependencies from other assemblies. Only components that are not registered as dependencies are removed.

    • AIX: ./ConfigEngine.sh uninstall-paa –DappName=assemblyName -DforceUninstall=true -DWasPassword=password -DPortalAdminPwd=password
    • IBM i: ConfigEngine.sh uninstall-paa –DappName=assemblyName -DforceUninstall=true -DWasPassword=password -DPortalAdminPwd=password
    • Linux: ./ConfigEngine.sh uninstall-paa –DappName=assemblyName -DforceUninstall=true -DWasPassword=password -DPortalAdminPwd=password
    • Solaris: ./ConfigEngine.sh uninstall-paa –DappName=assemblyName -DforceUninstall=true -DWasPassword=password -DPortalAdminPwd=password
    • Windows: ConfigEngine.bat uninstall-paa –DappName=assemblyName -DforceUninstall=true -DWasPassword=password -DPortalAdminPwd=password
    • z/OS: Complete the following steps:
      1. From the Portal configuration panel, select Application configuration tasks.
      2. Select Configure content with Solution Installer.
      3. Select Uninstall and remove a solution.
      4. Select Define variables.
        Reminder: If you need assistance to define the variables, press F1 to display the help panel.
      5. Generate the customization jobs.
      6. Follow the Customization dialog instructions for submitting the customization jobs. If the job ends abruptly or is canceled without a failure message, remove all log files from the ConfigEngine/log directory before you rerun the job.
    Optional parameter: The -DforceUninstall=true parameter is optional. If the parameter is not set, only components in the components.properties file with a value of true are uninstalled.
  5. Optional: Complete the following steps to enable SPNEGO:
    1. Log on to WebSphere Integrated Solutions Console.
    2. Go to Security > Global security > Web and SIP security > SPNEGO Web authentication.
    3. Check the Enable SPNEGO check box.
    4. Save your changes.