Scmbug manual: RELEASE_0-8-16
PrevChapter 8. ResourcesNext

8.2. Installation

8.2.1. System

Under UNIX, Scmbug is available in the form of Debian and RPM packages. The provided packages are:

Under Windows, the entire Scmbug system is available in the form of a single .zip file. It must be manually installed in C:/Program Files/Scmbug. It requires ActiveState ActivePerl installed in C:/Perl/bin/perl, and a temporary directory called C:/Temp.

Source code distributions are also available. Figure 8-1 shows how the system can be configured and installed from source. It is possible to choose a different destination of the libraries and binaries of Scmbug both in UNIX and Windows systems at configuration time. If you are configuring from source code, running './configure --help' can provide more information.

Figure 8-1. Installation of the system from source.

	bash$ ./configure
	bash$ make
	bash$ su
	bash# make install-common
	bash# make install-doc
	bash# make install-tools
	bash# make install-server

Tip

Installing all these packages will NOT automatically integrate an SCM repository with a bug-tracking system. It will only install the basic software needed to do so.

A user must configure the Integration Daemon and start it as shown in Figure 8-2. Then, a user must run the Glue Installer to install the Scmbug integration in an SCM repository.

Figure 8-2. Integration daemon start.

Starting the Integration Daemon in UNIX systems: 

bash# /etc/init.d/scmbug-server start

Starting the Integration Daemon in Windows systems: 

C:\> cd C:/Program Files/Scmbug/etc/init.d
C:/Program Files/Scmbug/etc/init.d> scmbug-server.bat

8.2.2. Documentation

Installation of documentation, including this manual, requires installing the package scmbug-doc.

8.2.3. Integration Tools

Installation of the Integration Tools requires installing the packages scmbug-common and scmbug-tools.

8.2.4. Integration Daemon

Installation of the daemon requires installing the packages scmbug-common and scmbug-server. Additionally, it requires installing the Mail::Sendmail and XML::Simple Perl modules, as shown in Figure 8-3.

Figure 8-3. Mail::Sendmail, XML::Simple installation.

Installation in UNIX systems: 

bash$ su
bash# perl -MCPAN -e "install Mail::Sendmail"
bash# perl -MCPAN -e "install XML::Simple"

Installation in Windows systems: 

C:\> ppm
PPM - Programmer's Package Manager version 3.1.
Copyright (c) 2001 ActiveState Corp. All Rights Reserved.
ActiveState is a devision of Sophos.

Entering interactive shell. Using Term::ReadLine::Stub as readline library.

Type 'help' to get started.
ppm> install Mail-Sendmail
ppm> install XML-Simple

The file /etc/scmbug/daemon.conf holds the configuration of the daemon.

Integration with multiple bug-tracking systems can be accomplished by starting multiple daemons listening at different ports.

8.2.4.1. Bugzilla

For reasons explained in Section 6.1, the integration daemon requires local presence of the source code used to run a Bugzilla instance. It also requires access to the MySQL database used to store Bugzilla's data. It is recommended that the daemon is installed on the same machine Bugzilla runs, but this is not required. If the daemon is installed on the same machine Bugzilla runs, Scmbug will force the Bugzilla version cache (which is a local file) to be regenerated when activity_tag integration requests are processed.

8.2.4.2. Mantis

Integration with Mantis requires access to the database used to store Mantis' data. At a minimum, it requires installing the DBI Perl module, as shown in Figure 8-4.

Figure 8-4. DBI installation.

Installation in UNIX systems: 

bash$ su
bash# perl -MCPAN -e "install DBI"

Installation in Windows systems: 

C:\> ppm
PPM - Programmer's Package Manager version 3.1.
Copyright (c) 2001 ActiveState Corp. All Rights Reserved.
ActiveState is a devision of Sophos.

Entering interactive shell. Using Term::ReadLine::Stub as readline library.

Type 'help' to get started.
ppm> install DBI
As explained in Section 6.2, Mantis supports installation with multiple database backends, and requires the corresponding DBD Perl module to be installed. For example, if Mantis is installed with a MySQL database backend, the DBD::mysql Perl module must also be installed(Figure 8-5) and the database_vendor variable must be configured as shown in Figure 6-3.

Figure 8-5. DBD::mysql installation.

Installation in UNIX systems: 

	bash$ su
	bash# perl -MCPAN -e "install DBD::mysql"

Installation in Windows systems: 

C:\> ppm
PPM - Programmer's Package Manager version 3.1.
Copyright (c) 2001 ActiveState Corp. All Rights Reserved.
ActiveState is a devision of Sophos.

Entering interactive shell. Using Term::ReadLine::Stub as readline library.

Type 'help' to get started.
ppm> install DBD-mysql

PrevHomeNext
ResourcesUpUpgrading