Downloading and installing additional content

You can use the Content Installer application to locate, download, and install extra content from the ISM Library.

About this task

The following steps explain how to download and install content that is available for your product.

Installing a new version of content overwrites any previous versions. If you want to be sure not to overwrite existing content, you can specify a two-letter prefix for components on the Replacements tab. This prefix is prepended to the names of the components that are installed.

Make sure that you install content into a development or test environment and perform the necessary customization and verification to ensure that it is suitable for production use. Then, use your standard tools to move the tested content to your production environment.

Procedure

  1. Click System Configuration > Content Installer to open the Content Installer application.
  2. In the List tab of the Content Installer application, click IBM® Control Desk.
    The Content tab displays a list of content packages available for the product.
  3. Look at the Installed and Installable check boxes to verify that the package is not already installed and that your environment meets the package's prerequisites. A check in the Installable check box indicates that your installation meets the requirements for installing the content.
  4. To download the content package, click the installation icon Installation icon for the package.
  5. A warning message is displayed to remind you that installing this package might overwrite content that is already installed. Make sure that you backed up your data before you install new content. Click Continue on the warning panel when you are ready to proceed.
  6. In the Install Content window, review the details about the content package and click Download.
    Because some content packages require a license agreement, this panel might contain a license agreement. If it does, you must accept the agreement before you can download the package.
  7. After the content is downloaded, in the Install Content window for Step 2, complete the following steps.
    1. Some packages contain several components, and you can decide which components to install. If multiple components are displayed on the Package Content tab, clear the Selected check boxes for the components that you do not want to install.
    2. On the Replacements tab, specify replacement values for attributes as needed.
      Some packages allow replacement values for content columns. This replacement is based on a pattern defined in the package xml file. A full replacement of an existing value or a partial pattern replacement (for example, a prefix) is possible. You can select from a predefined list of values, which is populated by a supplied SQL query, or you can specify a value manually. The description column on the Replacements tab provides more information about the replacement option.
    3. On the Documents tab review and download documents as needed.
    4. After you complete the required actions on the Install Content window, click Install to install the selected components of the package.
      When the installation is complete, the Install Complete window is displayed.
    5. To view information about the installation, click Show Details,
      A message is displayed to specify what content was selected and whether any errors occurred during installation. If an item of content fails to install successfully, all items belonging to that transaction are rolled back.