How To Install WebSphere Developers Edition - script based

Posted by Pascal Schöner on 11:23 PM with No comments


One part of a WebSphere administrators daily business is to integrate an application in a large WAS topologies.
In most cases the developers develop applications on some lightweight application servers like tomcat or jetty.
However it´s easier (for the WAS admin) when the developers have a Websphere server on their machine to develop directly on the IBM JDK and with the difficulties of WAS.


So you need a script which installs the WAS developers edition on the machine of your developers.
In the following steps you get some information what you need to do and some example scripts.
All non defined paths you need to set for your own are marked with [ ]-brackets.

1. First you have to Download all needed repositories. For the some packages you need your IBM passport advantage login. You need the following packages:
  • IBM Installation Manager from here
  • WebSphere Developers Edition installation packages from here
  • The latest fixpack for your WAS version from here
  • Optional you need the JDK7 (only for WAS 8.5 and above) from here
2. Now you have to unzip all the packages. At best you do this on a shared directory perhaps on a DFS.
So all of your developers can get the libaries for installation very easy without any download.

This is an example for the filesystem structure (left picture) and an unzipped repository (right picture):







3. Next you have to install the installation manager. You can do this very easy with the help of a batch-script and a xml file which descripes the installation:

example for the xml-installation file:
<?xml version="1.0" encoding="UTF-8"?>
<agent-input clean='true' temporary='true'>
<server>
 <repository location="[PATH TO YOUR REPOSITORIES]\InstallationManager"></repository>
</server>


<install>
<offering features='agent_core,agent_jre' id='com.ibm.cic.agent' installLocation='[DESTINATION ON YOUR MACHINE' />
        
</install>
</agent-input>

example for the batch script:
[PATH TO YOUR REPOSITORIES]\InstallationManager\tools\imcl.exe input "[PATH TO YOUR CONFIGDIRECTORY]\im_install.xml" -log "..\logs\im_install.log" -acceptLicense

4. Now you can start with the installation of your websphere server. In this case your need also a xml file wich descripes the installation and a batch file.

example for xml-installation file:
<?xml version='1.0' encoding='UTF-8'?>
<agent-input>
  <variables>
    <variable name='sharedLocation' value='[YOUR IM SHARED DIRECTORY]'/>
  </variables>
  <server>
    <repository location='[PATH TO YOUR REPOSITORIES]\was'/>
    <repository location='[PATH TO YOUR REPOSITORIES]\WS_SDK_JAVA'/>
    <repository location='[PATH TO YOUR REPOSITORIES]\fp'/>
  </server>
  <profile id='IBM WebSphere Application Server V8.5' installLocation='[YOUR WAS INSTALL LOCATION]'>
    <data key='eclipseLocation' value='[YOUR WAS INSTALL LOCATION]'/>
    <data key='user.import.profile' value='false'/>
    <data key='cic.selector.os' value='win32'/>
    <data key='cic.selector.arch' value='x86'/>
    <data key='cic.selector.ws' value='win32'/>
    <data key='cic.selector.nl' value='de,en'/>
  </profile>
  <install modify='false'>
    <!-- IBM WebSphere Application Server Network Deployment 8.5.5.2 -->
    <offering profile='IBM WebSphere Application Server V8.5' id='com.ibm.websphere.ND.v85' version='8.5.5002.20140408_1947' features='core.feature,ejbdeploy,thinclient,embeddablecontainer,com.ibm.sdk.6_64bit' installFixes='none'/>
    <!-- IBM WebSphere SDK Java Technology Edition (optional) 7.0.4.1 -->
    <offering profile='IBM WebSphere Application Server V8.5' id='com.ibm.websphere.IBMJAVA.v70' version='7.0.4001.20130510_2103' features='com.ibm.sdk.7' installFixes='none'/>
  </install>
  <preference name='com.ibm.cic.common.core.preferences.eclipseCache' value='${sharedLocation}'/>
  <preference name='com.ibm.cic.common.core.preferences.connectTimeout' value='30'/>
  <preference name='com.ibm.cic.common.core.preferences.readTimeout' value='45'/>
  <preference name='com.ibm.cic.common.core.preferences.downloadAutoRetryCount' value='0'/>
  <preference name='offering.service.repositories.areUsed' value='false'/>
  <preference name='com.ibm.cic.common.core.preferences.ssl.nonsecureMode' value='false'/>
  <preference name='com.ibm.cic.common.core.preferences.http.disablePreemptiveAuthentication' value='false'/>
  <preference name='http.ntlm.auth.kind' value='NTLM'/>
  <preference name='http.ntlm.auth.enableIntegrated.win32' value='true'/>
  <preference name='com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts' value='true'/>
  <preference name='com.ibm.cic.common.core.preferences.keepFetchedFiles' value='false'/>
  <preference name='PassportAdvantageIsEnabled' value='false'/>
  <preference name='com.ibm.cic.common.core.preferences.searchForUpdates' value='true'/>
  <preference name='com.ibm.cic.agent.ui.displayInternalVersion' value='false'/>
  <preference name='com.ibm.cic.common.sharedUI.showErrorLog' value='true'/>
  <preference name='com.ibm.cic.common.sharedUI.showWarningLog' value='true'/>
  <preference name='com.ibm.cic.common.sharedUI.showNoteLog' value='true'/>
</agent-input> 

You can get the IBM websphere offering ids you need for the xml from here

example for batch script:
call "[PATH TO YOUR IM-INSTALLTIDIR]\eclipse\tools\imcl.exe" input "[PATH TO YOUR CONFIGDIRECTORY]\was855_install.xml" -acceptLicense

The combination of the example batch file and the xml file has installed the WAS developers edition V8.5 with the fixpack and the optional JDK 7 out of your local repositories.

5. At last you should create a default WAS application server profile for your developer.
For this you only need a batch file which calls the manageprofile command from websphere:
[YOUR WAS INSTALL LOCATION]\bin\ProfileManagement\manageprofiles.bat -create -templatePath [YOUR WAS INSTALL LOCATION]\profileTemplates\default

6. (Optional) If you need the JDK7 you have to configure your JVM (server1) to use the JDK7 as default Java Runtime as described in this article.




[Images] Cover picture by Markus Spiske (http://www.raumrot.com/);