IBM BPM, V8.0.1, All platforms > Administer the IT infrastructure > Administer Process Portal > Administer Process Portal spaces > Remove widgets

Uninstalling custom widgets and catalogs in Process Portal spaces

You can uninstall a custom catalog and the widgets that it contains from a space.

Custom widgets are widgets that your organization has developed. You can remove a custom widget in one of the following ways:

• Disable the widget, which deregisters the widget so that it is no longer available to users but it keeps the widget code on the server.

  If you want to remove a widget that is provided by the product, this is the way to do it. See Disabling widgets in Process Portal spaces.

• Uninstalling the custom widget and the catalog that contains it, which removes all of the widgets in the catalog and the catalog.
• Uninstalling the custom widget individually, which removes the widget from its catalog but maintains the catalog. Do not choose this way if you are uninstalling the last widget defined in the catalog. Instead, install the widget and its catalog. For information, see Uninstalling custom widgets individually from Process Portal spaces.

When a custom widget is installed, the following actions occur:

• The EAR for the widget is installed in the profile_root/installedApps/ node_name directory.

• The catalog file for the widget is added to, or updated in the profile_root/BusinessSpace/ node_name/ server_name/mm.runtime.prof/config directory. This action registers the widget. The catalog in your file is also added to the default catalog using an include tag.

• The endpoints used by the widget (if it uses them and needs custom endpoints) are added or updated in the profile_root/BusinessSpace/ node_name/ server_name/mm.runtime.prof/endpoints directory.

• The help files for the widget (if it uses the information center for its help) are added to the profile_root/config/BusinessSpace/help/eclipse/plugins directory.

When you uninstall one or more custom widgets and their catalog, you are deleting the widget files and the catalog file, removing the reference to the catalog file from the default catalog, and updating the documentation to remove the help plug-ins for the widgets. A command is provided for the uninstallation.

Procedure

1. If you do not have the .zip file that was used install the custom widget and its catalog, you need to re-create it:

   1. Create an ear directory. Copy the EAR files for your custom widgets into the directory.

   2. Create a catalog directory and copy the catalog XML (widget registration) file into it.

   3. Create a help directory and copy the documentation plug-ins into it if there are any documentation plug-ins.

      If you have other documentation plug-ins that have hyperlinks to the documentation plug-ins that you are deleting, you will need to update those plug-ins separately. See the final step in Create a documentation plugin for information.

   4. Compress the .ear file, catalog, and help directories. Check that the structure of the .zip file contains the following items:
      • ear\ widgets_name.ear (one or more EAR files)
      • catalog\ catalog_name.xml
      • help\eclipse\plugins\*

2. At a command prompt, change directories to the profile_root/bin or cluster_root/bin directory.

3. Enter wsadmin.bat -conntype NONE and then enter the appropriate command:

   • For uninstalling the widgets from a non-clustered environment: $AdminTask uninstallBusinessSpaceWidgets {-nodeName node -serverName server -widgets fullpath}

   • For uninstalling the widgets from a clustered environment:$AdminTask uninstallBusinessSpaceWidgets {-clusterName cluster -widgets fullpath}

   fullpath is the name and location of the .zip file created.

   For information on uninstallBusinessSpaceWidgets, see uninstallBusinessSpaceWidgets command: .

   The command deletes the EARs, catalog file, and documentation plug-ins contained in the .zip file.

4. Enter Exit

5. Log in to Process Portal and delete the widget from any templates and spaces that use it. If you do not delete the widget, a placeholder image and a message that the widget is unavailable are displayed.

Remove widgets from Process Portal spaces

Related tasks:
Disabling widgets in Process Portal spaces

Related information:
Packaging and deploying custom widgets