Packaging and deploying custom widgets (deprecated)
You can package your custom widgets to prepare them for use in a runtime environment. You can also deploy the widgets to add them to the server.
Before you begin
Check that the following things are ready:
- The iWidget definition file for your custom widget
- Optional: Some or all of the implementation files for your custom widget. You can complete the implementation by updating your widget.
- The iWidget and any implementation packaged into an enterprise application (EAR)
- Optional: The documentation plugin containing the widget help files
- The widget registration definition for the custom widget to an existing catalog file or a created catalog file
The installBusinessSpaceWidgets and updateBusinessSpaceWidgets commands mentioned in this topic are run using the AdminTask object of the wsadmin scripting client.
The following conditions must be met:
- Run the commands on the deployment manager node.
- Run the commands in the connected mode, that is, do not use the wsadmin -conntype none option.
- You must connect with a user ID that has WebSphere® Application Server administrator privileges.
Start the wsadmin scripting client from the deployment_manager_profile/bin directory.
About this task
Packaging and deploying widgets is usually an iterative
process. The steps in the procedure describe how to package and deploy
a widget for the first time. If you are updating an existing widget,
the steps are similar with the following exceptions:
- Use the updateBusinessSpaceWidgets command instead of the installBusinessSpaceWidgets command.
- Skip step 1 if you did not update the EAR files, step 2 if you did not update the catalog file, and skip step 3 if you did not update the help files. Alternatively, you can include the files but use the -noWidgets, -noCatalogs, and -noHelp parameters to control what you are updating. If you are updating an EAR file, you must include the complete EAR.
Complete the following steps for each Business Space environment.