Augmentation rules and limitations for feature packs on z/OS

Profile augmentation depends on the type of profile, whether you changed the configuration information, and so on. You must have the correct combination of feature packs in order to add a node, manage clusters, install applications, and manage server templates. Use these rules and limitations to ensure a properly functioning feature-pack environment.

You can have a mix of augmented and unaugmented profiles that share a single WebSphere Application Server installation. Feature-pack functionality is available only within profiles that have been augmented.

Augmentation rules and limitations

Table 1. Rules for profile augmentation.

The following table provides additional augmentation rules for particular types of profiles with this feature pack.

Profile Supported Not supported
Standalone application server
  • Creation of a new standalone application server that is enabled for the Feature Pack for SCA

    When you create the standalone application server profile for the feature pack, the feature pack automatically augments the profile with Feature Pack for SCA capabilities.

  • Augmentation of an existing Version 7.0 standalone application server profile with the Feature Pack for SCA
  • New or updated for this feature pack Augmentation of an existing Version 7.0 standalone application server profile with the SDO feature if it has been augmented with the Feature Pack for SCA Version 1.0.1.0 or later and the Feature Pack for XML

New or updated for this feature pack Creation of a new standalone application server that is enabled for the SDO feature of the Feature Pack for SCA Version 1.0.1.0 or later

Deployment manager
  • Creation of a new deployment manager that is enabled for the Feature Pack for SCA

    When you create the deployment manager profile for the feature pack, the feature pack automatically augments the profile with Feature Pack for SCA capabilities.

  • Augmentation of an existing deployment manager profile with the Feature Pack for SCA

    This action is supported as long as all of the federated nodes in the cell are Version 7.0 or higher.

    You might have made configuration changes to the deployment manager profile.

  • New or updated for this feature pack Augmentation of an existing Version 7.0 deployment manager profile with the SDO feature of the Feature Pack for SCA if it has been augmented with the Feature Pack for SCA Version 1.0.1.0 or later and the Feature Pack for XML

Augmentation of an existing deployment manager profile if the version of any federated node in the cell is lower than Version 7.0

New or updated for this feature pack Creation of a new deployment manager profile that is enabled for the SDO feature of the Feature Pack for SCA Version 1.0.1.0 or later

Managed (custom) node
  • Creation of a new managed (custom) node that is enabled for the Feature Pack for SCA

    When you create the managed (custom) node for the feature pack, the feature pack automatically augments the profile with Feature Pack for SCA capabilities.

  • Augmentation of an existing managed (custom) node with the Feature Pack for SCA
  • New or updated for this feature pack Augmentation of an existing managed (custom) node with the SDO feature of the Feature Pack for SCA if it has been augmented with the Feature Pack for SCA Version 1.0.1.0 or later and the Feature Pack for XML
Creation of a new managed (custom) node that is enabled for the SDO feature of the Feature Pack for SCA Version 1.0.1.0 or later
Network Deployment cell
  • Creation of a new Network Deployment cell profile that is enabled for the Feature Pack for SCA

    When you create the deployment manager and the federated application server for the cell, the feature pack automatically augments the profile with Feature Pack for SCA capabilities.

  • Augmentation of an existing Network Deployment cell with the Feature Pack for SCA

    You must enable a deployment manager and application server for the feature pack based on the preceding rules in this table.

New or updated for this feature pack Augmentation of an existing cell profile with the SDO feature of the Feature Pack for SCA

New or updated for this feature pack Creation of a new cell profile that is enabled for the SDO feature of the Feature Pack for SCA Version 1.0.1.0 or later

Administrative agent   Creation or augmentation of an administrative agent to enable it for a feature pack

However, you can use an administrative agent in a feature-pack environment.

Job manager   Creation or augmentation of a job manager to enable it for a feature pack

However, you can use a job manager in a feature-pack environment.

Secure proxy server   Creation or augmentation of a secure proxy server to enable it for a feature pack

However, you can use a secure proxy server in a feature-pack environment.

Secure proxy administrative agent   Creation or augmentation of a secure proxy administrative agent to enable it for a feature pack

However, you can use a secure proxy administrative agent in a feature-pack environment.

Augmentation rules and limitations in a mixed-cell environment

Table 2. Augmentation in a mixed-cell environment.

When you perform tasks between nodes or between nodes and the deployment manager, the feature packs must be compatible.

Function Rules
Addition of a node
  • You can add a node to a cell as long as the deployment manager has been augmented with at least the same set of feature packs as the node. The deployment manager might have been augmented with additional feature packs.
  • You can add a node with no feature-pack profile to a cell even though the deployment manager is augmented with some feature packs; however, the node that you add must be at Version 7.0 or higher.
  • You cannot add a node with a particular feature-pack profile to a cell if the deployment manager has not been augmented with that feature pack.
Application installation
  • You can target an application that requires feature-pack functionality to an application server on a node that has been augmented with feature packs that contain that functionality.
  • You cannot target an application that requires feature-pack functionality to an application server on a node that has not been augmented with that feature-pack functionality.
  • You can target an application that does not require feature-pack functionality to an application server on a node with or without feature-pack augmentation.
Server configuration template use
  • You can use the server configuration template to create a server on another node that is augmented with the same feature pack.
  • If you attempt to use a server configuration template to create a server on another node that is augmented with a different feature pack, the operation fails. The scenario is not supported.
Cluster management
  • When you add a new member to a cluster, the new member must be able to run all the applications that have been targeted for the cluster.
  • If an application targeted for the cluster requires a specific feature pack, you must add the new member from a node that is enabled with that feature pack; otherwise, an error occurs.
  • If no application on the cluster requires a specific feature pack, you can add the new member to the cluster from a node with or without a feature pack.
Configuration-archive export and import
  • If a configuration contains feature-pack capabilities, exporting a configuration to a configuration archive and importing a configuration from a configuration archive are not supported. If you run one of the import or export commands of the ConfigArchiveOperations command group against one of these configurations, the command might complete without reporting an error. No message is displayed when importing or exporting; however, no confirmation exists for imported configuration success.
Important: Back up your configuration file system before augmenting any profiles. You cannot unaugment profiles, and you might want to restore your pre-augmentation configuration later. After you restore, you will have to manually make any other changes that you made to the configuration after the backup.

Unaugmentation rule

You cannot unaugment profiles that have been enabled with feature-pack functionality in WebSphere Application Server for z/OS Version 7.0.

Reference topic    

Terms of Use | Feedback

Last updated: Oct 21, 2010 12:24:53 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=v701sca&product=was-nd-mp&topic=rins_limit_sca_zos
File name: rins_limit_sca_zos.html