[AIX Solaris HP-UX Linux Windows]

Installing IBM WebSphere SDK Java Technology Edition Version 7.0 or 7.1 using response files

IBM® WebSphere® SDK Java™ Technology Edition Version 6.0 is no longer in service. Using IBM Installation Manager, you can optionally install IBM WebSphere SDK Java Technology Edition Version 7.0 and 7.1., which are in service until July 2022. For new installations of WebSphere Application Server 8.5.5.11 or later, Java SE 8 is installed by default.

Before you begin

Attention: Starting in version 8.5.5.11, the default versions of Java are Java SE 6 or Java SE 8. As such, you can accept the default and install either Java SE 6 or Java SE 8 as the version of Java SE contained in the /java and /java64 directories in WebSphere Application Server and used by default during server and node configuration. Java 8 is the recommended Java SDK because it provides the latest features and security updates. You can continue to use Java SE 6, but no service can be provided after the end of support in April 2018, which might expose your environment to security risks.
Java SE 7 and Java SE 7.1 (not available for Solaris and HP) are also viable options for installing on WebSphere Application Server version 8.5.5.11.
  • The bit level of Java SE 7.0 is based on the bit level selected during the initial installation of WebSphere Application Server. If a 32-bit WebSphere Application Server is installed, then only the 32-bit Java SE 7.0 can be installed. If a 64-bit WebSphere Application Server is installed, then only the 64-bit Java SE 7.0 can be installed.
  • Installing the optional Java SE 7.0 or Java SE 7.1 does not imply that profiles can take advantage of this new version of Java. The managesdk command can be used to switch Java or the WebSphere Application Server administrative console (wsadmin) can be used to make the switch.

[8.5.5.14 or later]Starting in version 8.5.5.14, Java SE 8 is the default Java. When updating to 8.5.5.14, any existing profile that uses Java SDK 6 is replaced by Java SDK 8. You can continue to use Java SDK Java Technology Edition Version 7.0 and Version 7.1, but no service can be provided after the end of support in July 2022, which could expose your environment to security risks.

For more information on Java SE 6, 7, and 7.1 end of service, see Java SE 6, 7, and 7.1 end of service in WebSphere Application Server V8.5.

The com.ibm.websphere.IBMJAVA.v80 offering will be deprecated, and no fix packs or interim fixes will be provided for this offering after March 2020. If this offering is installed with WebSphere Application Server Version 8.5.5 after March 2020, uninstall it and switch to the default Java SE 8 SDK provided by the WebSphere Application Server package in the same package group. With the default Java SE 8 SDK, you continue receiving Java SE 8 SDK support, including security updates.

[8.5.5.18 or later]Starting in version 8.5.5.18 for Linux on POWER8 Little Endian (LE), the default versions of Java are Java SE 7.1 or Java SE 8. As such, you can accept the default and install either Java SE 7.1 or Java SE 8 as the version of Java SE contained in the /java directory in WebSphere Application Server and used by default during server and node configuration. Java 8 is the recommended Java SDK because it provides the latest features and security updates. You can continue to use Java SE 7.1, but no service can be provided after the end of support in July 2022, which might expose your environment to security risks.

You can use the user.wasjava=java8 property only with new installations of the product for Linux on POWER8 LE. The user.wasjava=java8 property does not work for product upgrades through fix packs for Linux on POWER8 LE.

[8.5.5.19 or later]Starting in version 8.5.5.19 for Linux on POWER8 Little Endian (LE), the default version of Java is Java SE 8. As such, you can accept the default and install Java SE 8 as the version of Java SE contained in the /java directory in WebSphere Application Server and used by default during server and node configuration. You can continue to use Java SE 7.1 by installing IBM WebSphere Java SDK Version 7.1, but no service can be provided after the end of support in July 2022, which might expose your environment to security risks.

The user.wasjava=java8 property is not required for installing and updating to version 8.5.5.19 for Linux on POWER8 LE.

Note: WebSphere Application Server Version 8.5.5.2 and later support IBM WebSphere SDK Java Technology Edition Version 7.1. This package is not available on the product media or on IBM Passport Advantage®.

About this task

