Comando Atualizar Aplicativo

É possível usar a interface da linha de comandos (CLI) update para atualizar o aplicativo Registry Services. Esse processo de atualização inclui atualizar o arquivo ear do aplicativo implementado no servidor de aplicativos e modificar o modelo de autenticação.

A operação executada por meio do comando da CLI update não atualiza quaisquer configurações da origem de dados ou a configuração de mapeamento de usuário.

O comando CLI de atualização modifica a nova versão do archive ear de acordo com as propriedades de instalação atuais e implementa esse ear no servidor.

Durante esse processo, a CLI usa o antigo archive ear para verificar se o usuário modificou o arquivo cleansingRules.xml atualmente implementado.

Essa CLI compara os arquivos de regras de limpeza atual e o original para determinar se há mudanças. Se houver alguma, o comando da CLI update emite uma mensagem de aviso e mantém todas as mudanças feitas pelo usuário.

Em seguida, ele gera um novo arquivo ear e atualiza o aplicativo Registry Services no servidor.

Sintaxe de comando

A sintaxe da CLI update varia de acordo com o ambiente no qual ela executa:

frs.bat update -type container [-properties properties_file]
./frs.sh update -type container [-properties properties_file]

Parâmetros

Tabela 1 lista os parâmetros usados com a CLI update e fornece sua descrição.

Tabela 1. Parâmetros Usados na CLI update.
Parâmetro	Valor	Descrição
-type	`container`	Esse valor define que o comando update deve atualizar o aplicativo Registry Services implementando um novo arquivo ear.
[-properties]	`properties_file`	Esse valor define que o arquivo .properties deve agir como a fonte das propriedades de atualização. Esse parâmetro é opcional. Se você não especificar esse parâmetro, o arquivo `REGISTRY_HOME`\etc\CLI.properties padrão será usado como a origem das propriedades de atualização. Essa operação de atualização requer a configuração destas propriedades no arquivo CLI.properties: `app.name` `appserver.host` `appserver.user` `appserver.password` `appserver.clientauthentication` `appserver.was.targets` `appserver.port` O nome do aplicativo definido na propriedade `app.name` deve ser implementado no servidor de aplicativos definido nas propriedades `appserver.host` e `appserver.port`.

Ao atualizar o aplicativo Registry Services com o modo de FIPS ativado, passe estes parâmetros de SSL para especificar o certificado a ser usado para criar uma conexão SOAP com o WebSphere Application Server:

Tabela 2. Parâmetros SSL Usados na CLI update (Modo FIPS Ativado)
Parâmetro	Valor	Descrição
-keyStore	`file_name`	Esse valor define o nome do arquivo keystore que contém um certificado para um usuário mapeado para uma função do Registry Services. Pode haver diversos certificados. Este parâmetro é necessário para propósitos de autenticação de certificado. Se você não especificar esse parâmetro, o Registry Services o lerá a partir da propriedade `javax.net.ssl.keyStore` no arquivo CLI.properties.
-keyStorePassword	`password`	Esse valor define a senha para o certificado especificado no parâmetro -keyStore. Este parâmetro é necessário para propósitos de autenticação de certificado. Se você não especificar esse parâmetro, o Registry Services o lerá a partir da propriedade `javax.net.ssl.keyStorePassword` no arquivo CLI.properties.
-trustStore	`file_name`	Esse valor define o nome do arquivo de armazenamento confiável que contém o certificado do servidor com o qual o Registry Services conecta para processar essa CLI. Pode haver diversos certificados em diversos servidores. Este parâmetro é necessário para propósitos de autenticação de certificado. Se você não especificar esse parâmetro, o Registry Services o lerá a partir da propriedade `javax.net.ssl.trustStore` no arquivo CLI.properties.
-trustStorePassword	`password`	Esse valor define a senha para o certificado especificado no parâmetro -trustStore. Este parâmetro é necessário para propósitos de autenticação de certificado. Se você não especificar esse parâmetro, o Registry Services o lerá a partir da propriedade `javax.net.ssl.trustStorePassword` no arquivo CLI.properties.
[-keyStoreType]	`type_name`	Este valor define o tipo de keystore. O valor padrão desse parâmetro opcional é o `keystore.type` especificado no arquivo java.security do JDK em uso. Se você não especificar esse parâmetro, o Registry Services o lerá a partir da propriedade `javax.net.ssl.keyStoreType` no arquivo CLI.properties.
[-trustStoreType]	`type_name`	Esse valor define o tipo de truststore. O valor padrão para esse parâmetro opcional é o `truststore.type` especificado no arquivo java.security do JDK em uso. Se você não especificar esse parâmetro, o Registry Services o lerá a partir da propriedade `javax.net.ssl.trustStoreType` no arquivo CLI.properties.

Amostra

frs.bat update -type container -properties C:/etc/container.properties
./frs.sh update -type container

Códigos de retorno

O comando update imprime um código de retorno ao concluir sua execução para que seja possível ter detalhes sobre o resultado obtido. Tabela 3 fornece os códigos de retorno que podem ser obtidos no final da execução de update e suas respectivas descrições.

Tabela 3. Códigos de Retorno da Execução do Comando update
Código de retorno	Descrição
0	O comando update executou a operação com êxito.
1	O comando update falhou em executar devido à ausência de um parâmetro -type.
2	O comando update falhou em executar devido a um arquivo de propriedades não localizado.
3	O comando update falhou em executar devido a um parâmetro -type inválido especificado na linha de comandos.
4	O comando update falhou em executar devido a um erro de atualização.
99	A execução do comando update falhou porque o modo de operação `somente leitura` está ativo.

Esse comando é usado somente para manutenção da instalação. Não use-o a menos que instruído diretamente pela equipe de suporte.