[AIX HP-UX Linux Solaris Windows]

Uninstalling the feature pack from distributed operating systems silently

You can use Installation Manager to uninstall this feature pack silently.

Before you begin

Optional: Perform or record the installation of Installation Manager, import of the WebSphere® Application Server Version 7.0.0.x product, and installation of the feature pack to a temporary installation registry on one of your systems so that you can use this temporary registry to record the uninstallation without using the standard registry where Installation Manager is installed.
Supported configurations [Fix Pack 11 or later] Supported configurations: You must use IBM Installation Manager Version 1.4.0 or later to install, modify, or uninstall a feature pack on WebSphere Application Server Version 7.0 Fix Pack 11 or later. For more information, see the support documentation for IBM Installation Manager.sptcfg

Procedure

  1. Stop all servers and applications on the WebSphere Application Server installations that contain the feature pack.
  2. Record a response file to uninstall the feature pack: On one of your systems, perform the following actions to record a response file that will uninstall the feature pack:
    1. From a command line, change to the eclipse subdirectory in the directory where you installed Installation Manager.
    2. Start Installation Manager from the command line using the -record option.
      For example:
      • [Windows] Administrator or non-administrator:
        IBMIM.exe -skipInstall "C:\temp\imRegistry" -record C:\temp\uninstall_response_file.xml
      • [AIX] [HP-UX] [Linux] [Solaris] Administrator:
        ./IBMIM -skipInstall /var/temp/imRegistry -record /var/temp/uninstall_response_file.xml
      • [AIX] [HP-UX] [Linux] [Solaris] Non-administrator:
        ./IBMIM -skipInstall user_home/var/temp/imRegistry -record user_home/var/temp/uninstall_response_file.xml
      Tip: If you choose to use the -skipInstall parameter with a temporary installation registry created as described in "Before you begin," Installation Manager uses the temporary installation registry while recording the response file. It is important to note that when the -skipInstall parameter is specified, no product packages are installed or uninstalled. All of the actions that you perform in Installation Manager simply update the installation data that is stored in the specified temporary registry. After the response file is generated, it can be used to uninstall the feature pack, removing the product files and updating the standard installation registry.

      The -skipInstall operation should not be used on the actual agent data location used by Installation Manager This is unsupported. Use a clean writable location, and re-use that location for future recording sessions.

      For more information, read Recording a response file with Installation Manager in the Installation Manager information center.

    3. Click Uninstall.
    4. In the Uninstall Packages window, perform the following actions.
      1. Select IBM® WebSphere Application Server V7 Feature Pack for Modern Batch and the appropriate version.
        Important: Do not select WebSphere Application Server Version 7.0.0.x unless you want to remove the base product from your systems along with the feature pack.
        Note: Do not select any other feature packs that you installed unless you want to remove them from your system along with this feature pack.
      2. Click Next.
      3. If a panel displays that indicates that you still have profiles that are augmented for the feature pack, perform one of the following actions:
        • Select the option to unaugment the profiles, and click Next.
        • Click Cancel to cancel the uninstallation.
        Important: Profiles augmented by a feature pack must be unaugmented or deleted before the feature pack is uninstalled. Profiles that are unaugmented should be deleted because they might not be valid after the feature pack is uninstalled.
    5. Review the summary information.
      Remember: If you include the WebSphere Application Server Version 7.0.0.x package, the base product will be removed from your systems.
    6. Click Uninstall.
    7. Click Finish.
    8. Click File > Exit to close Installation Manager.
    9. If you selected the option to unaugment the profiles and used the -skipInstall parameter when you started Installation Manager in recording mode, confirm that the option to unaugment profiles was recorded.
      Open the uninstallation response file that you created and confirm that it contains the following entry for each feature pack (offering) for which you want to unaugment profiles:
      <profile installLocation='app_server_root' id='value_of_profile_attribute_of_offering_element'>
          <data value='true' key='user.confirm.unaugment,value_of_id_attribute_of_offering_element' /> 
      </profile>
      If it does not, add the entry to the response file before using it for your silent uninstallations.
      If your response file contained this offering element, for example:
      <uninstall modify='false'>
          <offering profile='IBM WebSphere Application Server - ND' features='fep.bat.core.feature' 
           id='com.ibm.websphere.BATCH.v10' /> 
      </uninstall>
      
      you would add the following profile element:
      <profile installLocation='app_server_root' id='IBM WebSphere Application Server - ND'>
          <data value='true' key='user.confirm.unaugment,com.ibm.websphere.BATCH.v10' /> 
      </profile>

      See the example at the end of this article.

  3. Use the response file to uninstall the feature pack silently: From a command line on each of the systems from which you want to uninstall the feature pack, change to the eclipse subdirectory in the directory where you installed Installation Manager and use the response file that you created to silently uninstall the feature pack.
    For example:
    • [Windows] Administrator or non-administrator:
      IBMIMc.exe --launcher.ini silent-install.ini -input C:\temp\uninstall_response_file.xml -log C:\temp\uninstall_log.xml
    • [AIX] [HP-UX] [Linux] [Solaris] Administrator:
      ./IBMIM --launcher.ini silent-install.ini -input /var/temp/uninstall_response_file.xml -log /var/temp/uninstall_log.xml
    • [AIX] [HP-UX] [Linux] [Solaris] Non-administrator:
      ./IBMIM --launcher.ini silent-install.ini -input user_home/var/temp/uninstall_response_file.xml 
      -log user_home/var/temp/uninstall_log.xml

    Go to the Installation Manager information center for more information.

  4. Optional: Uninstall WebSphere Application Server Version 7.0.0.x.
    Important: Do not use the uninstall script to uninstall WebSphere Application Server if you have installed any of the feature packs on the product. If you have installed any feature packs on the product, use IBM Installation Manager to uninstall the feature packs and the product.
    1. Ensure that all Version 7.0 feature packs have been uninstalled.
    2. Record a response file to uninstall WebSphere Application Server: On one of your systems, perform the following actions to record a response file that will uninstall WebSphere Application Server Version 7.0.0.x from Installation Manager:
      1. From a command line, change to the eclipse subdirectory in the directory where you installed Installation Manager.
      2. Start Installation Manager from the command line using the using the -record option.
        For example:
        • [Windows] Administrator or non-administrator:
          IBMIM.exe -skipInstall "C:\temp\imRegistry"
          -record C:\temp\uninstall_response_file.xml
        • [AIX] [HP-UX] [Linux] [Solaris] Administrator:
          ./IBMIM -skipInstall /var/temp/imRegistry
          -record /var/temp/uninstall_response_file.xml
        • [AIX] [HP-UX] [Linux] [Solaris] Non-administrator:
          ./IBMIM -skipInstall user_home/var/temp/imRegistry
          -record user_home/var/temp/uninstall_response_file.xml
        Tip: If you choose to use the -skipInstall parameter with a temporary installation registry created as described in "Before you begin," Installation Manager uses the temporary installation registry while recording the response file. It is important to note that when the -skipInstall parameter is specified, no product packages are installed or uninstalled. All of the actions that you perform in Installation Manager simply update the installation data that is stored in the specified temporary registry. After the response file is generated, it can be used to uninstall the feature pack, removing the product files and updating the standard installation registry.

        The -skipInstall operation should not be used on the actual agent data location used by Installation Manager This is unsupported. Use a clean writable location, and re-use that location for future recording sessions.

        For more information, read Recording a response file with Installation Manager in the Installation Manager information center.

      3. Click Uninstall.
      4. In the Uninstall Packages window, select the WebSphere Application Server Version 7.0.0.x installation and click Next.
      5. Review the summary information, and click Uninstall.
      6. Click Finish.
      7. Click File > Exit to close Installation Manager.
    3. Use the response file to uninstall WebSphere Application Server silently: From a command line on each of the systems from which you want to uninstall WebSphere Application Server Version 7.0.0.x, change to the eclipse subdirectory in the directory where you installed Installation Manager and use the response file that you created to silently uninstall the product.
      For example:
      • [Windows] Administrator or non-administrator:
        IBMIMc.exe -launcher.ini silent-install.ini
        -input C:\temp\uninstall_response_file.xml -log C:\temp\uninstall_log.xml
      • [AIX] [HP-UX] [Linux] [Solaris] Administrator:
        ./IBMIM -launcher.ini silent-install.ini
        -input /var/temp/uninstall_response_file.xml -log /var/temp/uninstall_log.xml
      • [AIX] [HP-UX] [Linux] [Solaris] Non-administrator:
        ./IBMIM -launcher.ini silent-install.ini
        -input user_home/var/temp/uninstall_response_file.xml
        -log user_home/var/temp/uninstall_log.xml

      Go to the Installation Manager information center for more information.

  5. Optional: Uninstall IBM Installation Manager.
    Important: Before you can uninstall IBM Installation Manager, you must uninstall all of the packages that were installed by Installation Manager and all imported WebSphere Application Server installations.

    Read Silently uninstalling Installation Manager in the Installation Manager information center for information about using the uninstall script to perform this procedure.

