Scheduled maintenance 2023.06.01. 07:30 CET
|Installing codebeamer #8689/HEAD / v1631|
Tags: Installation Linux MAC-OS Windows
If upgrading from an older version please refer to Upgrading from older versions.
codeBeamer is shipped with a web container (tomcat), database server (Derby) and on Windows with Subversion, Git and Mercurial (hg). On Linux, Unix, MAC-OS systems the required SCM(s) must be installed via package manager. The installation typically takes 10-15 minutes.The pre-configured Derby database is for evaluation purposes only, and should not be used for production purposes.
For addition information Please see:
codeBeamer's server must always be started by the same operating system user to avoid file and database access problems. The server requires read and write file permissions for its own working and temporary files, and for the databases.
codeBeamer's server inherits access permissions from the user who started the server. To avoid permission problems on Linux/Unix systems, it is good practice to create a new operating system user (for example codebeamer) with very restricted access to the file system, and to use this system account to start codeBeamer. In this case, even when there is no restriction specified in the codeBeamer configuration file, a restricted access to the file system is guaranteed on the operating system level.
Installation on a Single Server
This section describes installation on a single server.
To install codeBeamer on your server, first download and execute a single self extract file for your platform.
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.Do not install or run codeBeamer as root.
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:
into the home directory of the codebeamer user (.e.g. /home/codebeamer).
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 Docker
Please refer to How to work with Docker how to install and use codeBeamer with Docker.
DatabasecodeBeamer is shipped with a Derby database that should be used only for evaluation purposes. It is strongly recommended configuring codeBeamer to use with PostgreSQL, MySQL or Oracle.
Please refer to the appropriate documentation provided with each codeBeamer version to find out which database versions are supported and how to setup them.
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!
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, MAC-OS
From shell the commands as below can be used:
To stop codeBeamer, type:
Starting during System Boot (Linux, Unix)
Typically when Linux starts, the codeBeamer service should also start automatically.
#!/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
codebeamer Knowledge Base
Services by Intland Software