Installing WebSphere Application Server
Thanks to its graphical installer, installing WebSphere Application Server is quite simple.
If you want to evaluate WebSphere Application Server on a specific UNIX system, you can request a copy for evaluation purposes from IBM. Contact your IBM sales representative for more information.
A trial version of WebSphere Application Server for Linux systems is available as a download or on the Linux Software Evaluation Kit (SEK), a set of four DVDs containing evaluation products from IBM WebSphere, IBM Information Management®, Lotus®, Rational®, and Tivoli® that enable you to install and configure IBM middleware and start building and deploying applications. The software on these DVDs is fully functional and can be used for 60 days for evaluation purposes. Product support for this trial period is available.
This tutorial focuses on installing WebSphere Application Server from a downloaded file. If you are installing WebSphere Application Server from the Linux SEK DVDs, the archive file containing the installable files for WebSphere Application Server are located on DVD #3 of the set. The instructions for extracting the contents of the archive file on your DVD are the same as those for extracting installable files from a downloaded file.
The Supported platforms section of this tutorial includes a list of the UNIX and Linux platforms on which WebSphere Application Server is officially supported. As commercial products, UNIX systems provide standard capabilities that can be guaranteed to be present for use by commercial products such as WebSphere Application Server. Unfortunately, Linux distributions can be very different from each other, so WebSphere Application Server is only officially supported on certain distributions. However, you can also run WebSphere Application Server on other Linux distributions by making some minor modifications to those systems.
Note: If you are installing WebSphere Application Server on a UNIX or supported Linux platform, you can skip this section and proceed directly to the Extracting files and beginning the installation section of this tutorial.
For example, not all Linux distributions include a version of the JRE that is suitable for use by the WebSphere Application Server installer and certain WebSphere Application Server functions. On unsupported Linux distributions such as Ubuntu, you should download and install the IBM Java SDK for use during the installation process. See Resources for a link from which you can download the appropriate version of the IBM Java SDK for your system. After downloading this file, you can extract its contents and install them using the following steps:
Extract the contents of the archive file using a command like the following:
tar zxvf filename.tar.gz
Replace filename with the name of the IBM Java SDK archive file that you downloaded, which will be something like ibm-java-sdk-6.0-2.0-linux-x86_64.tar.gz. The directory that is created by the
tarcommand will be something like ibm-java-x86_64-60.
sudocommand to move the directory that was extracted from the archive file to a system directory such as /opt by using a command like the following:
mv DIRECTORY /opt
Replace DIRECTORY with the name of the directory that was created when you extracted the contents of the IBM Java SDK archive file that you downloaded.
Modify the series of directories that your system searches for binaries by executing a command like the following:
export PATH DIRECTORY:$PATH
You should add this command to your shell startup file (~/.bashrc) to ensure that you use this version of the JRE in the future.
On Ubuntu systems, you must also modify the default shell that is mapped to the generic UNIX/Linux shell, /bin/sh. Ubuntu systems use a lightweight shell named /bin/dash as /bin/sh, but this shell does not provide all the capabilities required by the WebSphere Application Server installation and startup scripts. To use the standard Bash shell as /bin/sh, execute the following commands on your Ubuntu system before beginning the WebSphere Application Server installation process:
sudo mv /bin/sh /bin/sh.ORIG sudo ln -s /bin/bash /bin/sh
These steps are sufficient to enable you to begin the WebSphere Application Server installation process on an Ubuntu system. Other Linux distributions may require similar changes.
After downloading or otherwise obtaining the archive file containing WebSphere Application Server or mounting the Linux SEK DVD #3 when using a Linux system, create a directory in which to extract the files from which you can actually install WebSphere Application Server. See Basic tasks for Linux Developers if you are unsure about how to mount your DVD or determine where it is mounted.
The /opt/WASTrial directory is the suggested location for extracting the files from which you will install WebSphere Application Server. To create this directory, do the following:
Depending on the UNIX operating system or Linux distribution
that is installed on the system where you are installing
WebSphere Application Server, use the
sudo -scommands to become a privileged user on your system. Enter the root password or your password (respectively) when prompted to do so.
Create the /opt/WASTrial directory using the
- Change directory to the /opt/WASTrial directory.
tarcommand to extract the contents of the file that you downloaded or the WebSphere Application Server archive file from the mounted DVD.
If you downloaded the file, use a command like the following:
tar zxvf /path/to/file/was.cd.7000.trial.base.linux.ia32.tar.gz
Replace /path/to/file with the full directory path of the location to which you downloaded the file.
If you are installing WebSphere Application Server from a DVD, use a command like the following:
tar zxvf /mountpoint/was7uxt/filename.tar.gz
Replace /mountpoint with the name of the directory on which SEK DVD #3 is mounted, and replace filename with the name of the WebSphere Application Server archive file in that directory. You may also have to replace was7uxt with the name of the directory containing the Linux archive file if a different directory name was used in the latest SEK DVD releases.
./launchpad.shcommand to start the Firefox Web browser, which displays the page shown in Figure 1.
Figure 1. Firefox Welcome page
Note: If you are using Linux for your evaluation, no 64-bit Linux version seems to be available for download. See Supported platforms for information about how to use the 32-bit Linux build on a 64-bit Linux system.
Click Launch the installation wizard for WebSphere Application Server Trial to begin the actual installation process. The graphical installer for WebSphere Application Server begins and displays its welcome screen, as shown in Figure 2.
Figure 2. WebSphere Application Server installer's welcome screen
The welcome screen shows that the graphical installer is working correctly and provides links to online sites that provide information and support for WebSphere and related products.
Click Next to proceed with the installation process.
The next page of the graphical installer displays the license under which WebSphere Application Server is released, as shown in Figure 3.
Figure 3. Accepting the IBM software license agreement
This license contains IBM licensing information for the evaluation version of WebSphere Application Server and language that excludes open source software that is distributed with IBM WebSphere Application Server from those terms and identifies separately licensed software components.
Select I accept the terms in the licensing agreement to accept the licensing terms. Click Next to proceed with the installation process. If you don't accept the license terms, a window displays asking you to confirm that fact. If you confirm that you do not accept the license terms, the installer exits.
The next page of the installer indicates whether your system satisfies the prerequisites for installation. If your system does not satisfy requirements, the installer may display information about any missing patches that you should install. In this case, you can either click Cancel to exit the installer and install the missing prerequisites, or simply proceed with the installation.
Click Next to proceed with the installation process.
Figure 4 shows the installer screen that enables you to install optional software while you install WebSphere Application Server.
Figure 4. Selecting optional software for installation
Optional software that you can install consists of the following:
- Sample applications: Source code and integrated applications for initial experimentation. The sample applications also serve as an excellent mechanism for verifying that WebSphere Application Server is installed correctly and is working properly on your system.
- Non-English language support for the administrative console: Language catalogs that provide national language support for WebSphere Application Server's administrative console. These language catalogs do not provide national language support for WebSphere Application Server itself, which is available in a separate item on this screen.
- Non-English language support for WebSphere Application Server: Language catalogs that provide national language support for WebSphere Application Server itself. These language catalogs do not provide national language support for WebSphere Application Server's administrative console, which is available in a separate item on this screen.
Unless you already have substantial experience with WebSphere Application Server, you should install the sample applications to provide a way for you to learn more about application integration and deployment in the WebSphere Application Server environment.
The default language package installed with WebSphere is English as spoken in the United States. Whether or not you install the optional language packages depends on your geographic location and language support requirements. The additional languages that are supported by the administrative console and WebSphere Application Server language support packs are Chinese, Czech, French, German, Hungarian, Italian, Japanese, Korean, Polish, Portuguese, Russian, and Spanish.
After selecting any additional features that you want to install, click Next to proceed with the installation process.
Next, the graphical installer displays the default location in which WebSphere Application Server will be installed, which is /opt/IBM/WebSphere/AppServer on UNIX and Linux systems. Figure 5 shows this screen.
Figure 5. Specifying the installation location
Note: I recommend that you do not change this location because installing WebSphere Application Server in non-standard locations can make local system administration more complex. Non-standard installation locations may also cause problems with WebSphere applications that may expect the standard installation location.
Click Next to proceed with the installation process.
The screen shown in Figure 6 enables you to identify the type of WebSphere Application Server environment you want to create during the installation process.
Figure 6. Specifying the target server environment
The environment refers to the administrative and network environment in which you are installing and integrating WebSphere Application Server. The environment that you select determines the type of execution profile that will be created automatically during the installation process (or whether one will be created at all). Your choices are the following:
- Management: Select this option if you are installing this copy of WebSphere Application Server to manage other application server environments on the local machine or on other systems on your network. Selecting this option creates an appropriate profile and will install and configure an administrative agent server, services for managing multiple application server environments, and an administrative agent to manage other application servers that are on the same machine.
- Application server: The default selection, this option creates an appropriate profile for installing a stand-alone application server that will run your enterprise applications and which can only be managed from its own administrative console.
- None: Select this option if you do not want to create an execution profile during installation. Only select this option if you will explicitly create one or more profiles after WebSphere Application Server is successfully installed on your system.
Click Next to proceed with the installation process.
Note: If you select None as your server execution environment, a warning dialog displays to inform you that at least one functional profile must be available to run WebSphere Application Server. Click Yes to proceed with the installation process without creating a profile during the installation process, and proceed to Summary page and actual installation. If you want to create a profile during the installation process, click No to return to the dialog shown in Figure 6 to modify your server execution environment setting.
The next screen of the installer, shown in Figure 7, enables you to create a secure account on your system for system administration through the WebSphere Application Server administrative console.
Figure 7. Defining an administrative user
Create an administrative user if you are installing a stand-alone or managed WebSphere Application Server—in other words, when you are installing WebSphere Application Server in an environment that creates a profile for you during the installation process, as described earlier in Specifying the WebSphere Application Server environment.
Enter a username and password for use in administering your WebSphere Application Server, and enter the password again to confirm that you typed it correctly the first time.
If you selected the sample applications for installation in the Selecting optional features for installation section, you will also be prompted to set a password for the user associated with those sample applications. Enter the password twice to ensure that you have typed it correctly or have at least made the same typo twice.
After supplying information about the administrative user (and, optionally, a password for the sample applications if you selected them for installation), click Next to proceed with the installation process.
As shown in Figure 8, a summary screen displays the configuration options that you have accepted or specified and provides a check box that enables you to verify that you have the necessary privileges to perform the installation.
Figure 8. Information about the proposed installation
In most cases, given that you are doing this installation as the root user, there's really no need to verify that you have the required privileges. Clear this check box and click Next to begin the installation process. A window displays showing the status of the installation process. The installation process first creates an uninstaller for WebSphere Application Server to simplify removing the software, if necessary. It then installs WebSphere Application Server, displaying status information as the installation proceeds.
When the installation finishes, the window shown in Figure 9 displays the success or failure of installation. If any errors occur, this window shows the location of a log file that you can examine to identify the problems and determine whether they were meaningful.
Figure 9. Summary information about your installation
This screen provides a check box that, because it is selected by default, starts the WebSphere Application Server First steps console when you exit the installer. The First steps console enables you to do some initial configuration of WebSphere Application Server.
At this point, you have two options:
- Leave the Launch the First steps console check box selected and click Finish to exit the installer and start the First steps console.
- Clear the Launch the First steps console check box and click Finish to exit the installer without starting the First steps console or WebSphere Application Server.
Congratulations: You've installed WebSphere Application Server. If you started the First steps console, proceed to the next section for information about using that console. Otherwise, you may want to do one of the following:
- Start the WebSphere Application Server manually.
- Integrate WebSphere Application Server with your system's Web server.
- Integrate WebSphere Application Server into your system's startup and shutdown processes.
- Access the WebSphere administrative console to begin configuring your WebSphere Application Server.