É possível utilizar as variáveis do WebSphere para fornecer configurações para qualquer
um dos atributos de tipos de dados de cadeia que estão contidos nos arquivos de configuração do produto.
Antes de Iniciar
Como os aplicativos não podem acessar diretamente as variáveis do WebSphere, se você definir uma variável do
WebSphere dentro de um aplicativo, a mensagem de erro "Variável desconhecida" será retornada. Se precisar referenciar
uma variável do WebSphere a partir de um aplicativo, inclua o método
a seguir no aplicativo para expandir a sequência que usa a variável
do WebSphere.
Evitar Problemas: A expansão
de variáveis do WebSphere requer que você tenha privilégios administrativos.
gotcha
private String expandVariable(String s) throws
javax.management.JMException {
com.ibm.websphere.management.AdminService as =
com.ibm.websphere.management.AdminServiceFactory.getAdminService
();
String server = as.getProcessName();
java.util.Set result = as.queryNames(new javax.management.ObjectName("*:*,type=AdminOperations,process="
+ server), null);
return (String)as.invoke((javax.management.ObjectName)
result.iterator().next(),"expandVariable",new Object[]
{"${"+s+"}"}, new String[] {"java.lang.String"});
Da mesma forma,
é possível incluir as seguintes linhas de código em um arquivo de script se você
quiser utilizar um comando de script para expandir variáveis WebSphere.
- Utilizando
Jacl:
set mbean [$AdminControl completeObjectName WebSphere:*,type=AdminOperations]
$AdminControl invoke $mbean expandVariable {{"${APP_INSTALL_ROOT}"}}
- Utilizando Jython:
AdminOperations = AdminControl.completeObjectName('WebSphere:*,type=AdminOperations')
print AdminControl.invoke(AdminOperations, 'expandVariable', '${APP_INSTALL_ROOT}')
Sobre Esta Tarefa
As variáveis do WebSphere geralmente são utilizadas para especificar caminhos de arquivo. O tópico "Configurações de Variáveis" fornece detalhes adicionais sobre como especificar variáveis e detalhes adicionais sobre componentes do produto que as utilizam.
As variáveis do WebSphere também são utilizadas para configurar:
- Nomes de caminhos de produtos, como JAVA_HOME e APP_INSTALL_ROOT.
- Determinados valores de customização de toda a célula ou de todo o cluster.
O serviço de localização.
Variáveis de ambiente.
O mecanismo do escopo da variável para as variáveis do
WebSphere permite definir uma variável no nível do nó, cluster ou da célula, e também no nível do servidor. Esse mecanismo permite especificar uma configuração para todos os servidores de um nó, cluster ou célula, em vez de especificar individualmente a configuração para cada servidor.
Para definir uma nova variável, alterar o valor de uma variável existente ou excluir uma variável, execute as etapas a seguir, conforme apropriado.
Procedimento
- Clique em no console administrativo
- Selecione o escopo da variável na lista de escopos disponíveis.
Se você criar uma nova variável, ela será criada no escopo selecionado. Se você definir a mesma variável em diversos níveis, a definição mais completa substituirá a configuração de nível superior. Por exemplo, se você especificar a mesma variável em um nível de célula e em um nível do nó, a configuração do nível do nó substituirá a configuração do nível da célula.
As variáveis de definição de escopo é especialmente importante se você estiver testando objetos da origem de dados. O escopo da variável pode fazer com que uma origem de dados
falhe no teste de conexão, mas tenha êxito no tempo de execução, ou passe no teste de conexão,
mas falhe no tempo de execução.
- Crie uma nova variável.
- Clique em Nova.
- Especifique um nome, um valor e, opcionalmente, uma descrição para a variável.
O servidor de aplicativos utiliza
variáveis internas
do WebSphere Application Server
para seus próprios propósitos. Os prefixos que indicam que uma variável é interna
são WAS_DAEMON_<propriedade customizada do servidor>,
WAS_DAEMON_ONLY_<propriedade customizada do servidor>
e WAS_SERVER_ONLY_<propriedade customizada do servidor>. As variáveis com essas marcações não são destinadas para sua utilização. Elas são reservadas exclusivamente
para utilização pelo tempo de execução do servidor. A modificação dessas variáveis pode
causar erros inesperados.
É possível utilizar as variáveis do WebSphere para modificar a configuração do daemon. Anexando uma propriedade customizada do servidor a uma marcação de daemon, é possível designar
a variável especificamente para o daemon. Digite DAEMON_<propriedade
customizada do servidor> no campo Nome. Por exemplo, se você inserir DAEMON_ras_trace_outputlocation no campo Nome e
SYSOUT no campo Valor, será possível direcionar a saída de rastreio do daemon específico para
SYSPRINT.
É possível criar as variáveis do WebSphere que suportam a substituição. Por exemplo, se você
inserir ${<nome da variável>} no campo de Nome,
o valor de <nome da variável> torna-se o nome
de sua nova variável do WebSphere. Por exemplo, se você inserir ${JAVA_HOME} como o nome de sua variável, o nome da variável do
WebSphere que é criado será o diretório home Java™.
- Clique em OK.
- Clique em na navegação do console administrativo e verifique se a variável é exibida na
lista de variáveis para o escopo selecionado.
O console administrativo não capta erros de digitação. A variável será
ignorada se a referência a ela for incorreta.
- Modifique a configuração para uma variável existente.
- Clique no nome da variável que você deseja alterar.
- Modifique o conteúdo do Campo Valores.
O campo Valores de algumas das variáveis que já foram definidas ao instalar o produto é de leitura, porque alterar os valores especificados para essas variáveis poderá causar erros de processamento do produto.
- Clique em OK.
- Exclua uma variável existente.
- Selecione a variável que deseja excluir.
- Clique em Excluir.
- Clique em OK.
- Verifique se essa variável foi removida da lista de variáveis para o escopo selecionado.
- Salve sua configuração.
- Pare os servidores afetados e inicie esses servidores novamente para
que a alteração na configuração da variável seja efetivada.
Se a alteração feita afetar um nó, pare e reinicie todos os servidores desse nó.
De mesma forma, se a alteração feita afetar uma célula, pare e reinicie todos os servidores dessa célula.