Tuesday, December 2, 2014

Install IBM WebSphere Application Server 8.5.5 ND

In this part you will learn howto Install IBM WebSphere Application Server 8.5.5 ND in RHEL 6.3, but with this knowledge you can install it over others Linux, Unix or Windows. Please be free to give me any question.


Sure you will install WebSphere 8.5 by first time in a Linux environment,  if this is the case then you will need to run a step 0, its ets, prepare the linux enviroment


1.- Prepare linux enviroment
2.- Install Agent Installer 1.7 (IBM IM) 
3.- Install WebSphere Application Server 8.5.5 ND binaries
4.- Install IHS 8.5
5.- Start IHS 8.5
6.- Configure WAS ND 8.5.5
7.- Install Plugin
8.- Configure Plugin
9.- Configure SSL


1.- Prepare linux enviroment

# yum install compat-libstdc++-296.i686 compat-libstdc++-33.i686
# yum install compat-libstdc++-33.x86_64
# yum install gtk2.i686 libXtst.i686


NOTE: My last install was over RHEL 6.4 and I use the IM 1.7 64 bits, I did not need the enviroment prepartation because the IM runs great!!! but you will need to run the WebSphere Customization Toolbox (WPT) you will need to install 32 bits libraries.
Maybe you need to disble SELinux too by temporarily switch off enforcement, if that is your case just run this:

echo 0 >/selinux/enforce


2.- Install Agent Installer 1.7 (IBM IM)

For this step you will need the file agent.installer.linux.gtk.x86_64_1.7.1000.20131119_2219.zip 

# unzip agent.installer.linux.gtk.x86_64_1.7.1000.20131119_2219.zip



all will be unzipped here, see next picture, then you only must run the installer

# ./install












 

3.- Install WebSphere Application Server 8.5.5 ND binaries

 You will need to download this files:
  • was.repo.8550.ihs.ilan_part1.zip
  • was.repo.8550.ihs.ilan_part2.zip
  • was.repo.8550.ndtrial_part1.zip
  • was.repo.8550.ndtrial_part2.zip
  • was.repo.8550.ndtrial_part3.zip
  • was.repo.8550.plg.ilan_part1.zip
  • was.repo.8550.plg.ilan_part2.zip
  • was.repo.8550.wct.ilan_part1.zip
  • was.repo.8550.wct.ilan_part2.zip
You can download binaries from http://www-03.ibm.com/software/products/en/appserv-wasnd/ 

Now you must create next folder system to spread the repo
# mkdir -p /opt/IBM/repositories/was.repo.8550/ihs
# mkdir -p /opt/IBM/repositories/was.repo.8550/nd
# mkdir -p /opt/IBM/repositories/was.repo.8550/plg
# mkdir -p /opt/IBM/repositories/was.repo.8550/wct


and put into /opt/IBM/repositories/was.repo.8550/ihs
was.repo.8550.ihs.ilan_part1.zip
was.repo.8550.ihs.ilan_part2.zip
 

into  /opt/IBM/repositories/was.repo.8550/nd
was.repo.8550.ndtrial_part1.zip
was.repo.8550.ndtrial_part2.zip
was.repo.8550.ndtrial_part3.zip
 

into  /opt/IBM/repositories/was.repo.8550/plg
was.repo.8550.plg.ilan_part1.zip
was.repo.8550.plg.ilan_part2.zip
 

and into  /opt/IBM/repositories/was.repo.8550/wct
was.repo.8550.wct.ilan_part1.zip
was.repo.8550.wct.ilan_part2.zip
 

unzip all files and erase zip files in case you need filesystem space
Next you can configure the ND 8.5.5 repository into IM



Now press Install







Be careful, I always put the version to AppServer folder, in this case is AppServer8.5



I Select JDK 64 bits




Do not create any profile here, we will create all in other moment


4.- Install IHS 8.5

Add the IHS 8.5.5 repository


Press OK

Now press install, select IHS...




As I have different IHS versions,  I use the number of version, in this case HTTPServer8.5



select Http Port





congrats!!!!

5.- Start IHS 8.5

# cd /opt/IBM/HTTPServer8.5/bin/
# ./apachectl start




Now open it in your web browser

http://rhel63



6.- Configure WAS ND 8.5.5


Let's to create the dmgr profile

# cd /opt/IBM/WebSphere/AppServer8.5/bin
# ./manageprofiles.sh -create -profileName Dmgr_Prod -templatePath /opt/IBM/WebSphere/AppServer8.5/profileTemplates/dmgr -nodeName Prod_ENV -cellName Prod -hostName rhel63



Let's to create the Servers profile

 # ./manageprofiles.sh -create -profileName Servers -templatePath /opt/IBM/WebSphere/AppServer8.5/profileTemplates/default -nodeName Germany -cellName Europa -hostName rhel63


Let's start the DMgr profile

# cd /opt/IBM/WebSphere/AppServer8.5/profiles/Dmgr_Prod/bin/
# ./startManager.sh
  




Let's start the server1 in Servers profile

# cd /opt/IBM/WebSphere/AppServer8.5/profiles/Servers/bin
# ./startServer.sh server1


