View source for OSTEP Websphere

[[Category:OSTEP SOP]][[Category:Websphere]]

= Overview =
Plan for a automated deployment of Websphere software on development systems. This deployment will take place inside a centos virtual machine. The virtual machine image will be installed with a kickstart file, which means, all that is needed to deploy a development environment, is a link to the kickstart file. The kickstart will pull in the basic installation package set, followed by the installation of custom repositories hosted online, which contain all the websphere software and plugins. This custom repository would contain websphere installations, fix packs and perhaps some other packages that may be needed in a development deployment. All the packages in the repository could be updated easily(and automatically if needed), in case a new fix pack comes out, or a new plugin build. From this repository it would be easy to deploy any software from it through a simple installation of the rpm packages.

= Getting Started =
This section will outline where to get information or files for any of the projects. Until this wiki page is complete, you may need to search google for some files or information, or ask someone. 

'''Websphere Version:'''
We are deploying websphere version 7

'''Websphere Files:'''
All of the websphere related files and plugins can be found in the following location.
Host: bahamas
Directory: /data/resources/

'''Websphere Fix Packs'''
Not every Fix Pack will be required. Download the latest Websphere Fix Packs. The latest Websphere Fix Packs can be found on this [http://www-01.ibm.com/support/docview.wss?uid=swg27009661 site].

'''Plugin'''
Get the latest Plugins for Websphere.

'''Known Problems/Solutions'''
Please read the known problems and solutions of each project. If you find a new problem that may need a manual fix, place the new problem and fix under the correct project. Document!

'''Manual Websphere Setup:''' 
[[OSTEP_Websphere_Manual_Setup | Manual Websphere Setup]]

'''Single Node Configuration'''
The single node configuration has mostly been documented, but you may need more resources in order to complete it. You can find many resources for wsadmin and commands to create members, servers, clusters, etc, all on the command line.
* [http://www-01.ibm.com/support/knowledgecenter/SSAW57_7.0.0/com.ibm.websphere.nd.multiplatform.doc/info/ae/ae/txml_addcluster.html add cluster commands]
* [http://www-01.ibm.com/support/knowledgecenter/SSFTDH_7.5.1/com.ibm.wbpm.imuc.sbpm.doc/topics/tins_create_cluster.html create cluster commands]
* [http://www-01.ibm.com/support/knowledgecenter/SSAW57_7.0.0/com.ibm.websphere.nd.multiplatform.doc/info/ae/ae/rxml_atclusterconfig.html cluster configuration]
* [http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/rxml_atservermanagement.html create servers commands]

= Package Websphere Application Server =
This step requires that the Websphere application is packaged within a rpm file. This step should include documentation on how it was packaged, any modifications made to the installation scripts/response files, and any difficulties that were experienced during the installation/packaging.

'''Who is working on this:''' place name here

== Manual Installation ==
[[OSTEP_Websphere_Manual_Setup#Install_Websphere_Application_Server | Manual Websphere Application Server ND Installation]]

== Progress ==
No progress has been made yet

== Known Problems/Solutions ==
This section indicates specific problems and possible solutions for the packaging Websphere application.

=== Installation Script on Centos ===
Problem:
*The installation script for Websphere on linux assumes that you are using redhat. This will cause a problem if you try and install using a centos system. 

Solution:
*Make the following changes to the file "/opt/IBM/WebSphere/Downloads/ApplicationServerND/WAS/install"
<pre>
* 433,434c433
<               release=`cat /etc/redhat-release | awk '{print $7}'`
---
>               #release=`cat /etc/redhat-release | awk '{print $7}'`
>               release=`cat /etc/centos-release | awk '{print $4}'`
</pre>

= Package Websphere Application Server Supplements =

This step requires that the Websphere application server supplements is packaged within a rpm file. This step should include documentation on how it was packaged, any modifications made to the installation scripts/response files, and any difficulties that were experienced during the installation/packaging.

'''Who is working on this:''' place name here

== Manual Installation ==
[[OSTEP_Websphere_Manual_Setup#Install_Websphere_Application_Server_Supplements | Manual Websphere Application Server ND Supplements Installation]]

== Progress ==
No progress has been made yet

== Known Problems/Solutions ==
This section indicates specific problems and possible solutions for the packaging Websphere application supplements.

=== Installation Script on Centos ===
Problem:
*The installation script for Websphere supplements on linux assumes that you are using redhat. This will cause a problem if you try and install using a centos system. 

Solution:
*Make the following changes to the file "/opt/IBM/WebSphere/Downloads/ApplicationServerNDSup/IHS/install"
<pre>

393c393,394
<                       release=`cat /etc/redhat-release | awk '{print $7}'`
---
>                       #release=`cat /etc/redhat-release | awk '{print $7}'`
>                       release=`cat /etc/centos-release | awk '{print $4}'`
433c434,435
<               release=`cat /etc/redhat-release | awk '{print $7}'`
---
>               #release=`cat /etc/redhat-release | awk '{print $7}'`
>               release=`cat /etc/centos-release | awk '{print $4}'`
</pre>

<!--
=== Failed Configuration Action ===

Problem:
*The installation completes only with a partial success, this "may" be enough to complete this project, but we should investigate why this is happening.
<pre>
(29-Oct-2014 1:09:52 PM), Process, com.ibm.ws.install.ni.ismp.installtoolkitbridge.ISMPInstallToolkitBridgeForNIFramework, wrn, Config action failed: CallPostinst - /opt/IBM/WebSphere/HTTPServer/properties/version/nif/config/install/CallPostinst.ant
(29-Oct-2014 1:09:52 PM), Process, com.ibm.ws.install.ni.ismp.installtoolkitbridge.ISMPInstallToolkitBridgeForNIFramework, wrn, Config action failed: InstallWASPlugin - /opt/IBM/WebSphere/HTTPServer/properties/version/nif/config/install/InstallWASPlugin.ant
(29-Oct-2014 1:09:52 PM), Process, com.installshield.wizardx.conditions.PlatformWizardBeanCondition, dbg.platform, target platform: name="Linux" version="3.10.0-123.6.3.el7.x86_64" arch="amd64"
(29-Oct-2014 1:09:52 PM), Process, com.installshield.wizardx.conditions.PlatformWizardBeanCondition, dbg.platform, condition platform: name="Windows .*" version="." arch="."
(29-Oct-2014 1:09:52 PM), Process, com.ibm.ws.install.ni.ismp.actions.SettleNIFRegistryAction, msg1, Current install/uninstall process is successful. Process type is: install
(29-Oct-2014 1:09:52 PM), Process, com.ibm.ws.install.ni.ismp.actions.SetExitCodeAction, msg1, CWUPI0000I: EXITCODE=2
(29-Oct-2014 1:09:52 PM), Process, com.ibm.ws.install.ni.ismp.actions.ISMPLogSuccessMessageAction, msg1, INSTCONFPARTIALSUCCESS
</pre>
Solution:
* No longer issue, moved to another bug
-->

=== Failed to run htpasswd ===

Problem:
*This program has packed a local version of the htpasswd binary inside it, this specific binary requires libraries that are unavailable by default.
<pre>

(29-Oct-2014 3:09:06 PM), Process, com.ibm.ws.install.ihs.ismp.actions.ExecWizardActionFromDirectory, err, java.io.IOException: Cannot run program "/opt/IBM/WebSphere/HTTPServer/bin/htpasswd" (in directory "/opt/IBM/WebSphere/HTTPServer"): java.io.IOException: error=2, No such file or directory
STACK_TRACE: 15
java.io.IOException: Cannot run program "/opt/IBM/WebSphere/HTTPServer/bin/htpasswd" (in directory "/opt/IBM/WebSphere/HTTPServer"): java.io.IOException: error=2, No such file or directory
        at java.lang.ProcessBuilder.start(ProcessBuilder.java:470)
        at java.lang.Runtime.exec(Runtime.java:604)
        at com.ibm.ws.install.ihs.ismp.actions.ExecWizardActionFromDirectory.executeProcess(ExecWizardActionFromDirectory.java:202)
        at com.ibm.ws.install.ihs.ismp.actions.ExecWizardActionFromDirectory.execute(ExecWizardActionFromDirectory.java:307)
        at com.installshield.wizard.StandardWizardListener.execute(StandardWizardListener.java:123)
        at com.installshield.wizard.StandardWizardListener.currentBeanChanged(StandardWizardListener.java:106)
        at com.installshield.wizard.Wizard$RunThread.run(Wizard.java:1569)
Caused by: java.io.IOException: java.io.IOException: error=2, No such file or directory
        at java.lang.Throwable.<init>(Throwable.java:67)
        at java.lang.UNIXProcess.<init>(UNIXProcess.java:197)
        at java.lang.ProcessImpl.start(ProcessImpl.java:101)
        at java.lang.ProcessBuilder.start(ProcessBuilder.java:463)
        ... 6 more


</pre>
Solution:
* Install the missing libraries
<pre>
sudo yum install glibc*i686*
</pre>

= Package Websphere Fixpacks =
This step requires that the Websphere Fix Packs are packaged within a rpm or multiple rpm files. This step should include documentation on how each were packaged, any modifications made to the installation scripts/response files, and any difficulties that were experienced during the installation/packaging. The installation of Fix Packs can only be completed after the Websphere software is installed. Automated packaging of this package rpm will be part of another step, these are not updated often, but rpms should be updated when the Fix Packs change.

'''Who is working on this:''' place name here

== Progress ==
No progress has been made yet

== Known Problems/Solutions ==
This section indicates specific problems and possible solutions for the Packaging Websphere Fix Packs 

=== Installation Script on Centos ===
Problem:
*The installation script for Websphere on linux assumes that you are using redhat. This will cause a problem if you try and install using a centos system.

Solution:
<pre>
Place patch, command, or instructions to fix installation script here.
</pre>

=== Response File ===
Problem:
<pre>
This file exists in the same directory as the installation script and must be modified with the correct responses for a successful installation.
</pre>
Solution:
<pre>
Place contents of response file on wiki here.
</pre>

<!--

= Package Nexj Plugins =
This step require the Nexj Plugins for Websphere are packaged in a rpm. This step should be very simple and shouldn't require any modifications or the files or during installation. Automated packaging of this package rpm will be part of another step, since these may be updated often.

'''Who is working on this:''' place name here

== Progress ==
No progress has been made yet

== Known Problems/Solutions ==
This section indicates specific problems and possible solutions for packaging Nexj Plugins

-->

= RPM Repository =
Some simple questions and information will be needed for this part. Will need to find the location to keep the repository, whether it can be public or private, access to certain resources(Nexj Plugins), a way for the other scripts to automatically upload files to the repository.

'''Who is working on this:''' place name here

== Progress ==
No progress has been made yet

== Known Problems/Solutions ==
This section indicates specific problems and possible solutions for the RPM Repository


= Centos Kickstart File =
Kickstart file that installs a basic centos system with all the tools we need for the websphere deployment. Probably want this to pull in minimal packages to save on size(?), as well as installing the custom repository that allows this installation access to our websphere software, fix packs, plugins, and configuration packages. This may also just kick off the installation of websphere and start all the services when it's ready.

'''Who is working on this:''' place name here

== Progress ==
No progress has been made yet

== Known Problems/Solutions ==
This section indicates specific problems and possible solutions for the Centos Kickstart File

<!--
= Script to Automate Websphere Fix Pack Packaging =
This step requires a script to be made which will automatically package websphere fixpacks into a rpm package and update the repository.

'''Who is working on this:''' place name here

== Progress ==
No progress has been made yet

== Known Problems/Solutions ==
This section indicates specific problems and possible solutions for the Script to Automate Websphere Fix Pack Packaging
-->

<!--
= Script to Automate Nexj Plugins Packaging =
This step requires a script to be made which will automatically package, latest Nexj Plugin files, into a rpm package and update the repository.

'''Who is working on this:''' place name here

== Progress ==
No progress has been made yet

== Known Problems/Solutions ==
This section indicates specific problems and possible solutions for the Script to Automate Nexj Plugins Packaging
-->


<!--
= Websphere Single Node Configuration =
This step may need more planning and testing. This is the final step which is done after the Websphere installation, Websphere Fix Packs installation, and Nexj Plugins installation. This step could become a part of a package that installs a single node configuration to websphere, it could be a script that runs the proper wsadmin commands to configure websphere, or it could be a puppet instance to deploy the configuration. No matter which option is chosen, it should be packaged and stored in the repository to keep with the same deployment method.

'''Who is working on this:''' place name here

== Progress ==
No progress has been made yet

== Known Problems/Solutions ==
This section indicates specific problems and possible solutions for the Websphere Single Node Configuration
-->