Install and Configure WebSphere Application Server On UNIX and Linux Systems

13/02/2019 Install and configure WebSphere Application Server on UNIX and Linux systems
IBM Developer Topics Community More open source at IBM
Introduction
Learn › AIX and UNIX
Before you start
Web servers and architectures
Install and configure WebSphere A

Installing WebSphere Application Server
Server on UNIX and Linux systems

Using the First steps console
Starting and stopping WebSphere

UNIX andServer
Application Linux are perfect platforms for WebSphere
Next steps
William von Hagen
SummaryPublished on December 22, 2008

Downloadable resources
Related topics
Before you start

Learn what to expect from this tutorial and how to get the most out of it.
About this tutorial
Application servers are a central component of the Web architectures used in enterprise com
with a general discussion of middleware in today's Web architectures, focusing on IBM's We
the different ways in which WebSphere Application Server can be deployed. The remainder o
information about how to install and configure WebSphere Application Server, integrate it int
and integrate it into your enterprise computing infrastructure. After completing this tutorial,
configure, and deploy WebSphere Application Server and its relationship with other applicat
computing environment.
Objectives
This tutorial provides:

https://www.ibm.com/developerworks/aix/tutorials/au-wasonlinux/index.html 1/32
• A review of common Web architectures and the role of application servers and middlewa
architectures.
• A basic understanding of WebSphere Application Server.
• An overview and comparison of common WebSphere installation and deployment mecha

Introduction
• Instructions for installing WebSphere Application Server on UNIX and Linux distributions
• A basic
Before overview of the initial configuration of the WebSphere Application Server.
you start
• Details
Web servers on
andhow to integrate WebSphere Application Server into the system startup and sh
architectures
start and stop the server manually.

Prerequisites
Application Server
This tutorial is written for beginning to intermediate-level systems administrators who may n
aNext
Web application server and who may be unfamiliar with modern Web server architectures.
steps
tutorial, you should have a general familiarity with UNIX command-line shells and text edito
Summary
System requirements
Related topics
To run the examples in this tutorial, you need administrative (root) privileges on a UNIX or Li
application server is currently installed. The system should have a minimum of 1GB of RAM.
When installing WebSphere Application Server, at least 3.1GB of disk space must be availab
1.3GB must be permanently available in the file system that contains the /opt directory, and
temporarily available in the file system from which you install WebSphere Application Server
If you are installing WebSphere Application Server on a Linux system, not all Linux distributio
Runtime Environment (JRE) that is suitable for use by the installer and certain WebSphere A
unsupported Linux distributions such as Ubuntu, you should download and install the IBM Ja
(SDK) and make some minor modifications to your system before installing WebSphere Appl
unsupported Linux distributions for instructions.
If you choose to install the IBM Java SDK, at least 450MB of additional disk space must be a
minimum of 175MB must be permanently available in the file system that contains the /opt d
be temporarily available in the file system from which you install IBM Java SDK.

Today's enterprise Web environments are much more sophisticated than the simple content
ago. Evolving Web software technologies and increasing connectivity between Web servers a
to
IBMrevolutionize
Developer what users Community
Topics can do from the Internet
More and the
open source at services
IBM that businesses can of
Web.
Introduction
Modern Web architectures and middleware
Before you start
Today's enterprise
Web servers Web architectures use what are known as n-tier architectures that enable
and architectures
sources beyond simple static content. To access remote data sources, these n-tier Web arch
middleware, which is the term for software that connects other applications or services. The
of middleware
Using is a Web
the First steps application server, such as IBM WebSphere Application Server, that h
console
interfaces (APIs) required by enterprise Web applications. These Web applications impleme
applications and resources (business logic) required by Web-based implementations of vario
Application Server
In n-tier
Next stepsWeb architectures, an application server can be running on the same system on wh
another system. The Web server acts as an intermediary between Web clients and the applic
Summary
application server acts as an intermediary between application logic and remote data requir
IBM WebSphere Application Server overview

Related topics
IBM WebSphere Application Server is a Java application server that is built using open stand
Enterprise Edition (Java EE), Extensible Markup Language (XML), and Hypertext Transfer Pro
WebSphere Application Server is typically used in conjunction with other IBM products, such
used with most other Web servers including the standard Apache HTTP Server, Microsoft® In
and the Sun Java System Web Server. The IBM HTTP Server includes a WebSphere Applicati
WebSphere configuration and administration.
WebSphere Application Server provides a robust, scalable environment for enterprise Web a
the reuse and integration opportunities provided by other WebSphere products minimize run
deliver a secure, standards-based infrastructure for Web-based application development an
existing WebSphere add-on products, supported development frameworks, and its support f
Service Component Architecture (SCA) satisfy the requirements of today's enterprise applica
development and integration of the new applications that will deliver tomorrow's solutions.
Both IBM WebSphere Application Server and IBM HTTP Server are supported on many platfo
HP-UX, IBM i (i5/OS, i6/OS, OS/400), IBM z/OS, Microsoft Windows®, and Solaris. See Suppo
information about hardware and software requirements.
Supported platforms
This tutorial discusses installing and configuring IBM WebSphere Application Server 7.0. Ver
supported on the following operating systems and associated hardware:
Introduction
• AIX
Before you start
• HP-UX on IA64 and HP-UX PA-RISC
• Linux (32 bit)
Installing
• LinuxWebSphere
for IBM i™,Application
System p™,Server
and System z™
• Sun
Using theSolaris on SPARC
First steps consoleand x86-64
• Microsoft
Starting
Windows 2000, Windows Server® 2003, and Microsoft Windows XP
and stopping WebSphere
Application Server
WebSphere Application Server is officially supported on the Red Hat Enterprise Linux version
Next steps
Server versions 9 and 10 Linux distributions, but you should be able to install it cleanly on an
up unsupported Linux distributions section provides tips to enable you to install and run Web
Summary
Linux distributions other than those that are officially supported.
Note: You can run the 32-bit Intel® architecture versions of WebSphere Application Server a
Related topics
system as long as you have installed your UNIX system's 32-bit compatibility libraries on tha
package and the package management system used for its installation differs on various UN
is the ia32-libs package.
Deploying WebSphere Application Server
WebSphere Application Server is typically deployed in one of two basic ways:
• As stand-alone application servers that support specific business logic and related appli
environments.
• In a network deployment scenario, where clusters of application servers deliver advance

performance, high-availability environments.
As your business requirements and information technology (IT) infrastructure grow, a stand-
Server installation can be integrated into the clusters created in a network deployment scen
This tutorial focuses on installing a stand-alone application server because of the site-specifi
deployments.

Thanks to its graphical installer, installing WebSphere Application Server is quite simple.
Introduction
Getting the installation files
Before you start
If
Webyou want and
servers to evaluate WebSphere Application Server on a specific UNIX system, you can re
architectures
purposes from IBM. Contact your IBM sales representative for more information.
A trialthe
Using version of WebSphere
First steps console Application Server for Linux systems is available as a download
Evaluation Kit (SEK), a set of four DVDs containing evaluation products from IBM WebSphere
Starting and
Lotus®, stoppingand
Rational®, WebSphere
Tivoli® that enable you to install and configure IBM middleware and st
Application Server
applications. The software on these DVDs is fully functional and can be used for 60 days for
support for this trial period is available.
Next steps
Summary
This tutorial focuses on installing WebSphere Application Server from a downloaded file. If y
Application Server from the Linux SEK DVDs, the archive file containing the installable files fo
are located on DVD #3 of the set. The instructions for extracting the contents of the archive fi
Relatedfor
those topics
extracting installable files from a downloaded file.
Setting up unsupported Linux distributions
The Supported platforms section of this tutorial includes a list of the UNIX and Linux platform
Application Server is officially supported. As commercial products, UNIX systems provide sta
guaranteed to be present for use by commercial products such as WebSphere Application Se
distributions can be very different from each other, so WebSphere Application Server is only
distributions. However, you can also run WebSphere Application Server on other Linux distrib
modifications to those systems.
Note: If you are installing WebSphere Application Server on a UNIX or supported Linux platfo
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
Server installer and certain WebSphere Application Server functions. On unsupported Linux
should download and install the IBM Java SDK for use during the installation process. Down
IBM Java SDK for your system. After downloading this file, you can extract its contents and i
steps:
1.
Extract the contents of the archive file using a command like the following:
IBM Developer
1
Topics Community
tar zxvf filename.tar.gz
More open source at IBM
Introduction
Replace filename with the name of the IBM Java SDK archive file that you downloaded, w
Before you start
java-sdk-6.0-2.0-linux-x86_64.tar.gz. The directory that is created by the tar command
Webx86_64-60.
servers and architectures
2.
Use the sudo command to move the directory that was extracted from the archive file to
using
Using a command
the First like the following:
steps console

1 mv DIRECTORY /opt
Application Server
Next steps
Replace DIRECTORY with the name of the directory that was created when you extracted
Summary
archive file that you downloaded.
3.
Modify
Related the series of directories that your system searches for binaries by executing a com
topics
1 export PATH DIRECTORY:$PATH
You should add this command to your shell startup file (~/.bashrc) to ensure that you use
future.
On Ubuntu systems, you must also modify the default shell that is mapped to the generic UN
systems use a lightweight shell named /bin/dash as /bin/sh, but this shell does not provide a
WebSphere Application Server installation and startup scripts. To use the standard Bash she
following commands on your Ubuntu system before beginning the WebSphere Application Se
1 sudo mv /bin/sh /bin/sh.ORIG

2 sudo ln -s /bin/bash /bin/sh
These steps are sufficient to enable you to begin the WebSphere Application Server installat
Other Linux distributions may require similar changes.
Extracting files and beginning the installation

