[AIX HP-UX Linux Solaris Windows]This topic applies only on the IBM i operating system.

Augmenting a profile 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 Network Deployment installation. For installation instructions, use the topics for installing the feature pack.

Each profile has one log file for augmentation. The augmentation log, if it exists, is overwritten if you augment the profile more than once. Optionally save the contents of the augmentation log before you start the next augmentation. You can choose the method of saving the log, such as renaming or copying the file. The augmentation log is located at:
  • [Linux] [HP-UX] [Solaris] [AIX] app_server_root/logs/manageprofiles/xxx_augment.log
  • [Windows] app_server_root\logs\manageprofiles\xxx_augment.log
where xxx is the profile name.
Important: If you are going to augment a managed (custom) profile, stop all servers on the node and the node agent before augmenting the profile.

About this task

This article explains how to use the manageprofiles command-line tool to augment a profile.

You can augment the application server profile, management profile with a server type of deployment manager, management profile with a server type of administrative agent, custom profile, and cell profile of the Network Deployment product. You cannot augment the management profile with a server type of job manager or secure proxy profile. Read Augmentation rules and limitations for feature packs on non-z/OS operating systems for additional information.

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.

For more information about the limitations for augmenting profiles with feature-pack templates, read the article on profile augmentation rules and limitations for feature packs in the information center.

The feature pack provides profile templates during installation. These templates are located in the app_server_root/profileTemplates/BATCH directory.

See Profile concepts for detailed information about these templates and how they are used.

Do not manually modify the files that are located in the profileTemplates directory. For example, if you are changing the ports during profile creation, use 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.This example augments a deployment manager profile.

Procedure

  1. Stop any servers running for the profile that you are augmenting.
  2. Open your command utility.
    • [AIX Solaris HP-UX Linux Windows] Open a command prompt, and navigate to the app_server_root/bin directory.
  3. Back up your current configuration.

    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
  4. 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 Solaris HP-UX Linux Windows] Note: If a relative file path is specified for the -templatePath parameter, your profile might not be fully augmented.

    The following command example augments the myDMGR deployment manager profile in a Network Deployment environment:

    • If the deployment manager was created as part of a cell profile:
      [Windows]
      manageprofiles.bat -augment -profileName myDMGR -templatePath 
      app_server_root\profileTemplates\BATCH\cell\dmgr
      [Linux] [Solaris] [HP-UX] [AIX]
      manageprofiles.sh -augment -profileName myDMGR -templatePath 
      app_server_root/profileTemplates/BATCH/cell/dmgr
    • If the deployment manager was created as a management profile of type deployment manager:
      [Windows]
      manageprofiles.bat -augment -profileName myDMGR -templatePath 
      app_server_root\profileTemplates\BATCH\management
      [Linux] [Solaris] [HP-UX] [AIX]
      manageprofiles.sh -augment -profileName myDMGR -templatePath 
      app_server_root/profileTemplates/BATCH/management
    Tip: If you do not know how the profile was originally created, perform one of the following actions:
    • Look in the app_server_root/properties/profileRegistry.xml file, where the subelement related to the profile will point to the template that was used to create it.
    • Use the -listAugments parameter with the manageprofiles command to list the registered augments on the profile from the profile registry. For example:
      manageprofiles(.bat)(.sh) -listAugments -profileName profile_name

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.

What to do next

Important: If you augmented a managed (custom) profile, restart all servers on the node and the node agent after profile augmentation completes.



In this information ...


IBM Redbooks, demos, education, and more

(Index)

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

This feature requires Internet access.

Task topic Task topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Jan 14, 2013 5:55:59 PM CST
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=v700compg&product=was-nd-mp&topic=txml_wsfpaugment
File name: txml_wsfpaugment.html