Install eXo platform 4.3 on windows

Trabla: Install eXo platform 4.3  on windows

eXo Platform is an open source, standard-based, Enterprise Social Collaboration Platform written in Java and distributed under the GNU Lesser General Public License. The platform is sold and distributed by eXo Platform, a global company with U.S. headquarters in San Francisco, California, global headquarters in France, and offices in Tunisia and Vietnam.
https://en.wikipedia.org/wiki/EXo_Platform

This tutorial explains how to  quick install eXo platform 4.3 on windows.

Solving:

1. Download and Install latest JRE - Java Runtime Environment ( if not installed on your machine )
from official Oracle site
http://www.oracle.com/technetwork/java/javase/downloads/index.html

2. Download eXo platform .zip from
https://sourceforge.net/projects/exo/

3. Create folder eXo on disk C:/   e.g. C:\eXo
 and  copy all files from eXo platform  archive

4. Set CATALINA_HOME windows environment variable
Create environment variable
CATALINA_HOME  and value - C:\eXo    (folder with exo files )

5. Set JRE_HOME windows environment variable

6. Change default port 8080
Open file <your_eXo_files>\conf\server.xml
for example on my PC C:\eXo\conf\server.xml
Change default port from 8080  to 8081

7. Run eXo

eXo started when \ | INFO  | Server startup in 534615 ms [org.apache.catali
na.startup.Catalina<main>]

8. Open browser with address

http://localhost:8081

eXo platform: java.net.BindException: Address already in use: bind

Trabla: eXo platform: java.net.BindException: Address already in use: bind

Full Console Output:

2016-04-23 21:09:07,358 | ERROR | Failed to start end point associated with Prot
ocolHandler ["http-nio-0.0.0.0-8080"] [o.apache.coyote.http11.Http11NioProtocol<
main>]
java.net.BindException: Address already in use: bind
        at sun.nio.ch.Net.bind0(Native Method) ~[na:1.8.0_92]
        at sun.nio.ch.Net.bind(Unknown Source) ~[na:1.8.0_92]
        at sun.nio.ch.Net.bind(Unknown Source) ~[na:1.8.0_92]
        at sun.nio.ch.ServerSocketChannelImpl.bind(Unknown Source) ~[na:1.8.0_92
]
        at sun.nio.ch.ServerSocketAdaptor.bind(Unknown Source) ~[na:1.8.0_92]
        at org.apache.tomcat.util.net.NioEndpoint.bind(NioEndpoint.java:475) ~[t
omcat-coyote.jar:7.0.63]
        at org.apache.tomcat.util.net.AbstractEndpoint.start(AbstractEndpoint.ja
va:666) ~[tomcat-coyote.jar:7.0.63]
        at org.apache.coyote.AbstractProtocol.start(AbstractProtocol.java:449) ~
[tomcat-coyote.jar:7.0.63]
        at org.apache.catalina.connector.Connector.startInternal(Connector.java:
1007) [catalina.jar:7.0.63]
        at org.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:150)
[catalina.jar:7.0.63]
        at org.apache.catalina.core.StandardService.startInternal(StandardServic
e.java:459) [catalina.jar:7.0.63]
        at org.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:150)
[catalina.jar:7.0.63]
        at org.apache.catalina.core.StandardServer.startInternal(StandardServer.
java:739) [catalina.jar:7.0.63]
        at org.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:150)
[catalina.jar:7.0.63]
        at org.apache.catalina.startup.Catalina.start(Catalina.java:689) [catali
na.jar:7.0.63]
        at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) ~[na:1.8.
0_92]
        at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source) ~[na:1.8.
0_92]
        at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source) ~[na:
1.8.0_92]
        at java.lang.reflect.Method.invoke(Unknown Source) ~[na:1.8.0_92]
        at org.apache.catalina.startup.Bootstrap.start(Bootstrap.java:321) [boot
strap.jar:7.0.63]
        at org.apache.catalina.startup.Bootstrap.main(Bootstrap.java:455) [boots
trap.jar:7.0.63]
2016-04-23 21:09:07,408 | ERROR | Failed to start connector [Connector[org.apach
e.coyote.http11.Http11NioProtocol-8080]] [org.apache.catalina.core.StandardServi
ce<main>]
org.apache.catalina.LifecycleException: Failed to start component [Connector[org
.apache.coyote.http11.Http11NioProtocol-8080]]
        at org.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:154)
[catalina.jar:7.0.63]
        at org.apache.catalina.core.StandardService.startInternal(StandardServic
e.java:459) ~[catalina.jar:7.0.63]
        at org.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:150)
