Installing WebSphere Application Server from your IBM i system

Install WebSphere® Application Server directly from your IBM® i system.

Before you begin

Prepare for the installation before using this procedure. See Preparing the operating system for installation on IBM i for more information.

Before you install WebSphere Application Server, ensure that your user profile has *ALLOBJ and *SECADM special authorities.

About this task

You can install WebSphere Application Server from Qshell using the INSTALL command. You can also use the RUNJVA command to invoke the installation wizard.

Procedure

  1. Sign on the IBM i system with a user profile that has *ALLOBJ and *SECADM special authorities.
  2. Verify that the host server jobs have started on your IBM i server.

    The host server jobs allow the installation code to run on IBM i. On a CL command line, enter the following command:

    STRHOSTSVR SERVER(*ALL)
  3. Place the WebSphere Application Server for IBM i disk in the disk drive of your server. Do not use the WebSphere Application Server for Windows® disk or any other operating system disk other than the disk for IBM i.
    The application server product installer is spanned across multiple CDs. If you are installing the product from the CDs, then you must use the following procedure or the installation will not proceed:
    1. Copy both installation CDs into the same parent directory (for example, WebSphere7) on your hard disk.
    2. Name the directories DISC1 and DISC2 (for example, WebSphere7/DISC1 and WebSphere7/DISC2).
    3. If your system's language is not set to English, then set the language to English for the duration of the installation.
      Avoid trouble: If your language is set to something other than English, the installation will fail.gotcha
    4. Run the installer from the DISC1 directory after following the remaining instructions in this document.
    5. After you have completed the installation, reset your system's language to its previous setting if you had changed it during the installation.
  4. Use the Copy (CPY) command to create a copy of the responsefile.base.txt file from the disk.

    For example:

    CPY OBJ('/QOPT/WEBSPHERE/WAS/responsefile.base.txt') TODIR('/MYDIR')

    QOPT is the disk mount point.

    WEBSPHERE is the disk volume label.

    /WAS is the product directory on the disk. This will be referred to in later steps.
    Note: For DVD media, an additional directory prefix is required before the product directory that reflects the operating system and architecture of the installation. Using the previous example, the following installation path applies when you use CD-ROM media:
    CPY OBJ('/QOPT/WEBSPHERE/WAS/responsefile.base.txt')
    TODIR('/MYDIR')
    However, the following installation path applies when you use DVD media to install the IBM i version of the product on the 64-bit architecture:
    CPY OBJ('/QOPT/WEBSPHERE/os400_ppc64/WAS/responsefile.base.txt')
    TODIR('/MYDIR')

    Read the packaging topics for more information.

  5. If you have not already done so, read the IBM International Program License Agreement located in the /WAS/lafiles directory.

    If you agree to the terms of the agreement, continue with the installation process.

  6. Edit the /MYDIR/responsefile.base.txt file. For more information about the installation options and values, see Customizing installation response files.
    1. Change the value for -OPT silentInstallLicenseAcceptance from false to true.

      A value of true indicates that you have read and accept the terms of the license agreement. This change is required to run the installation.

    2. Specify a Java™ Software Development Kit (SDK) to invoke the installer and configure the product and profiles. You can force the use of a specific Java SDK with the i5osjdklocation option in the response file.
      New feature: You can now choose to install and configure the application server product on IBM i using one of three supported Java SDKs. Read the "Customizing the response file" topic for more information.newfeat
    3. Various features might not be installed with the product by default. If you want to use install certain features, uncomment the -OPT addFeature line for each specific feature you want to install. Valid features are listed in the response file.
    4. By default, the PROF_enableAdminSecurity option is set to true. If you want to enable administrative security during installation, you must specify values for the PROF_adminUserName and PROF_adminPassword options.

      The user ID and password do not need to be a system user ID and password or an LDAP user ID and password. The ID-and-password pair specified are stored in the user registry and used for administrative security for the default profile. Write down the user ID and password.

      If you do not want to enable administrative security, change the value for the PROF_enableAdminSecurity option from true to false.

    5. Change other installation options to suit your installation requirements.
  7. Invoke the installation program for WebSphere Application Server for IBM i.

    To invoke the installation program for WebSphere Application Server for IBM i, run the INSTALL command from Qshell or use the RUNJVA command from the CL command line.

    In the following example commands, path/responsefile represents the fully-qualified path of the responsefile.base.txt file that you edited.

    • Run the INSTALL command from Qshell.
      1. On a CL command line, issue the STRQSH command to start the Qshell command shell.
      2. Issue the INSTALL command from the /WAS directory to start the installation program.
        INSTALL -options <path>/responsefile 
        Note:
        • The following path applies when you use the CD-ROM media and copy it to IFS, where <path> is the main directory to which you saved the image:
          cd <path>/DISC1/WAS
        • The following applies when installing from the DVD media:
          cd /QOPT/WEBSPHERE/os400_ppc64/WAS
        Avoid trouble: If you are installing across multiple CDs, then you must use one of the following SDKs: 5722-JV1 (or 5761-JV1) Option 11 or Option 12. If you are only using SDK 5761-JV1 Option 10, then you must manually invoke the Java command. See the response file for details on each SDK. To use SDK 5761-JV1 Option 10, perform the following steps:
        1. Change to the WAS directory:
          cd <path>/DISC1/WAS
        2. Invoke the command, where <path>/responsefile represents the fully-qualified path of your response file:
          /QIBM/ProdData/Java400/jdk6/bin/java -Xms64m -Dis.debug=1 -Dos400.dir.create.auth=RX -Dos400.file.create.auth=RX -Dcom.ibm.was.updi.skipDeleteOnReplace=true   -classpath setup.jar:preSetup.jar PreInstallSetup -is:javahome /QIBM/ProdData/Java400/jdk6/bin/java -options <path>/responsefile
        gotcha
      Important: Do not exit the Qshell session (PF3) until the installation has completed. Doing so might cause the installation to stop prematurely.
    • Issue the RUNJVA command from the CL command line.
      At the CL command line, change back to the /WAS directory before issuing the command.
      • The following path applies when you use the CD-ROM media and copy it to IFS:
        CHGCURDIR DIR('path/DISC1/WAS')
      • The following applies when you have the DVD media:
        CHGCURDIR DIR('/QOPT/WEBSPHERE/os400_ppc64/WAS')
      Enter the RUNJVA command on one line. The command is shown on more lines for formatting clarity.
      RUNJVA
      CLASS(run) PARM('-options' 'path/responsefile')
      CLASSPATH('lib/jt400.jar:setup.jar')
      PROP(
      ('Xbootclasspath/p' '../JDK/jre.pak/repository/package.java.jre/java/jre/lib/xml.jar')
      (java.version 1.6)
      (is.debug 1)
      )

Results

After you invoke the installation, messages are displayed that indicate the progress of the installation process. When the setup program completes, press F3 to exit.

Troubleshooting

Check the app_server_root/logs/install/log.txt file for success, partial success, or failure for an installation. If the app_server_root/logs/install directory does not exist, check the following locations for log files:
  • user_home/waslogs
  • user_home/niflogs/tmp/waslogs
where user_home is the home directory for the user performing the installation.

If the install completes indicating INSTCONFPARTIALSUCCESS, check the log files located under the user_data_root/profileRegistry/logs/manageprofiles directory for errors. Do not uninstall and attempt to reinstall. If you cannot determine the problem, contact IBM Support.

What to do next

For security purposes, if the host servers were not running prior to installation, it is recommended that you run the End Host Server (ENDHOSTSVR) command after the installation is complete.

Next: Go to Installing the WebSphere Application Server group PTF on IBM i to continue the installation.




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: Oct 21, 2010 12:08:31 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=compass&product=was-base-iseries&topic=tins_is_instloc
File name: tins_is_instloc.html