Example [Windows]

The following is an example of a response file for silently uninstalling the feature pack.
<?xml version="1.0" encoding="UTF-8"?>

<!-- ##### Copyright ######################################################
# Licensed Materials - Property of IBM
# 5724-H88, 5724-J08, 5724-I63, 5724-H89 (c) Copyright IBM Corp. 2010. 
# All Rights Reserved. US Government Users Restricted Rights-Use, duplication 
# or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
# 
####################################################################### -->

<!-- ##### Frequently Asked Questions #####################################
# The latest information about using Installation Manager is 
# located in the online Information Center. There you can find 
# information about the commands and attributes used in 
# silent installation response files.
# 
#     Installation Manager Information Center can be found at:
#     http://publib.boulder.ibm.com/infocenter/install/v1r2/index.jsp
# 
# Question 1. How do I record a response file using Installation Manager?
# Answer 1. Start Installation Manager from the command line with the
# record parameter and it will generate a response file containing actions 
# it performed, repositories it used, and its preferences settings. 
# Optionally use the -skipInstall parameter if you do not want the product
# to be installed to the machine. Specify a new agentDataLocation location 
# value when doing a new installation. Do not use an existing 
# agentDataLocation for an installation because it might damage the 
# installation data and prevent you from modifying, updating, rolling back, 
# or uninstalling the installed packages.
#
# Windows: IBMIM -record <responseFile> -skipInstall <agentDataLocation>
# Linux or UNIX: ./IBMIM -record <responseFile> -skipInstall <agentDataLocation>
# 
# For example:
#   Windows = IBMIM.exe -record c:\temp\responsefiles\FEP.uninstall.xml
#     -skipInstall c:\temp\skipInstall\WebSphere_Feature_Pack
#   Linux or UNIX = ./IBMIM -record /home/user/responsefiles/FEP.uninstall.xml
#     -skipInstall c:\temp\skipInstall\WebSphere_Feature_Pack
# 
# Question 2. How do I run Installation Manager silently?
# Answer 2. Create a silent installation response file and submit it to 
# Installation Manager on the command line:
#
#   Windows = IBMIMc.exe -silent -input <path and file name of response file>
#   Linux or UNIX = ./IBMIM -silent -input <path and file name of response file>
# 
# For example: 
#   Windows = IBMIMc.exe -silent -input c:\temp\responsefile\FEP.uninstall.xml
#   Linux or UNIX = ./IBMIM -silent -input /home/user/responsefile/FEP.uninstall.xml
# 
# Note that Windows uses IBMIMc.exe, whereas Linux and UNIX uses IBMIM.exe.
# Do not use the command IBMIM.exe on Windows systems for silent installations.
# Do not use the command IBMIMc.exe on Linux and UNIX operating systems.
#
####################################################################### -->