You have the following options for installing IBM WebSphere SDK Java Technology Edition Version 7.0 or 7.1.
  • Version 7.0
    • Access the live repository, and use a web-based installation.

      Whenever possible, install from the remote web-based repositories so that you are accessing the most up-to-date installation files.

      If you have an IBM ID, you can use Installation Manager to install IBM WebSphere SDK Java Technology Edition Version 7.0 from the following web-based repository:
      https://www.ibm.com/software/repositorymanager/com.ibm.websphere.IBMJAVA.v70 
      Note: This location does not contain a web page that you can access using a web browser. This is a remote web-based repository location that you specify under File > Preferences to install IBM WebSphere SDK Java Technology Edition Version 7.0.
    • Download the files from the Passport Advantage site, and use a local installation.
      Licensed customers with an IBM ID can download the necessary repositories from the Passport Advantage site.
      1. Download the repositories from the Passport Advantage site.
        Tip: For a list of the IBM WebSphere Application Server Version 8.5 installation images, see How to download WebSphere Application Server V8.5 from Passport Advantage Online.
      2. Use Installation Manager to install IBM WebSphere SDK Java Technology Edition Version 7.0 from the downloaded repositories.
    • Access the repositories on the physical media and use a local installation.

      Use Installation Manager to install IBM WebSphere SDK Java Technology Edition Version 7.0 from the product repositories on the media.

  • Version 7.1
    • Access the live repositories, and use a web-based installation.

      Whenever possible, install from the remote web-based repositories so that you are accessing the most up-to-date installation files.

      If you have an IBM ID, you can use Installation Manager to install IBM WebSphere SDK Java Technology Edition Version 7.1 from the following web-based repository:
      https://www.ibm.com/software/repositorymanager/com.ibm.websphere.IBMJAVA.v71 
      Note: This location does not contain a web page that you can access using a web browser. This is a remote web-based repository location that you specify under File > Preferences to install IBM WebSphere SDK Java Technology Edition Version 7.1.
    • Download the files from the IBM Fix Central site, and use a local installation.
      1. Download the 7.1.x.x-WS-IBMWASJAVA-partx repositories from IBM Fix Central. Each IBM WebSphere SDK Java Technology Edition fix pack repository has multiple parts.
      2. Use Installation Manager to install IBM WebSphere SDK Java Technology Edition Version 7.1 from the downloaded repositories.
Notes:
  • If you do not have an IBM ID, you must install IBM WebSphere SDK Java Technology Edition Version 7.0 from the product repositories on the media or from local repositories that were populated with the SDK installation files by using the Packaging Utility.
  • With the Packaging Utility, you can create and manage packages for installation repositories. You can copy multiple packages into one repository or copy multiple disks for one product into a repository. For example, you can copy packages from Passport Advantage or a web-based repository into a local repository. For more information on the Packaging Utility, see the IBM Installation Manager documentation.

Using Installation Manager, you can work with response files to install IBM WebSphere SDK Java Technology Edition Version 7.0 or 7.1 in a variety of ways. You can record a response file using the GUI as described in the following procedure, or you can generate a new response file by hand or by taking an example and modifying it.

The WebSphere Application Server offering installation determines whether Installation Manager installs a 32-bit or 64-bit version of IBM WebSphere SDK Java Technology Edition Version 7.0 or 7.1.
  • If the WebSphere Application Server offering has a 32-bit version of IBM WebSphere SDK Java Technology Edition Version 6.0 installed, Installation Manager installs a 32-bit version of SDK Version 7.0 or 7.1.
  • If the WebSphere Application Server offering has a 64-bit version of SDK Version 6.0 installed, Installation Manager installs a 64-bit version of SDK Version 7.0 or 7.1.
  • For DMZ Secure Proxy Server for IBM WebSphere Application Server, which has only a JRE, Installation Manager installs an SDK Version 7.0 or 7.1 bit architecture corresponding to that of the JRE.

