Propriedades Administrativas para Usar a Programação de Script Wsadmin
A administração de script utiliza diversos arquivos de propriedade Java. Os arquivos de propriedades podem ser utilizados para controlar as suas configurações do sistema. Antes que qualquer arquivo de propriedade seja especificado na linha de comandos, são carregados três níveis de arquivos de propriedade padrão. Esses arquivos de propriedade incluem um arquivo padrão de instalação, um arquivo padrão do usuário e um arquivo de propriedades.
O primeiro nível representa uma instalação padrão, localizada no diretório profile_root/properties para cada perfil do servidor de aplicativos chamado wsadmin.properties. O segundo nível representa um usuário padrão e está localizado na propriedade Java user.home. Esse arquivo de propriedades também é chamado wsadmin.properties. O terceiro nível é um arquivo de propriedades apontado pela variável de ambiente WSADMIN_PROPERTIES. Essa variável de ambiente é definida no ambiente onde a ferramenta wsadmin inicia.
Se um ou mais desses arquivos de propriedades estiverem presentes, eles serão interpretados antes de qualquer arquivo de propriedades presente na linha de comandos. Os três níveis de arquivos de propriedades são carregados na ordem que são especificados. O arquivo de propriedades carregado por último substitui os carregados anteriormente.
As propriedades Java a seguir são utilizadas por script:
com.ibm.ws.scripting.appendTrace
Determina se o arquivo de rastreio será anexado ao final do arquivo de log existente. A configuração padrão, false, substitui o arquivo de log em cada chamada.
com.ibm.ws.scripting.classpath
Pesquisa classes e recursos e é anexada à lista de caminhos.
com.ibm.ws.scripting.connectionType
Determina o conector a ser utilizado. Esse valor pode ser SOAP, JSR160RMI, RMI, IPC ou NONE. O arquivo wsadmin.properties especifica SOAP como o conector.
com.ibm.ws.scripting.crossDocumentValidationEnabled
Determina se o mecanismo de validação examina outros documentos quando alterações são feitas em um documento.
Os valores possíveis são true e false. O valor padrão é verdadeiro.
com.ibm.ws.scripting.defaultLang
Indica a linguagem a ser utilizada ao executar scripts. O arquivo wsadmin.properties especifica Jacl como a linguagem de script.
As linguagens de script suportadas são Jacl e Jython.
com.ibm.ws.scripting.echoparams
Determina se a saída dos parâmetros ou argumentos é feita para STDOUT ou para um arquivo de log do wsadmin. A configuração padrão, true, envia os parâmetros ou argumentos para um arquivo de log.
com.ibm.ws.scripting.emitWarningForCustomSecurityPolicy
Controla se a mensagem WASX7207W é emitida quando as permissões personalizadas são localizadas.
Os valores possíveis são true e false. O valor padrão é verdadeiro.
com.ibm.ws.scripting.exceptionPropagationThrown
Configure esta propriedade para relatar a exceção correta quando um objeto de script integrado do WebSphere Application Server emitir uma exceção que é capturada e manipulada no script e, posteriormente, uma segunda exceção não WebSphere Application Server for emitida, mas não capturada. Na saída, o wsadmin relatará erroneamente a primeira exceção como a causa para sair.
com.ibm.ws.scripting.host
Determina o host a ser utilizado ao tentar uma conexão. Se não for especificado, o padrão será a máquina local.
com.ibm.ws.scripting.ipchost
A propriedade ipchost determina o host que o sistema utiliza para conectar-se ao conector IPC. Use o nome do host ou endereço IP do adaptador de loopback no qual o conector IPC atende, como localhost, 127.0.0.1 ou ::1. O valor padrão é localhost.
com.ibm.ws.scripting.port
Especifica a porta a ser utilizada ao tentar uma conexão. O arquivo wsadmin.properties especifica 8879 como a porta SOAP para a instalação de um único servidor.
com.ibm.ws.scripting.profiles
Especifica uma lista de scripts de perfis para execução automaticamente antes da execução dos comandos de usuário, scripts ou de um shell interativo.
O arquivo wsadmin.properties especifica securityProcs.jacl e LTPA_LDAPSecurityProcs.jacl como os valores dessa propriedade. Se Jython for especificado com a opção wsadmin -lang, a ferramenta wsadmin executa uma conversão para alterar os nomes de scripts de perfis especificados nessa propriedade para utilizar a extensão de arquivo que corresponde à linguagem especificada. Utilize os procedimentos do script fornecido com as configurações padrão para facilitar a configuração da segurança.
com.ibm.ws.scripting.traceFile
Determina para onde a saída de rastreio e de log é direcionada. O arquivo wsadmin.properties especifica o arquivo wsadmin.traceout que está localizado no diretório profile_root/logs de cada perfil do servidor de aplicativos como valor dessa propriedade.
Se vários usuários trabalharem com a ferramenta wsadmin simultaneamente, defina diferentes propriedades traceFile nos arquivos de propriedades do usuário. Se o nome do arquivo contiver caracteres DBCS (Conjunto de Caracteres de Byte Duplo), utilize o formato unicode, como \uxxxx, em que xxxx é um número.
com.ibm.ws.scripting.traceString
Ativa o rastreio para o processo de script. O padrão tem o rastreio desativado.
com.ibm.ws.scripting.tempdir
Determina o diretório a ser utilizado para os arquivos temporários ao instalar aplicativos.
A API JVM (Java Virtual Machine) usa java.io.temp como o valor-padrão.
com.ibm.ws.scripting.validationLevel
Determina o nível de validação a ser utilizado quando as alterações de configuração são feitas a partir da interface de script.
Os valores possíveis são: NONE, LOW, MEDIUM, HIGH, HIGHEST. O padrão é HIGHEST.
com.ibm.ws.scripting.validationOutput
Determina para onde os relatórios de validação são direcionados. O arquivo padrão é wsadmin.valout que está localizado no diretório profile_root/logs de cada perfil do servidor de aplicativos.
Se vários usuários trabalharem com a ferramenta wsadmin simultaneamente, defina diferentes propriedades validationOutput nos arquivos de propriedades do usuário. Se o nome do arquivo contiver caracteres DBCS (Conjunto de Caracteres de Byte Duplo), utilize o formato unicode, como \uxxxx, em que xxxx é um número.