<!-- ##### Uninstall Settings #############################################
# The clean and temporary attributes specify the repositories and other
# preferences Installation Manager uses and whether those settings
# should persist after the installation finishes.
# 
# Valid values for clean:
#      true = only use the repositories and other preferences that are 
#           specified in the response file.
#      false = use the repositories and other preferences that are specified 
#           in the response file and Installation Manager.
# 
# Valid values for temporary:
#      true = repositories and other preferences specified in the response
#           file do not persist in Installation Manager.
#      false = repositories and other preferences specified in the response
#           file persist in Installation Manager.
# 
####################################################################### -->

<agent-input temporary='true' clean='true'>

<!-- ##### Unaugment Profiles #############################################
# Profiles augmented by a WebSphere Application Server Feature Pack must
# have those feature pack specific changes removed before the feature pack
# can be uninstalled. Combine the unaugment data key with the offering ID 
# for the feature pack being uninstalled to unaugment the profiles. If 
# more than one feature pack is being uninstalled, then include a separate 
# unaugment data key for each feature pack offering. 
# 
# Several feature pack offering ID values are:
#      com.ibm.websphere.SCA.v10
#      com.ibm.websphere.XML.v10
#      com.ibm.websphere.CEA.v10
#      com.ibm.websphere.ARIESJPA.v10
# 
# Profiles that are unaugmented should be deleted because they might not
# be valid after the feature pack is uninstalled.
# 
# Valid values for data key user.confirm.unaugment:
#      true = unaugment all profiles containing augmentations associated
#           with the feature pack offering ID with the data key.
#      false = do not unaugment any profiles containing augmentations 
#           associated with the feature pack offering ID. Uninstall fails.
####################################################################### -->

