David Ghedini

Linux, Java, Oracle, and PostgreSQL


David Ghedini

Tuesday Aug 14, 2012

Apache TomEE on CentOS 6

This post will cover installing Apache TomEE on CentOS 6.x

TomEE is a certified implementation of the Java EE 6 Web Profile.

What is most interesting is that it is build on top of Tomcat 7. Literally. Nothing has been removed from Tomcat 7, only added to.

Installation is quite identical to Tomcat 7 and you can even deploy TomEE as a WAR from within an existing Tomcat 7.x installation.

I wasn't keen on this option as the overall directory structure, jar locations, conf files, etc...are different from the apache-tomee-1.0.0-webprofile package layout, which we will be installing below.

Conversely, it could be an option to consider as apache-tomee-1.0.0-webprofile is packaged with Tomcat 7.0.27 (current stable is 7.0.29).

There is also a TomEE Plus package with additional features, but this is not Java EE6 certified. Installation of TomEE Plus is identical to Web Profile below, just change the file names.

Below, we'll install TomEE and configure it to run as a service. To see how to run TomEE as an unprivileged user, Manager configuration, run on port 80, etc, etc...please see my Tomcat 7 Installation post

To begin, we'll need to install the Java Development Kit (JDK) 6




Step 1: Install JDK 1.6 latest



You can download the latest JDK here: http://www.oracle.com/technetwork/java/javase/downloads/index.html

We'll install the latest JDK, which is JDK 6, Update 33.

For CentOS 64 bit, I'll be using jdk-6u33-linux-x64.bin (for 32 bit, use jdk-6u33-linux-i586.bin)

Download jdk-6u33-linux-x64.bin and save it the /opt directory.

[root@demo3 opt]# ls
jdk-6u33-linux-x64.bin


Creating a new directory /usr/java:

[root@demo3 opt ]# mkdir /usr/java  


Change to the /usr/java directory we created

[root@demo3 opt ]# cd /usr/java  
[root@demo3 java ]# 


Execute the bin file using 'sh /opt/jdk-6u33-linux-x64.bin' (if you saved jdk-6u33-linux-x64.bin to a location other than /opt, adjust accordingly)

[root@demo3 java]# sh /opt/jdk-6u33-linux-x64.bin


This will create the directory /usr/java/jdk1.6.0_33. This will be our JAVA_HOME.


We can now set JAVA_HOME and put Java into the path of our users.

To set the JAVA_HOME, add below to the .bash_profile of root (you can do the same for user tomcat - or any other user - later if you decide to run it under a non-privileged user).
JAVA_HOME=/usr/java/jdk1.6.0_33
export JAVA_HOME
PATH=$JAVA_HOME/bin:$PATH
export PATH


Once you have added the above to .bash_profile, issue '. ~/.bash_profile' as shown below. Or you can simply log out and log back in.

[root@demo3 ~]#  . ~/.bash_profile


Verify that Java is now in your path by issuing 'echo $JAVA_HOME'

[root@demo3 ~]# echo $JAVA_HOME
/usr/java/jdk1.6.0_33


You can also issue 'java -version' to check that Java is available to your user.

[root@demo3 ~]# java -version
java version "1.6.0_33"
Java(TM) SE Runtime Environment (build 1.6.0_33-b04)
Java HotSpot(TM) 64-Bit Server VM (build 20.8-b03, mixed mode)


Step 2: Download and Unpack Apache TomEE 1.0.0 (or latest)



We will install TomEE under /usr/share.

Switch to the /usr/share directory:

[root@demo3 ~]# cd /usr/share
[root@demo3 share ]# 
Download apache-tomee-1.0.0-webprofile.tar.gz (or the latest version) here

and save it to /usr/share

unpack the file using tar -xzf:

[root@demo3 share ]# tar -xzf apache-tomee-1.0.0-webprofile.tar.gz 
This will create the directory /usr/share/apache-tomee-webprofile-1.0.0

This will be the home directory for TomEE


Step 3: Configure TomEE to Run as a Service.



