Installing CodeBeamer

CodeBeamer is shipped with a web container (tomcat), database server (Derby) and on Windows with Subversion, Git and Mercurial (hg). On Linux, Unix, Solaris, MAC-OS systems the required SCM(s) must be installed via package manager. The installation typically takes 10-15 minutes.

For addition information Please see:

• General System Requirements
• Post-installation Configuration
• Customizing Notification Emails
• Deployment options for Git, Mercurial and SVN

Installation on a Single Server

This paragraph describes installation on a single server.

Client computers do not require codeBeamer installation;  their only requirements are that the browser's Cookies and JavaScript should be enabled.

To install codeBeamer on your server, first download and execute a single self extract file for your platform.

Database

Please refer to the appropriate documentation provided with each codeBeamer version, to find out which database versions are supported and how to setup them.

• Preparing MySQL Database for Installation
• Preparing Oracle Database for Installation

Installation on Windows

After downloading the self extract file, you can start the installation by double-clicking on the self extract file.

It is strongly recommended installing codeBeamer as Service to ensure that codeBeamer will be running also after the user logged out.

Installation on Linux

On Linux systems we suggest to install and run codeBeamer under a special user account, typically codebeamer.

If you want to put an Apache Web server in front of codeBeamer (e.g. to access codebeamer via the standard HTTP(S) ports 80 (443) or to access managed Subversion repositories via HTTP protocol), you should install the Apache server for your platform first (see Configuring Tomcat for codeBeamer, Configuring Apache for Subversion) and then create the codebeamer user in the same group where Apache is:

E.g. on Red Hat Enterprise:

sudo adduser codebeamer --ingroup apache

Before installing codeBeamer:

• JRE/JDK: codeBeamer is shipped with 32 bit 1.6.x Oracle (Sun) JRE however it is strongly recommended installing JRE/JDK of your Linux distribution. If codeBeamer finds a JRE/JDK 1.6.x (32 or 64 bit) or higher on your system it will use that JRE/JDK otherwise the shipped one.

To install codeBeamer:

• Log in or sudo as user codebeamer

into the home directory of the codebeamer user (.e.g. /home/codebeamer).

• Make the downloaded installation file (e.g. CB-7.0-GA-linux.bin) executable

sh CB-7.0-GA-linux.bin

• To make upgrading to newer codeBeamer versions easier, we suggest to create a symbolic link called CB in the codebeamer home directory, that points to the current/active version (e.g. CB-7.0):

cd /home/codebeamer/
ln -s CB-7.0 CB

If you later install a new codeBeamer version, (e.g. CB-7.1) you will get a new directory CB-7.1 parallel to existing CB-7.0), but by simply redirecting the CB symbolic link to CB-7.1 all scripts based on CB will now consistently operate on the new version.

Installation on Unix, Solaris or MAC-OS

On Unix, Solaris, MAC-OS systems there is no self extract kit. Please contact sales@intland.com and ask for access permissions to the war installation file:

CB-x.x.x-tomcat.zip

Extract the Zip file, and follow the installation instructions described in the INSTALL.txt file.

Starting/Stopping codeBeamer

Windows

The codeBeamer server must be started before you can access codeBeamer.

If you select to install codeBeamer as a Windows Service (during the Installation), codeBeamer will be automatically started and stopped with the system. To manaully start/stop/restart the service, use the Windows Services Control panel.

Only if you did not choose to install codeBeamer as a service, you can start and stop it manually!

From the Window's Start menu select

Programs -> CodeBeamer x.x -> Start CodeBeamer Server

To stop the server, use:

Programs -> CodeBeamer x.x -> Stop CodeBeamer Server

When the server has started, start your browser on the server's URL with:

Programs -> CodeBeamer x.x -> Browse CodeBeamer

Linux, Unix, Solaris, MAC-OS

From shell the commands as below can be used:

$ /installdir/bin/startup

To stop CodeBeamer type:

$ /installdir/bin/stop

Starting during System Boot (Linux, Unix, Solaris)

Typically when Linux starts, the codeBeamer service should also start automatically.
For that create a new file in /etc/init.d/codebeamer with this content:

#!/bin/bash
#
# Run-level Startup script for codeBeamer
#
# chkconfig: 345 91 19
# description: Startup/Shutdown codeBeamer

CB_HOME="/home/codebeamer/CB"
CB_OWNR="codebeamer"

case "$1" in
    start)
        # startup
        echo -n "Starting CodeBeamer: "
        su - $CB_OWNR -c "cd $CB_HOME/bin && $CB_HOME/bin/startup"
        echo "OK"
        ;;
    stop)
        # shutdown
        echo -n "Shutdown CodeBeamer: "
        su - $CB_OWNR -c "cd $CB_HOME/bin && $CB_HOME/bin/stop"
        echo "OK"
        ;;
    reload|restart)
        $0 stop
        $0 start
        ;;
    *)
        echo "Usage: $0 start|stop|restart|reload"
        exit 1
esac
exit 0

If necessary modify the CB_HOME and CB_OWNR variables at the start of the script. Save it.

Now to activate the service, execute these commands as root (These commands are for Ubuntu and may be different on other platforms):

sudo chmod +x /etc/init.d/codebeamer
sudo update-rc.d codebeamer defaults

After this the CodeBeamer service is set up, and can be started/stopped using the service commands:

service codebeamer start
service codebeamer stop

See next:

• Important Files and Directories
• Post-installation Configuration