WebSphere Application Server - Express, Version 6.0.x     Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Installing the Express product with full installation options

This topic describes how to install IBM WebSphere Application Server - Express, Version 6 with full installation options.

Before you begin

This procedure is one of the installation paths that are available for any platform.

Select the appropriate installation path before you begin the installation.

Before starting the installation, see Using the launchpad to start the installation for information about the Installation solutions diagrams. The diagrams show typical topologies for the product. The solutions are also in Planning to install WebSphere Application Server - Express.

Why and when to perform this task

Perform the following installation to install all features for the WebSphere Application Server - Express product and to accept default characteristics for the application server profile.

Steps for this task

  1. Log on as root on a Linux or UNIX operating system, or as a member of the administrator group on a Windows system.
    [Linux][UNIX]In addition, verify that the umask setting is 022. To verify the umask setting, issue the following command:
    umask
    To set the umask setting to 022, issue the following command:
    umask 022
    [Windows]Some steps of the installation on a Windows platform require the administrator group user to have the following advanced user rights:
    • Act as part of the operating system
    • Log on as a service

    For example, on some Windows systems, click Administrative Tools > Local Security Policy > User Rights Assignments to see the advanced options. See your Windows documentation for more information.

    [Windows]The installation wizard grants your Windows user ID the advanced user rights, if the user ID belongs to the administrator group. The silent installation does not grant these rights. If you create a new user ID on a Windows platform to perform a silent installation, you must restart the system to activate the proper authorizations for the user ID before you can perform a successful silent installation.

    [Windows]When installing the WebSphere Application Server as a Windows service, do not use a user ID that contains spaces. A user ID with spaces cannot be validated. Such a user ID is not allowed to continue the installation. To work around this problem, install with a user ID that does not contain spaces, or do not choose to install Windows services.

  2. Insert the product CD-ROM labeled WebSphere Application Server - Express into the CD-ROM drive and mount the drive if necessary, as described in Mounting CD-ROMS on Linux and UNIX operating systems.
  3. Start the installation with the launchpad.sh command on Linux and UNIX platforms or the launchpad.bat on Windows platforms.
    You can also start the installation using the install command:
    • [Linux][UNIX]/WAS/install
    • [Windows]\WAS\install
    If you have a problem with using the correct Java 2 SDK, you can force the installation to use the correct SDK with the following command:
    • [Linux][UNIX]./install -is:javahome install_root/java
    • [Windows]install -is:javahome install_root\java

    If you have a problem starting the launchpad, use the troubleshooting information in Using the launchpad to start the installation to correct the problem.

    When using the launchpad, launch the Installation wizard for Express server.

    After launching the Installation wizard from the launchpad or from the command line, the InstallShield MultiPlatform (ISMP) wizard initializes and then displays the Welcome panel.

  4. Click Next to continue.

    The license agreement displays.

  5. Click the radio button beside the I accept the terms in the license agreement message to agree to the license agreement, then click Next to continue.

    After you accept the licensing terms, the Installation wizard checks for a supported operating system and prerequisite patches.

    If you encounter a problem such as not having the right prerequisite updates on your system, cancel the installation, make the required changes, and restart the installation.

    Although the Installation wizard checks for prerequisite operating system patches with the prereqChecker application, review the prerequisites on the IBM WebSphere Application Server supported hardware, software, and APIs Web site if you have not already done so.

    The Web site lists all supported operating systems and the operating system fixes and patches that you must install to have a compliant operating system.

    Refer to the documentation for non-IBM prerequisite and corequisite products to learn how to migrate to their supported versions.

  6. After confirming that your operating system is supported and that you have installed all necessary patches, click Next to continue.

    The Installation wizard checks for a previous installation at the same product level.

    If the wizard detects a previous installation, it displays the Existing installation panel. The panel lets you add features to the existing installation, perform a new installation to another directory, or perform an upgrade of a trial installation to the full product.

    If a Version 6 product exists:

    This scenario assumes that there is no existing V6 product on the machine.

    The wizard displays a panel that prompts you for the location of the installation root directory for the product binaries.

  7. [Linux][UNIX]Specify the destination of the installation root directory, then click Next.

    Specify the location of the installation root directory for the core product files, which are also known as the shared system files or the product binaries. The system files do not change unless you add features; install service such as refresh packs, fix packs, or interim fixes; or install a product that extends the Express product.

    The following list shows default installation locations for supported platforms:
    • [AIX]/usr/IBM/WebSphere/AppServer
    • [Linux][HP-UX][Solaris]/opt/IBM/WebSphere/AppServer
    • [Windows]C:\Program Files\IBM\WebSphere\AppServer
    [Linux][UNIX]
    Important: Do not use symbolic links as the destination directory. Symbolic links are not supported.

    [Linux][UNIX]Spaces are not supported in the name of the installation directory on Linux and UNIX systems.

    Deleting the default target location and leaving an installation directory field empty prevents you from continuing.

    Non-ASCII special characters are not supported in the name of the installation directory.

    The installer program checks for required space at the beginning of the installation. If you do not have enough space, stop the installation program, free space by deleting unused files and emptying the recycle bin, and restart the installation.

    [Windows]Important: Do not use a semi-colon in the directory name on all Windows systems. WebSphere Application Server cannot install properly on a Windows platform if the target directory includes a semi-colon. A semi-colon is the character used to construct the classpath in all Windows systems.

    The installation directory path must be no longer than 60 characters to successfully create the application server profile on a Windows 2000 system.

    The wizard displays the Installation options panel. The panel lets you choose whether to do a full installation or a custom installation. A custom installation displays the Features selection panel. Use the panel to select which features to install. This procedure documents using the full installation, which does not display the Features selection panel..

  8. Choose a type of installation, then click Next.

    Select Full installation to install all features. Choose this option to install everything you need to run Web applications on your serve. Use this option if you are new to WebSphere Application Server - Express and are unsure of what to install.

    The wizard displays the pre-installation summary panel for you to review before installing the product.

  9. Review the summary information, then click Next to install the product code or Back to change your specifications.

    The Installation wizard creates the uninstaller program and then displays a progress panel that shows which components are being installed. At the end of the installation, the wizard displays the Installation completion panel.

  10. Verify the success of the installer program by examining the completion panel and the log files for installation status.

    If problems occur, consult the following applicable log files. See Troubleshooting installation for the complete list of log files.

    Log files for WebSphere Application Server products: The following table shows the installation logs, content, and indicators of success and failure for WebSphere Application Server products for Version 6.
    Table 1. Installation and profile creation logs for WebSphere Application Server products
    Log Content Indicators
    install_root/logs/log.txt Logs all installation events
    INSTCONFFAIL
    Total installation failure.
    INSTCONFSUCCESS
    Successful installation.
    INSTCONFPARTIALSUCCESS
    Installation errors occurred but the installation is still usable. Additional information identifies the errors.
    install_root/logs/wasprofile/wasprofile_create_profile_name.log
    • Traces all events that occur during the creation of the named profile
    • Created when using the Profile creation wizard or the wasprofile command
    INSTCONFFAIL
    Total profile creation failure.
    INSTCONFSUCCESS
    Successful profile creation.
    INSTCONFPARTIALSUCCESS
    Profile creation errors occurred but the profile is still functional. Additional information identifies the errors.
    install_root/logs/wasprofile/wasprofile_delete_profile_name.log
    • Traces all events that occur during the deletion of the named profile
    • Created when using the Profile creation wizard or the wasprofile command
    INSTCONFFAIL
    Total profile deletion failure.
    INSTCONFSUCCESS
    Successful profile deletion.
    INSTCONFPARTIALSUCCESS
    Profile deletion errors occurred but the profile is still deleted. Additional information identifies the errors.
    install_root/profiles/profile_name/logs/pctLog.txt Logs all profile creation events that occur when using the Profile creation wizard
    INSTCONFFAIL
    Total profile creation failure.
    INSTCONFSUCCESS
    Successful profile creation.
    INSTCONFPARTIALSUCCESS
    Profile creation errors occurred but the profile is still functional. Additional information identifies the errors.
    install_root/logs/instconfig.log (Not available on Linux systems or UNIX systems) Logs the activities of ANT configuration scripts that run at the end of the installation procedure.
    Configuration action failed:
    Unsuccessful ANT script configuration.
    Configuration action succeeded:
    Successful ANT script configuration.

    If the installation of the core product files fails, fix the error and reinstall.

    If the creation of a profile fails, fix the error and run the Profile creation tool to recreate the profile.

    Troubleshoot the installation if the install_root/logs/log.txt file or the install_root/logs/wasprofile/wasprofile_create_default.log file does not contain a record of any problems, but problems exist.

    See Troubleshooting installation and Installation component troubleshooting tips for more information.

    [Windows]Examine the Start menu entry. The menu is an indication of a successful installation:
    • Programs > IBM WebSphere > Application Server, Express V6
    • [Windows]All Programs > IBM WebSphere > Application Server, Express V6

    If problems exist that cause you to reinstall the product, correct the errors, uninstall the product as described in Uninstalling the product, reboot a Windows machine or log off and back on as root on a Linux or UNIX machine, and reinstall.

  11. Click Finish to close the Installation wizard.

Result

This procedure results in the Installation wizard installing WebSphere Application Server - Express into the installation root directory. The Installation wizard creates a profile named default that provides the run-time environment for the server1 application server.

Further configuration is not necessary at this time. However, you can create additional stand-alone application servers with the Profile creation wizard. Each profile is created in the install_root/profiles directory by default.

See Using the Profile creation wizard for more information.

What to do next

Deploy an application to get started!

See Fast paths for WebSphere Application Server to get started deploying applications.




Related tasks
Installing the product and additional software

Task topic    

Terms of Use | Feedback

Last updated: Jun 8, 2005 12:45:23 PM EDT
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.express.doc/info/exp/ae/tins_typicale.html

© Copyright IBM Corporation 2004, 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)