Installing and removing features on distributed operating systems
You can use Installation Manager to install and remove a product feature.
Before you begin
Make sure that your Installation Manager preferences are pointing to the appropriate web-based or local repositories containing the product.
About this task
Perform this procedure to use the Installation Manager GUI to install or remove a feature.
Procedure
Examples
- You can modify features:In the following list, the optional feature offering names are enclosed in parentheses:Here is an example of a response file for modifying the features in an installation:
For the Express product:<?xml version="1.0" encoding="UTF-8"?> <agent-input clean='true' temporary='true'> <server> <repository location="https://www.ibm.com/software/repositorymanager/com.ibm.websphere.BASE.v85" /> </server> <install modify='true'> <offering id='com.ibm.websphere.BASE.v85' profile='IBM WebSphere Application Server V8.5' features='samples'/> </install> <uninstall modify='true'> <offering id='com.ibm.websphere.BASE.v85' profile='IBM WebSphere Application Server V8.5' features='thinclient,ejbdeploy,embeddablecontainer'/> </uninstall> <profile id='IBM WebSphere Application Server V8.5' installLocation='C:\Program Files\IBM\WebSphere\AppServer'> <data key='eclipseLocation' value='C:\Program Files\IBM\WebSphere\AppServer'/> <data key='user.import.profile' value='false'/> <data key='cic.selector.nl' value='en'/> </profile> </agent-input>
<?xml version="1.0" encoding="UTF-8"?> <agent-input clean='true' temporary='true'> <server> <repository location="https://www.ibm.com/software/repositorymanager/com.ibm.websphere.EXPRESS.v85" /> </server> <install modify='true'> <offering id='com.ibm.websphere.EXPRESS.v85' profile='IBM WebSphere Application Server V8.5' features='samples'/> </install> <uninstall modify='true'> <offering id='com.ibm.websphere.EXPRESS.v85' profile='IBM WebSphere Application Server V8.5' features='thinclient,ejbdeploy,embeddablecontainer'/> </uninstall> <profile id='IBM WebSphere Application Server V8.5' installLocation='C:\Program Files\IBM\WebSphere\AppServer'> <data key='eclipseLocation' value='C:\Program Files\IBM\WebSphere\AppServer'/> <data key='user.import.profile' value='false'/> <data key='cic.selector.nl' value='en'/> </profile> </agent-input>
Tip: See Sample response file: Modifying IBM WebSphere Application Server for the base product or Sample response file: Modifying IBM WebSphere Application Server - Express for the Express product for an annotated sample of a response file for performing this procedure.Here is an example of using the imcl command to modify the features in an installation:
For the Express product, replaceimcl.exe modify com.ibm.websphere.BASE.v85 -addFeatures samples -removeFeatures thinclient,ejbdeploy,embeddablecontainer -repositories https://www.ibm.com/software/repositorymanager/com.ibm.websphere.BASE.v85 -installationDirectory C:\Program Files\IBM\WebSphere\AppServer -keyring C:\keyring_file.keyring -password password
BASE
in the command withEXPRESS
.Supported configurations:Starting in Installation Manager Version 1.6.2, the -keyring and -password options that were used to access credentials in a key ring file are deprecated. For Installation Manager Version 1.6.2 and later, use the -secureStorageFile and -masterPasswordFile options to store credentials in a credential storage file.
In Version 1.7, the format of the secure storage file is revised, and is no longer compatible with versions of Installation Manager before version 1.7. Update Installation Manager to version 1.7 or higher and then re-create and replace any secure storage files that you created with earlier versions.
There is no migration path from key ring files to storage files because of the differences in the file structures. You must create a storage file to replace a key ring file. For more information about using the -secureStorageFile and -masterPasswordFile options to store credentials in a credential storage file, see the IBM Installation Manager documentation.
- You can modify languages:
To change the installed languages, use the -properties argument with the cic.selector.nl property in the imcl command to specify the languages that you want in your installation.
For example:imcl.exe modify com.ibm.websphere.BASE.v85_8.5.0.20110503_0200 -repositories https://www.ibm.com/software/repositorymanager/com.ibm.websphere.BASE.v85 -installationDirectory C:\Program Files\IBM\WebSphere\AppServer -properties cic.selector.nl=en,,hu,,ko,,pl,,es -keyring C:\keyring_file.keyring -password password
English, Hungarian, Korean, Polish and Spanish would be installed after using this example. If you started with an installation with English only, this would add the other languages. If you started with an installation with more languages, the other languages would be removed.
For the Express product, replace
To find out which languages are installed, use listInstallationDirectories with the imcl command and specify either -long, or -verbose.BASE
in the command withEXPRESS
.For example:imcl.exe listInstallationDirectories -long