<profile id='IBM WebSphere Application Server - ND'>
     <data key='user.confirm.unaugment,com.ibm.websphere.BATCH.v10' value='true'/>
     <!-- <data key='user.confirm.unaugment,com.ibm.websphere.featurepackID.v10' value='true'/> -->
</profile>

<!-- ##### Uninstall ######################################################
# Use the uninstall command to inform Installation Manager of the 
# installation packages to uninstall. 
# 
# The offering ID attribute is required because it specifies the 
# offering to be uninstalled. 
# 
# The profile attribute is required and must match the profile ID 
# of the targeted installation of WebSphere Application Server 
# version 7 in which the feature pack is installed. Profile ids can be 
# found in the installed.xml file located in the application data location 
# for Installation Manager.
# 
# The version attribute is optional. If a version number is provided, 
# then the version level specified must match exactly the version of 
# the offering in the specified profile. If the version attribute 
# is not provided, then the default behavior is to uninstall any
# version of the offering that is available in the specified profile.
# 
# The features attribute is optional. If the features attribute is not, 
# then the default behavior is to uninstall all features for the offering.
####################################################################### -->

<uninstall modify='false'>
     <offering id='com.ibm.websphere.BATCH.v10' 
        profile='IBM WebSphere Application Server - ND'/>
</uninstall>

<!-- ##### Preferences Settings ###########################################
# Preferences for Installation Manager can be specified. 
# These preference correspond to those that are located in the graphical
# interface under File / Preferences. 
# 
# If a preference command is omitted from or commented out of the response 
# file, then Installation Manager uses the preference value that was 
# previously set or the default value for the preference. 
# 
# The eclipseCache preference specifies the shared data location for 
# Installation Manager. This value is typically set the first time 
# Installation Manager does an installation. After this value is set, 
# is cannot be changed using a response file or the graphical wizard. 
# If this preference is uncommented, ensure that the location matches the 
# location used by Installation Manager and can be written to by all 
# user accounts using Installation Manager.
# 
# Preference settings might be added or deprecated in new versions of
# Installation Manager. Consult the online Installation Manager
# Information Center for the latest set of preferences and 
# descriptions about how to use them.
#
# http://publib.boulder.ibm.com/infocenter/install/v1r2/index.jsp
# 
####################################################################### -->

<!-- 
<preference name='com.ibm.cic.common.core.preferences.eclipseCache' value='/home/user/IBM/WebSphere/IMShared'/> 
<preference name='com.ibm.cic.common.core.preferences.connectTimeout' value='30'/>
<preference name='com.ibm.cic.common.core.preferences.readTimeout' value='30'/>
<preference name='com.ibm.cic.common.core.preferences.downloadAutoRetryCount' value='0'/>
<preference name='offering.service.repositories.areUsed' value='true'/>
<preference name='com.ibm.cic.common.core.preferences.ssl.nonsecureMode' value='false'/>
<preference name='com.ibm.cic.common.core.preferences.http.disablePreemptiveAuthentication' value='false'/>
<preference name='http.ntlm.auth.kind' value='NTLM'/>
<preference name='http.ntlm.auth.enableIntegrated.win32' value='true'/>
<preference name='com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts' value='true'/>
<preference name='com.ibm.cic.common.core.preferences.keepFetchedFiles' value='false'/>
<preference name='PassportAdvantageIsEnabled' value='false'/>
<preference name='com.ibm.cic.common.core.preferences.searchForUpdates' value='false'/>
 -->

</agent-input>
Tip: In this example above, the offering tag does not specify the version attribute (version='1.0.0.20090716_2245' for example). If the version attribute is included, you can use the uninstallation response file only for the specified version of the offering. Go to the Installation Manager information center for more information.



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=tins_uninstallfp_silent
File name: tins_uninstallfp_silent.html