Você está na página 1de 4

Instalao do TestLink

Para instalar o TestLink [http://www.teamst.org], primeiro descompacte-o e renomeie o


diretrio para o nome desejado. Para essas instrues, estamos considerando que o software
foi instalado no diretrio /var/www/testlink. Aps isso, entre no script de instalao,
atravs da URL:
http://endereo_do_testlink/install/index.php
Sero pedidos alguns parmetros. Ateno para o fato de que deve ser fornecido o login e
senha do administrador do banco de dados e do usurio a ser utilizado pelo TestLink. O
script de instalao cria o banco e as tabelas necessrias. Ao final da instalao, por medida
de segurana, exclua o diretrio install, que fica dentro do diretrio onde foi instalado o
TestLink.
Entre no sistema usando as credenciais fornecidas ao final da instalao: usurio admin,
senha admin. Aps isso, entre na opo Users e clique no boto Create para criar um novo
usurio. Esse primeiro usurio dever ter Login e Password definidos como o nome de
usurio e senha do LDAP. Alm disso, seu papel (role) dever ser definido como admin. Feito
isso saia do sistema para fazer as alteraes necessrias nos arquivos de configurao.
Arquivo de configurao principal
Em primeiro lugar, no se deve alterar diretamente o
arquivo /var/www/testlink/config.inc.php, que onde ficam as configuraes do
software. Ao invs disso, crie um
arquivo /var/www/testlink/custom_config.inc.php. Isso facilitar futuras
atualizaes e eliminar o risco de danificar o arquivo original de configuraes. Nesse
arquivo s devem ser includos os parmetros alterados. Ou seja, caso algum parmetro
seja mantido como default, ele poder ficar somente no arquivo config.inc.php. Abaixo
est uma cpia do arquivo custom_config.inc.php indicado para a nossa instalao
(ao final do cdigo, encontram-se algumas explicaes e comentrios de determinadas partes
da configurao):
<?php
/**
* TestLink Open Source Project - http://testlink.sourceforge.net/
* This script is distributed under the GNU General Public License 2 or later.
*
* Filename $RCSfile: custom_config.inc.php,v $
*
* @version $Revision: 1.4.2.3 $
* @modified $Date: 2007/11/03 07:51:43 $ by $Author: franciscom $
*
* SCOPE:
* Constants and configuration parameters used throughout TestLink
* DEFINED BY USERS.
*
* Use this page to overwrite configuration parameters (variables and defines)
* presente in:
*
* config.inc.php
* cfg\const.inc.php
*-----------------------------------------------------------------------------
*/
// ----------------------------------------------------------------------------
/** [Localization] */

$g_default_language = 'pt_BR';

// ----------------------------------------------------------------------------
/** [Bug Tracking systems] */

Pgina 1 de 4 sl:testlink_doc [Arquitetura de sistemas]
29/06/11 http://arquiteturadesistemas.pbh.gov.br/wiki/doku.php?id=sl:testlink_doc
$g_interface_bugs='MANTIS';

// ----------------------------------------------------------------------------
/** [Authentication] */

/* Login authentication method */

$tlCfg->authentication['method'] = 'LDAP';

/** LDAP authentication credentials */

$tlCfg->authentication['ldap_server'] = 'ldap://ldapmaster.pbh';
$tlCfg->authentication['ldap_port'] = '636';
$tlCfg->authentication['ldap_version'] = '3';
$tlCfg->authentication['ldap_root_dn'] = 'dc=pbh,dc=gov,dc=br';
$tlCfg->authentication['ldap_organization'] = '';
$tlCfg->authentication['ldap_uid_field'] = 'uid';
$tlCfg->authentication['ldap_bind_dn'] = ''; // Left empty for anonymous LDAP binding
$tlCfg->authentication['ldap_bind_passwd'] = ''; // Left empty for anonymous LDAP binding

/** Validating new user login names */

$tlCfg->validation_cfg->user_login_valid_regex='/^[\w \-.]+$/';

// ----------------------------------------------------------------------------
/** [SMTP] */

# Administrator e-mail, receives error/problem messages
$g_tl_admin_email = 'email_do_administrador@pbh.gov.br';

# The sender ("From:") e-mail, visible to recipients
$g_from_email = 'email_do_remetente@pbh.gov.br';

# The return address for bounced mail
$g_return_path_email = 'email_de_retorno@pbh.gov.br';

# Urgent = 1, Not Urgent = 5, Disable = 0
$g_mail_priority = 0;

// SMTP Configuration
$g_smtp_host = 'envia.netuno.pbh'; # SMTP server MUST BE configured

// Configure only if SMTP server requires authentication
$g_smtp_username = ''; # user
$g_smtp_password = ''; # password

// ----------------------------------------------------------------------------
/** [MISC] */

// [LOGIN]
//
// Allow Users to create their own accounts by new user link on login page
// TRUE => allow [STANDARD BEHAVIOUR]
// FALSE => disallow
//
$g_user_self_signup = FALSE;

// ----- End of Config ------------------------------------------------

// ----- END OF FILE --------------------------------------------------
?>
Alguns comentrios sobre a configurao
Seo [Authentication]
Item
/** Validating new user login names */
$tlCfg->validation_cfg->user_login_valid_regex='/^[\w \-.]+$/';
Essa expresso regular limita o uso de alguns caracteres nos nomes de usurio. A expresso
original era /^[\w \-]+$/, que significa que podem ser utilizados qualquer caractere
alfanumrico (/w) e o sinal - (\-) no nome. Uma vez que no nosso LDAP vrios nomes
Pgina 2 de 4 sl:testlink_doc [Arquitetura de sistemas]
29/06/11 http://arquiteturadesistemas.pbh.gov.br/wiki/doku.php?id=sl:testlink_doc
possuem ., foi preciso acrescentar tambm esse sinal grfico expresso. Por isso a
expresso final ficou /^[\w \-.]+$/. Os smbolos /^ e $/ significam, respectivamente, o
incio e o fim do nome, ou seja, servem para limitar a expresso.
Seo [SMTP]
Itens
# Administrator e-mail, receives error/problem messages
$g_tl_admin_email = 'email_do_administrador@pbh.gov.br';

# The sender ("From:") e-mail, visible to recipients
$g_from_email = 'email_do_remetente@pbh.gov.br';

# The return address for bounced mail
$g_return_path_email = 'email_de_retorno@pbh.gov.br';
O "email_do_administrador deve ser o endereo de e-mail do administrador do ambiente.
Esse endereo receber as mensagens de erro e de problemas relativos ao TestLink. O
"email_do_rementente deve ser o endereo que aparecer para as pessoas que receberem
notificaes do sistema. Por questo de privacidade, pode-se optar por usar um e-mail
invlido (como algo do tipo "nao_responda ou "mensagem_automatica) ou usar um
genrico, que redirecione para o usurio responsvel por receber essas mensagens.
Normalmente os e-mails que vo com esse remetente NO devem ser respondidos, pois so
notificaes do sistema, da a sugesto para e-mails invlidos. Por fim, "email_de_retorno
aquele utilizado para receber mensagens que so enviadas, mas, por algum motivo, no
conseguem atingir o seu destinatrio e voltam para o remetente (geralmente referenciados
como bounce). Normalmente utiliza-se aqui tambm o endereo do administrador, a no
ser que exista alguma outra pessoa responsvel por essa rea.
Arquivo de configuraes do Mantis
O prximo arquivo a ser alterado o /var/www/testlink/cfg/mantis.cfg.php. O
contedo desse arquivo deve ser o especificado abaixo. Mais uma vez, os valores indicados
so os recomendados para a nossa instalao atual e, normalmente, somente os parmetros
BUG_TRACK_DB_USER e BUG_TRACK_DB_PASS devem ser alterados. Ao final do cdigo,
encontram-se as descries sobre alguns parmetros.
<?php
/**
* TestLink Open Source Project - http://testlink.sourceforge.net/
* $Id: mantis.cfg.php,v 1.7.2.1 2007/12/07 11:33:30 franciscom Exp $
*
* Constants used throughout TestLink are defined within this file
* they should be changed for your environment
*
* 20051229 - scs - added DEFINE for the DB-Type
*/

//Set the bug tracking system Interface to MANTIS 0.19.1
//also tested with MANTIS 1.0.0.a3

/** The DB host to use when connecting to the mantis db */
define('BUG_TRACK_DB_HOST', 'localhost');

/** The name of the database that contains the mantis tables */
define('BUG_TRACK_DB_NAME', 'mantis');

/** The DB type being used by mantis
values: mysql,mssql,postgres
*/
define('BUG_TRACK_DB_TYPE', 'mysql');

/** The DB password to use for connecting to the mantis db */
define('BUG_TRACK_DB_USER', 'usurio_do_mantis');
define('BUG_TRACK_DB_PASS', 'senha_do_mantis');

/* link of the web server for mantis*/
Pgina 3 de 4 sl:testlink_doc [Arquitetura de sistemas]
29/06/11 http://arquiteturadesistemas.pbh.gov.br/wiki/doku.php?id=sl:testlink_doc
/* anonymous login into mantis has to be turned on, and a mantis user has to created with viewer rights t
/* Change the following in your mantis config_inc.php (replace dummy with your created user)
# --- anonymous login -----------
# Allow anonymous login
$g_allow_anonymous_login = ON;
$g_anonymous_account = 'dummy';
*/
define('BUG_TRACK_HREF', "http://demandas.pbh.gov.br/view.php?id=");

/** link to the bugtracking system, for entering new bugs */
define('BUG_TRACK_ENTER_BUG_HREF',"http://demandas.pbh.gov.br");
?>
Descrio dos parmetros
BUG_TRACK_DB_HOST - o host onde est instalado o banco de dados do Mantis
BUG_TRACK_DB_NAME - o nome do banco de dados do Mantis
BUG_TRACK_DB_USER - usurio que acessa o banco de dados do Mantis
BUG_TRACK_DB_PASS - senha do usurio que acessa o banco de dados do Mantis
BUG_TRACK_HREF - URL para visualizar os casos no Mantis
BUG_TRACK_ENTER_BUG_HREF - URL de acesso ao Mantis
sl/testlink_doc.txt ltima modificao: 2009/04/28 09:22 por fred
Pgina 4 de 4 sl:testlink_doc [Arquitetura de sistemas]
29/06/11 http://arquiteturadesistemas.pbh.gov.br/wiki/doku.php?id=sl:testlink_doc