WAS v8.0 > Install the application serving environment > Distributed operating systems > Install and uninstall the DMZ Secure Proxy Server


Install the DMZ Secure Proxy Server using response files

We can install the DMZ Secure Proxy Server for IBM WebSphere Application Server using Installation Manager response files. Installing the DMZ Secure Proxy Server allows a secure proxy server profile to be created outside of the cell.

Install Installation Manager on each of the systems onto which to install the product.

  1. Perform one of the following procedures:

    • To use the Installation Manager that is included with this product, perform the following actions:

      1. Obtain the necessary files from the physical media or the web.

        There are three basic options for obtaining and installing Installation Manager and the product.

        • Access the physical media, and use local installation

          You can access Installation Manager and the product repositories on the product media. We can install Installation Manager on the system and use it to install the product from the product repositories on the media.

        • Download the files from the Passport Advantage site, and use local installation

          Licensed customers can download Installation Manager as well as the necessary product repositories from the Passport Advantage site. We can then install Installation Manager on the system and use it to install the product from the repositories.

          Tip: See How to download WAS V8.0 from Passport Advantage Online for a list of the IBM WebSphere Application Server v8.0 installation images downloadable from the IBM Passport Advantage Online website and other information.

        • Download a file from the Installation Manager website, and use web-based installation

          We can download and unpack a compressed file containing Installation Manager from the IBM Installation Manager download website. We can then install Installation Manager on your local system and use it to install the product from the web-based repository located at 

          http://www.ibm.com/software/repositorymanager/com.ibm.websphere.NDDMZ.v80

          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 specify in the response file so that the installation can access the files in this repository.

      2. Change to the location containing the Installation Manager installation files, and run one of the following commands to install Installation Manager:

        Administrative installation:

        • installc.exe -log log_file_path_and_name
        • ./installc -log log_file_path_and_name

        Non-administrative installation:

        • userinstc.exe -log log_file_path_and_name
        • ./userinstc -log log_file_path_and_name

        Group-mode installation:

        ./groupinstc -dataLocation application_data_location -log log_file_path_and_name

        Notes on group mode:

        • Group mode allows multiple users to use a single instance of IBM Installation Manager to manage software packages.
        • Group mode is not available on Windows operating systems.

        • If you do not install Installation Manager using group mode, you will not be able to use group mode to manage any of the products that you install later using this Installation Manager.

        • Make sure that you change the installation location from the default location in the current user's home directory to a location that is accessible by all users in the group.

        • Set up your groups, permissions, and environment variables as described in the Group mode road maps in the IBM Installation Manager v1.4 Information Center before installing in group mode.

        • For more information on using group mode, read the Group mode road maps in the IBM Installation Manager v1.4 Information Center.

    • If you already have a version of Installation Manager installed on the system and to use it to install and maintain the product, obtain the necessary product files from the physical media or the web.

      There are three basic options for installing the product.

      • Access the physical media, and use local installation

        You can access the product repositories on the product media. Use your existing Installation Manager to install the product from the product repositories on the media.

      • Download the files from the Passport Advantage site, and use local installation

        Licensed customers can download the necessary product repositories from the Passport Advantage site. We can then use your existing Installation Manager to install the product from the repositories.

        Tip: See How to download WAS V8.0 from Passport Advantage Online for a list of the IBM WebSphere Application Server v8.0 installation images downloadable from the IBM Passport Advantage Online website and other information.

      • Access the live repositories, and use web-based installation

        You can install Installation Manager on your local system and use it to install the product from the web-based repository located at 

        http://www.ibm.com/software/repositorymanager/com.ibm.websphere.NDDMZ.v80

        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 specify in the response file so that the installation can access the files in this repository.

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

  2. Add the product repository to your Installation Manager preferences.

    1. Start Installation Manager.

    2. In the top menu, click File > Preferences.

    3. Select Repositories.
    4. Perform the following actions:

      1. Click Add Repository.

      2. Enter the path to the repository.config file in the location containing the repository files.

        For example:

        • C:\repositories\product_name\local-repositories
        • /var/repositories/product_name/local-repositories

        or 

        http://www.ibm.com/software/repositorymanager/com.ibm.websphere.NDDMZ.v80

      3. Click OK.

    5. Deselect any locations listed in the Repositories window that you will not be using.

    6. Click Apply.

    7. Click OK.

    8. Click File > Exit to close Installation Manager.

Use Installation Manager, you can work with response files to install the DMZ Secure Proxy Server in a variety of ways. We 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.


