...

• A ferramenta está disponível à partir da SP 36 da release 12.1.27.
• A versão mínima para usar a ferramenta é 12.27.34.
• A ferramenta deve ser executada em um sistema operacional homologado.
• É necessário ter o .Net Framework v4.78 ou superior instalado.
• É necessário ter o Oracle Client com o arquivo tnsnames.ora configurado.
• É necessário que o owner tenha privilégio ao dicionário de dados do Oracle (“select any dictionary” ou "select_catalog_role").
• É desejável que o owner tenha privilégio para encerramento de sessões (“alter system kill”).
  • Como alternativa, caso não seja adicionado o privilégio, pode ser criada uma procedure para que alguns recursos do produto consigam realizar o encerramento de sessões. Ver documentação sobre Servidor de Banco de Dados para exemplo da procedure e mais informações.
• É necessário que o usuário tenha permissão para ler/escrever no diretório ao qual os arquivos serão substituídos.

...

Caso haja mais de um pacote disponível no mesmo diretório da aplicação, será exibido um formulário para selecionar qual pacote deseja utilizar.

...

Validade do Pacote

Os pacotes de atualização possuem uma data de expiração para garantir que as atualizações ocorram sempre para a release mais recente disponível na ocasião, assegurando que as últimas correções e adequações de produto serão aplicadas. Caso a ferramenta seja iniciada por um pacote de atualização que foi disponibilizado a mais de 15 dias, uma mensagem de alerta será exibida, porém, será possível continuar a atualização. Ao se deparar com esta mensagem, recomenda-se verificar na ocasião se há um pacote de atualização (release) mais recente.

Image Added

Se o pacote de atualização tiver sido liberado a mais de 30 dias, a ferramenta impedirá que a atualização seja iniciada e somente permitirá continuar se for informado uma chave de acesso emergencial fornecida pelo suporte. Neste cenário, recomenda-se verificar se há na ocasião um pacote de atualização mais recente disponível, e se mesmo assim houver a necessidade de atualizar para o pacote obsoleto, a chave de acesso deverá ser solicitada a equipe de suporte que avaliará se há viabilidade para que a mesma seja fornecida.

Image Added

Image Added

...

Tela de Avisos

Após fazer o login, será visualizada a tela de avisos, que exibirá (quando houver) notificações sobre procedimentos/informações referentes ao processo de atualização.

...

Há a possibilidade de exportar essas informações através do botão ´Salvar Relatório´.

...

Execução em modo silencioso

A aplicação pode ser inicializada com passagem de parâmetros conforme descrito abaixo:

• autoexec
  Usado para que a execução se inicie sem interação humana, ou seja, execução silenciosa.
• salvalog
  Usado para informar a geração de log da aplicação. Serão criados arquivos na pasta Logs, no mesmo diretório da aplicação, tendo como padrão o nome como “log_ddMMyyyyHHmmss.json”.
• -c <servidor> <usuário> <senha>
  Para informar a conexão com a base de dados, deve-se utilizar o marcador -c seguido do servidor, usuário e senha, nessa ordem e sempre com essas informações. A aplicação irá buscar no TNSNAMES os dados de conexão, então é preciso que o arquivo esteja configurado corretamente.
  
• tipoAmbiente=<ambiente>
  Usado para informar se o ambiente é de Produção ou Homologação. Se o parâmetro não for informado, será considerado ambiente de produção. Valores possíveis: P (produção) ou H (homologação).
• pacote=<caminho>
  Usado para informar o caminho do pacote que será utilizado na atualização do ambiente contendo o arquivo compactado no formato zip ou o diretório com os arquivos descompactados.
• desconectausuarios=<valor>
  Usado para encerrar as sessões ativas no ambiente informado. Valores possíveis: S (sim) ou N (não). ATENÇÃO: Ao informar SIM, todas as sessões serão encerradas sem aviso e portanto deve ser utilizado com cautela.

Os parâmetros podem ser informados em qualquer ordem, exceto o parâmetro de conexão que, ao informar o marcador, deve seguir a ordem estabelecida na documentação. Os dados de conexão são obrigatórios.

Ao executar em modo silencioso, um ícone de sistema irá exibir as informações atuais da execução, conforme imagem abaixo.

Image Added

Os arquivos de log gerados, seguem o modelo de exemplo abaixo.

{
  "nomeExecutavel": "Atualiza.exe",
  "id": 1,
  "sistemaOperacional": {
    "nome": "Windows 10 Pro",
    "versao": "10.0.19042.0",
    "build": "19042",
    "release": "2009"
  },  
"nivel": "Informacao",  
"dominio": "SP01",
"nomeMaquina": "RBPN019403893",
"nomeUsuario": "vitor.gilioli",
"dataHora": "21/10/2021 11:40:56",
"mensagem": "A versão mínima do framework .NET para executar a aplicação não está instalada.\nNecessário .NET 4.8\nInstalado .NET 4.7",
 "stack": "",
 "palavrasChave": [ ".net", "inicialização", "framework" ]
}

{
  "nomeExecutavel": "Atualiza.exe",
  "id": 1,
  "sistemaOperacional": {
    "nome": "Windows 10 Pro",
    "versao": "10.0.19042.0",
    "build": "19042",
    "release": "2009"
  },
  "nivel": "Erro",
  "dominio": "SP01",
  "nomeMaquina": "RBPN019403893",
  "nomeUsuario": "vitor.gilioli",
  "dataHora": "21/10/2021 15:07:46",
  "mensagem": "Não é permitido abrir mais de uma instância pois o módulo já esta sendo executado.\n\nTerminal: RBPN019403893\nUsuário O.S: vitor.gilioli",
  "stack": "",
  "palavrasChave": [ "rms", "atualiza", "versão", "aplicação" ]
}

{
  "nomeExecutavel": "Atualiza.exe",
  "id": 0,
  "sistemaOperacional": {
    "nome": "Windows 10 Pro",
    "versao": "10.0.19042.0",
    "build": "19042",
    "release": "2009"
  },
  "nivel": "Sucesso",
  "dominio": "SP01",
  "nomeMaquina": "RBPN019403893",
  "nomeUsuario": "vitor.gilioli",
  "dataHora": "21/10/2021 15:11:09",
  "mensagem": "Atualização finalizada.\nTempo decorrido de atualização: 00:02:19",
  "stack": "",
  "palavrasChave": [ "rms", "atualiza", "sucesso", "atualização" ]
}

Exemplo de chamada

"Atualiza.exe" autoexec salvalog -c ora19 rms rms tipoAmbiente=P pacote=C:\RMS\Pacotes\SP_R32_8.zip

Código de Saída

A aplicação irá lançar um código de saída (exitCode) com o valor 0, caso tenha finalizado a execução com sucesso ou o valor 1 caso tenha apresentado algum erro durante a execução. Para ambas as situações, se for passado o parâmetro salvalog, a aplicação irá gerar sempre o arquivo de log referente ao momento de encerramento da aplicação, seja por sucesso ou erro.