Installing on Debian Etch

From OpenCms Wiki
(Difference between revisions)
Jump to: navigation, search
(Deploying the opencms.war file)
m
 
(7 intermediate revisions by one user not shown)
Line 5: Line 5:
 
  update-alternatives --config java
 
  update-alternatives --config java
 
  update-alternatives --config javac
 
  update-alternatives --config javac
  apt-get install tomcat5.5 tomcat5.5-admin tomcat5.5-webapps
+
  apt-get install tomcat5.5
  
In case you want to run an ordinary Apache as a proxy in front of Tomcat, also install the mod-jk package:
+
In case you also want the tomcat-example-webapps and the admin-interface, install also the following packages:
  apt-get install libapache2-mod-jk
+
 
 +
apt-get install tomcat5.5-admin tomcat5.5-webapps
 +
 
 +
In case you want to run an ordinary Apache as a proxy in front of Tomcat, also install the apache2.2 package, it includes the necessary mod_proxy and mod_proxy_http, as well as rewrite:
 +
  apt-get install apache2-mpm-prefork apache2.2-common
 +
a2enmod proxy proxy_http proxy_ajp rewrite
  
 
== Configuring Apache Tomcat 5.5 ==
 
== Configuring Apache Tomcat 5.5 ==
Line 19: Line 24:
 
  TOMCAT5_SECURITY=no
 
  TOMCAT5_SECURITY=no
  
In case you use mod-jk, make the following changes to /etc/libapache2-mod-jk/workers.properties:
+
Add a user for managing tomcat, do to this, edit the file /etc/tomcat5.5/tomcat-users.xml and make it look like this:
workers.tomcat_home=/usr/share/tomcat5.5
+
workers.java_home=/usr/lib/jvm/java-1.5.0-sun
+
  
== Deploying the opencms.war file ==
+
<?xml version='1.0' encoding='utf-8'?>
 +
<tomcat-users>
 +
  <role rolename="tomcat"/>
 +
  <role rolename="admin"/>
 +
  <role rolename="manager"/>
 +
  <user username="tomcat" password="tomcat" roles="tomcat"/>
 +
  <user username="admin" password="admin" roles="admin,manager"/>
 +
</tomcat-users>
  
First, stop tomcat:
+
So your user for managing tomcat will be "admin", with the password "admin".
  
/etc/init.d/tomcat5.5 stop
+
Now, let's restart tomcat:
  
Then, copy the opencms.war into the webapps folder:
+
  /etc/init.d/tomcat5.5 restart
  cp opencms.war /var/lib/tomcat5.5/webapps/
+
  
Then, restart tomcat:
+
To see if all worked so far, navigate to [http://localhost:8180/ http://localhost:8180/] and you should see the welcome-page of tomcat. Click on
 +
"Tomcat Manager" and enter admin/admin to check if your newly created user works
  
 +
== Deploying the opencms.war file ==
 +
 +
First, stop Tomcat, then copy the opencms.war into the webapps folder, and start Tomcat again:
 +
 +
/etc/init.d/tomcat5.5 stop
 +
cp opencms.war /var/lib/tomcat5.5/webapps/
 
  /etc/init.d/tomcat5.5 start
 
  /etc/init.d/tomcat5.5 start
 +
 +
[[Category:Getting OpenCms up and running]]

Latest revision as of 11:44, 24 April 2008

Installing the necessary software

apt-get update
apt-get install sun-java5-jdk sun-java5-jre
update-alternatives --config java
update-alternatives --config javac
apt-get install tomcat5.5

In case you also want the tomcat-example-webapps and the admin-interface, install also the following packages:

apt-get install tomcat5.5-admin tomcat5.5-webapps 

In case you want to run an ordinary Apache as a proxy in front of Tomcat, also install the apache2.2 package, it includes the necessary mod_proxy and mod_proxy_http, as well as rewrite:

apt-get install apache2-mpm-prefork apache2.2-common
a2enmod proxy proxy_http proxy_ajp rewrite

Configuring Apache Tomcat 5.5

The file /etc/default/tomcat5.5 holds some configuration which we need to change: Change the following parameters:

#We have plenty of RAM, let's give it to Tomcat:
CATALINA_OPTS="-Djava.awt.headless=true -Xms512M -Xmx2048M -server"
TOMCAT5_SECURITY=no

Add a user for managing tomcat, do to this, edit the file /etc/tomcat5.5/tomcat-users.xml and make it look like this:

<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
 <role rolename="tomcat"/>
 <role rolename="admin"/>
 <role rolename="manager"/>
 <user username="tomcat" password="tomcat" roles="tomcat"/>
 <user username="admin" password="admin" roles="admin,manager"/>
</tomcat-users>

So your user for managing tomcat will be "admin", with the password "admin".

Now, let's restart tomcat:

/etc/init.d/tomcat5.5 restart

To see if all worked so far, navigate to http://localhost:8180/ and you should see the welcome-page of tomcat. Click on "Tomcat Manager" and enter admin/admin to check if your newly created user works

Deploying the opencms.war file

First, stop Tomcat, then copy the opencms.war into the webapps folder, and start Tomcat again:

/etc/init.d/tomcat5.5 stop
cp opencms.war /var/lib/tomcat5.5/webapps/
/etc/init.d/tomcat5.5 start
Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox