Com o Jazz Gateway,
é possível recuperar programaticamente números e status de itens de trabalho
do repositório do Rational Team
Concert para System z.
O Jazz Gateway é executado como um
daemon do servidor no z/OS, Windows®, Linux® e outras plataformas, para executar autenticação SSL
em um repositório do Jazz.
Ele transmite um número de item de trabalho em um URI REST para o repositório do Jazz para obter o XML do item de trabalho
e, em seguida, retorna o status do item de trabalho ou o XML do item de trabalho completo
para o cliente.
Como o Jazz Gateway
Comunica-se com o Repositório do Jazz
O daemon do servidor Jazz Gateway
comunica-se com uma porta específica para recuperar pedidos do cliente.
No z/OS, estes pedidos são feitos
enviando uma tarefa do servidor System z Jazz Gateway. É possível modificar
o cliente REXX para especificar uma porta específica,
para que o cliente e o daemon do servidor System z Jazz Gateway
possam comunicar-se um com o outro por meio de uma conexão do soquete.
- Para chamar o cliente REXX,
use um REXX EXEC, como um
EXEC independente ou uma saída de usuário SCLM para configurar os parâmetros necessários, como os seguintes:
- ID do usuário
- senha
- URL de repositório do Jazz
- número da porta
- número do item de trabalho
- O cliente REXX transmite estas informações
para o daemon do servidor System z Jazz Gateway e espera
uma resposta.
- O daemon do servidor System z Jazz Gateway é autenticado
no repositório do Jazz e transmite o pedido
do item de trabalho por meio de um URI REST.
- O servidor Jazz Gateway
retorna as informações do item de trabalho em XML, e o daemon do servidor
procede de uma das seguintes formas:
- Ele extrai o status do item de trabalho do XML.
- Ele transmite o XML completo de volta para o cliente REXX, que retorna-o ao
EXEC de chamada.
Instalando o Jazz Gateway
O Jazz Gateway é instalado no z/OS usando SMP/E como parte do componente Build System
Toolkit para System z.
Se desejar instalar o gateway nas plataformas distribuídas suportadas, você deverá
fazer download do arquivo .zip do Jazz Gateway
da seção All Downloads do Rational
Team Concert para System
z em Jazz.net.
Instalando o Jazz Gateway
no UNIX
Conclua as seguintes etapas para instalar o Jazz Gateway no UNIX:
- Faça download do RTCz-JazzRestGateway-2.0.0.2.zip da seção
All Downloads do Rational Team
Concert para System z em Jazz.net: https://jazz.net/downloads/rational-team-concert-z/releases/2.0.0.2.
- Descompacte os seguintes arquivos ZIP .jar para o diretório de instalação do Jazz Gateway:
- RTCz-JazzGateway-<buildID>.jar
- log4j-1.2.12.jar
- com.ibm.team.repository.common_1.0.1.I200909060153.jar
- org.eclipse.osgi_3.4.3.R34x_v20081215-1030.jar
- commons-httpclient-3.0.jar
Chamando o Jazz Gateway
no UNIX Usando Java
Conclua as seguintes etapas para chamar
o Jazz Gateway no UNIX:
- Abra um terminal shell.
- Vá para o diretório no qual os arquivos do gateway estão instalados.
- Insira o seguinte comando:
java -cp .\RTCz-JazzGateway-<buildID>.jar;.\log4j-1.2.12.jar;
.\com.ibm.team.repository.common_0.6.1.I200810072228.jar;.\org.eclipse.osgi_3.3.2.R33x_v20080105.jar;.\commons-httpclient-3.0.jar com.ibm.teamz.jazz.gateway.JazzGateway 6666
Nota: Para
este exemplo, 6666 é o número da porta usada pelo gateway.
- Pressione CTRL+C para parar o gateway.
Shell Script UNIX de Exemplo
O exemplo a seguir
é um shell script para parar e iniciar o Jazz Gateway. É possível customizar o exemplo de
acordo com seu ambiente, alterando o valor de
JAVA_HOME e
GTW_DIR.
#! /bin/sh
#
# RTCzGateway-daemon: Starts/stops the Jazz Gateway
#
#
name="IBM Jazz Gateway"
export JAVA_HOME=<Java_sdk_directory>
export GTW_DIR=<Jazz_gateway_directory>
port=${2:-3456}
PID=GtwPid.$port
cmd="$JAVA_HOME/bin/java -classpath $GTW_DIR/RTCz-JazzGateway-I20090929-1150.jar:$GTW_DIR/log4j-1.2.12.jar:$GTW_DIR/com.ibm.team.repository.common_1.0.1.I200909060153.jar:$GTW_DIR/org.eclipse.osgi_3.4.3.R34x_v20081215-1030.jar:$GTW_DIR/commons-httpclient-3.0.jar com.ibm.teamz.jazz.gateway.JazzGateway $port"
Start() {
if [ -f $PID ]
then
echo "$name $port already started"
else
echo "Starting $name $port daemon... "
$cmd >$PID.log 2>&1&
echo $! >$PID
fi
}
Stop() {
if [ -f $PID ]
then
echo "Shutting down $name $port daemon: "
kill -9 `cat $PID`
rm $PID
else
echo "$name $port daemon not started "
fi
}
Restart() {
Stop
Iniciar
}
# See how we were called.
case "$1" in
start)
Iniciar
;;
stop)
Stop
;;
restart)
Restart
;;
*)
echo $"Usage: $0 {start|stop|restart} <port_number>"
exit 1
esac
exit $?
Este script pode ser usado como um script de inicialização do sistema.
A administração deste tipo de shell script se difere para cada plataforma
UNIX ou Linux na qual o Jazz Gateway
é suportado. A tabela a seguir lista o local dos
scripts de inicialização do sistema para cada sistema:
| Sistema |
Local |
| AIX |
/etc/rc.d |
| Red Hat |
/etc/rc.d/init.d |
| SUSE |
/etc/init.d |
| Solaris |
/etc/init.d |
Instalando o Jazz Gateway
no Windows
Conclua as seguintes etapas para instalar o Jazz Gateway no Windows:
- Faça download do RTCz-JazzRestGateway-2.0.0.2.zip da seção
All Downloads do Rational Team
Concert para System z em Jazz.net: https://jazz.net/downloads/rational-team-concert-z/releases/2.0.0.2.
- Descompacte os seguintes arquivos ZIP .jar para o diretório de instalação do Jazz Gateway:
- RTCz-JazzGateway-<buildID>.jar
- log4j-1.2.12.jar
- com.ibm.team.repository.common_1.0.1.I200909060153.jar
- org.eclipse.osgi_3.4.3.R34x_v20081215-1030.jar
- commons-httpclient-3.0.jar
Chamando o Jazz Gateway no Windows Usando Java
Conclua
as seguintes etapas para chamar o Jazz Gateway
no Windows:
- Abra uma janela do prompt de comandos.
- Vá para o diretório no qual os arquivos do gateway estão instalados.
- Insira o seguinte comando:
java -cp .\RTCz-JazzGateway-<buildID>.jar;.\log4j-1.2.12.jar;.\com.ibm.team.repository.common_0.6.1.I200810072228.jar;.\org.eclipse.osgi_3.3.2.R33x_v20080105.jar;.\commons-httpclient-3.0.jar com.ibm.teamz.jazz.gateway.JazzGateway 6666
Nota: Para
este exemplo, 6666 é o número da porta usada pelo gateway.
O arquivo de comando
startgw.cmd
pode ser usado para iniciar o gateway. Antes de iniciar o gateway, atualize a variável
JAVA_HOME
no script.
Exemplo para Configurar um Serviço do Windows
O
Jazz Gateway é um aplicativo Java; portanto, ele não inclui suporte direto
para execução como um serviço do Windows. No entanto, existem
vários wrappers de serviço disponíveis. Este exemplo usa o Java Service
Launcher, que é um utilitário separado que não faz parte do Rational
Team Concert para System z, mas está disponível on-line. É possível modificar
este exemplo para o wrapper de serviço que você usa.
Configurando o
Java Service Launcher
Conclua as seguintes etapas para configurar
o Java Service Launcher (JSL) para o Jazz Gateway:
- Abra um prompt de comandos e altere os diretórios para o diretório bin
que contém o arquivo jsl.ini.
- Edite o arquivo jsl.ini no diretório bin:
- No prompt de comandos, execute jsl -debug para testar sua configuração.
Isto executará o Jazz Gateway. Deve aparecer uma mensagem semelhante a:
Debugging IBM Jazz Gateway (gateway_port_number)
Now starting JVM
ControlHandler registered after JVM start
- Resolva erros adicionais antes de continuar.
- Verifique o arquivo de log definido na configuração de systemout para
determinar se o gateway está recebendo no número da porta especificado
pela variável PORT.
- Pressione CTRL+C para encerrar o teste de depuração.
Instalando o Serviço do Windows e Iniciando o Jazz
Gateway
Conclua as seguintes etapas para instalar o serviço do
Windows JSL e iniciar o Jazz Gateway:
- No prompt de comandos, altere os diretórios para o diretório bin jsl.
- Execute jsl -install.
- Abra o painel de controle de serviços do Windows (Iniciar > Executar
> services.msc).
- Localize o serviço IBM Jazz Gateway (ou conforme você nomeou-o
no arquivo .ini).
- Clique com o botão direito do mouse e selecione Iniciar.
- Solicita construções para assegurar que seu mecanismo de construção esteja processando com êxito
os pedidos de construção.
- Após a configuração inicial, o serviço iniciará automaticamente
quando o sistema for inicializado, devido à configuração de starttype=auto
no arquivo ini.
Nota: Se precisar alterar as configurações no arquivo .ini, primeiro
você deverá parar e desinstalar o serviço (consulte as instruções abaixo).
Em seguida, faça suas mudanças no arquivo .ini e reinstale o serviço.
Parando o
serviço Jazz Gateway
Conclua as seguintes etapas para parar
o serviço Jazz Gateway:
- Abra o painel de controle de serviços do Windows (Iniciar > Executar
> services.msc).
- Localize o serviço IBM Jazz Gateway (ou conforme você nomeou-o
no arquivo .ini).
- Clique com o botão direito do mouse e selecione Parar.
Desinstalando o Serviço do Windows
Conclua
as seguintes etapas para desinstalar o serviço do Windows JSL:
- Abra o painel de controle de serviços do Windows (Iniciar > Executar
> services.msc).
- Localize o serviço IBM Jazz Gateway (ou conforme você nomeou-o
no arquivo .ini).
- Clique com o botão direito do mouse e selecione Parar.
- No prompt de comandos, altere os diretórios para o diretório bin jsl.
- Execute jsl -remove.