Visão Geral do System z Jazz Gateway

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.

  1. 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
  2. O cliente REXX transmite estas informações para o daemon do servidor System z Jazz Gateway e espera uma resposta.
  3. 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.
  4. 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.

Pré-requisitos para instalar o Jazz Gateway no UNIX e Windows
  • IBM Java software development kit (SDK) 1.5 deve ser instalado
  • A variável de ambiente JAVA_HOME deve ser configurada para o diretório que contém o Java 1.5 SDK
  • O java.exe deve ser incluído em PATH
Para obter informações adicionais, consulte Requisitos do Sistema Detalhados para Ambientes do Servidor Rational Team Concert para System z 2.0.

Instalando o Jazz Gateway no UNIX

Conclua as seguintes etapas para instalar o Jazz Gateway no UNIX:
  1. 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.
  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:
  1. Abra um terminal shell.
  2. Vá para o diretório no qual os arquivos do gateway estão instalados.
  3. 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.
  4. 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:
  1. 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.
  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:
  1. Abra uma janela do prompt de comandos.
  2. Vá para o diretório no qual os arquivos do gateway estão instalados.
  3. 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:
  1. Abra um prompt de comandos e altere os diretórios para o diretório bin que contém o arquivo jsl.ini.
  2. Edite o arquivo jsl.ini no diretório bin:
    • Defina uma variável na seção [define] para armazenar o número da porta usada pelo gateway.
      • PORT= gateway_port_number
    • Defina uma variável na seção [define] para armazenar o caminho para o diretório de instalação do gateway.
      • GTW_DIR= gateway_directory
    • Altere appname, servicename, displayname e servicedescription para nomes e descrições de sua escolha, por exemplo, IBM Jazz Gateway (%PORT%).
    • Defina a configuração de jrepath para %JAVA_HOME%.
      Nota: Certifique-se de configurar o jrepath na seção [java] do arquivo .ini, não na seção [service], que tem um comentário semelhante.
    • Defina a configuração de useconsolehandler para true para assegurar que o mecanismo de construção continue sendo executado após um logout.
    • Defina a configuração de systemout para algo como %GTW_DIR%\gtw%PORT%.out.log.
    • Defina a configuração de systemerr para algo como %GTW_DIR%\lgtw%PORT%.err.log.
    • Na seção [java], inclua os seguintes parâmetros a serem transmitidos para Java:
      • params = 4
      • param00 = -cp
      • param01 = %GTW_DIR%\RTCz-JazzGateway-I20090929-1150.jar;%GTW_DIR%\log4j-1.2.12.jar;%GTW_DIR%\com.ibm.team.repository.common_0.6.1.I200810072228.jar;%GTW_DIR%\org.eclipse.osgi_3.3.2.R33x_v20080105.jar;.\commons-httpclient-3.0.jar
      • param02 = com.ibm.teamz.jazz.gateway.JazzGateway
      • param03 = %PORT%
  3. 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
  4. Resolva erros adicionais antes de continuar.
  5. 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.
  6. 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:
  1. No prompt de comandos, altere os diretórios para o diretório bin jsl.
  2. Execute jsl -install.
  3. Abra o painel de controle de serviços do Windows (Iniciar > Executar > services.msc).
  4. Localize o serviço IBM Jazz Gateway (ou conforme você nomeou-o no arquivo .ini).
  5. Clique com o botão direito do mouse e selecione Iniciar.
  6. Solicita construções para assegurar que seu mecanismo de construção esteja processando com êxito os pedidos de construção.
  7. 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:
  1. Abra o painel de controle de serviços do Windows (Iniciar > Executar > services.msc).
  2. Localize o serviço IBM Jazz Gateway (ou conforme você nomeou-o no arquivo .ini).
  3. 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:
  1. Abra o painel de controle de serviços do Windows (Iniciar > Executar > services.msc).
  2. Localize o serviço IBM Jazz Gateway (ou conforme você nomeou-o no arquivo .ini).
  3. Clique com o botão direito do mouse e selecione Parar.
  4. No prompt de comandos, altere os diretórios para o diretório bin jsl.
  5. Execute jsl -remove.