BusinessObjects

O blog do Consultor BO

Rotina de backup pelo método BIAR

Pessoal, esse é um dos métodos mais interessantes para fazer backup do BO, ele não dispensa o método tradicional de efetuar backup dos database e file store, porém esse método também se faz necessário pela flexibilidade de restore.

O que é o backup pelo método BIAR:

BIAR é um tipo de arquivo de exportação do BO, é um arquivo de transporte, “uma exportação lógica”. Através da ferramenta “Upgrade Management Tool” é possível gerar um arquivo BIAR de todo o conteúdo e algumas configurações do servidor BO. Considera-se conteúdo: Pastas publicas, relatórios e arquivos publicados no repositório, instâncias, usuários, grupos de usuários, permissões de acesso, níveis de acesso, etc. Itens como customizações da instalação do BO não são exportadas, como configuração do TomCat, alterações em arquivos da instalação do BO.

Qual a vantagem do backup pelo método BIAR:

O backup tradicional é feito sobre os databases de repositório e auditoria e também sobre a pasta de File Store da instalação do BO. Esse backup é completo, porém a restauração também é completa, e é necessário a restauração em um ambiente idêntico ao original, ou seja, não pode ser restaurado em um 2º servidor com o nome e IP diferentes, precisa estar tudo exatamente idêntico. Com o método BIAR é possível restaurar o backup em qualquer instalação BO, e se necessário, é possível resgatar apenas o objeto de interesse para restaurar. Por exemplo: Imagine que alguém excluiu uma pasta de relatórios, somente uma pasta. Com esse backup é possível restaurar somente essa pasta sem nem se quer parar o BO. O backup tradicional você teria que restaurar o BO inteiro e além disso, se a percepção dessa exclusão de pasta for de muito tempo, por exemplo: a pasta foi excluída a 1 mês e só perceberam agora; então será perdido o que foi incluído ou alterado dentro desse período.

Como implementar o backup:

A ferramenta Upgrade Management Tool é um pacote “JAR” que pode ser executada via prompt de comando parametrizando a geração de um arquivo BIAR, com isso podemos criar um arquivo BAT para a execução desse pacote. Esse BAT pode ser agendado nas tarefas do windows (caso esteja trabalhando com Linux, é só seguir a mesma lógica com shell script).

Script:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
@echo off
echo SAP BusinessObjects BI 4.0 - Backup Diario
 
set vBOEDIR="D:\BO" 
set vBOESRV="ServerName"
set vBOEUSR="UsuarioBackup" 
set vBOEPSW="UsuarioBackupSenha" 
set vBKPDiR="D:\BO_BKP\biar_diario"
 
for /F "tokens=1-4 delims=/ " %%A in ('echo %date%') do set vDate=%%D.%%B.%%C
for /F "tokens=1-4 delims=:" %%A in ('echo %time%') do set vTime=%%A.%%B.%%C
for /F "tokens=1-4 delims=." %%A in ('echo %vTime%') do set vTime=%%A.%%B.%%C
echo - Variaveis setadas
 
echo - Backup iniciado
cd "%vBOEDIR%\SAP BusinessObjects Enterprise XI 4.0\java\apps\upgradeManagementTool\jars\"
 
"%vBOEDIR%\SAP BusinessObjects Enterprise XI 4.0\win64_x64\jdk\jre\bin\javaw.exe" -Xmx8g -Djava.library.path="%vBOEDIR%\SAP BusinessObjects Enterprise XI 4.0\win64_x64" -jar upgrademanagementtool.jar -mode livetobiar -biarfile "%vBKPDIR%\bkp_%vBOESRV%_%vDate%_%vTime%.biar" -logfile "%vBKPDIR%\bkp_%vBOESRV%_%vDate%_%vTime%.log.csv" -source %vBOESRV%:6400 -sourceusername %vBOEUSR% -sourcepassword %vBOEPSW%
echo - Backup finalizado