check the port for open the admin console, by default the first WebSphere server take 9060 port, next server will take 9061, you can check the ports with this command:

# netstat -an | grep LISTEN | grep tcp | grep 906




9060 is dmgr and 9061 is server1, at this point you must understand that server1 is in a no management node, the idea is add this node to a dmgr node




 as you can see, there is not any server in dmgr...yet



open server1 console too and find soap port



go to
Servers  -> Server Types -> WebSphere application servers 

select server1, look for ports in right panel of server1



 in this case the SOAP port is 8880

Now logout and return to console in 9060 port, the DMgr Console


Now let's go to federate server1 from Servers profile, this process will create a new server called "nodeagent" who will be responsible to management all administration process and comunication between DMgr and all servers in this Node

Go to
System administration -> Nodes


 press Add Node


In next screen in Node Conection Part put the name of your server (it must be defined before in /etc/hosts file), the SOAP port, that in this case is 8880 AND select in Options Include applications and Include buses






SORRY!! some messages are in spanish...

now you can see the new node..in this case Germany


start server1 using this console
go to
Servers  -> Server Types -> WebSphere application servers



check apps
go to
Applications  -> All applications



check http port
# netstat -an | grep LISTEN | grep tcp | grep 908


Open in a web browser  the sample app

http://rhel63:9080/snoop

 

7.- Install Plugin

in the IM goto File -> Preferences... -> Add Repository...



Press Ok and Now just install the Plugin












8.- Configure Plugin

In order to configure the plugin we need to install the "WebSphere Customization Toolbox", it is the easier way to do it



Press Ok and just install the "WebSphere Customization Toolbox (ILAN)"











once finish the toolbox install you can starting by the IM at finished or by the menu of Operative System, as you wish


You can see the option at next picture







On Add Web Server Plug-in Location, complete these fields:
Name:Prod_Local_WebServer
Location:path to your Plugin install



Now you should see something like this


now you will create the properties for your webserver


select you webserver type


64 bits


be careful with your IHS Choice...I said that cose in my case I have differents IHS install


I used here:
user ID:     wasadmin
Password: Wasadmin


user ID:     wasadmin
Group  :     wasadmin
NOTE: why this is important? because this user/password is used to administrate webserver, specialty the remote webservers 


WebServer Name (must be unique): ProdLocalWebServer


Choose local install and the folder of your ND 8.5 install


Will appear the name of your Dmgr






Ready, now we must run the Configure script

# cd /opt/IBM/WebSphere/Plugins8.5/bin/
# ls

you will need to copy the configureProdLocalWebServer.sh script


cd /opt/IBM/WebSphere/AppServer8.5/profiles/Dmgr_Prod/bin
cp /opt/IBM/WebSphere/Plugins8.5/bin/configureProdLocalWebServer.sh . 


now we just run this script, he will make all the magic things for you...

# ./configureProdLocalWebServer.sh





Congrats!!!
now open admin console and check the new web server definition
go to
Servers - > All servers 


You can test the snoop app using IHS, you will see that plugin is not prepared


here you could ask why the plugin does not work? the answer is that you need to update plugin.xml into webserver in order it works..then you must do it...update it

go to
Servers - > web servers


1.- mark ProdLocalWebServer server and press Generate plug-in


2.- mark ProdLocalWebServer server and press Propagate plugin



3.-  mark ProdLocalWebServer server and press Stop



4.- mark ProdLocalWebServer server and press Start




Now go to Snoop App browser tab and press F5 to refresh and voilà!!!


9.- Configure SSL


To configure SSL we will use this doc, "Enabling SSL in the IBM HTTP Server configuration" but adapted to this situation, then:
1.- vi /opt/IBM/HTTPServer8.5/conf/httpd.conf
add all content between ###BEGIN to ###END just above the line containing "LoadModule was_ap22_module /opt/IBM/WebSphere/Plugins8.5/bin/64bits/mod_was_ap22_http.so"

check next picture

 



save and close
2.- # mkdir /opt/IBM/HTTPServer8.5/ssl
Now in graphical env run next commands
# cd /opt/IBM/HTTPServer8.5/bin



You must create the key.kdb into /opt/IBM/HTTPServer8.5/ssl folder



put the password and be sure to mark Stash the password to a file


Next press New Seft Signed


fill all info



now you can close the ikeyman

Restart the IHS in order to start SSL port
3.- # ./apachectl restart
# netstat -an | grep 443

Now we can check it in any web browser




SSL is configured...very easy right?

New let's check if snoop app can open on SSL



Finished!!!

2 comments:

  1. Very detailed post. thank you very much.
    I have an issue where the nodeagent would not trust the dmgr.
    I had accidently deleted the certificates from the dmgr

    How do I re-register the node ?
    When I start the node it starts fine, with a bunch of ffdc errors about this SSL issue.

    ReplyDelete
  2. Very detailed post. thank you very much.
    I have an issue where the nodeagent would not trust the dmgr.
    I had accidently deleted the certificates from the dmgr

    How do I re-register the node ?
    When I start the node it starts fine, with a bunch of ffdc errors about this SSL issue.

    ReplyDelete