Creating customized CIP profiles

The Installation Factory allows for a customized installation package (CIP) to be created that bundles an installation image, maintenance packages, previously exported standalone application server configuration archives, EARs, user files, and scripts. An installer can use an existing CIP to install an exact replica of a model application serving environment, with installed maintenance packages, configured profiles, and deployed applications.

Before you begin

The installer can use the enhanced Profile Creation wizard in the CIP to create profiles and automatically restore the profile customizations that are included in the CIP. Or, the installer can use the wasprofile command to perform the same tasks manually from the command line.

If you cannot use the Profile Creation wizard, use the wasprofile command to restore the customized profiles as described in Creating customized CIP profiles from the command line.

You must have previously installed a CIP to create CIP profiles and restore customizations that are included in the CIP.

Configuration archives are available for use in a CIP only when WebSphere Application Server is bundled with maintenance at the Version 6.0.2.5 level or higher. As you might expect, the configuration archive file must export from a system that has maintenance applied at a maintenance level of Version 6.0.2.5 or higher.

If you are restoring a customized profile that uses messaging, you must also include a script to configure the service integration bus (SIB). The original SIB configuration is not portable and, therefore, is not included in the CIP.

[HP-UX] Note: If you include any customized shell scripts for the HP-UX operating system, you must add #!/bin/sh as the first line of the script or the script will fail to run.

You cannot restore a CAR enabled with a feature pack using a CIP at this time. The only available profile type which can be restored in a CIP is an unaugmented stand-alone application server profile.

About this task

The series of configuration events for using a configuration archive and other CIP customizations is shown in the following Version 6.x. example:
  1. An expert installs Version 6.x.
  2. The expert installs Refresh Pack 2 (or higher) for Version 6.x to raise the model system to the Version 6.x.2 maintenance level.
  3. The expert installs Fix Pack 5 or a later fix pack for Version 6.x.2 to raise the model system to the required Version 6.x.2.5 or later maintenance level.
  4. The expert creates a default (stand-alone application server) profile, deploys applications, and makes other configuration changes.
  5. The expert creates a configuration archive of the default profile using the wsadmin tool:
    wsadmin -conntype NONE -c "$AdminTask exportWasprofile {-archive myarchive.car}

    Note: The first steps above are optional and are only required if a configuration archive needs to be exported for inclusion in a CIP. If configuration archive customization is not required, then the steps above can be omitted.

  6. The expert uses the Installation Factory to create a CIP that includes the 6.x product image.
    The CIP optionally includes a refresh pack as well as a fix pack.
    1. The expert optionally includes scripts to run during install time or uninstall time.
    2. The expert optionally includes the configuration archive in the CIP when configuration profile customization for the Stand Alone Application Server config.
    3. You can only include EARs for the standalone profile
    4. You can include scripts for all profile types.
    5. The expert optionally includes additional files to be installed on the system.
  7. The expert distributes the CIP to installers who require the pre-configured system for their users.
  8. The installers install the CIP.
  9. The installers use the specialized Profile creation wizard in the CIP to create a profile.
Table 1. Profile Creation wizard locations and functions
Profile Creation wizard Location Creates Customized Profiles? Creates Normal Profiles?
Enhanced IF version Launch the Profile Creation wizard check box at the end of the CIP installation. (cip_app_server_root/ProfileCreator/) Yes No *
Enhanced IF version cip_app_server_root/ProfileCreator/ Yes No *
Product version cip_app_server_root/bin/ProfileCreator/ No Yes
Profile version cip_app_server_root/profiles/profile_name/bin/ProfileCreator/ No Yes
* The enhanced Profile Creation wizard exists only when there is a customization for a profile. If no customization exists, this enhanced Profile Creation wizard is not present in the CIP. In such a case, the checkbox at the end of the CIP installation wizard opens the normal Profile Creation wizard.

A configuration archive is available for an application server CIP profile only. A special profile template enables the importation of a configuration archive file into the application server profile.

Use the enhanced Profile Creation wizard to create profiles that accept configuration actions that are included in the CIP. Use the minimal default profile template to create an application server when you are restoring a configuration archive file. If the customizations do not restore a CAR, the normal application server template creates the application server profile. Either type of application server profile accepts other configuration actions in the CIP that might deploy EAR files and run scripts.

Table 2. Allowed customizations
CIP Profile Type Include and Run Scripts Include and Deploy an Enterprise Archive (EAR) Include and Restore a Configuration Archive (CAR)
Deployment manager

(dmgr profile)

Yes No No
Stand-alone application server

(default profile)

Yes Yes Yes
Custom

(managed profile)

Yes No No

Procedure

Results

After creating the profile and restoring the customizations, the installation should have a profile that is configured like the profile in the model product installation that was the pattern for the CIP. Existing customizations for a profile template apply to any profiles that you create with the enhanced Profile Creation wizard.

To create a profile without the exact same customizations, in other words, a normal profile, use the normal product Profile Creation wizard in the cip_app_server_root\profiles\profile_name\bin\ProfileCreator directory.

What to do next

After installing your customized system, install a Web server and plug-ins, if necessary, and startthe application server to test your applications.



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    

Terms of Use | Feedback

Last updated: Aug 29, 2010 5:25:00 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=vela&product=was-base-dist&topic=tins_if_restore_car_gui
File name: tins_if_restore_car_gui.html