Procedure

  1. Optional: Record a response file to install IBM WebSphere SDK Java Technology Edition Version 7.0 or 7.1: On one of your systems, perform the following actions to record a response file that will install IBM WebSphere SDK Java Technology Edition Version 7.0 or 7.1.
    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\install_response_file.xml
      • [Linux][AIX][HP-UX][Solaris]Administrator:
        ./IBMIM -skipInstall /var/temp/imRegistry 
          -record /var/temp/install_response_file.xml
      • [Linux][AIX][HP-UX][Solaris]Non-administrator:
        ./IBMIM -skipInstall user_home/var/temp/imRegistry 
          -record user_home/var/temp/install_response_file.xml
      Tip: When you record a new response file, you can specify the -skipInstall parameter. Using this parameter has the following benefits:
      • No files are actually installed, and this speeds up the recording.
      • If you use a temporary data location with the -skipInstall parameter, Installation Manager writes the installation registry to the specified data location while recording. When you start Installation Manager again without the -skipInstall parameter, you then can use your response file to install against the real 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 the IBM Installation Manager documentation.

    3. Add the appropriate repositories to your Installation Manager preferences.
      1. In the menu, click File > Preferences.
      2. Select Repositories.
      3. Perform the following actions for each repository:
        1. Click Add Repository.
        2. Enter the path to the repository.config file in the remote web-based repository or the local directory into which you unpacked the repository files.
          For example:
          • Remote repositories:
            https://downloads.mycorp.com:8080/WAS_85_repository
            or
            https://www.ibm.com/software/repositorymanager/com.ibm.websphere.IBMJAVA.v70 
            https://www.ibm.com/software/repositorymanager/com.ibm.websphere.IBMJAVA.v71 
          • Local repositories:
            • [Windows]C:\repositories\jdk7\local-repositories
            • [Linux][AIX][HP-UX][Solaris]/var/repositories/jdk7/local-repositories
        3. Click OK.
      4. Click Apply.
      5. Click OK.
    4. Click Install.
      Note: If you are prompted to authenticate, use the IBM ID and password that you registered with on the program website.

      Installation Manager searches its defined repositories for available packages.

    5. Perform the appropriate actions.
      1. Select IBM WebSphere SDK Java Technology Edition and the appropriate version, and click Continue.
      2. Select the fixes to install.

        Any recommended fixes are selected by default.

        If there are recommended fixes, you can select the option to show only recommended fixes and hide non-recommended fixes.

      3. Click Next.
    6. Select the appropriate WebSphere Application Server installation on which to install IBM WebSphere SDK Java Technology Edition Version 7.0 or 7.1, and click Next.
    7. Click Next.
    8. Review the summary information, and click Install.
      • If the installation is successful, the program displays a message indicating that installation is successful.
        Note: The program might also display important post-installation instructions as well.
      • If the installation is not successful, click View Log File to troubleshoot the problem.
    9. Click Finish.
    10. Click File > Exit to close Installation Manager.
    11. Optional: If you are using an authenticated remote repository, create a keyring file for silent installation.
      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" 
            -keyring C:\IM\im.keyring 
            -record C:\temp\keyring_response_file.xml
        • [Linux][AIX][HP-UX][Solaris]Administrator:
          ./IBMIM -skipInstall /var/temp/imRegistry 
            -keyring /var/IM/im.keyring 
            -record /var/temp/keyring_response_file.xml
        • [Linux][AIX][HP-UX][Solaris]Non-administrator:
          ./IBMIM -skipInstall user_home/var/temp/imRegistry 
            -keyring user_home/var/IM/im.keyring 
            -record user_home/var/temp/keyring_response_file.xml
      3. When a window opens that requests your credentials for the authenticated remote repository, enter the correct credentials and save them.
      4. Click File > Exit to close Installation Manager.
      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.

  2. Use the response files to install IBM WebSphere SDK Java Technology Edition Version 7.0 or 7.1:
    1. Optional: Use the response file to install the keyring: Go to a command line on each of the systems on which you want to install IBM WebSphere SDK Java Technology Edition Version 7.0 or 7.1, change to the eclipse/tools subdirectory in the directory where you installed Installation Manager, and install the keyring.
      For example:
      • [Windows] Administrator or non-administrator:
        imcl.exe
          input C:\temp\keyring_response_file.xml 
          -log C:\temp\keyring_log.xml
      • [Linux][AIX][HP-UX][Solaris]Administrator:
        ./imcl
          input /var/temp/keyring_response_file.xml 
          -log /var/temp/keyring_log.xml
      • [Linux][AIX][HP-UX][Solaris]Non-administrator:
        ./imcl
          input user_home/var/temp/keyring_response_file.xml 
          -log user_home/var/temp/keyring_log.xml
    2. Use the response file to install IBM WebSphere SDK Java Technology Edition Version 7.0 or 7.1: Go to a command line on each of the systems on which you want to install IBM WebSphere SDK Java Technology Edition Version 7.0 or 7.1, change to the eclipse/tools subdirectory in the directory where you installed Installation Manager, and install IBM WebSphere SDK Java Technology Edition Version 7.0 or 7.1.
      For example:
      • [Windows] Administrator or non-administrator:
        imcl.exe
          input C:\temp\install_response_file.xml 
          -log C:\temp\install_log.xml 
          -keyring C:\IM\im.keyring
      • [Linux][AIX][HP-UX][Solaris]Administrator:
        ./imcl
          input /var/temp/install_response_file.xml 
          -log /var/temp/install_log.xml 
          -keyring /var/IM/im.keyring
      • [Linux][AIX][HP-UX][Solaris]Non-administrator:
        ./imcl
          input user_home/var/temp/install_response_file.xml 
          -log user_home/var/temp/install_log.xml 
          -keyring user_home/var/IM/im.keyring
      Notes:
      • The relevant terms and conditions, notices, and other information are provided in the license-agreement files in the lafiles or product_name/lafiles subdirectory of the installation image or repository for this product.
      • The program might write important post-installation instructions to standard output.

Example

[Windows]The following is an example of a response file for installing IBM WebSphere SDK Java Technology Edition Version 7.0 or 7.1.
<?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.IBMJAVA.v70" /> 
</server>
<install modify='false'>
<offering id='com.ibm.websphere.IBMJAVA.v70' 
  profile='IBM WebSphere Application Server V8.5' installFixes='none'/>
</install>
<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.IBMJAVA.v71" /> 
</server>
<install modify='false'>
<offering id='com.ibm.websphere.IBMJAVA.v71' 
  profile='IBM WebSphere Application Server V8.5' installFixes='none'/>
</install>
<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>

What to do next

Tip: Run the managesdk command to switch the SDK used by commands and server profiles.