Create a simple Start/Stop/Restart for TomEE.

Change to the /etc/init.d directory and create a script called 'tomee' as shown below.

[root@demo3 share]# cd /etc/init.d
[root@demo3 init.d]# vi tomee
And here is the script we will use.

#!/bin/bash
# description: TomEE Start Stop Restart
# processname: tomee
# chkconfig: 234 20 80
JAVA_HOME=/usr/java/jdk1.6.0_33
export JAVA_HOME
PATH=$JAVA_HOME/bin:$PATH
export PATH
CATALINA_HOME=apache-tomee-webprofile-1.0.0

case $1 in
start)
sh $CATALINA_HOME/bin/startup.sh
;; 
stop)   
sh $CATALINA_HOME/bin/shutdown.sh
;; 
restart)
sh $CATALINA_HOME/bin/shutdown.sh
sh $CATALINA_HOME/bin/startup.sh
;; 
esac    
exit 0
You can adjust your script according to your needs.

Make the script executable:

[root@demo3 init.d]# chmod 755 tomee
Add to chkconfig with run levels 234 (or whatever you prefer)

[root@demo3 init.d]# chkconfig --add tomee
[root@demo3 init.d]# chkconfig --level 234 tomee on
Verify it:

[root@demo3 init.d]# chkconfig --list tomee
tomee          0:off   1:off   2:on    3:on    4:on    5:off   6:off
Test the script.

Start TomEE:
[root@demo3 ~]# service tomee start
Using CATALINA_BASE:   /usr/share/apache-tomee-webprofile-1.0.0
Using CATALINA_HOME:   /usr/share/apache-tomee-webprofile-1.0.0
Using CATALINA_TMPDIR: /usr/share/apache-tomee-webprofile-1.0.0/temp
Using JRE_HOME:        /usr/java/jdk1.6.0_33
Using CLASSPATH:       /usr/share/apache-tomee-webprofile-1.0.0/bin/bootstrap.jar:/usr/share/apache-tomee-webprofile-1.0.0/bin/tomcat-juli.jar
Check if the Tomcat Manager page is visible at http://yourIPaddress:8080. If not check your firewall and logs.

Stop TomEE:

[root@demo3 ~]# service tomee stop
Using CATALINA_BASE:   /usr/share/apache-tomee-webprofile-1.0.0
Using CATALINA_HOME:   /usr/share/apache-tomee-webprofile-1.0.0
Using CATALINA_TMPDIR: /usr/share/apache-tomee-webprofile-1.0.0/temp
Using JRE_HOME:        /usr/java/jdk1.6.0_33
Using CLASSPATH:       /usr/share/apache-tomee-webprofile-1.0.0/bin/bootstrap.jar:/usr/share/apache-tomee-webprofile-1.0.0/bin/tomcat-juli.jar
Review the catalina.out log located at /usr/share/apache-tomee-webprofile-1.0.0/logs/catalina.out and check for any errors.

[root@demo3 init.d]# more /usr/share/apache-tomee-webprofile-1.0.0/logs/catalina.out


Step 4 (Optional): Configure Remote Access to TomEE Console



By default, the TomEE Console is restricted via a valve to 127.0.0.1 (localhost).

You can remove or change this via the context.xml at:

/usr/share/apache-tomee-webprofile-1.0.0/webapps/tomee/META-INF/context.xml

<Context>
  <Valve className="org.apache.catalina.valves.RemoteAddrValve" allow="127\.0\.0\.1|0:0:0:0:0:0:0:1(%.*)?|^::1$" deny=""/>
</Context>


As with Tomcat 7, piping (|) is used in place of commas.


Below is a quick look at the TomEE Console screens and it's tabs:


TomEE Console Welcome Page:

TomEE Console



TomEE Console Test Page:

TomEE Console Test



TomEE Console JNDI Page:

TomEE Console JNDI



TomEE Console EJB Page:

TomEE Console EJB



TomEE Console Class Page:

TomEE Console Class



TomEE Console Invoke Page:

TomEE Console Invoke



