au was on linux pdf
TRANSCRIPT
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 140
Install and configure WebSphere ApplicationServer on UNIX and Linux systems
UNIX and Linux are perfect platforms for WebSphere
Skill Level Intermediate
William von Hagen (wvhvonhagenorg)Systems Administrator Writer
WordSmiths
22 Dec 2008
Learn how application servers are used in modern enterprise environments and howto install IBMreg WebSpherereg Application Server on UNIXreg and Linuxreg systems toprovide the cornerstone of a robust well-supported enterprise Web environmentThis tutorial also explains how to integrate WebSphere Application Server into the
startup and shutdown processes on your UNIX and Linux servers and provides linksto many other resources that will help you get up and running quickly withWebSphere Application Server
Section 1 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 inenterprise computing today This tutorial begins with a general discussion ofmiddleware in todays Web architectures focusing on IBMs WebSphere family ofproducts and the different ways in which WebSphere Application Server can bedeployed The remainder of the tutorial provides detailed information about how toinstall and configure WebSphere Application Server integrate it into your systems
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 1 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 240
startup process and integrate it into your enterprise computing infrastructure Aftercompleting this tutorial you will understand how to install configure and deployWebSphere Application Server and its relationship with other applications andservers in a Web-based computing environment
Objectives
This tutorial provides
bull A review of common Web architectures and the role of application serversand middleware in todays enterprise Web architectures
bull A basic understanding of WebSphere Application Server
bull An overview and comparison of common WebSphere installation anddeployment mechanisms
bull Instructions for installing WebSphere Application Server on UNIX andLinux distributions
bull A basic overview of the initial configuration of the WebSphere ApplicationServer
bull Details on how to integrate WebSphere Application Server into thesystem startup and shutdown processes and how to start and stop theserver manually
PrerequisitesThis tutorial is written for beginning to intermediate-level systems administrators whomay never have installed or configured a Web application server and who may beunfamiliar with modern Web server architectures To complete the examples in thistutorial you should have a general familiarity with UNIX command-line shells andtext editors
System requirements
To run the examples in this tutorial you need administrative (root) privileges on aUNIX or Linux system on which no application server is currently installed Thesystem should have a minimum of 1GB of RAM
When installing WebSphere Application Server at least 31GB of disk space mustbe available on the system A minimum of 13GB must be permanently available inthe file system that contains the opt directory and 175GB more must be
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 2 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 340
temporarily available in the file system from which you install WebSphere ApplicationServer
If you are installing WebSphere Application Server on a Linux system not all Linuxdistributions include a version of the Javatrade Runtime Environment (JRE) that is
suitable for use by the installer and certain WebSphere Application Server functionsOn unsupported Linux distributions such as Ubuntu you should download and installthe IBM Java software development kit (SDK) and make some minor modificationsto your system before installing WebSphere Application Server See Setting upunsupported Linux distributions for instructions
If you choose to install the IBM Java SDK at least 450MB of additional disk spacemust be available on the system A minimum of 175MB must be permanentlyavailable in the file system that contains the opt directory and 275MB more must betemporarily available in the file system from which you install IBM Java SDK
Section 2 Web servers and architectures
Todays enterprise Web environments are much more sophisticated than the simplecontent-delivery model of a few years ago Evolving Web software technologies andincreasing connectivity between Web servers and other data resources continue torevolutionize what users can do from the Internet and the services that businessescan offer and use themselves over the Web
Modern Web architectures and middleware
Todays enterprise Web architectures use what are known as n-tier architecturesthat enable Web servers to connect to data sources beyond simple static content Toaccess remote data sources these n-tier Web architectures typically usemiddleware which is the term for software that connects other applications orservices The most powerful and flexible form of middleware is a Web application server such as IBM WebSphere Application Server that hosts the applicationprogram interfaces (APIs) required by enterprise Web applications These Web
applications implement the connectivity between applications and resources(business logic ) required by Web-based implementations of various business processes
In n-tier Web architectures an application server can be running on the samesystem on which a Web server is running or on another system The Web serveracts as an intermediary between Web clients and the application server just as theapplication server acts as an intermediary between application logic and remote data
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 3 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 440
requirements
IBM WebSphere Application Server overview
IBM WebSphere Application Server is a Java application server that is built usingopen standards such as Java Platform Enterprise Edition (Java EE) ExtensibleMarkup Language (XML) and Hypertext Transfer Protocol (HTTP)-based Webservices WebSphere Application Server is typically used in conjunction with otherIBM products such as IBM HTTP Server but can be used with most other Webservers including the standard Apache HTTP Server Microsoftreg Internet InformationServices (IIS) and the Sun Java System Web Server The IBM HTTP Serverincludes a WebSphere Application Server plug-in to simplify WebSphereconfiguration and administration
WebSphere Application Server provides a robust scalable environment for
enterprise Web applications Its architecture and the reuse and integrationopportunities provided by other WebSphere products minimize runtime memoryrequirements and deliver a secure standards-based infrastructure for Web-basedapplication development and deployment The wide range of existing WebSphereadd-on products supported development frameworks and its support for newstandards such as the Service Component Architecture (SCA) satisfy therequirements of todays enterprise applications while simplifying the developmentand integration of the new applications that will deliver tomorrows solutions SeeResources for a link to the WebSphere Application and transaction infrastructurepage which provides information about many of the WebSphere add-on productsthat are currently available
Both IBM WebSphere Application Server and IBM HTTP Server are supported onmany platforms including Linux IBM AIXreg HP-UX IBM i (i5OS i6OS OS400)IBM zOS Microsoft Windowsreg and Solaris See Supported platforms for moredetailed information about hardware and software requirements
See Resources for links to additional information on popular n-tier applicationservers
Supported platforms
This tutorial discusses installing and configuring IBM WebSphere Application Server70 Version 70 is available for and supported on the following operating systemsand associated hardware
bull AIX
bull HP-UX on IA64 and HP-UX PA-RISC
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 4 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 540
bull Linux (32 bit)
bull Linux for IBM itrade System ptrade and System ztrade
bull Sun Solaris on SPARC and x86-64
bull Microsoft Windows 2000 Windows Serverreg 2003 and MicrosoftWindows XP
WebSphere Application Server is officially supported on the Red Hat EnterpriseLinux versions 4 and 5 and SUSE Enterprise Server versions 9 and 10 Linuxdistributions but you should be able to install it cleanly on any Linux distribution TheSetting up unsupported Linux distributions section provides tips to enable you toinstall and run WebSphere Application Server on Linux distributions other than thosethat are officially supported
Note You can run the 32-bit Intelreg architecture versions of WebSphere Application
Server and HTTP Server on a 64-bit UNIX system as long as you have installed yourUNIX systems 32-bit compatibility libraries on that system The name of thispackage and the package management system used for its installation differs onvarious UNIX systems On Linux systems this is the ia32-libs package
Deploying WebSphere Application Server
WebSphere Application Server is typically deployed in one of two basic ways
bull As stand-alone application servers that support specific business logic
and related applications in single-server environments
bull In a network deployment scenario where clusters of application serversdeliver advanced capabilities for high-performance high-availabilityenvironments (See Resources for more information)
As your business requirements and information technology (IT) infrastructure growa stand-alone WebSphere Application Server installation can be integrated into theclusters created in a network deployment scenario
This tutorial focuses on installing a stand-alone application server because of thesite-specific nature of network deployments
Section 3 Installing WebSphere Application Server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 5 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 640
Thanks to its graphical installer installing WebSphere Application Server is quitesimple
Getting the installation files
If you want to evaluate WebSphere Application Server on a specific UNIX systemyou can request a copy for evaluation purposes from IBM Contact your IBM salesrepresentative for more information
A trial version of WebSphere Application Server for Linux systems is available as adownload or on the Linux Software Evaluation Kit (SEK) a set of four DVDscontaining evaluation products from IBM WebSphere IBM InformationManagementreg Lotusreg Rationalreg and Tivolireg that enable you to install andconfigure IBM middleware and start building and deploying applications Thesoftware 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 downloadedfile If you are installing WebSphere Application Server from the Linux SEK DVDsthe archive file containing the installable files for WebSphere Application Server arelocated on DVD 3 of the set The instructions for extracting the contents of thearchive file on your DVD are the same as those for extracting installable files from adownloaded file
Setting up unsupported Linux distributions
The Supported platforms section of this tutorial includes a list of the UNIX and Linuxplatforms on which WebSphere Application Server is officially supported Ascommercial products UNIX systems provide standard capabilities that can beguaranteed to be present for use by commercial products such as WebSphereApplication Server Unfortunately Linux distributions can be very different from eachother so WebSphere Application Server is only officially supported on certaindistributions However you can also run WebSphere Application Server on otherLinux 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 filesand beginning the installation section of this tutorial
For example not all Linux distributions include a version of the JRE that is suitablefor use by the WebSphere Application Server installer and certain WebSphereApplication Server functions On unsupported Linux distributions such as Ubuntuyou should download and install the IBM Java SDK for use during the installation
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 6 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 740
process See Resources for a link from which you can download the appropriateversion of the IBM Java SDK for your system After downloading this file you canextract its contents and install them using the following steps
1 Extract the contents of the archive file using a command like the following
tar zxvf filenametargz
Replace filename with the name of the IBM Java SDK archive file that youdownloaded which will be something likeibm-java-sdk-60-20-linux-x86_64targz The directory that is created bythe tar command will be something like ibm-java-x86_64-60
2 Use the sudo command to move the directory that was extracted from the
archive file to a system directory such as opt by using a command likethe following
mv DIRECTORY opt
Replace DIRECTORY with the name of the directory that was createdwhen you extracted the contents of the IBM Java SDK archive file thatyou downloaded
3 Modify the series of directories that your system searches for binaries byexecuting a command like the following
export PATH DIRECTORY$PATH
You should add this command to your shell startup file (~bashrc) toensure 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 thegeneric UNIXLinux shell binsh Ubuntu systems use a lightweight shell named
bindash as binsh but this shell does not provide all the capabilities required bythe WebSphere Application Server installation and startup scripts To use thestandard Bash shell as binsh execute the following commands on your Ubuntusystem before beginning the WebSphere Application Server installation process
sudo mv binsh binshORIGsudo ln -s binbash binsh
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 7 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 840
These steps are sufficient to enable you to begin the WebSphere Application Serverinstallation process on an Ubuntu system Other Linux distributions may requiresimilar changes
Extracting files and beginning the installation
After downloading or otherwise obtaining the archive file containing WebSphereApplication Server or mounting the Linux SEK DVD 3 when using a Linux systemcreate a directory in which to extract the files from which you can actually installWebSphere Application Server See Basic tasks for Linux Developers if you areunsure about how to mount your DVD or determine where it is mounted
The optWASTrial directory is the suggested location for extracting the files fromwhich you will install WebSphere Application Server To create this directory do the
following
1 Depending on the UNIX operating system or Linux distribution that isinstalled on the system where you are installing WebSphere ApplicationServer use the su or sudo -s commands to become a privileged useron your system Enter the root password or your password (respectively)when prompted to do so
2 Create the optWASTrial directory using the mkdir optWASTrial
command
3 Change directory to the optWASTrial directory
4 Use the tar command to extract the contents of the file that youdownloaded or the WebSphere Application Server archive file from themounted DVDIf you downloaded the file use a command like the following
tar zxvf pathtofilewascd7000trialbaselinuxia32targz
Replace pathtofile 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 acommand like the following
tar zxvf mountpointwas7uxtfilenametargz
Replace mountpoint with the name of the directory on which SEK DVD
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 8 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 940
3 is mounted and replace filename with the name of the WebSphereApplication Server archive file in that directory You may also have toreplace was7uxt with the name of the directory containing the Linuxarchive file if a different directory name was used in the latest SEK DVDreleases
5 Use the launchpadsh command to start the Firefox Web browserwhich displays the page shown in Figure 1Figure 1 Firefox Welcome page
Note If you are using Linux for your evaluation no 64-bit Linux version seems to beavailable for download See Supported platforms for information about how to usethe 32-bit Linux build on a 64-bit Linux system
Starting the installer
Click Launch the installation wizard for WebSphere Application Server Trial tobegin the actual installation process The graphical installer for WebSphereApplication Server begins and displays its welcome screen as shown in Figure 2
Figure 2 WebSphere Application Server installers welcome screen
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 9 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1040
The welcome screen shows that the graphical installer is working correctly andprovides links to online sites that provide information and support for WebSphereand related products
Click Next to proceed with the installation process
Accepting the license terms and checking your system
The next page of the graphical installer displays the license under which WebSphereApplication Server is released as shown in Figure 3
Figure 3 Accepting the IBM software license agreement
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 10 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1140
This license contains IBM licensing information for the evaluation version ofWebSphere Application Server and language that excludes open source softwarethat is distributed with IBM WebSphere Application Server from those terms andidentifies separately licensed software components
Select I accept the terms in the licensing agreement to accept the licensingterms Click Next to proceed with the installation process If you dont accept thelicense terms a window displays asking you to confirm that fact If you confirm thatyou do not accept the license terms the installer exits
The next page of the installer indicates whether your system satisfies theprerequisites for installation If your system does not satisfy requirements theinstaller may display information about any missing patches that you should installIn this case you can either click Cancel to exit the installer and install the missingprerequisites or simply proceed with the installation
Click Next to proceed with the installation process
Selecting optional features for installation
Figure 4 shows the installer screen that enables you to install optional software whileyou install WebSphere Application Server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 11 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1240
Figure 4 Selecting optional software for installation
Optional software that you can install consists of the following
bull Sample applications Source code and integrated applications for initial
experimentation The sample applications also serve as an excellentmechanism for verifying that WebSphere Application Server is installedcorrectly and is working properly on your system
bull Non-English language support for the administrative consoleLanguage catalogs that provide national language support for WebSphereApplication Servers administrative console These language catalogs donot provide national language support for WebSphere Application Serveritself which is available in a separate item on this screen
bull Non-English language support for WebSphere Application ServerLanguage catalogs that provide national language support for WebSphereApplication Server itself These language catalogs do not provide nationallanguage support for WebSphere Application Servers administrativeconsole which is available in a separate item on this screen
Unless you already have substantial experience with WebSphere Application Serveryou should install the sample applications to provide a way for you to learn moreabout application integration and deployment in the WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 12 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1340
environment
The default language package installed with WebSphere is English as spoken in theUnited States Whether or not you install the optional language packages dependson your geographic location and language support requirements The additional
languages that are supported by the administrative console and WebSphereApplication Server language support packs are Chinese Czech French GermanHungarian Italian Japanese Korean Polish Portuguese Russian and Spanish
After selecting any additional features that you want to install click Next to proceedwith the installation process
Identifying the target installation directory
Next the graphical installer displays the default location in which WebSphereApplication Server will be installed which is optIBMWebSphereAppServer onUNIX 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 installingWebSphere Application Server in non-standard locations can make local systemadministration more complex Non-standard installation locations may also cause
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 13 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1440
problems with WebSphere applications that may expect the standard installationlocation
Click Next to proceed with the installation process
Specifying the WebSphere Application Server environment
The screen shown in Figure 6 enables you to identify the type of WebSphereApplication 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 youare installing and integrating WebSphere Application Server The environment thatyou 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 choicesare the following
bull Management Select this option if you are installing this copy ofWebSphere Application Server to manage other application serverenvironments on the local machine or on other systems on your networkSelecting this option creates an appropriate profile and will install and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 14 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1540
configure an administrative agent server services for managing multipleapplication server environments and an administrative agent to manageother application servers that are on the same machine
bull Application server The default selection this option creates anappropriate profile for installing a stand-alone application server that will
run your enterprise applications and which can only be managed from itsown administrative console
bull None Select this option if you do not want to create an execution profileduring installation Only select this option if you will explicitly create one ormore profiles after WebSphere Application Server is successfully installedon your system
Click Next to proceed with the installation process
Note If you select None as your server execution environment a warning dialogdisplays to inform you that at least one functional profile must be available to runWebSphere Application Server Click Yes to proceed with the installation processwithout creating a profile during the installation process and proceed to Summarypage and actual installation If you want to create a profile during the installationprocess click No to return to the dialog shown in Figure 6 to modify your serverexecution environment setting
Creating an administrative user
The next screen of the installer shown in Figure 7 enables you to create a secureaccount on your system for system administration through the WebSphereApplication Server administrative console
Figure 7 Defining an administrative user
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 15 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1640
Create an administrative user if you are installing a stand-alone or managedWebSphere Application Servermdashin other words when you are installing WebSphereApplication Server in an environment that creates a profile for you during theinstallation process as described earlier in Specifying the WebSphere Application
Server environment
Enter a username and password for use in administering your WebSphereApplication Server and enter the password again to confirm that you typed itcorrectly the first time
If you selected the sample applications for installation in the Selecting optionalfeatures for installation section you will also be prompted to set a password for theuser associated with those sample applications Enter the password twice to ensurethat you have typed it correctly or have at least made the same typo twice
After supplying information about the administrative user (and optionally apassword for the sample applications if you selected them for installation) click Nextto proceed with the installation process
Summary page and actual installation
As shown in Figure 8 a summary screen displays the configuration options that you
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 16 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1740
have accepted or specified and provides a check box that enables you to verify thatyou 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 theresreally no need to verify that you have the required privileges Clear this check boxand click Next to begin the installation process A window displays showing thestatus of the installation process The installation process first creates an uninstallerfor WebSphere Application Server to simplify removing the software if necessary Itthen installs WebSphere Application Server displaying status information as theinstallation proceeds
Installation status and next steps
When the installation finishes the window shown in Figure 9 displays the success orfailure of installation If any errors occur this window shows the location of a log filethat you can examine to identify the problems and determine whether they weremeaningful
Figure 9 Summary information about your installation
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 17 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1840
This screen provides a check box that because it is selected by default starts theWebSphere Application Server First steps console when you exit the installer TheFirst steps console enables you to do some initial configuration of WebSphereApplication Server
At this point you have two options
bull Leave the Launch the First steps console check box selected and clickFinish to exit the installer and start the First steps console
bull Clear the Launch the First steps console check box and click Finish toexit the installer without starting the First steps console or WebSphereApplication Server
Congratulations Youve installed WebSphere Application Server If you started theFirst steps console proceed to the next section for information about using thatconsole Otherwise you may want to do one of the following
bull Start the WebSphere Application Server manually
bull Integrate WebSphere Application Server with your systems Web server
bull Integrate WebSphere Application Server into your systems startup and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 18 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1940
shutdown processes
bull Access the WebSphere administrative console to begin configuring yourWebSphere Application Server
Section 4 Using the First steps console
The WebSphere Application Server installation process can automatically start aFirst steps console to help you familiarize yourself with WebSphere ApplicationServer and perform some initial configuration tasks Figure 10 shows the initialscreen of the First steps console
Figure 10 First steps console
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 19 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2040
As shown in Figure 10 the First steps console provides links to a number ofconvenient tasks that you may want to perform immediately after installationincluding
bull Installation verification Checks your WebSphere Application Server
installation to verify that it is installed correctly and starts the applicationserver as part of this check
bull Start the Server Starts the WebSphere Application Server displayingthe output of the startup process in a separate window for convenienceand diagnostic purposes When the application server is running this linkchanges to a Stop the server link which provides a convenient way tostop the server and displays the output of the server shutdown process ina separate window Stopping the server requires the administrativepassword that you set during the installation process and provides aconvenient check that the application servers internal authentication
mechanism is working correctlybull Administrative console Starts the WebSphere Administrative console
in a browser window enabling you to perform configuration tasks that areoutside the scope of the installation process Starting the administrativeconsole also requires the administrative password that you set during theinstallation process
bull Profile management tool Enables you to create additional executionprofiles each of which can be for use with specific enterprise Webapplications port configurations and so on If you did not specify a targetserver environment during the installation process and are not migrating
server configuration information from an existing WebSphere ApplicationServer installation use this option to create at least one WebSphereApplication Server profile You cannot start WebSphere ApplicationServer without at least one profilemdasheach profile provides the configurationinformation required to start the application server in a specific context
bull Samples gallery Provides access to the sample applications youinstalled during the installation process
bull Information center for WebSphere Application Server Opens theWebSphere Application Server Library Web site in a browser to providedetailed information about WebSphere Application Server in a variety of
enterprise application scenarios
bull Migration wizard Starts a wizard that simplifies migrating configurationinformation and applications from earlier versions of WebSphereApplication Server
The next few sections provide highlights of using selected options from the Firststeps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 20 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2140
Installation verification
Though error messages would have displayed had any problems occurred duringthe WebSphere Application Server installation process its always comforting to be
able to double-check that your application server installation is complete and that allthe necessary configuration files were created correctly during that process
To verify that WebSphere Application Server was installed correctly on your systemand start it as part of the testing process click the Installation verification link inthe First steps console A window like the one shown in Figure 11 displays
Figure 11 Output of the verification process
As you can see from this figure the verification process first starts the applicationserver with your default profile and then connects to the application server to verifythe Servlet engine JavaServer pages and enterprise bean configuration It thenexamines the authentication of the key stores that are used to provide secureconnections between WebSphere components
When the verification process completes you can click the close button in the upperright-hand corner of the output window to close that window and return to the Firststeps console Note that the Start the server link has been replaced by a Stop the
server link because the WebSphere Application Server was started as part of theverification process
Starting the server
If you choose not to verify your WebSphere Application Server installation as
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 21 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2240
described in the previous section you can start the WebSphere Application Servermanually by clicking the Start the server link in the First steps console Clicking thislink displays an output window much like the one shown in Figure 11 except that itonly shows the initial text about starting the server and does not probe theconfiguration of your server
Note If the First steps console does not show a Start the server link but insteaddisplays only a Stop the server link your WebSphere Application Server is alreadyrunning
After a line like ADMU3000I Server NAME open for e-business
displays in the output window you can click the close box in the upper right-handcorner of the output window to close that window and return to the First stepsconsole
Administrative consoleThe WebSphere Application Server Administrative console is the primarymechanism for configuring the application server integrating the application serverwith external applications such as database systems and installing WebSphereapplications If you are new to WebSphere Application Server and want to explorethe administrative console or want to install new WebSphere applicationsimmediately after installing WebSphere you may want to start the Administrativeconsole from the First steps console
Click Administrative console to start the WebSphere Administrative console fromthe First steps console The login screen for the Administrative console opens in abrowser window as shown in Figure 12
Figure 12 Administrative console login screen
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 22 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2340
The Administrative console requires a Secure Sockets Layer (SSL) HTTPconnection generally referred to as a Hypertext Transfer Protocol over SecureSockets Layer (HTTPS) connection The page shown in Figure 12 only displays if avalid third-party SSL certificate is installed on your system If the system on whichyou installed WebSphere Application Server does not have a valid certificate issuedby a third party you will see a warning dialog like that shown in Figure 13 instead
Figure 13 Certificate not trusted alert
If you see this message see the next section of this tutorial for information about
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 23 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2440
configuring a security exception for your systems existing certificate
If you see the Administrative console login screen as shown in Figure 12 enter theadministrative username and password that you defined during the installationprocess and click Login or press Return The WebSphere Application Server
Administrative console displays as shown in Figure 14 You can explore or use theAdministrative console clicking the Logout link in the header when you are done
Figure 14 Administrative console
Configuring a certificate security exception
As discussed in the previous section the WebSphere Application ServerAdministrative console requires an SSL HTTP connection generally referred to asan HTTPS connection According to the default security policies used by mostsystems this means that the public key security certificate presented by your systemmust be a valid certificate issued by a trusted third-party certificate authority such asthawte VeriSign GeoTrust and many others See Resources for more informationabout these third-party certificate authorities
In a production environment you will certainly only want to use WebSphere
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 24 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2540
Application Server on a system with a valid enterprise or third-party securitycertificate so that users of your Web applications can verify the identity of the systemthat they are connecting to However you may be installing and configuringWebSphere Application Server on a new system for which you have not yet obtaineda certificate In this case you can temporarily or permanently define your existing
certificate as a trusted one that is an exception to the standard WebSphere securitypolicy
To define a policy exception click OK in the dialog shown in Figure 13 to display thescreen shown in Figure 15
Figure 15 A secure connection failure in Firefox
Click the Or you can define an exception link to begin the process of identifyingyour systems certificate as a valid digital public key certificate A screen identical to
the current screen displays with the exception of two additional buttons that displayat the bottom of the screen Click Add exception to continue the process of definingthe current certificate as an exception to the default certificate policy The dialogshown in Figure 16 displays
Note Clicking the Get me out of here button exits the exception definition processand returns you to your browser without establishing a connection to the WebSphere
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 25 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2640
Administrative console which isnt all that useful for the purposes of this tutorial
Figure 16 Initial dialog for defining a security exception
Click Get Certificate to retrieve your systems current certificate which displaysinformation about the current certificate and enables the Confirm Security
Exception button at the bottom left of the dialog shown in Figure 16 as shown inFigure 17
Figure 17 Updated dialog for defining a security exception
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 26 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 240
startup process and integrate it into your enterprise computing infrastructure Aftercompleting this tutorial you will understand how to install configure and deployWebSphere Application Server and its relationship with other applications andservers in a Web-based computing environment
Objectives
This tutorial provides
bull A review of common Web architectures and the role of application serversand middleware in todays enterprise Web architectures
bull A basic understanding of WebSphere Application Server
bull An overview and comparison of common WebSphere installation anddeployment mechanisms
bull Instructions for installing WebSphere Application Server on UNIX andLinux distributions
bull A basic overview of the initial configuration of the WebSphere ApplicationServer
bull Details on how to integrate WebSphere Application Server into thesystem startup and shutdown processes and how to start and stop theserver manually
PrerequisitesThis tutorial is written for beginning to intermediate-level systems administrators whomay never have installed or configured a Web application server and who may beunfamiliar with modern Web server architectures To complete the examples in thistutorial you should have a general familiarity with UNIX command-line shells andtext editors
System requirements
To run the examples in this tutorial you need administrative (root) privileges on aUNIX or Linux system on which no application server is currently installed Thesystem should have a minimum of 1GB of RAM
When installing WebSphere Application Server at least 31GB of disk space mustbe available on the system A minimum of 13GB must be permanently available inthe file system that contains the opt directory and 175GB more must be
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 2 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 340
temporarily available in the file system from which you install WebSphere ApplicationServer
If you are installing WebSphere Application Server on a Linux system not all Linuxdistributions include a version of the Javatrade Runtime Environment (JRE) that is
suitable for use by the installer and certain WebSphere Application Server functionsOn unsupported Linux distributions such as Ubuntu you should download and installthe IBM Java software development kit (SDK) and make some minor modificationsto your system before installing WebSphere Application Server See Setting upunsupported Linux distributions for instructions
If you choose to install the IBM Java SDK at least 450MB of additional disk spacemust be available on the system A minimum of 175MB must be permanentlyavailable in the file system that contains the opt directory and 275MB more must betemporarily available in the file system from which you install IBM Java SDK
Section 2 Web servers and architectures
Todays enterprise Web environments are much more sophisticated than the simplecontent-delivery model of a few years ago Evolving Web software technologies andincreasing connectivity between Web servers and other data resources continue torevolutionize what users can do from the Internet and the services that businessescan offer and use themselves over the Web
Modern Web architectures and middleware
Todays enterprise Web architectures use what are known as n-tier architecturesthat enable Web servers to connect to data sources beyond simple static content Toaccess remote data sources these n-tier Web architectures typically usemiddleware which is the term for software that connects other applications orservices The most powerful and flexible form of middleware is a Web application server such as IBM WebSphere Application Server that hosts the applicationprogram interfaces (APIs) required by enterprise Web applications These Web
applications implement the connectivity between applications and resources(business logic ) required by Web-based implementations of various business processes
In n-tier Web architectures an application server can be running on the samesystem on which a Web server is running or on another system The Web serveracts as an intermediary between Web clients and the application server just as theapplication server acts as an intermediary between application logic and remote data
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 3 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 440
requirements
IBM WebSphere Application Server overview
IBM WebSphere Application Server is a Java application server that is built usingopen standards such as Java Platform Enterprise Edition (Java EE) ExtensibleMarkup Language (XML) and Hypertext Transfer Protocol (HTTP)-based Webservices WebSphere Application Server is typically used in conjunction with otherIBM products such as IBM HTTP Server but can be used with most other Webservers including the standard Apache HTTP Server Microsoftreg Internet InformationServices (IIS) and the Sun Java System Web Server The IBM HTTP Serverincludes a WebSphere Application Server plug-in to simplify WebSphereconfiguration and administration
WebSphere Application Server provides a robust scalable environment for
enterprise Web applications Its architecture and the reuse and integrationopportunities provided by other WebSphere products minimize runtime memoryrequirements and deliver a secure standards-based infrastructure for Web-basedapplication development and deployment The wide range of existing WebSphereadd-on products supported development frameworks and its support for newstandards such as the Service Component Architecture (SCA) satisfy therequirements of todays enterprise applications while simplifying the developmentand integration of the new applications that will deliver tomorrows solutions SeeResources for a link to the WebSphere Application and transaction infrastructurepage which provides information about many of the WebSphere add-on productsthat are currently available
Both IBM WebSphere Application Server and IBM HTTP Server are supported onmany platforms including Linux IBM AIXreg HP-UX IBM i (i5OS i6OS OS400)IBM zOS Microsoft Windowsreg and Solaris See Supported platforms for moredetailed information about hardware and software requirements
See Resources for links to additional information on popular n-tier applicationservers
Supported platforms
This tutorial discusses installing and configuring IBM WebSphere Application Server70 Version 70 is available for and supported on the following operating systemsand associated hardware
bull AIX
bull HP-UX on IA64 and HP-UX PA-RISC
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 4 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 540
bull Linux (32 bit)
bull Linux for IBM itrade System ptrade and System ztrade
bull Sun Solaris on SPARC and x86-64
bull Microsoft Windows 2000 Windows Serverreg 2003 and MicrosoftWindows XP
WebSphere Application Server is officially supported on the Red Hat EnterpriseLinux versions 4 and 5 and SUSE Enterprise Server versions 9 and 10 Linuxdistributions but you should be able to install it cleanly on any Linux distribution TheSetting up unsupported Linux distributions section provides tips to enable you toinstall and run WebSphere Application Server on Linux distributions other than thosethat are officially supported
Note You can run the 32-bit Intelreg architecture versions of WebSphere Application
Server and HTTP Server on a 64-bit UNIX system as long as you have installed yourUNIX systems 32-bit compatibility libraries on that system The name of thispackage and the package management system used for its installation differs onvarious UNIX systems On Linux systems this is the ia32-libs package
Deploying WebSphere Application Server
WebSphere Application Server is typically deployed in one of two basic ways
bull As stand-alone application servers that support specific business logic
and related applications in single-server environments
bull In a network deployment scenario where clusters of application serversdeliver advanced capabilities for high-performance high-availabilityenvironments (See Resources for more information)
As your business requirements and information technology (IT) infrastructure growa stand-alone WebSphere Application Server installation can be integrated into theclusters created in a network deployment scenario
This tutorial focuses on installing a stand-alone application server because of thesite-specific nature of network deployments
Section 3 Installing WebSphere Application Server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 5 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 640
Thanks to its graphical installer installing WebSphere Application Server is quitesimple
Getting the installation files
If you want to evaluate WebSphere Application Server on a specific UNIX systemyou can request a copy for evaluation purposes from IBM Contact your IBM salesrepresentative for more information
A trial version of WebSphere Application Server for Linux systems is available as adownload or on the Linux Software Evaluation Kit (SEK) a set of four DVDscontaining evaluation products from IBM WebSphere IBM InformationManagementreg Lotusreg Rationalreg and Tivolireg that enable you to install andconfigure IBM middleware and start building and deploying applications Thesoftware 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 downloadedfile If you are installing WebSphere Application Server from the Linux SEK DVDsthe archive file containing the installable files for WebSphere Application Server arelocated on DVD 3 of the set The instructions for extracting the contents of thearchive file on your DVD are the same as those for extracting installable files from adownloaded file
Setting up unsupported Linux distributions
The Supported platforms section of this tutorial includes a list of the UNIX and Linuxplatforms on which WebSphere Application Server is officially supported Ascommercial products UNIX systems provide standard capabilities that can beguaranteed to be present for use by commercial products such as WebSphereApplication Server Unfortunately Linux distributions can be very different from eachother so WebSphere Application Server is only officially supported on certaindistributions However you can also run WebSphere Application Server on otherLinux 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 filesand beginning the installation section of this tutorial
For example not all Linux distributions include a version of the JRE that is suitablefor use by the WebSphere Application Server installer and certain WebSphereApplication Server functions On unsupported Linux distributions such as Ubuntuyou should download and install the IBM Java SDK for use during the installation
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 6 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 740
process See Resources for a link from which you can download the appropriateversion of the IBM Java SDK for your system After downloading this file you canextract its contents and install them using the following steps
1 Extract the contents of the archive file using a command like the following
tar zxvf filenametargz
Replace filename with the name of the IBM Java SDK archive file that youdownloaded which will be something likeibm-java-sdk-60-20-linux-x86_64targz The directory that is created bythe tar command will be something like ibm-java-x86_64-60
2 Use the sudo command to move the directory that was extracted from the
archive file to a system directory such as opt by using a command likethe following
mv DIRECTORY opt
Replace DIRECTORY with the name of the directory that was createdwhen you extracted the contents of the IBM Java SDK archive file thatyou downloaded
3 Modify the series of directories that your system searches for binaries byexecuting a command like the following
export PATH DIRECTORY$PATH
You should add this command to your shell startup file (~bashrc) toensure 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 thegeneric UNIXLinux shell binsh Ubuntu systems use a lightweight shell named
bindash as binsh but this shell does not provide all the capabilities required bythe WebSphere Application Server installation and startup scripts To use thestandard Bash shell as binsh execute the following commands on your Ubuntusystem before beginning the WebSphere Application Server installation process
sudo mv binsh binshORIGsudo ln -s binbash binsh
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 7 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 840
These steps are sufficient to enable you to begin the WebSphere Application Serverinstallation process on an Ubuntu system Other Linux distributions may requiresimilar changes
Extracting files and beginning the installation
After downloading or otherwise obtaining the archive file containing WebSphereApplication Server or mounting the Linux SEK DVD 3 when using a Linux systemcreate a directory in which to extract the files from which you can actually installWebSphere Application Server See Basic tasks for Linux Developers if you areunsure about how to mount your DVD or determine where it is mounted
The optWASTrial directory is the suggested location for extracting the files fromwhich you will install WebSphere Application Server To create this directory do the
following
1 Depending on the UNIX operating system or Linux distribution that isinstalled on the system where you are installing WebSphere ApplicationServer use the su or sudo -s commands to become a privileged useron your system Enter the root password or your password (respectively)when prompted to do so
2 Create the optWASTrial directory using the mkdir optWASTrial
command
3 Change directory to the optWASTrial directory
4 Use the tar command to extract the contents of the file that youdownloaded or the WebSphere Application Server archive file from themounted DVDIf you downloaded the file use a command like the following
tar zxvf pathtofilewascd7000trialbaselinuxia32targz
Replace pathtofile 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 acommand like the following
tar zxvf mountpointwas7uxtfilenametargz
Replace mountpoint with the name of the directory on which SEK DVD
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 8 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 940
3 is mounted and replace filename with the name of the WebSphereApplication Server archive file in that directory You may also have toreplace was7uxt with the name of the directory containing the Linuxarchive file if a different directory name was used in the latest SEK DVDreleases
5 Use the launchpadsh command to start the Firefox Web browserwhich displays the page shown in Figure 1Figure 1 Firefox Welcome page
Note If you are using Linux for your evaluation no 64-bit Linux version seems to beavailable for download See Supported platforms for information about how to usethe 32-bit Linux build on a 64-bit Linux system
Starting the installer
Click Launch the installation wizard for WebSphere Application Server Trial tobegin the actual installation process The graphical installer for WebSphereApplication Server begins and displays its welcome screen as shown in Figure 2
Figure 2 WebSphere Application Server installers welcome screen
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 9 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1040
The welcome screen shows that the graphical installer is working correctly andprovides links to online sites that provide information and support for WebSphereand related products
Click Next to proceed with the installation process
Accepting the license terms and checking your system
The next page of the graphical installer displays the license under which WebSphereApplication Server is released as shown in Figure 3
Figure 3 Accepting the IBM software license agreement
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 10 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1140
This license contains IBM licensing information for the evaluation version ofWebSphere Application Server and language that excludes open source softwarethat is distributed with IBM WebSphere Application Server from those terms andidentifies separately licensed software components
Select I accept the terms in the licensing agreement to accept the licensingterms Click Next to proceed with the installation process If you dont accept thelicense terms a window displays asking you to confirm that fact If you confirm thatyou do not accept the license terms the installer exits
The next page of the installer indicates whether your system satisfies theprerequisites for installation If your system does not satisfy requirements theinstaller may display information about any missing patches that you should installIn this case you can either click Cancel to exit the installer and install the missingprerequisites or simply proceed with the installation
Click Next to proceed with the installation process
Selecting optional features for installation
Figure 4 shows the installer screen that enables you to install optional software whileyou install WebSphere Application Server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 11 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1240
Figure 4 Selecting optional software for installation
Optional software that you can install consists of the following
bull Sample applications Source code and integrated applications for initial
experimentation The sample applications also serve as an excellentmechanism for verifying that WebSphere Application Server is installedcorrectly and is working properly on your system
bull Non-English language support for the administrative consoleLanguage catalogs that provide national language support for WebSphereApplication Servers administrative console These language catalogs donot provide national language support for WebSphere Application Serveritself which is available in a separate item on this screen
bull Non-English language support for WebSphere Application ServerLanguage catalogs that provide national language support for WebSphereApplication Server itself These language catalogs do not provide nationallanguage support for WebSphere Application Servers administrativeconsole which is available in a separate item on this screen
Unless you already have substantial experience with WebSphere Application Serveryou should install the sample applications to provide a way for you to learn moreabout application integration and deployment in the WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 12 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1340
environment
The default language package installed with WebSphere is English as spoken in theUnited States Whether or not you install the optional language packages dependson your geographic location and language support requirements The additional
languages that are supported by the administrative console and WebSphereApplication Server language support packs are Chinese Czech French GermanHungarian Italian Japanese Korean Polish Portuguese Russian and Spanish
After selecting any additional features that you want to install click Next to proceedwith the installation process
Identifying the target installation directory
Next the graphical installer displays the default location in which WebSphereApplication Server will be installed which is optIBMWebSphereAppServer onUNIX 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 installingWebSphere Application Server in non-standard locations can make local systemadministration more complex Non-standard installation locations may also cause
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 13 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1440
problems with WebSphere applications that may expect the standard installationlocation
Click Next to proceed with the installation process
Specifying the WebSphere Application Server environment
The screen shown in Figure 6 enables you to identify the type of WebSphereApplication 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 youare installing and integrating WebSphere Application Server The environment thatyou 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 choicesare the following
bull Management Select this option if you are installing this copy ofWebSphere Application Server to manage other application serverenvironments on the local machine or on other systems on your networkSelecting this option creates an appropriate profile and will install and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 14 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1540
configure an administrative agent server services for managing multipleapplication server environments and an administrative agent to manageother application servers that are on the same machine
bull Application server The default selection this option creates anappropriate profile for installing a stand-alone application server that will
run your enterprise applications and which can only be managed from itsown administrative console
bull None Select this option if you do not want to create an execution profileduring installation Only select this option if you will explicitly create one ormore profiles after WebSphere Application Server is successfully installedon your system
Click Next to proceed with the installation process
Note If you select None as your server execution environment a warning dialogdisplays to inform you that at least one functional profile must be available to runWebSphere Application Server Click Yes to proceed with the installation processwithout creating a profile during the installation process and proceed to Summarypage and actual installation If you want to create a profile during the installationprocess click No to return to the dialog shown in Figure 6 to modify your serverexecution environment setting
Creating an administrative user
The next screen of the installer shown in Figure 7 enables you to create a secureaccount on your system for system administration through the WebSphereApplication Server administrative console
Figure 7 Defining an administrative user
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 15 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1640
Create an administrative user if you are installing a stand-alone or managedWebSphere Application Servermdashin other words when you are installing WebSphereApplication Server in an environment that creates a profile for you during theinstallation process as described earlier in Specifying the WebSphere Application
Server environment
Enter a username and password for use in administering your WebSphereApplication Server and enter the password again to confirm that you typed itcorrectly the first time
If you selected the sample applications for installation in the Selecting optionalfeatures for installation section you will also be prompted to set a password for theuser associated with those sample applications Enter the password twice to ensurethat you have typed it correctly or have at least made the same typo twice
After supplying information about the administrative user (and optionally apassword for the sample applications if you selected them for installation) click Nextto proceed with the installation process
Summary page and actual installation
As shown in Figure 8 a summary screen displays the configuration options that you
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 16 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1740
have accepted or specified and provides a check box that enables you to verify thatyou 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 theresreally no need to verify that you have the required privileges Clear this check boxand click Next to begin the installation process A window displays showing thestatus of the installation process The installation process first creates an uninstallerfor WebSphere Application Server to simplify removing the software if necessary Itthen installs WebSphere Application Server displaying status information as theinstallation proceeds
Installation status and next steps
When the installation finishes the window shown in Figure 9 displays the success orfailure of installation If any errors occur this window shows the location of a log filethat you can examine to identify the problems and determine whether they weremeaningful
Figure 9 Summary information about your installation
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 17 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1840
This screen provides a check box that because it is selected by default starts theWebSphere Application Server First steps console when you exit the installer TheFirst steps console enables you to do some initial configuration of WebSphereApplication Server
At this point you have two options
bull Leave the Launch the First steps console check box selected and clickFinish to exit the installer and start the First steps console
bull Clear the Launch the First steps console check box and click Finish toexit the installer without starting the First steps console or WebSphereApplication Server
Congratulations Youve installed WebSphere Application Server If you started theFirst steps console proceed to the next section for information about using thatconsole Otherwise you may want to do one of the following
bull Start the WebSphere Application Server manually
bull Integrate WebSphere Application Server with your systems Web server
bull Integrate WebSphere Application Server into your systems startup and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 18 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1940
shutdown processes
bull Access the WebSphere administrative console to begin configuring yourWebSphere Application Server
Section 4 Using the First steps console
The WebSphere Application Server installation process can automatically start aFirst steps console to help you familiarize yourself with WebSphere ApplicationServer and perform some initial configuration tasks Figure 10 shows the initialscreen of the First steps console
Figure 10 First steps console
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 19 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2040
As shown in Figure 10 the First steps console provides links to a number ofconvenient tasks that you may want to perform immediately after installationincluding
bull Installation verification Checks your WebSphere Application Server
installation to verify that it is installed correctly and starts the applicationserver as part of this check
bull Start the Server Starts the WebSphere Application Server displayingthe output of the startup process in a separate window for convenienceand diagnostic purposes When the application server is running this linkchanges to a Stop the server link which provides a convenient way tostop the server and displays the output of the server shutdown process ina separate window Stopping the server requires the administrativepassword that you set during the installation process and provides aconvenient check that the application servers internal authentication
mechanism is working correctlybull Administrative console Starts the WebSphere Administrative console
in a browser window enabling you to perform configuration tasks that areoutside the scope of the installation process Starting the administrativeconsole also requires the administrative password that you set during theinstallation process
bull Profile management tool Enables you to create additional executionprofiles each of which can be for use with specific enterprise Webapplications port configurations and so on If you did not specify a targetserver environment during the installation process and are not migrating
server configuration information from an existing WebSphere ApplicationServer installation use this option to create at least one WebSphereApplication Server profile You cannot start WebSphere ApplicationServer without at least one profilemdasheach profile provides the configurationinformation required to start the application server in a specific context
bull Samples gallery Provides access to the sample applications youinstalled during the installation process
bull Information center for WebSphere Application Server Opens theWebSphere Application Server Library Web site in a browser to providedetailed information about WebSphere Application Server in a variety of
enterprise application scenarios
bull Migration wizard Starts a wizard that simplifies migrating configurationinformation and applications from earlier versions of WebSphereApplication Server
The next few sections provide highlights of using selected options from the Firststeps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 20 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2140
Installation verification
Though error messages would have displayed had any problems occurred duringthe WebSphere Application Server installation process its always comforting to be
able to double-check that your application server installation is complete and that allthe necessary configuration files were created correctly during that process
To verify that WebSphere Application Server was installed correctly on your systemand start it as part of the testing process click the Installation verification link inthe First steps console A window like the one shown in Figure 11 displays
Figure 11 Output of the verification process
As you can see from this figure the verification process first starts the applicationserver with your default profile and then connects to the application server to verifythe Servlet engine JavaServer pages and enterprise bean configuration It thenexamines the authentication of the key stores that are used to provide secureconnections between WebSphere components
When the verification process completes you can click the close button in the upperright-hand corner of the output window to close that window and return to the Firststeps console Note that the Start the server link has been replaced by a Stop the
server link because the WebSphere Application Server was started as part of theverification process
Starting the server
If you choose not to verify your WebSphere Application Server installation as
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 21 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2240
described in the previous section you can start the WebSphere Application Servermanually by clicking the Start the server link in the First steps console Clicking thislink displays an output window much like the one shown in Figure 11 except that itonly shows the initial text about starting the server and does not probe theconfiguration of your server
Note If the First steps console does not show a Start the server link but insteaddisplays only a Stop the server link your WebSphere Application Server is alreadyrunning
After a line like ADMU3000I Server NAME open for e-business
displays in the output window you can click the close box in the upper right-handcorner of the output window to close that window and return to the First stepsconsole
Administrative consoleThe WebSphere Application Server Administrative console is the primarymechanism for configuring the application server integrating the application serverwith external applications such as database systems and installing WebSphereapplications If you are new to WebSphere Application Server and want to explorethe administrative console or want to install new WebSphere applicationsimmediately after installing WebSphere you may want to start the Administrativeconsole from the First steps console
Click Administrative console to start the WebSphere Administrative console fromthe First steps console The login screen for the Administrative console opens in abrowser window as shown in Figure 12
Figure 12 Administrative console login screen
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 22 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2340
The Administrative console requires a Secure Sockets Layer (SSL) HTTPconnection generally referred to as a Hypertext Transfer Protocol over SecureSockets Layer (HTTPS) connection The page shown in Figure 12 only displays if avalid third-party SSL certificate is installed on your system If the system on whichyou installed WebSphere Application Server does not have a valid certificate issuedby a third party you will see a warning dialog like that shown in Figure 13 instead
Figure 13 Certificate not trusted alert
If you see this message see the next section of this tutorial for information about
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 23 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2440
configuring a security exception for your systems existing certificate
If you see the Administrative console login screen as shown in Figure 12 enter theadministrative username and password that you defined during the installationprocess and click Login or press Return The WebSphere Application Server
Administrative console displays as shown in Figure 14 You can explore or use theAdministrative console clicking the Logout link in the header when you are done
Figure 14 Administrative console
Configuring a certificate security exception
As discussed in the previous section the WebSphere Application ServerAdministrative console requires an SSL HTTP connection generally referred to asan HTTPS connection According to the default security policies used by mostsystems this means that the public key security certificate presented by your systemmust be a valid certificate issued by a trusted third-party certificate authority such asthawte VeriSign GeoTrust and many others See Resources for more informationabout these third-party certificate authorities
In a production environment you will certainly only want to use WebSphere
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 24 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2540
Application Server on a system with a valid enterprise or third-party securitycertificate so that users of your Web applications can verify the identity of the systemthat they are connecting to However you may be installing and configuringWebSphere Application Server on a new system for which you have not yet obtaineda certificate In this case you can temporarily or permanently define your existing
certificate as a trusted one that is an exception to the standard WebSphere securitypolicy
To define a policy exception click OK in the dialog shown in Figure 13 to display thescreen shown in Figure 15
Figure 15 A secure connection failure in Firefox
Click the Or you can define an exception link to begin the process of identifyingyour systems certificate as a valid digital public key certificate A screen identical to
the current screen displays with the exception of two additional buttons that displayat the bottom of the screen Click Add exception to continue the process of definingthe current certificate as an exception to the default certificate policy The dialogshown in Figure 16 displays
Note Clicking the Get me out of here button exits the exception definition processand returns you to your browser without establishing a connection to the WebSphere
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 25 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2640
Administrative console which isnt all that useful for the purposes of this tutorial
Figure 16 Initial dialog for defining a security exception
Click Get Certificate to retrieve your systems current certificate which displaysinformation about the current certificate and enables the Confirm Security
Exception button at the bottom left of the dialog shown in Figure 16 as shown inFigure 17
Figure 17 Updated dialog for defining a security exception
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 26 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 340
temporarily available in the file system from which you install WebSphere ApplicationServer
If you are installing WebSphere Application Server on a Linux system not all Linuxdistributions include a version of the Javatrade Runtime Environment (JRE) that is
suitable for use by the installer and certain WebSphere Application Server functionsOn unsupported Linux distributions such as Ubuntu you should download and installthe IBM Java software development kit (SDK) and make some minor modificationsto your system before installing WebSphere Application Server See Setting upunsupported Linux distributions for instructions
If you choose to install the IBM Java SDK at least 450MB of additional disk spacemust be available on the system A minimum of 175MB must be permanentlyavailable in the file system that contains the opt directory and 275MB more must betemporarily available in the file system from which you install IBM Java SDK
Section 2 Web servers and architectures
Todays enterprise Web environments are much more sophisticated than the simplecontent-delivery model of a few years ago Evolving Web software technologies andincreasing connectivity between Web servers and other data resources continue torevolutionize what users can do from the Internet and the services that businessescan offer and use themselves over the Web
Modern Web architectures and middleware
Todays enterprise Web architectures use what are known as n-tier architecturesthat enable Web servers to connect to data sources beyond simple static content Toaccess remote data sources these n-tier Web architectures typically usemiddleware which is the term for software that connects other applications orservices The most powerful and flexible form of middleware is a Web application server such as IBM WebSphere Application Server that hosts the applicationprogram interfaces (APIs) required by enterprise Web applications These Web
applications implement the connectivity between applications and resources(business logic ) required by Web-based implementations of various business processes
In n-tier Web architectures an application server can be running on the samesystem on which a Web server is running or on another system The Web serveracts as an intermediary between Web clients and the application server just as theapplication server acts as an intermediary between application logic and remote data
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 3 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 440
requirements
IBM WebSphere Application Server overview
IBM WebSphere Application Server is a Java application server that is built usingopen standards such as Java Platform Enterprise Edition (Java EE) ExtensibleMarkup Language (XML) and Hypertext Transfer Protocol (HTTP)-based Webservices WebSphere Application Server is typically used in conjunction with otherIBM products such as IBM HTTP Server but can be used with most other Webservers including the standard Apache HTTP Server Microsoftreg Internet InformationServices (IIS) and the Sun Java System Web Server The IBM HTTP Serverincludes a WebSphere Application Server plug-in to simplify WebSphereconfiguration and administration
WebSphere Application Server provides a robust scalable environment for
enterprise Web applications Its architecture and the reuse and integrationopportunities provided by other WebSphere products minimize runtime memoryrequirements and deliver a secure standards-based infrastructure for Web-basedapplication development and deployment The wide range of existing WebSphereadd-on products supported development frameworks and its support for newstandards such as the Service Component Architecture (SCA) satisfy therequirements of todays enterprise applications while simplifying the developmentand integration of the new applications that will deliver tomorrows solutions SeeResources for a link to the WebSphere Application and transaction infrastructurepage which provides information about many of the WebSphere add-on productsthat are currently available
Both IBM WebSphere Application Server and IBM HTTP Server are supported onmany platforms including Linux IBM AIXreg HP-UX IBM i (i5OS i6OS OS400)IBM zOS Microsoft Windowsreg and Solaris See Supported platforms for moredetailed information about hardware and software requirements
See Resources for links to additional information on popular n-tier applicationservers
Supported platforms
This tutorial discusses installing and configuring IBM WebSphere Application Server70 Version 70 is available for and supported on the following operating systemsand associated hardware
bull AIX
bull HP-UX on IA64 and HP-UX PA-RISC
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 4 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 540
bull Linux (32 bit)
bull Linux for IBM itrade System ptrade and System ztrade
bull Sun Solaris on SPARC and x86-64
bull Microsoft Windows 2000 Windows Serverreg 2003 and MicrosoftWindows XP
WebSphere Application Server is officially supported on the Red Hat EnterpriseLinux versions 4 and 5 and SUSE Enterprise Server versions 9 and 10 Linuxdistributions but you should be able to install it cleanly on any Linux distribution TheSetting up unsupported Linux distributions section provides tips to enable you toinstall and run WebSphere Application Server on Linux distributions other than thosethat are officially supported
Note You can run the 32-bit Intelreg architecture versions of WebSphere Application
Server and HTTP Server on a 64-bit UNIX system as long as you have installed yourUNIX systems 32-bit compatibility libraries on that system The name of thispackage and the package management system used for its installation differs onvarious UNIX systems On Linux systems this is the ia32-libs package
Deploying WebSphere Application Server
WebSphere Application Server is typically deployed in one of two basic ways
bull As stand-alone application servers that support specific business logic
and related applications in single-server environments
bull In a network deployment scenario where clusters of application serversdeliver advanced capabilities for high-performance high-availabilityenvironments (See Resources for more information)
As your business requirements and information technology (IT) infrastructure growa stand-alone WebSphere Application Server installation can be integrated into theclusters created in a network deployment scenario
This tutorial focuses on installing a stand-alone application server because of thesite-specific nature of network deployments
Section 3 Installing WebSphere Application Server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 5 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 640
Thanks to its graphical installer installing WebSphere Application Server is quitesimple
Getting the installation files
If you want to evaluate WebSphere Application Server on a specific UNIX systemyou can request a copy for evaluation purposes from IBM Contact your IBM salesrepresentative for more information
A trial version of WebSphere Application Server for Linux systems is available as adownload or on the Linux Software Evaluation Kit (SEK) a set of four DVDscontaining evaluation products from IBM WebSphere IBM InformationManagementreg Lotusreg Rationalreg and Tivolireg that enable you to install andconfigure IBM middleware and start building and deploying applications Thesoftware 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 downloadedfile If you are installing WebSphere Application Server from the Linux SEK DVDsthe archive file containing the installable files for WebSphere Application Server arelocated on DVD 3 of the set The instructions for extracting the contents of thearchive file on your DVD are the same as those for extracting installable files from adownloaded file
Setting up unsupported Linux distributions
The Supported platforms section of this tutorial includes a list of the UNIX and Linuxplatforms on which WebSphere Application Server is officially supported Ascommercial products UNIX systems provide standard capabilities that can beguaranteed to be present for use by commercial products such as WebSphereApplication Server Unfortunately Linux distributions can be very different from eachother so WebSphere Application Server is only officially supported on certaindistributions However you can also run WebSphere Application Server on otherLinux 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 filesand beginning the installation section of this tutorial
For example not all Linux distributions include a version of the JRE that is suitablefor use by the WebSphere Application Server installer and certain WebSphereApplication Server functions On unsupported Linux distributions such as Ubuntuyou should download and install the IBM Java SDK for use during the installation
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 6 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 740
process See Resources for a link from which you can download the appropriateversion of the IBM Java SDK for your system After downloading this file you canextract its contents and install them using the following steps
1 Extract the contents of the archive file using a command like the following
tar zxvf filenametargz
Replace filename with the name of the IBM Java SDK archive file that youdownloaded which will be something likeibm-java-sdk-60-20-linux-x86_64targz The directory that is created bythe tar command will be something like ibm-java-x86_64-60
2 Use the sudo command to move the directory that was extracted from the
archive file to a system directory such as opt by using a command likethe following
mv DIRECTORY opt
Replace DIRECTORY with the name of the directory that was createdwhen you extracted the contents of the IBM Java SDK archive file thatyou downloaded
3 Modify the series of directories that your system searches for binaries byexecuting a command like the following
export PATH DIRECTORY$PATH
You should add this command to your shell startup file (~bashrc) toensure 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 thegeneric UNIXLinux shell binsh Ubuntu systems use a lightweight shell named
bindash as binsh but this shell does not provide all the capabilities required bythe WebSphere Application Server installation and startup scripts To use thestandard Bash shell as binsh execute the following commands on your Ubuntusystem before beginning the WebSphere Application Server installation process
sudo mv binsh binshORIGsudo ln -s binbash binsh
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 7 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 840
These steps are sufficient to enable you to begin the WebSphere Application Serverinstallation process on an Ubuntu system Other Linux distributions may requiresimilar changes
Extracting files and beginning the installation
After downloading or otherwise obtaining the archive file containing WebSphereApplication Server or mounting the Linux SEK DVD 3 when using a Linux systemcreate a directory in which to extract the files from which you can actually installWebSphere Application Server See Basic tasks for Linux Developers if you areunsure about how to mount your DVD or determine where it is mounted
The optWASTrial directory is the suggested location for extracting the files fromwhich you will install WebSphere Application Server To create this directory do the
following
1 Depending on the UNIX operating system or Linux distribution that isinstalled on the system where you are installing WebSphere ApplicationServer use the su or sudo -s commands to become a privileged useron your system Enter the root password or your password (respectively)when prompted to do so
2 Create the optWASTrial directory using the mkdir optWASTrial
command
3 Change directory to the optWASTrial directory
4 Use the tar command to extract the contents of the file that youdownloaded or the WebSphere Application Server archive file from themounted DVDIf you downloaded the file use a command like the following
tar zxvf pathtofilewascd7000trialbaselinuxia32targz
Replace pathtofile 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 acommand like the following
tar zxvf mountpointwas7uxtfilenametargz
Replace mountpoint with the name of the directory on which SEK DVD
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 8 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 940
3 is mounted and replace filename with the name of the WebSphereApplication Server archive file in that directory You may also have toreplace was7uxt with the name of the directory containing the Linuxarchive file if a different directory name was used in the latest SEK DVDreleases
5 Use the launchpadsh command to start the Firefox Web browserwhich displays the page shown in Figure 1Figure 1 Firefox Welcome page
Note If you are using Linux for your evaluation no 64-bit Linux version seems to beavailable for download See Supported platforms for information about how to usethe 32-bit Linux build on a 64-bit Linux system
Starting the installer
Click Launch the installation wizard for WebSphere Application Server Trial tobegin the actual installation process The graphical installer for WebSphereApplication Server begins and displays its welcome screen as shown in Figure 2
Figure 2 WebSphere Application Server installers welcome screen
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 9 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1040
The welcome screen shows that the graphical installer is working correctly andprovides links to online sites that provide information and support for WebSphereand related products
Click Next to proceed with the installation process
Accepting the license terms and checking your system
The next page of the graphical installer displays the license under which WebSphereApplication Server is released as shown in Figure 3
Figure 3 Accepting the IBM software license agreement
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 10 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1140
This license contains IBM licensing information for the evaluation version ofWebSphere Application Server and language that excludes open source softwarethat is distributed with IBM WebSphere Application Server from those terms andidentifies separately licensed software components
Select I accept the terms in the licensing agreement to accept the licensingterms Click Next to proceed with the installation process If you dont accept thelicense terms a window displays asking you to confirm that fact If you confirm thatyou do not accept the license terms the installer exits
The next page of the installer indicates whether your system satisfies theprerequisites for installation If your system does not satisfy requirements theinstaller may display information about any missing patches that you should installIn this case you can either click Cancel to exit the installer and install the missingprerequisites or simply proceed with the installation
Click Next to proceed with the installation process
Selecting optional features for installation
Figure 4 shows the installer screen that enables you to install optional software whileyou install WebSphere Application Server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 11 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1240
Figure 4 Selecting optional software for installation
Optional software that you can install consists of the following
bull Sample applications Source code and integrated applications for initial
experimentation The sample applications also serve as an excellentmechanism for verifying that WebSphere Application Server is installedcorrectly and is working properly on your system
bull Non-English language support for the administrative consoleLanguage catalogs that provide national language support for WebSphereApplication Servers administrative console These language catalogs donot provide national language support for WebSphere Application Serveritself which is available in a separate item on this screen
bull Non-English language support for WebSphere Application ServerLanguage catalogs that provide national language support for WebSphereApplication Server itself These language catalogs do not provide nationallanguage support for WebSphere Application Servers administrativeconsole which is available in a separate item on this screen
Unless you already have substantial experience with WebSphere Application Serveryou should install the sample applications to provide a way for you to learn moreabout application integration and deployment in the WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 12 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1340
environment
The default language package installed with WebSphere is English as spoken in theUnited States Whether or not you install the optional language packages dependson your geographic location and language support requirements The additional
languages that are supported by the administrative console and WebSphereApplication Server language support packs are Chinese Czech French GermanHungarian Italian Japanese Korean Polish Portuguese Russian and Spanish
After selecting any additional features that you want to install click Next to proceedwith the installation process
Identifying the target installation directory
Next the graphical installer displays the default location in which WebSphereApplication Server will be installed which is optIBMWebSphereAppServer onUNIX 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 installingWebSphere Application Server in non-standard locations can make local systemadministration more complex Non-standard installation locations may also cause
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 13 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1440
problems with WebSphere applications that may expect the standard installationlocation
Click Next to proceed with the installation process
Specifying the WebSphere Application Server environment
The screen shown in Figure 6 enables you to identify the type of WebSphereApplication 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 youare installing and integrating WebSphere Application Server The environment thatyou 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 choicesare the following
bull Management Select this option if you are installing this copy ofWebSphere Application Server to manage other application serverenvironments on the local machine or on other systems on your networkSelecting this option creates an appropriate profile and will install and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 14 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1540
configure an administrative agent server services for managing multipleapplication server environments and an administrative agent to manageother application servers that are on the same machine
bull Application server The default selection this option creates anappropriate profile for installing a stand-alone application server that will
run your enterprise applications and which can only be managed from itsown administrative console
bull None Select this option if you do not want to create an execution profileduring installation Only select this option if you will explicitly create one ormore profiles after WebSphere Application Server is successfully installedon your system
Click Next to proceed with the installation process
Note If you select None as your server execution environment a warning dialogdisplays to inform you that at least one functional profile must be available to runWebSphere Application Server Click Yes to proceed with the installation processwithout creating a profile during the installation process and proceed to Summarypage and actual installation If you want to create a profile during the installationprocess click No to return to the dialog shown in Figure 6 to modify your serverexecution environment setting
Creating an administrative user
The next screen of the installer shown in Figure 7 enables you to create a secureaccount on your system for system administration through the WebSphereApplication Server administrative console
Figure 7 Defining an administrative user
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 15 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1640
Create an administrative user if you are installing a stand-alone or managedWebSphere Application Servermdashin other words when you are installing WebSphereApplication Server in an environment that creates a profile for you during theinstallation process as described earlier in Specifying the WebSphere Application
Server environment
Enter a username and password for use in administering your WebSphereApplication Server and enter the password again to confirm that you typed itcorrectly the first time
If you selected the sample applications for installation in the Selecting optionalfeatures for installation section you will also be prompted to set a password for theuser associated with those sample applications Enter the password twice to ensurethat you have typed it correctly or have at least made the same typo twice
After supplying information about the administrative user (and optionally apassword for the sample applications if you selected them for installation) click Nextto proceed with the installation process
Summary page and actual installation
As shown in Figure 8 a summary screen displays the configuration options that you
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 16 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1740
have accepted or specified and provides a check box that enables you to verify thatyou 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 theresreally no need to verify that you have the required privileges Clear this check boxand click Next to begin the installation process A window displays showing thestatus of the installation process The installation process first creates an uninstallerfor WebSphere Application Server to simplify removing the software if necessary Itthen installs WebSphere Application Server displaying status information as theinstallation proceeds
Installation status and next steps
When the installation finishes the window shown in Figure 9 displays the success orfailure of installation If any errors occur this window shows the location of a log filethat you can examine to identify the problems and determine whether they weremeaningful
Figure 9 Summary information about your installation
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 17 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1840
This screen provides a check box that because it is selected by default starts theWebSphere Application Server First steps console when you exit the installer TheFirst steps console enables you to do some initial configuration of WebSphereApplication Server
At this point you have two options
bull Leave the Launch the First steps console check box selected and clickFinish to exit the installer and start the First steps console
bull Clear the Launch the First steps console check box and click Finish toexit the installer without starting the First steps console or WebSphereApplication Server
Congratulations Youve installed WebSphere Application Server If you started theFirst steps console proceed to the next section for information about using thatconsole Otherwise you may want to do one of the following
bull Start the WebSphere Application Server manually
bull Integrate WebSphere Application Server with your systems Web server
bull Integrate WebSphere Application Server into your systems startup and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 18 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1940
shutdown processes
bull Access the WebSphere administrative console to begin configuring yourWebSphere Application Server
Section 4 Using the First steps console
The WebSphere Application Server installation process can automatically start aFirst steps console to help you familiarize yourself with WebSphere ApplicationServer and perform some initial configuration tasks Figure 10 shows the initialscreen of the First steps console
Figure 10 First steps console
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 19 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2040
As shown in Figure 10 the First steps console provides links to a number ofconvenient tasks that you may want to perform immediately after installationincluding
bull Installation verification Checks your WebSphere Application Server
installation to verify that it is installed correctly and starts the applicationserver as part of this check
bull Start the Server Starts the WebSphere Application Server displayingthe output of the startup process in a separate window for convenienceand diagnostic purposes When the application server is running this linkchanges to a Stop the server link which provides a convenient way tostop the server and displays the output of the server shutdown process ina separate window Stopping the server requires the administrativepassword that you set during the installation process and provides aconvenient check that the application servers internal authentication
mechanism is working correctlybull Administrative console Starts the WebSphere Administrative console
in a browser window enabling you to perform configuration tasks that areoutside the scope of the installation process Starting the administrativeconsole also requires the administrative password that you set during theinstallation process
bull Profile management tool Enables you to create additional executionprofiles each of which can be for use with specific enterprise Webapplications port configurations and so on If you did not specify a targetserver environment during the installation process and are not migrating
server configuration information from an existing WebSphere ApplicationServer installation use this option to create at least one WebSphereApplication Server profile You cannot start WebSphere ApplicationServer without at least one profilemdasheach profile provides the configurationinformation required to start the application server in a specific context
bull Samples gallery Provides access to the sample applications youinstalled during the installation process
bull Information center for WebSphere Application Server Opens theWebSphere Application Server Library Web site in a browser to providedetailed information about WebSphere Application Server in a variety of
enterprise application scenarios
bull Migration wizard Starts a wizard that simplifies migrating configurationinformation and applications from earlier versions of WebSphereApplication Server
The next few sections provide highlights of using selected options from the Firststeps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 20 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2140
Installation verification
Though error messages would have displayed had any problems occurred duringthe WebSphere Application Server installation process its always comforting to be
able to double-check that your application server installation is complete and that allthe necessary configuration files were created correctly during that process
To verify that WebSphere Application Server was installed correctly on your systemand start it as part of the testing process click the Installation verification link inthe First steps console A window like the one shown in Figure 11 displays
Figure 11 Output of the verification process
As you can see from this figure the verification process first starts the applicationserver with your default profile and then connects to the application server to verifythe Servlet engine JavaServer pages and enterprise bean configuration It thenexamines the authentication of the key stores that are used to provide secureconnections between WebSphere components
When the verification process completes you can click the close button in the upperright-hand corner of the output window to close that window and return to the Firststeps console Note that the Start the server link has been replaced by a Stop the
server link because the WebSphere Application Server was started as part of theverification process
Starting the server
If you choose not to verify your WebSphere Application Server installation as
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 21 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2240
described in the previous section you can start the WebSphere Application Servermanually by clicking the Start the server link in the First steps console Clicking thislink displays an output window much like the one shown in Figure 11 except that itonly shows the initial text about starting the server and does not probe theconfiguration of your server
Note If the First steps console does not show a Start the server link but insteaddisplays only a Stop the server link your WebSphere Application Server is alreadyrunning
After a line like ADMU3000I Server NAME open for e-business
displays in the output window you can click the close box in the upper right-handcorner of the output window to close that window and return to the First stepsconsole
Administrative consoleThe WebSphere Application Server Administrative console is the primarymechanism for configuring the application server integrating the application serverwith external applications such as database systems and installing WebSphereapplications If you are new to WebSphere Application Server and want to explorethe administrative console or want to install new WebSphere applicationsimmediately after installing WebSphere you may want to start the Administrativeconsole from the First steps console
Click Administrative console to start the WebSphere Administrative console fromthe First steps console The login screen for the Administrative console opens in abrowser window as shown in Figure 12
Figure 12 Administrative console login screen
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 22 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2340
The Administrative console requires a Secure Sockets Layer (SSL) HTTPconnection generally referred to as a Hypertext Transfer Protocol over SecureSockets Layer (HTTPS) connection The page shown in Figure 12 only displays if avalid third-party SSL certificate is installed on your system If the system on whichyou installed WebSphere Application Server does not have a valid certificate issuedby a third party you will see a warning dialog like that shown in Figure 13 instead
Figure 13 Certificate not trusted alert
If you see this message see the next section of this tutorial for information about
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 23 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2440
configuring a security exception for your systems existing certificate
If you see the Administrative console login screen as shown in Figure 12 enter theadministrative username and password that you defined during the installationprocess and click Login or press Return The WebSphere Application Server
Administrative console displays as shown in Figure 14 You can explore or use theAdministrative console clicking the Logout link in the header when you are done
Figure 14 Administrative console
Configuring a certificate security exception
As discussed in the previous section the WebSphere Application ServerAdministrative console requires an SSL HTTP connection generally referred to asan HTTPS connection According to the default security policies used by mostsystems this means that the public key security certificate presented by your systemmust be a valid certificate issued by a trusted third-party certificate authority such asthawte VeriSign GeoTrust and many others See Resources for more informationabout these third-party certificate authorities
In a production environment you will certainly only want to use WebSphere
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 24 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2540
Application Server on a system with a valid enterprise or third-party securitycertificate so that users of your Web applications can verify the identity of the systemthat they are connecting to However you may be installing and configuringWebSphere Application Server on a new system for which you have not yet obtaineda certificate In this case you can temporarily or permanently define your existing
certificate as a trusted one that is an exception to the standard WebSphere securitypolicy
To define a policy exception click OK in the dialog shown in Figure 13 to display thescreen shown in Figure 15
Figure 15 A secure connection failure in Firefox
Click the Or you can define an exception link to begin the process of identifyingyour systems certificate as a valid digital public key certificate A screen identical to
the current screen displays with the exception of two additional buttons that displayat the bottom of the screen Click Add exception to continue the process of definingthe current certificate as an exception to the default certificate policy The dialogshown in Figure 16 displays
Note Clicking the Get me out of here button exits the exception definition processand returns you to your browser without establishing a connection to the WebSphere
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 25 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2640
Administrative console which isnt all that useful for the purposes of this tutorial
Figure 16 Initial dialog for defining a security exception
Click Get Certificate to retrieve your systems current certificate which displaysinformation about the current certificate and enables the Confirm Security
Exception button at the bottom left of the dialog shown in Figure 16 as shown inFigure 17
Figure 17 Updated dialog for defining a security exception
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 26 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 440
requirements
IBM WebSphere Application Server overview
IBM WebSphere Application Server is a Java application server that is built usingopen standards such as Java Platform Enterprise Edition (Java EE) ExtensibleMarkup Language (XML) and Hypertext Transfer Protocol (HTTP)-based Webservices WebSphere Application Server is typically used in conjunction with otherIBM products such as IBM HTTP Server but can be used with most other Webservers including the standard Apache HTTP Server Microsoftreg Internet InformationServices (IIS) and the Sun Java System Web Server The IBM HTTP Serverincludes a WebSphere Application Server plug-in to simplify WebSphereconfiguration and administration
WebSphere Application Server provides a robust scalable environment for
enterprise Web applications Its architecture and the reuse and integrationopportunities provided by other WebSphere products minimize runtime memoryrequirements and deliver a secure standards-based infrastructure for Web-basedapplication development and deployment The wide range of existing WebSphereadd-on products supported development frameworks and its support for newstandards such as the Service Component Architecture (SCA) satisfy therequirements of todays enterprise applications while simplifying the developmentand integration of the new applications that will deliver tomorrows solutions SeeResources for a link to the WebSphere Application and transaction infrastructurepage which provides information about many of the WebSphere add-on productsthat are currently available
Both IBM WebSphere Application Server and IBM HTTP Server are supported onmany platforms including Linux IBM AIXreg HP-UX IBM i (i5OS i6OS OS400)IBM zOS Microsoft Windowsreg and Solaris See Supported platforms for moredetailed information about hardware and software requirements
See Resources for links to additional information on popular n-tier applicationservers
Supported platforms
This tutorial discusses installing and configuring IBM WebSphere Application Server70 Version 70 is available for and supported on the following operating systemsand associated hardware
bull AIX
bull HP-UX on IA64 and HP-UX PA-RISC
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 4 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 540
bull Linux (32 bit)
bull Linux for IBM itrade System ptrade and System ztrade
bull Sun Solaris on SPARC and x86-64
bull Microsoft Windows 2000 Windows Serverreg 2003 and MicrosoftWindows XP
WebSphere Application Server is officially supported on the Red Hat EnterpriseLinux versions 4 and 5 and SUSE Enterprise Server versions 9 and 10 Linuxdistributions but you should be able to install it cleanly on any Linux distribution TheSetting up unsupported Linux distributions section provides tips to enable you toinstall and run WebSphere Application Server on Linux distributions other than thosethat are officially supported
Note You can run the 32-bit Intelreg architecture versions of WebSphere Application
Server and HTTP Server on a 64-bit UNIX system as long as you have installed yourUNIX systems 32-bit compatibility libraries on that system The name of thispackage and the package management system used for its installation differs onvarious UNIX systems On Linux systems this is the ia32-libs package
Deploying WebSphere Application Server
WebSphere Application Server is typically deployed in one of two basic ways
bull As stand-alone application servers that support specific business logic
and related applications in single-server environments
bull In a network deployment scenario where clusters of application serversdeliver advanced capabilities for high-performance high-availabilityenvironments (See Resources for more information)
As your business requirements and information technology (IT) infrastructure growa stand-alone WebSphere Application Server installation can be integrated into theclusters created in a network deployment scenario
This tutorial focuses on installing a stand-alone application server because of thesite-specific nature of network deployments
Section 3 Installing WebSphere Application Server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 5 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 640
Thanks to its graphical installer installing WebSphere Application Server is quitesimple
Getting the installation files
If you want to evaluate WebSphere Application Server on a specific UNIX systemyou can request a copy for evaluation purposes from IBM Contact your IBM salesrepresentative for more information
A trial version of WebSphere Application Server for Linux systems is available as adownload or on the Linux Software Evaluation Kit (SEK) a set of four DVDscontaining evaluation products from IBM WebSphere IBM InformationManagementreg Lotusreg Rationalreg and Tivolireg that enable you to install andconfigure IBM middleware and start building and deploying applications Thesoftware 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 downloadedfile If you are installing WebSphere Application Server from the Linux SEK DVDsthe archive file containing the installable files for WebSphere Application Server arelocated on DVD 3 of the set The instructions for extracting the contents of thearchive file on your DVD are the same as those for extracting installable files from adownloaded file
Setting up unsupported Linux distributions
The Supported platforms section of this tutorial includes a list of the UNIX and Linuxplatforms on which WebSphere Application Server is officially supported Ascommercial products UNIX systems provide standard capabilities that can beguaranteed to be present for use by commercial products such as WebSphereApplication Server Unfortunately Linux distributions can be very different from eachother so WebSphere Application Server is only officially supported on certaindistributions However you can also run WebSphere Application Server on otherLinux 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 filesand beginning the installation section of this tutorial
For example not all Linux distributions include a version of the JRE that is suitablefor use by the WebSphere Application Server installer and certain WebSphereApplication Server functions On unsupported Linux distributions such as Ubuntuyou should download and install the IBM Java SDK for use during the installation
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 6 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 740
process See Resources for a link from which you can download the appropriateversion of the IBM Java SDK for your system After downloading this file you canextract its contents and install them using the following steps
1 Extract the contents of the archive file using a command like the following
tar zxvf filenametargz
Replace filename with the name of the IBM Java SDK archive file that youdownloaded which will be something likeibm-java-sdk-60-20-linux-x86_64targz The directory that is created bythe tar command will be something like ibm-java-x86_64-60
2 Use the sudo command to move the directory that was extracted from the
archive file to a system directory such as opt by using a command likethe following
mv DIRECTORY opt
Replace DIRECTORY with the name of the directory that was createdwhen you extracted the contents of the IBM Java SDK archive file thatyou downloaded
3 Modify the series of directories that your system searches for binaries byexecuting a command like the following
export PATH DIRECTORY$PATH
You should add this command to your shell startup file (~bashrc) toensure 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 thegeneric UNIXLinux shell binsh Ubuntu systems use a lightweight shell named
bindash as binsh but this shell does not provide all the capabilities required bythe WebSphere Application Server installation and startup scripts To use thestandard Bash shell as binsh execute the following commands on your Ubuntusystem before beginning the WebSphere Application Server installation process
sudo mv binsh binshORIGsudo ln -s binbash binsh
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 7 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 840
These steps are sufficient to enable you to begin the WebSphere Application Serverinstallation process on an Ubuntu system Other Linux distributions may requiresimilar changes
Extracting files and beginning the installation
After downloading or otherwise obtaining the archive file containing WebSphereApplication Server or mounting the Linux SEK DVD 3 when using a Linux systemcreate a directory in which to extract the files from which you can actually installWebSphere Application Server See Basic tasks for Linux Developers if you areunsure about how to mount your DVD or determine where it is mounted
The optWASTrial directory is the suggested location for extracting the files fromwhich you will install WebSphere Application Server To create this directory do the
following
1 Depending on the UNIX operating system or Linux distribution that isinstalled on the system where you are installing WebSphere ApplicationServer use the su or sudo -s commands to become a privileged useron your system Enter the root password or your password (respectively)when prompted to do so
2 Create the optWASTrial directory using the mkdir optWASTrial
command
3 Change directory to the optWASTrial directory
4 Use the tar command to extract the contents of the file that youdownloaded or the WebSphere Application Server archive file from themounted DVDIf you downloaded the file use a command like the following
tar zxvf pathtofilewascd7000trialbaselinuxia32targz
Replace pathtofile 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 acommand like the following
tar zxvf mountpointwas7uxtfilenametargz
Replace mountpoint with the name of the directory on which SEK DVD
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 8 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 940
3 is mounted and replace filename with the name of the WebSphereApplication Server archive file in that directory You may also have toreplace was7uxt with the name of the directory containing the Linuxarchive file if a different directory name was used in the latest SEK DVDreleases
5 Use the launchpadsh command to start the Firefox Web browserwhich displays the page shown in Figure 1Figure 1 Firefox Welcome page
Note If you are using Linux for your evaluation no 64-bit Linux version seems to beavailable for download See Supported platforms for information about how to usethe 32-bit Linux build on a 64-bit Linux system
Starting the installer
Click Launch the installation wizard for WebSphere Application Server Trial tobegin the actual installation process The graphical installer for WebSphereApplication Server begins and displays its welcome screen as shown in Figure 2
Figure 2 WebSphere Application Server installers welcome screen
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 9 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1040
The welcome screen shows that the graphical installer is working correctly andprovides links to online sites that provide information and support for WebSphereand related products
Click Next to proceed with the installation process
Accepting the license terms and checking your system
The next page of the graphical installer displays the license under which WebSphereApplication Server is released as shown in Figure 3
Figure 3 Accepting the IBM software license agreement
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 10 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1140
This license contains IBM licensing information for the evaluation version ofWebSphere Application Server and language that excludes open source softwarethat is distributed with IBM WebSphere Application Server from those terms andidentifies separately licensed software components
Select I accept the terms in the licensing agreement to accept the licensingterms Click Next to proceed with the installation process If you dont accept thelicense terms a window displays asking you to confirm that fact If you confirm thatyou do not accept the license terms the installer exits
The next page of the installer indicates whether your system satisfies theprerequisites for installation If your system does not satisfy requirements theinstaller may display information about any missing patches that you should installIn this case you can either click Cancel to exit the installer and install the missingprerequisites or simply proceed with the installation
Click Next to proceed with the installation process
Selecting optional features for installation
Figure 4 shows the installer screen that enables you to install optional software whileyou install WebSphere Application Server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 11 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1240
Figure 4 Selecting optional software for installation
Optional software that you can install consists of the following
bull Sample applications Source code and integrated applications for initial
experimentation The sample applications also serve as an excellentmechanism for verifying that WebSphere Application Server is installedcorrectly and is working properly on your system
bull Non-English language support for the administrative consoleLanguage catalogs that provide national language support for WebSphereApplication Servers administrative console These language catalogs donot provide national language support for WebSphere Application Serveritself which is available in a separate item on this screen
bull Non-English language support for WebSphere Application ServerLanguage catalogs that provide national language support for WebSphereApplication Server itself These language catalogs do not provide nationallanguage support for WebSphere Application Servers administrativeconsole which is available in a separate item on this screen
Unless you already have substantial experience with WebSphere Application Serveryou should install the sample applications to provide a way for you to learn moreabout application integration and deployment in the WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 12 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1340
environment
The default language package installed with WebSphere is English as spoken in theUnited States Whether or not you install the optional language packages dependson your geographic location and language support requirements The additional
languages that are supported by the administrative console and WebSphereApplication Server language support packs are Chinese Czech French GermanHungarian Italian Japanese Korean Polish Portuguese Russian and Spanish
After selecting any additional features that you want to install click Next to proceedwith the installation process
Identifying the target installation directory
Next the graphical installer displays the default location in which WebSphereApplication Server will be installed which is optIBMWebSphereAppServer onUNIX 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 installingWebSphere Application Server in non-standard locations can make local systemadministration more complex Non-standard installation locations may also cause
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 13 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1440
problems with WebSphere applications that may expect the standard installationlocation
Click Next to proceed with the installation process
Specifying the WebSphere Application Server environment
The screen shown in Figure 6 enables you to identify the type of WebSphereApplication 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 youare installing and integrating WebSphere Application Server The environment thatyou 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 choicesare the following
bull Management Select this option if you are installing this copy ofWebSphere Application Server to manage other application serverenvironments on the local machine or on other systems on your networkSelecting this option creates an appropriate profile and will install and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 14 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1540
configure an administrative agent server services for managing multipleapplication server environments and an administrative agent to manageother application servers that are on the same machine
bull Application server The default selection this option creates anappropriate profile for installing a stand-alone application server that will
run your enterprise applications and which can only be managed from itsown administrative console
bull None Select this option if you do not want to create an execution profileduring installation Only select this option if you will explicitly create one ormore profiles after WebSphere Application Server is successfully installedon your system
Click Next to proceed with the installation process
Note If you select None as your server execution environment a warning dialogdisplays to inform you that at least one functional profile must be available to runWebSphere Application Server Click Yes to proceed with the installation processwithout creating a profile during the installation process and proceed to Summarypage and actual installation If you want to create a profile during the installationprocess click No to return to the dialog shown in Figure 6 to modify your serverexecution environment setting
Creating an administrative user
The next screen of the installer shown in Figure 7 enables you to create a secureaccount on your system for system administration through the WebSphereApplication Server administrative console
Figure 7 Defining an administrative user
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 15 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1640
Create an administrative user if you are installing a stand-alone or managedWebSphere Application Servermdashin other words when you are installing WebSphereApplication Server in an environment that creates a profile for you during theinstallation process as described earlier in Specifying the WebSphere Application
Server environment
Enter a username and password for use in administering your WebSphereApplication Server and enter the password again to confirm that you typed itcorrectly the first time
If you selected the sample applications for installation in the Selecting optionalfeatures for installation section you will also be prompted to set a password for theuser associated with those sample applications Enter the password twice to ensurethat you have typed it correctly or have at least made the same typo twice
After supplying information about the administrative user (and optionally apassword for the sample applications if you selected them for installation) click Nextto proceed with the installation process
Summary page and actual installation
As shown in Figure 8 a summary screen displays the configuration options that you
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 16 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1740
have accepted or specified and provides a check box that enables you to verify thatyou 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 theresreally no need to verify that you have the required privileges Clear this check boxand click Next to begin the installation process A window displays showing thestatus of the installation process The installation process first creates an uninstallerfor WebSphere Application Server to simplify removing the software if necessary Itthen installs WebSphere Application Server displaying status information as theinstallation proceeds
Installation status and next steps
When the installation finishes the window shown in Figure 9 displays the success orfailure of installation If any errors occur this window shows the location of a log filethat you can examine to identify the problems and determine whether they weremeaningful
Figure 9 Summary information about your installation
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 17 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1840
This screen provides a check box that because it is selected by default starts theWebSphere Application Server First steps console when you exit the installer TheFirst steps console enables you to do some initial configuration of WebSphereApplication Server
At this point you have two options
bull Leave the Launch the First steps console check box selected and clickFinish to exit the installer and start the First steps console
bull Clear the Launch the First steps console check box and click Finish toexit the installer without starting the First steps console or WebSphereApplication Server
Congratulations Youve installed WebSphere Application Server If you started theFirst steps console proceed to the next section for information about using thatconsole Otherwise you may want to do one of the following
bull Start the WebSphere Application Server manually
bull Integrate WebSphere Application Server with your systems Web server
bull Integrate WebSphere Application Server into your systems startup and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 18 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1940
shutdown processes
bull Access the WebSphere administrative console to begin configuring yourWebSphere Application Server
Section 4 Using the First steps console
The WebSphere Application Server installation process can automatically start aFirst steps console to help you familiarize yourself with WebSphere ApplicationServer and perform some initial configuration tasks Figure 10 shows the initialscreen of the First steps console
Figure 10 First steps console
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 19 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2040
As shown in Figure 10 the First steps console provides links to a number ofconvenient tasks that you may want to perform immediately after installationincluding
bull Installation verification Checks your WebSphere Application Server
installation to verify that it is installed correctly and starts the applicationserver as part of this check
bull Start the Server Starts the WebSphere Application Server displayingthe output of the startup process in a separate window for convenienceand diagnostic purposes When the application server is running this linkchanges to a Stop the server link which provides a convenient way tostop the server and displays the output of the server shutdown process ina separate window Stopping the server requires the administrativepassword that you set during the installation process and provides aconvenient check that the application servers internal authentication
mechanism is working correctlybull Administrative console Starts the WebSphere Administrative console
in a browser window enabling you to perform configuration tasks that areoutside the scope of the installation process Starting the administrativeconsole also requires the administrative password that you set during theinstallation process
bull Profile management tool Enables you to create additional executionprofiles each of which can be for use with specific enterprise Webapplications port configurations and so on If you did not specify a targetserver environment during the installation process and are not migrating
server configuration information from an existing WebSphere ApplicationServer installation use this option to create at least one WebSphereApplication Server profile You cannot start WebSphere ApplicationServer without at least one profilemdasheach profile provides the configurationinformation required to start the application server in a specific context
bull Samples gallery Provides access to the sample applications youinstalled during the installation process
bull Information center for WebSphere Application Server Opens theWebSphere Application Server Library Web site in a browser to providedetailed information about WebSphere Application Server in a variety of
enterprise application scenarios
bull Migration wizard Starts a wizard that simplifies migrating configurationinformation and applications from earlier versions of WebSphereApplication Server
The next few sections provide highlights of using selected options from the Firststeps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 20 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2140
Installation verification
Though error messages would have displayed had any problems occurred duringthe WebSphere Application Server installation process its always comforting to be
able to double-check that your application server installation is complete and that allthe necessary configuration files were created correctly during that process
To verify that WebSphere Application Server was installed correctly on your systemand start it as part of the testing process click the Installation verification link inthe First steps console A window like the one shown in Figure 11 displays
Figure 11 Output of the verification process
As you can see from this figure the verification process first starts the applicationserver with your default profile and then connects to the application server to verifythe Servlet engine JavaServer pages and enterprise bean configuration It thenexamines the authentication of the key stores that are used to provide secureconnections between WebSphere components
When the verification process completes you can click the close button in the upperright-hand corner of the output window to close that window and return to the Firststeps console Note that the Start the server link has been replaced by a Stop the
server link because the WebSphere Application Server was started as part of theverification process
Starting the server
If you choose not to verify your WebSphere Application Server installation as
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 21 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2240
described in the previous section you can start the WebSphere Application Servermanually by clicking the Start the server link in the First steps console Clicking thislink displays an output window much like the one shown in Figure 11 except that itonly shows the initial text about starting the server and does not probe theconfiguration of your server
Note If the First steps console does not show a Start the server link but insteaddisplays only a Stop the server link your WebSphere Application Server is alreadyrunning
After a line like ADMU3000I Server NAME open for e-business
displays in the output window you can click the close box in the upper right-handcorner of the output window to close that window and return to the First stepsconsole
Administrative consoleThe WebSphere Application Server Administrative console is the primarymechanism for configuring the application server integrating the application serverwith external applications such as database systems and installing WebSphereapplications If you are new to WebSphere Application Server and want to explorethe administrative console or want to install new WebSphere applicationsimmediately after installing WebSphere you may want to start the Administrativeconsole from the First steps console
Click Administrative console to start the WebSphere Administrative console fromthe First steps console The login screen for the Administrative console opens in abrowser window as shown in Figure 12
Figure 12 Administrative console login screen
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 22 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2340
The Administrative console requires a Secure Sockets Layer (SSL) HTTPconnection generally referred to as a Hypertext Transfer Protocol over SecureSockets Layer (HTTPS) connection The page shown in Figure 12 only displays if avalid third-party SSL certificate is installed on your system If the system on whichyou installed WebSphere Application Server does not have a valid certificate issuedby a third party you will see a warning dialog like that shown in Figure 13 instead
Figure 13 Certificate not trusted alert
If you see this message see the next section of this tutorial for information about
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 23 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2440
configuring a security exception for your systems existing certificate
If you see the Administrative console login screen as shown in Figure 12 enter theadministrative username and password that you defined during the installationprocess and click Login or press Return The WebSphere Application Server
Administrative console displays as shown in Figure 14 You can explore or use theAdministrative console clicking the Logout link in the header when you are done
Figure 14 Administrative console
Configuring a certificate security exception
As discussed in the previous section the WebSphere Application ServerAdministrative console requires an SSL HTTP connection generally referred to asan HTTPS connection According to the default security policies used by mostsystems this means that the public key security certificate presented by your systemmust be a valid certificate issued by a trusted third-party certificate authority such asthawte VeriSign GeoTrust and many others See Resources for more informationabout these third-party certificate authorities
In a production environment you will certainly only want to use WebSphere
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 24 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2540
Application Server on a system with a valid enterprise or third-party securitycertificate so that users of your Web applications can verify the identity of the systemthat they are connecting to However you may be installing and configuringWebSphere Application Server on a new system for which you have not yet obtaineda certificate In this case you can temporarily or permanently define your existing
certificate as a trusted one that is an exception to the standard WebSphere securitypolicy
To define a policy exception click OK in the dialog shown in Figure 13 to display thescreen shown in Figure 15
Figure 15 A secure connection failure in Firefox
Click the Or you can define an exception link to begin the process of identifyingyour systems certificate as a valid digital public key certificate A screen identical to
the current screen displays with the exception of two additional buttons that displayat the bottom of the screen Click Add exception to continue the process of definingthe current certificate as an exception to the default certificate policy The dialogshown in Figure 16 displays
Note Clicking the Get me out of here button exits the exception definition processand returns you to your browser without establishing a connection to the WebSphere
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 25 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2640
Administrative console which isnt all that useful for the purposes of this tutorial
Figure 16 Initial dialog for defining a security exception
Click Get Certificate to retrieve your systems current certificate which displaysinformation about the current certificate and enables the Confirm Security
Exception button at the bottom left of the dialog shown in Figure 16 as shown inFigure 17
Figure 17 Updated dialog for defining a security exception
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 26 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 540
bull Linux (32 bit)
bull Linux for IBM itrade System ptrade and System ztrade
bull Sun Solaris on SPARC and x86-64
bull Microsoft Windows 2000 Windows Serverreg 2003 and MicrosoftWindows XP
WebSphere Application Server is officially supported on the Red Hat EnterpriseLinux versions 4 and 5 and SUSE Enterprise Server versions 9 and 10 Linuxdistributions but you should be able to install it cleanly on any Linux distribution TheSetting up unsupported Linux distributions section provides tips to enable you toinstall and run WebSphere Application Server on Linux distributions other than thosethat are officially supported
Note You can run the 32-bit Intelreg architecture versions of WebSphere Application
Server and HTTP Server on a 64-bit UNIX system as long as you have installed yourUNIX systems 32-bit compatibility libraries on that system The name of thispackage and the package management system used for its installation differs onvarious UNIX systems On Linux systems this is the ia32-libs package
Deploying WebSphere Application Server
WebSphere Application Server is typically deployed in one of two basic ways
bull As stand-alone application servers that support specific business logic
and related applications in single-server environments
bull In a network deployment scenario where clusters of application serversdeliver advanced capabilities for high-performance high-availabilityenvironments (See Resources for more information)
As your business requirements and information technology (IT) infrastructure growa stand-alone WebSphere Application Server installation can be integrated into theclusters created in a network deployment scenario
This tutorial focuses on installing a stand-alone application server because of thesite-specific nature of network deployments
Section 3 Installing WebSphere Application Server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 5 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 640
Thanks to its graphical installer installing WebSphere Application Server is quitesimple
Getting the installation files
If you want to evaluate WebSphere Application Server on a specific UNIX systemyou can request a copy for evaluation purposes from IBM Contact your IBM salesrepresentative for more information
A trial version of WebSphere Application Server for Linux systems is available as adownload or on the Linux Software Evaluation Kit (SEK) a set of four DVDscontaining evaluation products from IBM WebSphere IBM InformationManagementreg Lotusreg Rationalreg and Tivolireg that enable you to install andconfigure IBM middleware and start building and deploying applications Thesoftware 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 downloadedfile If you are installing WebSphere Application Server from the Linux SEK DVDsthe archive file containing the installable files for WebSphere Application Server arelocated on DVD 3 of the set The instructions for extracting the contents of thearchive file on your DVD are the same as those for extracting installable files from adownloaded file
Setting up unsupported Linux distributions
The Supported platforms section of this tutorial includes a list of the UNIX and Linuxplatforms on which WebSphere Application Server is officially supported Ascommercial products UNIX systems provide standard capabilities that can beguaranteed to be present for use by commercial products such as WebSphereApplication Server Unfortunately Linux distributions can be very different from eachother so WebSphere Application Server is only officially supported on certaindistributions However you can also run WebSphere Application Server on otherLinux 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 filesand beginning the installation section of this tutorial
For example not all Linux distributions include a version of the JRE that is suitablefor use by the WebSphere Application Server installer and certain WebSphereApplication Server functions On unsupported Linux distributions such as Ubuntuyou should download and install the IBM Java SDK for use during the installation
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 6 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 740
process See Resources for a link from which you can download the appropriateversion of the IBM Java SDK for your system After downloading this file you canextract its contents and install them using the following steps
1 Extract the contents of the archive file using a command like the following
tar zxvf filenametargz
Replace filename with the name of the IBM Java SDK archive file that youdownloaded which will be something likeibm-java-sdk-60-20-linux-x86_64targz The directory that is created bythe tar command will be something like ibm-java-x86_64-60
2 Use the sudo command to move the directory that was extracted from the
archive file to a system directory such as opt by using a command likethe following
mv DIRECTORY opt
Replace DIRECTORY with the name of the directory that was createdwhen you extracted the contents of the IBM Java SDK archive file thatyou downloaded
3 Modify the series of directories that your system searches for binaries byexecuting a command like the following
export PATH DIRECTORY$PATH
You should add this command to your shell startup file (~bashrc) toensure 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 thegeneric UNIXLinux shell binsh Ubuntu systems use a lightweight shell named
bindash as binsh but this shell does not provide all the capabilities required bythe WebSphere Application Server installation and startup scripts To use thestandard Bash shell as binsh execute the following commands on your Ubuntusystem before beginning the WebSphere Application Server installation process
sudo mv binsh binshORIGsudo ln -s binbash binsh
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 7 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 840
These steps are sufficient to enable you to begin the WebSphere Application Serverinstallation process on an Ubuntu system Other Linux distributions may requiresimilar changes
Extracting files and beginning the installation
After downloading or otherwise obtaining the archive file containing WebSphereApplication Server or mounting the Linux SEK DVD 3 when using a Linux systemcreate a directory in which to extract the files from which you can actually installWebSphere Application Server See Basic tasks for Linux Developers if you areunsure about how to mount your DVD or determine where it is mounted
The optWASTrial directory is the suggested location for extracting the files fromwhich you will install WebSphere Application Server To create this directory do the
following
1 Depending on the UNIX operating system or Linux distribution that isinstalled on the system where you are installing WebSphere ApplicationServer use the su or sudo -s commands to become a privileged useron your system Enter the root password or your password (respectively)when prompted to do so
2 Create the optWASTrial directory using the mkdir optWASTrial
command
3 Change directory to the optWASTrial directory
4 Use the tar command to extract the contents of the file that youdownloaded or the WebSphere Application Server archive file from themounted DVDIf you downloaded the file use a command like the following
tar zxvf pathtofilewascd7000trialbaselinuxia32targz
Replace pathtofile 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 acommand like the following
tar zxvf mountpointwas7uxtfilenametargz
Replace mountpoint with the name of the directory on which SEK DVD
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 8 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 940
3 is mounted and replace filename with the name of the WebSphereApplication Server archive file in that directory You may also have toreplace was7uxt with the name of the directory containing the Linuxarchive file if a different directory name was used in the latest SEK DVDreleases
5 Use the launchpadsh command to start the Firefox Web browserwhich displays the page shown in Figure 1Figure 1 Firefox Welcome page
Note If you are using Linux for your evaluation no 64-bit Linux version seems to beavailable for download See Supported platforms for information about how to usethe 32-bit Linux build on a 64-bit Linux system
Starting the installer
Click Launch the installation wizard for WebSphere Application Server Trial tobegin the actual installation process The graphical installer for WebSphereApplication Server begins and displays its welcome screen as shown in Figure 2
Figure 2 WebSphere Application Server installers welcome screen
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 9 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1040
The welcome screen shows that the graphical installer is working correctly andprovides links to online sites that provide information and support for WebSphereand related products
Click Next to proceed with the installation process
Accepting the license terms and checking your system
The next page of the graphical installer displays the license under which WebSphereApplication Server is released as shown in Figure 3
Figure 3 Accepting the IBM software license agreement
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 10 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1140
This license contains IBM licensing information for the evaluation version ofWebSphere Application Server and language that excludes open source softwarethat is distributed with IBM WebSphere Application Server from those terms andidentifies separately licensed software components
Select I accept the terms in the licensing agreement to accept the licensingterms Click Next to proceed with the installation process If you dont accept thelicense terms a window displays asking you to confirm that fact If you confirm thatyou do not accept the license terms the installer exits
The next page of the installer indicates whether your system satisfies theprerequisites for installation If your system does not satisfy requirements theinstaller may display information about any missing patches that you should installIn this case you can either click Cancel to exit the installer and install the missingprerequisites or simply proceed with the installation
Click Next to proceed with the installation process
Selecting optional features for installation
Figure 4 shows the installer screen that enables you to install optional software whileyou install WebSphere Application Server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 11 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1240
Figure 4 Selecting optional software for installation
Optional software that you can install consists of the following
bull Sample applications Source code and integrated applications for initial
experimentation The sample applications also serve as an excellentmechanism for verifying that WebSphere Application Server is installedcorrectly and is working properly on your system
bull Non-English language support for the administrative consoleLanguage catalogs that provide national language support for WebSphereApplication Servers administrative console These language catalogs donot provide national language support for WebSphere Application Serveritself which is available in a separate item on this screen
bull Non-English language support for WebSphere Application ServerLanguage catalogs that provide national language support for WebSphereApplication Server itself These language catalogs do not provide nationallanguage support for WebSphere Application Servers administrativeconsole which is available in a separate item on this screen
Unless you already have substantial experience with WebSphere Application Serveryou should install the sample applications to provide a way for you to learn moreabout application integration and deployment in the WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 12 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1340
environment
The default language package installed with WebSphere is English as spoken in theUnited States Whether or not you install the optional language packages dependson your geographic location and language support requirements The additional
languages that are supported by the administrative console and WebSphereApplication Server language support packs are Chinese Czech French GermanHungarian Italian Japanese Korean Polish Portuguese Russian and Spanish
After selecting any additional features that you want to install click Next to proceedwith the installation process
Identifying the target installation directory
Next the graphical installer displays the default location in which WebSphereApplication Server will be installed which is optIBMWebSphereAppServer onUNIX 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 installingWebSphere Application Server in non-standard locations can make local systemadministration more complex Non-standard installation locations may also cause
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 13 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1440
problems with WebSphere applications that may expect the standard installationlocation
Click Next to proceed with the installation process
Specifying the WebSphere Application Server environment
The screen shown in Figure 6 enables you to identify the type of WebSphereApplication 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 youare installing and integrating WebSphere Application Server The environment thatyou 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 choicesare the following
bull Management Select this option if you are installing this copy ofWebSphere Application Server to manage other application serverenvironments on the local machine or on other systems on your networkSelecting this option creates an appropriate profile and will install and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 14 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1540
configure an administrative agent server services for managing multipleapplication server environments and an administrative agent to manageother application servers that are on the same machine
bull Application server The default selection this option creates anappropriate profile for installing a stand-alone application server that will
run your enterprise applications and which can only be managed from itsown administrative console
bull None Select this option if you do not want to create an execution profileduring installation Only select this option if you will explicitly create one ormore profiles after WebSphere Application Server is successfully installedon your system
Click Next to proceed with the installation process
Note If you select None as your server execution environment a warning dialogdisplays to inform you that at least one functional profile must be available to runWebSphere Application Server Click Yes to proceed with the installation processwithout creating a profile during the installation process and proceed to Summarypage and actual installation If you want to create a profile during the installationprocess click No to return to the dialog shown in Figure 6 to modify your serverexecution environment setting
Creating an administrative user
The next screen of the installer shown in Figure 7 enables you to create a secureaccount on your system for system administration through the WebSphereApplication Server administrative console
Figure 7 Defining an administrative user
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 15 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1640
Create an administrative user if you are installing a stand-alone or managedWebSphere Application Servermdashin other words when you are installing WebSphereApplication Server in an environment that creates a profile for you during theinstallation process as described earlier in Specifying the WebSphere Application
Server environment
Enter a username and password for use in administering your WebSphereApplication Server and enter the password again to confirm that you typed itcorrectly the first time
If you selected the sample applications for installation in the Selecting optionalfeatures for installation section you will also be prompted to set a password for theuser associated with those sample applications Enter the password twice to ensurethat you have typed it correctly or have at least made the same typo twice
After supplying information about the administrative user (and optionally apassword for the sample applications if you selected them for installation) click Nextto proceed with the installation process
Summary page and actual installation
As shown in Figure 8 a summary screen displays the configuration options that you
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 16 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1740
have accepted or specified and provides a check box that enables you to verify thatyou 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 theresreally no need to verify that you have the required privileges Clear this check boxand click Next to begin the installation process A window displays showing thestatus of the installation process The installation process first creates an uninstallerfor WebSphere Application Server to simplify removing the software if necessary Itthen installs WebSphere Application Server displaying status information as theinstallation proceeds
Installation status and next steps
When the installation finishes the window shown in Figure 9 displays the success orfailure of installation If any errors occur this window shows the location of a log filethat you can examine to identify the problems and determine whether they weremeaningful
Figure 9 Summary information about your installation
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 17 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1840
This screen provides a check box that because it is selected by default starts theWebSphere Application Server First steps console when you exit the installer TheFirst steps console enables you to do some initial configuration of WebSphereApplication Server
At this point you have two options
bull Leave the Launch the First steps console check box selected and clickFinish to exit the installer and start the First steps console
bull Clear the Launch the First steps console check box and click Finish toexit the installer without starting the First steps console or WebSphereApplication Server
Congratulations Youve installed WebSphere Application Server If you started theFirst steps console proceed to the next section for information about using thatconsole Otherwise you may want to do one of the following
bull Start the WebSphere Application Server manually
bull Integrate WebSphere Application Server with your systems Web server
bull Integrate WebSphere Application Server into your systems startup and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 18 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1940
shutdown processes
bull Access the WebSphere administrative console to begin configuring yourWebSphere Application Server
Section 4 Using the First steps console
The WebSphere Application Server installation process can automatically start aFirst steps console to help you familiarize yourself with WebSphere ApplicationServer and perform some initial configuration tasks Figure 10 shows the initialscreen of the First steps console
Figure 10 First steps console
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 19 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2040
As shown in Figure 10 the First steps console provides links to a number ofconvenient tasks that you may want to perform immediately after installationincluding
bull Installation verification Checks your WebSphere Application Server
installation to verify that it is installed correctly and starts the applicationserver as part of this check
bull Start the Server Starts the WebSphere Application Server displayingthe output of the startup process in a separate window for convenienceand diagnostic purposes When the application server is running this linkchanges to a Stop the server link which provides a convenient way tostop the server and displays the output of the server shutdown process ina separate window Stopping the server requires the administrativepassword that you set during the installation process and provides aconvenient check that the application servers internal authentication
mechanism is working correctlybull Administrative console Starts the WebSphere Administrative console
in a browser window enabling you to perform configuration tasks that areoutside the scope of the installation process Starting the administrativeconsole also requires the administrative password that you set during theinstallation process
bull Profile management tool Enables you to create additional executionprofiles each of which can be for use with specific enterprise Webapplications port configurations and so on If you did not specify a targetserver environment during the installation process and are not migrating
server configuration information from an existing WebSphere ApplicationServer installation use this option to create at least one WebSphereApplication Server profile You cannot start WebSphere ApplicationServer without at least one profilemdasheach profile provides the configurationinformation required to start the application server in a specific context
bull Samples gallery Provides access to the sample applications youinstalled during the installation process
bull Information center for WebSphere Application Server Opens theWebSphere Application Server Library Web site in a browser to providedetailed information about WebSphere Application Server in a variety of
enterprise application scenarios
bull Migration wizard Starts a wizard that simplifies migrating configurationinformation and applications from earlier versions of WebSphereApplication Server
The next few sections provide highlights of using selected options from the Firststeps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 20 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2140
Installation verification
Though error messages would have displayed had any problems occurred duringthe WebSphere Application Server installation process its always comforting to be
able to double-check that your application server installation is complete and that allthe necessary configuration files were created correctly during that process
To verify that WebSphere Application Server was installed correctly on your systemand start it as part of the testing process click the Installation verification link inthe First steps console A window like the one shown in Figure 11 displays
Figure 11 Output of the verification process
As you can see from this figure the verification process first starts the applicationserver with your default profile and then connects to the application server to verifythe Servlet engine JavaServer pages and enterprise bean configuration It thenexamines the authentication of the key stores that are used to provide secureconnections between WebSphere components
When the verification process completes you can click the close button in the upperright-hand corner of the output window to close that window and return to the Firststeps console Note that the Start the server link has been replaced by a Stop the
server link because the WebSphere Application Server was started as part of theverification process
Starting the server
If you choose not to verify your WebSphere Application Server installation as
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 21 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2240
described in the previous section you can start the WebSphere Application Servermanually by clicking the Start the server link in the First steps console Clicking thislink displays an output window much like the one shown in Figure 11 except that itonly shows the initial text about starting the server and does not probe theconfiguration of your server
Note If the First steps console does not show a Start the server link but insteaddisplays only a Stop the server link your WebSphere Application Server is alreadyrunning
After a line like ADMU3000I Server NAME open for e-business
displays in the output window you can click the close box in the upper right-handcorner of the output window to close that window and return to the First stepsconsole
Administrative consoleThe WebSphere Application Server Administrative console is the primarymechanism for configuring the application server integrating the application serverwith external applications such as database systems and installing WebSphereapplications If you are new to WebSphere Application Server and want to explorethe administrative console or want to install new WebSphere applicationsimmediately after installing WebSphere you may want to start the Administrativeconsole from the First steps console
Click Administrative console to start the WebSphere Administrative console fromthe First steps console The login screen for the Administrative console opens in abrowser window as shown in Figure 12
Figure 12 Administrative console login screen
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 22 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2340
The Administrative console requires a Secure Sockets Layer (SSL) HTTPconnection generally referred to as a Hypertext Transfer Protocol over SecureSockets Layer (HTTPS) connection The page shown in Figure 12 only displays if avalid third-party SSL certificate is installed on your system If the system on whichyou installed WebSphere Application Server does not have a valid certificate issuedby a third party you will see a warning dialog like that shown in Figure 13 instead
Figure 13 Certificate not trusted alert
If you see this message see the next section of this tutorial for information about
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 23 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2440
configuring a security exception for your systems existing certificate
If you see the Administrative console login screen as shown in Figure 12 enter theadministrative username and password that you defined during the installationprocess and click Login or press Return The WebSphere Application Server
Administrative console displays as shown in Figure 14 You can explore or use theAdministrative console clicking the Logout link in the header when you are done
Figure 14 Administrative console
Configuring a certificate security exception
As discussed in the previous section the WebSphere Application ServerAdministrative console requires an SSL HTTP connection generally referred to asan HTTPS connection According to the default security policies used by mostsystems this means that the public key security certificate presented by your systemmust be a valid certificate issued by a trusted third-party certificate authority such asthawte VeriSign GeoTrust and many others See Resources for more informationabout these third-party certificate authorities
In a production environment you will certainly only want to use WebSphere
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 24 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2540
Application Server on a system with a valid enterprise or third-party securitycertificate so that users of your Web applications can verify the identity of the systemthat they are connecting to However you may be installing and configuringWebSphere Application Server on a new system for which you have not yet obtaineda certificate In this case you can temporarily or permanently define your existing
certificate as a trusted one that is an exception to the standard WebSphere securitypolicy
To define a policy exception click OK in the dialog shown in Figure 13 to display thescreen shown in Figure 15
Figure 15 A secure connection failure in Firefox
Click the Or you can define an exception link to begin the process of identifyingyour systems certificate as a valid digital public key certificate A screen identical to
the current screen displays with the exception of two additional buttons that displayat the bottom of the screen Click Add exception to continue the process of definingthe current certificate as an exception to the default certificate policy The dialogshown in Figure 16 displays
Note Clicking the Get me out of here button exits the exception definition processand returns you to your browser without establishing a connection to the WebSphere
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 25 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2640
Administrative console which isnt all that useful for the purposes of this tutorial
Figure 16 Initial dialog for defining a security exception
Click Get Certificate to retrieve your systems current certificate which displaysinformation about the current certificate and enables the Confirm Security
Exception button at the bottom left of the dialog shown in Figure 16 as shown inFigure 17
Figure 17 Updated dialog for defining a security exception
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 26 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 640
Thanks to its graphical installer installing WebSphere Application Server is quitesimple
Getting the installation files
If you want to evaluate WebSphere Application Server on a specific UNIX systemyou can request a copy for evaluation purposes from IBM Contact your IBM salesrepresentative for more information
A trial version of WebSphere Application Server for Linux systems is available as adownload or on the Linux Software Evaluation Kit (SEK) a set of four DVDscontaining evaluation products from IBM WebSphere IBM InformationManagementreg Lotusreg Rationalreg and Tivolireg that enable you to install andconfigure IBM middleware and start building and deploying applications Thesoftware 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 downloadedfile If you are installing WebSphere Application Server from the Linux SEK DVDsthe archive file containing the installable files for WebSphere Application Server arelocated on DVD 3 of the set The instructions for extracting the contents of thearchive file on your DVD are the same as those for extracting installable files from adownloaded file
Setting up unsupported Linux distributions
The Supported platforms section of this tutorial includes a list of the UNIX and Linuxplatforms on which WebSphere Application Server is officially supported Ascommercial products UNIX systems provide standard capabilities that can beguaranteed to be present for use by commercial products such as WebSphereApplication Server Unfortunately Linux distributions can be very different from eachother so WebSphere Application Server is only officially supported on certaindistributions However you can also run WebSphere Application Server on otherLinux 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 filesand beginning the installation section of this tutorial
For example not all Linux distributions include a version of the JRE that is suitablefor use by the WebSphere Application Server installer and certain WebSphereApplication Server functions On unsupported Linux distributions such as Ubuntuyou should download and install the IBM Java SDK for use during the installation
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 6 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 740
process See Resources for a link from which you can download the appropriateversion of the IBM Java SDK for your system After downloading this file you canextract its contents and install them using the following steps
1 Extract the contents of the archive file using a command like the following
tar zxvf filenametargz
Replace filename with the name of the IBM Java SDK archive file that youdownloaded which will be something likeibm-java-sdk-60-20-linux-x86_64targz The directory that is created bythe tar command will be something like ibm-java-x86_64-60
2 Use the sudo command to move the directory that was extracted from the
archive file to a system directory such as opt by using a command likethe following
mv DIRECTORY opt
Replace DIRECTORY with the name of the directory that was createdwhen you extracted the contents of the IBM Java SDK archive file thatyou downloaded
3 Modify the series of directories that your system searches for binaries byexecuting a command like the following
export PATH DIRECTORY$PATH
You should add this command to your shell startup file (~bashrc) toensure 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 thegeneric UNIXLinux shell binsh Ubuntu systems use a lightweight shell named
bindash as binsh but this shell does not provide all the capabilities required bythe WebSphere Application Server installation and startup scripts To use thestandard Bash shell as binsh execute the following commands on your Ubuntusystem before beginning the WebSphere Application Server installation process
sudo mv binsh binshORIGsudo ln -s binbash binsh
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 7 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 840
These steps are sufficient to enable you to begin the WebSphere Application Serverinstallation process on an Ubuntu system Other Linux distributions may requiresimilar changes
Extracting files and beginning the installation
After downloading or otherwise obtaining the archive file containing WebSphereApplication Server or mounting the Linux SEK DVD 3 when using a Linux systemcreate a directory in which to extract the files from which you can actually installWebSphere Application Server See Basic tasks for Linux Developers if you areunsure about how to mount your DVD or determine where it is mounted
The optWASTrial directory is the suggested location for extracting the files fromwhich you will install WebSphere Application Server To create this directory do the
following
1 Depending on the UNIX operating system or Linux distribution that isinstalled on the system where you are installing WebSphere ApplicationServer use the su or sudo -s commands to become a privileged useron your system Enter the root password or your password (respectively)when prompted to do so
2 Create the optWASTrial directory using the mkdir optWASTrial
command
3 Change directory to the optWASTrial directory
4 Use the tar command to extract the contents of the file that youdownloaded or the WebSphere Application Server archive file from themounted DVDIf you downloaded the file use a command like the following
tar zxvf pathtofilewascd7000trialbaselinuxia32targz
Replace pathtofile 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 acommand like the following
tar zxvf mountpointwas7uxtfilenametargz
Replace mountpoint with the name of the directory on which SEK DVD
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 8 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 940
3 is mounted and replace filename with the name of the WebSphereApplication Server archive file in that directory You may also have toreplace was7uxt with the name of the directory containing the Linuxarchive file if a different directory name was used in the latest SEK DVDreleases
5 Use the launchpadsh command to start the Firefox Web browserwhich displays the page shown in Figure 1Figure 1 Firefox Welcome page
Note If you are using Linux for your evaluation no 64-bit Linux version seems to beavailable for download See Supported platforms for information about how to usethe 32-bit Linux build on a 64-bit Linux system
Starting the installer
Click Launch the installation wizard for WebSphere Application Server Trial tobegin the actual installation process The graphical installer for WebSphereApplication Server begins and displays its welcome screen as shown in Figure 2
Figure 2 WebSphere Application Server installers welcome screen
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 9 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1040
The welcome screen shows that the graphical installer is working correctly andprovides links to online sites that provide information and support for WebSphereand related products
Click Next to proceed with the installation process
Accepting the license terms and checking your system
The next page of the graphical installer displays the license under which WebSphereApplication Server is released as shown in Figure 3
Figure 3 Accepting the IBM software license agreement
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 10 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1140
This license contains IBM licensing information for the evaluation version ofWebSphere Application Server and language that excludes open source softwarethat is distributed with IBM WebSphere Application Server from those terms andidentifies separately licensed software components
Select I accept the terms in the licensing agreement to accept the licensingterms Click Next to proceed with the installation process If you dont accept thelicense terms a window displays asking you to confirm that fact If you confirm thatyou do not accept the license terms the installer exits
The next page of the installer indicates whether your system satisfies theprerequisites for installation If your system does not satisfy requirements theinstaller may display information about any missing patches that you should installIn this case you can either click Cancel to exit the installer and install the missingprerequisites or simply proceed with the installation
Click Next to proceed with the installation process
Selecting optional features for installation
Figure 4 shows the installer screen that enables you to install optional software whileyou install WebSphere Application Server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 11 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1240
Figure 4 Selecting optional software for installation
Optional software that you can install consists of the following
bull Sample applications Source code and integrated applications for initial
experimentation The sample applications also serve as an excellentmechanism for verifying that WebSphere Application Server is installedcorrectly and is working properly on your system
bull Non-English language support for the administrative consoleLanguage catalogs that provide national language support for WebSphereApplication Servers administrative console These language catalogs donot provide national language support for WebSphere Application Serveritself which is available in a separate item on this screen
bull Non-English language support for WebSphere Application ServerLanguage catalogs that provide national language support for WebSphereApplication Server itself These language catalogs do not provide nationallanguage support for WebSphere Application Servers administrativeconsole which is available in a separate item on this screen
Unless you already have substantial experience with WebSphere Application Serveryou should install the sample applications to provide a way for you to learn moreabout application integration and deployment in the WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 12 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1340
environment
The default language package installed with WebSphere is English as spoken in theUnited States Whether or not you install the optional language packages dependson your geographic location and language support requirements The additional
languages that are supported by the administrative console and WebSphereApplication Server language support packs are Chinese Czech French GermanHungarian Italian Japanese Korean Polish Portuguese Russian and Spanish
After selecting any additional features that you want to install click Next to proceedwith the installation process
Identifying the target installation directory
Next the graphical installer displays the default location in which WebSphereApplication Server will be installed which is optIBMWebSphereAppServer onUNIX 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 installingWebSphere Application Server in non-standard locations can make local systemadministration more complex Non-standard installation locations may also cause
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 13 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1440
problems with WebSphere applications that may expect the standard installationlocation
Click Next to proceed with the installation process
Specifying the WebSphere Application Server environment
The screen shown in Figure 6 enables you to identify the type of WebSphereApplication 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 youare installing and integrating WebSphere Application Server The environment thatyou 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 choicesare the following
bull Management Select this option if you are installing this copy ofWebSphere Application Server to manage other application serverenvironments on the local machine or on other systems on your networkSelecting this option creates an appropriate profile and will install and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 14 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1540
configure an administrative agent server services for managing multipleapplication server environments and an administrative agent to manageother application servers that are on the same machine
bull Application server The default selection this option creates anappropriate profile for installing a stand-alone application server that will
run your enterprise applications and which can only be managed from itsown administrative console
bull None Select this option if you do not want to create an execution profileduring installation Only select this option if you will explicitly create one ormore profiles after WebSphere Application Server is successfully installedon your system
Click Next to proceed with the installation process
Note If you select None as your server execution environment a warning dialogdisplays to inform you that at least one functional profile must be available to runWebSphere Application Server Click Yes to proceed with the installation processwithout creating a profile during the installation process and proceed to Summarypage and actual installation If you want to create a profile during the installationprocess click No to return to the dialog shown in Figure 6 to modify your serverexecution environment setting
Creating an administrative user
The next screen of the installer shown in Figure 7 enables you to create a secureaccount on your system for system administration through the WebSphereApplication Server administrative console
Figure 7 Defining an administrative user
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 15 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1640
Create an administrative user if you are installing a stand-alone or managedWebSphere Application Servermdashin other words when you are installing WebSphereApplication Server in an environment that creates a profile for you during theinstallation process as described earlier in Specifying the WebSphere Application
Server environment
Enter a username and password for use in administering your WebSphereApplication Server and enter the password again to confirm that you typed itcorrectly the first time
If you selected the sample applications for installation in the Selecting optionalfeatures for installation section you will also be prompted to set a password for theuser associated with those sample applications Enter the password twice to ensurethat you have typed it correctly or have at least made the same typo twice
After supplying information about the administrative user (and optionally apassword for the sample applications if you selected them for installation) click Nextto proceed with the installation process
Summary page and actual installation
As shown in Figure 8 a summary screen displays the configuration options that you
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 16 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1740
have accepted or specified and provides a check box that enables you to verify thatyou 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 theresreally no need to verify that you have the required privileges Clear this check boxand click Next to begin the installation process A window displays showing thestatus of the installation process The installation process first creates an uninstallerfor WebSphere Application Server to simplify removing the software if necessary Itthen installs WebSphere Application Server displaying status information as theinstallation proceeds
Installation status and next steps
When the installation finishes the window shown in Figure 9 displays the success orfailure of installation If any errors occur this window shows the location of a log filethat you can examine to identify the problems and determine whether they weremeaningful
Figure 9 Summary information about your installation
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 17 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1840
This screen provides a check box that because it is selected by default starts theWebSphere Application Server First steps console when you exit the installer TheFirst steps console enables you to do some initial configuration of WebSphereApplication Server
At this point you have two options
bull Leave the Launch the First steps console check box selected and clickFinish to exit the installer and start the First steps console
bull Clear the Launch the First steps console check box and click Finish toexit the installer without starting the First steps console or WebSphereApplication Server
Congratulations Youve installed WebSphere Application Server If you started theFirst steps console proceed to the next section for information about using thatconsole Otherwise you may want to do one of the following
bull Start the WebSphere Application Server manually
bull Integrate WebSphere Application Server with your systems Web server
bull Integrate WebSphere Application Server into your systems startup and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 18 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1940
shutdown processes
bull Access the WebSphere administrative console to begin configuring yourWebSphere Application Server
Section 4 Using the First steps console
The WebSphere Application Server installation process can automatically start aFirst steps console to help you familiarize yourself with WebSphere ApplicationServer and perform some initial configuration tasks Figure 10 shows the initialscreen of the First steps console
Figure 10 First steps console
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 19 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2040
As shown in Figure 10 the First steps console provides links to a number ofconvenient tasks that you may want to perform immediately after installationincluding
bull Installation verification Checks your WebSphere Application Server
installation to verify that it is installed correctly and starts the applicationserver as part of this check
bull Start the Server Starts the WebSphere Application Server displayingthe output of the startup process in a separate window for convenienceand diagnostic purposes When the application server is running this linkchanges to a Stop the server link which provides a convenient way tostop the server and displays the output of the server shutdown process ina separate window Stopping the server requires the administrativepassword that you set during the installation process and provides aconvenient check that the application servers internal authentication
mechanism is working correctlybull Administrative console Starts the WebSphere Administrative console
in a browser window enabling you to perform configuration tasks that areoutside the scope of the installation process Starting the administrativeconsole also requires the administrative password that you set during theinstallation process
bull Profile management tool Enables you to create additional executionprofiles each of which can be for use with specific enterprise Webapplications port configurations and so on If you did not specify a targetserver environment during the installation process and are not migrating
server configuration information from an existing WebSphere ApplicationServer installation use this option to create at least one WebSphereApplication Server profile You cannot start WebSphere ApplicationServer without at least one profilemdasheach profile provides the configurationinformation required to start the application server in a specific context
bull Samples gallery Provides access to the sample applications youinstalled during the installation process
bull Information center for WebSphere Application Server Opens theWebSphere Application Server Library Web site in a browser to providedetailed information about WebSphere Application Server in a variety of
enterprise application scenarios
bull Migration wizard Starts a wizard that simplifies migrating configurationinformation and applications from earlier versions of WebSphereApplication Server
The next few sections provide highlights of using selected options from the Firststeps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 20 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2140
Installation verification
Though error messages would have displayed had any problems occurred duringthe WebSphere Application Server installation process its always comforting to be
able to double-check that your application server installation is complete and that allthe necessary configuration files were created correctly during that process
To verify that WebSphere Application Server was installed correctly on your systemand start it as part of the testing process click the Installation verification link inthe First steps console A window like the one shown in Figure 11 displays
Figure 11 Output of the verification process
As you can see from this figure the verification process first starts the applicationserver with your default profile and then connects to the application server to verifythe Servlet engine JavaServer pages and enterprise bean configuration It thenexamines the authentication of the key stores that are used to provide secureconnections between WebSphere components
When the verification process completes you can click the close button in the upperright-hand corner of the output window to close that window and return to the Firststeps console Note that the Start the server link has been replaced by a Stop the
server link because the WebSphere Application Server was started as part of theverification process
Starting the server
If you choose not to verify your WebSphere Application Server installation as
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 21 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2240
described in the previous section you can start the WebSphere Application Servermanually by clicking the Start the server link in the First steps console Clicking thislink displays an output window much like the one shown in Figure 11 except that itonly shows the initial text about starting the server and does not probe theconfiguration of your server
Note If the First steps console does not show a Start the server link but insteaddisplays only a Stop the server link your WebSphere Application Server is alreadyrunning
After a line like ADMU3000I Server NAME open for e-business
displays in the output window you can click the close box in the upper right-handcorner of the output window to close that window and return to the First stepsconsole
Administrative consoleThe WebSphere Application Server Administrative console is the primarymechanism for configuring the application server integrating the application serverwith external applications such as database systems and installing WebSphereapplications If you are new to WebSphere Application Server and want to explorethe administrative console or want to install new WebSphere applicationsimmediately after installing WebSphere you may want to start the Administrativeconsole from the First steps console
Click Administrative console to start the WebSphere Administrative console fromthe First steps console The login screen for the Administrative console opens in abrowser window as shown in Figure 12
Figure 12 Administrative console login screen
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 22 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2340
The Administrative console requires a Secure Sockets Layer (SSL) HTTPconnection generally referred to as a Hypertext Transfer Protocol over SecureSockets Layer (HTTPS) connection The page shown in Figure 12 only displays if avalid third-party SSL certificate is installed on your system If the system on whichyou installed WebSphere Application Server does not have a valid certificate issuedby a third party you will see a warning dialog like that shown in Figure 13 instead
Figure 13 Certificate not trusted alert
If you see this message see the next section of this tutorial for information about
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 23 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2440
configuring a security exception for your systems existing certificate
If you see the Administrative console login screen as shown in Figure 12 enter theadministrative username and password that you defined during the installationprocess and click Login or press Return The WebSphere Application Server
Administrative console displays as shown in Figure 14 You can explore or use theAdministrative console clicking the Logout link in the header when you are done
Figure 14 Administrative console
Configuring a certificate security exception
As discussed in the previous section the WebSphere Application ServerAdministrative console requires an SSL HTTP connection generally referred to asan HTTPS connection According to the default security policies used by mostsystems this means that the public key security certificate presented by your systemmust be a valid certificate issued by a trusted third-party certificate authority such asthawte VeriSign GeoTrust and many others See Resources for more informationabout these third-party certificate authorities
In a production environment you will certainly only want to use WebSphere
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 24 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2540
Application Server on a system with a valid enterprise or third-party securitycertificate so that users of your Web applications can verify the identity of the systemthat they are connecting to However you may be installing and configuringWebSphere Application Server on a new system for which you have not yet obtaineda certificate In this case you can temporarily or permanently define your existing
certificate as a trusted one that is an exception to the standard WebSphere securitypolicy
To define a policy exception click OK in the dialog shown in Figure 13 to display thescreen shown in Figure 15
Figure 15 A secure connection failure in Firefox
Click the Or you can define an exception link to begin the process of identifyingyour systems certificate as a valid digital public key certificate A screen identical to
the current screen displays with the exception of two additional buttons that displayat the bottom of the screen Click Add exception to continue the process of definingthe current certificate as an exception to the default certificate policy The dialogshown in Figure 16 displays
Note Clicking the Get me out of here button exits the exception definition processand returns you to your browser without establishing a connection to the WebSphere
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 25 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2640
Administrative console which isnt all that useful for the purposes of this tutorial
Figure 16 Initial dialog for defining a security exception
Click Get Certificate to retrieve your systems current certificate which displaysinformation about the current certificate and enables the Confirm Security
Exception button at the bottom left of the dialog shown in Figure 16 as shown inFigure 17
Figure 17 Updated dialog for defining a security exception
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 26 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 740
process See Resources for a link from which you can download the appropriateversion of the IBM Java SDK for your system After downloading this file you canextract its contents and install them using the following steps
1 Extract the contents of the archive file using a command like the following
tar zxvf filenametargz
Replace filename with the name of the IBM Java SDK archive file that youdownloaded which will be something likeibm-java-sdk-60-20-linux-x86_64targz The directory that is created bythe tar command will be something like ibm-java-x86_64-60
2 Use the sudo command to move the directory that was extracted from the
archive file to a system directory such as opt by using a command likethe following
mv DIRECTORY opt
Replace DIRECTORY with the name of the directory that was createdwhen you extracted the contents of the IBM Java SDK archive file thatyou downloaded
3 Modify the series of directories that your system searches for binaries byexecuting a command like the following
export PATH DIRECTORY$PATH
You should add this command to your shell startup file (~bashrc) toensure 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 thegeneric UNIXLinux shell binsh Ubuntu systems use a lightweight shell named
bindash as binsh but this shell does not provide all the capabilities required bythe WebSphere Application Server installation and startup scripts To use thestandard Bash shell as binsh execute the following commands on your Ubuntusystem before beginning the WebSphere Application Server installation process
sudo mv binsh binshORIGsudo ln -s binbash binsh
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 7 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 840
These steps are sufficient to enable you to begin the WebSphere Application Serverinstallation process on an Ubuntu system Other Linux distributions may requiresimilar changes
Extracting files and beginning the installation
After downloading or otherwise obtaining the archive file containing WebSphereApplication Server or mounting the Linux SEK DVD 3 when using a Linux systemcreate a directory in which to extract the files from which you can actually installWebSphere Application Server See Basic tasks for Linux Developers if you areunsure about how to mount your DVD or determine where it is mounted
The optWASTrial directory is the suggested location for extracting the files fromwhich you will install WebSphere Application Server To create this directory do the
following
1 Depending on the UNIX operating system or Linux distribution that isinstalled on the system where you are installing WebSphere ApplicationServer use the su or sudo -s commands to become a privileged useron your system Enter the root password or your password (respectively)when prompted to do so
2 Create the optWASTrial directory using the mkdir optWASTrial
command
3 Change directory to the optWASTrial directory
4 Use the tar command to extract the contents of the file that youdownloaded or the WebSphere Application Server archive file from themounted DVDIf you downloaded the file use a command like the following
tar zxvf pathtofilewascd7000trialbaselinuxia32targz
Replace pathtofile 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 acommand like the following
tar zxvf mountpointwas7uxtfilenametargz
Replace mountpoint with the name of the directory on which SEK DVD
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 8 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 940
3 is mounted and replace filename with the name of the WebSphereApplication Server archive file in that directory You may also have toreplace was7uxt with the name of the directory containing the Linuxarchive file if a different directory name was used in the latest SEK DVDreleases
5 Use the launchpadsh command to start the Firefox Web browserwhich displays the page shown in Figure 1Figure 1 Firefox Welcome page
Note If you are using Linux for your evaluation no 64-bit Linux version seems to beavailable for download See Supported platforms for information about how to usethe 32-bit Linux build on a 64-bit Linux system
Starting the installer
Click Launch the installation wizard for WebSphere Application Server Trial tobegin the actual installation process The graphical installer for WebSphereApplication Server begins and displays its welcome screen as shown in Figure 2
Figure 2 WebSphere Application Server installers welcome screen
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 9 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1040
The welcome screen shows that the graphical installer is working correctly andprovides links to online sites that provide information and support for WebSphereand related products
Click Next to proceed with the installation process
Accepting the license terms and checking your system
The next page of the graphical installer displays the license under which WebSphereApplication Server is released as shown in Figure 3
Figure 3 Accepting the IBM software license agreement
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 10 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1140
This license contains IBM licensing information for the evaluation version ofWebSphere Application Server and language that excludes open source softwarethat is distributed with IBM WebSphere Application Server from those terms andidentifies separately licensed software components
Select I accept the terms in the licensing agreement to accept the licensingterms Click Next to proceed with the installation process If you dont accept thelicense terms a window displays asking you to confirm that fact If you confirm thatyou do not accept the license terms the installer exits
The next page of the installer indicates whether your system satisfies theprerequisites for installation If your system does not satisfy requirements theinstaller may display information about any missing patches that you should installIn this case you can either click Cancel to exit the installer and install the missingprerequisites or simply proceed with the installation
Click Next to proceed with the installation process
Selecting optional features for installation
Figure 4 shows the installer screen that enables you to install optional software whileyou install WebSphere Application Server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 11 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1240
Figure 4 Selecting optional software for installation
Optional software that you can install consists of the following
bull Sample applications Source code and integrated applications for initial
experimentation The sample applications also serve as an excellentmechanism for verifying that WebSphere Application Server is installedcorrectly and is working properly on your system
bull Non-English language support for the administrative consoleLanguage catalogs that provide national language support for WebSphereApplication Servers administrative console These language catalogs donot provide national language support for WebSphere Application Serveritself which is available in a separate item on this screen
bull Non-English language support for WebSphere Application ServerLanguage catalogs that provide national language support for WebSphereApplication Server itself These language catalogs do not provide nationallanguage support for WebSphere Application Servers administrativeconsole which is available in a separate item on this screen
Unless you already have substantial experience with WebSphere Application Serveryou should install the sample applications to provide a way for you to learn moreabout application integration and deployment in the WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 12 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1340
environment
The default language package installed with WebSphere is English as spoken in theUnited States Whether or not you install the optional language packages dependson your geographic location and language support requirements The additional
languages that are supported by the administrative console and WebSphereApplication Server language support packs are Chinese Czech French GermanHungarian Italian Japanese Korean Polish Portuguese Russian and Spanish
After selecting any additional features that you want to install click Next to proceedwith the installation process
Identifying the target installation directory
Next the graphical installer displays the default location in which WebSphereApplication Server will be installed which is optIBMWebSphereAppServer onUNIX 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 installingWebSphere Application Server in non-standard locations can make local systemadministration more complex Non-standard installation locations may also cause
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 13 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1440
problems with WebSphere applications that may expect the standard installationlocation
Click Next to proceed with the installation process
Specifying the WebSphere Application Server environment
The screen shown in Figure 6 enables you to identify the type of WebSphereApplication 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 youare installing and integrating WebSphere Application Server The environment thatyou 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 choicesare the following
bull Management Select this option if you are installing this copy ofWebSphere Application Server to manage other application serverenvironments on the local machine or on other systems on your networkSelecting this option creates an appropriate profile and will install and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 14 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1540
configure an administrative agent server services for managing multipleapplication server environments and an administrative agent to manageother application servers that are on the same machine
bull Application server The default selection this option creates anappropriate profile for installing a stand-alone application server that will
run your enterprise applications and which can only be managed from itsown administrative console
bull None Select this option if you do not want to create an execution profileduring installation Only select this option if you will explicitly create one ormore profiles after WebSphere Application Server is successfully installedon your system
Click Next to proceed with the installation process
Note If you select None as your server execution environment a warning dialogdisplays to inform you that at least one functional profile must be available to runWebSphere Application Server Click Yes to proceed with the installation processwithout creating a profile during the installation process and proceed to Summarypage and actual installation If you want to create a profile during the installationprocess click No to return to the dialog shown in Figure 6 to modify your serverexecution environment setting
Creating an administrative user
The next screen of the installer shown in Figure 7 enables you to create a secureaccount on your system for system administration through the WebSphereApplication Server administrative console
Figure 7 Defining an administrative user
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 15 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1640
Create an administrative user if you are installing a stand-alone or managedWebSphere Application Servermdashin other words when you are installing WebSphereApplication Server in an environment that creates a profile for you during theinstallation process as described earlier in Specifying the WebSphere Application
Server environment
Enter a username and password for use in administering your WebSphereApplication Server and enter the password again to confirm that you typed itcorrectly the first time
If you selected the sample applications for installation in the Selecting optionalfeatures for installation section you will also be prompted to set a password for theuser associated with those sample applications Enter the password twice to ensurethat you have typed it correctly or have at least made the same typo twice
After supplying information about the administrative user (and optionally apassword for the sample applications if you selected them for installation) click Nextto proceed with the installation process
Summary page and actual installation
As shown in Figure 8 a summary screen displays the configuration options that you
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 16 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1740
have accepted or specified and provides a check box that enables you to verify thatyou 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 theresreally no need to verify that you have the required privileges Clear this check boxand click Next to begin the installation process A window displays showing thestatus of the installation process The installation process first creates an uninstallerfor WebSphere Application Server to simplify removing the software if necessary Itthen installs WebSphere Application Server displaying status information as theinstallation proceeds
Installation status and next steps
When the installation finishes the window shown in Figure 9 displays the success orfailure of installation If any errors occur this window shows the location of a log filethat you can examine to identify the problems and determine whether they weremeaningful
Figure 9 Summary information about your installation
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 17 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1840
This screen provides a check box that because it is selected by default starts theWebSphere Application Server First steps console when you exit the installer TheFirst steps console enables you to do some initial configuration of WebSphereApplication Server
At this point you have two options
bull Leave the Launch the First steps console check box selected and clickFinish to exit the installer and start the First steps console
bull Clear the Launch the First steps console check box and click Finish toexit the installer without starting the First steps console or WebSphereApplication Server
Congratulations Youve installed WebSphere Application Server If you started theFirst steps console proceed to the next section for information about using thatconsole Otherwise you may want to do one of the following
bull Start the WebSphere Application Server manually
bull Integrate WebSphere Application Server with your systems Web server
bull Integrate WebSphere Application Server into your systems startup and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 18 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1940
shutdown processes
bull Access the WebSphere administrative console to begin configuring yourWebSphere Application Server
Section 4 Using the First steps console
The WebSphere Application Server installation process can automatically start aFirst steps console to help you familiarize yourself with WebSphere ApplicationServer and perform some initial configuration tasks Figure 10 shows the initialscreen of the First steps console
Figure 10 First steps console
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 19 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2040
As shown in Figure 10 the First steps console provides links to a number ofconvenient tasks that you may want to perform immediately after installationincluding
bull Installation verification Checks your WebSphere Application Server
installation to verify that it is installed correctly and starts the applicationserver as part of this check
bull Start the Server Starts the WebSphere Application Server displayingthe output of the startup process in a separate window for convenienceand diagnostic purposes When the application server is running this linkchanges to a Stop the server link which provides a convenient way tostop the server and displays the output of the server shutdown process ina separate window Stopping the server requires the administrativepassword that you set during the installation process and provides aconvenient check that the application servers internal authentication
mechanism is working correctlybull Administrative console Starts the WebSphere Administrative console
in a browser window enabling you to perform configuration tasks that areoutside the scope of the installation process Starting the administrativeconsole also requires the administrative password that you set during theinstallation process
bull Profile management tool Enables you to create additional executionprofiles each of which can be for use with specific enterprise Webapplications port configurations and so on If you did not specify a targetserver environment during the installation process and are not migrating
server configuration information from an existing WebSphere ApplicationServer installation use this option to create at least one WebSphereApplication Server profile You cannot start WebSphere ApplicationServer without at least one profilemdasheach profile provides the configurationinformation required to start the application server in a specific context
bull Samples gallery Provides access to the sample applications youinstalled during the installation process
bull Information center for WebSphere Application Server Opens theWebSphere Application Server Library Web site in a browser to providedetailed information about WebSphere Application Server in a variety of
enterprise application scenarios
bull Migration wizard Starts a wizard that simplifies migrating configurationinformation and applications from earlier versions of WebSphereApplication Server
The next few sections provide highlights of using selected options from the Firststeps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 20 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2140
Installation verification
Though error messages would have displayed had any problems occurred duringthe WebSphere Application Server installation process its always comforting to be
able to double-check that your application server installation is complete and that allthe necessary configuration files were created correctly during that process
To verify that WebSphere Application Server was installed correctly on your systemand start it as part of the testing process click the Installation verification link inthe First steps console A window like the one shown in Figure 11 displays
Figure 11 Output of the verification process
As you can see from this figure the verification process first starts the applicationserver with your default profile and then connects to the application server to verifythe Servlet engine JavaServer pages and enterprise bean configuration It thenexamines the authentication of the key stores that are used to provide secureconnections between WebSphere components
When the verification process completes you can click the close button in the upperright-hand corner of the output window to close that window and return to the Firststeps console Note that the Start the server link has been replaced by a Stop the
server link because the WebSphere Application Server was started as part of theverification process
Starting the server
If you choose not to verify your WebSphere Application Server installation as
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 21 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2240
described in the previous section you can start the WebSphere Application Servermanually by clicking the Start the server link in the First steps console Clicking thislink displays an output window much like the one shown in Figure 11 except that itonly shows the initial text about starting the server and does not probe theconfiguration of your server
Note If the First steps console does not show a Start the server link but insteaddisplays only a Stop the server link your WebSphere Application Server is alreadyrunning
After a line like ADMU3000I Server NAME open for e-business
displays in the output window you can click the close box in the upper right-handcorner of the output window to close that window and return to the First stepsconsole
Administrative consoleThe WebSphere Application Server Administrative console is the primarymechanism for configuring the application server integrating the application serverwith external applications such as database systems and installing WebSphereapplications If you are new to WebSphere Application Server and want to explorethe administrative console or want to install new WebSphere applicationsimmediately after installing WebSphere you may want to start the Administrativeconsole from the First steps console
Click Administrative console to start the WebSphere Administrative console fromthe First steps console The login screen for the Administrative console opens in abrowser window as shown in Figure 12
Figure 12 Administrative console login screen
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 22 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2340
The Administrative console requires a Secure Sockets Layer (SSL) HTTPconnection generally referred to as a Hypertext Transfer Protocol over SecureSockets Layer (HTTPS) connection The page shown in Figure 12 only displays if avalid third-party SSL certificate is installed on your system If the system on whichyou installed WebSphere Application Server does not have a valid certificate issuedby a third party you will see a warning dialog like that shown in Figure 13 instead
Figure 13 Certificate not trusted alert
If you see this message see the next section of this tutorial for information about
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 23 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2440
configuring a security exception for your systems existing certificate
If you see the Administrative console login screen as shown in Figure 12 enter theadministrative username and password that you defined during the installationprocess and click Login or press Return The WebSphere Application Server
Administrative console displays as shown in Figure 14 You can explore or use theAdministrative console clicking the Logout link in the header when you are done
Figure 14 Administrative console
Configuring a certificate security exception
As discussed in the previous section the WebSphere Application ServerAdministrative console requires an SSL HTTP connection generally referred to asan HTTPS connection According to the default security policies used by mostsystems this means that the public key security certificate presented by your systemmust be a valid certificate issued by a trusted third-party certificate authority such asthawte VeriSign GeoTrust and many others See Resources for more informationabout these third-party certificate authorities
In a production environment you will certainly only want to use WebSphere
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 24 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2540
Application Server on a system with a valid enterprise or third-party securitycertificate so that users of your Web applications can verify the identity of the systemthat they are connecting to However you may be installing and configuringWebSphere Application Server on a new system for which you have not yet obtaineda certificate In this case you can temporarily or permanently define your existing
certificate as a trusted one that is an exception to the standard WebSphere securitypolicy
To define a policy exception click OK in the dialog shown in Figure 13 to display thescreen shown in Figure 15
Figure 15 A secure connection failure in Firefox
Click the Or you can define an exception link to begin the process of identifyingyour systems certificate as a valid digital public key certificate A screen identical to
the current screen displays with the exception of two additional buttons that displayat the bottom of the screen Click Add exception to continue the process of definingthe current certificate as an exception to the default certificate policy The dialogshown in Figure 16 displays
Note Clicking the Get me out of here button exits the exception definition processand returns you to your browser without establishing a connection to the WebSphere
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 25 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2640
Administrative console which isnt all that useful for the purposes of this tutorial
Figure 16 Initial dialog for defining a security exception
Click Get Certificate to retrieve your systems current certificate which displaysinformation about the current certificate and enables the Confirm Security
Exception button at the bottom left of the dialog shown in Figure 16 as shown inFigure 17
Figure 17 Updated dialog for defining a security exception
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 26 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 840
These steps are sufficient to enable you to begin the WebSphere Application Serverinstallation process on an Ubuntu system Other Linux distributions may requiresimilar changes
Extracting files and beginning the installation
After downloading or otherwise obtaining the archive file containing WebSphereApplication Server or mounting the Linux SEK DVD 3 when using a Linux systemcreate a directory in which to extract the files from which you can actually installWebSphere Application Server See Basic tasks for Linux Developers if you areunsure about how to mount your DVD or determine where it is mounted
The optWASTrial directory is the suggested location for extracting the files fromwhich you will install WebSphere Application Server To create this directory do the
following
1 Depending on the UNIX operating system or Linux distribution that isinstalled on the system where you are installing WebSphere ApplicationServer use the su or sudo -s commands to become a privileged useron your system Enter the root password or your password (respectively)when prompted to do so
2 Create the optWASTrial directory using the mkdir optWASTrial
command
3 Change directory to the optWASTrial directory
4 Use the tar command to extract the contents of the file that youdownloaded or the WebSphere Application Server archive file from themounted DVDIf you downloaded the file use a command like the following
tar zxvf pathtofilewascd7000trialbaselinuxia32targz
Replace pathtofile 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 acommand like the following
tar zxvf mountpointwas7uxtfilenametargz
Replace mountpoint with the name of the directory on which SEK DVD
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 8 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 940
3 is mounted and replace filename with the name of the WebSphereApplication Server archive file in that directory You may also have toreplace was7uxt with the name of the directory containing the Linuxarchive file if a different directory name was used in the latest SEK DVDreleases
5 Use the launchpadsh command to start the Firefox Web browserwhich displays the page shown in Figure 1Figure 1 Firefox Welcome page
Note If you are using Linux for your evaluation no 64-bit Linux version seems to beavailable for download See Supported platforms for information about how to usethe 32-bit Linux build on a 64-bit Linux system
Starting the installer
Click Launch the installation wizard for WebSphere Application Server Trial tobegin the actual installation process The graphical installer for WebSphereApplication Server begins and displays its welcome screen as shown in Figure 2
Figure 2 WebSphere Application Server installers welcome screen
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 9 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1040
The welcome screen shows that the graphical installer is working correctly andprovides links to online sites that provide information and support for WebSphereand related products
Click Next to proceed with the installation process
Accepting the license terms and checking your system
The next page of the graphical installer displays the license under which WebSphereApplication Server is released as shown in Figure 3
Figure 3 Accepting the IBM software license agreement
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 10 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1140
This license contains IBM licensing information for the evaluation version ofWebSphere Application Server and language that excludes open source softwarethat is distributed with IBM WebSphere Application Server from those terms andidentifies separately licensed software components
Select I accept the terms in the licensing agreement to accept the licensingterms Click Next to proceed with the installation process If you dont accept thelicense terms a window displays asking you to confirm that fact If you confirm thatyou do not accept the license terms the installer exits
The next page of the installer indicates whether your system satisfies theprerequisites for installation If your system does not satisfy requirements theinstaller may display information about any missing patches that you should installIn this case you can either click Cancel to exit the installer and install the missingprerequisites or simply proceed with the installation
Click Next to proceed with the installation process
Selecting optional features for installation
Figure 4 shows the installer screen that enables you to install optional software whileyou install WebSphere Application Server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 11 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1240
Figure 4 Selecting optional software for installation
Optional software that you can install consists of the following
bull Sample applications Source code and integrated applications for initial
experimentation The sample applications also serve as an excellentmechanism for verifying that WebSphere Application Server is installedcorrectly and is working properly on your system
bull Non-English language support for the administrative consoleLanguage catalogs that provide national language support for WebSphereApplication Servers administrative console These language catalogs donot provide national language support for WebSphere Application Serveritself which is available in a separate item on this screen
bull Non-English language support for WebSphere Application ServerLanguage catalogs that provide national language support for WebSphereApplication Server itself These language catalogs do not provide nationallanguage support for WebSphere Application Servers administrativeconsole which is available in a separate item on this screen
Unless you already have substantial experience with WebSphere Application Serveryou should install the sample applications to provide a way for you to learn moreabout application integration and deployment in the WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 12 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1340
environment
The default language package installed with WebSphere is English as spoken in theUnited States Whether or not you install the optional language packages dependson your geographic location and language support requirements The additional
languages that are supported by the administrative console and WebSphereApplication Server language support packs are Chinese Czech French GermanHungarian Italian Japanese Korean Polish Portuguese Russian and Spanish
After selecting any additional features that you want to install click Next to proceedwith the installation process
Identifying the target installation directory
Next the graphical installer displays the default location in which WebSphereApplication Server will be installed which is optIBMWebSphereAppServer onUNIX 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 installingWebSphere Application Server in non-standard locations can make local systemadministration more complex Non-standard installation locations may also cause
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 13 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1440
problems with WebSphere applications that may expect the standard installationlocation
Click Next to proceed with the installation process
Specifying the WebSphere Application Server environment
The screen shown in Figure 6 enables you to identify the type of WebSphereApplication 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 youare installing and integrating WebSphere Application Server The environment thatyou 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 choicesare the following
bull Management Select this option if you are installing this copy ofWebSphere Application Server to manage other application serverenvironments on the local machine or on other systems on your networkSelecting this option creates an appropriate profile and will install and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 14 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1540
configure an administrative agent server services for managing multipleapplication server environments and an administrative agent to manageother application servers that are on the same machine
bull Application server The default selection this option creates anappropriate profile for installing a stand-alone application server that will
run your enterprise applications and which can only be managed from itsown administrative console
bull None Select this option if you do not want to create an execution profileduring installation Only select this option if you will explicitly create one ormore profiles after WebSphere Application Server is successfully installedon your system
Click Next to proceed with the installation process
Note If you select None as your server execution environment a warning dialogdisplays to inform you that at least one functional profile must be available to runWebSphere Application Server Click Yes to proceed with the installation processwithout creating a profile during the installation process and proceed to Summarypage and actual installation If you want to create a profile during the installationprocess click No to return to the dialog shown in Figure 6 to modify your serverexecution environment setting
Creating an administrative user
The next screen of the installer shown in Figure 7 enables you to create a secureaccount on your system for system administration through the WebSphereApplication Server administrative console
Figure 7 Defining an administrative user
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 15 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1640
Create an administrative user if you are installing a stand-alone or managedWebSphere Application Servermdashin other words when you are installing WebSphereApplication Server in an environment that creates a profile for you during theinstallation process as described earlier in Specifying the WebSphere Application
Server environment
Enter a username and password for use in administering your WebSphereApplication Server and enter the password again to confirm that you typed itcorrectly the first time
If you selected the sample applications for installation in the Selecting optionalfeatures for installation section you will also be prompted to set a password for theuser associated with those sample applications Enter the password twice to ensurethat you have typed it correctly or have at least made the same typo twice
After supplying information about the administrative user (and optionally apassword for the sample applications if you selected them for installation) click Nextto proceed with the installation process
Summary page and actual installation
As shown in Figure 8 a summary screen displays the configuration options that you
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 16 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1740
have accepted or specified and provides a check box that enables you to verify thatyou 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 theresreally no need to verify that you have the required privileges Clear this check boxand click Next to begin the installation process A window displays showing thestatus of the installation process The installation process first creates an uninstallerfor WebSphere Application Server to simplify removing the software if necessary Itthen installs WebSphere Application Server displaying status information as theinstallation proceeds
Installation status and next steps
When the installation finishes the window shown in Figure 9 displays the success orfailure of installation If any errors occur this window shows the location of a log filethat you can examine to identify the problems and determine whether they weremeaningful
Figure 9 Summary information about your installation
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 17 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1840
This screen provides a check box that because it is selected by default starts theWebSphere Application Server First steps console when you exit the installer TheFirst steps console enables you to do some initial configuration of WebSphereApplication Server
At this point you have two options
bull Leave the Launch the First steps console check box selected and clickFinish to exit the installer and start the First steps console
bull Clear the Launch the First steps console check box and click Finish toexit the installer without starting the First steps console or WebSphereApplication Server
Congratulations Youve installed WebSphere Application Server If you started theFirst steps console proceed to the next section for information about using thatconsole Otherwise you may want to do one of the following
bull Start the WebSphere Application Server manually
bull Integrate WebSphere Application Server with your systems Web server
bull Integrate WebSphere Application Server into your systems startup and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 18 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1940
shutdown processes
bull Access the WebSphere administrative console to begin configuring yourWebSphere Application Server
Section 4 Using the First steps console
The WebSphere Application Server installation process can automatically start aFirst steps console to help you familiarize yourself with WebSphere ApplicationServer and perform some initial configuration tasks Figure 10 shows the initialscreen of the First steps console
Figure 10 First steps console
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 19 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2040
As shown in Figure 10 the First steps console provides links to a number ofconvenient tasks that you may want to perform immediately after installationincluding
bull Installation verification Checks your WebSphere Application Server
installation to verify that it is installed correctly and starts the applicationserver as part of this check
bull Start the Server Starts the WebSphere Application Server displayingthe output of the startup process in a separate window for convenienceand diagnostic purposes When the application server is running this linkchanges to a Stop the server link which provides a convenient way tostop the server and displays the output of the server shutdown process ina separate window Stopping the server requires the administrativepassword that you set during the installation process and provides aconvenient check that the application servers internal authentication
mechanism is working correctlybull Administrative console Starts the WebSphere Administrative console
in a browser window enabling you to perform configuration tasks that areoutside the scope of the installation process Starting the administrativeconsole also requires the administrative password that you set during theinstallation process
bull Profile management tool Enables you to create additional executionprofiles each of which can be for use with specific enterprise Webapplications port configurations and so on If you did not specify a targetserver environment during the installation process and are not migrating
server configuration information from an existing WebSphere ApplicationServer installation use this option to create at least one WebSphereApplication Server profile You cannot start WebSphere ApplicationServer without at least one profilemdasheach profile provides the configurationinformation required to start the application server in a specific context
bull Samples gallery Provides access to the sample applications youinstalled during the installation process
bull Information center for WebSphere Application Server Opens theWebSphere Application Server Library Web site in a browser to providedetailed information about WebSphere Application Server in a variety of
enterprise application scenarios
bull Migration wizard Starts a wizard that simplifies migrating configurationinformation and applications from earlier versions of WebSphereApplication Server
The next few sections provide highlights of using selected options from the Firststeps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 20 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2140
Installation verification
Though error messages would have displayed had any problems occurred duringthe WebSphere Application Server installation process its always comforting to be
able to double-check that your application server installation is complete and that allthe necessary configuration files were created correctly during that process
To verify that WebSphere Application Server was installed correctly on your systemand start it as part of the testing process click the Installation verification link inthe First steps console A window like the one shown in Figure 11 displays
Figure 11 Output of the verification process
As you can see from this figure the verification process first starts the applicationserver with your default profile and then connects to the application server to verifythe Servlet engine JavaServer pages and enterprise bean configuration It thenexamines the authentication of the key stores that are used to provide secureconnections between WebSphere components
When the verification process completes you can click the close button in the upperright-hand corner of the output window to close that window and return to the Firststeps console Note that the Start the server link has been replaced by a Stop the
server link because the WebSphere Application Server was started as part of theverification process
Starting the server
If you choose not to verify your WebSphere Application Server installation as
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 21 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2240
described in the previous section you can start the WebSphere Application Servermanually by clicking the Start the server link in the First steps console Clicking thislink displays an output window much like the one shown in Figure 11 except that itonly shows the initial text about starting the server and does not probe theconfiguration of your server
Note If the First steps console does not show a Start the server link but insteaddisplays only a Stop the server link your WebSphere Application Server is alreadyrunning
After a line like ADMU3000I Server NAME open for e-business
displays in the output window you can click the close box in the upper right-handcorner of the output window to close that window and return to the First stepsconsole
Administrative consoleThe WebSphere Application Server Administrative console is the primarymechanism for configuring the application server integrating the application serverwith external applications such as database systems and installing WebSphereapplications If you are new to WebSphere Application Server and want to explorethe administrative console or want to install new WebSphere applicationsimmediately after installing WebSphere you may want to start the Administrativeconsole from the First steps console
Click Administrative console to start the WebSphere Administrative console fromthe First steps console The login screen for the Administrative console opens in abrowser window as shown in Figure 12
Figure 12 Administrative console login screen
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 22 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2340
The Administrative console requires a Secure Sockets Layer (SSL) HTTPconnection generally referred to as a Hypertext Transfer Protocol over SecureSockets Layer (HTTPS) connection The page shown in Figure 12 only displays if avalid third-party SSL certificate is installed on your system If the system on whichyou installed WebSphere Application Server does not have a valid certificate issuedby a third party you will see a warning dialog like that shown in Figure 13 instead
Figure 13 Certificate not trusted alert
If you see this message see the next section of this tutorial for information about
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 23 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2440
configuring a security exception for your systems existing certificate
If you see the Administrative console login screen as shown in Figure 12 enter theadministrative username and password that you defined during the installationprocess and click Login or press Return The WebSphere Application Server
Administrative console displays as shown in Figure 14 You can explore or use theAdministrative console clicking the Logout link in the header when you are done
Figure 14 Administrative console
Configuring a certificate security exception
As discussed in the previous section the WebSphere Application ServerAdministrative console requires an SSL HTTP connection generally referred to asan HTTPS connection According to the default security policies used by mostsystems this means that the public key security certificate presented by your systemmust be a valid certificate issued by a trusted third-party certificate authority such asthawte VeriSign GeoTrust and many others See Resources for more informationabout these third-party certificate authorities
In a production environment you will certainly only want to use WebSphere
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 24 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2540
Application Server on a system with a valid enterprise or third-party securitycertificate so that users of your Web applications can verify the identity of the systemthat they are connecting to However you may be installing and configuringWebSphere Application Server on a new system for which you have not yet obtaineda certificate In this case you can temporarily or permanently define your existing
certificate as a trusted one that is an exception to the standard WebSphere securitypolicy
To define a policy exception click OK in the dialog shown in Figure 13 to display thescreen shown in Figure 15
Figure 15 A secure connection failure in Firefox
Click the Or you can define an exception link to begin the process of identifyingyour systems certificate as a valid digital public key certificate A screen identical to
the current screen displays with the exception of two additional buttons that displayat the bottom of the screen Click Add exception to continue the process of definingthe current certificate as an exception to the default certificate policy The dialogshown in Figure 16 displays
Note Clicking the Get me out of here button exits the exception definition processand returns you to your browser without establishing a connection to the WebSphere
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 25 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2640
Administrative console which isnt all that useful for the purposes of this tutorial
Figure 16 Initial dialog for defining a security exception
Click Get Certificate to retrieve your systems current certificate which displaysinformation about the current certificate and enables the Confirm Security
Exception button at the bottom left of the dialog shown in Figure 16 as shown inFigure 17
Figure 17 Updated dialog for defining a security exception
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 26 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 940
3 is mounted and replace filename with the name of the WebSphereApplication Server archive file in that directory You may also have toreplace was7uxt with the name of the directory containing the Linuxarchive file if a different directory name was used in the latest SEK DVDreleases
5 Use the launchpadsh command to start the Firefox Web browserwhich displays the page shown in Figure 1Figure 1 Firefox Welcome page
Note If you are using Linux for your evaluation no 64-bit Linux version seems to beavailable for download See Supported platforms for information about how to usethe 32-bit Linux build on a 64-bit Linux system
Starting the installer
Click Launch the installation wizard for WebSphere Application Server Trial tobegin the actual installation process The graphical installer for WebSphereApplication Server begins and displays its welcome screen as shown in Figure 2
Figure 2 WebSphere Application Server installers welcome screen
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 9 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1040
The welcome screen shows that the graphical installer is working correctly andprovides links to online sites that provide information and support for WebSphereand related products
Click Next to proceed with the installation process
Accepting the license terms and checking your system
The next page of the graphical installer displays the license under which WebSphereApplication Server is released as shown in Figure 3
Figure 3 Accepting the IBM software license agreement
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 10 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1140
This license contains IBM licensing information for the evaluation version ofWebSphere Application Server and language that excludes open source softwarethat is distributed with IBM WebSphere Application Server from those terms andidentifies separately licensed software components
Select I accept the terms in the licensing agreement to accept the licensingterms Click Next to proceed with the installation process If you dont accept thelicense terms a window displays asking you to confirm that fact If you confirm thatyou do not accept the license terms the installer exits
The next page of the installer indicates whether your system satisfies theprerequisites for installation If your system does not satisfy requirements theinstaller may display information about any missing patches that you should installIn this case you can either click Cancel to exit the installer and install the missingprerequisites or simply proceed with the installation
Click Next to proceed with the installation process
Selecting optional features for installation
Figure 4 shows the installer screen that enables you to install optional software whileyou install WebSphere Application Server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 11 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1240
Figure 4 Selecting optional software for installation
Optional software that you can install consists of the following
bull Sample applications Source code and integrated applications for initial
experimentation The sample applications also serve as an excellentmechanism for verifying that WebSphere Application Server is installedcorrectly and is working properly on your system
bull Non-English language support for the administrative consoleLanguage catalogs that provide national language support for WebSphereApplication Servers administrative console These language catalogs donot provide national language support for WebSphere Application Serveritself which is available in a separate item on this screen
bull Non-English language support for WebSphere Application ServerLanguage catalogs that provide national language support for WebSphereApplication Server itself These language catalogs do not provide nationallanguage support for WebSphere Application Servers administrativeconsole which is available in a separate item on this screen
Unless you already have substantial experience with WebSphere Application Serveryou should install the sample applications to provide a way for you to learn moreabout application integration and deployment in the WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 12 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1340
environment
The default language package installed with WebSphere is English as spoken in theUnited States Whether or not you install the optional language packages dependson your geographic location and language support requirements The additional
languages that are supported by the administrative console and WebSphereApplication Server language support packs are Chinese Czech French GermanHungarian Italian Japanese Korean Polish Portuguese Russian and Spanish
After selecting any additional features that you want to install click Next to proceedwith the installation process
Identifying the target installation directory
Next the graphical installer displays the default location in which WebSphereApplication Server will be installed which is optIBMWebSphereAppServer onUNIX 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 installingWebSphere Application Server in non-standard locations can make local systemadministration more complex Non-standard installation locations may also cause
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 13 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1440
problems with WebSphere applications that may expect the standard installationlocation
Click Next to proceed with the installation process
Specifying the WebSphere Application Server environment
The screen shown in Figure 6 enables you to identify the type of WebSphereApplication 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 youare installing and integrating WebSphere Application Server The environment thatyou 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 choicesare the following
bull Management Select this option if you are installing this copy ofWebSphere Application Server to manage other application serverenvironments on the local machine or on other systems on your networkSelecting this option creates an appropriate profile and will install and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 14 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1540
configure an administrative agent server services for managing multipleapplication server environments and an administrative agent to manageother application servers that are on the same machine
bull Application server The default selection this option creates anappropriate profile for installing a stand-alone application server that will
run your enterprise applications and which can only be managed from itsown administrative console
bull None Select this option if you do not want to create an execution profileduring installation Only select this option if you will explicitly create one ormore profiles after WebSphere Application Server is successfully installedon your system
Click Next to proceed with the installation process
Note If you select None as your server execution environment a warning dialogdisplays to inform you that at least one functional profile must be available to runWebSphere Application Server Click Yes to proceed with the installation processwithout creating a profile during the installation process and proceed to Summarypage and actual installation If you want to create a profile during the installationprocess click No to return to the dialog shown in Figure 6 to modify your serverexecution environment setting
Creating an administrative user
The next screen of the installer shown in Figure 7 enables you to create a secureaccount on your system for system administration through the WebSphereApplication Server administrative console
Figure 7 Defining an administrative user
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 15 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1640
Create an administrative user if you are installing a stand-alone or managedWebSphere Application Servermdashin other words when you are installing WebSphereApplication Server in an environment that creates a profile for you during theinstallation process as described earlier in Specifying the WebSphere Application
Server environment
Enter a username and password for use in administering your WebSphereApplication Server and enter the password again to confirm that you typed itcorrectly the first time
If you selected the sample applications for installation in the Selecting optionalfeatures for installation section you will also be prompted to set a password for theuser associated with those sample applications Enter the password twice to ensurethat you have typed it correctly or have at least made the same typo twice
After supplying information about the administrative user (and optionally apassword for the sample applications if you selected them for installation) click Nextto proceed with the installation process
Summary page and actual installation
As shown in Figure 8 a summary screen displays the configuration options that you
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 16 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1740
have accepted or specified and provides a check box that enables you to verify thatyou 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 theresreally no need to verify that you have the required privileges Clear this check boxand click Next to begin the installation process A window displays showing thestatus of the installation process The installation process first creates an uninstallerfor WebSphere Application Server to simplify removing the software if necessary Itthen installs WebSphere Application Server displaying status information as theinstallation proceeds
Installation status and next steps
When the installation finishes the window shown in Figure 9 displays the success orfailure of installation If any errors occur this window shows the location of a log filethat you can examine to identify the problems and determine whether they weremeaningful
Figure 9 Summary information about your installation
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 17 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1840
This screen provides a check box that because it is selected by default starts theWebSphere Application Server First steps console when you exit the installer TheFirst steps console enables you to do some initial configuration of WebSphereApplication Server
At this point you have two options
bull Leave the Launch the First steps console check box selected and clickFinish to exit the installer and start the First steps console
bull Clear the Launch the First steps console check box and click Finish toexit the installer without starting the First steps console or WebSphereApplication Server
Congratulations Youve installed WebSphere Application Server If you started theFirst steps console proceed to the next section for information about using thatconsole Otherwise you may want to do one of the following
bull Start the WebSphere Application Server manually
bull Integrate WebSphere Application Server with your systems Web server
bull Integrate WebSphere Application Server into your systems startup and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 18 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1940
shutdown processes
bull Access the WebSphere administrative console to begin configuring yourWebSphere Application Server
Section 4 Using the First steps console
The WebSphere Application Server installation process can automatically start aFirst steps console to help you familiarize yourself with WebSphere ApplicationServer and perform some initial configuration tasks Figure 10 shows the initialscreen of the First steps console
Figure 10 First steps console
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 19 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2040
As shown in Figure 10 the First steps console provides links to a number ofconvenient tasks that you may want to perform immediately after installationincluding
bull Installation verification Checks your WebSphere Application Server
installation to verify that it is installed correctly and starts the applicationserver as part of this check
bull Start the Server Starts the WebSphere Application Server displayingthe output of the startup process in a separate window for convenienceand diagnostic purposes When the application server is running this linkchanges to a Stop the server link which provides a convenient way tostop the server and displays the output of the server shutdown process ina separate window Stopping the server requires the administrativepassword that you set during the installation process and provides aconvenient check that the application servers internal authentication
mechanism is working correctlybull Administrative console Starts the WebSphere Administrative console
in a browser window enabling you to perform configuration tasks that areoutside the scope of the installation process Starting the administrativeconsole also requires the administrative password that you set during theinstallation process
bull Profile management tool Enables you to create additional executionprofiles each of which can be for use with specific enterprise Webapplications port configurations and so on If you did not specify a targetserver environment during the installation process and are not migrating
server configuration information from an existing WebSphere ApplicationServer installation use this option to create at least one WebSphereApplication Server profile You cannot start WebSphere ApplicationServer without at least one profilemdasheach profile provides the configurationinformation required to start the application server in a specific context
bull Samples gallery Provides access to the sample applications youinstalled during the installation process
bull Information center for WebSphere Application Server Opens theWebSphere Application Server Library Web site in a browser to providedetailed information about WebSphere Application Server in a variety of
enterprise application scenarios
bull Migration wizard Starts a wizard that simplifies migrating configurationinformation and applications from earlier versions of WebSphereApplication Server
The next few sections provide highlights of using selected options from the Firststeps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 20 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2140
Installation verification
Though error messages would have displayed had any problems occurred duringthe WebSphere Application Server installation process its always comforting to be
able to double-check that your application server installation is complete and that allthe necessary configuration files were created correctly during that process
To verify that WebSphere Application Server was installed correctly on your systemand start it as part of the testing process click the Installation verification link inthe First steps console A window like the one shown in Figure 11 displays
Figure 11 Output of the verification process
As you can see from this figure the verification process first starts the applicationserver with your default profile and then connects to the application server to verifythe Servlet engine JavaServer pages and enterprise bean configuration It thenexamines the authentication of the key stores that are used to provide secureconnections between WebSphere components
When the verification process completes you can click the close button in the upperright-hand corner of the output window to close that window and return to the Firststeps console Note that the Start the server link has been replaced by a Stop the
server link because the WebSphere Application Server was started as part of theverification process
Starting the server
If you choose not to verify your WebSphere Application Server installation as
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 21 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2240
described in the previous section you can start the WebSphere Application Servermanually by clicking the Start the server link in the First steps console Clicking thislink displays an output window much like the one shown in Figure 11 except that itonly shows the initial text about starting the server and does not probe theconfiguration of your server
Note If the First steps console does not show a Start the server link but insteaddisplays only a Stop the server link your WebSphere Application Server is alreadyrunning
After a line like ADMU3000I Server NAME open for e-business
displays in the output window you can click the close box in the upper right-handcorner of the output window to close that window and return to the First stepsconsole
Administrative consoleThe WebSphere Application Server Administrative console is the primarymechanism for configuring the application server integrating the application serverwith external applications such as database systems and installing WebSphereapplications If you are new to WebSphere Application Server and want to explorethe administrative console or want to install new WebSphere applicationsimmediately after installing WebSphere you may want to start the Administrativeconsole from the First steps console
Click Administrative console to start the WebSphere Administrative console fromthe First steps console The login screen for the Administrative console opens in abrowser window as shown in Figure 12
Figure 12 Administrative console login screen
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 22 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2340
The Administrative console requires a Secure Sockets Layer (SSL) HTTPconnection generally referred to as a Hypertext Transfer Protocol over SecureSockets Layer (HTTPS) connection The page shown in Figure 12 only displays if avalid third-party SSL certificate is installed on your system If the system on whichyou installed WebSphere Application Server does not have a valid certificate issuedby a third party you will see a warning dialog like that shown in Figure 13 instead
Figure 13 Certificate not trusted alert
If you see this message see the next section of this tutorial for information about
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 23 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2440
configuring a security exception for your systems existing certificate
If you see the Administrative console login screen as shown in Figure 12 enter theadministrative username and password that you defined during the installationprocess and click Login or press Return The WebSphere Application Server
Administrative console displays as shown in Figure 14 You can explore or use theAdministrative console clicking the Logout link in the header when you are done
Figure 14 Administrative console
Configuring a certificate security exception
As discussed in the previous section the WebSphere Application ServerAdministrative console requires an SSL HTTP connection generally referred to asan HTTPS connection According to the default security policies used by mostsystems this means that the public key security certificate presented by your systemmust be a valid certificate issued by a trusted third-party certificate authority such asthawte VeriSign GeoTrust and many others See Resources for more informationabout these third-party certificate authorities
In a production environment you will certainly only want to use WebSphere
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 24 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2540
Application Server on a system with a valid enterprise or third-party securitycertificate so that users of your Web applications can verify the identity of the systemthat they are connecting to However you may be installing and configuringWebSphere Application Server on a new system for which you have not yet obtaineda certificate In this case you can temporarily or permanently define your existing
certificate as a trusted one that is an exception to the standard WebSphere securitypolicy
To define a policy exception click OK in the dialog shown in Figure 13 to display thescreen shown in Figure 15
Figure 15 A secure connection failure in Firefox
Click the Or you can define an exception link to begin the process of identifyingyour systems certificate as a valid digital public key certificate A screen identical to
the current screen displays with the exception of two additional buttons that displayat the bottom of the screen Click Add exception to continue the process of definingthe current certificate as an exception to the default certificate policy The dialogshown in Figure 16 displays
Note Clicking the Get me out of here button exits the exception definition processand returns you to your browser without establishing a connection to the WebSphere
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 25 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2640
Administrative console which isnt all that useful for the purposes of this tutorial
Figure 16 Initial dialog for defining a security exception
Click Get Certificate to retrieve your systems current certificate which displaysinformation about the current certificate and enables the Confirm Security
Exception button at the bottom left of the dialog shown in Figure 16 as shown inFigure 17
Figure 17 Updated dialog for defining a security exception
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 26 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1040
The welcome screen shows that the graphical installer is working correctly andprovides links to online sites that provide information and support for WebSphereand related products
Click Next to proceed with the installation process
Accepting the license terms and checking your system
The next page of the graphical installer displays the license under which WebSphereApplication Server is released as shown in Figure 3
Figure 3 Accepting the IBM software license agreement
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 10 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1140
This license contains IBM licensing information for the evaluation version ofWebSphere Application Server and language that excludes open source softwarethat is distributed with IBM WebSphere Application Server from those terms andidentifies separately licensed software components
Select I accept the terms in the licensing agreement to accept the licensingterms Click Next to proceed with the installation process If you dont accept thelicense terms a window displays asking you to confirm that fact If you confirm thatyou do not accept the license terms the installer exits
The next page of the installer indicates whether your system satisfies theprerequisites for installation If your system does not satisfy requirements theinstaller may display information about any missing patches that you should installIn this case you can either click Cancel to exit the installer and install the missingprerequisites or simply proceed with the installation
Click Next to proceed with the installation process
Selecting optional features for installation
Figure 4 shows the installer screen that enables you to install optional software whileyou install WebSphere Application Server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 11 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1240
Figure 4 Selecting optional software for installation
Optional software that you can install consists of the following
bull Sample applications Source code and integrated applications for initial
experimentation The sample applications also serve as an excellentmechanism for verifying that WebSphere Application Server is installedcorrectly and is working properly on your system
bull Non-English language support for the administrative consoleLanguage catalogs that provide national language support for WebSphereApplication Servers administrative console These language catalogs donot provide national language support for WebSphere Application Serveritself which is available in a separate item on this screen
bull Non-English language support for WebSphere Application ServerLanguage catalogs that provide national language support for WebSphereApplication Server itself These language catalogs do not provide nationallanguage support for WebSphere Application Servers administrativeconsole which is available in a separate item on this screen
Unless you already have substantial experience with WebSphere Application Serveryou should install the sample applications to provide a way for you to learn moreabout application integration and deployment in the WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 12 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1340
environment
The default language package installed with WebSphere is English as spoken in theUnited States Whether or not you install the optional language packages dependson your geographic location and language support requirements The additional
languages that are supported by the administrative console and WebSphereApplication Server language support packs are Chinese Czech French GermanHungarian Italian Japanese Korean Polish Portuguese Russian and Spanish
After selecting any additional features that you want to install click Next to proceedwith the installation process
Identifying the target installation directory
Next the graphical installer displays the default location in which WebSphereApplication Server will be installed which is optIBMWebSphereAppServer onUNIX 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 installingWebSphere Application Server in non-standard locations can make local systemadministration more complex Non-standard installation locations may also cause
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 13 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1440
problems with WebSphere applications that may expect the standard installationlocation
Click Next to proceed with the installation process
Specifying the WebSphere Application Server environment
The screen shown in Figure 6 enables you to identify the type of WebSphereApplication 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 youare installing and integrating WebSphere Application Server The environment thatyou 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 choicesare the following
bull Management Select this option if you are installing this copy ofWebSphere Application Server to manage other application serverenvironments on the local machine or on other systems on your networkSelecting this option creates an appropriate profile and will install and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 14 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1540
configure an administrative agent server services for managing multipleapplication server environments and an administrative agent to manageother application servers that are on the same machine
bull Application server The default selection this option creates anappropriate profile for installing a stand-alone application server that will
run your enterprise applications and which can only be managed from itsown administrative console
bull None Select this option if you do not want to create an execution profileduring installation Only select this option if you will explicitly create one ormore profiles after WebSphere Application Server is successfully installedon your system
Click Next to proceed with the installation process
Note If you select None as your server execution environment a warning dialogdisplays to inform you that at least one functional profile must be available to runWebSphere Application Server Click Yes to proceed with the installation processwithout creating a profile during the installation process and proceed to Summarypage and actual installation If you want to create a profile during the installationprocess click No to return to the dialog shown in Figure 6 to modify your serverexecution environment setting
Creating an administrative user
The next screen of the installer shown in Figure 7 enables you to create a secureaccount on your system for system administration through the WebSphereApplication Server administrative console
Figure 7 Defining an administrative user
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 15 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1640
Create an administrative user if you are installing a stand-alone or managedWebSphere Application Servermdashin other words when you are installing WebSphereApplication Server in an environment that creates a profile for you during theinstallation process as described earlier in Specifying the WebSphere Application
Server environment
Enter a username and password for use in administering your WebSphereApplication Server and enter the password again to confirm that you typed itcorrectly the first time
If you selected the sample applications for installation in the Selecting optionalfeatures for installation section you will also be prompted to set a password for theuser associated with those sample applications Enter the password twice to ensurethat you have typed it correctly or have at least made the same typo twice
After supplying information about the administrative user (and optionally apassword for the sample applications if you selected them for installation) click Nextto proceed with the installation process
Summary page and actual installation
As shown in Figure 8 a summary screen displays the configuration options that you
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 16 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1740
have accepted or specified and provides a check box that enables you to verify thatyou 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 theresreally no need to verify that you have the required privileges Clear this check boxand click Next to begin the installation process A window displays showing thestatus of the installation process The installation process first creates an uninstallerfor WebSphere Application Server to simplify removing the software if necessary Itthen installs WebSphere Application Server displaying status information as theinstallation proceeds
Installation status and next steps
When the installation finishes the window shown in Figure 9 displays the success orfailure of installation If any errors occur this window shows the location of a log filethat you can examine to identify the problems and determine whether they weremeaningful
Figure 9 Summary information about your installation
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 17 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1840
This screen provides a check box that because it is selected by default starts theWebSphere Application Server First steps console when you exit the installer TheFirst steps console enables you to do some initial configuration of WebSphereApplication Server
At this point you have two options
bull Leave the Launch the First steps console check box selected and clickFinish to exit the installer and start the First steps console
bull Clear the Launch the First steps console check box and click Finish toexit the installer without starting the First steps console or WebSphereApplication Server
Congratulations Youve installed WebSphere Application Server If you started theFirst steps console proceed to the next section for information about using thatconsole Otherwise you may want to do one of the following
bull Start the WebSphere Application Server manually
bull Integrate WebSphere Application Server with your systems Web server
bull Integrate WebSphere Application Server into your systems startup and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 18 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1940
shutdown processes
bull Access the WebSphere administrative console to begin configuring yourWebSphere Application Server
Section 4 Using the First steps console
The WebSphere Application Server installation process can automatically start aFirst steps console to help you familiarize yourself with WebSphere ApplicationServer and perform some initial configuration tasks Figure 10 shows the initialscreen of the First steps console
Figure 10 First steps console
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 19 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2040
As shown in Figure 10 the First steps console provides links to a number ofconvenient tasks that you may want to perform immediately after installationincluding
bull Installation verification Checks your WebSphere Application Server
installation to verify that it is installed correctly and starts the applicationserver as part of this check
bull Start the Server Starts the WebSphere Application Server displayingthe output of the startup process in a separate window for convenienceand diagnostic purposes When the application server is running this linkchanges to a Stop the server link which provides a convenient way tostop the server and displays the output of the server shutdown process ina separate window Stopping the server requires the administrativepassword that you set during the installation process and provides aconvenient check that the application servers internal authentication
mechanism is working correctlybull Administrative console Starts the WebSphere Administrative console
in a browser window enabling you to perform configuration tasks that areoutside the scope of the installation process Starting the administrativeconsole also requires the administrative password that you set during theinstallation process
bull Profile management tool Enables you to create additional executionprofiles each of which can be for use with specific enterprise Webapplications port configurations and so on If you did not specify a targetserver environment during the installation process and are not migrating
server configuration information from an existing WebSphere ApplicationServer installation use this option to create at least one WebSphereApplication Server profile You cannot start WebSphere ApplicationServer without at least one profilemdasheach profile provides the configurationinformation required to start the application server in a specific context
bull Samples gallery Provides access to the sample applications youinstalled during the installation process
bull Information center for WebSphere Application Server Opens theWebSphere Application Server Library Web site in a browser to providedetailed information about WebSphere Application Server in a variety of
enterprise application scenarios
bull Migration wizard Starts a wizard that simplifies migrating configurationinformation and applications from earlier versions of WebSphereApplication Server
The next few sections provide highlights of using selected options from the Firststeps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 20 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2140
Installation verification
Though error messages would have displayed had any problems occurred duringthe WebSphere Application Server installation process its always comforting to be
able to double-check that your application server installation is complete and that allthe necessary configuration files were created correctly during that process
To verify that WebSphere Application Server was installed correctly on your systemand start it as part of the testing process click the Installation verification link inthe First steps console A window like the one shown in Figure 11 displays
Figure 11 Output of the verification process
As you can see from this figure the verification process first starts the applicationserver with your default profile and then connects to the application server to verifythe Servlet engine JavaServer pages and enterprise bean configuration It thenexamines the authentication of the key stores that are used to provide secureconnections between WebSphere components
When the verification process completes you can click the close button in the upperright-hand corner of the output window to close that window and return to the Firststeps console Note that the Start the server link has been replaced by a Stop the
server link because the WebSphere Application Server was started as part of theverification process
Starting the server
If you choose not to verify your WebSphere Application Server installation as
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 21 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2240
described in the previous section you can start the WebSphere Application Servermanually by clicking the Start the server link in the First steps console Clicking thislink displays an output window much like the one shown in Figure 11 except that itonly shows the initial text about starting the server and does not probe theconfiguration of your server
Note If the First steps console does not show a Start the server link but insteaddisplays only a Stop the server link your WebSphere Application Server is alreadyrunning
After a line like ADMU3000I Server NAME open for e-business
displays in the output window you can click the close box in the upper right-handcorner of the output window to close that window and return to the First stepsconsole
Administrative consoleThe WebSphere Application Server Administrative console is the primarymechanism for configuring the application server integrating the application serverwith external applications such as database systems and installing WebSphereapplications If you are new to WebSphere Application Server and want to explorethe administrative console or want to install new WebSphere applicationsimmediately after installing WebSphere you may want to start the Administrativeconsole from the First steps console
Click Administrative console to start the WebSphere Administrative console fromthe First steps console The login screen for the Administrative console opens in abrowser window as shown in Figure 12
Figure 12 Administrative console login screen
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 22 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2340
The Administrative console requires a Secure Sockets Layer (SSL) HTTPconnection generally referred to as a Hypertext Transfer Protocol over SecureSockets Layer (HTTPS) connection The page shown in Figure 12 only displays if avalid third-party SSL certificate is installed on your system If the system on whichyou installed WebSphere Application Server does not have a valid certificate issuedby a third party you will see a warning dialog like that shown in Figure 13 instead
Figure 13 Certificate not trusted alert
If you see this message see the next section of this tutorial for information about
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 23 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2440
configuring a security exception for your systems existing certificate
If you see the Administrative console login screen as shown in Figure 12 enter theadministrative username and password that you defined during the installationprocess and click Login or press Return The WebSphere Application Server
Administrative console displays as shown in Figure 14 You can explore or use theAdministrative console clicking the Logout link in the header when you are done
Figure 14 Administrative console
Configuring a certificate security exception
As discussed in the previous section the WebSphere Application ServerAdministrative console requires an SSL HTTP connection generally referred to asan HTTPS connection According to the default security policies used by mostsystems this means that the public key security certificate presented by your systemmust be a valid certificate issued by a trusted third-party certificate authority such asthawte VeriSign GeoTrust and many others See Resources for more informationabout these third-party certificate authorities
In a production environment you will certainly only want to use WebSphere
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 24 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2540
Application Server on a system with a valid enterprise or third-party securitycertificate so that users of your Web applications can verify the identity of the systemthat they are connecting to However you may be installing and configuringWebSphere Application Server on a new system for which you have not yet obtaineda certificate In this case you can temporarily or permanently define your existing
certificate as a trusted one that is an exception to the standard WebSphere securitypolicy
To define a policy exception click OK in the dialog shown in Figure 13 to display thescreen shown in Figure 15
Figure 15 A secure connection failure in Firefox
Click the Or you can define an exception link to begin the process of identifyingyour systems certificate as a valid digital public key certificate A screen identical to
the current screen displays with the exception of two additional buttons that displayat the bottom of the screen Click Add exception to continue the process of definingthe current certificate as an exception to the default certificate policy The dialogshown in Figure 16 displays
Note Clicking the Get me out of here button exits the exception definition processand returns you to your browser without establishing a connection to the WebSphere
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 25 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2640
Administrative console which isnt all that useful for the purposes of this tutorial
Figure 16 Initial dialog for defining a security exception
Click Get Certificate to retrieve your systems current certificate which displaysinformation about the current certificate and enables the Confirm Security
Exception button at the bottom left of the dialog shown in Figure 16 as shown inFigure 17
Figure 17 Updated dialog for defining a security exception
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 26 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1140
This license contains IBM licensing information for the evaluation version ofWebSphere Application Server and language that excludes open source softwarethat is distributed with IBM WebSphere Application Server from those terms andidentifies separately licensed software components
Select I accept the terms in the licensing agreement to accept the licensingterms Click Next to proceed with the installation process If you dont accept thelicense terms a window displays asking you to confirm that fact If you confirm thatyou do not accept the license terms the installer exits
The next page of the installer indicates whether your system satisfies theprerequisites for installation If your system does not satisfy requirements theinstaller may display information about any missing patches that you should installIn this case you can either click Cancel to exit the installer and install the missingprerequisites or simply proceed with the installation
Click Next to proceed with the installation process
Selecting optional features for installation
Figure 4 shows the installer screen that enables you to install optional software whileyou install WebSphere Application Server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 11 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1240
Figure 4 Selecting optional software for installation
Optional software that you can install consists of the following
bull Sample applications Source code and integrated applications for initial
experimentation The sample applications also serve as an excellentmechanism for verifying that WebSphere Application Server is installedcorrectly and is working properly on your system
bull Non-English language support for the administrative consoleLanguage catalogs that provide national language support for WebSphereApplication Servers administrative console These language catalogs donot provide national language support for WebSphere Application Serveritself which is available in a separate item on this screen
bull Non-English language support for WebSphere Application ServerLanguage catalogs that provide national language support for WebSphereApplication Server itself These language catalogs do not provide nationallanguage support for WebSphere Application Servers administrativeconsole which is available in a separate item on this screen
Unless you already have substantial experience with WebSphere Application Serveryou should install the sample applications to provide a way for you to learn moreabout application integration and deployment in the WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 12 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1340
environment
The default language package installed with WebSphere is English as spoken in theUnited States Whether or not you install the optional language packages dependson your geographic location and language support requirements The additional
languages that are supported by the administrative console and WebSphereApplication Server language support packs are Chinese Czech French GermanHungarian Italian Japanese Korean Polish Portuguese Russian and Spanish
After selecting any additional features that you want to install click Next to proceedwith the installation process
Identifying the target installation directory
Next the graphical installer displays the default location in which WebSphereApplication Server will be installed which is optIBMWebSphereAppServer onUNIX 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 installingWebSphere Application Server in non-standard locations can make local systemadministration more complex Non-standard installation locations may also cause
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 13 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1440
problems with WebSphere applications that may expect the standard installationlocation
Click Next to proceed with the installation process
Specifying the WebSphere Application Server environment
The screen shown in Figure 6 enables you to identify the type of WebSphereApplication 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 youare installing and integrating WebSphere Application Server The environment thatyou 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 choicesare the following
bull Management Select this option if you are installing this copy ofWebSphere Application Server to manage other application serverenvironments on the local machine or on other systems on your networkSelecting this option creates an appropriate profile and will install and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 14 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1540
configure an administrative agent server services for managing multipleapplication server environments and an administrative agent to manageother application servers that are on the same machine
bull Application server The default selection this option creates anappropriate profile for installing a stand-alone application server that will
run your enterprise applications and which can only be managed from itsown administrative console
bull None Select this option if you do not want to create an execution profileduring installation Only select this option if you will explicitly create one ormore profiles after WebSphere Application Server is successfully installedon your system
Click Next to proceed with the installation process
Note If you select None as your server execution environment a warning dialogdisplays to inform you that at least one functional profile must be available to runWebSphere Application Server Click Yes to proceed with the installation processwithout creating a profile during the installation process and proceed to Summarypage and actual installation If you want to create a profile during the installationprocess click No to return to the dialog shown in Figure 6 to modify your serverexecution environment setting
Creating an administrative user
The next screen of the installer shown in Figure 7 enables you to create a secureaccount on your system for system administration through the WebSphereApplication Server administrative console
Figure 7 Defining an administrative user
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 15 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1640
Create an administrative user if you are installing a stand-alone or managedWebSphere Application Servermdashin other words when you are installing WebSphereApplication Server in an environment that creates a profile for you during theinstallation process as described earlier in Specifying the WebSphere Application
Server environment
Enter a username and password for use in administering your WebSphereApplication Server and enter the password again to confirm that you typed itcorrectly the first time
If you selected the sample applications for installation in the Selecting optionalfeatures for installation section you will also be prompted to set a password for theuser associated with those sample applications Enter the password twice to ensurethat you have typed it correctly or have at least made the same typo twice
After supplying information about the administrative user (and optionally apassword for the sample applications if you selected them for installation) click Nextto proceed with the installation process
Summary page and actual installation
As shown in Figure 8 a summary screen displays the configuration options that you
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 16 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1740
have accepted or specified and provides a check box that enables you to verify thatyou 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 theresreally no need to verify that you have the required privileges Clear this check boxand click Next to begin the installation process A window displays showing thestatus of the installation process The installation process first creates an uninstallerfor WebSphere Application Server to simplify removing the software if necessary Itthen installs WebSphere Application Server displaying status information as theinstallation proceeds
Installation status and next steps
When the installation finishes the window shown in Figure 9 displays the success orfailure of installation If any errors occur this window shows the location of a log filethat you can examine to identify the problems and determine whether they weremeaningful
Figure 9 Summary information about your installation
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 17 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1840
This screen provides a check box that because it is selected by default starts theWebSphere Application Server First steps console when you exit the installer TheFirst steps console enables you to do some initial configuration of WebSphereApplication Server
At this point you have two options
bull Leave the Launch the First steps console check box selected and clickFinish to exit the installer and start the First steps console
bull Clear the Launch the First steps console check box and click Finish toexit the installer without starting the First steps console or WebSphereApplication Server
Congratulations Youve installed WebSphere Application Server If you started theFirst steps console proceed to the next section for information about using thatconsole Otherwise you may want to do one of the following
bull Start the WebSphere Application Server manually
bull Integrate WebSphere Application Server with your systems Web server
bull Integrate WebSphere Application Server into your systems startup and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 18 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1940
shutdown processes
bull Access the WebSphere administrative console to begin configuring yourWebSphere Application Server
Section 4 Using the First steps console
The WebSphere Application Server installation process can automatically start aFirst steps console to help you familiarize yourself with WebSphere ApplicationServer and perform some initial configuration tasks Figure 10 shows the initialscreen of the First steps console
Figure 10 First steps console
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 19 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2040
As shown in Figure 10 the First steps console provides links to a number ofconvenient tasks that you may want to perform immediately after installationincluding
bull Installation verification Checks your WebSphere Application Server
installation to verify that it is installed correctly and starts the applicationserver as part of this check
bull Start the Server Starts the WebSphere Application Server displayingthe output of the startup process in a separate window for convenienceand diagnostic purposes When the application server is running this linkchanges to a Stop the server link which provides a convenient way tostop the server and displays the output of the server shutdown process ina separate window Stopping the server requires the administrativepassword that you set during the installation process and provides aconvenient check that the application servers internal authentication
mechanism is working correctlybull Administrative console Starts the WebSphere Administrative console
in a browser window enabling you to perform configuration tasks that areoutside the scope of the installation process Starting the administrativeconsole also requires the administrative password that you set during theinstallation process
bull Profile management tool Enables you to create additional executionprofiles each of which can be for use with specific enterprise Webapplications port configurations and so on If you did not specify a targetserver environment during the installation process and are not migrating
server configuration information from an existing WebSphere ApplicationServer installation use this option to create at least one WebSphereApplication Server profile You cannot start WebSphere ApplicationServer without at least one profilemdasheach profile provides the configurationinformation required to start the application server in a specific context
bull Samples gallery Provides access to the sample applications youinstalled during the installation process
bull Information center for WebSphere Application Server Opens theWebSphere Application Server Library Web site in a browser to providedetailed information about WebSphere Application Server in a variety of
enterprise application scenarios
bull Migration wizard Starts a wizard that simplifies migrating configurationinformation and applications from earlier versions of WebSphereApplication Server
The next few sections provide highlights of using selected options from the Firststeps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 20 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2140
Installation verification
Though error messages would have displayed had any problems occurred duringthe WebSphere Application Server installation process its always comforting to be
able to double-check that your application server installation is complete and that allthe necessary configuration files were created correctly during that process
To verify that WebSphere Application Server was installed correctly on your systemand start it as part of the testing process click the Installation verification link inthe First steps console A window like the one shown in Figure 11 displays
Figure 11 Output of the verification process
As you can see from this figure the verification process first starts the applicationserver with your default profile and then connects to the application server to verifythe Servlet engine JavaServer pages and enterprise bean configuration It thenexamines the authentication of the key stores that are used to provide secureconnections between WebSphere components
When the verification process completes you can click the close button in the upperright-hand corner of the output window to close that window and return to the Firststeps console Note that the Start the server link has been replaced by a Stop the
server link because the WebSphere Application Server was started as part of theverification process
Starting the server
If you choose not to verify your WebSphere Application Server installation as
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 21 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2240
described in the previous section you can start the WebSphere Application Servermanually by clicking the Start the server link in the First steps console Clicking thislink displays an output window much like the one shown in Figure 11 except that itonly shows the initial text about starting the server and does not probe theconfiguration of your server
Note If the First steps console does not show a Start the server link but insteaddisplays only a Stop the server link your WebSphere Application Server is alreadyrunning
After a line like ADMU3000I Server NAME open for e-business
displays in the output window you can click the close box in the upper right-handcorner of the output window to close that window and return to the First stepsconsole
Administrative consoleThe WebSphere Application Server Administrative console is the primarymechanism for configuring the application server integrating the application serverwith external applications such as database systems and installing WebSphereapplications If you are new to WebSphere Application Server and want to explorethe administrative console or want to install new WebSphere applicationsimmediately after installing WebSphere you may want to start the Administrativeconsole from the First steps console
Click Administrative console to start the WebSphere Administrative console fromthe First steps console The login screen for the Administrative console opens in abrowser window as shown in Figure 12
Figure 12 Administrative console login screen
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 22 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2340
The Administrative console requires a Secure Sockets Layer (SSL) HTTPconnection generally referred to as a Hypertext Transfer Protocol over SecureSockets Layer (HTTPS) connection The page shown in Figure 12 only displays if avalid third-party SSL certificate is installed on your system If the system on whichyou installed WebSphere Application Server does not have a valid certificate issuedby a third party you will see a warning dialog like that shown in Figure 13 instead
Figure 13 Certificate not trusted alert
If you see this message see the next section of this tutorial for information about
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 23 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2440
configuring a security exception for your systems existing certificate
If you see the Administrative console login screen as shown in Figure 12 enter theadministrative username and password that you defined during the installationprocess and click Login or press Return The WebSphere Application Server
Administrative console displays as shown in Figure 14 You can explore or use theAdministrative console clicking the Logout link in the header when you are done
Figure 14 Administrative console
Configuring a certificate security exception
As discussed in the previous section the WebSphere Application ServerAdministrative console requires an SSL HTTP connection generally referred to asan HTTPS connection According to the default security policies used by mostsystems this means that the public key security certificate presented by your systemmust be a valid certificate issued by a trusted third-party certificate authority such asthawte VeriSign GeoTrust and many others See Resources for more informationabout these third-party certificate authorities
In a production environment you will certainly only want to use WebSphere
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 24 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2540
Application Server on a system with a valid enterprise or third-party securitycertificate so that users of your Web applications can verify the identity of the systemthat they are connecting to However you may be installing and configuringWebSphere Application Server on a new system for which you have not yet obtaineda certificate In this case you can temporarily or permanently define your existing
certificate as a trusted one that is an exception to the standard WebSphere securitypolicy
To define a policy exception click OK in the dialog shown in Figure 13 to display thescreen shown in Figure 15
Figure 15 A secure connection failure in Firefox
Click the Or you can define an exception link to begin the process of identifyingyour systems certificate as a valid digital public key certificate A screen identical to
the current screen displays with the exception of two additional buttons that displayat the bottom of the screen Click Add exception to continue the process of definingthe current certificate as an exception to the default certificate policy The dialogshown in Figure 16 displays
Note Clicking the Get me out of here button exits the exception definition processand returns you to your browser without establishing a connection to the WebSphere
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 25 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2640
Administrative console which isnt all that useful for the purposes of this tutorial
Figure 16 Initial dialog for defining a security exception
Click Get Certificate to retrieve your systems current certificate which displaysinformation about the current certificate and enables the Confirm Security
Exception button at the bottom left of the dialog shown in Figure 16 as shown inFigure 17
Figure 17 Updated dialog for defining a security exception
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 26 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1240
Figure 4 Selecting optional software for installation
Optional software that you can install consists of the following
bull Sample applications Source code and integrated applications for initial
experimentation The sample applications also serve as an excellentmechanism for verifying that WebSphere Application Server is installedcorrectly and is working properly on your system
bull Non-English language support for the administrative consoleLanguage catalogs that provide national language support for WebSphereApplication Servers administrative console These language catalogs donot provide national language support for WebSphere Application Serveritself which is available in a separate item on this screen
bull Non-English language support for WebSphere Application ServerLanguage catalogs that provide national language support for WebSphereApplication Server itself These language catalogs do not provide nationallanguage support for WebSphere Application Servers administrativeconsole which is available in a separate item on this screen
Unless you already have substantial experience with WebSphere Application Serveryou should install the sample applications to provide a way for you to learn moreabout application integration and deployment in the WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 12 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1340
environment
The default language package installed with WebSphere is English as spoken in theUnited States Whether or not you install the optional language packages dependson your geographic location and language support requirements The additional
languages that are supported by the administrative console and WebSphereApplication Server language support packs are Chinese Czech French GermanHungarian Italian Japanese Korean Polish Portuguese Russian and Spanish
After selecting any additional features that you want to install click Next to proceedwith the installation process
Identifying the target installation directory
Next the graphical installer displays the default location in which WebSphereApplication Server will be installed which is optIBMWebSphereAppServer onUNIX 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 installingWebSphere Application Server in non-standard locations can make local systemadministration more complex Non-standard installation locations may also cause
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 13 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1440
problems with WebSphere applications that may expect the standard installationlocation
Click Next to proceed with the installation process
Specifying the WebSphere Application Server environment
The screen shown in Figure 6 enables you to identify the type of WebSphereApplication 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 youare installing and integrating WebSphere Application Server The environment thatyou 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 choicesare the following
bull Management Select this option if you are installing this copy ofWebSphere Application Server to manage other application serverenvironments on the local machine or on other systems on your networkSelecting this option creates an appropriate profile and will install and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 14 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1540
configure an administrative agent server services for managing multipleapplication server environments and an administrative agent to manageother application servers that are on the same machine
bull Application server The default selection this option creates anappropriate profile for installing a stand-alone application server that will
run your enterprise applications and which can only be managed from itsown administrative console
bull None Select this option if you do not want to create an execution profileduring installation Only select this option if you will explicitly create one ormore profiles after WebSphere Application Server is successfully installedon your system
Click Next to proceed with the installation process
Note If you select None as your server execution environment a warning dialogdisplays to inform you that at least one functional profile must be available to runWebSphere Application Server Click Yes to proceed with the installation processwithout creating a profile during the installation process and proceed to Summarypage and actual installation If you want to create a profile during the installationprocess click No to return to the dialog shown in Figure 6 to modify your serverexecution environment setting
Creating an administrative user
The next screen of the installer shown in Figure 7 enables you to create a secureaccount on your system for system administration through the WebSphereApplication Server administrative console
Figure 7 Defining an administrative user
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 15 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1640
Create an administrative user if you are installing a stand-alone or managedWebSphere Application Servermdashin other words when you are installing WebSphereApplication Server in an environment that creates a profile for you during theinstallation process as described earlier in Specifying the WebSphere Application
Server environment
Enter a username and password for use in administering your WebSphereApplication Server and enter the password again to confirm that you typed itcorrectly the first time
If you selected the sample applications for installation in the Selecting optionalfeatures for installation section you will also be prompted to set a password for theuser associated with those sample applications Enter the password twice to ensurethat you have typed it correctly or have at least made the same typo twice
After supplying information about the administrative user (and optionally apassword for the sample applications if you selected them for installation) click Nextto proceed with the installation process
Summary page and actual installation
As shown in Figure 8 a summary screen displays the configuration options that you
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 16 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1740
have accepted or specified and provides a check box that enables you to verify thatyou 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 theresreally no need to verify that you have the required privileges Clear this check boxand click Next to begin the installation process A window displays showing thestatus of the installation process The installation process first creates an uninstallerfor WebSphere Application Server to simplify removing the software if necessary Itthen installs WebSphere Application Server displaying status information as theinstallation proceeds
Installation status and next steps
When the installation finishes the window shown in Figure 9 displays the success orfailure of installation If any errors occur this window shows the location of a log filethat you can examine to identify the problems and determine whether they weremeaningful
Figure 9 Summary information about your installation
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 17 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1840
This screen provides a check box that because it is selected by default starts theWebSphere Application Server First steps console when you exit the installer TheFirst steps console enables you to do some initial configuration of WebSphereApplication Server
At this point you have two options
bull Leave the Launch the First steps console check box selected and clickFinish to exit the installer and start the First steps console
bull Clear the Launch the First steps console check box and click Finish toexit the installer without starting the First steps console or WebSphereApplication Server
Congratulations Youve installed WebSphere Application Server If you started theFirst steps console proceed to the next section for information about using thatconsole Otherwise you may want to do one of the following
bull Start the WebSphere Application Server manually
bull Integrate WebSphere Application Server with your systems Web server
bull Integrate WebSphere Application Server into your systems startup and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 18 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1940
shutdown processes
bull Access the WebSphere administrative console to begin configuring yourWebSphere Application Server
Section 4 Using the First steps console
The WebSphere Application Server installation process can automatically start aFirst steps console to help you familiarize yourself with WebSphere ApplicationServer and perform some initial configuration tasks Figure 10 shows the initialscreen of the First steps console
Figure 10 First steps console
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 19 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2040
As shown in Figure 10 the First steps console provides links to a number ofconvenient tasks that you may want to perform immediately after installationincluding
bull Installation verification Checks your WebSphere Application Server
installation to verify that it is installed correctly and starts the applicationserver as part of this check
bull Start the Server Starts the WebSphere Application Server displayingthe output of the startup process in a separate window for convenienceand diagnostic purposes When the application server is running this linkchanges to a Stop the server link which provides a convenient way tostop the server and displays the output of the server shutdown process ina separate window Stopping the server requires the administrativepassword that you set during the installation process and provides aconvenient check that the application servers internal authentication
mechanism is working correctlybull Administrative console Starts the WebSphere Administrative console
in a browser window enabling you to perform configuration tasks that areoutside the scope of the installation process Starting the administrativeconsole also requires the administrative password that you set during theinstallation process
bull Profile management tool Enables you to create additional executionprofiles each of which can be for use with specific enterprise Webapplications port configurations and so on If you did not specify a targetserver environment during the installation process and are not migrating
server configuration information from an existing WebSphere ApplicationServer installation use this option to create at least one WebSphereApplication Server profile You cannot start WebSphere ApplicationServer without at least one profilemdasheach profile provides the configurationinformation required to start the application server in a specific context
bull Samples gallery Provides access to the sample applications youinstalled during the installation process
bull Information center for WebSphere Application Server Opens theWebSphere Application Server Library Web site in a browser to providedetailed information about WebSphere Application Server in a variety of
enterprise application scenarios
bull Migration wizard Starts a wizard that simplifies migrating configurationinformation and applications from earlier versions of WebSphereApplication Server
The next few sections provide highlights of using selected options from the Firststeps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 20 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2140
Installation verification
Though error messages would have displayed had any problems occurred duringthe WebSphere Application Server installation process its always comforting to be
able to double-check that your application server installation is complete and that allthe necessary configuration files were created correctly during that process
To verify that WebSphere Application Server was installed correctly on your systemand start it as part of the testing process click the Installation verification link inthe First steps console A window like the one shown in Figure 11 displays
Figure 11 Output of the verification process
As you can see from this figure the verification process first starts the applicationserver with your default profile and then connects to the application server to verifythe Servlet engine JavaServer pages and enterprise bean configuration It thenexamines the authentication of the key stores that are used to provide secureconnections between WebSphere components
When the verification process completes you can click the close button in the upperright-hand corner of the output window to close that window and return to the Firststeps console Note that the Start the server link has been replaced by a Stop the
server link because the WebSphere Application Server was started as part of theverification process
Starting the server
If you choose not to verify your WebSphere Application Server installation as
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 21 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2240
described in the previous section you can start the WebSphere Application Servermanually by clicking the Start the server link in the First steps console Clicking thislink displays an output window much like the one shown in Figure 11 except that itonly shows the initial text about starting the server and does not probe theconfiguration of your server
Note If the First steps console does not show a Start the server link but insteaddisplays only a Stop the server link your WebSphere Application Server is alreadyrunning
After a line like ADMU3000I Server NAME open for e-business
displays in the output window you can click the close box in the upper right-handcorner of the output window to close that window and return to the First stepsconsole
Administrative consoleThe WebSphere Application Server Administrative console is the primarymechanism for configuring the application server integrating the application serverwith external applications such as database systems and installing WebSphereapplications If you are new to WebSphere Application Server and want to explorethe administrative console or want to install new WebSphere applicationsimmediately after installing WebSphere you may want to start the Administrativeconsole from the First steps console
Click Administrative console to start the WebSphere Administrative console fromthe First steps console The login screen for the Administrative console opens in abrowser window as shown in Figure 12
Figure 12 Administrative console login screen
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 22 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2340
The Administrative console requires a Secure Sockets Layer (SSL) HTTPconnection generally referred to as a Hypertext Transfer Protocol over SecureSockets Layer (HTTPS) connection The page shown in Figure 12 only displays if avalid third-party SSL certificate is installed on your system If the system on whichyou installed WebSphere Application Server does not have a valid certificate issuedby a third party you will see a warning dialog like that shown in Figure 13 instead
Figure 13 Certificate not trusted alert
If you see this message see the next section of this tutorial for information about
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 23 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2440
configuring a security exception for your systems existing certificate
If you see the Administrative console login screen as shown in Figure 12 enter theadministrative username and password that you defined during the installationprocess and click Login or press Return The WebSphere Application Server
Administrative console displays as shown in Figure 14 You can explore or use theAdministrative console clicking the Logout link in the header when you are done
Figure 14 Administrative console
Configuring a certificate security exception
As discussed in the previous section the WebSphere Application ServerAdministrative console requires an SSL HTTP connection generally referred to asan HTTPS connection According to the default security policies used by mostsystems this means that the public key security certificate presented by your systemmust be a valid certificate issued by a trusted third-party certificate authority such asthawte VeriSign GeoTrust and many others See Resources for more informationabout these third-party certificate authorities
In a production environment you will certainly only want to use WebSphere
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 24 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2540
Application Server on a system with a valid enterprise or third-party securitycertificate so that users of your Web applications can verify the identity of the systemthat they are connecting to However you may be installing and configuringWebSphere Application Server on a new system for which you have not yet obtaineda certificate In this case you can temporarily or permanently define your existing
certificate as a trusted one that is an exception to the standard WebSphere securitypolicy
To define a policy exception click OK in the dialog shown in Figure 13 to display thescreen shown in Figure 15
Figure 15 A secure connection failure in Firefox
Click the Or you can define an exception link to begin the process of identifyingyour systems certificate as a valid digital public key certificate A screen identical to
the current screen displays with the exception of two additional buttons that displayat the bottom of the screen Click Add exception to continue the process of definingthe current certificate as an exception to the default certificate policy The dialogshown in Figure 16 displays
Note Clicking the Get me out of here button exits the exception definition processand returns you to your browser without establishing a connection to the WebSphere
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 25 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2640
Administrative console which isnt all that useful for the purposes of this tutorial
Figure 16 Initial dialog for defining a security exception
Click Get Certificate to retrieve your systems current certificate which displaysinformation about the current certificate and enables the Confirm Security
Exception button at the bottom left of the dialog shown in Figure 16 as shown inFigure 17
Figure 17 Updated dialog for defining a security exception
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 26 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1340
environment
The default language package installed with WebSphere is English as spoken in theUnited States Whether or not you install the optional language packages dependson your geographic location and language support requirements The additional
languages that are supported by the administrative console and WebSphereApplication Server language support packs are Chinese Czech French GermanHungarian Italian Japanese Korean Polish Portuguese Russian and Spanish
After selecting any additional features that you want to install click Next to proceedwith the installation process
Identifying the target installation directory
Next the graphical installer displays the default location in which WebSphereApplication Server will be installed which is optIBMWebSphereAppServer onUNIX 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 installingWebSphere Application Server in non-standard locations can make local systemadministration more complex Non-standard installation locations may also cause
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 13 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1440
problems with WebSphere applications that may expect the standard installationlocation
Click Next to proceed with the installation process
Specifying the WebSphere Application Server environment
The screen shown in Figure 6 enables you to identify the type of WebSphereApplication 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 youare installing and integrating WebSphere Application Server The environment thatyou 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 choicesare the following
bull Management Select this option if you are installing this copy ofWebSphere Application Server to manage other application serverenvironments on the local machine or on other systems on your networkSelecting this option creates an appropriate profile and will install and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 14 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1540
configure an administrative agent server services for managing multipleapplication server environments and an administrative agent to manageother application servers that are on the same machine
bull Application server The default selection this option creates anappropriate profile for installing a stand-alone application server that will
run your enterprise applications and which can only be managed from itsown administrative console
bull None Select this option if you do not want to create an execution profileduring installation Only select this option if you will explicitly create one ormore profiles after WebSphere Application Server is successfully installedon your system
Click Next to proceed with the installation process
Note If you select None as your server execution environment a warning dialogdisplays to inform you that at least one functional profile must be available to runWebSphere Application Server Click Yes to proceed with the installation processwithout creating a profile during the installation process and proceed to Summarypage and actual installation If you want to create a profile during the installationprocess click No to return to the dialog shown in Figure 6 to modify your serverexecution environment setting
Creating an administrative user
The next screen of the installer shown in Figure 7 enables you to create a secureaccount on your system for system administration through the WebSphereApplication Server administrative console
Figure 7 Defining an administrative user
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 15 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1640
Create an administrative user if you are installing a stand-alone or managedWebSphere Application Servermdashin other words when you are installing WebSphereApplication Server in an environment that creates a profile for you during theinstallation process as described earlier in Specifying the WebSphere Application
Server environment
Enter a username and password for use in administering your WebSphereApplication Server and enter the password again to confirm that you typed itcorrectly the first time
If you selected the sample applications for installation in the Selecting optionalfeatures for installation section you will also be prompted to set a password for theuser associated with those sample applications Enter the password twice to ensurethat you have typed it correctly or have at least made the same typo twice
After supplying information about the administrative user (and optionally apassword for the sample applications if you selected them for installation) click Nextto proceed with the installation process
Summary page and actual installation
As shown in Figure 8 a summary screen displays the configuration options that you
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 16 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1740
have accepted or specified and provides a check box that enables you to verify thatyou 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 theresreally no need to verify that you have the required privileges Clear this check boxand click Next to begin the installation process A window displays showing thestatus of the installation process The installation process first creates an uninstallerfor WebSphere Application Server to simplify removing the software if necessary Itthen installs WebSphere Application Server displaying status information as theinstallation proceeds
Installation status and next steps
When the installation finishes the window shown in Figure 9 displays the success orfailure of installation If any errors occur this window shows the location of a log filethat you can examine to identify the problems and determine whether they weremeaningful
Figure 9 Summary information about your installation
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 17 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1840
This screen provides a check box that because it is selected by default starts theWebSphere Application Server First steps console when you exit the installer TheFirst steps console enables you to do some initial configuration of WebSphereApplication Server
At this point you have two options
bull Leave the Launch the First steps console check box selected and clickFinish to exit the installer and start the First steps console
bull Clear the Launch the First steps console check box and click Finish toexit the installer without starting the First steps console or WebSphereApplication Server
Congratulations Youve installed WebSphere Application Server If you started theFirst steps console proceed to the next section for information about using thatconsole Otherwise you may want to do one of the following
bull Start the WebSphere Application Server manually
bull Integrate WebSphere Application Server with your systems Web server
bull Integrate WebSphere Application Server into your systems startup and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 18 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1940
shutdown processes
bull Access the WebSphere administrative console to begin configuring yourWebSphere Application Server
Section 4 Using the First steps console
The WebSphere Application Server installation process can automatically start aFirst steps console to help you familiarize yourself with WebSphere ApplicationServer and perform some initial configuration tasks Figure 10 shows the initialscreen of the First steps console
Figure 10 First steps console
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 19 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2040
As shown in Figure 10 the First steps console provides links to a number ofconvenient tasks that you may want to perform immediately after installationincluding
bull Installation verification Checks your WebSphere Application Server
installation to verify that it is installed correctly and starts the applicationserver as part of this check
bull Start the Server Starts the WebSphere Application Server displayingthe output of the startup process in a separate window for convenienceand diagnostic purposes When the application server is running this linkchanges to a Stop the server link which provides a convenient way tostop the server and displays the output of the server shutdown process ina separate window Stopping the server requires the administrativepassword that you set during the installation process and provides aconvenient check that the application servers internal authentication
mechanism is working correctlybull Administrative console Starts the WebSphere Administrative console
in a browser window enabling you to perform configuration tasks that areoutside the scope of the installation process Starting the administrativeconsole also requires the administrative password that you set during theinstallation process
bull Profile management tool Enables you to create additional executionprofiles each of which can be for use with specific enterprise Webapplications port configurations and so on If you did not specify a targetserver environment during the installation process and are not migrating
server configuration information from an existing WebSphere ApplicationServer installation use this option to create at least one WebSphereApplication Server profile You cannot start WebSphere ApplicationServer without at least one profilemdasheach profile provides the configurationinformation required to start the application server in a specific context
bull Samples gallery Provides access to the sample applications youinstalled during the installation process
bull Information center for WebSphere Application Server Opens theWebSphere Application Server Library Web site in a browser to providedetailed information about WebSphere Application Server in a variety of
enterprise application scenarios
bull Migration wizard Starts a wizard that simplifies migrating configurationinformation and applications from earlier versions of WebSphereApplication Server
The next few sections provide highlights of using selected options from the Firststeps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 20 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2140
Installation verification
Though error messages would have displayed had any problems occurred duringthe WebSphere Application Server installation process its always comforting to be
able to double-check that your application server installation is complete and that allthe necessary configuration files were created correctly during that process
To verify that WebSphere Application Server was installed correctly on your systemand start it as part of the testing process click the Installation verification link inthe First steps console A window like the one shown in Figure 11 displays
Figure 11 Output of the verification process
As you can see from this figure the verification process first starts the applicationserver with your default profile and then connects to the application server to verifythe Servlet engine JavaServer pages and enterprise bean configuration It thenexamines the authentication of the key stores that are used to provide secureconnections between WebSphere components
When the verification process completes you can click the close button in the upperright-hand corner of the output window to close that window and return to the Firststeps console Note that the Start the server link has been replaced by a Stop the
server link because the WebSphere Application Server was started as part of theverification process
Starting the server
If you choose not to verify your WebSphere Application Server installation as
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 21 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2240
described in the previous section you can start the WebSphere Application Servermanually by clicking the Start the server link in the First steps console Clicking thislink displays an output window much like the one shown in Figure 11 except that itonly shows the initial text about starting the server and does not probe theconfiguration of your server
Note If the First steps console does not show a Start the server link but insteaddisplays only a Stop the server link your WebSphere Application Server is alreadyrunning
After a line like ADMU3000I Server NAME open for e-business
displays in the output window you can click the close box in the upper right-handcorner of the output window to close that window and return to the First stepsconsole
Administrative consoleThe WebSphere Application Server Administrative console is the primarymechanism for configuring the application server integrating the application serverwith external applications such as database systems and installing WebSphereapplications If you are new to WebSphere Application Server and want to explorethe administrative console or want to install new WebSphere applicationsimmediately after installing WebSphere you may want to start the Administrativeconsole from the First steps console
Click Administrative console to start the WebSphere Administrative console fromthe First steps console The login screen for the Administrative console opens in abrowser window as shown in Figure 12
Figure 12 Administrative console login screen
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 22 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2340
The Administrative console requires a Secure Sockets Layer (SSL) HTTPconnection generally referred to as a Hypertext Transfer Protocol over SecureSockets Layer (HTTPS) connection The page shown in Figure 12 only displays if avalid third-party SSL certificate is installed on your system If the system on whichyou installed WebSphere Application Server does not have a valid certificate issuedby a third party you will see a warning dialog like that shown in Figure 13 instead
Figure 13 Certificate not trusted alert
If you see this message see the next section of this tutorial for information about
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 23 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2440
configuring a security exception for your systems existing certificate
If you see the Administrative console login screen as shown in Figure 12 enter theadministrative username and password that you defined during the installationprocess and click Login or press Return The WebSphere Application Server
Administrative console displays as shown in Figure 14 You can explore or use theAdministrative console clicking the Logout link in the header when you are done
Figure 14 Administrative console
Configuring a certificate security exception
As discussed in the previous section the WebSphere Application ServerAdministrative console requires an SSL HTTP connection generally referred to asan HTTPS connection According to the default security policies used by mostsystems this means that the public key security certificate presented by your systemmust be a valid certificate issued by a trusted third-party certificate authority such asthawte VeriSign GeoTrust and many others See Resources for more informationabout these third-party certificate authorities
In a production environment you will certainly only want to use WebSphere
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 24 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2540
Application Server on a system with a valid enterprise or third-party securitycertificate so that users of your Web applications can verify the identity of the systemthat they are connecting to However you may be installing and configuringWebSphere Application Server on a new system for which you have not yet obtaineda certificate In this case you can temporarily or permanently define your existing
certificate as a trusted one that is an exception to the standard WebSphere securitypolicy
To define a policy exception click OK in the dialog shown in Figure 13 to display thescreen shown in Figure 15
Figure 15 A secure connection failure in Firefox
Click the Or you can define an exception link to begin the process of identifyingyour systems certificate as a valid digital public key certificate A screen identical to
the current screen displays with the exception of two additional buttons that displayat the bottom of the screen Click Add exception to continue the process of definingthe current certificate as an exception to the default certificate policy The dialogshown in Figure 16 displays
Note Clicking the Get me out of here button exits the exception definition processand returns you to your browser without establishing a connection to the WebSphere
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 25 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2640
Administrative console which isnt all that useful for the purposes of this tutorial
Figure 16 Initial dialog for defining a security exception
Click Get Certificate to retrieve your systems current certificate which displaysinformation about the current certificate and enables the Confirm Security
Exception button at the bottom left of the dialog shown in Figure 16 as shown inFigure 17
Figure 17 Updated dialog for defining a security exception
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 26 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1440
problems with WebSphere applications that may expect the standard installationlocation
Click Next to proceed with the installation process
Specifying the WebSphere Application Server environment
The screen shown in Figure 6 enables you to identify the type of WebSphereApplication 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 youare installing and integrating WebSphere Application Server The environment thatyou 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 choicesare the following
bull Management Select this option if you are installing this copy ofWebSphere Application Server to manage other application serverenvironments on the local machine or on other systems on your networkSelecting this option creates an appropriate profile and will install and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 14 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1540
configure an administrative agent server services for managing multipleapplication server environments and an administrative agent to manageother application servers that are on the same machine
bull Application server The default selection this option creates anappropriate profile for installing a stand-alone application server that will
run your enterprise applications and which can only be managed from itsown administrative console
bull None Select this option if you do not want to create an execution profileduring installation Only select this option if you will explicitly create one ormore profiles after WebSphere Application Server is successfully installedon your system
Click Next to proceed with the installation process
Note If you select None as your server execution environment a warning dialogdisplays to inform you that at least one functional profile must be available to runWebSphere Application Server Click Yes to proceed with the installation processwithout creating a profile during the installation process and proceed to Summarypage and actual installation If you want to create a profile during the installationprocess click No to return to the dialog shown in Figure 6 to modify your serverexecution environment setting
Creating an administrative user
The next screen of the installer shown in Figure 7 enables you to create a secureaccount on your system for system administration through the WebSphereApplication Server administrative console
Figure 7 Defining an administrative user
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 15 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1640
Create an administrative user if you are installing a stand-alone or managedWebSphere Application Servermdashin other words when you are installing WebSphereApplication Server in an environment that creates a profile for you during theinstallation process as described earlier in Specifying the WebSphere Application
Server environment
Enter a username and password for use in administering your WebSphereApplication Server and enter the password again to confirm that you typed itcorrectly the first time
If you selected the sample applications for installation in the Selecting optionalfeatures for installation section you will also be prompted to set a password for theuser associated with those sample applications Enter the password twice to ensurethat you have typed it correctly or have at least made the same typo twice
After supplying information about the administrative user (and optionally apassword for the sample applications if you selected them for installation) click Nextto proceed with the installation process
Summary page and actual installation
As shown in Figure 8 a summary screen displays the configuration options that you
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 16 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1740
have accepted or specified and provides a check box that enables you to verify thatyou 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 theresreally no need to verify that you have the required privileges Clear this check boxand click Next to begin the installation process A window displays showing thestatus of the installation process The installation process first creates an uninstallerfor WebSphere Application Server to simplify removing the software if necessary Itthen installs WebSphere Application Server displaying status information as theinstallation proceeds
Installation status and next steps
When the installation finishes the window shown in Figure 9 displays the success orfailure of installation If any errors occur this window shows the location of a log filethat you can examine to identify the problems and determine whether they weremeaningful
Figure 9 Summary information about your installation
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 17 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1840
This screen provides a check box that because it is selected by default starts theWebSphere Application Server First steps console when you exit the installer TheFirst steps console enables you to do some initial configuration of WebSphereApplication Server
At this point you have two options
bull Leave the Launch the First steps console check box selected and clickFinish to exit the installer and start the First steps console
bull Clear the Launch the First steps console check box and click Finish toexit the installer without starting the First steps console or WebSphereApplication Server
Congratulations Youve installed WebSphere Application Server If you started theFirst steps console proceed to the next section for information about using thatconsole Otherwise you may want to do one of the following
bull Start the WebSphere Application Server manually
bull Integrate WebSphere Application Server with your systems Web server
bull Integrate WebSphere Application Server into your systems startup and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 18 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1940
shutdown processes
bull Access the WebSphere administrative console to begin configuring yourWebSphere Application Server
Section 4 Using the First steps console
The WebSphere Application Server installation process can automatically start aFirst steps console to help you familiarize yourself with WebSphere ApplicationServer and perform some initial configuration tasks Figure 10 shows the initialscreen of the First steps console
Figure 10 First steps console
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 19 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2040
As shown in Figure 10 the First steps console provides links to a number ofconvenient tasks that you may want to perform immediately after installationincluding
bull Installation verification Checks your WebSphere Application Server
installation to verify that it is installed correctly and starts the applicationserver as part of this check
bull Start the Server Starts the WebSphere Application Server displayingthe output of the startup process in a separate window for convenienceand diagnostic purposes When the application server is running this linkchanges to a Stop the server link which provides a convenient way tostop the server and displays the output of the server shutdown process ina separate window Stopping the server requires the administrativepassword that you set during the installation process and provides aconvenient check that the application servers internal authentication
mechanism is working correctlybull Administrative console Starts the WebSphere Administrative console
in a browser window enabling you to perform configuration tasks that areoutside the scope of the installation process Starting the administrativeconsole also requires the administrative password that you set during theinstallation process
bull Profile management tool Enables you to create additional executionprofiles each of which can be for use with specific enterprise Webapplications port configurations and so on If you did not specify a targetserver environment during the installation process and are not migrating
server configuration information from an existing WebSphere ApplicationServer installation use this option to create at least one WebSphereApplication Server profile You cannot start WebSphere ApplicationServer without at least one profilemdasheach profile provides the configurationinformation required to start the application server in a specific context
bull Samples gallery Provides access to the sample applications youinstalled during the installation process
bull Information center for WebSphere Application Server Opens theWebSphere Application Server Library Web site in a browser to providedetailed information about WebSphere Application Server in a variety of
enterprise application scenarios
bull Migration wizard Starts a wizard that simplifies migrating configurationinformation and applications from earlier versions of WebSphereApplication Server
The next few sections provide highlights of using selected options from the Firststeps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 20 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2140
Installation verification
Though error messages would have displayed had any problems occurred duringthe WebSphere Application Server installation process its always comforting to be
able to double-check that your application server installation is complete and that allthe necessary configuration files were created correctly during that process
To verify that WebSphere Application Server was installed correctly on your systemand start it as part of the testing process click the Installation verification link inthe First steps console A window like the one shown in Figure 11 displays
Figure 11 Output of the verification process
As you can see from this figure the verification process first starts the applicationserver with your default profile and then connects to the application server to verifythe Servlet engine JavaServer pages and enterprise bean configuration It thenexamines the authentication of the key stores that are used to provide secureconnections between WebSphere components
When the verification process completes you can click the close button in the upperright-hand corner of the output window to close that window and return to the Firststeps console Note that the Start the server link has been replaced by a Stop the
server link because the WebSphere Application Server was started as part of theverification process
Starting the server
If you choose not to verify your WebSphere Application Server installation as
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 21 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2240
described in the previous section you can start the WebSphere Application Servermanually by clicking the Start the server link in the First steps console Clicking thislink displays an output window much like the one shown in Figure 11 except that itonly shows the initial text about starting the server and does not probe theconfiguration of your server
Note If the First steps console does not show a Start the server link but insteaddisplays only a Stop the server link your WebSphere Application Server is alreadyrunning
After a line like ADMU3000I Server NAME open for e-business
displays in the output window you can click the close box in the upper right-handcorner of the output window to close that window and return to the First stepsconsole
Administrative consoleThe WebSphere Application Server Administrative console is the primarymechanism for configuring the application server integrating the application serverwith external applications such as database systems and installing WebSphereapplications If you are new to WebSphere Application Server and want to explorethe administrative console or want to install new WebSphere applicationsimmediately after installing WebSphere you may want to start the Administrativeconsole from the First steps console
Click Administrative console to start the WebSphere Administrative console fromthe First steps console The login screen for the Administrative console opens in abrowser window as shown in Figure 12
Figure 12 Administrative console login screen
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 22 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2340
The Administrative console requires a Secure Sockets Layer (SSL) HTTPconnection generally referred to as a Hypertext Transfer Protocol over SecureSockets Layer (HTTPS) connection The page shown in Figure 12 only displays if avalid third-party SSL certificate is installed on your system If the system on whichyou installed WebSphere Application Server does not have a valid certificate issuedby a third party you will see a warning dialog like that shown in Figure 13 instead
Figure 13 Certificate not trusted alert
If you see this message see the next section of this tutorial for information about
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 23 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2440
configuring a security exception for your systems existing certificate
If you see the Administrative console login screen as shown in Figure 12 enter theadministrative username and password that you defined during the installationprocess and click Login or press Return The WebSphere Application Server
Administrative console displays as shown in Figure 14 You can explore or use theAdministrative console clicking the Logout link in the header when you are done
Figure 14 Administrative console
Configuring a certificate security exception
As discussed in the previous section the WebSphere Application ServerAdministrative console requires an SSL HTTP connection generally referred to asan HTTPS connection According to the default security policies used by mostsystems this means that the public key security certificate presented by your systemmust be a valid certificate issued by a trusted third-party certificate authority such asthawte VeriSign GeoTrust and many others See Resources for more informationabout these third-party certificate authorities
In a production environment you will certainly only want to use WebSphere
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 24 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2540
Application Server on a system with a valid enterprise or third-party securitycertificate so that users of your Web applications can verify the identity of the systemthat they are connecting to However you may be installing and configuringWebSphere Application Server on a new system for which you have not yet obtaineda certificate In this case you can temporarily or permanently define your existing
certificate as a trusted one that is an exception to the standard WebSphere securitypolicy
To define a policy exception click OK in the dialog shown in Figure 13 to display thescreen shown in Figure 15
Figure 15 A secure connection failure in Firefox
Click the Or you can define an exception link to begin the process of identifyingyour systems certificate as a valid digital public key certificate A screen identical to
the current screen displays with the exception of two additional buttons that displayat the bottom of the screen Click Add exception to continue the process of definingthe current certificate as an exception to the default certificate policy The dialogshown in Figure 16 displays
Note Clicking the Get me out of here button exits the exception definition processand returns you to your browser without establishing a connection to the WebSphere
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 25 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2640
Administrative console which isnt all that useful for the purposes of this tutorial
Figure 16 Initial dialog for defining a security exception
Click Get Certificate to retrieve your systems current certificate which displaysinformation about the current certificate and enables the Confirm Security
Exception button at the bottom left of the dialog shown in Figure 16 as shown inFigure 17
Figure 17 Updated dialog for defining a security exception
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 26 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1540
configure an administrative agent server services for managing multipleapplication server environments and an administrative agent to manageother application servers that are on the same machine
bull Application server The default selection this option creates anappropriate profile for installing a stand-alone application server that will
run your enterprise applications and which can only be managed from itsown administrative console
bull None Select this option if you do not want to create an execution profileduring installation Only select this option if you will explicitly create one ormore profiles after WebSphere Application Server is successfully installedon your system
Click Next to proceed with the installation process
Note If you select None as your server execution environment a warning dialogdisplays to inform you that at least one functional profile must be available to runWebSphere Application Server Click Yes to proceed with the installation processwithout creating a profile during the installation process and proceed to Summarypage and actual installation If you want to create a profile during the installationprocess click No to return to the dialog shown in Figure 6 to modify your serverexecution environment setting
Creating an administrative user
The next screen of the installer shown in Figure 7 enables you to create a secureaccount on your system for system administration through the WebSphereApplication Server administrative console
Figure 7 Defining an administrative user
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 15 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1640
Create an administrative user if you are installing a stand-alone or managedWebSphere Application Servermdashin other words when you are installing WebSphereApplication Server in an environment that creates a profile for you during theinstallation process as described earlier in Specifying the WebSphere Application
Server environment
Enter a username and password for use in administering your WebSphereApplication Server and enter the password again to confirm that you typed itcorrectly the first time
If you selected the sample applications for installation in the Selecting optionalfeatures for installation section you will also be prompted to set a password for theuser associated with those sample applications Enter the password twice to ensurethat you have typed it correctly or have at least made the same typo twice
After supplying information about the administrative user (and optionally apassword for the sample applications if you selected them for installation) click Nextto proceed with the installation process
Summary page and actual installation
As shown in Figure 8 a summary screen displays the configuration options that you
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 16 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1740
have accepted or specified and provides a check box that enables you to verify thatyou 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 theresreally no need to verify that you have the required privileges Clear this check boxand click Next to begin the installation process A window displays showing thestatus of the installation process The installation process first creates an uninstallerfor WebSphere Application Server to simplify removing the software if necessary Itthen installs WebSphere Application Server displaying status information as theinstallation proceeds
Installation status and next steps
When the installation finishes the window shown in Figure 9 displays the success orfailure of installation If any errors occur this window shows the location of a log filethat you can examine to identify the problems and determine whether they weremeaningful
Figure 9 Summary information about your installation
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 17 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1840
This screen provides a check box that because it is selected by default starts theWebSphere Application Server First steps console when you exit the installer TheFirst steps console enables you to do some initial configuration of WebSphereApplication Server
At this point you have two options
bull Leave the Launch the First steps console check box selected and clickFinish to exit the installer and start the First steps console
bull Clear the Launch the First steps console check box and click Finish toexit the installer without starting the First steps console or WebSphereApplication Server
Congratulations Youve installed WebSphere Application Server If you started theFirst steps console proceed to the next section for information about using thatconsole Otherwise you may want to do one of the following
bull Start the WebSphere Application Server manually
bull Integrate WebSphere Application Server with your systems Web server
bull Integrate WebSphere Application Server into your systems startup and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 18 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1940
shutdown processes
bull Access the WebSphere administrative console to begin configuring yourWebSphere Application Server
Section 4 Using the First steps console
The WebSphere Application Server installation process can automatically start aFirst steps console to help you familiarize yourself with WebSphere ApplicationServer and perform some initial configuration tasks Figure 10 shows the initialscreen of the First steps console
Figure 10 First steps console
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 19 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2040
As shown in Figure 10 the First steps console provides links to a number ofconvenient tasks that you may want to perform immediately after installationincluding
bull Installation verification Checks your WebSphere Application Server
installation to verify that it is installed correctly and starts the applicationserver as part of this check
bull Start the Server Starts the WebSphere Application Server displayingthe output of the startup process in a separate window for convenienceand diagnostic purposes When the application server is running this linkchanges to a Stop the server link which provides a convenient way tostop the server and displays the output of the server shutdown process ina separate window Stopping the server requires the administrativepassword that you set during the installation process and provides aconvenient check that the application servers internal authentication
mechanism is working correctlybull Administrative console Starts the WebSphere Administrative console
in a browser window enabling you to perform configuration tasks that areoutside the scope of the installation process Starting the administrativeconsole also requires the administrative password that you set during theinstallation process
bull Profile management tool Enables you to create additional executionprofiles each of which can be for use with specific enterprise Webapplications port configurations and so on If you did not specify a targetserver environment during the installation process and are not migrating
server configuration information from an existing WebSphere ApplicationServer installation use this option to create at least one WebSphereApplication Server profile You cannot start WebSphere ApplicationServer without at least one profilemdasheach profile provides the configurationinformation required to start the application server in a specific context
bull Samples gallery Provides access to the sample applications youinstalled during the installation process
bull Information center for WebSphere Application Server Opens theWebSphere Application Server Library Web site in a browser to providedetailed information about WebSphere Application Server in a variety of
enterprise application scenarios
bull Migration wizard Starts a wizard that simplifies migrating configurationinformation and applications from earlier versions of WebSphereApplication Server
The next few sections provide highlights of using selected options from the Firststeps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 20 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2140
Installation verification
Though error messages would have displayed had any problems occurred duringthe WebSphere Application Server installation process its always comforting to be
able to double-check that your application server installation is complete and that allthe necessary configuration files were created correctly during that process
To verify that WebSphere Application Server was installed correctly on your systemand start it as part of the testing process click the Installation verification link inthe First steps console A window like the one shown in Figure 11 displays
Figure 11 Output of the verification process
As you can see from this figure the verification process first starts the applicationserver with your default profile and then connects to the application server to verifythe Servlet engine JavaServer pages and enterprise bean configuration It thenexamines the authentication of the key stores that are used to provide secureconnections between WebSphere components
When the verification process completes you can click the close button in the upperright-hand corner of the output window to close that window and return to the Firststeps console Note that the Start the server link has been replaced by a Stop the
server link because the WebSphere Application Server was started as part of theverification process
Starting the server
If you choose not to verify your WebSphere Application Server installation as
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 21 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2240
described in the previous section you can start the WebSphere Application Servermanually by clicking the Start the server link in the First steps console Clicking thislink displays an output window much like the one shown in Figure 11 except that itonly shows the initial text about starting the server and does not probe theconfiguration of your server
Note If the First steps console does not show a Start the server link but insteaddisplays only a Stop the server link your WebSphere Application Server is alreadyrunning
After a line like ADMU3000I Server NAME open for e-business
displays in the output window you can click the close box in the upper right-handcorner of the output window to close that window and return to the First stepsconsole
Administrative consoleThe WebSphere Application Server Administrative console is the primarymechanism for configuring the application server integrating the application serverwith external applications such as database systems and installing WebSphereapplications If you are new to WebSphere Application Server and want to explorethe administrative console or want to install new WebSphere applicationsimmediately after installing WebSphere you may want to start the Administrativeconsole from the First steps console
Click Administrative console to start the WebSphere Administrative console fromthe First steps console The login screen for the Administrative console opens in abrowser window as shown in Figure 12
Figure 12 Administrative console login screen
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 22 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2340
The Administrative console requires a Secure Sockets Layer (SSL) HTTPconnection generally referred to as a Hypertext Transfer Protocol over SecureSockets Layer (HTTPS) connection The page shown in Figure 12 only displays if avalid third-party SSL certificate is installed on your system If the system on whichyou installed WebSphere Application Server does not have a valid certificate issuedby a third party you will see a warning dialog like that shown in Figure 13 instead
Figure 13 Certificate not trusted alert
If you see this message see the next section of this tutorial for information about
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 23 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2440
configuring a security exception for your systems existing certificate
If you see the Administrative console login screen as shown in Figure 12 enter theadministrative username and password that you defined during the installationprocess and click Login or press Return The WebSphere Application Server
Administrative console displays as shown in Figure 14 You can explore or use theAdministrative console clicking the Logout link in the header when you are done
Figure 14 Administrative console
Configuring a certificate security exception
As discussed in the previous section the WebSphere Application ServerAdministrative console requires an SSL HTTP connection generally referred to asan HTTPS connection According to the default security policies used by mostsystems this means that the public key security certificate presented by your systemmust be a valid certificate issued by a trusted third-party certificate authority such asthawte VeriSign GeoTrust and many others See Resources for more informationabout these third-party certificate authorities
In a production environment you will certainly only want to use WebSphere
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 24 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2540
Application Server on a system with a valid enterprise or third-party securitycertificate so that users of your Web applications can verify the identity of the systemthat they are connecting to However you may be installing and configuringWebSphere Application Server on a new system for which you have not yet obtaineda certificate In this case you can temporarily or permanently define your existing
certificate as a trusted one that is an exception to the standard WebSphere securitypolicy
To define a policy exception click OK in the dialog shown in Figure 13 to display thescreen shown in Figure 15
Figure 15 A secure connection failure in Firefox
Click the Or you can define an exception link to begin the process of identifyingyour systems certificate as a valid digital public key certificate A screen identical to
the current screen displays with the exception of two additional buttons that displayat the bottom of the screen Click Add exception to continue the process of definingthe current certificate as an exception to the default certificate policy The dialogshown in Figure 16 displays
Note Clicking the Get me out of here button exits the exception definition processand returns you to your browser without establishing a connection to the WebSphere
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 25 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2640
Administrative console which isnt all that useful for the purposes of this tutorial
Figure 16 Initial dialog for defining a security exception
Click Get Certificate to retrieve your systems current certificate which displaysinformation about the current certificate and enables the Confirm Security
Exception button at the bottom left of the dialog shown in Figure 16 as shown inFigure 17
Figure 17 Updated dialog for defining a security exception
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 26 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1640
Create an administrative user if you are installing a stand-alone or managedWebSphere Application Servermdashin other words when you are installing WebSphereApplication Server in an environment that creates a profile for you during theinstallation process as described earlier in Specifying the WebSphere Application
Server environment
Enter a username and password for use in administering your WebSphereApplication Server and enter the password again to confirm that you typed itcorrectly the first time
If you selected the sample applications for installation in the Selecting optionalfeatures for installation section you will also be prompted to set a password for theuser associated with those sample applications Enter the password twice to ensurethat you have typed it correctly or have at least made the same typo twice
After supplying information about the administrative user (and optionally apassword for the sample applications if you selected them for installation) click Nextto proceed with the installation process
Summary page and actual installation
As shown in Figure 8 a summary screen displays the configuration options that you
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 16 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1740
have accepted or specified and provides a check box that enables you to verify thatyou 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 theresreally no need to verify that you have the required privileges Clear this check boxand click Next to begin the installation process A window displays showing thestatus of the installation process The installation process first creates an uninstallerfor WebSphere Application Server to simplify removing the software if necessary Itthen installs WebSphere Application Server displaying status information as theinstallation proceeds
Installation status and next steps
When the installation finishes the window shown in Figure 9 displays the success orfailure of installation If any errors occur this window shows the location of a log filethat you can examine to identify the problems and determine whether they weremeaningful
Figure 9 Summary information about your installation
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 17 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1840
This screen provides a check box that because it is selected by default starts theWebSphere Application Server First steps console when you exit the installer TheFirst steps console enables you to do some initial configuration of WebSphereApplication Server
At this point you have two options
bull Leave the Launch the First steps console check box selected and clickFinish to exit the installer and start the First steps console
bull Clear the Launch the First steps console check box and click Finish toexit the installer without starting the First steps console or WebSphereApplication Server
Congratulations Youve installed WebSphere Application Server If you started theFirst steps console proceed to the next section for information about using thatconsole Otherwise you may want to do one of the following
bull Start the WebSphere Application Server manually
bull Integrate WebSphere Application Server with your systems Web server
bull Integrate WebSphere Application Server into your systems startup and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 18 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1940
shutdown processes
bull Access the WebSphere administrative console to begin configuring yourWebSphere Application Server
Section 4 Using the First steps console
The WebSphere Application Server installation process can automatically start aFirst steps console to help you familiarize yourself with WebSphere ApplicationServer and perform some initial configuration tasks Figure 10 shows the initialscreen of the First steps console
Figure 10 First steps console
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 19 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2040
As shown in Figure 10 the First steps console provides links to a number ofconvenient tasks that you may want to perform immediately after installationincluding
bull Installation verification Checks your WebSphere Application Server
installation to verify that it is installed correctly and starts the applicationserver as part of this check
bull Start the Server Starts the WebSphere Application Server displayingthe output of the startup process in a separate window for convenienceand diagnostic purposes When the application server is running this linkchanges to a Stop the server link which provides a convenient way tostop the server and displays the output of the server shutdown process ina separate window Stopping the server requires the administrativepassword that you set during the installation process and provides aconvenient check that the application servers internal authentication
mechanism is working correctlybull Administrative console Starts the WebSphere Administrative console
in a browser window enabling you to perform configuration tasks that areoutside the scope of the installation process Starting the administrativeconsole also requires the administrative password that you set during theinstallation process
bull Profile management tool Enables you to create additional executionprofiles each of which can be for use with specific enterprise Webapplications port configurations and so on If you did not specify a targetserver environment during the installation process and are not migrating
server configuration information from an existing WebSphere ApplicationServer installation use this option to create at least one WebSphereApplication Server profile You cannot start WebSphere ApplicationServer without at least one profilemdasheach profile provides the configurationinformation required to start the application server in a specific context
bull Samples gallery Provides access to the sample applications youinstalled during the installation process
bull Information center for WebSphere Application Server Opens theWebSphere Application Server Library Web site in a browser to providedetailed information about WebSphere Application Server in a variety of
enterprise application scenarios
bull Migration wizard Starts a wizard that simplifies migrating configurationinformation and applications from earlier versions of WebSphereApplication Server
The next few sections provide highlights of using selected options from the Firststeps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 20 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2140
Installation verification
Though error messages would have displayed had any problems occurred duringthe WebSphere Application Server installation process its always comforting to be
able to double-check that your application server installation is complete and that allthe necessary configuration files were created correctly during that process
To verify that WebSphere Application Server was installed correctly on your systemand start it as part of the testing process click the Installation verification link inthe First steps console A window like the one shown in Figure 11 displays
Figure 11 Output of the verification process
As you can see from this figure the verification process first starts the applicationserver with your default profile and then connects to the application server to verifythe Servlet engine JavaServer pages and enterprise bean configuration It thenexamines the authentication of the key stores that are used to provide secureconnections between WebSphere components
When the verification process completes you can click the close button in the upperright-hand corner of the output window to close that window and return to the Firststeps console Note that the Start the server link has been replaced by a Stop the
server link because the WebSphere Application Server was started as part of theverification process
Starting the server
If you choose not to verify your WebSphere Application Server installation as
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 21 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2240
described in the previous section you can start the WebSphere Application Servermanually by clicking the Start the server link in the First steps console Clicking thislink displays an output window much like the one shown in Figure 11 except that itonly shows the initial text about starting the server and does not probe theconfiguration of your server
Note If the First steps console does not show a Start the server link but insteaddisplays only a Stop the server link your WebSphere Application Server is alreadyrunning
After a line like ADMU3000I Server NAME open for e-business
displays in the output window you can click the close box in the upper right-handcorner of the output window to close that window and return to the First stepsconsole
Administrative consoleThe WebSphere Application Server Administrative console is the primarymechanism for configuring the application server integrating the application serverwith external applications such as database systems and installing WebSphereapplications If you are new to WebSphere Application Server and want to explorethe administrative console or want to install new WebSphere applicationsimmediately after installing WebSphere you may want to start the Administrativeconsole from the First steps console
Click Administrative console to start the WebSphere Administrative console fromthe First steps console The login screen for the Administrative console opens in abrowser window as shown in Figure 12
Figure 12 Administrative console login screen
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 22 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2340
The Administrative console requires a Secure Sockets Layer (SSL) HTTPconnection generally referred to as a Hypertext Transfer Protocol over SecureSockets Layer (HTTPS) connection The page shown in Figure 12 only displays if avalid third-party SSL certificate is installed on your system If the system on whichyou installed WebSphere Application Server does not have a valid certificate issuedby a third party you will see a warning dialog like that shown in Figure 13 instead
Figure 13 Certificate not trusted alert
If you see this message see the next section of this tutorial for information about
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 23 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2440
configuring a security exception for your systems existing certificate
If you see the Administrative console login screen as shown in Figure 12 enter theadministrative username and password that you defined during the installationprocess and click Login or press Return The WebSphere Application Server
Administrative console displays as shown in Figure 14 You can explore or use theAdministrative console clicking the Logout link in the header when you are done
Figure 14 Administrative console
Configuring a certificate security exception
As discussed in the previous section the WebSphere Application ServerAdministrative console requires an SSL HTTP connection generally referred to asan HTTPS connection According to the default security policies used by mostsystems this means that the public key security certificate presented by your systemmust be a valid certificate issued by a trusted third-party certificate authority such asthawte VeriSign GeoTrust and many others See Resources for more informationabout these third-party certificate authorities
In a production environment you will certainly only want to use WebSphere
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 24 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2540
Application Server on a system with a valid enterprise or third-party securitycertificate so that users of your Web applications can verify the identity of the systemthat they are connecting to However you may be installing and configuringWebSphere Application Server on a new system for which you have not yet obtaineda certificate In this case you can temporarily or permanently define your existing
certificate as a trusted one that is an exception to the standard WebSphere securitypolicy
To define a policy exception click OK in the dialog shown in Figure 13 to display thescreen shown in Figure 15
Figure 15 A secure connection failure in Firefox
Click the Or you can define an exception link to begin the process of identifyingyour systems certificate as a valid digital public key certificate A screen identical to
the current screen displays with the exception of two additional buttons that displayat the bottom of the screen Click Add exception to continue the process of definingthe current certificate as an exception to the default certificate policy The dialogshown in Figure 16 displays
Note Clicking the Get me out of here button exits the exception definition processand returns you to your browser without establishing a connection to the WebSphere
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 25 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2640
Administrative console which isnt all that useful for the purposes of this tutorial
Figure 16 Initial dialog for defining a security exception
Click Get Certificate to retrieve your systems current certificate which displaysinformation about the current certificate and enables the Confirm Security
Exception button at the bottom left of the dialog shown in Figure 16 as shown inFigure 17
Figure 17 Updated dialog for defining a security exception
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 26 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1740
have accepted or specified and provides a check box that enables you to verify thatyou 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 theresreally no need to verify that you have the required privileges Clear this check boxand click Next to begin the installation process A window displays showing thestatus of the installation process The installation process first creates an uninstallerfor WebSphere Application Server to simplify removing the software if necessary Itthen installs WebSphere Application Server displaying status information as theinstallation proceeds
Installation status and next steps
When the installation finishes the window shown in Figure 9 displays the success orfailure of installation If any errors occur this window shows the location of a log filethat you can examine to identify the problems and determine whether they weremeaningful
Figure 9 Summary information about your installation
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 17 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1840
This screen provides a check box that because it is selected by default starts theWebSphere Application Server First steps console when you exit the installer TheFirst steps console enables you to do some initial configuration of WebSphereApplication Server
At this point you have two options
bull Leave the Launch the First steps console check box selected and clickFinish to exit the installer and start the First steps console
bull Clear the Launch the First steps console check box and click Finish toexit the installer without starting the First steps console or WebSphereApplication Server
Congratulations Youve installed WebSphere Application Server If you started theFirst steps console proceed to the next section for information about using thatconsole Otherwise you may want to do one of the following
bull Start the WebSphere Application Server manually
bull Integrate WebSphere Application Server with your systems Web server
bull Integrate WebSphere Application Server into your systems startup and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 18 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1940
shutdown processes
bull Access the WebSphere administrative console to begin configuring yourWebSphere Application Server
Section 4 Using the First steps console
The WebSphere Application Server installation process can automatically start aFirst steps console to help you familiarize yourself with WebSphere ApplicationServer and perform some initial configuration tasks Figure 10 shows the initialscreen of the First steps console
Figure 10 First steps console
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 19 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2040
As shown in Figure 10 the First steps console provides links to a number ofconvenient tasks that you may want to perform immediately after installationincluding
bull Installation verification Checks your WebSphere Application Server
installation to verify that it is installed correctly and starts the applicationserver as part of this check
bull Start the Server Starts the WebSphere Application Server displayingthe output of the startup process in a separate window for convenienceand diagnostic purposes When the application server is running this linkchanges to a Stop the server link which provides a convenient way tostop the server and displays the output of the server shutdown process ina separate window Stopping the server requires the administrativepassword that you set during the installation process and provides aconvenient check that the application servers internal authentication
mechanism is working correctlybull Administrative console Starts the WebSphere Administrative console
in a browser window enabling you to perform configuration tasks that areoutside the scope of the installation process Starting the administrativeconsole also requires the administrative password that you set during theinstallation process
bull Profile management tool Enables you to create additional executionprofiles each of which can be for use with specific enterprise Webapplications port configurations and so on If you did not specify a targetserver environment during the installation process and are not migrating
server configuration information from an existing WebSphere ApplicationServer installation use this option to create at least one WebSphereApplication Server profile You cannot start WebSphere ApplicationServer without at least one profilemdasheach profile provides the configurationinformation required to start the application server in a specific context
bull Samples gallery Provides access to the sample applications youinstalled during the installation process
bull Information center for WebSphere Application Server Opens theWebSphere Application Server Library Web site in a browser to providedetailed information about WebSphere Application Server in a variety of
enterprise application scenarios
bull Migration wizard Starts a wizard that simplifies migrating configurationinformation and applications from earlier versions of WebSphereApplication Server
The next few sections provide highlights of using selected options from the Firststeps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 20 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2140
Installation verification
Though error messages would have displayed had any problems occurred duringthe WebSphere Application Server installation process its always comforting to be
able to double-check that your application server installation is complete and that allthe necessary configuration files were created correctly during that process
To verify that WebSphere Application Server was installed correctly on your systemand start it as part of the testing process click the Installation verification link inthe First steps console A window like the one shown in Figure 11 displays
Figure 11 Output of the verification process
As you can see from this figure the verification process first starts the applicationserver with your default profile and then connects to the application server to verifythe Servlet engine JavaServer pages and enterprise bean configuration It thenexamines the authentication of the key stores that are used to provide secureconnections between WebSphere components
When the verification process completes you can click the close button in the upperright-hand corner of the output window to close that window and return to the Firststeps console Note that the Start the server link has been replaced by a Stop the
server link because the WebSphere Application Server was started as part of theverification process
Starting the server
If you choose not to verify your WebSphere Application Server installation as
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 21 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2240
described in the previous section you can start the WebSphere Application Servermanually by clicking the Start the server link in the First steps console Clicking thislink displays an output window much like the one shown in Figure 11 except that itonly shows the initial text about starting the server and does not probe theconfiguration of your server
Note If the First steps console does not show a Start the server link but insteaddisplays only a Stop the server link your WebSphere Application Server is alreadyrunning
After a line like ADMU3000I Server NAME open for e-business
displays in the output window you can click the close box in the upper right-handcorner of the output window to close that window and return to the First stepsconsole
Administrative consoleThe WebSphere Application Server Administrative console is the primarymechanism for configuring the application server integrating the application serverwith external applications such as database systems and installing WebSphereapplications If you are new to WebSphere Application Server and want to explorethe administrative console or want to install new WebSphere applicationsimmediately after installing WebSphere you may want to start the Administrativeconsole from the First steps console
Click Administrative console to start the WebSphere Administrative console fromthe First steps console The login screen for the Administrative console opens in abrowser window as shown in Figure 12
Figure 12 Administrative console login screen
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 22 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2340
The Administrative console requires a Secure Sockets Layer (SSL) HTTPconnection generally referred to as a Hypertext Transfer Protocol over SecureSockets Layer (HTTPS) connection The page shown in Figure 12 only displays if avalid third-party SSL certificate is installed on your system If the system on whichyou installed WebSphere Application Server does not have a valid certificate issuedby a third party you will see a warning dialog like that shown in Figure 13 instead
Figure 13 Certificate not trusted alert
If you see this message see the next section of this tutorial for information about
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 23 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2440
configuring a security exception for your systems existing certificate
If you see the Administrative console login screen as shown in Figure 12 enter theadministrative username and password that you defined during the installationprocess and click Login or press Return The WebSphere Application Server
Administrative console displays as shown in Figure 14 You can explore or use theAdministrative console clicking the Logout link in the header when you are done
Figure 14 Administrative console
Configuring a certificate security exception
As discussed in the previous section the WebSphere Application ServerAdministrative console requires an SSL HTTP connection generally referred to asan HTTPS connection According to the default security policies used by mostsystems this means that the public key security certificate presented by your systemmust be a valid certificate issued by a trusted third-party certificate authority such asthawte VeriSign GeoTrust and many others See Resources for more informationabout these third-party certificate authorities
In a production environment you will certainly only want to use WebSphere
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 24 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2540
Application Server on a system with a valid enterprise or third-party securitycertificate so that users of your Web applications can verify the identity of the systemthat they are connecting to However you may be installing and configuringWebSphere Application Server on a new system for which you have not yet obtaineda certificate In this case you can temporarily or permanently define your existing
certificate as a trusted one that is an exception to the standard WebSphere securitypolicy
To define a policy exception click OK in the dialog shown in Figure 13 to display thescreen shown in Figure 15
Figure 15 A secure connection failure in Firefox
Click the Or you can define an exception link to begin the process of identifyingyour systems certificate as a valid digital public key certificate A screen identical to
the current screen displays with the exception of two additional buttons that displayat the bottom of the screen Click Add exception to continue the process of definingthe current certificate as an exception to the default certificate policy The dialogshown in Figure 16 displays
Note Clicking the Get me out of here button exits the exception definition processand returns you to your browser without establishing a connection to the WebSphere
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 25 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2640
Administrative console which isnt all that useful for the purposes of this tutorial
Figure 16 Initial dialog for defining a security exception
Click Get Certificate to retrieve your systems current certificate which displaysinformation about the current certificate and enables the Confirm Security
Exception button at the bottom left of the dialog shown in Figure 16 as shown inFigure 17
Figure 17 Updated dialog for defining a security exception
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 26 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1840
This screen provides a check box that because it is selected by default starts theWebSphere Application Server First steps console when you exit the installer TheFirst steps console enables you to do some initial configuration of WebSphereApplication Server
At this point you have two options
bull Leave the Launch the First steps console check box selected and clickFinish to exit the installer and start the First steps console
bull Clear the Launch the First steps console check box and click Finish toexit the installer without starting the First steps console or WebSphereApplication Server
Congratulations Youve installed WebSphere Application Server If you started theFirst steps console proceed to the next section for information about using thatconsole Otherwise you may want to do one of the following
bull Start the WebSphere Application Server manually
bull Integrate WebSphere Application Server with your systems Web server
bull Integrate WebSphere Application Server into your systems startup and
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 18 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1940
shutdown processes
bull Access the WebSphere administrative console to begin configuring yourWebSphere Application Server
Section 4 Using the First steps console
The WebSphere Application Server installation process can automatically start aFirst steps console to help you familiarize yourself with WebSphere ApplicationServer and perform some initial configuration tasks Figure 10 shows the initialscreen of the First steps console
Figure 10 First steps console
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 19 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2040
As shown in Figure 10 the First steps console provides links to a number ofconvenient tasks that you may want to perform immediately after installationincluding
bull Installation verification Checks your WebSphere Application Server
installation to verify that it is installed correctly and starts the applicationserver as part of this check
bull Start the Server Starts the WebSphere Application Server displayingthe output of the startup process in a separate window for convenienceand diagnostic purposes When the application server is running this linkchanges to a Stop the server link which provides a convenient way tostop the server and displays the output of the server shutdown process ina separate window Stopping the server requires the administrativepassword that you set during the installation process and provides aconvenient check that the application servers internal authentication
mechanism is working correctlybull Administrative console Starts the WebSphere Administrative console
in a browser window enabling you to perform configuration tasks that areoutside the scope of the installation process Starting the administrativeconsole also requires the administrative password that you set during theinstallation process
bull Profile management tool Enables you to create additional executionprofiles each of which can be for use with specific enterprise Webapplications port configurations and so on If you did not specify a targetserver environment during the installation process and are not migrating
server configuration information from an existing WebSphere ApplicationServer installation use this option to create at least one WebSphereApplication Server profile You cannot start WebSphere ApplicationServer without at least one profilemdasheach profile provides the configurationinformation required to start the application server in a specific context
bull Samples gallery Provides access to the sample applications youinstalled during the installation process
bull Information center for WebSphere Application Server Opens theWebSphere Application Server Library Web site in a browser to providedetailed information about WebSphere Application Server in a variety of
enterprise application scenarios
bull Migration wizard Starts a wizard that simplifies migrating configurationinformation and applications from earlier versions of WebSphereApplication Server
The next few sections provide highlights of using selected options from the Firststeps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 20 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2140
Installation verification
Though error messages would have displayed had any problems occurred duringthe WebSphere Application Server installation process its always comforting to be
able to double-check that your application server installation is complete and that allthe necessary configuration files were created correctly during that process
To verify that WebSphere Application Server was installed correctly on your systemand start it as part of the testing process click the Installation verification link inthe First steps console A window like the one shown in Figure 11 displays
Figure 11 Output of the verification process
As you can see from this figure the verification process first starts the applicationserver with your default profile and then connects to the application server to verifythe Servlet engine JavaServer pages and enterprise bean configuration It thenexamines the authentication of the key stores that are used to provide secureconnections between WebSphere components
When the verification process completes you can click the close button in the upperright-hand corner of the output window to close that window and return to the Firststeps console Note that the Start the server link has been replaced by a Stop the
server link because the WebSphere Application Server was started as part of theverification process
Starting the server
If you choose not to verify your WebSphere Application Server installation as
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 21 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2240
described in the previous section you can start the WebSphere Application Servermanually by clicking the Start the server link in the First steps console Clicking thislink displays an output window much like the one shown in Figure 11 except that itonly shows the initial text about starting the server and does not probe theconfiguration of your server
Note If the First steps console does not show a Start the server link but insteaddisplays only a Stop the server link your WebSphere Application Server is alreadyrunning
After a line like ADMU3000I Server NAME open for e-business
displays in the output window you can click the close box in the upper right-handcorner of the output window to close that window and return to the First stepsconsole
Administrative consoleThe WebSphere Application Server Administrative console is the primarymechanism for configuring the application server integrating the application serverwith external applications such as database systems and installing WebSphereapplications If you are new to WebSphere Application Server and want to explorethe administrative console or want to install new WebSphere applicationsimmediately after installing WebSphere you may want to start the Administrativeconsole from the First steps console
Click Administrative console to start the WebSphere Administrative console fromthe First steps console The login screen for the Administrative console opens in abrowser window as shown in Figure 12
Figure 12 Administrative console login screen
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 22 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2340
The Administrative console requires a Secure Sockets Layer (SSL) HTTPconnection generally referred to as a Hypertext Transfer Protocol over SecureSockets Layer (HTTPS) connection The page shown in Figure 12 only displays if avalid third-party SSL certificate is installed on your system If the system on whichyou installed WebSphere Application Server does not have a valid certificate issuedby a third party you will see a warning dialog like that shown in Figure 13 instead
Figure 13 Certificate not trusted alert
If you see this message see the next section of this tutorial for information about
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 23 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2440
configuring a security exception for your systems existing certificate
If you see the Administrative console login screen as shown in Figure 12 enter theadministrative username and password that you defined during the installationprocess and click Login or press Return The WebSphere Application Server
Administrative console displays as shown in Figure 14 You can explore or use theAdministrative console clicking the Logout link in the header when you are done
Figure 14 Administrative console
Configuring a certificate security exception
As discussed in the previous section the WebSphere Application ServerAdministrative console requires an SSL HTTP connection generally referred to asan HTTPS connection According to the default security policies used by mostsystems this means that the public key security certificate presented by your systemmust be a valid certificate issued by a trusted third-party certificate authority such asthawte VeriSign GeoTrust and many others See Resources for more informationabout these third-party certificate authorities
In a production environment you will certainly only want to use WebSphere
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 24 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2540
Application Server on a system with a valid enterprise or third-party securitycertificate so that users of your Web applications can verify the identity of the systemthat they are connecting to However you may be installing and configuringWebSphere Application Server on a new system for which you have not yet obtaineda certificate In this case you can temporarily or permanently define your existing
certificate as a trusted one that is an exception to the standard WebSphere securitypolicy
To define a policy exception click OK in the dialog shown in Figure 13 to display thescreen shown in Figure 15
Figure 15 A secure connection failure in Firefox
Click the Or you can define an exception link to begin the process of identifyingyour systems certificate as a valid digital public key certificate A screen identical to
the current screen displays with the exception of two additional buttons that displayat the bottom of the screen Click Add exception to continue the process of definingthe current certificate as an exception to the default certificate policy The dialogshown in Figure 16 displays
Note Clicking the Get me out of here button exits the exception definition processand returns you to your browser without establishing a connection to the WebSphere
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 25 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2640
Administrative console which isnt all that useful for the purposes of this tutorial
Figure 16 Initial dialog for defining a security exception
Click Get Certificate to retrieve your systems current certificate which displaysinformation about the current certificate and enables the Confirm Security
Exception button at the bottom left of the dialog shown in Figure 16 as shown inFigure 17
Figure 17 Updated dialog for defining a security exception
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 26 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 1940
shutdown processes
bull Access the WebSphere administrative console to begin configuring yourWebSphere Application Server
Section 4 Using the First steps console
The WebSphere Application Server installation process can automatically start aFirst steps console to help you familiarize yourself with WebSphere ApplicationServer and perform some initial configuration tasks Figure 10 shows the initialscreen of the First steps console
Figure 10 First steps console
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 19 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2040
As shown in Figure 10 the First steps console provides links to a number ofconvenient tasks that you may want to perform immediately after installationincluding
bull Installation verification Checks your WebSphere Application Server
installation to verify that it is installed correctly and starts the applicationserver as part of this check
bull Start the Server Starts the WebSphere Application Server displayingthe output of the startup process in a separate window for convenienceand diagnostic purposes When the application server is running this linkchanges to a Stop the server link which provides a convenient way tostop the server and displays the output of the server shutdown process ina separate window Stopping the server requires the administrativepassword that you set during the installation process and provides aconvenient check that the application servers internal authentication
mechanism is working correctlybull Administrative console Starts the WebSphere Administrative console
in a browser window enabling you to perform configuration tasks that areoutside the scope of the installation process Starting the administrativeconsole also requires the administrative password that you set during theinstallation process
bull Profile management tool Enables you to create additional executionprofiles each of which can be for use with specific enterprise Webapplications port configurations and so on If you did not specify a targetserver environment during the installation process and are not migrating
server configuration information from an existing WebSphere ApplicationServer installation use this option to create at least one WebSphereApplication Server profile You cannot start WebSphere ApplicationServer without at least one profilemdasheach profile provides the configurationinformation required to start the application server in a specific context
bull Samples gallery Provides access to the sample applications youinstalled during the installation process
bull Information center for WebSphere Application Server Opens theWebSphere Application Server Library Web site in a browser to providedetailed information about WebSphere Application Server in a variety of
enterprise application scenarios
bull Migration wizard Starts a wizard that simplifies migrating configurationinformation and applications from earlier versions of WebSphereApplication Server
The next few sections provide highlights of using selected options from the Firststeps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 20 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2140
Installation verification
Though error messages would have displayed had any problems occurred duringthe WebSphere Application Server installation process its always comforting to be
able to double-check that your application server installation is complete and that allthe necessary configuration files were created correctly during that process
To verify that WebSphere Application Server was installed correctly on your systemand start it as part of the testing process click the Installation verification link inthe First steps console A window like the one shown in Figure 11 displays
Figure 11 Output of the verification process
As you can see from this figure the verification process first starts the applicationserver with your default profile and then connects to the application server to verifythe Servlet engine JavaServer pages and enterprise bean configuration It thenexamines the authentication of the key stores that are used to provide secureconnections between WebSphere components
When the verification process completes you can click the close button in the upperright-hand corner of the output window to close that window and return to the Firststeps console Note that the Start the server link has been replaced by a Stop the
server link because the WebSphere Application Server was started as part of theverification process
Starting the server
If you choose not to verify your WebSphere Application Server installation as
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 21 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2240
described in the previous section you can start the WebSphere Application Servermanually by clicking the Start the server link in the First steps console Clicking thislink displays an output window much like the one shown in Figure 11 except that itonly shows the initial text about starting the server and does not probe theconfiguration of your server
Note If the First steps console does not show a Start the server link but insteaddisplays only a Stop the server link your WebSphere Application Server is alreadyrunning
After a line like ADMU3000I Server NAME open for e-business
displays in the output window you can click the close box in the upper right-handcorner of the output window to close that window and return to the First stepsconsole
Administrative consoleThe WebSphere Application Server Administrative console is the primarymechanism for configuring the application server integrating the application serverwith external applications such as database systems and installing WebSphereapplications If you are new to WebSphere Application Server and want to explorethe administrative console or want to install new WebSphere applicationsimmediately after installing WebSphere you may want to start the Administrativeconsole from the First steps console
Click Administrative console to start the WebSphere Administrative console fromthe First steps console The login screen for the Administrative console opens in abrowser window as shown in Figure 12
Figure 12 Administrative console login screen
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 22 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2340
The Administrative console requires a Secure Sockets Layer (SSL) HTTPconnection generally referred to as a Hypertext Transfer Protocol over SecureSockets Layer (HTTPS) connection The page shown in Figure 12 only displays if avalid third-party SSL certificate is installed on your system If the system on whichyou installed WebSphere Application Server does not have a valid certificate issuedby a third party you will see a warning dialog like that shown in Figure 13 instead
Figure 13 Certificate not trusted alert
If you see this message see the next section of this tutorial for information about
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 23 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2440
configuring a security exception for your systems existing certificate
If you see the Administrative console login screen as shown in Figure 12 enter theadministrative username and password that you defined during the installationprocess and click Login or press Return The WebSphere Application Server
Administrative console displays as shown in Figure 14 You can explore or use theAdministrative console clicking the Logout link in the header when you are done
Figure 14 Administrative console
Configuring a certificate security exception
As discussed in the previous section the WebSphere Application ServerAdministrative console requires an SSL HTTP connection generally referred to asan HTTPS connection According to the default security policies used by mostsystems this means that the public key security certificate presented by your systemmust be a valid certificate issued by a trusted third-party certificate authority such asthawte VeriSign GeoTrust and many others See Resources for more informationabout these third-party certificate authorities
In a production environment you will certainly only want to use WebSphere
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 24 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2540
Application Server on a system with a valid enterprise or third-party securitycertificate so that users of your Web applications can verify the identity of the systemthat they are connecting to However you may be installing and configuringWebSphere Application Server on a new system for which you have not yet obtaineda certificate In this case you can temporarily or permanently define your existing
certificate as a trusted one that is an exception to the standard WebSphere securitypolicy
To define a policy exception click OK in the dialog shown in Figure 13 to display thescreen shown in Figure 15
Figure 15 A secure connection failure in Firefox
Click the Or you can define an exception link to begin the process of identifyingyour systems certificate as a valid digital public key certificate A screen identical to
the current screen displays with the exception of two additional buttons that displayat the bottom of the screen Click Add exception to continue the process of definingthe current certificate as an exception to the default certificate policy The dialogshown in Figure 16 displays
Note Clicking the Get me out of here button exits the exception definition processand returns you to your browser without establishing a connection to the WebSphere
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 25 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2640
Administrative console which isnt all that useful for the purposes of this tutorial
Figure 16 Initial dialog for defining a security exception
Click Get Certificate to retrieve your systems current certificate which displaysinformation about the current certificate and enables the Confirm Security
Exception button at the bottom left of the dialog shown in Figure 16 as shown inFigure 17
Figure 17 Updated dialog for defining a security exception
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 26 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2040
As shown in Figure 10 the First steps console provides links to a number ofconvenient tasks that you may want to perform immediately after installationincluding
bull Installation verification Checks your WebSphere Application Server
installation to verify that it is installed correctly and starts the applicationserver as part of this check
bull Start the Server Starts the WebSphere Application Server displayingthe output of the startup process in a separate window for convenienceand diagnostic purposes When the application server is running this linkchanges to a Stop the server link which provides a convenient way tostop the server and displays the output of the server shutdown process ina separate window Stopping the server requires the administrativepassword that you set during the installation process and provides aconvenient check that the application servers internal authentication
mechanism is working correctlybull Administrative console Starts the WebSphere Administrative console
in a browser window enabling you to perform configuration tasks that areoutside the scope of the installation process Starting the administrativeconsole also requires the administrative password that you set during theinstallation process
bull Profile management tool Enables you to create additional executionprofiles each of which can be for use with specific enterprise Webapplications port configurations and so on If you did not specify a targetserver environment during the installation process and are not migrating
server configuration information from an existing WebSphere ApplicationServer installation use this option to create at least one WebSphereApplication Server profile You cannot start WebSphere ApplicationServer without at least one profilemdasheach profile provides the configurationinformation required to start the application server in a specific context
bull Samples gallery Provides access to the sample applications youinstalled during the installation process
bull Information center for WebSphere Application Server Opens theWebSphere Application Server Library Web site in a browser to providedetailed information about WebSphere Application Server in a variety of
enterprise application scenarios
bull Migration wizard Starts a wizard that simplifies migrating configurationinformation and applications from earlier versions of WebSphereApplication Server
The next few sections provide highlights of using selected options from the Firststeps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 20 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2140
Installation verification
Though error messages would have displayed had any problems occurred duringthe WebSphere Application Server installation process its always comforting to be
able to double-check that your application server installation is complete and that allthe necessary configuration files were created correctly during that process
To verify that WebSphere Application Server was installed correctly on your systemand start it as part of the testing process click the Installation verification link inthe First steps console A window like the one shown in Figure 11 displays
Figure 11 Output of the verification process
As you can see from this figure the verification process first starts the applicationserver with your default profile and then connects to the application server to verifythe Servlet engine JavaServer pages and enterprise bean configuration It thenexamines the authentication of the key stores that are used to provide secureconnections between WebSphere components
When the verification process completes you can click the close button in the upperright-hand corner of the output window to close that window and return to the Firststeps console Note that the Start the server link has been replaced by a Stop the
server link because the WebSphere Application Server was started as part of theverification process
Starting the server
If you choose not to verify your WebSphere Application Server installation as
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 21 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2240
described in the previous section you can start the WebSphere Application Servermanually by clicking the Start the server link in the First steps console Clicking thislink displays an output window much like the one shown in Figure 11 except that itonly shows the initial text about starting the server and does not probe theconfiguration of your server
Note If the First steps console does not show a Start the server link but insteaddisplays only a Stop the server link your WebSphere Application Server is alreadyrunning
After a line like ADMU3000I Server NAME open for e-business
displays in the output window you can click the close box in the upper right-handcorner of the output window to close that window and return to the First stepsconsole
Administrative consoleThe WebSphere Application Server Administrative console is the primarymechanism for configuring the application server integrating the application serverwith external applications such as database systems and installing WebSphereapplications If you are new to WebSphere Application Server and want to explorethe administrative console or want to install new WebSphere applicationsimmediately after installing WebSphere you may want to start the Administrativeconsole from the First steps console
Click Administrative console to start the WebSphere Administrative console fromthe First steps console The login screen for the Administrative console opens in abrowser window as shown in Figure 12
Figure 12 Administrative console login screen
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 22 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2340
The Administrative console requires a Secure Sockets Layer (SSL) HTTPconnection generally referred to as a Hypertext Transfer Protocol over SecureSockets Layer (HTTPS) connection The page shown in Figure 12 only displays if avalid third-party SSL certificate is installed on your system If the system on whichyou installed WebSphere Application Server does not have a valid certificate issuedby a third party you will see a warning dialog like that shown in Figure 13 instead
Figure 13 Certificate not trusted alert
If you see this message see the next section of this tutorial for information about
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 23 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2440
configuring a security exception for your systems existing certificate
If you see the Administrative console login screen as shown in Figure 12 enter theadministrative username and password that you defined during the installationprocess and click Login or press Return The WebSphere Application Server
Administrative console displays as shown in Figure 14 You can explore or use theAdministrative console clicking the Logout link in the header when you are done
Figure 14 Administrative console
Configuring a certificate security exception
As discussed in the previous section the WebSphere Application ServerAdministrative console requires an SSL HTTP connection generally referred to asan HTTPS connection According to the default security policies used by mostsystems this means that the public key security certificate presented by your systemmust be a valid certificate issued by a trusted third-party certificate authority such asthawte VeriSign GeoTrust and many others See Resources for more informationabout these third-party certificate authorities
In a production environment you will certainly only want to use WebSphere
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 24 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2540
Application Server on a system with a valid enterprise or third-party securitycertificate so that users of your Web applications can verify the identity of the systemthat they are connecting to However you may be installing and configuringWebSphere Application Server on a new system for which you have not yet obtaineda certificate In this case you can temporarily or permanently define your existing
certificate as a trusted one that is an exception to the standard WebSphere securitypolicy
To define a policy exception click OK in the dialog shown in Figure 13 to display thescreen shown in Figure 15
Figure 15 A secure connection failure in Firefox
Click the Or you can define an exception link to begin the process of identifyingyour systems certificate as a valid digital public key certificate A screen identical to
the current screen displays with the exception of two additional buttons that displayat the bottom of the screen Click Add exception to continue the process of definingthe current certificate as an exception to the default certificate policy The dialogshown in Figure 16 displays
Note Clicking the Get me out of here button exits the exception definition processand returns you to your browser without establishing a connection to the WebSphere
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 25 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2640
Administrative console which isnt all that useful for the purposes of this tutorial
Figure 16 Initial dialog for defining a security exception
Click Get Certificate to retrieve your systems current certificate which displaysinformation about the current certificate and enables the Confirm Security
Exception button at the bottom left of the dialog shown in Figure 16 as shown inFigure 17
Figure 17 Updated dialog for defining a security exception
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 26 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2140
Installation verification
Though error messages would have displayed had any problems occurred duringthe WebSphere Application Server installation process its always comforting to be
able to double-check that your application server installation is complete and that allthe necessary configuration files were created correctly during that process
To verify that WebSphere Application Server was installed correctly on your systemand start it as part of the testing process click the Installation verification link inthe First steps console A window like the one shown in Figure 11 displays
Figure 11 Output of the verification process
As you can see from this figure the verification process first starts the applicationserver with your default profile and then connects to the application server to verifythe Servlet engine JavaServer pages and enterprise bean configuration It thenexamines the authentication of the key stores that are used to provide secureconnections between WebSphere components
When the verification process completes you can click the close button in the upperright-hand corner of the output window to close that window and return to the Firststeps console Note that the Start the server link has been replaced by a Stop the
server link because the WebSphere Application Server was started as part of theverification process
Starting the server
If you choose not to verify your WebSphere Application Server installation as
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 21 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2240
described in the previous section you can start the WebSphere Application Servermanually by clicking the Start the server link in the First steps console Clicking thislink displays an output window much like the one shown in Figure 11 except that itonly shows the initial text about starting the server and does not probe theconfiguration of your server
Note If the First steps console does not show a Start the server link but insteaddisplays only a Stop the server link your WebSphere Application Server is alreadyrunning
After a line like ADMU3000I Server NAME open for e-business
displays in the output window you can click the close box in the upper right-handcorner of the output window to close that window and return to the First stepsconsole
Administrative consoleThe WebSphere Application Server Administrative console is the primarymechanism for configuring the application server integrating the application serverwith external applications such as database systems and installing WebSphereapplications If you are new to WebSphere Application Server and want to explorethe administrative console or want to install new WebSphere applicationsimmediately after installing WebSphere you may want to start the Administrativeconsole from the First steps console
Click Administrative console to start the WebSphere Administrative console fromthe First steps console The login screen for the Administrative console opens in abrowser window as shown in Figure 12
Figure 12 Administrative console login screen
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 22 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2340
The Administrative console requires a Secure Sockets Layer (SSL) HTTPconnection generally referred to as a Hypertext Transfer Protocol over SecureSockets Layer (HTTPS) connection The page shown in Figure 12 only displays if avalid third-party SSL certificate is installed on your system If the system on whichyou installed WebSphere Application Server does not have a valid certificate issuedby a third party you will see a warning dialog like that shown in Figure 13 instead
Figure 13 Certificate not trusted alert
If you see this message see the next section of this tutorial for information about
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 23 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2440
configuring a security exception for your systems existing certificate
If you see the Administrative console login screen as shown in Figure 12 enter theadministrative username and password that you defined during the installationprocess and click Login or press Return The WebSphere Application Server
Administrative console displays as shown in Figure 14 You can explore or use theAdministrative console clicking the Logout link in the header when you are done
Figure 14 Administrative console
Configuring a certificate security exception
As discussed in the previous section the WebSphere Application ServerAdministrative console requires an SSL HTTP connection generally referred to asan HTTPS connection According to the default security policies used by mostsystems this means that the public key security certificate presented by your systemmust be a valid certificate issued by a trusted third-party certificate authority such asthawte VeriSign GeoTrust and many others See Resources for more informationabout these third-party certificate authorities
In a production environment you will certainly only want to use WebSphere
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 24 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2540
Application Server on a system with a valid enterprise or third-party securitycertificate so that users of your Web applications can verify the identity of the systemthat they are connecting to However you may be installing and configuringWebSphere Application Server on a new system for which you have not yet obtaineda certificate In this case you can temporarily or permanently define your existing
certificate as a trusted one that is an exception to the standard WebSphere securitypolicy
To define a policy exception click OK in the dialog shown in Figure 13 to display thescreen shown in Figure 15
Figure 15 A secure connection failure in Firefox
Click the Or you can define an exception link to begin the process of identifyingyour systems certificate as a valid digital public key certificate A screen identical to
the current screen displays with the exception of two additional buttons that displayat the bottom of the screen Click Add exception to continue the process of definingthe current certificate as an exception to the default certificate policy The dialogshown in Figure 16 displays
Note Clicking the Get me out of here button exits the exception definition processand returns you to your browser without establishing a connection to the WebSphere
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 25 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2640
Administrative console which isnt all that useful for the purposes of this tutorial
Figure 16 Initial dialog for defining a security exception
Click Get Certificate to retrieve your systems current certificate which displaysinformation about the current certificate and enables the Confirm Security
Exception button at the bottom left of the dialog shown in Figure 16 as shown inFigure 17
Figure 17 Updated dialog for defining a security exception
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 26 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2240
described in the previous section you can start the WebSphere Application Servermanually by clicking the Start the server link in the First steps console Clicking thislink displays an output window much like the one shown in Figure 11 except that itonly shows the initial text about starting the server and does not probe theconfiguration of your server
Note If the First steps console does not show a Start the server link but insteaddisplays only a Stop the server link your WebSphere Application Server is alreadyrunning
After a line like ADMU3000I Server NAME open for e-business
displays in the output window you can click the close box in the upper right-handcorner of the output window to close that window and return to the First stepsconsole
Administrative consoleThe WebSphere Application Server Administrative console is the primarymechanism for configuring the application server integrating the application serverwith external applications such as database systems and installing WebSphereapplications If you are new to WebSphere Application Server and want to explorethe administrative console or want to install new WebSphere applicationsimmediately after installing WebSphere you may want to start the Administrativeconsole from the First steps console
Click Administrative console to start the WebSphere Administrative console fromthe First steps console The login screen for the Administrative console opens in abrowser window as shown in Figure 12
Figure 12 Administrative console login screen
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 22 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2340
The Administrative console requires a Secure Sockets Layer (SSL) HTTPconnection generally referred to as a Hypertext Transfer Protocol over SecureSockets Layer (HTTPS) connection The page shown in Figure 12 only displays if avalid third-party SSL certificate is installed on your system If the system on whichyou installed WebSphere Application Server does not have a valid certificate issuedby a third party you will see a warning dialog like that shown in Figure 13 instead
Figure 13 Certificate not trusted alert
If you see this message see the next section of this tutorial for information about
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 23 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2440
configuring a security exception for your systems existing certificate
If you see the Administrative console login screen as shown in Figure 12 enter theadministrative username and password that you defined during the installationprocess and click Login or press Return The WebSphere Application Server
Administrative console displays as shown in Figure 14 You can explore or use theAdministrative console clicking the Logout link in the header when you are done
Figure 14 Administrative console
Configuring a certificate security exception
As discussed in the previous section the WebSphere Application ServerAdministrative console requires an SSL HTTP connection generally referred to asan HTTPS connection According to the default security policies used by mostsystems this means that the public key security certificate presented by your systemmust be a valid certificate issued by a trusted third-party certificate authority such asthawte VeriSign GeoTrust and many others See Resources for more informationabout these third-party certificate authorities
In a production environment you will certainly only want to use WebSphere
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 24 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2540
Application Server on a system with a valid enterprise or third-party securitycertificate so that users of your Web applications can verify the identity of the systemthat they are connecting to However you may be installing and configuringWebSphere Application Server on a new system for which you have not yet obtaineda certificate In this case you can temporarily or permanently define your existing
certificate as a trusted one that is an exception to the standard WebSphere securitypolicy
To define a policy exception click OK in the dialog shown in Figure 13 to display thescreen shown in Figure 15
Figure 15 A secure connection failure in Firefox
Click the Or you can define an exception link to begin the process of identifyingyour systems certificate as a valid digital public key certificate A screen identical to
the current screen displays with the exception of two additional buttons that displayat the bottom of the screen Click Add exception to continue the process of definingthe current certificate as an exception to the default certificate policy The dialogshown in Figure 16 displays
Note Clicking the Get me out of here button exits the exception definition processand returns you to your browser without establishing a connection to the WebSphere
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 25 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2640
Administrative console which isnt all that useful for the purposes of this tutorial
Figure 16 Initial dialog for defining a security exception
Click Get Certificate to retrieve your systems current certificate which displaysinformation about the current certificate and enables the Confirm Security
Exception button at the bottom left of the dialog shown in Figure 16 as shown inFigure 17
Figure 17 Updated dialog for defining a security exception
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 26 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2340
The Administrative console requires a Secure Sockets Layer (SSL) HTTPconnection generally referred to as a Hypertext Transfer Protocol over SecureSockets Layer (HTTPS) connection The page shown in Figure 12 only displays if avalid third-party SSL certificate is installed on your system If the system on whichyou installed WebSphere Application Server does not have a valid certificate issuedby a third party you will see a warning dialog like that shown in Figure 13 instead
Figure 13 Certificate not trusted alert
If you see this message see the next section of this tutorial for information about
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 23 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2440
configuring a security exception for your systems existing certificate
If you see the Administrative console login screen as shown in Figure 12 enter theadministrative username and password that you defined during the installationprocess and click Login or press Return The WebSphere Application Server
Administrative console displays as shown in Figure 14 You can explore or use theAdministrative console clicking the Logout link in the header when you are done
Figure 14 Administrative console
Configuring a certificate security exception
As discussed in the previous section the WebSphere Application ServerAdministrative console requires an SSL HTTP connection generally referred to asan HTTPS connection According to the default security policies used by mostsystems this means that the public key security certificate presented by your systemmust be a valid certificate issued by a trusted third-party certificate authority such asthawte VeriSign GeoTrust and many others See Resources for more informationabout these third-party certificate authorities
In a production environment you will certainly only want to use WebSphere
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 24 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2540
Application Server on a system with a valid enterprise or third-party securitycertificate so that users of your Web applications can verify the identity of the systemthat they are connecting to However you may be installing and configuringWebSphere Application Server on a new system for which you have not yet obtaineda certificate In this case you can temporarily or permanently define your existing
certificate as a trusted one that is an exception to the standard WebSphere securitypolicy
To define a policy exception click OK in the dialog shown in Figure 13 to display thescreen shown in Figure 15
Figure 15 A secure connection failure in Firefox
Click the Or you can define an exception link to begin the process of identifyingyour systems certificate as a valid digital public key certificate A screen identical to
the current screen displays with the exception of two additional buttons that displayat the bottom of the screen Click Add exception to continue the process of definingthe current certificate as an exception to the default certificate policy The dialogshown in Figure 16 displays
Note Clicking the Get me out of here button exits the exception definition processand returns you to your browser without establishing a connection to the WebSphere
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 25 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2640
Administrative console which isnt all that useful for the purposes of this tutorial
Figure 16 Initial dialog for defining a security exception
Click Get Certificate to retrieve your systems current certificate which displaysinformation about the current certificate and enables the Confirm Security
Exception button at the bottom left of the dialog shown in Figure 16 as shown inFigure 17
Figure 17 Updated dialog for defining a security exception
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 26 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2440
configuring a security exception for your systems existing certificate
If you see the Administrative console login screen as shown in Figure 12 enter theadministrative username and password that you defined during the installationprocess and click Login or press Return The WebSphere Application Server
Administrative console displays as shown in Figure 14 You can explore or use theAdministrative console clicking the Logout link in the header when you are done
Figure 14 Administrative console
Configuring a certificate security exception
As discussed in the previous section the WebSphere Application ServerAdministrative console requires an SSL HTTP connection generally referred to asan HTTPS connection According to the default security policies used by mostsystems this means that the public key security certificate presented by your systemmust be a valid certificate issued by a trusted third-party certificate authority such asthawte VeriSign GeoTrust and many others See Resources for more informationabout these third-party certificate authorities
In a production environment you will certainly only want to use WebSphere
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 24 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2540
Application Server on a system with a valid enterprise or third-party securitycertificate so that users of your Web applications can verify the identity of the systemthat they are connecting to However you may be installing and configuringWebSphere Application Server on a new system for which you have not yet obtaineda certificate In this case you can temporarily or permanently define your existing
certificate as a trusted one that is an exception to the standard WebSphere securitypolicy
To define a policy exception click OK in the dialog shown in Figure 13 to display thescreen shown in Figure 15
Figure 15 A secure connection failure in Firefox
Click the Or you can define an exception link to begin the process of identifyingyour systems certificate as a valid digital public key certificate A screen identical to
the current screen displays with the exception of two additional buttons that displayat the bottom of the screen Click Add exception to continue the process of definingthe current certificate as an exception to the default certificate policy The dialogshown in Figure 16 displays
Note Clicking the Get me out of here button exits the exception definition processand returns you to your browser without establishing a connection to the WebSphere
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 25 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2640
Administrative console which isnt all that useful for the purposes of this tutorial
Figure 16 Initial dialog for defining a security exception
Click Get Certificate to retrieve your systems current certificate which displaysinformation about the current certificate and enables the Confirm Security
Exception button at the bottom left of the dialog shown in Figure 16 as shown inFigure 17
Figure 17 Updated dialog for defining a security exception
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 26 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2540
Application Server on a system with a valid enterprise or third-party securitycertificate so that users of your Web applications can verify the identity of the systemthat they are connecting to However you may be installing and configuringWebSphere Application Server on a new system for which you have not yet obtaineda certificate In this case you can temporarily or permanently define your existing
certificate as a trusted one that is an exception to the standard WebSphere securitypolicy
To define a policy exception click OK in the dialog shown in Figure 13 to display thescreen shown in Figure 15
Figure 15 A secure connection failure in Firefox
Click the Or you can define an exception link to begin the process of identifyingyour systems certificate as a valid digital public key certificate A screen identical to
the current screen displays with the exception of two additional buttons that displayat the bottom of the screen Click Add exception to continue the process of definingthe current certificate as an exception to the default certificate policy The dialogshown in Figure 16 displays
Note Clicking the Get me out of here button exits the exception definition processand returns you to your browser without establishing a connection to the WebSphere
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 25 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2640
Administrative console which isnt all that useful for the purposes of this tutorial
Figure 16 Initial dialog for defining a security exception
Click Get Certificate to retrieve your systems current certificate which displaysinformation about the current certificate and enables the Confirm Security
Exception button at the bottom left of the dialog shown in Figure 16 as shown inFigure 17
Figure 17 Updated dialog for defining a security exception
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 26 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2640
Administrative console which isnt all that useful for the purposes of this tutorial
Figure 16 Initial dialog for defining a security exception
Click Get Certificate to retrieve your systems current certificate which displaysinformation about the current certificate and enables the Confirm Security
Exception button at the bottom left of the dialog shown in Figure 16 as shown inFigure 17
Figure 17 Updated dialog for defining a security exception
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 26 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2740
The Permanently store this exception check box above the Confirm SecurityException button enables you to specify whether your system permanently storesthe current certificate as an exception to the security policy or whether it will only beaccepted for the current session When configuring systems for production useclear this check box so that you must always go through the security exception
process to prevent you from forgetting to install a valid certificate on the system thatis running WebSphere Application Server If you are working on a test system thatwill never be used in production you can leave the Permanently store thisexception check box selected
Click the Confirm Security Exception button to define the current certificate as anexception to the security policy The WebSphere Application Server Administrative
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 27 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2840
console login screen displays as shown in Figure 12 You can then enter theadministrative username and password that you defined during the installationprocess and click Login or press Return to access the WebSphere ApplicationServer Administrative console as shown in Figure 14 You can explore or use theAdministrative 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 shownin Figure 18 which enables you to experiment with the sample applications that youoptionally installed during the WebSphere Application Server installation process
Figure 18 Sample applications gallery
You can execute or modify these examples to get a feel for how to write WebSphereapplications and how they will be displayed and perform in a WebSphere-basedenvironment The most interesting of the sample applications is an online Java PetStore that enables you to walk through an example of browsing and purchasingproducts online
When youre finished experimenting with the sample applications you can simplyclose the browser window to return to the First steps console
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 28 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 2940
Shutting down WebSphere Application Server
After experimenting with the various options provided on the First steps console youmay want to terminate the application server so that you can experiment with
manually starting the application server or integrating starting and stopping theWebSphere Application Server into your systems startup and shutdown processesas explained in the next section of this tutorial To stop the WebSphere ApplicationServer from the First steps console click the Stop the server link in the First stepsconsole Clicking this link displays an authentication dialog like the one shown inFigure 19
Figure 19 Authenticating to stop the application server
Enter the administrative username and password that you set during the installationprocess and click OK to begin the application server shutdown process A dialog
like the one shown in Figure 20 displays showing the output of the shutdownprocess
Figure 20 Output from stopping the application server
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 29 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3040
After a line like ADMU4000I Server NAME stop completed displays in theoutput window you can click the close box in the upper right-hand corner of theoutput window to close that window and return to the First steps console
Section 5 Starting and stopping WebSphere ApplicationServer
Installing WebSphere Application Server doesnt start the WebSphere ApplicationServer process on your system As discussed in the previous section the First stepsconsole that displays by default at the end of the installation process provides aconvenient mechanism for starting WebSphere Application Server for the first timeHowever that is of limited value after you complete the installation process and exitthis console
This section explains how to start and stop WebSphere Application Server manuallyand how to integrate starting and stopping the application server into the startup andshutdown processes for your system If you are using WebSphere ApplicationServer for real work or long-term experimentation youll want it to start automaticallywhen you start your system and to shut down cleanly when you shut down yoursystem
As explained in the following sections WebSphere Application Server providesconvenient UNIXLinux shell scripts that simplify the process of starting and stopping
the application server from the command line or from within other scripts such asthe ones that are run during your systems startup and shutdown processes
Start WebSphere Application Server
WebSphere Application Server provides the startServersh shell script tosimplify the application server startup process This script takes one argumentwhich is the name of the application server that you want to start On systems whereyou have newly installed the WebSphere Application Server the name of the defaultserver is server1
To start the application server use the su or sudo -s commands (depending onthe UNIX system or Linux distribution you are using) to become a privileged user onthe system where you installed the application server Enter the root password oryour password (respectively) when prompted to do so
Next enter the following command to start WebSphere Application Server
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 30 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3140
optIBMWebSphereAppServerbinstartServersh server1
As the application server starts you will see output similar to that displayed in theoutput window shown in Figure 11 The command prompt redisplays when the
server startup process completes and the application server is ready for use
System startup and shutdown integration
After installing a Web server on your system you typically want it to startautomatically any time you restart your system When installing WebSphereApplication Server on platforms such as Microsoft Windows the installation processenables you to define the server and administration server as Windows services thatstart automatically when your system starts Unfortunately the UNIX and Linuxinstallers dont provide any equivalent integration into the startup processes for those
systems Therefore you must manually integrate WebSphere Application Server intothe startup process on UNIX and Linux systems
All UNIX and Linux systems define the tasks that should be performed during thestartup and shutdown processes via a series of shell scripts (commonly referred toas init scripts ) that are executed as the system starts On most UNIX and Linuxsystems these scripts are organized in the way specified by the SysVInit (that isSystem V Init which refers to an old version of UNIX) system startup mechanism(see Resources for more information) In this mechanism the primary startup scriptsfor the system all reside in etcinitd (which may be a symbolic link to the
etcrcdinitd directory on some systems) The specific scripts that are executed as
the system boots into a specific numeric level of operation (known as a runlevel ) aresymbolic links from directories with names of the form etcrcrunlevel d to the scriptsin the etcinitd directory Ubuntu Linux systems use a different startup mechanismthat is configured to be compatible with the SysVInit process and is explained in asubsequent section
Create a SysVInit script
To create a SysVInit script for WebSphere Application Server you can do one of thefollowing
bull Download the sample SysVInit script that is provided with this tutorialbull Copy an existing init script and modify it to execute the processes
associated with your WebSphere Application Server installation
The remainder of this section explains how to download and use the sampleSysVInit script provided with this tutorial which looks like Listing 1
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 31 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3240
Listing 1 Sample SysVInit script
binbash Simple startup script for IBM WebSphere Application Server chkconfig - 85 15
description IBM WebSphere Application Server is a powerful middleware platform for connecting Web-based applications and servers
Path to the WebSphere startup and shutdown scriptsstartscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServershprog=the WebSphere Application ServerRETVAL=0
modify the following line as needed to reflect any custom Java installation directoryPATH=optIBMibm-java-x86_64_60bin$PATH
Function to start the serverstart()
echo -n $Starting $prog
$startscript server1RETVAL=$echoreturn $RETVAL
Function to stop the serverstop()
echo -n $Stopping $prog $shutscript server1 -username ADMINUSER -password PASSWORDRETVAL=$echoreturn $RETVAL
See how we were calledcase $1 in
start)start
stop)stop
restart)stopstart
)echo $Usage $0 start|stop|restartexit 1
esac
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 etcinitd as the root user (or
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 32 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3340
by using the sudo command) giving it a name such aswebsphere_sysvinitsh
3 Edit this file using your favorite text editor changing ADMINUSER andPASSWORD to the administrative username and password that you
defined during the installation process and save those changes
4 As the root user or by using sudo make the file executable using thiscommand
chmod 755 etcinitdwebsphere_sysvinitsh
5 Create symbolic links to this file from the directory associated with yoursystems default runlevel (usually the etcrc5d directory for a graphicalsystem or the etcrc3d directory for a system that uses a text console) byusing commands like the following
ln -s etcinitdwebsphere_sysvinitsh etcrc5dS85ibm-wasln -s etcinitdwebsphere_sysvinitsh etcrc5dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S85ibm-was symbolic linkautomatically 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 SysVInitmechanism The Ubuntu startup mechanism is known as Upstart (see Resources)and is a relatively new event-driven startup mechanism that was created for Ubuntubut is being adopted by other distributions such as Fedora and therefore eventuallyRed Hat and Centos Upstart is becoming popular largely because of its support forconcurrency and responsiveness to system events
At the moment Upstart is implemented to be compatible with the traditional SysVInitmodel See Downloads for a simple Upstart script that you can put in the etcinitddirectory on your system and use for WebSphere Application Server This scriptlooks like Listing 2
Listing 2 Sample Upstart script
binbash -e BEGIN INIT INFO Provides ibm-websphere Required-Start $local_fs $remote_fs $network $syslog Required-Stop $local_fs $remote_fs $network $syslog Default-Start 2 3 4 5
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 33 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3440
Default-Stop 0 1 6 Short-Description Startstop IBM WebSphere Application Server END INIT INFO IBM WAS This initd script starts the IBM WebSphere Application Server
modify the following line as needed to reflect any custom Java installation directoryENV=env -i LANG=C PATH=optIBMibm-java-x86_64_60binusrbinbin
set -eif [ -d optIBMWebSphereAppServerbin ] then
echo No IBM WebSphere Application Server installedexit 0
fi
liblsbinit-functions
test -f etcdefaultrcS ampamp etcdefaultrcS
startscript=optIBMWebSphereAppServerbinstartServershshutscript=optIBMWebSphereAppServerbinstopServersh
case $1 instart)log_daemon_msg Starting application server IBM WASif $startscript then
log_end_msg 0else
log_end_msg 1fi
stop)
log_daemon_msg Stopping application server IBM WASif $stopscript -user was-admin -password PASSWORD then
log_end_msg 0else
log_end_msg 1fi
restart)
log_daemon_msg Restarting Web server IBM HTTPif ($stopscript -user was-admin -password PASSWORD ampamp $startscript)
thenlog_end_msg 0
elselog_end_msg 1
fi)
log_success_msg Usage etcinitdwebsphere start|stop|restartexit 1
esac
After downloading this file perform the following steps
1 Save this file to your system and copy it to etcinitd as the root user (orby using the sudo command) giving it a name such aswebsphere_upstartsh
2 As the root user or by using the sudo command make the file executableby using this command
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 34 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3540
chmod 755 etcinitdwebsphere_upstartsh
3 Create symbolic links to this file from the directory associated with your
systems default runlevel (usually the etcrc2d directory) by using thecommands like the following
ln -s etcinitdwebsphere_upstartsh etcrc2dS91ibm-wasln -s etcinitdwebsphere_upstartsh etcrc2dK15ibm-was
The next time you shut down your system the K15ibm-was symbolic link that youcreated automatically stops WebSphere Application Server as part of the shutdownprocess The next time you start your system the S91ibm-was symbolic linkautomatically starts WebSphere Application Server as part of the startup process
Section 6 Next steps
Congratulations on installing WebSphere Application Server and integrating it intoyour system startup and shutdown processes Youre now ready to add your ownapplications customize the servers configuration and so on Writing and integratingWebSphere applications is outside the scope of this tutorial However heres somegeneral information that you will find useful when working with WebSphere
Application Server
bull To open the WebSphere Application Server Administrative console in abrowser from the system on which it is installed visit the following URL
httpslocalhost9043ibmconsole
The screen shown in Figure 12 displays Enter the administrativeusername and password that you defined during the installation process
and click Login or press Return to display the WebSphere ApplicationServer Administrative console as shown in Figure 14
bull To re-execute the First steps console use the following command
cdoptIBMWebSphereAppServerprofilesAppSrv01firststeps
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 35 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3640
firststepssh
Section 7 Summary
An application server is the core of most three-tier enterprise Web installations IBMWebSphere Application Server is one of the most popular application servers in usetoday supported by IBM and a huge ecosystem of third-party applications andvendors The ability to download and experiment with a trial version of WebSphereApplication Server makes it easy for you to install test and familiarize yourself withWebSphere Application Server in your environment WebSphere Application Serverprovides a robust powerful well-tested and well-supported foundation for your
enterprise Web applications and services
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 36 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3740
Downloads
Description Name Size Download method
Sample SysVInit WebSphere startup file websphere_sysvinitsh2KB HTTP
Sample Upstart WebSphere startup file websphere_upstartsh2KB HTTP
Information about download methods
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 37 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3840
Resources
Learn
bull See the WebSphere Application Server 7 software and hardware requirements
documentation for specific operating system patch requirements and supporteddatabase information
bull Get product documentation for IBM WebSphere Application Server and relatedproducts from the WebSphere library
bull See the WebSphere Application and transaction infrastructure page forinformation about many of the WebSphere add-on products that are currentlyavailable
bull See the IBM Redbooks Domain on the WebSphere software platform fortechnical and procedural information on the WebSphere software platform andWebSphere applications
bull See the WebSphere zone on developerWorks for additional information aboutplanning developing and deploying enterprise Web environments andapplications
bull See the IBM HTTP Server Information Center for detailed information aboutusing the IBM HTTP Server with WebSphere Application Server
bull Learn more about WebSphere Application Server Network Deployment whereclusters of application servers deliver advanced capabilities forhigh-performance high-availability environments
bull In the AIX and UNIX area on developerWorks get the resources you need toadvance your skills in UNIX administration
bull Check out additional WebSphere tips and tricks from the developerWorks site
bull Learn more about SysVInit the traditional UNIX and Linux system startup andshutdown mechanism
bull Learn more about Upstart a relatively new event-driven startup mechanismcreated for Ubuntu and popular largely because of its support for concurrencyand responsiveness to system events
bull Check out additional UNIX tips and tricks from the developerWorks site
bull Browse the technology bookstore for books on WebSphere Application Serverand other technical topics
Get products and technologies
bull Download a free trial version of WebSphere Application Server version 7 foryour platform
developerWorksreg ibmcomdeveloperWorks
Install and configure WebSphere Application Server on UNIX and Linux systemsPage 38 of 40 copy Copyright IBM Corporation 2008 All rights reserved
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 3940
bull Download the IBM Java SDK for your platform You may need to download andinstall the IBM Java SDK to install and use IBM WebSphere Application Serveron certain Linux distributions
bull Download full and trial versions of other WebSphere products
bull Download IBM HTTP Server version 61 for your platform
bull Popular 3-tier application servers include WebSphere products Adobereg JRuntrade Oracles BEA WebLogic Red Hats JBoss and Sun MicrosystemsEnterprise JavaBeans technology
bull Some examples of trusted third-party certificate authorities are thawte VeriSignand GeoTrust
Discuss
bull Check out developerWorks blogs and get involved in the developerWorkscommunity
bull Participate in the WebSphere Application Server forum
About the author
William von HagenWilliam von Hagen has been a UNIX systems administrator for more than 20 yearsand a Linux advocate since 1993 Bill is the author or co-author of books on subjectssuch as Ubuntu Linux Xen Virtualization the GNU Compiler Collection (GCC) SuSE
Linux Mac OS X Linux file systems and SGML He has also written numerousarticles for Linux and Mac OS X publications and Web sites You can reach Bill atwvhvonhagenorg
Trademarks
Java and JavaServer Pages are trademarks of Sun Microsystems Inc in the UnitedStates other countries or both
Linux is a registered trademark of Linus Torvalds in the United States othercountries or both
Microsoft Windows and Windows Server are trademarks of Microsoft Corporation inthe United States other countries or both
UNIX is a registered trademark of The Open Group in the United States and othercountries
Other company product or service names may be trademarks or service marks of
ibmcomdeveloperWorks developerWorksreg
Install and configure WebSphere Application Server on UNIX and Linux systems copy Copyright IBM Corporation 2008 All rights reserved Page 39 of 40
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks
862019 Au Was on Linux PDF
httpslidepdfcomreaderfullau-was-on-linux-pdf 4040
others
developerWorksreg ibmcomdeveloperWorks