After downloading or otherwise obtaining the archive file containing WebSphere Application
DVD #3 when using a Linux system, create a directory in which to extract the files from whic
Introduction Application Server. See Basic tasks for Linux Developers if you are unsure about
WebSphere
determine where it is mounted.
Before you start
The
Web /opt/WASTrial directory is the suggested location for extracting the files from which you
servers and architectures
Application Server. To create this directory, do the following:
1. Depending
Using on the
the First steps UNIX operating system or Linux distribution that is installed on the sys
console
WebSphere Application Server, use the su or sudo -s commands to become a privileged
root password or your password (respectively) when prompted to do so.
Application Server
2. Create the /opt/WASTrial directory using the mkdir /opt/WASTrial command.
Next steps
3. Change directory to the /opt/WASTrial directory.
Summary
4. Use the tar command to extract the contents of the file that you downloaded or the Web
file from the
Downloadable mounted DVD.
resources
If you
Related downloaded the file, use a command like the following:
topics
1 tar zxvf <em>/path/to/file</em>/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
If you are installing WebSphere Application Server from a DVD, use a command like the f
1 tar zxvf <em>/mountpoint/was7uxt/filename</em>.tar.gz
Replace /mountpoint with the name of the directory on which SEK DVD #3 is mounted, a
of the WebSphere Application Server archive file in that directory. You may also have to r
the directory containing the Linux archive file if a different directory name was used in th
5. Use the ./launchpad.sh command to start the Firefox Web browser, which displays the
Figure 1. Firefox Welcome page
Introduction
Before you start

Application Server
Note: If you are using Linux for your evaluation, no 64-bit Linux version seems to be availabl
Next steps
platforms for information about how to use the 32-bit Linux build on a 64-bit Linux system.
Summary
Starting the installer

Related topics
Click Launch the installation wizard for WebSphere Application Server Trial to begin the a
graphical installer for WebSphere Application Server begins and displays its welcome screen
Figure 2. WebSphere Application Server installer's welcome screen
The welcome screen shows that the graphical installer is working correctly and provides link
information and support for WebSphere and related products.

Click Next to proceed with the installation process.
Introduction
Accepting the license terms and checking your system
Before you start
The
Web next page
servers andof the graphical installer displays the license under which WebSphere Applica
architectures
in Figure 3.
Figure 3. Accepting the IBM software license agreement

Application Server
Next steps
Summary
Related topics
This license contains IBM licensing information for the evaluation version of WebSphere App
excludes open source software that is distributed with IBM WebSphere Application Server fr
separately licensed software components.
Select I accept the terms in the licensing agreement to accept the licensing terms. Click Ne
process. If you don't accept the license terms, a window displays asking you to confirm that
not accept the license terms, the installer exits.
The next page of the installer indicates whether your system satisfies the prerequisites for in
not satisfy requirements, the installer may display information about any missing patches th
you can either click Cancel to exit the installer and install the missing prerequisites, or simpl
Selecting optional features for installation

Figure 4 shows the installer screen that enables you to install optional software while you in
Server.
Introduction
Figure 4. Selecting optional software for installation
Before you start

Application Server
Next steps
Summary
Related topics
Optional software that you can install consists of the following:
• Sample applications: Source code and integrated applications for initial experimentatio
serve as an excellent mechanism for verifying that WebSphere Application Server is insta
properly on your system.
• Non-English language support for the administrative console: Language catalogs that p
for WebSphere Application Server's administrative console. These language catalogs do
support for WebSphere Application Server itself, which is available in a separate item on
• Non-English language support for WebSphere Application Server: Language catalogs t

support for WebSphere Application Server itself. These language catalogs do not provide
WebSphere Application Server's administrative console, which is available in a separate
Unless you already have substantial experience with WebSphere Application Server, you sho
applications to provide a way for you to learn more about application integration and deploy
Application Server environment.
The default language package installed with WebSphere is English as spoken in the United S
the optional language packages depends on your geographic location and language support
languages that are supported by the administrative console and WebSphere Application Serv
Chinese, Czech, French, German, Hungarian, Italian, Japanese, Korean, Polish, Portuguese, R

After selecting any additional features that you want to install, click Next to proceed with the
Introduction
Identifying the target installation directory
Before you start
Next, the graphical

Web servers installer displays the default location in which WebSphere Application Se
and architectures
/opt/IBM/WebSphere/AppServer on UNIX and Linux systems. Figure 5 shows this screen.
Figure 5. Specifying the installation location

Application Server
Next steps
Summary
Related topics
Note: I recommend that you do not change this location because installing WebSphere Appl
locations can make local system administration more complex. Non-standard installation loc
with WebSphere applications that may expect the standard installation location.
Specifying the WebSphere Application Server environment
The screen shown in Figure 6 enables you to identify the type of WebSphere Application Ser
create during the installation process.
Figure 6. Specifying the target server environment
Introduction
Before you start