[catalina.jar:7.0.63]
        at org.apache.catalina.core.StandardServer.startInternal(StandardServer.
java:739) [catalina.jar:7.0.63]
        at org.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:150)
[catalina.jar:7.0.63]
        at org.apache.catalina.startup.Catalina.start(Catalina.java:689) [catali
na.jar:7.0.63]
        at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) ~[na:1.8.
0_92]
        at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source) ~[na:1.8.
0_92]
        at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source) ~[na:
1.8.0_92]
        at java.lang.reflect.Method.invoke(Unknown Source) ~[na:1.8.0_92]
        at org.apache.catalina.startup.Bootstrap.start(Bootstrap.java:321) [boot
strap.jar:7.0.63]
        at org.apache.catalina.startup.Bootstrap.main(Bootstrap.java:455) [boots
trap.jar:7.0.63]
Caused by: org.apache.catalina.LifecycleException: service.getName(): "Catalina"
;  Protocol handler start failed
        at org.apache.catalina.connector.Connector.startInternal(Connector.java:
1014) ~[catalina.jar:7.0.63]
        at org.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:150)
[catalina.jar:7.0.63]
        ... 11 common frames omitted
Caused by: java.net.BindException: Address already in use: bind
        at sun.nio.ch.Net.bind0(Native Method) ~[na:1.8.0_92]
        at sun.nio.ch.Net.bind(Unknown Source) ~[na:1.8.0_92]
        at sun.nio.ch.Net.bind(Unknown Source) ~[na:1.8.0_92]
        at sun.nio.ch.ServerSocketChannelImpl.bind(Unknown Source) ~[na:1.8.0_92
]
        at sun.nio.ch.ServerSocketAdaptor.bind(Unknown Source) ~[na:1.8.0_92]
        at org.apache.tomcat.util.net.NioEndpoint.bind(NioEndpoint.java:475) ~[t
omcat-coyote.jar:7.0.63]
        at org.apache.tomcat.util.net.AbstractEndpoint.start(AbstractEndpoint.ja
va:666) ~[tomcat-coyote.jar:7.0.63]
        at org.apache.coyote.AbstractProtocol.start(AbstractProtocol.java:449) ~
[tomcat-coyote.jar:7.0.63]
        at org.apache.catalina.connector.Connector.startInternal(Connector.java:
1007) ~[catalina.jar:7.0.63]
        ... 12 common frames omitted
2016-04-23 21:09:07,458 | INFO  | Starting ProtocolHandler ["ajp-bio-0.0.0.0-800
9"] [org.apache.coyote.ajp.AjpProtocol<main>]
2016-04-23 21:09:07,568 | INFO  | Server startup in 750410 ms [org.apache.catali
na.startup.Catalina<main>]

This error typically appears when any another application is using
default port 8080.

Solving:

1. Stop eXo platform via stop_eXo.bat

2. Open file <your_eXo_files>\conf\server.xml
for example on my PC C:\eXo\conf\server.xml

3. Change default port from 8080  to 8081

4. Start eXo platform via start_eXo.bat

eXo platform: Neither the JAVA_HOME nor the JRE_HOME environment variable is defined

Trabla: starting eXo platform via  start_eXo.bat
- error in cmd:

Neither the JAVA_HOME nor the JRE_HOME environment variable is defined
At least one of these environment variable is needed to run this program

Solving:

To fix this error we need to create new environment variable
with name JRE_HOME
and value - path to JRE - java runtime environment

1. Open Control Panel -> System

2. Click "Advance system settings"
then click "Environment Variables"
then click "New"

3. Create new environment variable
JRE_HOME with value - path to JRE - java runtime environment
( e.g. on pc - C:\Program Files\Java\jre1.8.0_92 ) and press ok

ATTENTION: if you have opened windows command promt ( cmd )
- you should restart it to new environment variable take effect !!!

eXo platform: CATALINA_HOME environment variable is not defined correctly

Trabla: starting eXo platform via  start_eXo.bat
- error in cmd:

The CATALINA_HOME environment variable is not defined correctly
This environment variable is needed to run this program

Solving:

To fix this error we need to create new environment variable
with name CATALINA_HOME
and value - path to eXo files folder

1. Open Control Panel -> System

2. Click "Advance system settings"
then click "Environment Variables"
then click "New"

3. Create new environment variable
CATALINA_HOME with value - path to eXo platform files
( e.g. on pc - C:/eXo ) and press ok

ATTENTION: if you have opened windows command promt ( cmd )
- you should restart it to new environment variable take effect !!!