Procedure

  1. Optional: Record a response file to install the DMZ Secure Proxy Server: On one of the systems, perform the following actions to record a response file that will install the DMZ Secure Proxy Server.

    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:

      • Administrator or non-administrator: 
        IBMIM.exe -skipInstall "C:\temp\imRegistry"
  -record C:\temp\install_response_file.xml
      • Administrator: 
        ./IBMIM -skipInstall /var/temp/imRegistry
  -record /var/temp/install_response_file.xml
      • 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 v1.4 Information Center.

    3. Add the appropriate repositories to your Installation Manager preferences.

      1. In the top 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_80_repository
            or 
            http://www.ibm.com/software/repositorymanager/com.ibm.websphere.NDDMZ.v80
          • Local repositories:

            • C:\repositories\proxy\local-repositories
            • /var/repositories/proxy/local-repositories

        3. Click OK.

      4. Click Apply.

      5. Click OK.

    4. Click Install.

      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 following actions.

      1. Select DMZ Secure Proxy Server for IBM WAS and the appropriate version.

        Note: If you are installing the trial version of this product, select DMZ Secure Proxy Server for IBM WAS Trial.

        If you already have the DMZ Secure Proxy Server installed on the system, a message displays indicating that the DMZ Secure Proxy Server is already installed.

        To create another installation of the DMZ Secure Proxy Server in another location, click Continue.

      2. Click Next.

    6. Accept the terms in the license agreements, and click Next.

    7. Specify the installation root directory for the DMZ Secure Proxy Server binaries, which are also referred to as the core product files or system files.

      The panel also displays the shared resources directory and disk-space information.

      Restrictions:

      • Delete the default target location and leaving an installation-directory field empty prevents you from continuing.
      • Do not use symbolic links as the destination directory.

        Symbolic links are not supported.

      • Do not use a semicolon in the directory name.

        The DMZ Secure Proxy Server cannot install properly if the target directory includes a semicolon.

        A semicolon is the character used to construct the class path on Windows systems.

      • The maximum path length on the Windows Server 2008, Windows Vista, and Windows 7 operating systems is 60 characters.

    8. Click Next.

    9. Select the languages for which translated content should be installed.

      English is always selected.

    10. Click Next.

    11. Select the features to install.

      Choose from the following features:

      • Administration Thin Client

        The Administration Thin Client is a runtime client that enables applications to run administration tasks to the application server.

        Tip: We can run the Installation Manager later to modify this installation and add or remove this feature.

      • IBM Runtime Environment for Java

        This option allows you to choose between a 32-bit and 64-bit IBM Runtime Environment for Java.

        Notes:

        • This option displays only if you are installing on a 64-bit system.
        • This does not apply to Solaris x86 64-bit systems.
        • We must select one of the two options.
        • You cannot modify this installation later and change this selection.

    12. Click Next.

    13. Review the summary information, and click Install.

      • If the installation is successful, the program displays a message indicating that installation is successful.

        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.

    14. Click Finish.

    15. Click File > Exit to close Installation Manager.

    16. Optional: If you are using an authenticated remote repository, create a keyring file for 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:

        • Administrator or non-administrator: 
          IBMIM.exe -skipInstall "C:\temp\imRegistry"
  -keyring C:\IM\im.keyring
  -record C:\temp\keyring_response_file.xml
        • Administrator: 
          ./IBMIM -skipInstall /var/temp/imRegistry
  -keyring /var/IM/im.keyring
  -record /var/temp/keyring_response_file.xml
        • 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.

        For more information, read the IBM Installation Manager v1.4 Information Center.

  2. Use the response files to install the DMZ Secure Proxy Server:

    1. Optional: Use the response file to install the keyring: Go to a command line on each of the systems on which to install the product, change to the eclipse/tools subdirectory in the directory where you installed Installation Manager, and install the keyring.

      For example:

      • Administrator or non-administrator: 
        imcl.exe -acceptLicense
  input C:\temp\keyring_response_file.xml
  -log C:\temp\keyring_log.xml
      • Administrator: 
        ./imcl -acceptLicense
  input /var/temp/keyring_response_file.xml
  -log /var/temp/keyring_log.xml
      • Non-administrator: 
        ./imcl -acceptLicense
  input user_home/var/temp/keyring_response_file.xml
  -log user_home/var/temp/keyring_log.xml

    2. Use the response file to install the product: Go to a command line on each of the systems on which to install the product, change to the eclipse/tools subdirectory in the directory where you installed Installation Manager, and install the product.

      For example:

      • Administrator or non-administrator: 
        imcl.exe -acceptLicense
  input C:\temp\install_response_file.xml
  -log C:\temp\install_log.xml
  -keyring C:\IM\im.keyring
      • Administrator: 
        ./imcl -acceptLicense
  input /var/temp/install_response_file.xml
  -log /var/temp/install_log.xml
  -keyring /var/IM/im.keyring
      • Non-administrator: 
        ./imcl -acceptLicense
  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.

      Read the IBM Installation Manager v1.4 Information Center for more information.


Example

The following is an example of a response file for installing the DMZ Secure Proxy Server. 

<?xml version="1.0" encoding="UTF-8"?>
<agent-input clean="true" temporary="true">
<server>
<repository location="http://www.ibm.com/software/repositorymanager/com.ibm.websphere.NDDMZ.v80" />

</server>
<install modify='false'>
<offering id='com.ibm.websphere.NDDMZ.v80'
  profile='DMZ Secure Proxy Server for IBM WAS V8.0'
  features='core.feature,thinclient,com.ibm.jre.6_32bit' installFixes='none'/>
</install>
<profile id='DMZ Secure Proxy Server for IBM WAS V8.0'
  installLocation='C:\IBM\WebSphere\AppServer'>
<data key='eclipseLocation' value='C:\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: Installing the DMZ Secure Proxy Server for IBM WAS for an annotated sample of a response file for performing this procedure.

Important: If you are installing on a 64-bit system, include one of the options for an IBM Runtime Environment for Java.

Follow these guidelines:


Install and uninstall the DMZ Secure Proxy Server
Install the DMZ Secure Proxy Server using the GUI
Install and uninstall features in the DMZ Secure Proxy Server
Install fix packs on the DMZ Secure Proxy Server using the GUI
Uninstall fix packs from the DMZ Secure Proxy Server using the GUI
Uninstall the DMZ Secure Proxy Server using the GUI
Uninstall the DMZ Secure Proxy Server using response files

+

Search Tips   |   Advanced Search