The environment
Application Server refers to the administrative and network environment in which you are inst
Application Server. The environment that you select determines the type of execution profile
Next steps
during the installation process (or whether one will be created at all). Your choices are the fo
Summary
• Management: Select this option if you are installing this copy of WebSphere Application
application server environments on the local machine or on other systems on your netwo
an appropriate profile and will install and configure an administrative agent server, servic
Related topics
application server environments, and an administrative agent to manage other applicatio
machine.
• Application server: The default selection, this option creates an appropriate profile for in
server that will run your enterprise applications and which can only be managed from its
• None: Select this option if you do not want to create an execution profile during installati
will explicitly create one or more profiles after WebSphere Application Server is successf
Note: If you select None as your server execution environment, a warning dialog displays to
functional profile must be available to run WebSphere Application Server. Click Yes to procee
without creating a profile during the installation process, and proceed to Summary page and
create a profile during the installation process, click No to return to the dialog shown in Figur
execution environment setting.
Creating an administrative user
The next screen of the installer, shown in Figure 7, enables you to create a secure account on
administration through the WebSphere Application Server administrative console.

Figure 7. Defining an administrative user
Introduction
Before you start

Application Server
Next steps
Summary
Create an administrative
Downloadable resources user if you are installing a stand-alone or managed WebSphere App
when you are installing WebSphere Application Server in an environment that creates a profi
Related topics
process, as described earlier in Specifying the WebSphere Application Server environment.
Enter a username and password for use in administering your WebSphere Application Serve
confirm that you typed it correctly the first time.
If you selected the sample applications for installation in the Selecting optional features for
be prompted to set a password for the user associated with those sample applications. Ente
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 th
selected them for installation), click Next to proceed with the installation process.
Summary page and actual installation
As shown in Figure 8, a summary screen displays the configuration options that you have acc
check box that enables you to verify that you have the necessary privileges to perform the in
Figure 8. Information about the proposed installation
Introduction
Before you start

In most cases,
Application given that you are doing this installation as the root user, there's really no nee
Server
required privileges. Clear this check box and click Next to begin the installation process. A w
Next steps
of the installation process. The installation process first creates an uninstaller for WebSpher
removing
Summary the software, if necessary. It then installs WebSphere Application Server, displayin
installation proceeds.
Related topics
Installation status and next steps
When the installation finishes, the window shown in Figure 9 displays the success or failure o
this window shows the location of a log file that you can examine to identify the problems an
meaningful.
Figure 9. Summary information about your installation
Introduction
Before you start

This screenServer
Application provides a check box that, because it is selected by default, starts the WebSphe
console when you exit the installer. The First steps console enables you to do some initial co
Next steps
Application Server.
Summary
At this point, you have two options:
• Leave the Launch the First steps console check box selected and click Finish to exit the
Related topics
console.
• Clear the Launch the First steps console check box and click Finish to exit the installer w
console or WebSphere Application Server.
Congratulations: You've installed WebSphere Application Server. If you started the First step
section for information about using that console. Otherwise, you may want to do one of the f
• 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 proces
• Access the WebSphere administrative console to begin configuring your WebSphere App

The WebSphere Application Server installation process can automatically start a First steps
yourself with WebSphere Application Server and perform some initial configuration tasks. Fi
the First steps console.
Figure 10. First steps console
Introduction
Before you start

Application Server
Next steps
Summary
As shown in Figure 10, the First steps console provides links to a number of convenient task
immediately
Related topics after installation, including:
• Installation verification: Checks your WebSphere Application Server installation to verif

starts the application server as part of this check.
• Start the Server: Starts the WebSphere Application Server, displaying the output of the s
window for convenience and diagnostic purposes. When the application server is running
server link, which provides a convenient way to stop the server and displays the output o
a separate window. Stopping the server requires the administrative password that you se
and provides a convenient check that the application server's internal authentication me
• Administrative console: Starts the WebSphere Administrative console in a browser wind

configuration tasks that are outside the scope of the installation process. Starting the ad
the administrative password that you set during the installation process.
• Profile management tool: Enables you to create additional execution profiles, each of w
enterprise Web applications, port configurations, and so on. If you did not specify a targe
installation process and are not migrating server configuration information from an existi
installation, use this option to create at least one WebSphere Application Server profile. Y
Application Server without at least one profile—each profile provides the configuration in
application server in a specific context.
• Samples gallery: Provides access to the sample applications you installed during the ins
• Information center for WebSphere Application Server: Opens the WebSphere Applicat
browser to provide detailed information about WebSphere Application Server in a variety
IBMscenarios.
Developer Topics Community More open source at IBM
• Migration wizard: Starts a wizard that simplifies migrating configuration information and
of WebSphere Application Server.
Introduction
The next
Before youfew
startsections provide highlights of using selected options from the First steps conso
Installation verification
Using theerror
Though Firstmessages
steps console
would have displayed had any problems occurred during the WebSp
installation process, it's always comforting to be able to double-check that your application s
that all theServer
Application necessary configuration files were created correctly during that process.
Next
To stepsthat WebSphere Application Server was installed correctly on your system and start
verify
click the Installation verification link in the First steps console. A window like the one show
Summary
Figure 11. Output

Downloadable of the verification process
resources
Related topics
As you can see from this figure, the verification process first starts the application server wit
connects to the application server to verify the Servlet engine, JavaServer pages, and enterp
examines the authentication of the key stores that are used to provide secure connections b
When the verification process completes, you can click the close button in the upper right-ha
to close that window and return to the First steps console. Note that the Start the server link
server link because the WebSphere Application Server was started as part of the verification
Starting the server
If you choose not to verify your WebSphere Application Server installation as described in th
the WebSphere Application Server manually by clicking the Start the server link in the First s
displays an output window much like the one shown in Figure 11, except that it only shows t
server and does not probe the configuration of your server.
Note: If the First steps console does not show a Start the server link, but instead displays on
Introduction
WebSphere Application Server is already running.
Before you start
After a line like ADMU3000I: Server NAME open for e-business... displays in the output w
box in the upper right-hand corner of the output window to close that window and return to t

Administrative console
Application
The Server Application Server Administrative console is the primary mechanism for con
WebSphere
integrating
Next steps the application server with external applications such as database systems, and
If you are new to WebSphere Application Server and want to explore the administrative cons
Summary
WebSphere applications immediately after installing WebSphere, you may want to start the A
First steps console.
Click Administrative
Related topics console to start the WebSphere Administrative console from the First s
the Administrative console opens in a browser window, as shown in Figure 12.
Figure 12. Administrative console login screen
The Administrative console requires a Secure Sockets Layer (SSL) HTTP connection, general
Transfer Protocol over Secure Sockets Layer (HTTPS) connection. The page shown in Figure
party SSL certificate is installed on your system. If the system on which you installed WebSp
have a valid certificate issued by a third party, you will see a warning dialog like that shown i
Figure 13. Certificate not trusted alert

Introduction
Before you start

If you see this
Application message, see the next section of this tutorial for information about configurin
Server
system's existing certificate.
Next steps
If you see the Administrative console login screen as shown in Figure 12, enter the administ
Summary
that you defined during the installation process and click Login or press Return. The WebSph
Administrative console displays, as shown in Figure 14. You can explore or use the Administ
link in the
Related header when you are done.
topics
Figure 14. Administrative console
Configuring a certificate security exception

As discussed in the previous section, the WebSphere Application Server Administrative cons
connection, generally referred to as an HTTPS connection. According to the default security
this means that the public key security certificate presented by your system must be a valid
third-party certificate authority such as thawte, VeriSign, GeoTrust, and many others.
In a production environment, you will certainly only want to use WebSphere Application Serv
Introduction
enterprise or third-party security certificate so that users of your Web applications can verify
Before you start
they are connecting to. However, you may be installing and configuring WebSphere Applicati
which you have
Web servers not yet obtained a certificate. In this case, you can temporarily or permanen
and architectures
as a trusted one that is an exception to the standard WebSphere security policy.
To define a policy exception, click OK in the dialog shown in Figure 13 to display the screen s
Figure
Starting15.
andAstopping
secure connection
WebSpherefailure in Firefox
Application Server
Next steps
Summary
Related topics
Click the Or you can define an exception link to begin the process of identifying your system
public key certificate. A screen identical to the current screen displays, with the exception of
display at the bottom of the screen. Click Add exception to continue the process of defining
exception to the default certificate policy. The dialog shown in Figure 16 displays.
Note: Clicking the Get me out of here! button exits the exception definition process and retu
establishing a connection to the WebSphere Administrative console, which isn't all that usef
Figure 16. Initial dialog for defining a security exception
Introduction
Before you start

Application Server
Next steps
Summary
Click Get Certificate to retrieve your system's current certificate, which displays information
Related topics
enables the Confirm Security Exception button at the bottom left of the dialog shown in Fig
Figure 17. Updated dialog for defining a security exception
Introduction
Before you start

Application Server
Next steps
Summary
The Permanently store this exception check box above the Confirm Security Exception but
Related topics
whether your system permanently stores the current certificate as an exception to the secur
be accepted for the current session. When configuring systems for production use, clear this
always go through the security exception process to prevent you from forgetting to install a v
is running WebSphere Application Server. If you are working on a test system that will never
leave the Permanently store this exception check box selected.
Click the Confirm Security Exception button to define the current certificate as an exception
WebSphere Application Server Administrative console login screen displays, as shown in Fig
administrative username and password that you defined during the installation process and
access the WebSphere Application Server Administrative console, as shown in Figure 14. Yo
Administrative console, clicking the Logout link in the header when you are done.
Samples gallery
Clicking the Samples gallery link in the First steps console displays the page shown in Figure
experiment with the sample applications that you optionally installed during the WebSphere
process.
Figure 18. Sample applications gallery

Introduction
Before you start

Application Server
You can execute or modify these examples to get a feel for how to write WebSphere applicat
Next steps and perform in a WebSphere-based environment. The most interesting of the sam
displayed
Pet Store that enables you to walk through an example of browsing and purchasing products
Summary
When you're finished

Downloadable resourcesexperimenting with the sample applications, you can simply close the
First steps console.
Related topics
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console, you may w
server so that you can experiment with manually starting the application server or integratin
WebSphere Application Server into your system's startup and shutdown processes, as expla
tutorial. To stop the WebSphere Application Server from the First steps console, click the Sto
console. Clicking this link displays an authentication dialog like the one shown in Figure 19.
Figure 19. Authenticating to stop the application server
Enter the administrative username and password that you set during the installation process
application server shutdown process. A dialog like the one shown in Figure 20 displays, show
process.
Figure 20. Output from stopping the application server

Introduction
Before you start

After a line like ADMU4000I: Server NAME stop completed displays in the output window, y
upper right-hand corner of the output window to close that window and return to the First st
Application Server
Next steps
Starting
Summary
and stopping WebSphere Application
Installing WebSphere
Downloadable resources Application Server doesn't start the WebSphere Application Server pro
discussed in the previous section, the First steps console that displays by default at the end
Related topics
provides a convenient mechanism for starting WebSphere Application Server for the first tim
value after you complete the installation process and exit this console.
This section explains how to start and stop WebSphere Application Server manually and how
stopping the application server into the startup and shutdown processes for your system. If
Application Server for real work or long-term experimentation, you'll want it to start automat
and to shut down cleanly when you shut down your system.
As explained in the following sections, WebSphere Application Server provides convenient U

simplify the process of starting and stopping the application server from the command line o
as the ones that are run during your system's startup and shutdown processes.
Start WebSphere Application Server
WebSphere Application Server provides the startServer.sh shell script to simplify the appl
This script takes one argument, which is the name of the application server that you want to
newly installed the WebSphere Application Server, the name of the default server is server1
To start the application server, use the su or sudo -s commands (depending on the UNIX sys
using), to become a privileged user on the system where you installed the application server
password (respectively) when prompted to do so.
Next, enter the following command to start WebSphere Application Server:

Introduction
1 /opt/IBM/WebSphere/AppServer/bin/startServer.sh server1
Before you start
Web
As servers
the and architectures
application server starts, you will see output similar to that displayed in the output wi
command prompt redisplays when the server startup process completes and the application

System startup and shutdown integration
Application Server
After installing a Web server on your system, you typically want it to start automatically any t
Next steps
When installing WebSphere Application Server on platforms such as Microsoft Windows, the
to define the server and administration server as Windows services that start automatically w
Summary
Unfortunately, the UNIX and Linux installers don't provide any equivalent integration into the
Downloadable
systems. resources
Therefore, you must manually integrate WebSphere Application Server into the sta
systems.
Related topics
All UNIX and Linux systems define the tasks that should be performed during the startup and
of shell scripts (commonly referred to as init scripts) that are executed as the system starts.
these scripts are organized in the way specified by the SysVInit (that is, System V Init, which
system startup mechanism. In this mechanism, the primary startup scripts for the system al
be a symbolic link to the /etc/rc.d/init.d directory on some systems). The specific scripts tha
boots into a specific numeric level of operation (known as a runlevel) are symbolic links from
form /etc/rcrunlevel.d to the scripts in the /etc/init.d directory. Ubuntu Linux systems use a d
configured to be compatible with the SysVInit process, and is explained in a subsequent sec
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server, you can do one of the following
• Download the sample SysVInit script that is provided with this tutorial.
• Copy an existing init script and modify it to execute the processes associated with your
installation.
The remainder of this section explains how to download and use the sample SysVInit script p
looks like Listing 1.

Listing 1. Sample SysVInit script
1 #!/bin/bash
2 #
Introduction
3 # Simple startup script for IBM WebSphere Application Server
4 #
Before
5 you start
# chkconfig: - 85 15
6 # description: IBM WebSphere Application Server is a powerful \
Web7 servers
# middleware platform for connecting Web-based applications and \
and architectures
8 # servers.
9
Installing
10 # WebSphere
Path to the Application
WebSphereServer
startup and shutdown scripts
11 startscript=/opt/IBM/WebSphere/AppServer/bin/startServer.sh
12 the
Using shutscript=/opt/IBM/WebSphere/AppServer/bin/stopServer.sh
First steps console
13 prog="the WebSphere Application Server"
14 RETVAL=0
Starting
15 and stopping WebSphere
Application
16 Server the following line as needed to reflect any custom Java
# modify
17 # installation directory
18 PATH=/opt/IBM/ibm-java-x86_64_60/bin:$PATH
Next
19 steps

20 # Function to start the server
Summary
21 start() {
22 echo -n $"Starting $prog: "
23 $startscript server1
Downloadable
24 resources
RETVAL=$?
25 echo
Related
26 topics
return $RETVAL
27 }
28
29 # Function to stop the server
30 stop() {
31 echo -n $"Stopping $prog: "
32 $shutscript server1 -username ADMINUSER -password PASSWORD
33 RETVAL=$?
34 echo
35 return $RETVAL
36 }
37
38 # See how we were called.
39 case "$1" in
40 start)
41 start
42 ;;
43 stop)
44 stop
45 ;;
46 restart)
47 stop
48 start
49 ;;
50 *)
51 echo $"Usage: $0 {start|stop|restart}"
52 exit 1
53 esac
54
55 exit $RETVAL
To download and install the sample SysVInit script, perform the following steps:
1. Download the sample script.

2. Save this file to your system and copy it to /etc/init.d as the root user (or by using the sud
such as websphere_sysvinit.sh.
Introduction
3. Edit this file using your favorite text editor, changing ADMINUSER and PASSWORD to the a
password
Before you startthat you defined during the installation process, and save those changes.
4. As
Web the root
servers and user or by using sudo, make the file executable using this command:
architectures
1 WebSphere
Installing chmod 755Application
/etc/init.d/websphere_sysvinit.sh
Server
5. Create
Starting andsymbolic links to this file from the directory associated with your system's default
stopping WebSphere
Application Server
directory for a graphical system or the /etc/rc3.d directory for a system that uses a text c
the following:
Next steps
1 ln -s /etc/init.d/websphere_sysvinit.sh /etc/rc5.d/S85ibm-was
Summary
2 ln -s /etc/init.d/websphere_sysvinit.sh /etc/rc5.d/K15ibm-was
Related topics
The next time you shut down your system, the K15ibm-was symbolic link that you created a
Application Server as part of the shutdown process. The next time you start your system, the
automatically starts WebSphere Application Server as part of the startup process.
Create an Ubuntu Upstart script
The Ubuntu Linux distribution uses an alternate startup mechanism to the SysVInit mechani
mechanism is known as Upstart and is a relatively new, event-driven startup mechanism tha
being adopted by other distributions such as Fedora and, therefore, eventually Red Hat and C
popular largely because of its support for concurrency and responsiveness to system events
At the moment, Upstart is implemented to be compatible with the traditional SysVInit mode
Upstart script that you can put in the /etc/init.d directory on your system and use for WebSp
script looks like Listing 2.
Listing 2. Sample Upstart script
1 #!/bin/bash -e
2 ### BEGIN INIT INFO
3 # Provides: ibm-websphere
4 # Required-Start: $local_fs $remote_fs $network $syslog
5 # Required-Stop: $local_fs $remote_fs $network $syslog
6 # Default-Start: 2 3 4 5
7 # Default-Stop: 0 1 6
8 # Short-Description: Start/stop IBM WebSphere Application Server
9 ### END INIT INFO
10 #
11 # IBM WAS This init.d script starts the IBM WebSphere
12 # Application Server.
13
14 # modify the following line as needed to reflect any custom Java
Introduction
15 # installation directory
16 ENV="env -i LANG=C PATH=/opt/IBM/ibm-java-x86_64_60/bin:/usr/bin:/bin"
Before
17 you start
18 set -e
19 if [ ! -d /opt/IBM/WebSphere/AppServer/bin ] ; then
20 echo "No IBM WebSphere Application Server installed"
21 exit 0
Installing
22 fiWebSphere Application Server
23
24 . /lib/lsb/init-functions
25
26 test -f /etc/default/rcS && . /etc/default/rcS
Starting
27 and stopping WebSphere
28 startscript=/opt/IBM/WebSphere/AppServer/bin/startServer.sh
Application Server
29 shutscript=/opt/IBM/WebSphere/AppServer/bin/stopServer.sh
30
Next
31 steps
case $1 in
32 start)
33
Summary log_daemon_msg "Starting application server" "IBM WAS"
34 if $startscript ; then
35 log_end_msg 0
Downloadable
36 resources
else
37 log_end_msg 1
Related fi
38 topics
39 ;;
40 stop)
41 log_daemon_msg "Stopping application server" "IBM WAS"
42 if $stopscript -user was-admin -password PASSWORD; then
43 log_end_msg 0
44 else
45 log_end_msg 1
46 fi
47 restart)
48 log_daemon_msg "Restarting Web server" "IBM HTTP"
49 if ($stopscript -user was-admin -password PASSWORD && $startscript)
50 then
51 log_end_msg 0
52 else
53 log_end_msg 1
54 fi
55 ;;
56 *)
57 log_success_msg "Usage: /etc/init.d/websphere {start|stop|restart}"
58 exit 1
59 ;;
60 esac
After downloading this file, perform the following steps:
1. Save this file to your system and copy it to /etc/init.d as the root user (or by using the sud
such as websphere_upstart.sh.
2. As the root user or by using the sudo command, make the file executable by using this co
1 chmod 755 /etc/init.d/websphere_upstart.sh

3. Create symbolic links to this file from the directory associated with your system's default
Introduction
directory) by using the commands like the following:
Before you start
1 ln -s /etc/init.d/websphere_upstart.sh /etc/rc2.d/S91ibm-was
Web servers
2 lnand
-sarchitectures
/etc/init.d/websphere_upstart.sh /etc/rc2.d/K15ibm-was

The next time you shut down your system, the K15ibm-was symbolic link that you created a
Starting and stopping
Application WebSphere
Server as part of the shutdown process. The next time you start your system, the
Application Server
automatically starts WebSphere Application Server as part of the startup process.
Next steps
Next
Summary steps
Congratulations on installing WebSphere Application Server and integrating it into your syste
Related topics
processes. You're now ready to add your own applications, customize the server's configurat
integrating WebSphere applications is outside the scope of this tutorial. However, here's som
will find useful when working with WebSphere Application Server:
• To open the WebSphere Application Server Administrative console in a browser from the
visit the following URL:
1 https://localhost:9043/ibm/console
The screen shown in Figure 12 displays. Enter the administrative username and passwor
installation process and click Login or press Return to display the WebSphere Application
as shown in Figure 14.
• To re-execute the First steps console, use the following command:
1 cd /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/firststeps
2 ./firststeps.sh
Summary
An application server is the core of most three-tier enterprise Web installations. IBM WebSp
the most popular application servers in use today, supported by IBM and a huge ecosystem
Introduction
vendors. The ability to download and experiment with a trial version of WebSphere Applicati
install, test,
Before you and familiarize yourself with WebSphere Application Server in your environment
start
provides a robust, powerful, well-tested, and well-supported foundation for your enterprise
 PDF
Starting ofstopping
and this content
WebSphere
Application Server
 Sample SysVInit WebSphere startup file (websphere_sysvinit.sh | 2KB)
Next steps
 Sample Upstart WebSphere startup file (websphere_upstart.sh | 2KB)
Summary
Related topics
Related topics
WebSphere Application Server detailed system requirements
WebSphere Application Server Library
IBM Redbooks Domain on the WebSphere software platform
IBM HTTP Server for WebSphere Application Server Knowledge Center
Comments
Sign in or register to add and subscribe to comments.
Subscribe me to comment notifications
IBM Developer
About
Site Feedback & FAQ

Submit content
Report abuse
Third-party notice
Introduction
Follow us
Before you start

Select a language
English
中文
Application Server
⽇本語
Next steps
Русский
Summary(Brasil)
Português
Español
한글
Related topics
Code Patterns
Articles
Tutorials
Recipes
Open Source Projects
Videos
Newsletters
Events
Cities
Developer Answers
Contact
IntroductionPrivacy Terms of use Accessibility Feedback Cookie Preferences U
Before you start

Application Server
Next steps
Summary
Related topics

Install and Configure WebSphere Application Server On UNIX and Linux Systems

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Install and Configure WebSphere Application Server On UNIX and Linux Systems

Uploaded by

Copyright:

Available Formats

13/02/2019 Install and configure WebSphere Application Server on UNIX and Linux systems

IBM Developer Topics Community More open source at IBM

Web servers and architectures

Install and conﬁgure WebSphere A

Server on UNIX and Linux systems

Starting and stopping WebSphere

Before you start

About this tutorial

This tutorial provides:

• An overview and comparison of common WebSphere installation and deployment mecha

Using the First steps console

Web servers and architectures

IBM WebSphere Application Server overview

Deploying WebSphere Application Server

WebSphere Application Server is typically deployed in one of two basic ways:

• In a network deployment scenario, where clusters of application servers deliver advance

Installing WebSphere Application Server

Setting up unsupported Linux distributions

Starting and stopping WebSphere

1 export PATH DIRECTORY:$PATH

1 sudo mv /bin/sh /bin/sh.ORIG

Extracting ﬁles and beginning the installation

1 tar zxvf <em>/path/to/file</em>/was.cd.7000.trial.base.linux.ia32.tar.gz

Figure 1. Firefox Welcome page

IBM Developer Topics Community More open source at IBM

Before you start

Web servers and architectures

Installing WebSphere Application Server

Using the First steps console

Starting and stopping WebSphere

Starting the installer

Figure 2. WebSphere Application Server installer's welcome screen

IBM Developer Topics Community More open source at IBM

Starting and stopping WebSphere

Click Next to proceed with the installation process.

Selecting optional features for installation

Web servers and architectures

Installing WebSphere Application Server

Using the First steps console

Starting and stopping WebSphere

Optional software that you can install consists of the following:

• Non-English language support for WebSphere Application Server: Language catalogs t

IBM Developer Topics Community More open source at IBM

Next, the graphical

Starting and stopping WebSphere

Click Next to proceed with the installation process.

Specifying the WebSphere Application Server environment

Figure 6. Specifying the target server environment

IBM Developer Topics Community More open source at IBM

Before you start

Web servers and architectures

Installing WebSphere Application Server

Using the First steps console

Starting and stopping WebSphere

Click Next to proceed with the installation process.

Creating an administrative user

IBM Developer Topics Community More open source at IBM

Before you start

Web servers and architectures

Installing WebSphere Application Server

Using the First steps console

Starting and stopping WebSphere

Summary page and actual installation