Agora eu vou comentar cada parte do script:

4
5
6
7
8
set vBOEDIR="D:\BO" 
set vBOESRV="ServerName"
set vBOEUSR="UsuarioBackup" 
set vBOEPSW="UsuarioBackupSenha" 
set vBKPDiR="D:\BO_BKP\biar_diario"

Essa parte é onde preenche as variáveis do script, para não ficar repedindo código:
vBOEDIR: Diretório de instalação do BO
vBOESRV: Nome ou IP do servidor BO
vBOEUSR: Usuário para conectar no BO
vBOEPSW: Senha do usuário
vBKPDiR: Diretório para gerar o arquivo BIAR

 

10
11
12
for /F "tokens=1-4 delims=/ " %%A in ('echo %date%') do set vDate=%%D.%%B.%%C
for /F "tokens=1-4 delims=:" %%A in ('echo %time%') do set vTime=%%A.%%B.%%C
for /F "tokens=1-4 delims=." %%A in ('echo %vTime%') do set vTime=%%A.%%B.%%C

Aqui é onde preenche as variáveis de tempo, para gerar o arquivo com a data e tempo no nome. Exemplo: bkp_servidor_20131201_1230.BIAR

 

16
cd "%vBOEDIR%\SAP BusinessObjects Enterprise XI 4.0\java\apps\upgradeManagementTool\jars\"

Esse é o comando para entrar no diretório da instalação do Upgrade Management Tool, especificamente onde ficam os pacotes JAR

 

18
 "%vBOEDIR%\SAP BusinessObjects Enterprise XI 4.0\win64_x64\jdk\jre\bin\javaw.exe" -Xmx8g -Djava.library.path="%vBOEDIR%\SAP BusinessObjects Enterprise XI 4.0\win64_x64" -jar upgrademanagementtool.jar -mode livetobiar -biarfile "%vBKPDIR%\bkp_%vBOESRV%_%vDate%_%vTime%.biar" -logfile "%vBKPDIR%\bkp_%vBOESRV%_%vDate%_%vTime%.log.csv" -source %vBOESRV%:6400 -sourceusername %vBOEUSR% -sourcepassword %vBOEPSW%

Por fim, o comando que efetua o backup. Os parâmetros desse comando que interessam são:
-jar: é o pacote JAR a ser executado, no caso o Upgrade Management Tool
-mode: É o modo que o backup será feito: LiveToBiar (do BO para arquivo BIAR); LiveToLive (do BO para outro BO); BiarToLive (do arquivo BIAR para o BO);
-biarfile: Diretório e nome do arquivo BIAR a ser gerado
-logfile: Diretório e nome do arquivo de log a ser gerado
-source: Nome/IP e porta do servidor BO
-sourcename: Usuário para conectar no BO
-sourcepassword: Senha do usuário

Uma cereja você pode colocar no bolo é esse comando aqui:

21
22
echo - Exclusao de arquivos antigos
FORFILES /S /P "%vBKPDiR%" /d -15 /c "CMD /C del @file /Q"

Esse comando exclui arquivos anteriores a 15 dias, onde “-15” que determina o números de dias a considerar.

 

Existem mais parametrizações para o Upgrade Management Tool, para saber acesse a ajuda da própria ferramenta, lá contem a parte de “Command Line” que explica cada detalhe, inclusive com alguns exemplos.

Esse método utilizando o Upgrade Management Tool é a evolução do mesmo método utilizando o Import Wizard na versão XI 3.1 e anteriores, este também é possível ser executado por linha de comando.

É possível também efetuar o backup via LCM gerando o arquivo LCMBIAR (notaram a semelhança?) tanto pelo Promotion Management quanto por linha de comando. Mas esse assunto é para outro post.

Referências:
SAP Business Intelligence platform Administrator Guide 4.0 SP 7
Backup & Recovery in BO 4.0

, , , , , ,

