WebSphere Application Server Version 6.1 Feature Pack for Web Services
             Operating Systems: AIX, HP-UX, i5/OS, Linux, Solaris, Windows

             Personalize the table of contents and search results
             New or updated topic for this feature pack

Augmenting profiles using the command prompt

After completing the installation of a feature pack, a feature pack might require you to augment a profile to make the profile compatible with a particular feature pack. You can augment the profile using the manageprofiles command.

Before you begin

Install the feature pack on an existing WebSphere Application Server Version 6.1 installation. For installation instructions, use the topics for installing the feature pack in the information center.

About this task

You can augment your existing deployment manager profile using the following tools:
  • [AIX HP-UX Linux Solaris Windows] The Profile Management tool
  • [i5/OS] [AIX HP-UX Linux Solaris Windows] The manageprofiles command line tool
This topic explains how to use the manageprofiles command line tool to augment a profile.

New or updated for this feature pack You cannot augment an existing custom, cell, or application server profile with a feature pack template. You can only augment the deployment manager profile.

The following guidelines apply for augmenting existing profiles in a mixed-cell environment.
  • You can add nodes that are configured for the feature pack to a cell if the deployment manager is augmented with the same feature pack environment.
  • You can add nodes that are not configured for the feature pack to a cell if the deployment manager is augmented with the feature pack environment.
  • You cannot add nodes that are configured for the feature pack to a cell if the deployment manager is not augmented with the feature pack environment.

New or updated for this feature pack The Feature Pack for Web Services provides a deployment manager profile template during installation. This template is located in the app_server_root/profileTemplates/WEBSERVICES/ directory.

Do not manually modify the files that are located in the install_dir/profileTemplates/WEBSERVICES directory. For example, if you are changing the ports during profile creation, use the Profile Management tool or the -startingPort or -portsFile arguments to the manageprofiles command instead of modifying the file in the profile template directory. For more information, use the manageprofiles command reference topics in the information center.

Use the following steps to augment your existing profiles that adhere to the previous guidelines.

Procedure

  1. Open your command utility.
    • [AIX HP-UX Linux Solaris Windows] Open a command prompt, and navigate to the app_server_root/bin directory.
    • [i5/OS] Start a Qshell session using the STRQSH CL command.
  2. Back up your current deployment manager profile.

    Profile augmentation might result in changes to the configuration of the profile. Use the backupConfig command to back up your current configuration before augmenting your profile. For example, the following command saves your current configuration to the featurePackAugment.zip file:

    backupConfig(.bat)(.sh) featurePackAugment.zip
  3. Augment your deployment manager profile for the feature pack environment.
    Use the manageprofiles command, specifying the fully qualified file path for the -templatePath parameter.
    [AIX HP-UX Linux Solaris Windows] Note: If a relative file path is specified for the -templatePath parameter, then your profile might not be fully augmented.

    Enter the following command to augment the myDMGR deployment manager profile in a Network Deployment environment:

    New or updated for this feature pack [Windows]
    manageprofiles.bat -augment -profileName myDMGR -templatePath 
    app_server_root\profileTemplates\WEBSERVICES\dmgr.wsfep
    [i5/OS] [Linux] [Solaris] [HP-UX] [AIX]
    manageprofiles(.sh) -augment -profileName myDMGR -templatePath 
    app_server_root/profileTemplates/WEBSERVICES/dmgr.wsfep

Results

The command returns a success or failure message. If you receive the message, There are no augmenting templates available for the selected type of profile, the profile you selected cannot be augmented with the feature pack template. For more information about the limitations for augmenting profiles with feature pack templates, read the profile augmentation rules and limitations for feature packs topic in the information center.




In this information ...


IBM Redbooks, demos, education, and more


Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

IBM Suggests
Task topic    

Terms of Use | Feedback

Last updated: Nov 25, 2008 2:35:59 AM CST
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.wsfep.multiplatform.doc/info/ae/ae/txml_wsfpaugment.html