To see how to run TomEE as an unprivileged user, Manager configuration, run on port 80, etc... please see my Tomcat 7 Installation post Related Tomcat Posts

Learn More About Apache Tomcat 7 Apache Tomcat Foundation Tomcat 7

Tomcat 7 Hosting

Bookmark and Share



Thursday May 26, 2011

Installing Tomcat 7 on Slackware 13

This entry will cover installing and configuration of Tomcat 7 on Slackware 13

It will also work for Tomcat 6.x.

We'll install the JDK, Tomcat, create a start/stop script, and configure Tomcat to run as a service and start at boot.

For this installation, we'll use Tomcat 7.0.14, the current release of Tomcat 7.

To begin, we'll install the Java Development Kit (JDK) 1.6 update 25

JDK 1.6 is the minimum JDK version required for Tomcat 7.


Step 1: Install the JDK


Download the JDK here: http://www.oracle.com/technetwork/java/javase/downloads/index.html

We'll use the latest, JDK 6 Update 25. The JDK is specific to 32 and 64 bit versions.

My Slackware box is 32 bit, so I'll need: jdk-6u25-linux-i586.bin

If you are on 32 bit, you'll need: jdk-6u25-linux-x64.bin

Download the JDK and save it to a directory. I'm saving it to /opt.


Create a new directory /usr/java.
root@slackd:~# mkdir /usr/java  

Change to the /usr/java directory we created and install the JDK using 'sh /opt/jdk-6u25-linux-i586.bin'
root@slackd:~# cd /usr/java
root@slackd:/usr/java# sh /opt/jdk-6u25-linux-i586.bin

Set the JAVA_HOME path to the location we installed our JDK above.

To set it for your current session, you can issue the following from the CLI:
root@slackd:/usr/java# JAVA_HOME=/usr/java/jdk1.6.0_25
root@slackd:/usr/java# export JAVA_HOME
root@slackd:/usr/java# PATH=$JAVA_HOME/bin:$PATH
root@slackd:/usr/java# export PATH
Step 2: Download and Unpack Tomcat 7.0.14


Download apache-tomcat-7.0.14.tar.gz here

Save the file to the /usr/share directory In the /usr/share directory, unpack the file using tar -xzf:

root@slackd:~# cd /usr/share
root@slackd:/usr/share# tar -xzf apache-tomcat-7.0.14.tar.gz  
This will create the directory /usr/share/apache-tomcat-7.0.14

Step 3: Configuring Tomcat to Run as a Service.


We will now create a simple Start/Stop/Restart script and configure Tomcat to run as a service. We will also configure Tomcat to start at boot.

Change to the /etc/rc.d directory and create a script called 'tomcat' as shown below.

root@slackd:~# cd /etc/rc.d
root@slackd:/etc/rc.d# vi rc.tomcat
#!/bin/bash
JAVA_HOME=/usr/java/jdk1.6.0_25
export JAVA_HOME
PATH=$JAVA_HOME/bin:$PATH
export PATH
CATALINA_HOME=/usr/share/apache-tomcat-7.0.14

case $1 in
start)
sh $CATALINA_HOME/bin/startup.sh
;; 
stop)   
sh $CATALINA_HOME/bin/shutdown.sh
;; 
restart)
sh $CATALINA_HOME/bin/shutdown.sh
sh $CATALINA_HOME/bin/startup.sh
;; 
esac    
exit 0
In the above script, we are simply calling the startup.sh and shutdown.sh scripts located in the Tomcat bin directory (/usr/share/apache-tomcat-7.0.14/bin).

CATALINA_HOME is the Tomcat home directory (/usr/share/apache-tomcat-7.0.14)

Now, set the permissions for your script to make it executable:

root@slackd: /etc/rc.d# chmod 755 tomcat
We can now run tomcat as a background service using: /etc/rc.d/rc.tomcat start | stop | restart

Test our script.

