Date Created: Mon 27-Apr-2009

Related Document Categories:

Get my WebSphere Application Server course here >>

Install WebSphere Community Edition

Installing WCE on Linux

Download WebSphere Community edition from IBM, find link by searching Google. It is recommended you use the IBM HTTP Downloader as it can resume if your internet connection is not so stable. (Probably a good thing if you have Sky Broadband)

Using Winscp upload the binary install you downloaded to your Linux server.

Run the WebSphere Community Installation wizard

chmod 7555 wasce_setup-


Extracting the installation resources from the installer archive...
Configuring the installer for this system's environment...
No Java virtual machine could be found from your PATH
environment variable. You must install a VM prior to
running this program.

#Set JVM Path

Now run the installer again, it will not launch an XWindows installer

Accept the license agreement.

Select an appropriate folder on your file system. You can use the default if you wish.

The installer will confirm your installation path and confirm that you have enough disk space on the file system.

Click "Install" to begin the installation.

click "Done" to finish.


I installed as root, not good, but it was what I did so the logs are found in root's home directory.

view wasce_install_2009-3-29_12-34-02.log

The error found was:
Additional Notes: WARNING - Detected not recommended Unix JVM architecture=amd64/64/Sun Microsystems Inc.
I am not worried, I know my Linux Server is Centos5 64Bit and might have a few issues, we will see.
All in all I consider this s successful installationv.
OK now I will start up the product.

cd /var/apps/wce/bin


Using GERONIMO_BASE: /var/apps/wce
Using GERONIMO_HOME: /var/apps/wce
Using GERONIMO_TMPDIR: var/temp
Using JRE_HOME: /var/java/jdk1.6.0_12/jre
Using GERONIMO_OUT: /var/apps/wce/var/log/server.out

Server started in background. PID: 7685


I should not be able to connect to port 8080


I could not due to the fact I had tomcat administration running on this port, to see errros you can tail logs for example:

tail -f /var/apps/wce/var/log/server.out

