Fazer backup e restaurar a configuração do Jazz Authorization Server

O backup do Jazz Authorization Server requer o backup dos arquivos de configuração do servidor e o backup do banco de dados de registro do cliente.

Fazendo backup dos arquivos de configuração do Jazz Authorization Server

Para fazer backup dos arquivos de configuração do servidor, faça backup de todos os arquivos no diretório a seguir:
JazzAuthServer/wlp/usr/servers/jazzop
Observação: Certifique-se de fazer o backup apenas dos arquivos desse diretório, e não de toda a árvore de diretórios.

Fazendo backup do banco de dados de registro do cliente

Há duas maneiras para fazer backup do banco de dados de registro do cliente:
  • O backup de todo o banco de dados do Derby preserva todas as informações originais. Uma vantagem de usar este método de backup será que se você, posteriormente, restaurar o banco de dados, não será necessário fazer quaisquer mudanças de configuração nos aplicativos Jazz. No entanto, o backup do banco de dados exige que você desligue o Jazz Authorization Server e todos os servidores de aplicativos do Jazz.
  • O salvamento de uma cópia dos registros de clientes em um arquivo pode ser concluído enquanto os servidores estiverem em execução. No entanto, para preservar a segurança, esse método de backup não registra os segredos que foram designados para os aplicativos. Se você restaurar os registros do cliente a partir do arquivo de backup, novos segredos serão gerados. Antes dos aplicativos Jazz funcionarem, você deverá configurá-los com os novos segredos.

Escolha o melhor método de backup para sua configuração de implantação e necessidades.

Fazendo backup do diretório de banco de dados Derby usado para registros do cliente

Para fazer o backup do diretório de banco de dados Derby usado para registros do cliente, conclua as etapas a seguir.

  1. Desligue o servidor de autorização do Jazz.
    Observação: O desligamento do servidor interrompe o uso de quaisquer aplicativos do Jazz que estejam configurados para usar o servidor. Portanto, é melhor encerrar esses aplicativos também. Se os aplicativos forem periodicamente desligados para backup, considere programar o backup do Jazz Authorization Server como parte desse desligamento.
  2. Faça o backup do diretório JazzAuthServer/derby/asDB.
  3. Reinicie o servidor de autorização do Jazz e qualquer outro servidor do Jazz que você tenha desligado.

Salvando um cópia dos registros do cliente em um arquivo

Para salvar uma cópia dos registros do cliente em um arquivo, conclua as etapas a seguir.
  1. Abra uma linha de comandos e altere para o diretório JazzAuthServer/cli.
  2. Execute o comando a seguir:
    lsclient -u username:password> fileLocation
    em que
    • username e ' password são as credenciais de administrador do Jazz Authorization Server.
    • fileLocation é o caminho completo e o nome de arquivo para criar e salvar.

Restauração de um backup da configuração do Jazz Authorization Server

Para restaurar um backup da configuração do servidor, pode primeiro ser necessário desinstalar e reinstalar o servidor, por exemplo, se a instalação foi danificada. Em seguida, conclua as etapas a seguir.

  1. Restaure os arquivos de configuração dos quais você fez backup em Backup dos arquivos de configuração do Jazz Authorization Server.
  2. Restaure o banco de dados de registro de clientes do qual você fez backup em Backup do banco de dados de registro de clientes.
    • Se você fez backup do banco de dados Derby, restaure o backup para o diretório JazzAuthServer/derby/asDB.
    • Se você salvou os registros do cliente em um arquivo, conclua as etapas a seguir.
      1. Edite o arquivo que você criou em Salvando uma cópia dos registros de clientes em um arquivo. Cada entrada contém uma linha semelhante a este exemplo:
        "client_secret":*

        Substitua o asterisco (*) com uma sequência a ser usada como o novo segredo do aplicativo. É possível fazer backup desse valor. Em seguida, salve o arquivo.

      2. Para cada aplicativo que tenha um arquivo " teamserver.properties em seu diretório de configuração " JazzInstallDir/server/conf/applicationContext, conclua as próximas etapas.
        1. Abra esse arquivo em um editor de texto.
        2. Localize a linha que começa com a sequência a seguir:
          com.ibm.team.repository.servlet.sso_clientSecret=
        3. Altere o valor para o novo valor que você definiu para o aplicativo na etapa a para especificar o novo segredo. Por exemplo,
          com.ibm.team.repository.servlet.sso_clientSecret="newClientSecret#12"
          Dica: embora o valor original possa ser colocado entre colchetes ([ e ]), não coloque o novo valor entre colchetes.
      3. Para os aplicativos Lifecycle Query Engine e Link Index Provider, edite o arquivo " lqe.properties no diretório de configuração de cada aplicativo, " JazzInstallDir/server/conf/lqe e " JazzInstallDir/server/conf/ldx. Configure o valor da propriedade lqe.configMode para true. Por exemplo,
        lqe.configMode="true"
      4. Para o aplicativo Jazz Report Builder, edite o arquivo app.properties em seu diretório de configuração JazzInstallDir/server/conf/rs. Altere o valor da propriedadejsa.client.secret para o novo valor que você definiu para o aplicativo na etapa a.
      5. Abra uma linha de comandos e altere para o diretório JazzAuthServer/cli.
      6. Execute o comando a seguir:
        ldclient -u username:password -c fileLocation
        em que
        • username e ' password são as credenciais de administrador do Jazz Authorization Server.
      7. Inicie os servidores de aplicativos do Jazz.
      8. Se os aplicativos Lifecycle Query Engine ou Link Index Provider estiverem registrados no Jazz Team Server, cancele o registro e registre-os novamente. Esta etapa notifica os aplicativos que seus segredos serão atualizados.