Start Tomcat:
root@slackd:~# /etc/rc.d/rc.tomcat start
Using CATALINA_BASE:   /usr/share/apache-tomcat-7.0.14
Using CATALINA_HOME:   /usr/share/apache-tomcat-7.0.14
Using CATALINA_TMPDIR: /usr/share/apache-tomcat-7.0.14/temp
Using JRE_HOME:        /usr/java/jdk1.6.0_25
Using CLASSPATH:       /usr/share/apache-tomcat-7.0.14/bin/bootstrap.jar:/usr/share/apache-tomcat-7.0.14/bin/tomcat-juli.jar
Stop Tomcat:

root@slackd:~# /etc/rc.d/rc.tomcat stop
Using CATALINA_BASE:   /usr/share/apache-tomcat-7.0.14
Using CATALINA_HOME:   /usr/share/apache-tomcat-7.0.14
Using CATALINA_TMPDIR: /usr/share/apache-tomcat-7.0.14/temp
Using JRE_HOME:        /usr/java/jdk1.6.0_25
Using CLASSPATH:       /usr/share/apache-tomcat-7.0.14/bin/bootstrap.jar:/usr/share/apache-tomcat-7.0.14/bin/tomcat-juli.jar
Restarting Tomcat (Must be started first):

root@slackd:~# /etc/rc.d/rc.tomcat restart
Using CATALINA_BASE:   /usr/share/apache-tomcat-7.0.14
Using CATALINA_HOME:   /usr/share/apache-tomcat-7.0.14
Using CATALINA_TMPDIR: /usr/share/apache-tomcat-7.0.14/temp
Using JRE_HOME:        /usr/java/jdk1.6.0_25
Using CLASSPATH:       /usr/share/apache-tomcat-7.0.14/bin/bootstrap.jar:/usr/share/apache-tomcat-7.0.14/bin/tomcat-juli.jar
Using CATALINA_BASE:   /usr/share/apache-tomcat-7.0.14
Using CATALINA_HOME:   /usr/share/apache-tomcat-7.0.14
Using CATALINA_TMPDIR: /usr/share/apache-tomcat-7.0.14/temp
Using JRE_HOME:        /usr/java/jdk1.6.0_25
Using CLASSPATH:       /usr/share/apache-tomcat-7.0.14/bin/bootstrap.jar:/usr/share/apache-tomcat-7.0.14/bin/tomcat-juli.jar
You should review the Catalina.out log located at /usr/share/apache-tomcat-7.0.14/logs/catalina.out and check for any errors.

You should now be able to access Tomcat at:

http://yourdomain.com:8080 or http://yourIPaddress:8080 and we should see the Tomcat home page.
FInally, to enable Tomcat to start at boot time, add the following lines to /etc/rc.local:
if [ -x /etc/rc.d/rc.tomcat ]; then
/etc/rc.d/rc.tomcat start
Related Tomcat Posts

Learn More About Apache Tomcat 7 Apache Tomcat Foundation Tomcat 7

Bookmark and Share



Sunday Mar 06, 2011

Install Apache Roller 4 with Tomcat on CentOS

This post will cover installing Apache Roller 4.0.1 on CentOS with Tomcat and MySQL.

4.0.1 is the current GA production release of Apache Roller.

For this post, you will need a working installation of Tomcat. If you do not have Tomcat installed, you can install it using our Tomcat step-by-step guide here.

What you will need to download:

apache-roller-4.0.1.zip JavaMail 1.4.4 mysql-connector-java-5.1.15-bin.jar I'll be saving the above file to my /opt directory.

1. Create the Required MySQL Database and User:


We'll call our database 'roller'

[root@srv6 opt]# mysql -u root -p
Enter password:
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 2694
Server version: 5.0.77 Source distribution

Type 'help;' or '\h' for help. Type '\c' to clear the buffer.

mysql> create database roller;
Query OK, 1 row affected (0.00 sec)

mysql> grant all on roller.* to myuser@localhost identified by 'secret';
Query OK, 0 rows affected (0.00 sec)

mysql>


2. Copy The Required JAR Files to the Tomcat/lib Directory


From our downloads, we'll need to copy the mail.jar and mysql-connector-java-5.1.15-bin.jar to our Tomcat/lib Directory

Unzip javamail1_4_4.zip

[root@srv6 opt]# unzip -q javamail1_4_4.zip
Change to the javamail-1.4.4 directory and copy mail.jar to the Tomcat lib directory:
[root@srv6 opt]# cd javamail-1.4.4
[root@srv6 javamail-1.4.4]# cp mail.jar /usr/share/apache-tomcat-6.0.30/lib/mail.jar


Change back to the /opt directory and unpack mysql-connector-java-5.1.15.tar.gz

[root@srv6 javamail-1.4.4]# cd /opt
[root@srv6 opt]# tar -xvf mysql-connector-java-5.1.15.tar.gz


Change to the mysql-connector-java-5.1.15 directory and copy mysql-connector-java-5.1.15-bin.jar to the Tomcat lib directory:

[root@srv6 opt]# cd mysql-connector-java-5.1.15
[root@srv6 mysql-connector-java-5.1.15]# cp mysql-connector-java-5.1.15-bin.jar /usr/share/apache-tomcat-6.0.30/lib/mysql-connector-java-5.1.15-bin.jar


3. Create a roller-custom.properties File


We'll now create our roller-custom.properties file in the Tomcat/lib directory

[root@srv6 mysql-connector-java-5.1.15]#  cd /usr/share/apache-tomcat-6.0.30/lib
[root@srv6 lib]# vi roller-custom.properties


The file should contain the following. Replace database, user and password with your own. If required enter the mail user credentials as well.

installation.type=auto
database.configurationType=jdbc
database.jdbc.driverClass=com.mysql.jdbc.Driver
database.jdbc.connectionURL=jdbc:mysql://localhost:3306/roller
database.jdbc.username=myuser
database.jdbc.password=secret
mail.configurationType=properties
mail.hostName=localhost
#mail.username=
#mail.password=
4. Create roller.war


We now need to build the roller.war file from our Roller download.

Unzip apache-roller-4.0.1.zip

[root@srv6 opt]# unzip -q apache-roller-4.0.1.zip
Change to the apache-roller-4.0.1/webapp/roller directory
[root@srv6 opt]# cd apache-roller-4.0.1/webapp/roller
Create the WAR file
[root@srv6 roller]# % jar cvf ../roller.war *


5. Copy the roller.war to your Tomcat/webapps Directory


The roller.war file is created apache-roller-4.0.1/webapp directory. Copy the WAR to your Tomcat/webapps directory

[root@srv6 webapp]# cp roller.war /usr/share/apache-tomcat-6.0.30/webapps/roller.war


6. Start Tomcat


Start up Tomcat to load your new files and jars.

[root@srv6 webapp]# service tomcat start
Using CATALINA_BASE:   /usr/share/apache-tomcat-6.0.30
Using CATALINA_HOME:   /usr/share/apache-tomcat-6.0.30
Using CATALINA_TMPDIR: /usr/share/apache-tomcat-6.0.30/temp
Using JRE_HOME:        /usr/java/jdk1.6.0_23
Using CLASSPATH:       /usr/share/apache-tomcat-6.0.30/bin/bootstrap.jar


7. Create Roller Tables in MySQL via Roller GUI


If your installation was successful, you should now be able to go to http://YourIP:8080/roller or http://YourDomain:8080/roller

If you are not able to access Roller, check your catalina.out or roller.log files in your Tomcat/logs directory.

You should see a prompt to create the roller tables in MySQL.

Click the "Yes - Create Tables Now" button



On successful completion of creating the Roller tables in MySQL you will see the following:



Follow the prompt and click to complete the installation.

8. Create Global Admin User


The Roller Front Page should now be displayed as below.



Click the 'New User Registration Link' to create your Global Admin user. As noted, the first user registered will have Global Admin rights.



http://roller.apache.org/

Bookmark and Share




Main Menu

Built With

Search

Pages

LinkedIn

Tag Cloud

Hosted by:

Navigation

Visitors

Sponsors

petiole Cloud

Feeds