Installing Apache Webserver (Deprecated)

Tags: not added yet

Apache Installation and Configuration

This page describes how to install and setup Apache to use it with codeBeamer.

Red Hat Enterprise Linux

Install Apache-2:
```
sudo yum install httpd
```
Unfortunately, the Red Hat distribution does not include the Apache Tomcat Connector (mod_jk), so you have to compile and install it yourself:
```
yum install gcc
yum install gcc-c++
yum install httpd-devel

cd <jakarta-tomcat-connectors-<version-src>/jk/native

./configure --with-apxs=/usr/sbin/apxs

make
make install
```
This will place the compiled mod_jk.so library in the /etc/httpd/modules directory.

Create a new file mod_jk.conf in the /etc/httpd/conf directory:

# Load mod_jk module
# Specify the filename of the mod_jk lib
LoadModule jk_module modules/mod_jk.so

# Where to find workers.properties
JkWorkersFile conf/workers.properties

# Where to put jk logs
JkLogFile /var/log/httpd/mod_jk.log

# Set the jk log level [debug/error/info]
JkLogLevel info

# Select the log format
JkLogStampFormat  "[%a %b %d %H:%M:%S %Y]"

# JkOptions indicates to send SSK KEY SIZE
JkOptions +ForwardKeySize +ForwardURICompat -ForwardDirectories

# JkRequestLogFormat
JkRequestLogFormat "%w %V %T"

# Mount your applications
#JkMount /cb* ajp13

Create a new file workers.properties in the /etc/httpd/conf directory:

worker.list=ajp13

worker.ajp13.port=8009
worker.ajp13.host=localhost
worker.ajp13.type=ajp13
worker.ajp13.socket_keepalive=true
worker.ajp13.lbfactor=1
worker.ajp13.connection_pool_size=50
worker.ajp13.connect_timeout=5000
worker.ajp13.prepost_timeout=5000
worker.ajp13.max_packet_size=65536

Edit /etc/httpd/conf/httpd.conf and add a single line at the end of the file:
```
# Include mod_jk's specific configuration file
Include conf/mod_jk.conf
```
Also add
```
JkMount /cb* ajp13
```
either at root level or to the appropriate Virtual Host section.
Check Apache configuration
```
/etc/init.d/httpd configtest
```
Restart Apache
```
/etc/init.d/httpd restart
```
Apache Logfiles:
```
/var/log/httpd
```

SuSE Linux

Install Apache-2 packets for SUSE via YAST:
```
apache2
apache2-mod_jk
```
Edit /etc/sysconfig/apache2 and add "mod_jk" to the APACHE_MODULES:
```
APACHE_MODULES=" .... mod_jk"
```

Create a new file mod_jk.conf in the directory /etc/apache2/conf.d:

<IfModule mod_jk.c>

    JkWorkersFile /etc/apache2/conf.d/workers.properties
    JkLogFile /var/log/apache2/mod_jk.log
    JkShmFile /var/log/apache2/shm

    # Log level to be used by mod_jk
    JkLogLevel error

    # Mount /cb*
    JkMount /cb* ajp13

</IfModule>

Create a new file workers.properties in the directory /etc/apache2/conf.d:

worker.list=ajp13

worker.ajp13.port=8009
worker.ajp13.host=localhost
worker.ajp13.type=ajp13
worker.ajp13.socket_keepalive=true
worker.ajp13.lbfactor=1
worker.ajp13.connection_pool_size=50
worker.ajp13.connect_timeout=5000
worker.ajp13.prepost_timeout=5000
worker.ajp13.max_packet_size=65536

Check Apache configuration
```
/etc/init.d/apache2 configtest
```
Restart Apache
```
/etc/init.d/apache2 restart
```
Apache log files
```
/var/log/apache2/
```

Ubuntu

Install Apache-2:

sudo apt-get install apache2 libapache2-mod-jk

Create a new file jk.conf (if it does not exist) in the directory /etc/apache2/mods-available:

JkWorkersFile /etc/apache2/workers.properties
JkLogFile /var/log/apache2/mod_jk.log
JkShmFile /var/log/apache2/shm

# Log level to be used by mod_jk
JkLogLevel error
JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "

# Mount /cb*
JkMount /cb* ajp13

Depending on your Apache version it might be necessary that JkMount must be used in VirtualHost as below (that can be done for example in /etc/apache2/httpd.conf):

<VirtualHost *:80>
    ServerName  myserver
    JkMount /cb* ajp13
</VirtualHost>

Create a soft link in /etc/apache2/mods-enabled to enable mod_jk:
```
cd /etc/apache2/mods-enabled
ln -s ../mods-available/jk.conf
```

Create a new file workers.properties in the directory /etc/apache2:

worker.list=ajp13

worker.ajp13.port=8009
worker.ajp13.host=localhost
worker.ajp13.type=ajp13
worker.ajp13.socket_keepalive=true
worker.ajp13.lbfactor=1
worker.ajp13.connection_pool_size=50
worker.ajp13.connect_timeout=5000
worker.ajp13.prepost_timeout=5000
worker.ajp13.max_packet_size=65536

Check Apache configuration
```
/etc/init.d/apache2 configtest
```
Restart Apache
```
/etc/init.d/apache2 restart
```
Apache log files
```
/var/log/apache2/
```

Windows

Download Apache-2.2.25 installer from the location below (or from any alternative source):
http://archive.apache.org/dist/httpd/binaries/win32/httpd-2.2.25-win32-x86-openssl-0.9.8y.msi
Install Apache to the default location (e.g C:\Program Files (x86)\Apache Software Foundation\) and choose typical installation.
Download and install mod_jk Apache module for Windows from:
https://archive.apache.org/dist/tomcat/tomcat-connectors/jk/binaries/win32/jk-1.2.31/mod_jk-1.2.31-httpd-2.2.3.so
You must copy the file 'mod_jk-1.2.31-httpd-2.2.3.so' to the HTTPD module directory (e.g. C:\Program Files (x86)\Apache Software Foundation\Apache2.2\modules\), and rename it to 'mod_jk.so'.

Create a new file 'workers.properties' in the \conf directory (e.g. "C:\Program Files (x86)\Apache Software Foundation\Apache2.2\conf"):

worker.list=ajp13

worker.ajp13.port=8009
worker.ajp13.host=localhost
worker.ajp13.type=ajp13
worker.ajp13.socket_keepalive=true
worker.ajp13.lbfactor=1
worker.ajp13.connection_pool_size=50
worker.ajp13.connect_timeout=5000
worker.ajp13.prepost_timeout=5000
worker.ajp13.max_packet_size=65536

Edit Apache Configuration

Click on Start->All apps->Apache HTTP Server 2.2->Edit the Apache httpd.conf Configuration File.
Alternatively the configuration file can be edited directly in a text editor. The file is located in \conf folder (e.g. C:\Program Files (x86)\Apache Software Foundation\Apache2.2\conf\. Also, it might require adjusting access permissions.

Append the following to the end of Apache configuration file httpd.conf

# Load mod_jk module
LoadModule    jk_module "C:/Program Files (x86)/Apache Software Foundation/Apache2.2/modules/mod_jk.so"

<IfModule mod_jk.c>

    # Where to find workers.properties
    JkWorkersFile "C:/Program Files (x86)/Apache Software Foundation/Apache2.2/conf/workers.properties"

    # Where to put jk shared memory
    JkShmFile      "C:/Program Files (x86)/Apache Software Foundation/Apache2.2/logs/mod_jk.shm"

    # Where to put jk logs
    JkLogFile      "C:/Program Files (x86)/Apache Software Foundation/Apache2.2/logs/mod_jk.log"

    # Set the jk log level [debug/error/info]
    JkLogLevel     error

    # Select the timestamp log format
    JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "

    # Mount /cb*
    JkMount /cb* ajp13

</IfModule>

Folder path references should be adjusted accordingly (e.g. "C:\Program Files\Apache Software Foundation\Apache2.2\" should be replaced with actual installation folder).

Check Apache configuration
Start->All apps->Apache HTTP Server 2.2->Test Configuration
Alternatively this can be done in command window by executing the httpd -t command in \bin folder (e.g. C:\Program Files (x86)\Apache Software Foundation\Apache2.2\bin).
Restart Apache
Use Start->All apps->Apache HTTP Server 2.2->Restart, or the service manager.

Other versions of Apache web server can work with codeBeamer. However the Apache HTTP Server Project does not provide binary releases anymore, only source code.