Caused by: org.apache.geronimo.kernel.config.InvalidConfigException: Unknown start exception
at org.apache.geronimo.kernel.config.ConfigurationUtil.startConfigurationGBeans(
at org.apache.geronimo.kernel.config.KernelConfigurationManager.start(
at org.apache.geronimo.kernel.config.SimpleConfigurationManager.startConfiguration(
... 16 more
Caused by: org.apache.geronimo.gbean.InvalidConfigurationException: Configuration org.apache.geronimo.configs/tomcat6/2.1.3/car failed to start due to the following reasons:
The service ServiceModule=org.apache.geronimo.configs/tomcat6/2.1.3/car,j2eeType=GBean,name=TomcatWebConnector did not start because service.getName(): "null"; Protocol handler start failed: Address already in use /

at org.apache.geronimo.kernel.config.ConfigurationUtil.startConfigurationGBeans(
... 18 more


What I need to do now is find how to change WCE do bind to a particular IP Address and port.

find . -type f | xargs grep 8080

/var/apps/wce/var/config/config.xml most probably contains my configuration. However I found that the config file uses substituted avriables from a properties file


So I changed the following line








as shown below.


# Put variables and their substitution values in this file.
# They will be used when processing the corresponding config.xml.
# Values in this file can be overridden by environment variables and system properties
# by prefixing the property name with 'org.apache.geronimo.config.substitution.'
# For example, an entry such as hostName=localhost
# can be overridden by an environment variable or system property org.apache.geronimo.config.substitution.hostName=foo
# When running multiple instances of Geronimo choose a PortOffset value such that none of the ports conflict.
# For example, try PortOffset=10
#Thu Dec 04 15:59:51 GMT+08:00 2008


I then tried to restart WCE.


tail the logs and you will see something like below

Module 14/71 org.apache.geronimo.configs/webservices-common/2.1.3/car started in .000s
Module 15/71 org.apache.geronimo.configs/tomcat6/2.1.3/car started in 1.772s
Module 16/71 started in .178s
Module 17/71 org.apache.geronimo.framework/plugin/2.1.3/car started in .124s
Module 18/71 org.apache.geronimo.framework/geronimo-gbean-deployer/2.1.3/car started in .313s
Module 19/71 org.apache.geronimo.configs/derby/2.1.3/car started in .000s
Module 20/71 org.apache.geronimo.configs/system-database/2.1.3/car started in 10.708s
Module 21/71 org.apache.geronimo.configs/activemq-broker/2.1.3/car started in 3.558s
Module 22/71 org.apache.geronimo.configs/openjpa/2.1.3/car started in .011s
Module 23/71 org.apache.geronimo.configs/openejb/2.1.3/car started in .702s
Module 24/71 org.apache.geronimo.configs/axis/2.1.3/car started in .069s
Module 25/71 org.apache.geronimo.configs/axis2/2.1.3/car started in .000s
Module 26/71 org.apache.geronimo.configs/axis2-ejb/2.1.3/car started in .000s
Module 27/71 org.apache.geronimo.configs/j2ee-corba-yoko/2.1.3/car started in .475s
Module 28/71 org.apache.geronimo.configs/tomcat6-no-ha/2.1.3/car started in .000s
Module 29/71 org.apache.geronimo.configs/clustering/2.1.3/car started in .006s
Module 30/71 org.apache.geronimo.configs/j2ee-deployer/2.1.3/car started in .123s
Module 31/71 org.apache.geronimo.configs/connector-deployer/2.1.3/car started in .067s
Module 32/71 org.apache.geronimo.configs/tomcat6-deployer/2.1.3/car started in .044s
Module 33/71 org.apache.geronimo.configs/tomcat6-clustering-builder-wadi/2.1.3/car started in .030s
Module 34/71 org.apache.geronimo.configs/activemq-ra/2.1.3/car started in .416s
Module 35/71 org.apache.geronimo.configs/javamail/2.1.3/car started in .034s
Module 36/71 org.apache.geronimo.configs/jasper-deployer/2.1.3/car started in .013s
Module 37/71 org.apache.geronimo.configs/myfaces/2.1.3/car started in .009s
Module 38/71 org.apache.geronimo.configs/myfaces-deployer/2.1.3/car started in .014s
Module 39/71 org.apache.geronimo.configs/openejb-deployer/2.1.3/car started in .339s
Module 40/71 org.apache.geronimo.configs/openejb-corba-deployer/2.1.3/car started in .068s
Module 41/71 org.apache.geronimo.configs/persistence-jpa10-deployer/2.1.3/car started in .043s
Module 42/71 org.apache.geronimo.configs/axis-deployer/2.1.3/car started in .043s
Module 43/71 org.apache.geronimo.configs/jaxws-deployer/2.1.3/car started in .000s
Module 44/71 org.apache.geronimo.configs/axis2-deployer/2.1.3/car started in .026s
Module 45/71 org.apache.geronimo.configs/jaxws-ejb-deployer/2.1.3/car started in .000s
Module 46/71 org.apache.geronimo.configs/axis2-ejb-deployer/2.1.3/car started in .028s
Module 47/71 org.apache.geronimo.configs/client-deployer/2.1.3/car started in .087s
Module 48/71 org.apache.geronimo.configs/hot-deployer/2.1.3/car started in .248s
Module 49/71 started in .066s
Module 50/71 org.apache.geronimo.configs/spring/2.1.3/car started in .000s
Module 51/71 org.apache.geronimo.plugins/pluto-support/2.1.3/car started in .009s
Module 52/71 org.apache.geronimo.plugins/console-tomcat/2.1.3/car started in 1.629s
Module 53/71 org.apache.geronimo.plugins/plugin-console-tomcat/2.1.3/car started in .244s
Module 54/71 org.apache.geronimo.configs/dojo-legacy-tomcat/2.1.3/car started in .040s
Module 55/71 org.apache.geronimo.plugins/debugviews-console-tomcat/2.1.3/car started in .248s
Module 56/71 org.apache.geronimo.plugins/sysdb-console-tomcat/2.1.3/car started in 1.013s
Module 57/71 org.apache.geronimo.plugins/activemq-console-tomcat/2.1.3/car started in .231s
Module 58/71 org.apache.geronimo.plugins/plancreator-console-tomcat/2.1.3/car started in .136s
Module 59/71 org.apache.geronimo.configs/remote-deploy-tomcat/2.1.3/car started in .054s
Module 60/71 org.apache.geronimo.configs/uddi-tomcat/2.1.3/car started in .473s
Module 61/71 org.apache.geronimo.configs/ca-helper-tomcat/2.1.3/car started in .104s
Module 62/71 org.apache.geronimo.configs/sharedlib/2.1.3/car started in .006s
Module 63/71 org.apache.geronimo.configs/mejb/2.1.3/car started in .155s
Module 64/71 org.apache.geronimo.configs/dojo-tomcat/2.1.3/car started in .112s
Module 65/71 org.apache.geronimo.plugins/agent-ds/2.1.3/car started in 15.318s
Module 66/71 org.apache.geronimo.plugins/agent/2.1.3/car started in .207s
Module 67/71 org.apache.geronimo.plugins/mconsole-ds/2.1.3/car started in .107s
Module 68/71 org.apache.geronimo.plugins/mconsole-tomcat/2.1.3/car started in .383s
Module 69/71 started in .000s
Module 70/71 started in .000s
Module 71/71 started in .000s
Startup completed in 43.119s seconds

Listening on Ports:
1050 CORBA Naming Service
1099 RMI Naming
1527 Derby Connector
2001 OpenEJB ORB Adapter
4201 OpenEJB Daemon
6882 OpenEJB ORB Adapter
8009 Tomcat Connector AJP AJP
8081 Tomcat Connector HTTP BIO HTTP
8443 Tomcat Connector HTTPS BIO HTTPS
9999 JMX Remoting Connector
61613 ActiveMQ Transport Connector
61616 ActiveMQ Transport Connector

Started Application Modules:
EAR: org.apache.geronimo.configs/uddi-tomcat/2.1.3/car
EAR: org.apache.geronimo.plugins/console-tomcat/2.1.3/car
JAR: org.apache.geronimo.configs/mejb/2.1.3/car
JAR: org.apache.geronimo.plugins/agent/2.1.3/car
RAR: org.apache.geronimo.configs/activemq-ra/2.1.3/car
RAR: org.apache.geronimo.configs/system-database/2.1.3/car
RAR: org.apache.geronimo.plugins/agent-ds/2.1.3/car
RAR: org.apache.geronimo.plugins/mconsole-ds/2.1.3/car
WAR: org.apache.geronimo.configs/ca-helper-tomcat/2.1.3/car
WAR: org.apache.geronimo.configs/dojo-legacy-tomcat/2.1.3/car
WAR: org.apache.geronimo.configs/dojo-tomcat/2.1.3/car
WAR: org.apache.geronimo.configs/remote-deploy-tomcat/2.1.3/car
WAR: org.apache.geronimo.plugins/activemq-console-tomcat/2.1.3/car
WAR: org.apache.geronimo.plugins/debugviews-console-tomcat/2.1.3/car
WAR: org.apache.geronimo.plugins/mconsole-tomcat/2.1.3/car
WAR: org.apache.geronimo.plugins/plancreator-console-tomcat/2.1.3/car
WAR: org.apache.geronimo.plugins/plugin-console-tomcat/2.1.3/car
WAR: org.apache.geronimo.plugins/sysdb-console-tomcat/2.1.3/car

Web Applications:

Server started.


I am now going to try and connect to the Administrative Console

The default user name is "system" and the default password is "manager".

Get my WebSphere Application Server course here >>

Steve Robinson - IBM Champion 2013

About Me

Steve Robinson has been working in IT for over 20 years and has provided solutions for many large-enterprise corporate companies across the world. Steve specialises in Java and Middleware.

In January 2013, I was awarded the prestigous 'IBM Champion' accolade.

  • Linked In
  • Twitter
  • About Me
  • My Blog
  • Contact Me

Read my books?

IBM WebSphere Application Server 8.0 Administration Guide

IBM WebSphere Application Server 8.0 Administration Guide

WebSphere Application Server 7.0 Administration Guide

WebSphere Application Server 7.0 Administration Guide

WebSphere Categories

Other Categories