You are not logged in. Click here to enter.

codeBeamer ALM
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

  1. Install Apache-2:
    sudo yum install httpd
    
  2. 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.

  3. 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
    
  4. 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
    
  5. 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.

  6. Check Apache configuration
    /etc/init.d/httpd configtest
    
  7. Restart Apache
    /etc/init.d/httpd restart
    
  8. Apache Logfiles:
    /var/log/httpd
    

SuSE Linux

  1. Install Apache-2 packets for SUSE via YAST:
    apache2
    apache2-mod_jk
    
  2. Edit /etc/sysconfig/apache2 and add "mod_jk" to the APACHE_MODULES:
    APACHE_MODULES=" .... mod_jk"
    
  3. 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>
    
  4. 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
    
  5. Check Apache configuration
    /etc/init.d/apache2 configtest
    
  6. Restart Apache
    /etc/init.d/apache2 restart
    
  7. Apache log files
    /var/log/apache2/
    

Ubuntu

  1. Install Apache-2:
    sudo apt-get install apache2 libapache2-mod-jk
    
  2. 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>
    
  3. Create a soft link in /etc/apache2/mods-enabled to enable mod_jk:
    cd /etc/apache2/mods-enabled
    ln -s ../mods-available/jk.conf
    
  4. 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
    
  5. Check Apache configuration
    /etc/init.d/apache2 configtest
    
  6. Restart Apache
    /etc/init.d/apache2 restart
    
  7. Apache log files
    /var/log/apache2/
    

Windows

  1. 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
  2. Install Apache to the default location (e.g C:\Program Files (x86)\Apache Software Foundation\) and choose typical installation.
  3. 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'.
  4. 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
    
  5. 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).

  6. 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).
  7. 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.

Configuring Apache for Managed Subversion Repositories

See Using Managed Subversion, Git & Mercurial Repositories