11 thoughts on “Rotina de backup pelo método BIAR

  • João disse:

    Oi Gustavo, e ai, tudo bem?

    Seu script foi muito útil aqui na empresa, com poucas modificações fizemos funcionar no Linux. Um abraço do time da PBH.

    • Glauber P. Pandolfi disse:

      Caro João, no´s conseguimos gerar o arquivo com sucesso. Porém, não conseguimos realizar o restore.

      Qual o procedimento utilizado?

  • Wasley Portes disse:

    Bom dia, blz??

    Na hora de executar o script está retornando o erro abaixo:

    could not find the main class:Files program will exit

    Sabe o que pode ser?

    • Gustavo Henrique Oliveira disse:

      Olá Wasley, infelizmente não sei dizer o que esta errado, mas tente investigar as parametrizações para as bibliotecas do Java, certamente o problema está ai.

      • Wasley Portes disse:

        Na verdade o erro original é o seguinte:

        Após fazer os ajustes necessários meu script ficou assim

        @echo
        echo SAP BusinessObjects BI 4.0 – Backup Diario

        set vBOEDIR=”F:\Program Files (x86)\BI\SAP BusinessObjects”
        set vBOESRV=”192.168.0.12″
        set vBOEUSR=”usuario”
        set vBOEPSW=”senha”
        set vBKPDiR=”F:\BKP_BO\biar_diario”

        for /F “tokens=1-4 delims=/ ” %%A in (‘echo %date%’) do set vDate=%%D.%%B.%%C
        for /F “tokens=1-4 delims=:” %%A in (‘echo %time%’) do set vTime=%%A.%%B.%%C
        for /F “tokens=1-4 delims=.” %%A in (‘echo %vTime%’) do set vTime=%%A.%%B.%%C
        echo – Variaveis setadas

        echo – Backup iniciado
        cd “%vBOEDIR%\SAP BusinessObjects Enterprise XI 4.0\java\apps\upgradeManagementTool\jars\”

        PAUSE

        “%vBOEDIR%\SAP BusinessObjects Enterprise XI 4.0\win64_x64\jdk\jre\bin\javaw.exe” -Xmx8g -Djava.library.path=”%vBOEDIR%\SAP BusinessObjects Enterprise XI 4.0\win64_x64″ -jar upgrademanagementtool.jar -mode livetobiar -biarfile “%vBKPDIR%\bkp_%vBOESRV%_%vDate%_%vTime%.biar” -logfile “%vBKPDIR%\bkp_%vBOESRV%_%vDate%_%vTime%.log.csv” -source %vBOESRV%:6400 -sourceusername %vBOEUSR% -sourcepassword %vBOEPSW%

        echo – Backup finalizado

        Porém ao executar ele dá o erro abaixo:

        ‘””F:\Program’ is not recognized as an internal or external command, operable program or batch file.

        • Gustavo Henrique Oliveira disse:

          O CMD não esta reconhecendo o diretório “F:\Program Files (x86)\BI\SAP BusinessObjects”, esse é o problema agora. Verifique no CMD como acessar esse diretório.

        • Glauber P. Pandolfi disse:

          O problema está na quantidade de caracteres.
          O CMD vai conseguir ler se você fizer da seguinte forma:
          set vBOEDIR=”F:\Progra~1”

        • Glauber P. Pandolfi disse:

          Senhores, estou enfrentando o problema abaixo:

          “unable to access jarfile upgrademanagementtool.jar”

          Alguma orientação?

  • vcarvalhom disse:

    Olá,
    Existe como exportar um relatório WebI para Biar?

    • Gustavo Henrique Oliveira disse:

      Olá, até a versão 3.1 você tem o Import Wizard em que você seleciona os objetos que vão compor seu BIAR. A partir da versão 4.0 você pode exportar via Promotion Management, que vai gerar um arquivo LCMBIAR (evolução do BIAR), e também tem o Upgrade Management Tool que gera o BIAR também.

Deixe uma resposta

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *