WebSphere Enterprise Service Bus, Version 6.2.0 Operating Systems: AIX, HP-UX, i5/OS, Linux, Solaris, Windows


Augmenting profiles using the manageprofiles command

Augmentation is the ability to change an existing profile with an augmentation template. You can augment existing WebSphere® Application Server or WebSphere Application Server Network Deployment profiles into WebSphere ESB profiles. You can augment a profile from the command line using the manageprofiles command.

Before you begin

Before using this procedure, ensure that you have done the following tasks:

Security role required for this task: See Granting write permission of files and directories to non-root users for profile creation.

To use the manageprofiles command to augment a profile, perform the following steps.

Procedure
  1. Determine the template that the existing profile was created with (deployment manager, stand-alone, or managed). You can determine the template that was used for creating the profile by viewing the profile registry in install_root/properties/profileRegistry.xml. Do not modify this file, use it only to view the templates.
  2. Find the appropriate template to augment to. You can augment an existing WebSphere Application Server or WebSphere Application Server Network Deployment profile into a WebSphere ESB profile. The following profile templates are available:
    • default.esbserver: for a WebSphere Enterprise Service Bus stand-alone server profile, which defines a stand-alone server.
    • dmgr.esbserver: for a WebSphere Enterprise Service Bus deployment manager profile, which defines a deployment manager.
    • managed.esbserver: for a WebSphere Enterprise Service Bus custom profile, which, when federated to a deployment manager, defines a managed node.
    Use the augment parameter to make changes to an existing profile with an augmentation template. The augment parameter causes the manageprofiles command to update or augment the profile identified in the -profileName parameter using the template in the -templatePath parameter. The augmentation templates that you can use are determined by which IBM® products and versions are installed in your environment. Make sure that you specify the fully qualified file path for -templatePath, because a relative file path for the -templatePath parameter results in the specified profile not being fully augmented.
    Note: Do not manually modify the files that are located in the install_dir/profileTemplates directory.
  3. Run the file from the command line. Do not supply a -profilePath parameter. Here are some simple examples. For more complex examples, see or Augmenting profiles with manageprofiles command with Oracle database – examplesAugmenting profiles with manageprofiles command with Derby or DB2 databases – examples or Augmenting profiles with manageprofiles command with Oracle database – examples.
    • For i5/OS operating system manageprofiles -augment -templatePath install_root/profileTemplates/default.esbserver -profileName MyProfileName
    • For Linux operating systemFor UNIX operating system manageprofiles.sh -augment -templatePath install_root/profileTemplates/default.esbserver -profileName MyProfileName
    • For Windows operating system manageprofiles.bat -augment -templatePath install_root\profileTemplates\default.esbserver -profileName MyProfileName

    If you have created a response file, use the -response parameter: -response myResponseFile

    The following example shows a response file for an augment operation:
    augment
    profileName=testResponseFileAugment
    templatePath=install_root/profileTemplates/default.esbserver 
    
    nodeName=myNodeName
    cellName=myCellName
    hostName=myHostName
    omitAction=myOptionalAction1, myOptionalAction2

    The command displays status as it runs. Wait for it to finish. Normal syntax checking on the response file applies as the file is parsed like any other response file. Individual values in the response file are treated as command-line parameters.

What to do next

You can see that your profile augmentation completed successfully if you receive a INSTCONFSUCCESS: Profile augmentation succeeded. message, and you can check the following log file:
  • For Linux operating systemFor UNIX operating system install_root/logs/manageprofiles/profile_name_augment.log
  • For Windows operating system install_root\logs\manageprofiles\profile_name_augment.log
  • For i5/OS operating system user_data_root/profileRegistry/logs/manageprofiles/profile_name_augment.log
Run the Installation Verification Test (IVT) tool to verify that the profile was augmented successfully. To do this, run the following command:
  • For i5/OS operating system On i5/OS® platforms: profile_root/bin/wbi_ivt
  • For Linux operating systemFor UNIX operating system On Linux® and UNIX® platforms: profile_root/bin/wbi_ivt.sh
  • For Windows operating system On Windows® platforms: profile_root\bin\wbi_ivt.bat

task Task topic

Terms of use | Feedback


Timestamp icon Last updated: 21 June 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/doc/tins_manageprofiles_aug.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
This information center is powered by Eclipse technology (http://www.eclipse.org).